You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/learn/dapp-staking/dapp-staking-faq.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -176,9 +176,9 @@ There you can find your current tier, number of stakers, total earned (total sta
176
176
177
177
### Q: How are dApps assigned to tiers?
178
178
179
-
At the end of each **Build&Earn** Subperiod, dApps are assigned to a tier based on the total value staked on them by users. There are *4 tiers*.
179
+
At the end of each **Build&Earn** Subperiod, dApps are assigned to a tier based on the total value staked on them by users. There are *4 tiers* with a **fixed maximum of 16 slots** distributed across all tiers.
180
180
181
-
The threshold for tier 4 is fixed, while it is dynamic for the other tiers.
181
+
Each tier has entry thresholds defined as **fixed percentages** of total issuance. These percentages remain constant, though the absolute threshold amounts adjust proportionally with changes in total issuance.
182
182
183
183
### Q: Is the amount of dApp Staking rewards fixed per dApp?
Copy file name to clipboardExpand all lines: docs/learn/dapp-staking/dapp-staking-protocol.md
+6-62Lines changed: 6 additions & 62 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -249,67 +249,25 @@ Each tier also has a _threshold_ which a dApp must satisfy in order to enter it.
249
249
#### Tiers Capacity
250
250
251
251
There is a limited amount of slots for dApps which means dApps have to compete for them.
252
-
The amount isn't static but is recalculated at the start of each period.
253
252
254
-
Since the purpose of dApp staking isn't for dApps to earn obscene amounts of rewards, but to provide
255
-
support to operate and further develop existing dApp, number of slots is scaled with the value of **ASTR** expressed in **USD**.
253
+
The protocol uses a **fixed maximum of 16 slots** distributed across all tiers. This fixed capacity provides predictability and stability to the tier system.
256
254
257
-
At the beginning of **each era**, using the _moving average_**ASTR** price, new number of slots is calculated:
These formulas were designed with a _baseline_ price in mind.
271
-
Using the _baseline_ price, the _baseline_ number of slots can be calculated using the listed formulas.
272
-
273
-
This value is important since it's used as a reference when calculating tier threshold adjustment.
255
+
The slots are divided among tiers according to statically configured portions. For example, on Astar, _tier 2_ gets **37.5%** of the slots and _tier 3_ gets **62.5%** of the slots (_tier 1_ and _tier 4_ have no slots). For a total of 16 slots, this represents 6 slots in _tier 2_ and 10 slots in _tier 3_. The exact slot distribution per tier varies by network and is defined in the [network parameters](/docs/learn/dapp-staking/protocol-parameters#network-values).
274
256
275
257
#### Tier Threshold Entry
276
258
277
259
A dApp isn't entitled to a tier by just participating in the dApp Staking.
278
260
It needs to attract sufficient support to even be eligible for entry into a tier.
279
261
280
262
E.g. a threshold to enter _tier 1_ might be set to **1,000,000 ASTR**.
281
-
Since number of slots is dynamic, so has to be the threshold to allow for more realistic competition.
282
-
It's not fair to define the same threshold for entering a tier if there are 50 slots or 500 slots since the
283
-
staked amount will be more diluted between various dApps.
284
-
285
-
The formula for adjusting tier entry threshold with dApps slot changes:
Tier entry thresholds are defined as **fixed percentages**of the total issuance. These percentages remain constant across periods, but the absolute threshold amounts adjust proportionally as the total issuance changes (e.g., through burn events).
295
265
296
-
*`Dynamic` - A percentage of the total issuance as staked funds that can change between periods. It includes:
297
-
- A **minimum** percentage that the threshold cannot fall below
298
-
- A **maximum** percentage cap that limits how high the threshold can grow
266
+
For example, suppose the total issuance is **8.4 billion** ASTR tokens. For a tier with a threshold percentage set at **2.32%**, this equals approximately **195 million ASTR**. If the total issuance drops to **8.0 billion** ASTR, the threshold adjusts to:
*`Fixed` - A constant percentage of the total issuance as staked funds, which does not change between periods. Used for the _lowest_ tier, and defines a static value.
303
-
304
-
These percentages are calculated based on a total issuance of **8.4 billion ASTR** tokens when dApp Staking V3 was launched. As the total issuance changes (e.g. burn events), the dynamic thresholds will adjust accordingly, ensuring a fair and adaptive staking environment.
305
-
306
-
For example, suppose the total issuance is **8.4 billion** ASTR tokens. For **Tier 1**, the dynamic threshold percentage is set at **3.57%** (*approximately 299,880,000 ASTR*), with a minimum required percentage of **2.38%** (*approximately 199,920,000 ASTR*) and a maximum possible percentage set according to network parameters. If the total issuance decreases due to a burn event, the threshold adjusts accordingly. For example, if the total issuance drops to **8.0 billion** ASTR, the **Tier 1** threshold adjusts to:
The maximum cap ensures that during periods of high competition or changing token price conditions, tier thresholds don't grow beyond reasonable limits, maintaining accessibility for dApps.
311
-
312
-
If the number of slots changes, the threshold is further adjusted based on the delta percentage formula.
270
+
This approach ensures that tier thresholds scale with the token supply while maintaining consistent percentage requirements.
313
271
314
272
*Refer to the [dApp staking parameters](/docs/learn/dapp-staking/protocol-parameters#network-values) page to find out more about the percentage values for each network.*
315
273
@@ -412,17 +370,3 @@ However, this should not be a problem given how the system is designed.
412
370
There is no longer _stake&forget_ - users are expected to revisit dApp staking at least at the
413
371
beginning of each new period to pick out old or new dApps on which to stake on.
414
372
If they don't do that, they miss out on earning staker rewards.
415
-
416
-
### Oracle Price Feed
417
-
418
-
Tier slots, thresholds and rewards need to be adjusted for the native currency price. This has been mentioned in previous chapters. E.g. if price of the **ASTR** goes up, the protocol can accommodate more dApps, and vice-versa.
419
-
420
-
This is done in multiple steps:
421
-
422
-
1. Permissioned oracle feeds the native currency price on-chain.
423
-
2. Price is aggregated over the defined time period (e.g. the entire day), and average value is calculated.
424
-
3. Aggregated price is stored into a circular buffer used to calculate moving average.
425
-
4. dApp staking tier configuration re-calculation relies on the moving average price.
426
-
427
-
The _moving-average_ approach is utilized to soften the impact of crypto's high price volatility.
428
-
It's important to keep the _window_ small enough to be able to react to price changes in timely manner, but long enough to _dampen_ sudden & temporary spikes.
Copy file name to clipboardExpand all lines: docs/learn/dapp-staking/index.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -129,7 +129,9 @@ Tier System is a method to rank dApps based on the total value staked on them. T
129
129
130
130
There are a limited number of tiers, each with a set number of slots and a minimum threshold for dApps to qualify.
131
131
132
-
A dApp must gain enough support to enter a tier, with dynamic thresholds for fair competition. Higher tiers offer larger rewards.
132
+
A dApp must gain enough support to enter a tier, with thresholds defined as fixed percentages of total issuance. Higher tiers offer larger rewards.
133
+
134
+
Within a tier, dApps can also have a **rank (0..10)**. Tokenomics 3.0 uses a deterministic `tier_rank_multipliers` weight model so a dApp's rewards can depend on **tier + rank** (not on empty slots). For the technical details and formulas, see the [technical overview](/docs/learn/dapp-staking/dapp-staking-protocol.md).
133
135
134
136
Within a tier, dApps can also have a **rank (0..10)**. Tokenomics 3.0 uses a deterministic `tier_rank_multipliers` weight model so a dApp's rewards can depend on **tier + rank** (not on empty slots). For the technical details and formulas, see the [technical overview](/docs/learn/dapp-staking/dapp-staking-protocol.md).
Copy file name to clipboardExpand all lines: docs/learn/dapp-staking/protocol-parameters.md
+8-21Lines changed: 8 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -82,18 +82,8 @@ For each tier, this value defines how much **rank 10** earns relative to **rank
82
82
### Tier Thresholds
83
83
84
84
The threshold a dApp must meet, based on a percentage of the total issuance staked, to enter a tier.
85
-
There are two types of threshold percentages:
86
85
87
-
*`Fixed` - A percentage of the total issuance as staked funds.
88
-
*`Dynamic` - A percentage of the total issuance as staked funds. This variant includes an additional adjustment in later calculations with a delta based on changes in the number of slots for each era. The threshold amount derived cannot drop below a defined minimum percentage, *minimum_required_percentage*. Similarly, the derived threshold amount cannot exceed a defined maximum percentage, *maximum_possible_percentage*.
89
-
90
-
### Price Aggregation Duration
91
-
92
-
Time period, expressed in blocks, during which native currency price is aggregated. When expired, average value is calculated and stored into the _moving-average_ circular buffer.
93
-
94
-
## Circular Buffer Length
95
-
96
-
Length of the circular buffer used to implement the _moving-average_ solution.
86
+
Tier thresholds are defined as **fixed percentages** of the total issuance. As the total issuance changes (e.g., through burn events), the absolute threshold amounts adjust proportionally, but the percentage remains constant.
97
87
98
88
## Network Values
99
89
@@ -108,14 +98,11 @@ Length of the circular buffer used to implement the _moving-average_ solution.
Copy file name to clipboardExpand all lines: docs/use/how-to-guides/layer-1/dapp-staking/for-devs/index.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,15 +22,15 @@ Before reading the dApp Staking section for dApp owner, make sure you understand
22
22
23
23
dApp Staking introduces the concept of a tier system for dApps. It's important to fully understand the [tier mechanism](/docs/learn/dapp-staking/dapp-staking-protocol.md#tier-system) before proceeding with dApp Staking application and registration as a dApp owner.
24
24
25
-
dApp Staking uses reward tiers (each with a limited number of slots), and where applicable assigns ranks within tiers so dApp rewards are determined deterministically by **tier + rank**. Tier capacity for dApp staking is calculated at the start of each period based on the ASTR price as described [here](/docs/learn/dapp-staking/dapp-staking-protocol.md#tier-system).
25
+
dApp Staking uses reward tiers (each with a limited number of slots), and where applicable assigns ranks within tiers so dApp rewards are determined deterministically by **tier + rank**. The protocol uses a **fixed maximum of 16 slots** distributed across all tiers, providing predictability and stability to the tiersystem.
26
26
27
27
The slots allocated to each tier can be viewed on the [dApp Staking Page](https://portal.astar.network/astar/dapp-staking/discover) of the Astar Portal.
28
28
29
29
At the end of each **Build&Earn** subperiod, dApps are assigned to a tier based on the total value staked on them by users. Each tier has a **threshold** that a dApp must reach in order to access it.
30
30
31
31
At the protocol level, at most **16 dApps are reward-eligible per era** (across tiers).
32
32
33
-
The threshold for tier 4 is fixed, but for the other tiers, the threshold is **dynamic** and calculated at the start of each new period based on the total number of slots for the period. To find out more, [click here](/docs/learn/dapp-staking/dapp-staking-protocol.md#tier-threshold-entry).
33
+
Tier thresholds are defined as **fixed percentages** of total issuance. These percentages remain constant across periods, though the absolute threshold amounts adjust proportionally with changes in total issuance. To find out more, [click here](/docs/learn/dapp-staking/dapp-staking-protocol.md#tier-threshold-entry).
34
34
35
35
**Rewards** for dApps are also **dynamic**, fluctuating from tier to tier. The higher the tier, the greater the number of ASTR tokens allocated from inflation as rewards for that tier.
0 commit comments