SDK Error Handling

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.