Inheritance
A dead-man's switch for your vault. Name your heirs and their shares, check in now and then to prove you're around, and if you ever go silent for good they can claim what you left them — without anyone ever holding your keys.
A self-custodial vault has a hard problem: if only you can sign, what happens to your assets if you're gone? Inheritance solves it on-chain. You bind a succession plan to your Sup Wallet, and payouts stay gated by rules you set — not by any server that can sign for you. It builds on Delegation: heirs can only ever receive coins you authorized, and only after your liveness lapses.
#Set it up (owner)
Open /inheritance with your wallet connected, then:
- Authorize the coins heirs may inherit — each coin type is a one-time grant on your vault.
- Create the plan — it's bound to your wallet.
- Add heirs with a percentage each. Payout only works when the active shares add up to 100%.
- Check in periodically with a heartbeat to prove you're alive.
- Share one claim link with your heirs.
Every action is a transaction you sign — the app never holds your keys.
#Liveness & grace
Two timers protect you from an accidental payout:
| Window | Length | What it means |
|---|---|---|
| Liveness | 180 days | Each heartbeat resets it. While it's alive, no one can claim. |
| Grace | 7 days | If liveness lapses, the first claim only starts a 7-day countdown — a last chance for you to check in and cancel. |
So a payout is never instant: your silence has to outlast the liveness window and the grace period.
#How heirs claim
Each heir keeps a MemberCap — a small object that proves their slot. To claim, an heir opens the link with the wallet that holds that cap:
- The first claim after your liveness lapses starts the grace period and moves no funds.
- After the 7-day grace passes, the heir claims again to receive their share.
Funds go to the wallet that owns the MemberCap, so heirs must claim from that wallet.
#Good to know
- Shares must total 100% or payouts are blocked — allocate fully before you rely on it.
- Grant every coin you want heirs to receive; ungranted coins can't be claimed.
- The MemberCap matters — if an heir loses or transfers it, the claim page won't find their slot.
- Heartbeat before the 180-day window runs out to stay in control.
#Developer note
Build the transactions with @workspace/sup-inheritance-sdk (createInheritanceClient → authorizeMany, createInheritance, addMembers, heartbeat, memberWithdraw); every method returns an unsigned Transaction. The on-chain logic is SupInheritance::inheritance — payout runs through an unmetered intent gated by the MemberCap, the 100% check, and the liveness/grace timing (it also supports zkSend and hashlock invites for heirs without a known address). See SDK / CLI / MCP and Delegation.
