Ctrlk

Verifying Fee Recipient Registered on MEV Relays

Checker Script

Mainnet

Install dependencies and activate a Python virtual environment.

sudo apt update
sudo apt install git python3-venv python3-full python3-requests
# Activate Python virtual environment
python3 -m venv ~/check_relay_env
source ~/check_relay_env/bin/activate
pip install web3 requests

Download the Fee Recipient checker script (Source).

git clone https://gist.github.com/bc188884f6bdc1ce2c65a949e84b0dc5.git check_no_relays
cd check_no_relays

Set the RPC endpoint using your local execution client or one of the free publicly available ones here: https://ethereumnodes.com/

export RPC_URL="http://127.0.0.1:8545"

or;

export RPC_URL="https://eth.llamarpc.com"

Run the Checker Script and enter your CSM Node Operator ID when prompted.

Expected output:

Example output using dummy pubkeys

Once done, you can deactivate the Python virtual environment.

Troubleshooting:

If you face a "connection refused" error as seen above, it either means the RPC endpoint of your Execution Client is not enabled or the RPC_URL used is incorrect

How to fix?

Edit the .env file.

Add :el-shared.yml to the back of the COMPOSE_FILE= line.

Save and exit with CTRL+O, ENTER, CTRL+X.

Restart the Eth Docker stack with ethd down then ethd up.

Testnet

WIP

Manual Check

For each MEV Relay you have configured, replace <VALIDATOR_PUBKEY> for each of the commands below and run them on your terminal.

Then verify that the Fee Recipient Address matches with the Lido Execution Layer Rewards Vaults on Mainnet or Holesky depending on your setup (Source).

Example output:

{"message":{"fee_recipient":"0x388C818CA8B9251b393131C08a736A67ccB19297","gas_limit":"30000000","timestamp":"1739938746","pubkey":"0x...."},"signature":"0x...."}

Lido Execution Layer Rewards Vault Address

1) Titan Relay Global (Mainnet) (Non-filtering):

2) Titan Relay Regional (Mainnet) (Filtering):

3) Agnostic Relay (Mainnet)

4) Ultrasound Relay (Mainnet)

5) Aestus Relay (Mainnet)

6) Manifold SecureRPC (Mainnet)

7) Flashbots (Mainnet)

8) bloXroute Max-Profit (Mainnet)

9) bloXroute Regulated (Mainnet)

What to do if Fee Recipient is wrong?

It’s important to verify your fee recipient configuration before your validator proposes a block, as incorrect settings may result in protocol penalties.

Check your local configuration​

Make sure the fee recipient address is set to the following.

Check this in your setup as follows:

  • Dappnode: open the Staking Brain and review the Fee Recipient field for each validator.

  • Stereum: open the UI and check the fee recipient field in the validator client settings.

  • Eth-Docker / Sedge: inspect your .env file and confirm the FEE_RECIPIENT variable is set correctly.

  • SSV: log in to app.ssv.network, click on Fee Address, and verify the address.

  • Obol: check your cluster definition file or Launchpad configuration before deploying.

  • systemd (separate VC): inspect your validator service file (/etc/systemd/system/<validator-client>.service) and confirm the correct --fee-recipient or equivalent flag is set.

Note for systemd users, make sure you do not set the Fee Recipient for your Solo Staking validator keys to the Lido Execution Layer Rewards Vault.

Check client logs​

Most validator clients log the configured fee recipient address during startup. Check your startup logs and confirm that the fee recipient is set to the Lido Execution Layer Rewards Vault.

Seek Lido's help​

If you're running a validator client or using a custom setup not covered in this guide, and need help setting the correct fee recipient address, the Lido Community Validator Specialists (Chimera) are here to help.

Join the Lido Discord and tag:

@community-validator-support

We’ll assist you in configuring your setup correctly to avoid penalties.

PreviousMethod 2: Configure on separate validator clientNextUpload/Remove/View validator keys

Last updated