Errors

PrivataError
├── AuthError           (INVALID_KEY, SCOPE_REQUIRED)
├── RateLimitedError    (RATE_LIMITED)              .retryAfterMs
├── ValidationError     (INVALID_PAIR, AMOUNT_TOO_*) .fields
├── QuoteExpiredError   (QUOTE_EXPIRED)
├── OrderError
│   ├── OrderNotFoundError       (ORDER_NOT_FOUND)
│   └── DuplicateOrderError      (DUPLICATE_ACTIVE_ORDER) .existingOrderId
├── ProviderError       (PROVIDER_ERROR, NO_PROVIDERS_AVAILABLE)
├── RefundError
│   ├── RefundWindowExpiredError (REFUND_WINDOW_EXPIRED)
│   ├── RefundNotProgrammaticError (REFUND_NOT_PROGRAMMATIC)
│   └── StableTargetRequiredError (STABLE_TARGET_REQUIRED)
├── WebhookPausedError  (WEBHOOK_PAUSED)
└── NetworkError        (timeouts, DNS, connection reset)

interface PrivataError extends Error {
  code: string;
  httpStatus: number;
  requestId?: string;
  message: string;
}

import {
  RateLimitedError,
  QuoteExpiredError,
  DuplicateOrderError,
  ValidationError,
  PrivataError,
} from "@privata/wallet-api";

try {
  await privata.createOrder({ ... });
} catch (e) {
  if (e instanceof RateLimitedError) return retry(after: e.retryAfterMs);
  if (e instanceof QuoteExpiredError) return reQuote();
  if (e instanceof DuplicateOrderError) return privata.getOrder(e.existingOrderId);
  if (e instanceof ValidationError) return showFieldErrors(e.fields);

  // Surface unknown errors with request_id so support can trace.
  if (e instanceof PrivataError) {
    log.error({ code: e.code, requestId: e.requestId }, e.message);
  }
  throw e;
}