Skip to main content

Safe Accounts

A Safe can hold a private balance in the Privacy Boost app. Moving tokens from the Safe into it is called shielding. From the private balance, the Safe can send privately to other Privacy Boost accounts, unshield back to a public address, swap, or use Earn. Any one owner can sign in with their own wallet to see the balance and history. Moving funds works the way it always does for your Safe: every shield, send, unshield, Earn action, and swap is a Safe transaction that needs your usual number of owner signatures. Privacy Boost has no key that can spend from the account.

Before you start

  • The Safe has to be on version 1.3.0 or later. A Safe on a version after 1.4.1 shields from inside Safe{Wallet}, not from app.privacyboost.io in its own tab.
  • Use OP Mainnet, Base, or the Base Sepolia testnet, where Safe{Wallet} can queue transactions. On other Privacy Boost networks, such as Soneium and OP Sepolia, only a Safe with a threshold of one works, and it can’t shield.
  • As with any Safe transaction, the owner who executes it pays the gas.

Sign in

Each owner signs in with their own wallet, either a browser wallet or one connected over WalletConnect. Don’t connect the Safe itself to the app over WalletConnect; if you do, the app stops and asks you to sign in as an owner instead. Signing in is a gasless message and doesn’t involve the other owners.

From app.privacyboost.io

  1. Go to app.privacyboost.io, choose Connect wallet, and check the network under the wallet list.
  2. Choose Safe (Sign in with an owner wallet).
  3. Enter the Safe’s address.
  4. Connect your owner wallet and approve the sign-in message.

From inside Safe{Wallet}

  1. In Safe{Wallet}, connect an owner wallet using Connect at the top right, on the Safe’s network.
  2. Open Privacy Boost from Apps. If it isn’t listed, add https://app.privacyboost.io as a custom Safe App.
  3. The app picks up the Safe that opened it. Connect your owner wallet and approve the sign-in message.
Some wallets can’t be reached from inside Safe{Wallet}. If yours isn’t offered, use WalletConnect or open the app in its own tab.

Set up the account

The first time an owner signs in, the app walks through Create a private account:
  1. Save a recovery phrase. This is optional. Owners don’t need it to sign in, and any owner can show it again later from the profile menu. The phrase gives read access to the account. It can’t move funds.
  2. Store the account’s keys. Approve two signature requests in your wallet. After this, any owner can finish setup from any device.
  3. Create the account on chain. Choose Queue setup to your Safe, which queues a one-time Safe transaction. Share it with Copy link for co-owners, then sign and execute it in Safe{Wallet} with your usual number of owners. Even if you’re the only signer needed, you execute it yourself in Safe{Wallet}. On a network where the app can’t queue to Safe{Wallet}, a Safe with a threshold of one gets Run setup from your Safe instead, which runs right away.
The app checks for the transaction every few seconds and signs you in once it executes. You can close the window in the meantime. Any owner who signs in later picks up from the same step.

Shield

Choose Shield, pick the token and amount, and confirm. You sign once to queue a single Safe transaction with everything the shield needs: wrapping native ETH if you’re shielding ETH, the token approval, and the deposit. In the Safe queue, it ends with a requestDeposit call to the Privacy Boost pool. A shield isn’t private the way a spend is: the token and amount are visible in the transaction. Once enough owners have signed, any owner executes it in Safe{Wallet}. The funds leave the Safe when it executes, and the private balance updates on its own shortly after. Until then, every owner can see the queued shield under Safe approvals. When you shield from inside Safe{Wallet}, Safe{Wallet} opens the transaction for review right away.

Send, unshield, earn, and swap

  1. Fill in the details and choose Queue approval (Queue to Safe for a swap, Confirm deposit or Confirm withdraw for Earn).
  2. Check the review sheet. It shows what the spend does, the amount, the recipient, and a commitment that ties the approval to exactly these details. The app checks the commitment before it lets you continue. Choose Continue to Safe.
  3. Sign once in your wallet to queue the approval in the Safe. Copy link for co-owners gives the others a direct link to it.
  4. The other owners check the approval in Privacy Boost (see below), then sign it in Safe{Wallet}. Once enough have signed, any owner executes it.
  5. Once it executes, Privacy Boost submits the private transaction automatically.

Checking an approval before you sign

In Safe{Wallet}, an approval is an approveSpendBatch call to the Privacy Boost AuthRegistry contract. It doesn’t show the token, amount, or recipient, which is what keeps the payment private, but it also means Safe{Wallet} alone can’t tell you what you’re signing. Before you sign another owner’s approval, sign in to Privacy Boost and open Safe approvals. Each pending approval lists its token, amount, recipient, expiry, and commitment, and its Queue position once the app finds it in the Safe queue. The queue position is the Safe transaction’s nonce, so make sure that’s the transaction you sign. Open in Safe{Wallet} takes you straight to it.

While an approval is pending

An approval expires 72 hours after it’s queued. If the Safe doesn’t execute it by then, nothing is spent, but the expired transaction keeps holding up the Safe queue until it’s cleared (see Safe approvals). The funds a pending approval would spend are set aside, and the balance shows how much is reserved. Earn and swap approvals also commit to a minimum output. If the price moves past it before the spend goes through, the spend waits under Price moved until the price comes back, you discard it, or it expires. Unshields, swaps, and Earn actions go out a random one or two blocks after the Safe executes the approval, which isn’t enough to stop someone linking the two by timing.

Safe approvals

The Safe approvals button at the top right shows what’s waiting on the Safe. Open it to see the queue: Discard drops a pending spend in Privacy Boost. Its Safe transaction stays in the Safe queue and holds up later Safe transactions, so reject it in Safe{Wallet} too. Reject rather than Remove: removing a transaction from the Safe queue doesn’t cancel signatures owners have already given.

Owners and access

Every current owner sees the same balance, history, and pending approvals. Wallets that aren’t owners of the Safe can’t sign in, and neither can an owner you remove from the Safe.

Coming back and switching networks

When you come back, the app shows Welcome back and asks you to sign the sign-in message again. Inside Safe{Wallet}, it asks you to connect your owner wallet on every visit. A Safe account works on one network at a time. To use the Safe on another network, sign out and sign in again on that network. The account is set up separately on each network.

Troubleshooting