About

Our native MON staking integration lets users delegate to any validator in the active set. When you stake MON, your delegation becomes active and starts earning rewards from the next era onward.

Staking rewards are accrued over each era and updated at the end of that era. Rewards are not auto-compounded — users can either claim them manually (adding rewards to their available balance) or restake them (adding rewards to the staked balance and compounding future rewards).

In practice, if a user delegates during era N, the stake begins earning from era N+1 onward and no additional action is required. When unstaking, the position is scheduled to exit in the following era (or two, if the unstake action was completed after the given era's boundary block). After the unstaking period is complete, the user must withdraw the unstaked MON to move it back into their available balance.

Pending Actions

Claim Rewards

Staking rewards accrue to a rewards balance that you can track via our /stake/balances endpoint. To claim these rewards to the users available balance, the CLAIM_REWARDS pending action is available.

Restake Rewards

Staking rewards accrue to a rewards balance that you can track via our /stake/balances endpoint. To claim and restake these rewards, the RESTAKE_REWARDS pending action is available.

Withdraw

After the unstaking period has passed, the user will need to use the WITHDRAW pending actions from their unstaked balance to make it available again. You can track both unstaking progress as well as the balance available to be withdrawn via our /stake/balances endpoint.

Considerations

1. Boundary blocks and staking/unstaking wait time:

   Every 50,000 blocks, a boundary block is produced. That block locks in all pending staking changes (including unstakes) for the next epoch. Whether an unstake takes one era or two depends on when it’s submitted relative to the boundary block:

   1. If users unstake before the boundary block, it’s picked up for the next era.
   2. If users unstake at or after the boundary block has just passed, it won’t be included until the following one, so it effectively takes two eras before the MON is fully unstaked and withdrawable.

Preferred Validators And Their IDs