Skip to main content

Troubleshooting

Common issues and quick fixes.

Google OAuth not working​

  • Confirm VITE_GOOGLE_CLIENT_ID/GOOGLE_CLIENT_ID matches the app in Google Cloud.
  • Redirect URI must match exactly (scheme, host, path).
  • Check browser console for Google SDK loading errors.

Account creation fails​

  • Ensure Aztec RPC is reachable (AZTEC_RPC_URL or VITE_AZTEC_RPC_URL).
  • If testing without Aztec, use the demo flow only; real deployments need RPC access.
  • Rebuild SDK if local changes exist: cd packages/sdk && pnpm build.

SDK import or type errors​

  • Run pnpm install in the repo root.
  • Build the SDK: cd packages/sdk && pnpm build.
  • Type-check: pnpm check or pnpm lint.

Proof generation issues​

  • Verify provider public key fetch succeeds.
  • Check JWT is unmodified and not expired.
  • If adding a new provider, confirm the circuit matches its signature algorithm.

Recovery not finding an account​

  • Use accountExistsForIdentity(authResult) to confirm the address.
  • Make sure you are using the same OAuth aud (client ID) as when the account was created.