SDK Error Handling

Retry and recovery guidance for proof polling, private proof reads, hosted flows, and verifier failures.

Common Failure Classes

Failure class	Where it appears	Recovery
Validation error	Local SDK usage	Fix the request shape before retrying
Hosted interactive handoff	Interactive verifier in a custom flow	Redirect to hosted verify or use `VerifyGate`
Async processing	Proof not finished yet	Poll status with backoff
Private proof auth required	Owner-only reads	Re-authenticate the owner and retry
Upstream outage	Auth/session BFF routes	Respect `Retry-After` and surface a retry path

const final = await client.pollProofStatus(proofId, {
  interval: 3000,
  timeout: 60000
});

const privateData = await client.getPrivateStatus(proofId, window.ethereum);

Do not spam verification creation on ambiguous failures.
Keep proof receipt IDs so you can resume polling or display the proof later.
Surface interactive verifier requirements clearly; don’t hide hosted handoffs behind generic error copy.