Shares and Growth

A share is your turtle's claim on the vault. Every royalty that arrives is split across every share in the collection, so more share means a bigger slice of every sale that happens from then on.

The numbers

Read growth off growthPerWeek() and each ceiling off capOf(path).

Every path grows

This is the change most worth understanding.

In v1 only a Pristine turtle grew, and the only other way up was to feed turtles to the forge. In v2 any turtle below its ceiling gains 0.70 share a week, whatever path it walks. A Forged turtle at 6.00 climbs to 9.00 on its own. A Champion at 11.00 climbs to 13.00.

Growth is continuous, not weekly. Share accrues every second and the contract works it out when it is read. There is no oracle, no admin trigger, nothing off chain. It is elapsed time multiplied by a rate.

The moment a turtle touches its ceiling it is marked maxed and growth stops. There is nothing above the ceiling.

The reset on transfer

If you sell a Pristine turtle that has not reached 12.00, its share drops to 1.00 for the new owner and the clock restarts.

Nothing else resets. Not Forged, not Legendary, not Champion, and not a Pristine that already reached the ceiling.

Why it works that way

To reward the people who actually hold. A flipper does not get to carry away growth that came from someone else's patience. The moment you commit long enough to reach the ceiling, that protection turns into ownership and the share is yours to sell.

Checking your own

Every figure here is readable from the collection contract.

pendingShare(id) gives a turtle's share right now, including everything that has accrued since it was last written.

stateOf(id) gives the stored state: the last written share, the path, the merge count, and whether it is maxed.

The Four Paths The Vault