Design goals and security properties
- Enforced delay: recovery cannot finalize before 30 days, removing instant silent takeover paths common with mnemonic-only recovery modes.
- Deterministic effect: the queued payload is a fixed transfer plan to a user-specified recipient. Auditors and operators can pre-compute and monitor the exact outcome.
- Onchain observability: the queued request is public. Watchtower sends escalating email notifications to the recovery email throughout the window.
- Sequence independence: contracts are self-sufficient. Users can run the standalone recovery tool. Session metadata is continuously backed up to Arweave for permanent storage. The only requirement is that the target EVM chain must be live.
Prerequisites
- 24-word recovery phrase: created for the wallet via UI or SDK. Used only for recovery authorization.
- Recovery notifications email: bound to the recovery key at phrase creation. Used by Watchtower.
- Optional encrypted backup: store an encrypted form of the phrase in a reputable password manager, protected by a memorized decryption password not stored with the encrypted blob.
Recovery flow
Step-by-step
- User creates the recovery signer phrase and adds the signer to the wallet with the existing session.
- At a later date, user initiates recovery from the main auth screen.
- User enters the recovery phrase. The wallet derives the recovery EOA, fetches wallet session metadata, and shows an inventory preview.
- User provides a target recipient wallet address (must differ from the source wallet). The wallet constructs and queues a transfer bundle.
- User initiates recovery. The UI shows the exact date and time to return. The request is recorded onchain and Watchtower notification cadence begins.
- User can return at any time to see the live countdown.
- If local state is not available, the user re-enters the recovery phrase. The wallet detects the active recovery and shows the countdown.
- After 30 days, the user triggers execution of the queued transfer bundle using an EOA wallet. Inventory moves to the recipient.
Notifications
- On queue, Watchtower emails the recovery email registered at phrase creation.
- Frequency increases as T+30 approaches.
- If email infrastructure is unavailable, onchain visibility remains. Integrators can run independent watchers.
- The user can cancel the recovery request at any time before finalization.