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

🐰Nym SRB

Learn how Nym staking rewards are calculated. NYMSRB is the realised, stake-weighted 30-day APR earned by NYM delegated to nym-nodes in the Nym mixnet, paid hourly from the mixmining reserve.

NYMSRB is a benchmark representing the realised, stake-weighted, annualized reward rate earned by NYM tokens delegated to nym-nodes in the Nym mixnet.

NYMSRB is calculated and published by Staking Rewards via the Nym Profile and Data API.

TL;DR: NYM is staked by delegating to nym-nodes (mixnodes and gateways), not to Nyx chain validators. Every hourly epoch the mixmining reserve pays the 240-node rewarded set, and each node's rewards compound into its delegations. NYMSRB measures what delegators actually earned over the last ~30 days (720 epochs), weighted by delegated stake, and annualizes it.

NYM staking is not Cosmos SDK validator staking. The Nyx chain's validators bond the separate NYX token, and the Nyx mint issues no new tokens. NYM has a fixed supply of 1,000,000,000; staking rewards are paid out of the pre-minted mixmining reserve held by the mixnet contract. The ATOMSRB formula therefore does not apply to NYM.

How NYM mixnet rewards work

  • Epochs and intervals. An epoch lasts 60 minutes. 720 epochs (30 days) form an interval.

  • Mixmining reserve. At each interval, a fixed fraction of the remaining reserve (currently 2%) becomes the interval's emission, split evenly across its 720 epochs as the epoch reward budget.

  • Rewarded set. At the start of every epoch, 240 nodes are selected probabilistically from all bonded nodes (currently 60 mixnodes, 80 entry gateways and 100 exit gateways). Selection favours performance and stake. Only nodes in the rewarded set earn in that epoch.

  • Node reward. A rewarded node's share of the epoch budget scales with its performance (0 to 1) and its stake saturation (0 to 1). Saturation is the node's total stake (operator pledge plus delegations) relative to the stake saturation point, currently about 257,354 NYM. Stake above the saturation point earns nothing extra and dilutes every staker on that node. A small premium (α = 0.3) rewards a larger operator pledge.

  • Distribution. From each node's reward, the operator first takes its declared operating cost (per interval, divided by 720), then its profit margin (currently 20-40%). The remainder is split pro rata across the operator pledge and every delegation, and compounds into them at the end of the epoch.

NYM Staking Rewards Rate: NYMSRB

Every nym-node keeps a cumulative reward index: the reward earned so far by one unit of delegation. The growth of that index over the observation window is exactly the return a delegator on that node earned, after operating cost, profit margin, performance and saturation.

ri=ui+TURi(t)ui+TURi(t−w)−1r_i = \frac{u_i + TUR_i(t)}{u_i + TUR_i(t - w)} - 1
NYMSRB=∑iDi(t−w)⋅ri∑iDi(t−w)⋅ty⋅24EwNYMSRB = \frac{\sum_i D_i(t - w) \cdot r_i}{\sum_i D_i(t - w)} \cdot \frac{t_y \cdot 24}{E_w}
Formula Key
Metric Name
Description

rir_i

Node Delegator Return

Return earned by one unit of delegation on node i over the window

uiu_i

Unit Delegation

The node's reward-index unit, in uNYM

TURiTUR_i

Total Unit Reward

The node's cumulative reward per unit of delegation

Di(t−w)D_i(t - w)

Delegated Tokens (node)

NYM delegated to node i at the start of the window

ww

Observation Window

About 30 days of blocks before the latest block

EwE_w

Window Epochs

Rewarded epochs elapsed in the window (latest rewarded epoch now minus latest rewarded epoch at the window start, about 720)

tyt_y

Year Constant

365 days (8,760 hourly epochs)

  • NYMSRB is realised, not projected: it is measured from the on-chain reward index, so it already reflects rewarded-set rotation, node performance, saturation, operating cost and profit margin.

  • It is weighted by delegated stake, so it is the rate earned by the average delegated NYM, including delegations on nodes that were rarely or never in the rewarded set.

  • Nodes bonded during the window have no starting weight and are excluded. Nodes that unbonded during the window are also excluded.

  • The rate is non-compounded: the window return is annualized linearly.

  • The annualization uses elapsed rewarded epochs rather than block time, so it does not depend on the chain's block rate.

  • If the window cannot be measured completely and consistently, no rate is published for that run. A missing value is never replaced by zero.

Slashing

NYM mixnet delegation has no slashing. An underperforming node earns less, or nothing, but the stake itself is not reduced.


NYM Validator Staking Rewards Rate: NYMSRB(v)

A node's delegator rate is its own realised return, ri⋅ty⋅24Ewr_i \cdot \frac{t_y \cdot 24}{E_w}. Operating cost and profit margin are already deducted inside rir_i, so no separate commission adjustment is applied. Node-level rates are not yet published on the Nym profile.


Observation Period

  1. The observation window ends at the latest block at the point of evaluation and starts about 30 days (about 720 hourly epochs) earlier.

  2. The window return is annualized for a comprehensive year-long projection.

Calculation Frequency

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

Limitations

  • The 365-day convention is used, with no leap-year adjustment.

  • NYMSRB is a trailing 30-day rate. It reflects the last interval's performance and does not forecast the next.

  • Individual delegators can earn considerably more or less than NYMSRB, depending on the node chosen (from 0% on nodes never selected to about 20% on the best nodes in a recent window).

  • Nyx chain validators also earn some transaction fees. These accrue to Nyx validators, not to NYM mixnet delegators, and are not part of NYMSRB.


NYM Real Reward Rate: NYMSRB^R

The real reward rate adjusts NYMSRB for inflation in the network.

NYMSRBR=1+NYMSRB1+ir−1NYMSRB^R = \frac{1 + NYMSRB}{1 + ir} - 1
Formula Key
Metric Name
Description

irir

Inflation Rate

Annual growth of the total NYM supply

Inflation Rate Behavior

NYM has a fixed total supply of 1,000,000,000 tokens and no protocol minting, so the inflation rate is 0% and NYMSRB^R equals NYMSRB. Staking rewards are paid from the pre-minted mixmining reserve: circulating supply grows as the reserve is paid out (about 22.5M NYM a year at current rates), but total supply does not.


Other Nym metrics calculated by Staking Rewards

Metric
Description

Staked Tokens

Total NYM bonded to nym-nodes: every node's operator pledge plus its delegations, including compounded rewards

Self Staked Tokens

NYM pledged by node operators to their own nodes (operator pledge)

Delegated Tokens

NYM delegated to nym-nodes by token holders

Active Staked Tokens

Stake on nodes in the current epoch's rewarded set. The set is re-selected every hour, so this value moves between readings

Active Validators

Number of nodes in the rewarded set (currently 240)

Total Validators

Number of bonded nym-nodes

Unstaking Time

An undelegation is queued and executed at the end of the current hourly epoch, so tokens are returned within at most 3,600 seconds. There is no lockup


Data Sources:

  • Staking Rewards from the Nym mixnet smart contract on the Nyx blockchain (current and archived contract state) and the Nym API.

  • Price and circulating supply from CoinGecko.


References:


📚 Learn more about NYM Staking

📊 Calculate your NYM Staking Rewards

⚙️ Access historic Nym Staking Data via API

Last updated