Staking and Un-staking Mechanisms
What happens behind the scenes when a user stakes or unstakes with Ike
Last updated
Copyright Water Cooler Studios, Inc. 2024
What happens behind the scenes when a user stakes or unstakes with Ike
Last updated
Staking on Ike involves the following order of operations:
AZERO Deposit: User deposits AZERO into the Vault contract by initiating a stake transaction.
Validator Forwarding: Vault contract checks the Registry contract to retrieve the current Target Weights. Vault contract checks all participating Validators to see how many AZERO are currently allocated to each. The Vault uses these sums to calculate the Current Weights (the percentage of the Total Pool held by each Validator). Vault contract uses the Constant Retargeting Algorithm to calculate how many of the newly submitted AZERO to forward to each of the Validators, and forwards them accordingly.
Receipt Token Issuance: Vault contract calculates the correct number of new shares (sA0) to create, using the current Redemption Ratio, and transfers them to the user. These sA0 serve as a receipt entitling the holder to their share of the Total Pooled. The sA0 tokens are fungible, can be traded and used elsewhere on the network, and can be used to redeem AZERO during the unstaking process. The number of new sA0 created, denoted here as newShares, is as follows:
where newStake is the number of newly deposited AZERO, totalShares is the Total Shares and totalPooled is the Total Pooled.
To see how this translates into a user's experience staking on Ike, see our docs on Staking with Ike.
As the Vault accepts new AZERO for staking it must delegate them across the participating Validators in such a way that aims to keep the amount delegated to each Validator consistent with the Target Weights stored in the Registry. In order to to do this, the Vault retrieves the Target Weights from the Registry and compares them to the current percentages of the Total Pool held by each of the participating Validators at that time. The Vault then calculates how much of the newly added AZERO should be delegated to each Validator in order to bring the current weights closer to the Target Weights stored in the Registry.
During the un-staking process, the Vault again uses the Target Weights from the Registry to decide how many AZERO to redeem from each Validator.
Ike involves some clever mechanisms to enable unstaking at scale, despite network-level constraints such as the Cooldown Period and Daily Unbonding Request Limits.
Unstaking on Ike involves the following order of operations:
Initiation: User calls Request Unlock, during which they submit their sA0 to the Vault.
Vault Sends Unlock Requests: The Vault automatically sends unlock requests to the Validators based on the Constant Retargeting Algorithm.
Cooldown Period: User must wait until Cooldown Period is over so that Validators are able to unbond the AZERO tokens.
Tokens returned to Vault: Anyone on the network can execute the delegateWithdrawUnbonded call, which forwards all newly unbonded AZERO held by the Validators back to the Vault, which can return them to users.
Token redemption: This is where the user can redeem their AZERO, including accrued yield. In order for this to happen, the Vault must have custody of the unbonded AZERO. There are two scenarios here:
If the newly unbonded AZERO are still held by Validators when a user tries to redeem theirs, the user must call redeemWithWithdraw. This first executes a delegateWithdrawUnbonded call, during which the Vault collects the unbonded AZERO from each of the Validator, and then executes the redeem call, which forwards the user's entitled portion of those AZERO from the Vault to the user's wallet.
If the Vault already has custody of the AZERO, the user can make a redeem call to the Vault, which sends the user's newly unstaked AZERO to their wallet. This scenario would happen when someone else has already executed the delegateWithdrawUnbonded call for this era.
Note: when a user uses the Ike GUI to redeem their claimable AZERO after the Cooldown Period, the GUI will intelligently decide whether to call redeemWithWithdraw or whether to simply call redeem.
To see how this translates into a user's experience staking on Ike, see our docs on Unstaking with Ike.
In order for the user to receive AZERO from the protocol, the Vault must make requests to each of the Validators, who in turn make requests to the Validators, to "unbond" (unstake) AZERO from network staking. These requests are enforced by the network and by the protocol, but they don't happen immediately.
