Skip to main content

Overview

StakeWise is a decentralized liquid staking protocol that allows anyone to participate in Ethereum staking without the traditional barriers of technical complexity or capital requirements. The protocol enables users to stake their ETH while maintaining liquidity through osToken →, StakeWise's liquid staking token.

At the core of StakeWise are individual staking pools called Vaults →. Anyone – from solo stakers to professional operators – can create and operate their own Vault, offering flexible staking solutions that serve diverse needs: solo stakers can access liquid staking for their own ETH, while individuals and organizations can stake on their terms and offer liquid staking services to others.

Deploying a Vault requires running the StakeWise Operator Service ↗ – specialized software that manages validator operations and ensures your Vault functions properly. Each Vault must have at least one node operator running this service to handle validator registrations, exits, and other critical operations that keep the Vault operational.

🏛️ Architecture Overview

Vault Your Vault
🎯 Operator Service
🛠️ Execution Node

🔗 Consensus Node

Core Functions

The Operator Service integrates seamlessly with any node setup, supporting your preferred execution and consensus clients, MEV relay, and distributed validator technology.

The Operator Service automates essential Vault management tasks:

Validator Registration

The Operator Service periodically checks whether the Vault has accumulated enough assets for registering new validators and sends a registration transaction to the Vault.

IconValidator Types
  • 0x01 Legacy validators: Fixed stake (32 ETH/1 GNO), no top-up funding available
  • 0x02 Compound validators: Variable stake up to 2048 ETH or 64 GNO, supports automatic funding

By default, the Operator Service registers new 0x02 validators, prioritizing funding existing compound validators when possible; otherwise, it registers new validators up to the maximum balance.

IconDeep Dive

For detailed information about the validator registration process, see Validator Registration →

Validator Consolidation

The Operator Service consolidates legacy 0x01 validators to 0x02 compound validators.

IconDeep Dive

For detailed instructions on consolidating validators, see Consolidate Validators →

Withdrawals

When a user requests to exit their stake, the Operator Service identifies the validators from which to withdraw the assets. It first triggers partial withdrawals for the 0x02 validators, starting with the one holding the largest balance. If partial withdrawals are insufficient, it proceeds with full withdrawals.

IconExit Queue Monitoring

To minimize the number of withdrawal transactions, the Operator Service submits a withdrawal transaction once every 12 hours (this interval can be reconfigured).

IconDeep Dive

For detailed instructions on exiting validators manually, see Manual Exit →

Vault State Update

Keeps your Vault synced by calling the updateState function of the Vault contract. This can be configured to run automatically every 12 hours, simplifying contract interactions and reducing gas costs for your users. By default, the Vault state sync is included in the transaction whenever the user interacts with the Vault (deposits, withdrawals, etc.).

Automated Fee Claims

By default, the fees earned by the Vault's fee recipient remain locked in the validators. You can enable periodic fee claims through the Operator Service. In this case, the earned fees will be claimed from the Vault and sent directly to the fee recipients.

IconDeep Dive

For detailed instructions on enabling fee claiming, see Fee Claiming →

Next Steps

Before running the Operator Service, you must first ensure your infrastructure meets the necessary Prerequisites → outlined in the next section.