Using Redacted

Backup and recovery

Updated 30 October 20263 min read

What brings your private account back depends on how it is kept. A wallet account comes back from your wallet, and a recovery phrase account comes back from its 25 words or its backup file. Either way your notes, Spending accounts and positions are rebuilt from the chain, so everything is where you left it.

Save a backup

While your account is open, open the account menu and choose Back up. What the screen offers depends on your account.

Wallet only

There is nothing to save. The screen says "Your wallet opens this account", and your wallet's signature opens it on any device.

Wallet + Face ID or fingerprint

Your wallet opens the account anywhere, and Face ID or your fingerprint adds the key on your devices. Passkey backup saves that device key in an encrypted file under a passphrase you choose. The file holds no key of your account itself, so it opens nothing without your wallet.

The passkey backup is optional and worth keeping. If every device with your passkey is lost, it lets a new device open your full account again, and it brings back money resting on the exit addresses that only your lost passkey could reach.

Recovery phrase

Show recovery words shows your 25 words. Write them down in order and keep them offline, because they are your account. Download backup file saves an encrypted file under a passphrase of at least 14 characters, and it also holds your home and rescue addresses.

Before your first deposit, the vault asks you for three of the words, picked at random, so you know that your backup works.

Restore anywhere

A wallet account comes back when you connect the same wallet and sign in. With Face ID or a fingerprint, a synced passkey opens it on your new device, and otherwise you approve the device from one where your account is open or use your passkey backup (see Sign-in and sessions). The vault then asks you to confirm once which version of your account is yours.

A recovery phrase account comes back on any device. Choose Restore and then either the recovery phrase or the backup file.

  • With the recovery phrase, enter the home address you chose when you created the account, and type the 25 words on the restore screen of the Redacted app you opened yourself.
  • With the backup file, choose the file and type its passphrase.

The vault then rebuilds your notes, Spending accounts and positions from the chain, because that is where they always lived, so there is nothing to migrate or re-fund and nothing is lost.

Withdraw after restoring

Once restored, you can send everything home or to your rescue address. Open positions (loans, stakes, orders) remain live and follow their products' normal rules until you close them.

A recovery phrase account restored on a new device from its words or its backup file gets a new device key there. Your money under the old device key can always go home or to your rescue address, and moving it anywhere else, into your new device key included, takes a request that waits 7 days. That wait is what keeps your money safe from anyone who has only your words. Adding a new device from one where your account is open carries the device key with it, so a paired device has no such wait.

Good to know

  • The 25 words, or the backup file together with its passphrase, are full control of a recovery phrase account, so store them separately and share neither.
  • If you forget a backup file's passphrase while your account is open, save a fresh file with a new one.
  • Your address is not the key. A public address proves nothing on its own, so restoring takes your wallet's signature, your 25 words or your backup file.

Under the hood

Backup files are encrypted in the vault with AES-256-GCM-SIV under a key from your passphrase, made with Argon2id (64 MiB of memory, 3 passes) and a fresh random salt, and the file's header is bound into the encryption, so no setting in it can be changed. Restoring then replays public chain history through your keys. Every note's secrets follow from your account's keys and public chain data, so your keys find every note again, which is the same no-database principle that runs the whole protocol.

See Sign-in and sessions for everyday unlocking and Security for the wider model.