Skip to Content
Step-by-Step GuideBackups & Export

Backups & Export

Every deposit and withdrawal creates a small set of claim secrets. You need them to finish the operation, for example to claim your tokens on Aztec. Shield encrypts them in your browser and keeps two encrypted copies: one in your browser and one on Shield’s server. Keeping your own recovery file as well means you can still recover an operation if your browser storage is cleared or you switch devices.

How backups work

  • Shield encrypts the secrets in your browser before anything is stored. The server only ever receives the encrypted copy and can’t read it.
  • The encryption key comes from an unlock signature from your Ethereum wallet. The first time you bridge from a device, your wallet asks for this signature once.
  • After that first unlock, the device remembers a public key that can lock new backups but can’t open them. New deposits and withdrawals on that device back up without asking for the signature again.
  • Opening a backup, to resume or restore an operation, always needs the unlock signature from the same wallet that started it.

Clearing your browser data removes the local copy and the remembered key. Your next bridge asks for the unlock signature again, and a recovery file you downloaded is still your independent safety net.

Download a recovery file

While an operation is still in progress, you can download an encrypted recovery file:

  1. Open the progress screen for the operation.
  2. Select Save a recovery file in the “Keep this tab open” message. If the operation failed, select Recovery file under the error.
  3. Save the JSON file somewhere safe.

The file name describes the operation, for example shield-L1-to-L2-100USDC-public-2026-07-22-1230-a1b2c3d4.json: direction, amount and token, mode, local time, and a short operation ID.

Write down your operation ID as well. You need it to resume an operation from a different device or browser.

Restore from a recovery file

  1. Connect the Ethereum wallet that started the bridge.
  2. Open the Activity page and select Restore from a recovery file.
  3. Drop the JSON file in, or select Choose file.
  4. Sign the unlock message when your wallet asks, then resume the operation.

When you resume from the Activity page without a file, Shield opens the server copy with the same unlock signature. Either way, use the original wallet: a different wallet can’t decrypt the secrets.

Last updated on