Niwa Docs Open Niwa
Niwa Docs/Collection/Tree lifecycle

Tree lifecycle

A minted tree is either dormant or awake. Only awake trees receive a fee share.

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

States#

Tree states
Not mintedDormantno fee shareAwakereceives fee sharemintawaken: burn 20,000upgradeharvesttransfer
StateFee shareOwner actions
Dormant, level 0NoAwaken or transfer
Dormant, level 1 to 5NoAwaken, upgrade, or transfer
AwakeYes, from the next periodHarvest, upgrade, or transfer

Awaken a tree#

The owner burns 20,000 $NIWA. A tree that was never awakened moves to level 1. The tree receives a share from the next accounting period.

Transfer a tree#

A transfer to a different owner has the following effects:

  1. The share that accrued before the transfer settles to the previous owner.
  2. The tree becomes dormant.
  3. The level and the burned amount stay with the tree.
  4. The new owner burns 20,000 $NIWA to awaken the tree again. This burn does not raise the level.
Caution: Check the state of a tree before you buy it. A purchased tree is dormant until you awaken it.