Niwa Docs Open Niwa
Niwa Docs/Collection/Tree upgrades

Tree upgrades

Five levels set the weight of a tree. Each upgrade burns $NIWA.

Preview: This page describes a design that is not deployed. Values and behavior can change before launch.

Levels#

LevelNameCumulative burnCost from previous levelWeight
1Sprout20,00020,0001.0×
2Sapling60,00040,0001.4×
3Blossom120,00060,0001.9×
4Elder240,000120,0002.5×
5Sacred Tree680,000440,0003.5×
Weight by level
1. Sprout
1.0×
2. Sapling
1.4×
3. Blossom
1.9×
4. Elder
2.5×
5. Sacred Tree
3.5×
Weight determines the share of the Orchard allocation. It is not a rate of return.

Rules#

  • A tree must be awakened one time before it can be upgraded.
  • You pay the difference between the cumulative amounts.
  • You can skip levels.
  • A level cannot decrease.
  • A level stays with the tree after a transfer.
  • An upgrade changes the weight from the next accounting period.
  • Burns are not refundable.

The token supply limits how many trees can reach each level. See Supply and burn limits.

Calculate the cost#

Subtract the cumulative burn of the current level from the cumulative burn of the target level:

cost = cumulativeBurn[targetLevel] - cumulativeBurn[currentLevel]

The following table shows the cost for each transition, in $NIWA.

FromTo level 2To level 3To level 4To level 5
Level 140,000100,000220,000660,000
Level 2Not applicable60,000180,000620,000
Level 3Not applicableNot applicable120,000560,000
Level 4Not applicableNot applicableNot applicable440,000

When an upgrade takes effect#

An upgrade takes effect in the next period
Period N: 1,000 unitsPeriod N+1: 1,000 unitsTree A500Tree B500Tree B upgrades to level 5the weight used in period N does not changeTree A222Tree B778Weights 1.0 and 3.5total weight 4.5