Skip to main content

Staking Flow

Before interacting with the API methods, it is useful to understand how native staking works on Sui.

Sui staking follows an object-based model. A wallet stakes SUI into a validator staking pool and receives stake-related on-chain objects. Unstaking is performed using the specific StakedSui object identifier.

All staking operations are executed on-chain. The Stakely Staking API crafts the required transactions, while signing and broadcasting are handled by your application.

Staking user journey​

A high-level view of what happens to your funds and the wait times involved. Each box is a state of your position; the arrows are the actions (and the time) that move between them.

Staking parameters​

Key parameters for planning a Sui integration:

ParameterValue
Staking typeNative
NetworksMainnet, Testnet
API minimum1 SUI
Stake activationNext epoch (~24h)
Unbonding / lock when exitingInstant (no unbonding period)
Rewards modelAccrues to the staked position
No unbonding on Sui

Sui has no unbonding or cooldown period. Unstaking a StakedSui object returns your principal plus accrued rewards to your wallet in the same transaction, as soon as it confirms. The only waiting period on Sui is on the way in: a new stake starts earning from the next epoch (~24h).

Stake​

Staking delegates a specified amount of SUI to a validator.

  1. Initiate Stake: Use the stake action to create a transaction that stakes a chosen amount to a validator.
  2. Transaction Confirmation: Once the transaction is confirmed on-chain, your StakedSui object is created. The stake begins earning rewards from the start of the next epoch (about 24h).
  3. Stake Objects: The wallet can then query staked positions and balances.

Unstake​

Unstaking withdraws stake from an existing StakedSui object. It is instant: there is no unbonding period or cooldown.

  1. Select Staked Object: Identify the staked_sui_object_id to unstake.
  2. Initiate Unstake: Use the unstake action to craft an unstake transaction.
  3. Transaction Confirmation: Once confirmed on-chain, the StakedSui object is consumed and your principal plus accrued rewards land back in your wallet immediately. No withdraw action or waiting period follows.

API interaction​