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

🔗 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.
Validator Types
0x01
Legacy validators: Fixed stake (32 ETH/1 GNO), no top-up funding available0x02
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.
Deep 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.
Deep 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.
Exit 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).
Deep 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.
Deep 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.