Using Redacted
Sign-in and sessions
Updated 30 October 20268 min read
Redacted replaces the usual routine of signing every action with a simpler one. You open your private account once on a device, act freely, and lock it when you are done.
Choose how your account is kept
The first time you open Private Mode, the app asks how your private account should be kept. All three ways run on the same hash-based notes, proofs and signatures and reach the same products and markets. They differ in what opens your account and what protects it.
| Choice | What opens your account | What protects it |
|---|---|---|
| Wallet + Face ID or fingerprint (recommended) | Your wallet signs you in, and then Face ID, Touch ID, Windows Hello or your fingerprint opens the account on this device | A key on your devices joins your wallet, so a phished wallet signature can only send your money home to your wallet |
| Wallet only | Your wallet's signature, on every device | It is as safe as your wallet signature, and you can add Face ID or a fingerprint at any time |
| Recovery phrase, in bunker mode | 25 words you write down, plus a key that stays on your devices | Nothing in it depends on a wallet signature, and its way home is as safe as its home and rescue address |
With Face ID or a fingerprint, someone who tricks you into signing the Redacted message on another site can read your history, but they can't take your money, apart from what rests in Spending accounts or on exit addresses made before the switch. Without the key on your devices, your notes can only go home to your wallet, and a request to pay anywhere else waits 7 days, which the app shows you so that you can cancel it.
Adding Face ID or a fingerprint later moves your private balance over to the new key privately, in the background. Spending accounts and exit addresses made before the switch keep your wallet's key, so a phished signature could still act on what stays in them. The app marks the older Spending accounts, offers to bring what they hold home and sends nothing new to them, so close any position that is still open there, and Send home under Exit addresses in the account menu empties your exit addresses.
A wallet account needs a wallet that signs the same message the same way every time. Wallets that sign differently each time, such as threshold wallets that sign together from several devices, and accounts that can't sign a message at all, such as a DAO's contract, keep their private account as a recovery phrase instead, and the app offers that choice.
Unlock Private Mode
Connect your wallet, tap the ghost icon and choose Sign to unlock. Your wallet signs a message once, and twice the first time on a device. The message begins with "Sign in to Redacted", names Redacted's vault (https://redactedvault.com), the network and your wallet, sends nothing and costs no fee. Your account's keys are made from it inside Redacted's vault, and nothing is recorded on-chain.
With Face ID or a fingerprint, the vault asks for it right after your wallet has signed. From then on Face ID or your fingerprint opens your account on this device without your wallet. A recovery phrase account opens on each device with what you choose in the vault, which is Face ID or a fingerprint, or a passphrase.
Redacted's vault runs inside the app, in a worker of its own in your browser, where it keeps your keys and makes every proof and signature. Its screens for your 25 words, passphrases and pairing codes open over the app, so type them only into the Redacted app you opened yourself. The passkey step is the one part that runs on the vault's own domain, redactedvault.com, in a small window that opens when you tap, and your device names that domain in its passkey prompt.
How sessions work
While your account is open, every supported action, from a swap to a withdrawal, runs on proofs and signatures that the vault makes in your browser, and your wallet stays silent. The one time it speaks again is when you fund the Reserve from your public balance, because that transfer is your public wallet acting.
Your account stays open in its tab until you lock it. Choosing Lock, reloading the page or closing the tab ends the session, and the next time your device opens the account again with its Face ID, fingerprint or passphrase, or with one signature of your wallet for a wallet-only account. Nothing happens without you, since there is no silent fallback to your public wallet.
Locking is instant and free because your keys only ever lived in your browser's memory. There is no server session to revoke, because no server holds your keys.
Passkeys
Face ID, Touch ID, Windows Hello and your fingerprint reach Redacted through a passkey, the sign-in method that your device or password manager already offers on many sites. The app names it after what your device uses, and it says passkey only where it can't tell.
Redacted's passkeys belong to its vault. Your device names them redactedvault.com, and a passkey prompt for any other name is not Redacted's. A passkey answers only on its own domain, so a look-alike site can't use it.
At the wallet + Face ID level, your passkey gives your account a second key that stays on your devices. Every note the account holds is bound to that key on-chain, so paying anyone other than your home wallet needs your device as well as your wallet. A synced passkey, for example in iCloud Keychain or Google Password Manager, gives the same key on each of your devices, with nothing to pair.
Passkeys work here when they support a feature called PRF. Recent versions of Safari and Chrome have it, and so do passkeys in iCloud Keychain, Google Password Manager and Windows Hello, and many other password managers and hardware keys. The in-app browsers of wallet apps can't use passkeys, so the app never asks for one there. It offers the other ways to open your account instead, and a new account made there starts as a wallet-only account, with Face ID or a fingerprint to add later in Safari or Chrome.
Add another device
A device where your synced passkey works opens your account by itself. Any other device, such as a Windows PC next to your iPhone, is approved from a device where your account is already open.
- On the device where your account is open, choose Approve a device in the account menu. The vault shows a one-time code that carries your account to your other device. Show it only to your own device.
- On the new device, choose Add this device, or Approve this device when it asks how to open your account, and read the code there in the vault. For a recovery phrase account, you also enter your home address there, as your other device shows it, because the code doesn't carry it.
- The new device then chooses how it opens your account, with Face ID or a fingerprint where it can, or otherwise with a passphrase. On a device without passkeys, that passphrase works together with your wallet's signature and needs at least 12 varied characters, not only digits.
A wallet-only account needs no pairing, because your wallet opens it on every device. A new wallet + Face ID account is ready for a second device once the first device has written the account's first record on-chain, which it does on its own, and until then the new device shows Your other device writes first.
Take a code only from your own other device, never from a link or a message.
Confirm once
A code, a passkey backup or a device sealed with a passphrase brings a device key from outside, so the vault asks you to confirm it once before the device uses it. It reads the chain from two sources and shows Your account? with every version of your account it finds there, the key each one rests on (This device, Wallet only, Another Face ID or From your file), what it holds and the block where it was written.
The version that your code or file belongs to carries This one. Choose it only if you made that code or file yourself, on your own device, and confirm it again under Yours?. A file or code you did not make yourself is not yours, even when it opens, because someone who phished your wallet signature could make one of their own. The device keeps your choice, so you confirm once per device, and a device that still needs the choice shows the same screen titled Confirm once. When only one source answered, the vault says so and offers Read again first.
If you lose your Face ID or fingerprint
Your wallet alone can always bring your private balance home. Choose Lost Face ID? in the account menu or Lost your Face ID? on the unlock screen, and the vault offers the ways that work on this device, in this order.
Where this browser can reach a passkey on your phone, Use your phone opens it with a QR code. Approve this device takes a code from a device where your account is still open, and Passkey backup takes your backup file and its passphrase (see Backup and recovery). Bring home pays every private balance to your wallet, at once when it fits its coin's instant lane and otherwise after the 12-hour queue, and it is public, because the amounts arrive at your wallet's address. Last, New Face ID starts your account again with a new passkey on this device. Money under the old key can then go home, or move privately to the new key with a request that takes 7 days.
The app names the button after your device, so it reads Touch ID, Windows Hello or Fingerprint where that is what you use.
Under the hood
A wallet account's message is the same in every copy of the app and names the vault, the network, the Redacted contract, the deployment and your wallet. The vault checks that your wallet signs it the same way twice before it trusts the result, and later unlocks need one signature, which it checks against a fingerprint of your account.
Passkeys use the PRF extension of WebAuthn, the standard behind passkeys, on the vault's domain. Your passkey gives the vault a secret that stays on your device, and the vault turns it into your account's device key with HKDF. Each device keeps your account sealed with AES-256-GCM-SIV under a key from its passkey, or from its passphrase through Argon2id. For a wallet account on a device without passkeys, that key needs your wallet's signature as well as the passphrase.
The vault wipes secrets from its own memory as soon as it no longer needs them, including proof inputs, your 25 words, passphrases, pairing codes and every key it derives.
A session is only a convenience. Your wallet, or your 25 words in bunker mode, is what guarantees access, and Backup and recovery covers each case.