📖Story SRB

IP Staking Rewards Benchmark (IPSRB™) Methodology

IPSRB is a benchmark representing the mean, annualized staking rate across all active Story validators.

IPSRB is calculated and published by Staking Rewards via the Story Profilearrow-up-right and Data APIarrow-up-right.

IPSRB=estimatedAPRIPSRB = estimatedAPR
Formula key
Metric name
Description

estimatedAPR

Estimated APR

The annualized staking reward rate published by the Story Foundation staking API, derived from on-chain staking pool parameters and inflation mechanics.

  • IPSRB takes into account all accumulated rewards, whether they have been claimed or remain unclaimed.

  • IPSRB operates on a non-compounded basis, meaning it excludes returns generated from the reinvestment of rewards.

  • Story is a Cosmos SDK + EVM hybrid chain. The staking layer follows Cosmos SDK delegation mechanics while execution runs on the EVM.

Slashing

circle-info

Story implements slashing for validators. Validators can be slashed for double-signing and extended downtime. Delegators share in slashing penalties proportional to their delegation.


Story Validator Staking Rewards Rate: IPSRB(v)

Staking Rewards calculates the IPSRB for each validator based on their individual commission rate and uptime.

IPSRB(v)=IPSRB(1cr)uIPSRB(v) = IPSRB * (1 - cr) * u
Formula key
Metric name
Description

cr

Commission Rate

The percentage commission rate the validator has set as a delegation fee for all delegators.

u

Uptime

The validator's uptime percentage, representing availability and participation in consensus.


Observation Period:

  1. IPSRB is determined based on the latest staking pool state and validator set at the point of evaluation.

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

Calculation

The calculation happens every 2 hours and is immediately published via Data APIarrow-up-right.

Limitations

  • IPSRB employs a 365-day convention for annualizing staking rewards. This convention remains consistent and does not accommodate adjustments for leap years.

  • The estimated APR is sourced from the Story Foundation staking API and reflects the protocol's own calculation of expected returns.

  • Individual validator returns vary based on commission rates and uptime.


IP Real Reward Rate (IPSRB^R)

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

IPSRBR=(1+IPSRB)/(1+i)1IPSRB^R = (1+IPSRB) /(1+i)-1
Formula key
Metric name
Description

i

Inflation Rate

The annual inflation rate, calculated as inflations_per_year divided by the total token supply.

Inflation Rate Behaviour

Story's inflation is governed by Cosmos SDK mint parameters. The inflations_per_year parameter defines the total new IP tokens minted annually. The inflation rate is calculated as:

ir=inflationsPerYear/totalSupplyir = inflationsPerYear / totalSupply

This rate adjusts dynamically as the total supply grows. The inflation mechanism is controlled by on-chain governance parameters via the Cosmos mint module.


Other Story metrics calculated by Staking Rewards:

Metric
Description

Delegated Tokens

The number of IP tokens delegated to validators by external delegators.

Self Staked Tokens

The number of IP tokens staked by validators directly from their own balance.

Staking Wallets

The total number of unique delegations on-chain.


Data Sources:

  • Story Foundation Staking API (staking.storyapis.com) for estimated APR, staking pool data, and validator information

  • Story Cosmos RPC (mainnet.storyrpc.io) for mint parameters and inflation data

  • CoinGecko (price, circulating supply, total supply)


References:


📚 Learn more about IP Stakingarrow-up-right

📊 Calculate your IP Staking Rewardsarrow-up-right

⚙️ Access historic Story Staking Data via APIarrow-up-right

Last updated