Skip to main content

Prerequisites

Before installing the 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:

IconConfigure Erigon and Reth

Preserve event logs to ensure the Operator Service functions correctly. Both clients require specific configuration to prevent event log pruning:

# 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.

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:

IconValidator Configuration

Configure your validator clients with the correct fee recipient address. You can find this address along with other essential Vault information in the Details section at the bottom of your Vault page in the StakeWise interface.

Deployed Vault​

Creating a New Vault​

If you don’t have a Vault yet, follow these steps:

IconVault Deployment Process
  1. Visit the StakeWise Operate page ↗ and connect your wallet
  2. Click Create Vault to begin configuration
  3. Follow the prompts to complete the setup
  4. Once the Vault is deployed, navigate to its page

You must have an active StakeWise Vault deployed and ready for operation.

IconUpgrade Vault Version

Upgrade your Vault to the required version before running the Operator Service:

  • Ethereum: Vault version 5
  • Gnosis: Vault version 3

You must upgrade your Vault to the latest version by logging in as a Vault Admin and clicking "Upgrade" at the top of the Vault page.

Finding Your Vault Address​

You will need the Vault contract address for Operator Service configuration:

IconWhere to Find Your Vault Address

Navigate to your Vault page — the address is included in the URL:

https://stakewise.io/vault/mainnet/0x1234567890abcdef...
                                   ^^^^^^^^^^^^^^^^^^^
                                    Your Vault Address

🎉 Congratulations! Your infrastructure is now ready for Operator Service installation ↗.

Last updated on