Skip to Content
Step-by-Step GuideTroubleshooting

Troubleshooting

Most messages you see during a bridge are informational and clear on their own. Here is what the common ones mean and what to do about them.

”Aztec is unreachable” or “Aztec looks down”

Shield cannot reach the Aztec network, or no new Aztec block has arrived for over 5 minutes. Bridging is paused until the network recovers. Wait a few minutes and try again.

”Aztec is busy”

The Aztec network is congested. Transfers can take longer than usual, or fail. You can still bridge, or wait until the banner clears.

”Over your deposit limit”

The deposit button shows Over your limit. There is a per-user daily deposit cap, measured over a rolling 24 hour window. If the app says “You have reached your deposit limit for now”, you have used up your budget. If it says “That amount is over your remaining limit”, enter a smaller amount; the message shows how much you can still bridge. Your budget frees up gradually as your earlier deposits age past 24 hours, so you can bridge again later without doing anything.

If you verified with Human Passport, you can also reach the $1,000 cumulative cap. Past that, complete Proof of Clean Hands to keep bridging.

”Deposit limit on hold”

The deposit button shows Limit held. When Shield approves a deposit, that deposit’s amount is held against your limits until it settles. This applies to both Proof of Clean Hands and Human Passport deposits, and stops an approval from being saved up and spent later to slip past the caps.

  • If the deposit confirms on-chain, the hold clears, so back-to-back successful deposits are not affected.
  • If the deposit failed or was abandoned, the hold frees up on its own. For Human Passport, this happens once its 30-minute approval window has passed, checked on your next deposit. For Proof of Clean Hands, the held amount counts until it ages out of the 24-hour window.

For the limits themselves, see Limits.

”Address failed compliance screening”

Shield screens your Ethereum address against sanctions and watchlist sources on every deposit and every withdrawal (see Proof of Innocence). If the address matches, Shield issues no approval, so the deposit or withdrawal doesn’t start and your tokens stay where they are. If you think the match is wrong, contact support on Discord .

If the message says screening is temporarily unavailable instead, the screening service is down. Nothing is wrong with your address; try again in a few minutes.

An RPC or batch error message

Some free RPC endpoints reject batched requests. Switch to a paid RPC endpoint, or wait for the automatic retry to go through.

Bridged tokens do not appear

Make sure your Aztec wallet is synced to the correct node. Once the wallet is caught up, your bridged balance shows up.

Check the Activity page too. If the operation shows Deposited but not Claimed, the L2 claim hasn’t run yet; resume it.

My private balance shows 0

The app shows either your public or your private balance, depending on the Privacy Mode switch in the header. Privacy Mode is off by default, so if you bridged in private mode, turn it on to see that balance.

I verified but Shield still asks me to verify

Make sure the Ethereum wallet you verified with is the one connected to Shield, then refresh the page. If you just finished verifying, give it a minute and refresh again.

My balance from the previous version is missing

Each Aztec network upgrade starts a new rollup, so balances from the previous version (Aztec v5) don’t appear here. That version stays available for a transition period so you can withdraw them; see Getting Started.

If a bridge was interrupted rather than erroring, it is not lost. Open the Activity page and resume it.

Last updated on