Technical Whitepaper / Inheritance Mechanism

Inheritance Mechanism

Every wallet holding iTokens can designate heirs for each asset. As long as you stay active, nothing changes for your heirs; they have no ability to move your funds.

#Designating heirs

For each asset you can name up to 30 heirs, each with a percentage share. Shares must add up to exactly 100%, so no part of an estate is left unassigned or assigned twice. You can't name yourself, and the same address can't appear twice. You can update your heirs at any time while no inheritance or recovery is in progress; saving them also counts as activity.

#How succession runs

  1. Inactivity. After 45 days without activity with that asset, any heir can start the inheritance. Starting it moves no funds.
  2. Waiting period. Claims open 7 days after the start. Until the inheritance ends, the owner can still cancel it with any activity.
  3. Claims. After the waiting period, each heir claims their own share whenever they choose.
  4. Remaining funds. After a further 14 days, any heir who has claimed can close the claims and split what is left among the heirs who claimed.

#Every heir gets exactly their share

The order in which heirs claim doesn't change what they receive. Every heir receives exactly their percentage of the estate.

#Remaining funds

Some heirs may never claim, whether because of a lost key or an address nobody uses anymore. And the owner's wallet can keep receiving iTokens after the claims open. Once the remaining-funds period has passed, any heir who has claimed can distribute the whole remaining balance among the heirs who claimed, in proportion to their shares. From that moment, heirs who didn't claim can no longer claim in this inheritance. Heirs who claimed can repeat this step for any iTokens that arrive later.

Recovery comes first

Recovery contacts can act after 30 days without activity, before heirs. Starting a recovery cancels an inheritance in progress; what heirs have already claimed stays with them.

#Default protocol periods

PeriodAt deployment
Inactivity period45 days
Inheritance waiting period7 days
Remaining-funds waiting period14 days after the claims open
Inheritance fee0.3% of each share
Values at deployment

Periods and fees on these pages are the values set when the contracts were deployed. They can change within limits written in the contracts, and the app always shows the current values for each asset.