Skip to main content

Validator Exit Bot

Introduction​

Validator Exit Bot automates triggering exits for Lido validators that have missed their exit deadline. The bot monitors the ValidatorExitBusOracle for exit requests, checks the current status of each validator on the beacon chain, and uses EIP-7002 triggerable exits to force the exit of any validator that has not exited on time. Exit trigger fees are paid from the bot's account and refunded by the withdrawal vault.

Requirements​

Hardware​

  • 1-core CPU
  • 1GB RAM

Nodes​

  • Ethereum EL RPC service
  • Ethereum CL API service (Beacon Node)

How to use​

On startup the bot fetches historical ExitDataProcessing events from the ValidatorExitBusOracle for the configured lookback period. It then runs in a continuous loop: for each validator in its state, the bot checks whether the validator has already exited on the CL, and if not, whether it has missed its exit deadline. Validators past their deadline are included in a batched trigger_exits transaction. The bot's address is set as the refund recipient to recover the per-validator withdrawal request fee.

Envs​

Required variables are (mainnet):

VariableDefaultDescription
WEB3_RPC_ENDPOINTS-Comma-separated list of EL RPC endpoints
CONSENSUS_CLIENT_URL-CL Beacon API endpoint
WALLET_PRIVATE_KEY-Private key used to send transactions. Omit to run in dry mode (no transactions sent)
LIDO_LOCATOR0xC1d0b3DE6792Bf6b4b37EccdcC24e45978Cfd2EbLido Locator address for Ethereum mainnet. Addresses for other supported networks can be found here
DRY_RUNfalseIf true, transactions are built but not submitted

Optional variables can be found here.

Running​

Source Code​

  1. Clone repository and install requirements: 
    git clone git@github.com:lidofinance/validator-exit-bot.git
    cd validator-exit-bot
  2. Install requirements: 
    poetry install
  3. Run validator exit bot: 
    poetry run python -m src.main

Docker​

Docker image can be found here.

Monitoring​

Prometheus metrics will be available on endpoint http://localhost:${PROMETHEUS_PORT}/metrics.

Health check endpoint: http://localhost:${SERVER_PORT}/health.