Skip to main content

dApp Staking Parameters

Overview

The following parameters are tightly tied to dApp staking, however, some parameters are shared with the Tokenomics 2.0 model. To find out more, please check the documentation here.

Era Reward Span Length

How many eras of reward information do we store in a single database entry. This puts an upper limit on how many rewards can a single claim_staker_reward call claim. Increasing this number has an impact on the PoV size consumed by the claim calls so it has to be kept relatively small.

Reward Retention In Periods

For how many periods do we keep staker & dApp rewards before they expire, and become unavailable for claiming. The larger this parameter is, the higher the deviation from the max inflation rate can occur since if many users have very old unclaimed rewards, and decide to claim them at a similar point in time, this would cause inflation to be spike up.

Max Number Of Contracts

There is a technical limitation on how many dApps the protocol can support at this time. However, this limit won't have a real impact on the protocol since at the moment of writing this document, neither Astar or Shiden are close to that limit.

Max Unlocking Chunks

Maximum number of unlocking chunks that a staker can simultaneously have. The chunk consists of some amount together with block number after which the chunk becomes unlocked.

Minimum Locked Amount

The minimum amount user has to lock in order to participate in dApp staking protocol. From the technical standpoint, the locked amount should cover the storage rent fee requirements, and prevents spamming of accounts with low lock amount. From the user’s standpoint, having low locked amount doesn’t make much sense because their rewards might not even be high enough to cover the transaction fee expense to claim those rewards.

Unlocking Period

Number of blocks required for unlocking chunk to become unlocked after starting the unlocking process.

Max Number Of Staked Contracts

Max number of staked contract entries a single account is allowed to have at once. This is again a technical bound, to provide additional security to the pallet.

Minimum Stake Amount

Similar to the minimum lock amount, but refers to the stake amount. It's suggested to keep this value same as the minimum locked amount.

Number Of Tiers

Number of distinct tiers in the protocol.

Reward Distribution

Describes the portion/percentage of the dApp reward pool that goes towards each tier. E.g. [10%, 20%, 30%, 40%] means that 10% of the reward pool goes for tier 1 rewards, 20% for tier 2 rewards, and so on.

Slot Distribution

Describes the portion/percentage of the total number of slots that goes towards each tier. E.g. [5%, 15%, 20%, 60%] means that 5% of the total slots are assigned for tier 1 dApps, 15% for tier 2 dApps, and so on.

Tier Thresholds

The threshold a dApp must meet, based on a percentage of the total issuance staked, to enter a tier. There are two types of threshold percentages:

  • Fixed - A percentage of the total issuance as staked funds.
  • 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.

Price Aggregation Duration

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.

Circular Buffer Length

Length of the circular buffer used to implement the moving-average solution.

Network Values

Parameter nameAstarShidenShibuya
Era Reward Span Length161616
Reward Retention In Periods432
Max Number Of Contracts500500500
Max Unlocking Chunks888
Minimum Locked Amount500 ASTR50 SDN5 SBY
Unlocking Period944
Max Number Of Staked Contracts16168
Minimum Stake Amount500 ASTR50 SDN5 SBY
Baseline Native Currency Price0.05 USD0.05 USD0.05 USD (mock)
Number Of Tiers444
Reward Distribution[25%, 47%, 25%, 3%][25%, 47%, 25%, 3%][40%, 30%, 20%, 10%]
Slot Portions[5%, 20%, 30%, 45%][5%, 20%, 30%, 45%][10%, 20%, 30%, 40%]
Tier 1 Threshold (total issuance %)Dynamic(3.57%/2.38%)Dynamic(3.57%/2.38%)Dynamic(0.0020%/0.0017%)
Tier 2 Threshold (total issuance %)Dynamic(0.89%/0.6%)Dynamic(0.89%/0.6%)Dynamic(0.0013%/0.0010%)
Tier 3 Threshold (total issuance %)Dynamic(0.238%/0.179%)Dynamic(0.238%/0.179%)Dynamic(0.00054%/0.00034%)
Tier 4 Threshold (total issuance %)Fixed(0.02%)Fixed(0.06%)Fixed(0.00014%)
Price Aggregation Duration7200 blocks7200 blocks7200 blocks
Circular Buffer Length777