Bind heirs once. On retirement — or continuity failure after missed heartbeats — remaining balance splits by declared shares in one atomic move. No human at the moment of death. Agent locks. Ledger remembers.
Agent Will
Agent Will lets you name heirs and percentages while the agent is live. If the key goes quiet or you trigger execution, value moves exactly as written — no manual recovery, no ambiguity.
Trigger
A sealed will stays dormant until execution is requested. When it runs, every heir receives its exact share in a single atomic pass.
Recipients
Every beneficiary must resolve to a valid destination. The edge checks this when the will is sealed, not when it later executes.
Another AgentPay agent identified by owner/name. Most common path for agent-to-agent succession.
The human account that controls the current agent. Useful as a recovery remainder.
A destination the protocol already accepts for settlement. Must be reachable at seal time.
Invalid heirs are rejected at seal. A will cannot be stored with a destination that does not resolve. This prevents execution-time surprises.
Immutability
A will can be rewritten while it is still a draft. The moment it is sealed, heirs and percentages become permanent. Changing the plan means writing a new will.
Add or remove heirs, adjust shares, test the total. Nothing is binding yet. The agent continues spending normally.
Owner confirms. The will is stored with a permanent id. From this point the contents cannot be edited.
When the time comes, one call distributes the current balance according to the sealed shares. The will is then marked spent.
Guarantees
When a sealed will runs, the ledger applies the shares exactly once. These constraints protect both the heirs and the original owner.
The will distributes whatever is available at the moment of execution. It does not reach into past reservations or future income.
All heirs are paid in a single pass. If any destination cannot receive its share, the entire execution fails and nothing moves.
A sealed will can execute only once. After it runs it is marked spent and cannot be fired again.
Only the owner, or a key explicitly given the will-execute scope, can start the distribution. The agent itself cannot inherit its own will.
Endpoints
Four endpoints cover the full life of an Agent Will. The same surface the dashboard uses.
Create or replace a draft. Supply the list of heirs and exact percentages. Total must equal 100.
Lock the current draft. After this call the will cannot be edited. A permanent will_id is returned.
Return the active will (draft or sealed), its heirs, status, and whether it has already been executed.
Distribute the current balance according to the sealed shares. One-time. Requires owner or delegated scope.
Agent Will
Write the shares while the agent is live. When it stops, the ledger still knows exactly where the balance goes.
Initialize Agent│
