Configuration

Configure modes, networks, and environment variables

Environment Variables

.env
LIDO_MODE=simulation          # "simulation" or "live"
PRIVATE_KEY=0x...             # Your wallet private key
HOODI_RPC_URL=https://eth-hoodi.g.alchemy.com/v2/9GGes9QipD09NUv7CJue2
MAINNET_RPC_URL=https://eth.llamarpc.com
REFERRAL_ADDRESS=0x0000000000000000000000000000000000000000

Modes

Simulation (Default)

  • All write operations return dry-run results
  • Shows estimated gas, expected outputs, and notes
  • Pass dry_run: false explicitly to broadcast on testnet
  • Safe for testing and demos

Live

  • Write operations execute real transactions
  • Requires a funded wallet with a private key
  • Pass dry_run: true to simulate before broadcasting
  • Use with caution on mainnet

Mode × Network Matrix

ModeTestnet (Hoodi)Mainnet (Ethereum)
SimulationDry-run on HoodiDry-run on mainnet
LiveReal txs on Hoodi (safe)Real txs on mainnet (real funds)
⚠
Live mode on mainnet uses real ETH. Always start with Hoodi testnet.