Skip to content

Commit 2be5243

Browse files
DinonardIvan Andrisekandabak
authored
Tokenomics 2.0 docs (#553)
* Tokenomics 2.0 * Updates * Fix broken link. * Minor deployment update * Update index.md * Update index.md fix link * Review fixes * clarification on voting era + extened info in example that follows --------- Co-authored-by: Ivan Andrisek <ivan@Ivans-MBP.fritz.box> Co-authored-by: Ivan <95318860+andabak@users.noreply.github.com>
1 parent 6b1e427 commit 2be5243

File tree

4 files changed

+199
-32
lines changed

4 files changed

+199
-32
lines changed

docs/learn/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ To expand your knowledge about building applications or utilizing various tools
1919
[Smart Contracts](/docs/learn/smart-contracts)
2020

2121
## Advanced
22-
[Tokenomics](/docs/learn/tokenomics/)
22+
[Tokenomics](/docs/learn/tokenomics2)
2323

2424
[Networks](/docs/learn/networks)
2525

docs/learn/tokenomics2/Inflation.md

Lines changed: 152 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -2,33 +2,166 @@
22
sidebar_position: 2
33
---
44

5-
## Hybdrid Inflation model
5+
Astar has a soft-capped 'yearly' inflation and uncapped max supply.
6+
Inflation is distributed amongst actors in the network, in varying proportions.
7+
Actors include:
8+
* stakers
9+
* dApp owners
10+
* collators
11+
* treasury
612

7-
The new inflation model will be preceded by an intermediate phase known as the hybrid inflation model. This transitional phase encompasses these modifications:
813

9-
### Inflation Adjustment
14+
## Basic Time Units
1015

11-
Inflation rates have been lowered. The maximum token reward per block, reached based on the optimal staking rate or staking TVL (Total Value Locked), has been reduced from 253.08 to 231.20. Please note that this is temporary until the next phase of Tokenomics 2.0 coming with dApp Staking v3.
16+
### Cycles
17+
**Cycle** can be considered as a 'year' in the Astar Network.
18+
When a new cycle starts, new inflation configuration is calculated according to the total issuance at that point in time.
19+
E.g. if 'yearly' inflation is set to be 7%, and total issuance is 1,000,000 ASTR, then the soft-capped max inflation for that
20+
cycle will be 70,000 ASTR.
1221

13-
### Treasury rewards
22+
Cycle length is configurable, but in practice it will resemble a 'year' off-chain.
1423

15-
The dynamic treasury allocation has been removed in favor of a fixed annual inflation rate of 5%. Which correspond to a reward of 11.06 ASTR per block.
24+
$inflation\_soft\_cap = inflation\_rate * total\_issuance$
1625

17-
### Collators rewards
26+
### Periods
1827

19-
Collators will now receive a steady 3.2% of the annual inflation which correspond to a reward of 7.07 ASTR per block. Although this represents a reduction from the previous model, the upcoming alignment of EVM fees and Substrate native fees is expected to increase overall fee earnings for collators.
28+
Each **cycle** consists of one or more **periods**.
29+
**Periods** are a core time unit in the dApp Staking protocol. Each period consists of a `Voting` and `Build&Earn` subperiods.
2030

21-
### Stakers & dApp Rewards
31+
During the `Voting` subperiod, neither stakers nor dApp owners can earn any rewards, only _collators_ and _treasury_ continue earning.
32+
During the the `Build&Earn` subperiod, stakers earn staking rewards per **era** and have the opportunity to earn bonus reward at the end of a period.
33+
dApp owners also earn rewards, based on how well their dApp is performing in dApp staking, at the end of each **era**.
2234

23-
The rewards for dApp staking, both for users and dApps, will remain unchanged in absolute terms. No immediate modifications will be implemented in this area. Future updates, including the introduction of dApp staking v3, will occur in the third phase of Tokenomics 2.0.
35+
### Eras
2436

25-
We use the blockReward distribution to ensure those three requirements (and calculate them from the reward per block):
37+
Each **period** is divided up into multiple **eras**.
38+
**Era** is the core time unit in dApp staking, and its length is measured in the number of blocks.
2639

27-
| | Percentage | Reward ASTR |
28-
|------------------|------------|-------------|
29-
| Block reward | 100% | 231.20 |
30-
| Treasury | 4.78% | 11.06 |
31-
| Collators | 3.06% | 7.07 |
32-
| dApp reward | 17.27% | 39.93 |
33-
| Base Staker | 23.04% | 53.27 |
34-
| Ajustable Staker | 51.84% | 119.85 |
40+
`BuildAndEarn` subperiod consists of one or more _standard_ **eras**. Each era has a fixed length.
41+
`Voting` subperiod always consists of exactly **one era** and this _voting_ era is unique as its length (in blocks) can be longer than a _standard_ era length (but always a multiple of _standard_ era length).
42+
43+
### Example
44+
45+
* Block is produced every 12 seconds
46+
* **Era length** is 7200 blocks which equals 24 hours (1 day) (This is _standard_ era length)
47+
* `Voting` subperiod length is 10 eras (This is the single _voting_ era which lasts 10 x 7700 blocks)
48+
* `Build&Earn` subperiod length is 81 eras
49+
* Cycle length is **4 periods**
50+
51+
With such configuration, we'd end up with a cycle lasting 364 days (roughly a year), and each period taking around 3 months to complete.
52+
53+
## Recalculation
54+
55+
When a new cycle begins, soft-inflation cap is recalculated, and according to the calculated value, rewards for all network actors are adjusted.
56+
57+
The reason why it's a _soft-cap_, instead of a _hard-cap_ is how staker & dApp rewards are distributed.
58+
Rewards are only minted when they are claimed, and it is possible that at the time of reward recalculation, some rewards remain unclaimed.
59+
As a result, theoretically, it's possible for the cycle inflation to exceed the _soft-cap_ even though in practice it will be highly unlikely
60+
due to _lazy minting_ & _fee burn_ mechanisms.
61+
62+
## Inflation Distribution
63+
64+
Based on the calculated _soft-cap_, rewards for all network participants are adjusted.
65+
66+
### Collators
67+
68+
_Collators_ get a fixed amount of the cycle's _soft-capped_ inflation.
69+
This amount is equally divided by the number of blocks in the cycle.
70+
71+
$collator\_reward\_per\_block = \frac{total\_collator\_cycle\_reward}{blocks\_per\_cycle}$
72+
73+
### Treasury
74+
75+
Similar to the _collators_, treasury gets a fixed amount of the cycle's _soft-capped_ inflation
76+
distributed in equal amounts throughout all the blocks in the cycle.
77+
78+
$treasury\_reward\_per\_block = \frac{total\_treasury\_cycle\_reward}{blocks\_per\_cycle}$
79+
80+
### dApps
81+
82+
dApp reward are _assigned_ at the end of each era during `Build&Earn` subperiod.
83+
This means that the total cycle's dApp reward amount has to be equally divided by the total number of `Build&Earn` eras in a cycle.
84+
85+
$dapp\_reward\_pool\_per\_era = \frac{total\_dapp\_cycle\_reward}{periods\_per\_cycle * eras\_per\_build\_and\_earn}$
86+
87+
The dApp staking protocol will calculate how much each staked dApp should get.
88+
89+
### Stakers
90+
91+
There are two components to the staker rewards - regular _staking_ rewards & the _bonus_ reward for loyal stakers.
92+
93+
#### Regular Staker Rewards
94+
95+
Regular staker rewards are awarded for staking native currency, **ASTR**, on a dApp.
96+
These rewards have two components - the _base_ reward and the _adjustable_ reward.
97+
98+
Base reward is the amount assigned to the reward pool at the end of each era regardless of how much has been staked in total.
99+
100+
$base\_staker\_reward\_pool\_per\_era = \frac{total\_base\_staker\_cycle\_reward}{number\_of\_cycles * eras\_per\_build\_and\_earn}$
101+
102+
The adjustable part is the dynamic part, and depends on the _total value staked_ and the _target stake value_.
103+
This amount linearly increases as the _total value staked_ increases, and then saturates once the amount is reached or exceeded.
104+
With this component, _staker rewards_ are not a _zero-sum game_.
105+
106+
$max_\_adjustable\_staker\_reward\_pool\_per\_era = \frac{total\_adjustable\_staker\_cycle\_reward}{number\_of\_cycles * eras\_per\_build\_and\_earn}$
107+
108+
The adjustable part of the reward is calculated once an era ends, using the _total value staked_ at that point in time.
109+
110+
$adjustable\_factor = min(1, \frac{total\_value\_staked\_percent}{ideal\_staking\_percent})$
111+
112+
Using the _adjustable\_factor_, adjustable portion of the staker reward is:
113+
114+
$adjustable\_staker\_reward\_pool = max_\_adjustable\_staker\_reward\_pool\_per\_era * adjustable\_factor$
115+
116+
When the _adjustable factor_ is less than **1**, it means the remainder is never minted, reducing the overall inflation.
117+
118+
With the above formulas, we can finally express how much staker _Alice_ earns in era **n**:
119+
120+
$staker\_reward\_per\_era_{Alice} = \frac{staked\_value_{Alice,n}}{total\_staked\_value_n} * (base\_staker\_reward\_pool\_per\_era_n + adjustable\_staker\_reward\_pool_n)$
121+
122+
#### Bonus Rewards
123+
124+
In case a staker stakes during the `Voting` subperiod, and doesn't reduce their stake during the `Build&Earn` subperiod below what
125+
was staked at the end of the `Voting` subperiod, it will make them eligible for the bonus reward.
126+
127+
Bonus reward pool is assigned per period, and can be expressed as:
128+
129+
$bonus\_reward\_pool\_per\_period = \frac{total\_bonus\_cycle\_reward}{periods\_per\_cycle}$
130+
131+
The bonus reward for a staker _Alice_ can then be expressed as:
132+
133+
$bonus\_staker\_reward_{Alice} = \frac{voting\_subperiod\_staked\_value_{Alice}}{total\_voting\_subperiod\_staked\_value} * (bonus\_reward\_pool\_per\_period)$
134+
135+
## Lazy Minting
136+
137+
Both _staker_ and _dApp_ rewards are minted in a lazy fashion - when they are needed. Only collator & treasury rewards are minted per block.
138+
139+
With the _adjustable staker reward_ and the dApp staking tier system, the inflation in practice will be much lower than the calculated _soft-cap_.
140+
Maximum adjustable award amounts is possible only if the ideal staking rate is reached or exceeded.
141+
For the dApp rewards, it's unlikely that all of the tiers will be filled with dApps - it might be that the tier capacity is larger than the demand,
142+
or that simply some dApps don't attract enough support to enter a tier. These rewards will never be even minted thus lowering the effective inflation rate.
143+
144+
Rewards don't persist forever, and must be claimed before they _expire_.
145+
Although this is expected to be very lenient, it's still possible to happen.
146+
147+
None of the aforementioned mechanism are _burn_ mechanisms, instead they just delay the _minting_ operation until it's needed.
148+
The major burn mechanism is part of the fee system, where a significant portion of fees get burned.
149+
Only due to this, it's practically impossible for the _soft-capped max inflation_ to be reached when considering rewards assigned & issued during
150+
a single cycle.
151+
152+
## Parameters
153+
154+
| | Shibuya |
155+
|--------------------------|---------------|
156+
| Periods Per Cycle | 2 |
157+
| Eras Per Voting Subperiod| 8 |
158+
| Eras Per Build&Earn Subperiod | 20 |
159+
| Blocks Per Era | 1800 (~6 hours) |
160+
| Cycle Inflation Rate | 1% |
161+
| Treasury Part | 5% |
162+
| Collators Part | 3% |
163+
| dApps Part | 20% |
164+
| Base Staker Part | 25% |
165+
| Adjustable Staker Part | 35% |
166+
| Bonus Part | 12% |
167+
| Ideal Staking Rate | 20% |

docs/learn/tokenomics2/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Astar Network is currently in a phased transition to a Tokenomics 2.0 model. The
1212

1313
Content to this section will be added as changes get enacted (go live).
1414

15-
Overview of current Astar Network's Tokenomics are documented **[here](../tokenomics)**
15+
Overview of current Astar Network's Tokenomics are documented **[here](../tokenomics2)**
1616

1717
The outline of the phased approach to Tokenomics 2.0:
1818
- Phase 0 - Forum Discussion:
@@ -26,7 +26,7 @@ The outline of the phased approach to Tokenomics 2.0:
2626
- ✅ Shiden - live since Decemeber 2023
2727
- ✅ Astar - live since December 2023
2828
- Phase 3 - Full Inflation Model (activation of dAppStaking v3 which affects block reward calculation, further reduction of inflation)
29-
- Shibuya testnet - parameters defined, implementation in progress
29+
- Shibuya testnet - live since December 2023
3030
- Shiden - parameters defined, implementation in progress
3131
- Astar - parameters defined, implementation in progress
3232
:::

docs/learn/tokenomics.md renamed to docs/learn/tokenomics2/legacy_inflation.md

Lines changed: 44 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,22 @@
11
---
2-
sidebar_position: 10
3-
title: Tokenomics
2+
sidebar_position: 3
3+
title: Legacy Tokenomics
44
---
55

6+
:::note
7+
The following subchapters cover legacy Astar tokenomics models.
8+
For the latest, please refer to the _Tokenomics 2.0_ model.
9+
:::
10+
11+
# Tokenomics 1.0
12+
613
import tokenomics from '/docs/learn/img/tokenomics_1.png'
714
import inflation from '/docs/learn/img/inflation_1.png'
815

916
[Astar Network]: https://astar.network/
1017

11-
:::note
12-
This section includes content for advanced users.
13-
:::
14-
1518
:::tip
16-
Astar and Shiden share the same economic model, though there were differences in their initial supply configurations.
19+
Astar and Shiden sharde the same economic model, though there were differences in their initial supply configurations.
1720
The following chapters focus on Astar and ASTR, however, this information also applies to Shiden and SDN token.
1821
:::
1922

@@ -46,7 +49,7 @@ The reader might notice that Astar issues 95 times more tokens per block than Sh
4649

4750
Each block reward is distributed to a set of beneficiaries.
4851
49-
#### > Collators
52+
#### Collators
5053

5154
The collator responsible for building the block will receive **collator's** portion of reward. This is the main financial incentive for the collators. Portion is configured as percentage of the block reward on-chain and is constant per block unless manually changed.
5255

@@ -55,11 +58,11 @@ In addition, it will receive fees paid by the users for transactions that were i
5558
For **Shiden**, **100%** of the fees are burned, and the full tip is paid to the collator.
5659
For **Astar**, **20%** of the fees & tips are burned, and the rest is paid to the collator.
5760

58-
#### > On-chain Treasury
61+
#### On-chain Treasury
5962

6063
Treasury receives a variable portion of block reward. It is then allocated to a range of initiatives across the Astar ecosystem. This includes building reserves for parachain auctions, as well as supporting various projects and activities that help grow and strengthen our network.
6164

62-
#### > dApp Staking
65+
#### dApp Staking
6366

6467
`dApp staking`, Astar's innovative developer incentive mechanism, receives a variable portion of the block rewards depending on current **total value locked** (or **TVL** in further text) in dApps staking.
6568

@@ -154,3 +157,34 @@ The following graph is a visualization of the described model.
154157
</div>
155158

156159
You can check this model and configure parameters yourself [here](https://www.desmos.com/calculator/cjjkt6smk5).
160+
161+
# Hybrid Inflation
162+
163+
The hybrid inflation model served as a step between the _Tokenomics 1.0_ and _Tokenomics 2.0_.
164+
165+
### Inflation Adjustment
166+
167+
Inflation rates have been lowered. The maximum token reward per block, reached based on the optimal staking rate or staking TVL (Total Value Locked), has been reduced from 253.08 to 231.20. Please note that this is temporary until the next phase of Tokenomics 2.0 coming with dApp Staking v3.
168+
169+
### Treasury rewards
170+
171+
The dynamic treasury allocation has been removed in favor of a fixed annual inflation rate of 5%. Which correspond to a reward of 11.06 ASTR per block.
172+
173+
### Collators rewards
174+
175+
Collators will now receive a steady 3.2% of the annual inflation which correspond to a reward of 7.07 ASTR per block. Although this represents a reduction from the previous model, the upcoming alignment of EVM fees and Substrate native fees is expected to increase overall fee earnings for collators.
176+
177+
### Stakers & dApp Rewards
178+
179+
The rewards for dApp staking, both for users and dApps, will remain unchanged in absolute terms. No immediate modifications will be implemented in this area. Future updates, including the introduction of dApp staking v3, will occur in the third phase of Tokenomics 2.0.
180+
181+
We use the blockReward distribution to ensure those three requirements (and calculate them from the reward per block):
182+
183+
| | Percentage | Reward ASTR |
184+
|------------------|------------|-------------|
185+
| Block reward | 100% | 231.20 |
186+
| Treasury | 4.78% | 11.06 |
187+
| Collators | 3.06% | 7.07 |
188+
| dApp reward | 17.27% | 39.93 |
189+
| Base Staker | 23.04% | 53.27 |
190+
| Adjustable Staker | 51.84% | 119.85 |

0 commit comments

Comments
 (0)