Operators
Tokenomics

Nym Tokenomics

ℹ️

The data on this page were last time updated on

Monday, December 23rd 2024, 11:36:26 UTC

.

Nym Network is composed of two main elements, the Mixnet represented by Nym Nodes routing and mixing the data packets, and Nyx blockchain distributted accros validator set, using smart contracts (based on cosmwasm (opens in a new tab)) to monitor and reward Nym Nodes by querying API endpoints and distributing NYM token to operators according to work done by their nodes. All Nym nodes and validators are run by decentralised community of operators.

NYM Token: Incentivise Stability & Secure Reputation

Besides the Mixnet itself, Nym Network is secured by its own blockchain Nyx (IBC on Cosmos) with a native token NYM.

NYM token key features

  • Incentives: Distribute rewards to decentralised nodes based on mixing and routing (work). This dynamic ensures that the network is as robust as possible - the nodes are chosen every hour according to their performance.

  • Network take over defense: Another decisive factor for a node to be chosen to the network active set is reputation. Reputation is a size of stake (delegation) where delegators earn proportional percentage of nodes rewards. Nodes without reputation are not chosen to take part in the network active set.

  • Centralisation defense: Any node can only have a certain stake (called stake saturation) to earn maximum rewards, increasing stake level per node leads to decreasing rewards for the operator and all delegators. This feature makes it more difficult for whales to over-stake their nodes or to attract more delegators (stakers) as they would become dis-advantaged.

To learn more about rewards calculation and distribution, read the next page Nym Mixnet Rewards.

Utility

NYM token is a first and foremost a utility to secure Nym Network.

Nyx blockchain's validators run API to monitor the network and node performance. Based on the live input the operators and stakers of the working nodes get rewarded. The network is adjusted and re-randomized in the beginning of each epoch (60 min) composing the best performing nodes with the highest reputation.

This creates an incentive for people to operate Nym nodes as quality and reliable service. The reputation system also works as a network defense against a large adversary take over or sybil attacks.

Node reputation is calculated by delegation. Delegation is a stake done by NYM token holders on top of nodes they want to support to join the network as it compensate the stakers with APR. Therefore there is an incentive for NYM holders to stake their token on top of nodes which they believe will perform well.

To prevent a whale takeover and centralisation, the revenue grows alongside nodes stake size only until a certain point, after which the rewards per staker start to decrease. We call this mark node stake saturation.

Thanks to Nyx blockchain API monitoring, the flow is dynamic and constantly optimized based on live metrics. Below is a detailed explanation and reckoning of Nym tokenomics logic.

Tokenomics

Summary in Numbers

Below is a table with token supply distribution.

ItemDescriptionAmount in NYM
Total SupplyMaximum amount of NYM token in existence1_000_000_000
Mixmining ReserveTokens releasing for operators rewards195_439_368
Vesting TokensTokens locked outside of cicrulation for future claim500
Circulating SupplyAmount of unlocked tokens804_560_131
Stake SaturationOptimal size of node self-bond + delegation1_020_023

To get live data, visit Nym token page (opens in a new tab) or see how to query API endpoints.

Calculation & Explanation

To get a full comprehension of node operators rewards calculation and delegators APR height (opens in a new tab), we need to understand some basic logic behind the numbers presented. This chapter covers some of the most essential variables in Nym tokenomics flow.


 ┌───────────┐   staking   ┌───────────┐   sum of      ┌───────────┐
 │           │   supply    │           │   nym nodes   │           │
 │circulating│   scale     │  staking  │   in rewarded │   stake   │
 │  supply   │   factor    │  target   │   set         │saturation │
 │           ├────────────►│           ├──────────────►│           │
 └───────────┘             └───────────┘               └───────────┘

Supply


Circulating supply is

804_560_131

NYM.

NYM token is capped at 1b. Visit Nym token page (opens in a new tab) to see live data and graphs.

Staking target

A number of aimed NYM tokens to be staked in the network. The staking target a is multiplier of staking supply scale factor and circulating supply.

📌

staking_target = staking_supply_scale_factor * circulating_supply

Staking supply scale factor is currently it's set to be

50.0%

.

The value of this variable can be changed to optimize the metrics of the network. With a current circulating supply of

804_560_131

NYM and staking supply scale factor

50.0%

, the staking target is

402_280_065

NYM.

Stake saturation

Node reputation in a form of self bond or stakers delegation. Stake saturation is calculated as:

📌

stake_saturation = staking_target / rewarded_set_size

rewarded_set_size = active_set_size + standby_set_size

With current circulating supply of

804_560_131

NYM, staking target of

402_280_065

NYM, divided by the sum of nodes in the rewarded set (opens in a new tab), the stake saturation level is

1_020_023

NYM per node.

Active set

Nym Network needs an optimised number of nodes to route and mix the packets. This healthy balance lies in between being too congested - which would detriment speed and user experience - on one side, and having too little traffic per node - which would could weaken anonymity - on the other.

The way how we approach this challenge is different for Mixnet (5-hop) and dVPN (2-hop) mode.

In both cases, the selection algorithm also looks whether the node runs with Terms & Conditions accepted AND if it's not a legacy binary version. In case either of these criterias are not met, the node will have be excluded from the rewarded set selection.

To read more about rewards calculation, please see next page Nym Operators Rewards.

Query Validator API

We have available API endpoints which can be accessed via Swagger UI page (opens in a new tab). Or by querying the endpoints directly:

curl -X 'GET' \
  'https://validator.nymtech.net/api/v1/circulating-supply' \
  -H 'accept: application/json'sh
 
curl -X 'GET' \
  'https://validator.nymtech.net/api/v1/circulating-supply/total-supply-value' \
-H 'accept: application/json'sh
 
 
curl -X 'GET' \
  'https://validator.nymtech.net/api/v1/circulating-supply-value' \
-H 'accept: application/json'sh
 
curl -X 'GET' \
  'https://validator.nymtech.net/api/v1/epoch/reward_params' \
-H 'accept: application/json'sh

The unit of value is measured in uNYM.

📌

1 NYM = 1_000_000 uNYM