Prerequisites
Before installing and running the V3 Operator Service, ensure your node infrastructure meets the technical requirements below for reliable operation.
Execution Client
Your execution node must be fully synced and running. Any client that supports the ETH Execution API specification ↗ can be used:
- Nethermind ↗ — (Ethereum, Gnosis)
- Besu ↗ — (Ethereum)
- Erigon ↗ — (Ethereum, Gnosis)
- Geth ↗ — (Ethereum)
- Reth ↗ — (Ethereum)
Configure Erigon and Reth
Preserve event logs to ensure the Operator Service functions correctly. Both clients require specific configuration to prevent event log pruning:
- Erigon
- Reth
# Ethereum Mainnet
erigon --prune=receipts --prune.to=21471500
# For other networks, adjust the block number to the Keeper contract creation block
These flags prevent pruning of event logs required by the Operator Service.
Add the following setting to your reth.toml
:
[prune.segments.receipts_log_filter.0x6b5815467da09daa7dc83db21c9239d98bb487b5]
before = 21471500
The Keeper contract ↗ on Ethereum Mainnet is located at
0x6b5815467da09daa7dc83db21c9239d98bb487b5
(must be provided in lowercase).
Alternatively, to save disk space, you can use the block number at which the protocol configuration was updated. The actual values are defined in the network config ↗ within the Operator sources. See the CONFIG_UPDATE_EVENT_BLOCK
field for the selected network.
Consensus Client
Your consensus node must also be fully synced and running. Any client that supports the ETH Beacon Node API specification ↗ can be used:
- Lighthouse ↗ — (Ethereum, Gnosis)
- Nimbus ↗ — (Ethereum, Gnosis)
- Prysm ↗ — (Ethereum)
- Teku ↗ — (Ethereum, Gnosis)
- Lodestar ↗ — (Ethereum, Gnosis)
Validator Configuration
Configure your validator clients with the correct fee recipient address, which is available in the "Details" section of your Vault in the StakeWise interface.
Deployed Vault
You must have an active StakeWise Vault deployed and ready for operation.
Creating a New Vault
If you don't have a Vault yet, follow these steps:
Vault Deployment Process
- Visit the StakeWise Operate page ↗ and connect your wallet
- Click Create Vault to begin configuration
- Follow the prompts to complete the setup
- Once the Vault is deployed, navigate to its page
Finding Your Vault Address
You will need the Vault contract address for Operator Service configuration:
Where to Find Your Vault Address
- From URL
- From Details Section
Navigate to your Vault page — the address is included in the URL:
https://stakewise.io/vault/mainnet/0x1234567890abcdef...
^^^^^^^^^^^^^^^^^^^
Your Vault Address
- Go to your Vault page
- Scroll to the bottom to find the Details section
- Look for the Contract address field
- Copy the displayed address
Network Support
Supported Networks
- Ethereum Mainnet - Production network
- Hoodi Testnet - Primary Ethereum testnet
- Gnosis Chain - Alternative mainnet with GNO staking
- Chiado Testnet - Gnosis Chain testnet
Ensure your execution and consensus clients are connected to the same network and properly synchronized before starting the operator.
🎉 Once your infrastructure meets these requirements, you're ready to proceed with Installation →.