Error Reference

{
  "type": "https://docs.sumvin.com/errors/pint_revoked",
  "title": "PINT Revoked",
  "status": 409,
  "detail": "PINT sr:us:pint:abc123 was revoked at 2026-02-13T11:30:00Z. No new tokens can be issued.",
  "instance": "/v0/sis/token/pint",
  "error_code": "PINT-409-002",
  "documentation": "https://docs.sumvin.com/errors/PINT-409-002"
}

interface ProblemDetail {
  type: string;
  title: string;
  status: number;
  detail: string;
  instance: string;
  error_code: string;
  documentation: string;
}

async function exchangePint(payload: unknown): Promise<Response> {
  const response = await fetch("https://sis.sumvin.com/v0/sis/token/pint", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.SIS_API_KEY}`,
    },
    body: JSON.stringify(payload),
  });

  if (!response.ok) {
    const error: ProblemDetail = await response.json();

    switch (error.error_code) {
      case "PINT-409-001":
        // Nonce conflict — increment and retry
        throw new RetryableError("Nonce already used", error);
      case "PINT-429-001":
        // Rate limited — wait and retry
        const retryAfter = response.headers.get("Retry-After");
        throw new RateLimitError(retryAfter, error);
      case "PINT-424-001":
        // On-chain call failed — retry with backoff
        throw new RetryableError("EIP-1271 check failed", error);
      default:
        throw new PintExchangeError(error);
    }
  }

  return response;
}

import requests

def exchange_pint(payload: dict, api_key: str) -> dict:
    response = requests.post(
        "https://sis.sumvin.com/v0/sis/token/pint",
        json=payload,
        headers={"Authorization": f"Bearer {api_key}"},
    )

    if not response.ok:
        error = response.json()
        error_code = error.get("error_code", "")

        if error_code == "PINT-409-001":
            raise NonceConflictError(error["detail"])
        elif error_code in ("PINT-429-001",):
            retry_after = response.headers.get("Retry-After", "30")
            raise RateLimitError(error["detail"], int(retry_after))
        elif error_code == "PINT-424-001":
            raise RetryableError(error["detail"])
        else:
            raise PintExchangeError(error["detail"], error_code)

    return response.json()