Multi-Relay Support

Using multiple relays, alongside the ETHGas relays, will improve the reliability of your block proposals and result in higher rewards

Validators have two relay configuration options when using ETHGas:

1. Multi-relay: Connect to any relays.

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

Both relay configurations use the commit-boost pipeline for block building.

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 proposed by your validators.

When migrating from ETHGas Relay Only to Multi-Relay, your payout_address should be moved from the validator client to the config.toml and the ETHGasPool contract address should be used on the validator client.

1

Set the ETHGas payout_address 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>"

# You do not need to re-register your validators when updating your payout_address
registration_mode = "skipped"

2

Re-run the ETHGas commit boost module this change.

This step is required to register the changes to the ETHGas account.

3

Set the ETHGasPool contract as the validator fee recipient

This should be configured on the validator client.

• 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]]
id = "ethgas"
url = "https://0x88ef3061f598101ca713d556cf757763[e-mail]"
enable_timing_games = true
target_first_request_ms = 0
frequency_get_header_ms = 100

[[relays]]
id = "titan"
url = "https://0x8c4ed5e24fe5c6ae21018437bde14769[e-mail]"
enable_timing_games = true
target_first_request_ms = 200
frequency_get_header_ms = 750

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.

• For non-ETHGas relays, we recommend setting:

  • target_first_request_ms = 200

  • frequency_get_header_ms = 750

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

5

Restart PBS module

This step is required to pick up the relay changes.

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.

---

There are two types of setups possible with Multi-Relay:

Multi-Relay with no ETHGas relays selected

In this scenario, blocks proposed by validators registered to the ETHGas platform will still be sold as whole blocks on the ETHGas marketplace, but they will not have markets open for preconfirmations, Realtime blockspace, or any other additional commitments.

✅ Whole Block Market

❌ Preconfirmations Market

❌ Realtime Market

---

Multi-Relay with multiple relays, including ETHGas relays

When an ETHGas relay is among the available connected relays, all markets will be available to validators registered to ETHGas, including whole blocks, preconfirmations, Realtime, and more.

✅ Whole Block Market

✅ Preconfirmations Market

✅ Realtime Market

---

2. ETHGas relays only

If a validator is 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 Commit 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 Commit 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