Multi-Relay Support

Validators have two relay configuration options when using ETHGas:

1. Multi-relay: Connect to any relay, with additional configuration.

2. ETHGas relays only: Connect to only ETHGas relays.

1. Multi-relay

To use any relay with a validator registered to ETHGas, additional configuration is required. The fee recipient for the validators using ETHGas must be set to the ETHGasPool contract address. Then, in the ETHGas commit-boost module configuration file, your payout address needs to be set.

• ETHGasPool - Mainnet : 0x3314Fb492a5d205A601f2A0521fAFbD039502Fc3

• ETHGasPool - Hoodi: 0x104Ef4192a97E0A93aBe8893c8A2d2484DFCBAF1

By setting your fee recipient on your validator clients, multi-relay support will automatically be enabled. Payments will still be made directly to your payout address in the block the validator proposes.

1

Setup the ETHGas commit-boost module

Confirm you are using the ETHGas custom PBS module image in the docker-compose file (or wherever you specify the PBS docker image).

Using a single instance of commit-boost with other non-ETHGas validators is fully supported. This modified version of commit-boost only impacts validators that are registered on the ETHGas exchange and have have their fee recipient sent to the ETHGasPool contract address. For all other validators, it operates exactly the same as the default commit-boost image.

ghcr.io/ethgas-developer/commitboost_ethgas_pbs:v0.9.2-ethgas

ethgas-preconf-commit-boost-module/README.md at main · ethgas-developer/ethgas-preconf-commit-boost-moduleGitHub

2

Set the ETHGas payoutAddress in config.toml

The payout_address should be set to the address where you want your rewards paid out.

config.toml

[[modules]]
id = "ETHGAS_COMMIT"
type = "commit"
...
payout_address = "<YOUR_PAYOUT_ADDRESS>"

Then re-run the ETHGas commit boost module to register this change.

3

Set the ETHGasPool contract as the validator fee recipient

This should be configured on the validator and beacon clients.

• ETHGasPool - Mainnet : 0x3314Fb492a5d205A601f2A0521fAFbD039502Fc3

• ETHGasPool - Hoodi: 0x104Ef4192a97E0A93aBe8893c8A2d2484

4

Add additional relays

Relays can be added to the config.toml using the following format:

Mainnet

config.toml

[[relays]]
url = "https://0x88ef3061f598101ca713d556cf757763[e-mail]"
enable_timing_games = true
target_first_request_ms = 0
frequency_get_header_ms = 100

Hoodi

• The configuration options enable_timing_games, target_first_request_ms and frequency_get_header_ms are set as recommended defaults. If those default settings are not included, it may lead to reduced validator performance.

• You do not have to use any ETHGas relays when using the multi-relay configuration, you can use any relay.

Currently, multi-relay configuration only supports a single ETHGas payoutAddress so it is not compatible with multiplexed validator setups where different validators require different fee recipient addresses.

This is being actively developed and will be available soon.

2. ETHGas relays only.

If a validator is only connected to only ETHGas relays, then a simplified configuration can be used.

1

Setup the ETHGas commit-boost module

ethgas-preconf-commit-boost-module/README.md at main · ethgas-developer/ethgas-preconf-commit-boost-moduleGitHub

2

Configure ETHGas commit-boost module to use only the ETHGas relay

Ensure that only $$-relay.ethgas.com relays are set in the config.toml file.

FAQ

Do I have to use ETHGas relays?

No. If you configure your validator clients for multi-relay support then you do not need to use any ETHGas relays. However, we recommend that you do use ETHGas relays to maximize your block reward potential.

How can I confirm that my validators are successfully registered to ETHGas?

You can use the GET /api/v1/user/validators API to view all your registered validators.

https://developers.ethgas.com/?http#get-api-v1-user-validators

What happens if I forget to set the payoutAddress in the ETHGas PBS module?

If you do not set a payoutAddress, any rewards you accrue will be held in your ETHGas account. This account is linked to the address you used to register your validators to ETHGas.

If you later set the payoutAddress through the ETHGas PBS module, then any accrued payments will automatically be paid out to that address.

Alternatively, you can manually withdraw the rewards from the ETHGas app or directly using the API.

Where can I confirm the ETHGas pool contract address?

Technical Integration