For the complete documentation index, see llms.txt. This page is also available as Markdown.

💧Sui SRB

Learn how Sui staking rewards are calculated. SUISRB formula covers 30-day average epoch rewards, total staked SUI, validator commission, and epoch-based distribution.

SUISRB is a benchmark representing the mean, annualized staking rate across all active Sui validators.

SUISRB is calculated and published by Staking Rewards via the Sui Profile and Data API.

TL;DR: Sui staking rewards are calculated from the 30-day rolling average of daily epoch rewards distributed to all validators, divided by total staked SUI and annualized over 365 days. The averaging window smooths fluctuations from variable epoch durations.

SUISRB=epochRewardsAvg30d×365/stakedTokensSUISRB = epochRewardsAvg30d \times 365 / stakedTokens
Formula key
Metric name
Description

epochRewardsAvg30d

30-Day Average Epoch Rewards

The 30-day rolling average of total daily staking rewards distributed to all validators. Derived from on-chain ValidatorEpochInfoEventV2 events, which record each validator's pool_staking_reward per epoch. Rewards are summed across all active validators and averaged over 30 days to smooth epoch-to-epoch variance.

stakedTokens

Staked Tokens

Total SUI tokens staked across all active validators, sourced from the sui_getLatestSuiSystemState RPC method (stakingPoolSuiBalance summed across all validators).

  • SUISRB is non-compounded and represents the staking rate before reinvesting rewards.

  • Includes both claimed and unclaimed staking rewards.

  • Epoch rewards are annualized using a 365-day year convention.

  • The 30-day averaging window smooths fluctuations from variable epoch durations and reward distributions.

Slashing

  1. SUISRB does not factor in the possibility of slashing occurrences.

  2. Sui does not currently implement token slashing for validators.


SUI Validator Staking Reward Rate: SUISRB(v)

Staking Rewards calculates the SUISRB for each validator using the APY values reported by the Sui RPC.

SUISRB(v)=apyMap(v)SUISRB(v) = apyMap(v)
Formula key
Metric name
Description

apyMap(v)

Validator APY

The APY for validator v as returned by the suix_getValidatorsApy RPC method. This reflects the validator's real achieved annualized yield, which already accounts for commission.

Note: If a validator does not appear in the APY map (e.g., newly activated), a fallback calculation is used: epochReward / stakedTokens * 365 * (1 - commission / 100), based on the validator's most recent epoch reward and its current commission rate.


Observation Period:

  1. The SUISRB is determined based on the latest epoch data at the point of evaluation.

  2. Epoch rewards are averaged over a 30-day rolling window.

  3. This data is then annualized for a comprehensive year-long projection.

Calculation

The calculation happens every 2 hours and is immediately published via Data API.

Limitations

  1. SUISRB employs a 365-day convention for annualizing epoch rewards. This convention remains consistent and does not accommodate adjustments for leap years.

  2. Epoch duration on Sui is approximately 24 hours but can vary. The 30-day averaging window mitigates this variability.

  3. SUISRB does not account for gas rebates or other non-staking rewards.

  4. Individual validator rates may differ from the asset-level benchmark depending on their commission rate and performance.

SUI Real Reward Rate: SUISRB^R

The real reward rate calculates the SUISRB adjusted for inflation in the network.

SUISRBR=(1+SUISRB)/(1+ir)1SUISRB^R = (1 + SUISRB) / (1 + ir) - 1
Formula key
Metric name
Description

ir

Inflation Rate

The annualized inflation rate, computed as: epochRewardsAvg30d * 365 / circulatingSupply, where circulatingSupply is sourced from CoinGecko market data.

Inflation Rate Behavior

Sui's inflation is determined by the staking reward distribution mechanism. Validators receive SUI tokens as staking rewards from a pre-defined supply schedule. The effective inflation rate depends on the total epoch rewards distributed relative to the circulating supply. Unlike chains with a fixed inflation schedule, Sui's reward distribution is governed by the protocol's tokenomics and storage fund mechanics.


Other Sui metrics calculated by Staking Rewards:

Metric
Description

Delegated Tokens

The number of SUI tokens delegated to validators (total staked minus self-staked).

Self Staked Tokens

The number of SUI tokens staked by validators from their own wallet, derived from suix_getStakes for the validator's address.

Staking Wallets

Total number of unique delegations per validator, sourced from the Blockberry validators API.

Epoch Rewards

Total staking rewards distributed in the latest epoch, sourced from on-chain ValidatorEpochInfoEventV2 events.

Epoch Duration

Duration of the current epoch in seconds, derived from the epochDurationMs field in system state.

Data Sources:


References:


📚 Learn more about SUI Staking

📊 Calculate your SUI Staking Rewards

⚙️ Access historic Sui Staking Data via API

Last updated