@usewhisk/cctp 0.0.0 → 0.1.0

package/dist/iris.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/iris/urls.ts","../src/errors.ts","../src/iris/limiter.ts","../src/iris/fetch.ts","../src/iris/types.ts","../src/fees/math.ts","../src/iris/fees.ts","../src/iris/messages.ts","../src/iris/reattest.ts","../src/iris/quote.ts"],"names":["sleep","DEFAULT_TIMEOUT_MS"],"mappings":"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","file":"iris.cjs","sourcesContent":["import type { Network } from \"../chains/types.js\";\n\nexport const IRIS_MAINNET_URL = \"https://iris-api.circle.com\";\nexport const IRIS_SANDBOX_URL = \"https://iris-api-sandbox.circle.com\";\n\nexport function irisBaseUrl(network: Network): string {\n  return network === \"mainnet\" ? IRIS_MAINNET_URL : IRIS_SANDBOX_URL;\n}\n","/**\n * Error hierarchy for `@usewhisk/cctp`.\n *\n * Each subclass has a stable `code` callers can switch on, plus a\n * machine-readable `name`. Human-readable detail goes in `message`.\n *\n * Layers:\n *   - `InvalidInputError`: caller passed bad data\n *   - `IrisError`: HTTP / parse failures from Iris\n *   - `ProtocolError`: CCTP-level invariant violated\n *   - `UnsupportedError`: the chain or ecosystem can't serve the call\n */\n\nexport type CctpErrorCode =\n  // input\n  | \"invalid_address\"\n  | \"invalid_bytes32\"\n  | \"invalid_amount\"\n  | \"invalid_chain\"\n  | \"invalid_domain\"\n  | \"invalid_input\"\n  // iris\n  | \"iris_http\"\n  | \"iris_network\"\n  | \"iris_parse\"\n  | \"iris_aborted\"\n  | \"iris_rate_limited\"\n  // protocol\n  | \"amount_too_large\"\n  | \"fee_unavailable\"\n  | \"tier_not_found\"\n  | \"no_route\"\n  | \"rpc_unavailable\"\n  // unsupported\n  | \"unsupported_chain\"\n  | \"unsupported_ecosystem\";\n\nexport class CctpError extends Error {\n  readonly code: CctpErrorCode;\n  override readonly cause?: unknown;\n\n  constructor(code: CctpErrorCode, message: string, cause?: unknown) {\n    super(message);\n    this.name = \"CctpError\";\n    this.code = code;\n    if (cause !== undefined) this.cause = cause;\n  }\n}\n\n/** Caller passed bad input. The fix is in the calling code. */\nexport class InvalidInputError extends CctpError {\n  constructor(code: CctpErrorCode, message: string, cause?: unknown) {\n    super(code, message, cause);\n    this.name = \"InvalidInputError\";\n  }\n}\n\n/** HTTP, JSON, or network failures from Iris. May be transient. */\nexport class IrisError extends CctpError {\n  constructor(code: CctpErrorCode, message: string, cause?: unknown) {\n    super(code, message, cause);\n    this.name = \"IrisError\";\n  }\n}\n\n/** HTTP non-2xx response from Iris. */\nexport class IrisHttpError extends IrisError {\n  readonly status: number;\n  readonly bodySnippet: string;\n  readonly url: string;\n  constructor(status: number, url: string, bodySnippet: string) {\n    super(\n      \"iris_http\",\n      `Iris ${status} on ${url}: ${bodySnippet.slice(0, 200)}`,\n    );\n    this.name = \"IrisHttpError\";\n    this.status = status;\n    this.url = url;\n    this.bodySnippet = bodySnippet;\n  }\n}\n\n/**\n * Iris answered 429, which blocks every request from this IP for five\n * minutes. `retryAt` is when this process will ask again, in ms since the\n * epoch.\n */\nexport class IrisRateLimitedError extends IrisError {\n  readonly retryAt: number;\n  readonly host: string;\n  constructor(host: string, retryAt: number) {\n    super(\n      \"iris_rate_limited\",\n      `Iris rate limit reached on ${host}; requests resume at ${new Date(retryAt).toISOString()}`,\n    );\n    this.name = \"IrisRateLimitedError\";\n    this.host = host;\n    this.retryAt = retryAt;\n  }\n}\n\n/** Network failure or per-request timeout, after retries. */\nexport class IrisNetworkError extends IrisError {\n  constructor(message: string, cause?: unknown) {\n    super(\"iris_network\", message, cause);\n    this.name = \"IrisNetworkError\";\n  }\n}\n\n/** Iris returned non-JSON or unexpected JSON shape. */\nexport class IrisParseError extends IrisError {\n  constructor(message: string, cause?: unknown) {\n    super(\"iris_parse\", message, cause);\n    this.name = \"IrisParseError\";\n  }\n}\n\n/** The caller's AbortSignal fired. */\nexport class IrisAbortedError extends IrisError {\n  constructor(message: string) {\n    super(\"iris_aborted\", message);\n    this.name = \"IrisAbortedError\";\n  }\n}\n\n/** CCTP-level invariant violated. */\nexport class ProtocolError extends CctpError {\n  constructor(code: CctpErrorCode, message: string, cause?: unknown) {\n    super(code, message, cause);\n    this.name = \"ProtocolError\";\n  }\n}\n\n/** The chain or ecosystem can't serve this call. */\nexport class UnsupportedError extends CctpError {\n  constructor(code: CctpErrorCode, message: string) {\n    super(code, message);\n    this.name = \"UnsupportedError\";\n  }\n}\n\nexport function isCctpError(value: unknown): value is CctpError {\n  return value instanceof CctpError;\n}\n","import { IrisRateLimitedError } from \"../errors.js\";\n\nexport type IrisLimiterOptions = {\n  /** Circle's limit is 35 a second; staying under it leaves room for others. */\n  ratePerSecond?: number;\n  /** Circle blocks the IP for five minutes after a 429. */\n  standDownMs?: number;\n  now?: () => number;\n  sleep?: (ms: number) => Promise<void>;\n};\n\nexport type IrisLimiter = {\n  /** Waits for a request slot, or throws while the host is standing down. */\n  acquire(host: string): Promise<void>;\n  /** Records a 429 and returns when requests may resume. */\n  standDown(host: string): number;\n  now(): number;\n  sleep(ms: number): Promise<void>;\n};\n\ntype Bucket = { tokens: number; updatedAt: number; blockedUntil: number };\n\nexport function createIrisLimiter(\n  options: IrisLimiterOptions = {},\n): IrisLimiter {\n  const rate = options.ratePerSecond ?? 30;\n  const standDownMs = options.standDownMs ?? 5 * 60_000;\n  const now = options.now ?? (() => Date.now());\n  const sleep =\n    options.sleep ??\n    ((ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms)));\n  const buckets = new Map<string, Bucket>();\n\n  const bucket = (host: string): Bucket => {\n    let b = buckets.get(host);\n    if (!b) {\n      b = { tokens: rate, updatedAt: now(), blockedUntil: 0 };\n      buckets.set(host, b);\n    }\n    return b;\n  };\n\n  return {\n    async acquire(host) {\n      const b = bucket(host);\n      if (now() < b.blockedUntil) {\n        throw new IrisRateLimitedError(host, b.blockedUntil);\n      }\n      const elapsed = (now() - b.updatedAt) / 1000;\n      b.tokens = Math.min(rate, b.tokens + elapsed * rate);\n      b.updatedAt = now();\n      if (b.tokens < 1) {\n        const waitMs = Math.ceil(((1 - b.tokens) / rate) * 1000);\n        await sleep(waitMs);\n        b.tokens += (waitMs / 1000) * rate;\n        b.updatedAt = now();\n      }\n      b.tokens -= 1;\n    },\n    standDown(host) {\n      const b = bucket(host);\n      b.blockedUntil = now() + standDownMs;\n      return b.blockedUntil;\n    },\n    now,\n    sleep,\n  };\n}\n\n/** Shared by every Iris call in the process, as Circle's limit is per IP. */\nexport const defaultIrisLimiter = createIrisLimiter();\n","/**\n * Iris fetch wrapper with timeout, retry, and `AbortSignal`.\n *\n * Error mapping:\n *   - 4xx (except 429)        → IrisHttpError (no retry)\n *   - 429                     → IrisRateLimitedError (no retry)\n *   - 5xx                     → retry, then IrisHttpError\n *   - Network failure         → retry, then IrisNetworkError\n *   - Caller-signaled abort   → IrisAbortedError\n *   - Per-request timeout     → retry, then IrisNetworkError\n *   - JSON parse failure      → IrisParseError (no retry)\n */\n\nimport {\n  IrisAbortedError,\n  IrisHttpError,\n  IrisNetworkError,\n  IrisParseError,\n  IrisRateLimitedError,\n} from \"../errors.js\";\nimport { defaultIrisLimiter, type IrisLimiter } from \"./limiter.js\";\n\nexport type FetchJsonOptions = {\n  /** Per-request timeout in ms. Default 5000. */\n  timeoutMs?: number;\n  /** Retries after the first attempt. Default 3. */\n  maxRetries?: number;\n  /** Base delay between retries in ms. Backoff multiplies by retry index. */\n  baseDelayMs?: number;\n  signal?: AbortSignal;\n  /** Defaults to the global `fetch`. */\n  fetch?: typeof fetch;\n  /** Defaults to one limiter shared by every Iris call in the process. */\n  limiter?: IrisLimiter;\n};\n\nconst DEFAULT_TIMEOUT_MS = 5000;\nconst DEFAULT_MAX_RETRIES = 3;\nconst DEFAULT_BASE_DELAY_MS = 300;\n\nexport async function fetchIrisJson<T>(\n  url: string,\n  options: FetchJsonOptions = {},\n  request: { method: \"POST\"; body: unknown } | { method: \"GET\" } = {\n    method: \"GET\",\n  },\n): Promise<T> {\n  const {\n    timeoutMs = DEFAULT_TIMEOUT_MS,\n    maxRetries = DEFAULT_MAX_RETRIES,\n    baseDelayMs = DEFAULT_BASE_DELAY_MS,\n    signal,\n    fetch: fetchImpl = fetch,\n    limiter = defaultIrisLimiter,\n  } = options;\n  const host = new URL(url).host;\n\n  let lastError: unknown;\n\n  for (let attempt = 0; attempt <= maxRetries; attempt++) {\n    if (signal?.aborted) throw new IrisAbortedError(\"Aborted by caller\");\n    await limiter.acquire(host);\n\n    const ctrl = new AbortController();\n    const timer = setTimeout(() => ctrl.abort(), timeoutMs);\n    const onCallerAbort = () => ctrl.abort();\n    signal?.addEventListener(\"abort\", onCallerAbort);\n\n    try {\n      const res = await fetchImpl(url, {\n        method: request.method,\n        headers: {\n          accept: \"application/json\",\n          ...(request.method === \"POST\" && {\n            \"content-type\": \"application/json\",\n          }),\n        },\n        ...(request.method === \"POST\" && {\n          body: JSON.stringify(request.body),\n        }),\n        signal: ctrl.signal,\n      });\n\n      if (res.ok) {\n        let json: unknown;\n        try {\n          json = await res.json();\n        } catch (err) {\n          throw new IrisParseError(`Invalid JSON from ${url}`, err);\n        }\n        return json as T;\n      }\n\n      // A retry inside the block would extend it, so stop asking at once.\n      if (res.status === 429) {\n        throw new IrisRateLimitedError(host, limiter.standDown(host));\n      }\n\n      if (res.status >= 400 && res.status < 500 && res.status !== 429) {\n        throw new IrisHttpError(res.status, url, await safeText(res));\n      }\n\n      lastError = new IrisHttpError(res.status, url, await safeText(res));\n    } catch (err) {\n      // Parse errors and 4xx HTTP errors bypass the retry loop.\n      if (err instanceof IrisParseError) throw err;\n      if (err instanceof IrisRateLimitedError) throw err;\n      if (err instanceof IrisHttpError) {\n        if (err.status < 500 && err.status !== 429) throw err;\n      }\n      // A timeout aborts too, but only the caller's signal stops the retries.\n      if (signal?.aborted) throw new IrisAbortedError(\"Aborted by caller\");\n      lastError = err;\n    } finally {\n      clearTimeout(timer);\n      signal?.removeEventListener(\"abort\", onCallerAbort);\n    }\n\n    if (attempt < maxRetries) {\n      await sleep(baseDelayMs * (attempt + 1), signal);\n    }\n  }\n\n  if (lastError instanceof IrisHttpError) throw lastError;\n  throw new IrisNetworkError(\n    `Iris request failed after ${maxRetries + 1} attempts`,\n    lastError,\n  );\n}\n\nasync function safeText(res: Response): Promise<string> {\n  try {\n    return await res.text();\n  } catch {\n    return \"\";\n  }\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new IrisAbortedError(\"Aborted by caller\"));\n      return;\n    }\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    function onAbort() {\n      clearTimeout(timer);\n      reject(new IrisAbortedError(\"Aborted by caller\"));\n    }\n    signal?.addEventListener(\"abort\", onAbort);\n  });\n}\n","import type { CctpDomain } from \"../chains/types.js\";\n\n/** Fast Transfer attests after a block or two, before hard finality. */\nexport const FINALITY_FAST = 1000 as const;\n/** Standard Transfer attests after hard finality. */\nexport const FINALITY_STANDARD = 2000 as const;\nexport type FinalityThreshold = typeof FINALITY_FAST | typeof FINALITY_STANDARD;\n\nexport type TransferSpeed = \"fast\" | \"standard\";\n\n/**\n * Forwarder fee levels returned per finality level, in USDC subunits.\n * Circle recommends `med` or higher.\n */\nexport type ForwarderFeeTier = {\n  low: bigint;\n  med: bigint;\n  high: bigint;\n};\n\n/**\n * A Fast or Standard row of the `/v2/burn/USDC/fees/{src}/{dst}` response, parsed.\n *\n * `minimumFee` is in hundredths of a basis point: Iris's `1.3` is `130n`.\n * `forwardFee` is present only when `?forward=true` is set on the request.\n */\nexport type BurnFeeTier = {\n  finalityThreshold: FinalityThreshold;\n  minimumFee: bigint;\n  forwardFee?: ForwarderFeeTier;\n};\n\n/** Iris never reports a failed attestation; a slow one stays pending. */\nexport type IrisAttestationStatus = \"pending_confirmations\" | \"complete\";\n\n/** Why a message is slower than asked. None of these is a failure. */\nexport type IrisDelayReason =\n  | \"insufficient_fee\"\n  | \"amount_above_max\"\n  | \"insufficient_allowance_available\";\n\n/**\n * Circle Orbit forwarder lifecycle status. Present only when the burn\n * was triggered with the forwarder hookData.\n *\n * - `PENDING`: relayer is processing.\n * - `CONFIRMED`: relayer submitted the mint, waiting on finality.\n * - `COMPLETE`: mint finalized.\n * - `FAILED`: relayer rejected; fall back to manual mint.\n */\nexport type ForwardState = \"PENDING\" | \"CONFIRMED\" | \"COMPLETE\" | \"FAILED\";\n\n/**\n * Single message returned by `/v2/messages/{srcDomain}`.\n */\nexport type IrisMessage = {\n  /** Raw 0x-prefixed CCTP message bytes; pass to receiveMessage. */\n  message: `0x${string}`;\n  /** Raw 0x-prefixed attestation bytes; pass to receiveMessage. */\n  attestation: `0x${string}`;\n  /** Decimal string. */\n  eventNonce: string;\n  status: IrisAttestationStatus;\n  cctpVersion: 2;\n  /** Present when burn included forwarder hookData. */\n  forwardState?: ForwardState | null;\n  /** Destination tx hash when forwardState is CONFIRMED or COMPLETE. */\n  forwardTxHash?: string | null;\n  delayReason?: IrisDelayReason | null;\n  /** Decoded message and message body, if Iris can decode them. */\n  decodedMessage?: {\n    sourceDomain: string;\n    destinationDomain: string;\n    nonce: `0x${string}`;\n    sender: string | null;\n    recipient: string | null;\n    destinationCaller: string | null;\n    minFinalityThreshold: string;\n    finalityThresholdExecuted: string;\n    messageBody: `0x${string}`;\n    decodedMessageBody?: {\n      burnToken: string | null;\n      mintRecipient: string | null;\n      amount: string;\n      messageSender: string | null;\n      maxFee: string;\n      feeExecuted: string;\n      expirationBlock: string;\n      hookData: `0x${string}` | null;\n    };\n  };\n};\n\nexport type IrisMessagesResponse = {\n  messages: IrisMessage[];\n};\n\n/**\n * Filters for getMessages. Pass at least one of `transactionHash` or `nonce`.\n */\nexport type GetMessagesQuery = {\n  sourceDomain: CctpDomain;\n  transactionHash?: string;\n  nonce?: string;\n};\n","/**\n * Fee math for CCTP V2 bridges.\n *\n * Two protocol-level fees stack on a Fast Transfer + Forwarder bridge:\n *\n *   1. Burn fee: a rate on the transfer amount, charged by CCTP. Iris\n *      returns `minimumFee` in basis points with up to two decimals\n *      (`1.3` is 0.013%). Whisk holds it as hundredths of a basis\n *      point, so `1.3` becomes `130n`.\n *\n *   2. Forwarder fee: a flat USDC fee that pays for destination gas\n *      and the relayer. Iris returns low, med and high levels in USDC\n *      subunits. Whisk defaults to `med`.\n *\n * `maxFee` on `depositForBurnWithHook` must cover both. Every step\n * rounds up: a `maxFee` one subunit short turns a Fast transfer into a\n * Standard one.\n */\n\nimport type { BurnFeeTier, ForwarderFeeTier } from \"../iris/types.js\";\nimport { InvalidInputError, IrisParseError, ProtocolError } from \"../errors.js\";\n\nconst CENTI_BPS_PER_UNIT = 1_000_000n;\n\nconst DECIMAL = /^(\\d+)(?:\\.(\\d+))?$/;\n\n// JSON numbers reach us already parsed. String() gives back the shortest\n// decimal that round-trips, which is the literal Iris sent for any value\n// with 15 or fewer significant digits. Exponent forms are refused.\nfunction ceilDecimal(raw: unknown, decimals: number, what: string): bigint {\n  const text =\n    typeof raw === \"number\" ? String(raw) : typeof raw === \"string\" ? raw : \"\";\n  const match = DECIMAL.exec(text);\n  if (!match) {\n    throw new IrisParseError(`Iris ${what} is invalid: ${String(raw)}`);\n  }\n  const fraction = match[2] ?? \"\";\n  const kept = fraction.slice(0, decimals).padEnd(decimals, \"0\");\n  const dropped = /[1-9]/.test(fraction.slice(decimals)) ? 1n : 0n;\n  return BigInt((match[1] ?? \"0\") + kept) + dropped;\n}\n\n/** Iris's `minimumFee` as hundredths of a basis point: `1.3` is `130n`. */\nexport function parseFeeBps(raw: unknown): bigint {\n  return ceilDecimal(raw, 2, \"minimumFee\");\n}\n\n/** An Iris forwarder fee in USDC subunits, rounded up. */\nexport function parseForwarderFee(raw: unknown): bigint {\n  return ceilDecimal(raw, 0, \"forwardFee\");\n}\n\n/**\n * The CCTP burn fee on `amount` subunits at `feeCentiBps` hundredths of\n * a basis point, rounded up.\n */\nexport function computeBurnFee(amount: bigint, feeCentiBps: bigint): bigint {\n  if (amount < 0n) {\n    throw new InvalidInputError(\n      \"invalid_amount\",\n      `amount must be non-negative, got ${amount}`,\n    );\n  }\n  if (feeCentiBps < 0n) {\n    throw new InvalidInputError(\n      \"invalid_input\",\n      `feeCentiBps must be non-negative, got ${feeCentiBps}`,\n    );\n  }\n  return ceilDiv(amount * feeCentiBps, CENTI_BPS_PER_UNIT);\n}\n\n/** The forwarder fee for a level, in USDC subunits. */\nexport function selectForwarderFee(\n  tier: BurnFeeTier,\n  level: keyof ForwarderFeeTier = \"med\",\n): bigint {\n  if (!tier.forwardFee) {\n    throw new ProtocolError(\n      \"fee_unavailable\",\n      \"Tier has no forwardFee. Fetch burn fees with includeForwarderFee=true\",\n    );\n  }\n  const value = tier.forwardFee[level];\n  if (value < 0n) {\n    throw new ProtocolError(\n      \"fee_unavailable\",\n      `Invalid forwardFee.${level}: ${value}`,\n    );\n  }\n  return value;\n}\n\nexport type ComputeMaxFeeInput = {\n  /** Transfer amount in USDC subunits. */\n  amount: bigint;\n  /** Selected tier (Fast or Standard). */\n  tier: BurnFeeTier;\n  /** Forwarder fee level; defaults to `\"med\"`. */\n  forwarderLevel?: keyof ForwarderFeeTier;\n  /**\n   * Whole basis points added to the forwarder fee (0 to 10000). Iris's\n   * `high` level already carries a buffer, so this defaults to 0.\n   */\n  forwarderBufferBps?: number;\n  /** Whether to include the forwarder fee. Defaults to `true`. */\n  includeForwarder?: boolean;\n  /**\n   * Whole basis points added to the protocol fee in `maxFee` only. Circle\n   * takes the fee it executes, so the buffer is a ceiling, not a charge.\n   */\n  burnFeeBufferBps?: number;\n  /** The on-chain minimum from `getMinFeeAmount`, in USDC subunits. */\n  minBurnFee?: bigint;\n};\n\nexport type ComputeMaxFeeResult = {\n  /** The protocol fee, raised to `minBurnFee` if lower, before any buffer. */\n  burnFee: bigint;\n  forwarderFee: bigint;\n  /** Total cap to pass as `maxFee` on `depositForBurnWithHook`. */\n  maxFee: bigint;\n};\n\n/**\n *   maxFee = burnFee (+ buffer) + forwarderFee (+ buffer)\n *\n * The result is a cap; the actual deducted fee can be less.\n */\nexport function computeMaxFee(input: ComputeMaxFeeInput): ComputeMaxFeeResult {\n  const {\n    amount,\n    tier,\n    forwarderLevel = \"med\",\n    forwarderBufferBps = 0,\n    includeForwarder = true,\n    burnFeeBufferBps = 0,\n    minBurnFee = 0n,\n  } = input;\n\n  const irisFee = computeBurnFee(amount, tier.minimumFee);\n  const burnFee = irisFee > minBurnFee ? irisFee : minBurnFee;\n  const forwarderFee = includeForwarder\n    ? applyBufferBps(\n        selectForwarderFee(tier, forwarderLevel),\n        forwarderBufferBps,\n      )\n    : 0n;\n\n  return {\n    burnFee,\n    forwarderFee,\n    maxFee: applyBufferBps(burnFee, burnFeeBufferBps) + forwarderFee,\n  };\n}\n\nfunction applyBufferBps(value: bigint, bps: number): bigint {\n  if (!Number.isSafeInteger(bps) || bps < 0) {\n    throw new InvalidInputError(\n      \"invalid_input\",\n      `bufferBps must be a non-negative whole number, got ${bps}`,\n    );\n  }\n  return ceilDiv(value * (10_000n + BigInt(bps)), 10_000n);\n}\n\nfunction ceilDiv(numerator: bigint, denominator: bigint): bigint {\n  return (numerator + denominator - 1n) / denominator;\n}\n","/**\n * Iris burn fees endpoint.\n *\n * GET /v2/burn/USDC/fees/{src}/{dst}?forward=true\n *\n * Returns one row per finality threshold (1000 = Fast, 2000 = Standard).\n * Each row has the protocol fee in basis points and, with ?forward=true,\n * the forwarder fee levels low/med/high in USDC subunits.\n */\nimport type { CctpDomain, Network } from \"../chains/types.js\";\nimport { irisBaseUrl } from \"./urls.js\";\nimport { fetchIrisJson, type FetchJsonOptions } from \"./fetch.js\";\nimport type {\n  BurnFeeTier,\n  FinalityThreshold,\n  ForwarderFeeTier,\n  TransferSpeed,\n} from \"./types.js\";\nimport { FINALITY_FAST, FINALITY_STANDARD } from \"./types.js\";\nimport { IrisParseError, ProtocolError } from \"../errors.js\";\nimport {\n  parseFeeBps,\n  parseForwarderFee,\n  selectForwarderFee,\n} from \"../fees/math.js\";\n\nexport type GetBurnFeesOptions = FetchJsonOptions & {\n  /** Default `true`. Set to `false` if you only need protocol fees. */\n  includeForwarderFee?: boolean;\n};\n\n/**\n * Rows for thresholds other than Fast and Standard are dropped. Use\n * `pickFeeTier` to choose one.\n */\nexport async function getBurnFees(\n  network: Network,\n  sourceDomain: CctpDomain,\n  destinationDomain: CctpDomain,\n  options: GetBurnFeesOptions = {},\n): Promise<BurnFeeTier[]> {\n  const { includeForwarderFee = true, ...fetchOpts } = options;\n  const base = irisBaseUrl(network);\n  const url = new URL(\n    `${base}/v2/burn/USDC/fees/${sourceDomain}/${destinationDomain}`,\n  );\n  if (includeForwarderFee) url.searchParams.set(\"forward\", \"true\");\n\n  const raw = await fetchIrisJson<unknown>(url.toString(), fetchOpts);\n  if (!Array.isArray(raw)) {\n    throw new IrisParseError(\"Iris burn-fees response is not an array\");\n  }\n  return raw\n    .map((row) => normalizeTier(row))\n    .filter((t): t is BurnFeeTier => t !== null);\n}\n\nfunction normalizeTier(row: unknown): BurnFeeTier | null {\n  if (!row || typeof row !== \"object\") {\n    throw new IrisParseError(\"Iris fee tier is not an object\");\n  }\n  const r = row as Record<string, unknown>;\n  const threshold = r.finalityThreshold;\n  if (threshold !== FINALITY_FAST && threshold !== FINALITY_STANDARD) {\n    return null;\n  }\n  const out: BurnFeeTier = {\n    finalityThreshold: threshold,\n    minimumFee: parseFeeBps(r.minimumFee),\n  };\n  if (r.forwardFee && typeof r.forwardFee === \"object\") {\n    const ff = r.forwardFee as Record<string, unknown>;\n    out.forwardFee = {\n      low: parseForwarderFee(ff.low),\n      med: parseForwarderFee(ff.med),\n      high: parseForwarderFee(ff.high),\n    };\n  }\n  return out;\n}\n\n/** The row for `speed`. Throws if Iris returned none for this route. */\nexport function pickFeeTier(\n  tiers: readonly BurnFeeTier[],\n  speed: TransferSpeed,\n): BurnFeeTier {\n  const threshold: FinalityThreshold =\n    speed === \"fast\" ? FINALITY_FAST : FINALITY_STANDARD;\n  const tier = tiers.find((t) => t.finalityThreshold === threshold);\n  if (!tier) {\n    throw new ProtocolError(\n      \"tier_not_found\",\n      `Iris returned no ${speed === \"fast\" ? \"Fast\" : \"Standard\"} Transfer fee for this route.`,\n    );\n  }\n  return tier;\n}\n\n/** The forwarder fee for a level, in USDC subunits. */\nexport function pickForwarderFee(\n  tier: BurnFeeTier,\n  level: keyof ForwarderFeeTier = \"med\",\n): bigint {\n  return selectForwarderFee(tier, level);\n}\n","/**\n * Iris messages endpoint.\n *\n * GET /v2/messages/{srcDomain}?transactionHash=...\n * GET /v2/messages/{srcDomain}?nonce=...\n *\n * Returns the message + attestation + forwarder state in a single\n * call. Use this to drive recovery polling.\n */\nimport type { CctpDomain, Network } from \"../chains/types.js\";\nimport { irisBaseUrl } from \"./urls.js\";\nimport { fetchIrisJson, type FetchJsonOptions } from \"./fetch.js\";\nimport {\n  IrisAbortedError,\n  IrisHttpError,\n  IrisRateLimitedError,\n} from \"../errors.js\";\nimport type { SecondsRange } from \"../chains/attestation.js\";\nimport { defaultIrisLimiter } from \"./limiter.js\";\nimport type {\n  GetMessagesQuery,\n  IrisMessage,\n  IrisMessagesResponse,\n} from \"./types.js\";\n\nexport type GetMessagesOptions = FetchJsonOptions & {\n  network: Network;\n  /** Defaults to Circle's Iris host for `network`. */\n  baseUrl?: string;\n};\n\n/**\n * Single fetch. Returns an empty array when Iris doesn't yet know about\n * the burn, whether it answers `messages: []` or 404.\n */\nexport async function getMessages(\n  query: GetMessagesQuery,\n  options: GetMessagesOptions,\n): Promise<IrisMessage[]> {\n  const { network, baseUrl, ...fetchOpts } = options;\n  const base = (baseUrl ?? irisBaseUrl(network)).replace(/\\/+$/, \"\");\n  const url = new URL(`${base}/v2/messages/${query.sourceDomain}`);\n  if (query.transactionHash) {\n    url.searchParams.set(\"transactionHash\", query.transactionHash);\n  }\n  if (query.nonce) {\n    url.searchParams.set(\"nonce\", query.nonce);\n  }\n  try {\n    const json = await fetchIrisJson<IrisMessagesResponse>(\n      url.toString(),\n      fetchOpts,\n    );\n    return json.messages ?? [];\n  } catch (err) {\n    if (err instanceof IrisHttpError && err.status === 404) {\n      return [];\n    }\n    throw err;\n  }\n}\n\nexport type PollMessageOptions = GetMessagesOptions & {\n  /** Polling interval in ms. Default 3000, or from {@link pollBudget}. */\n  intervalMs?: number;\n  /** Total timeout in ms. Default 15 minutes, or from {@link pollBudget}. */\n  timeoutMs?: number;\n  /**\n   * Custom predicate to decide when polling is \"done\". Default: a forwarded\n   * message once Circle's relayer is done or has failed, otherwise once the\n   * attestation is complete.\n   */\n  isDone?: (message: IrisMessage) => boolean;\n  /**\n   * Called when a 429 makes the poll stand down, with the time it resumes.\n   * The wait does not count against `timeoutMs`.\n   */\n  onRateLimited?: (retryAt: number) => void;\n};\n\nconst DEFAULT_INTERVAL_MS = 3000;\nconst DEFAULT_TIMEOUT_MS = 15 * 60 * 1000;\nconst TIMEOUT_MARGIN_MS = 5 * 60 * 1000;\n\n/**\n * How often and how long to poll for a route whose attestation takes\n * `eta` seconds. Fast routes poll often so the payer hears at once; hour-long\n * ones poll gently so they do not eat the shared rate limit.\n */\nexport function pollBudget(eta: SecondsRange): {\n  intervalMs: number;\n  timeoutMs: number;\n} {\n  const intervalMs =\n    eta.max <= 60 ? 2_000 : eta.max <= 30 * 60 ? 10_000 : 30_000;\n  return { intervalMs, timeoutMs: eta.max * 2 * 1000 + TIMEOUT_MARGIN_MS };\n}\n\n/**\n * Circle's relayer has minted once it reports the mint `CONFIRMED` or\n * `COMPLETE` with its tx hash. `PENDING` can carry a hash that is not mined.\n */\nexport function isForwardDone(message: IrisMessage): boolean {\n  return (\n    (message.forwardState === \"CONFIRMED\" ||\n      message.forwardState === \"COMPLETE\") &&\n    !!message.forwardTxHash\n  );\n}\n\nfunction defaultIsDone(message: IrisMessage): boolean {\n  if (message.forwardState != null) {\n    return isForwardDone(message) || message.forwardState === \"FAILED\";\n  }\n  return message.status === \"complete\";\n}\n\n/**\n * Returns the message once `isDone` holds, or on timeout the latest one\n * seen (`null` if none). Throws if Iris keeps failing; a slow attestation\n * only times out.\n */\nexport async function pollMessages(\n  query: GetMessagesQuery,\n  options: PollMessageOptions,\n): Promise<IrisMessage | null> {\n  const {\n    intervalMs = DEFAULT_INTERVAL_MS,\n    timeoutMs = DEFAULT_TIMEOUT_MS,\n    isDone = defaultIsDone,\n    onRateLimited,\n    signal,\n    ...rest\n  } = options;\n  const limiter = rest.limiter ?? defaultIrisLimiter;\n\n  let deadline = limiter.now() + timeoutMs;\n  let latest: IrisMessage | null = null;\n\n  while (limiter.now() < deadline) {\n    if (signal?.aborted) throw new IrisAbortedError(\"Aborted by caller\");\n\n    let messages: IrisMessage[];\n    try {\n      messages = await getMessages(query, { ...rest, signal });\n    } catch (err) {\n      if (!(err instanceof IrisRateLimitedError)) throw err;\n      onRateLimited?.(err.retryAt);\n      const waitMs = Math.max(0, err.retryAt - limiter.now());\n      deadline += waitMs;\n      await limiter.sleep(waitMs);\n      continue;\n    }\n    if (messages.length > 0) {\n      const first = messages[0];\n      if (first) {\n        latest = first;\n        if (isDone(first)) return first;\n      }\n    }\n\n    await sleep(intervalMs, signal);\n  }\n\n  return latest;\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new IrisAbortedError(\"Aborted by caller\"));\n      return;\n    }\n    const timer = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    function onAbort() {\n      clearTimeout(timer);\n      reject(new IrisAbortedError(\"Aborted by caller\"));\n    }\n    signal?.addEventListener(\"abort\", onAbort);\n  });\n}\n","/**\n * Iris reattest endpoint.\n *\n * POST /v2/reattest/{nonce}\n *\n * Asks Circle to sign an expired or pre-finality message again. Circle only\n * acknowledges the request; the new attestation is then read from\n * `/v2/messages` by nonce.\n */\nimport type { Network } from \"../chains/types.js\";\nimport { irisBaseUrl } from \"./urls.js\";\nimport { fetchIrisJson, type FetchJsonOptions } from \"./fetch.js\";\nimport { IrisHttpError, IrisParseError } from \"../errors.js\";\n\nexport type ReattestOptions = FetchJsonOptions & {\n  network: Network;\n};\n\n/** Returns Circle's acknowledgement, or `null` when Iris has no such nonce. */\nexport async function reattest(\n  nonce: string,\n  options: ReattestOptions,\n): Promise<{ nonce: string } | null> {\n  const { network, ...fetchOpts } = options;\n  const url = `${irisBaseUrl(network)}/v2/reattest/${nonce}`;\n  let json: unknown;\n  try {\n    json = await fetchIrisJson<unknown>(url, fetchOpts, {\n      method: \"POST\",\n      body: {},\n    });\n  } catch (err) {\n    if (err instanceof IrisHttpError && err.status === 404) return null;\n    throw err;\n  }\n  const acknowledged =\n    typeof json === \"object\" && json !== null && \"nonce\" in json\n      ? json.nonce\n      : undefined;\n  if (typeof acknowledged !== \"string\") {\n    throw new IrisParseError(\"Iris reattest reply has no nonce\");\n  }\n  return { nonce: acknowledged };\n}\n","import type { Address, CctpDomain, Network } from \"../chains/types.js\";\nimport { IrisParseError } from \"../errors.js\";\nimport { fetchIrisJson, type FetchJsonOptions } from \"./fetch.js\";\nimport { irisBaseUrl } from \"./urls.js\";\n\nexport type UpfrontFeeType = \"FORWARD\" | \"PRE_FINALITY\";\n\nexport type SignedBurnQuoteRequest = {\n  /** The burn amount in USDC subunits. The quote is bound to it. */\n  amount: bigint;\n  /** The source chain's USDC: Whisk pays fees in USDC, never native gas. */\n  feeToken: Address;\n  requests: readonly UpfrontFeeType[];\n};\n\nexport type SignedQuoteExpiry =\n  | { mode: \"TIMESTAMP\"; expiresAt: number }\n  | { mode: \"BLOCK_NUMBER\"; expiresAtBlock: bigint };\n\nexport type SignedBurnQuote = {\n  /** Submitted as-is to `TokenMessengerWithFees`. */\n  signedQuote: `0x${string}`;\n  /** Circle's clock, in Unix seconds. */\n  issuedAt: number;\n  expiry: SignedQuoteExpiry;\n  feeTotalAmount: bigint;\n  feeToken: Address;\n  /**\n   * Absent from Circle's schema but present in its replies. When it is\n   * missing, the contract alone holds the quote to the amount.\n   */\n  burnAmount?: bigint;\n  items: { type: UpfrontFeeType; amount: bigint }[];\n};\n\n/**\n * `POST /v2/quote/burn/usdc/{source}/{destination}`: Circle's signed price\n * for paying the Fast and forwarding fees on the source chain. No API key.\n */\nexport async function getSignedBurnQuote(\n  network: Network,\n  sourceDomain: CctpDomain,\n  destinationDomain: CctpDomain,\n  request: SignedBurnQuoteRequest,\n  options: FetchJsonOptions = {},\n): Promise<SignedBurnQuote> {\n  const url = `${irisBaseUrl(network)}/v2/quote/burn/usdc/${sourceDomain}/${destinationDomain}`;\n  const raw = await fetchIrisJson<unknown>(url, options, {\n    method: \"POST\",\n    body: {\n      amount: request.amount.toString(),\n      feeToken: request.feeToken,\n      requests: request.requests.map((type) => ({ type })),\n    },\n  });\n  const quote = parseQuote(raw);\n  if (quote.burnAmount !== undefined && quote.burnAmount !== request.amount) {\n    throw new IrisParseError(\n      `Iris quoted ${quote.burnAmount} subunits, not the ${request.amount} requested`,\n    );\n  }\n  if (quote.feeToken.toLowerCase() !== request.feeToken.toLowerCase()) {\n    throw new IrisParseError(\n      `Iris priced the fee in ${quote.feeToken}, not ${request.feeToken}`,\n    );\n  }\n  const types = quote.items.map((i) => i.type).sort();\n  if (types.join() !== [...request.requests].sort().join()) {\n    throw new IrisParseError(\n      `Iris priced ${types.join(\", \")}, not ${request.requests.join(\", \")}`,\n    );\n  }\n  return quote;\n}\n\nfunction parseQuote(raw: unknown): SignedBurnQuote {\n  const fail = (what: string): never => {\n    throw new IrisParseError(`Iris quote: ${what}`);\n  };\n  if (typeof raw !== \"object\" || raw === null) return fail(\"not an object\");\n  const r = raw as Record<string, unknown>;\n\n  const signedQuote = r.signedQuote;\n  if (\n    typeof signedQuote !== \"string\" ||\n    !/^0x([0-9a-fA-F]{2})+$/.test(signedQuote)\n  ) {\n    return fail(\"signedQuote is not hex bytes\");\n  }\n  if (!Number.isSafeInteger(r.issuedAt))\n    return fail(\"issuedAt is not a timestamp\");\n  const feeToken = r.feeToken;\n  if (typeof feeToken !== \"string\" || !/^0x[0-9a-fA-F]{40}$/.test(feeToken)) {\n    return fail(\"feeToken is not an address\");\n  }\n  const feeTotalAmount = subunits(r.feeTotalAmount) ?? fail(\"feeTotalAmount\");\n  const burnAmount =\n    r.burnAmount === undefined\n      ? undefined\n      : (subunits(r.burnAmount) ?? fail(\"burnAmount\"));\n\n  if (!Array.isArray(r.items) || r.items.length === 0) return fail(\"no items\");\n  const items = r.items.map(\n    (item: unknown): SignedBurnQuote[\"items\"][number] => {\n      const i = (item ?? {}) as Record<string, unknown>;\n      if (i.type !== \"FORWARD\" && i.type !== \"PRE_FINALITY\") {\n        return fail(`unknown item type ${String(i.type)}`);\n      }\n      return {\n        type: i.type,\n        amount: subunits(i.amount) ?? fail(\"item amount\"),\n      };\n    },\n  );\n  if (items.reduce((sum, i) => sum + i.amount, 0n) !== feeTotalAmount) {\n    return fail(\"items do not add up to feeTotalAmount\");\n  }\n\n  return {\n    signedQuote: signedQuote as `0x${string}`,\n    issuedAt: r.issuedAt as number,\n    expiry: parseExpiry(r.expiry) ?? fail(\"expiry\"),\n    feeTotalAmount,\n    feeToken: feeToken as Address,\n    ...(burnAmount !== undefined && { burnAmount }),\n    items,\n  };\n}\n\nfunction parseExpiry(raw: unknown): SignedQuoteExpiry | undefined {\n  if (typeof raw !== \"object\" || raw === null) return undefined;\n  const e = raw as Record<string, unknown>;\n  if (e.mode === \"TIMESTAMP\" && Number.isSafeInteger(e.expiresAt)) {\n    return { mode: \"TIMESTAMP\", expiresAt: e.expiresAt as number };\n  }\n  if (e.mode === \"BLOCK_NUMBER\" && Number.isSafeInteger(e.expiresAtBlock)) {\n    return {\n      mode: \"BLOCK_NUMBER\",\n      expiresAtBlock: BigInt(e.expiresAtBlock as number),\n    };\n  }\n  return undefined;\n}\n\nfunction subunits(raw: unknown): bigint | undefined {\n  return typeof raw === \"string\" && /^(0|[1-9]\\d*)$/.test(raw)\n    ? BigInt(raw)\n    : undefined;\n}\n\n/**\n * Circle's remaining Fast Transfer allowance, in USDC subunits rounded down.\n * Iris sends it as a JSON number of whole USDC.\n */\nexport async function getFastBurnAllowance(\n  network: Network,\n  options: FetchJsonOptions = {},\n): Promise<bigint> {\n  const raw = await fetchIrisJson<unknown>(\n    `${irisBaseUrl(network)}/v2/fastBurn/USDC/allowance`,\n    options,\n  );\n  const value =\n    typeof raw === \"object\" && raw !== null && \"allowance\" in raw\n      ? raw.allowance\n      : undefined;\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) {\n    throw new IrisParseError(\"Iris allowance is not a non-negative number\");\n  }\n  // The shortest decimal form of a double reads back as the same double,\n  // so this is the text Iris sent for any allowance below 2^53.\n  const match = /^(\\d+)(?:\\.(\\d+))?$/.exec(String(value));\n  if (!match)\n    throw new IrisParseError(`Iris allowance ${value} is not decimal`);\n  const frac = (match[2] ?? \"\").padEnd(6, \"0\").slice(0, 6);\n  return BigInt(match[1]!) * 1_000_000n + BigInt(frac);\n}\n"]}

package/dist/iris.d.cts

@@ -0,0 +1,205 @@
+import { N as Network, e as CctpDomain, B as BurnFeeTier, T as TransferSpeed, F as ForwarderFeeTier, m as IrisMessage, G as GetMessagesQuery, o as SecondsRange, A as Address } from './attestation-D52iUV0y.cjs';
+export { i as FINALITY_FAST, j as FINALITY_STANDARD, b as FinalityThreshold, k as ForwardState, I as IrisAttestationStatus, l as IrisDelayReason, n as IrisMessagesResponse } from './attestation-D52iUV0y.cjs';
+
+declare const IRIS_MAINNET_URL = "https://iris-api.circle.com";
+declare const IRIS_SANDBOX_URL = "https://iris-api-sandbox.circle.com";
+declare function irisBaseUrl(network: Network): string;
+
+type IrisLimiterOptions = {
+    /** Circle's limit is 35 a second; staying under it leaves room for others. */
+    ratePerSecond?: number;
+    /** Circle blocks the IP for five minutes after a 429. */
+    standDownMs?: number;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+};
+type IrisLimiter = {
+    /** Waits for a request slot, or throws while the host is standing down. */
+    acquire(host: string): Promise<void>;
+    /** Records a 429 and returns when requests may resume. */
+    standDown(host: string): number;
+    now(): number;
+    sleep(ms: number): Promise<void>;
+};
+declare function createIrisLimiter(options?: IrisLimiterOptions): IrisLimiter;
+/** Shared by every Iris call in the process, as Circle's limit is per IP. */
+declare const defaultIrisLimiter: IrisLimiter;
+
+/**
+ * Iris fetch wrapper with timeout, retry, and `AbortSignal`.
+ *
+ * Error mapping:
+ *   - 4xx (except 429)        → IrisHttpError (no retry)
+ *   - 429                     → IrisRateLimitedError (no retry)
+ *   - 5xx                     → retry, then IrisHttpError
+ *   - Network failure         → retry, then IrisNetworkError
+ *   - Caller-signaled abort   → IrisAbortedError
+ *   - Per-request timeout     → retry, then IrisNetworkError
+ *   - JSON parse failure      → IrisParseError (no retry)
+ */
+
+type FetchJsonOptions = {
+    /** Per-request timeout in ms. Default 5000. */
+    timeoutMs?: number;
+    /** Retries after the first attempt. Default 3. */
+    maxRetries?: number;
+    /** Base delay between retries in ms. Backoff multiplies by retry index. */
+    baseDelayMs?: number;
+    signal?: AbortSignal;
+    /** Defaults to the global `fetch`. */
+    fetch?: typeof fetch;
+    /** Defaults to one limiter shared by every Iris call in the process. */
+    limiter?: IrisLimiter;
+};
+declare function fetchIrisJson<T>(url: string, options?: FetchJsonOptions, request?: {
+    method: "POST";
+    body: unknown;
+} | {
+    method: "GET";
+}): Promise<T>;
+
+/**
+ * Iris burn fees endpoint.
+ *
+ * GET /v2/burn/USDC/fees/{src}/{dst}?forward=true
+ *
+ * Returns one row per finality threshold (1000 = Fast, 2000 = Standard).
+ * Each row has the protocol fee in basis points and, with ?forward=true,
+ * the forwarder fee levels low/med/high in USDC subunits.
+ */
+
+type GetBurnFeesOptions = FetchJsonOptions & {
+    /** Default `true`. Set to `false` if you only need protocol fees. */
+    includeForwarderFee?: boolean;
+};
+/**
+ * Rows for thresholds other than Fast and Standard are dropped. Use
+ * `pickFeeTier` to choose one.
+ */
+declare function getBurnFees(network: Network, sourceDomain: CctpDomain, destinationDomain: CctpDomain, options?: GetBurnFeesOptions): Promise<BurnFeeTier[]>;
+/** The row for `speed`. Throws if Iris returned none for this route. */
+declare function pickFeeTier(tiers: readonly BurnFeeTier[], speed: TransferSpeed): BurnFeeTier;
+/** The forwarder fee for a level, in USDC subunits. */
+declare function pickForwarderFee(tier: BurnFeeTier, level?: keyof ForwarderFeeTier): bigint;
+
+/**
+ * Iris messages endpoint.
+ *
+ * GET /v2/messages/{srcDomain}?transactionHash=...
+ * GET /v2/messages/{srcDomain}?nonce=...
+ *
+ * Returns the message + attestation + forwarder state in a single
+ * call. Use this to drive recovery polling.
+ */
+
+type GetMessagesOptions = FetchJsonOptions & {
+    network: Network;
+    /** Defaults to Circle's Iris host for `network`. */
+    baseUrl?: string;
+};
+/**
+ * Single fetch. Returns an empty array when Iris doesn't yet know about
+ * the burn, whether it answers `messages: []` or 404.
+ */
+declare function getMessages(query: GetMessagesQuery, options: GetMessagesOptions): Promise<IrisMessage[]>;
+type PollMessageOptions = GetMessagesOptions & {
+    /** Polling interval in ms. Default 3000, or from {@link pollBudget}. */
+    intervalMs?: number;
+    /** Total timeout in ms. Default 15 minutes, or from {@link pollBudget}. */
+    timeoutMs?: number;
+    /**
+     * Custom predicate to decide when polling is "done". Default: a forwarded
+     * message once Circle's relayer is done or has failed, otherwise once the
+     * attestation is complete.
+     */
+    isDone?: (message: IrisMessage) => boolean;
+    /**
+     * Called when a 429 makes the poll stand down, with the time it resumes.
+     * The wait does not count against `timeoutMs`.
+     */
+    onRateLimited?: (retryAt: number) => void;
+};
+/**
+ * How often and how long to poll for a route whose attestation takes
+ * `eta` seconds. Fast routes poll often so the payer hears at once; hour-long
+ * ones poll gently so they do not eat the shared rate limit.
+ */
+declare function pollBudget(eta: SecondsRange): {
+    intervalMs: number;
+    timeoutMs: number;
+};
+/**
+ * Circle's relayer has minted once it reports the mint `CONFIRMED` or
+ * `COMPLETE` with its tx hash. `PENDING` can carry a hash that is not mined.
+ */
+declare function isForwardDone(message: IrisMessage): boolean;
+/**
+ * Returns the message once `isDone` holds, or on timeout the latest one
+ * seen (`null` if none). Throws if Iris keeps failing; a slow attestation
+ * only times out.
+ */
+declare function pollMessages(query: GetMessagesQuery, options: PollMessageOptions): Promise<IrisMessage | null>;
+
+/**
+ * Iris reattest endpoint.
+ *
+ * POST /v2/reattest/{nonce}
+ *
+ * Asks Circle to sign an expired or pre-finality message again. Circle only
+ * acknowledges the request; the new attestation is then read from
+ * `/v2/messages` by nonce.
+ */
+
+type ReattestOptions = FetchJsonOptions & {
+    network: Network;
+};
+/** Returns Circle's acknowledgement, or `null` when Iris has no such nonce. */
+declare function reattest(nonce: string, options: ReattestOptions): Promise<{
+    nonce: string;
+} | null>;
+
+type UpfrontFeeType = "FORWARD" | "PRE_FINALITY";
+type SignedBurnQuoteRequest = {
+    /** The burn amount in USDC subunits. The quote is bound to it. */
+    amount: bigint;
+    /** The source chain's USDC: Whisk pays fees in USDC, never native gas. */
+    feeToken: Address;
+    requests: readonly UpfrontFeeType[];
+};
+type SignedQuoteExpiry = {
+    mode: "TIMESTAMP";
+    expiresAt: number;
+} | {
+    mode: "BLOCK_NUMBER";
+    expiresAtBlock: bigint;
+};
+type SignedBurnQuote = {
+    /** Submitted as-is to `TokenMessengerWithFees`. */
+    signedQuote: `0x${string}`;
+    /** Circle's clock, in Unix seconds. */
+    issuedAt: number;
+    expiry: SignedQuoteExpiry;
+    feeTotalAmount: bigint;
+    feeToken: Address;
+    /**
+     * Absent from Circle's schema but present in its replies. When it is
+     * missing, the contract alone holds the quote to the amount.
+     */
+    burnAmount?: bigint;
+    items: {
+        type: UpfrontFeeType;
+        amount: bigint;
+    }[];
+};
+/**
+ * `POST /v2/quote/burn/usdc/{source}/{destination}`: Circle's signed price
+ * for paying the Fast and forwarding fees on the source chain. No API key.
+ */
+declare function getSignedBurnQuote(network: Network, sourceDomain: CctpDomain, destinationDomain: CctpDomain, request: SignedBurnQuoteRequest, options?: FetchJsonOptions): Promise<SignedBurnQuote>;
+/**
+ * Circle's remaining Fast Transfer allowance, in USDC subunits rounded down.
+ * Iris sends it as a JSON number of whole USDC.
+ */
+declare function getFastBurnAllowance(network: Network, options?: FetchJsonOptions): Promise<bigint>;
+
+export { BurnFeeTier, type FetchJsonOptions, ForwarderFeeTier, type GetBurnFeesOptions, type GetMessagesOptions, GetMessagesQuery, IRIS_MAINNET_URL, IRIS_SANDBOX_URL, type IrisLimiter, type IrisLimiterOptions, IrisMessage, type PollMessageOptions, type ReattestOptions, type SignedBurnQuote, type SignedBurnQuoteRequest, type SignedQuoteExpiry, TransferSpeed, type UpfrontFeeType, createIrisLimiter, defaultIrisLimiter, fetchIrisJson, getBurnFees, getFastBurnAllowance, getMessages, getSignedBurnQuote, irisBaseUrl, isForwardDone, pickFeeTier, pickForwarderFee, pollBudget, pollMessages, reattest };

package/dist/iris.d.ts

@@ -0,0 +1,205 @@
+import { N as Network, e as CctpDomain, B as BurnFeeTier, T as TransferSpeed, F as ForwarderFeeTier, m as IrisMessage, G as GetMessagesQuery, o as SecondsRange, A as Address } from './attestation-D52iUV0y.js';
+export { i as FINALITY_FAST, j as FINALITY_STANDARD, b as FinalityThreshold, k as ForwardState, I as IrisAttestationStatus, l as IrisDelayReason, n as IrisMessagesResponse } from './attestation-D52iUV0y.js';
+
+declare const IRIS_MAINNET_URL = "https://iris-api.circle.com";
+declare const IRIS_SANDBOX_URL = "https://iris-api-sandbox.circle.com";
+declare function irisBaseUrl(network: Network): string;
+
+type IrisLimiterOptions = {
+    /** Circle's limit is 35 a second; staying under it leaves room for others. */
+    ratePerSecond?: number;
+    /** Circle blocks the IP for five minutes after a 429. */
+    standDownMs?: number;
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+};
+type IrisLimiter = {
+    /** Waits for a request slot, or throws while the host is standing down. */
+    acquire(host: string): Promise<void>;
+    /** Records a 429 and returns when requests may resume. */
+    standDown(host: string): number;
+    now(): number;
+    sleep(ms: number): Promise<void>;
+};
+declare function createIrisLimiter(options?: IrisLimiterOptions): IrisLimiter;
+/** Shared by every Iris call in the process, as Circle's limit is per IP. */
+declare const defaultIrisLimiter: IrisLimiter;
+
+/**
+ * Iris fetch wrapper with timeout, retry, and `AbortSignal`.
+ *
+ * Error mapping:
+ *   - 4xx (except 429)        → IrisHttpError (no retry)
+ *   - 429                     → IrisRateLimitedError (no retry)
+ *   - 5xx                     → retry, then IrisHttpError
+ *   - Network failure         → retry, then IrisNetworkError
+ *   - Caller-signaled abort   → IrisAbortedError
+ *   - Per-request timeout     → retry, then IrisNetworkError
+ *   - JSON parse failure      → IrisParseError (no retry)
+ */
+
+type FetchJsonOptions = {
+    /** Per-request timeout in ms. Default 5000. */
+    timeoutMs?: number;
+    /** Retries after the first attempt. Default 3. */
+    maxRetries?: number;
+    /** Base delay between retries in ms. Backoff multiplies by retry index. */
+    baseDelayMs?: number;
+    signal?: AbortSignal;
+    /** Defaults to the global `fetch`. */
+    fetch?: typeof fetch;
+    /** Defaults to one limiter shared by every Iris call in the process. */
+    limiter?: IrisLimiter;
+};
+declare function fetchIrisJson<T>(url: string, options?: FetchJsonOptions, request?: {
+    method: "POST";
+    body: unknown;
+} | {
+    method: "GET";
+}): Promise<T>;
+
+/**
+ * Iris burn fees endpoint.
+ *
+ * GET /v2/burn/USDC/fees/{src}/{dst}?forward=true
+ *
+ * Returns one row per finality threshold (1000 = Fast, 2000 = Standard).
+ * Each row has the protocol fee in basis points and, with ?forward=true,
+ * the forwarder fee levels low/med/high in USDC subunits.
+ */
+
+type GetBurnFeesOptions = FetchJsonOptions & {
+    /** Default `true`. Set to `false` if you only need protocol fees. */
+    includeForwarderFee?: boolean;
+};
+/**
+ * Rows for thresholds other than Fast and Standard are dropped. Use
+ * `pickFeeTier` to choose one.
+ */
+declare function getBurnFees(network: Network, sourceDomain: CctpDomain, destinationDomain: CctpDomain, options?: GetBurnFeesOptions): Promise<BurnFeeTier[]>;
+/** The row for `speed`. Throws if Iris returned none for this route. */
+declare function pickFeeTier(tiers: readonly BurnFeeTier[], speed: TransferSpeed): BurnFeeTier;
+/** The forwarder fee for a level, in USDC subunits. */
+declare function pickForwarderFee(tier: BurnFeeTier, level?: keyof ForwarderFeeTier): bigint;
+
+/**
+ * Iris messages endpoint.
+ *
+ * GET /v2/messages/{srcDomain}?transactionHash=...
+ * GET /v2/messages/{srcDomain}?nonce=...
+ *
+ * Returns the message + attestation + forwarder state in a single
+ * call. Use this to drive recovery polling.
+ */
+
+type GetMessagesOptions = FetchJsonOptions & {
+    network: Network;
+    /** Defaults to Circle's Iris host for `network`. */
+    baseUrl?: string;
+};
+/**
+ * Single fetch. Returns an empty array when Iris doesn't yet know about
+ * the burn, whether it answers `messages: []` or 404.
+ */
+declare function getMessages(query: GetMessagesQuery, options: GetMessagesOptions): Promise<IrisMessage[]>;
+type PollMessageOptions = GetMessagesOptions & {
+    /** Polling interval in ms. Default 3000, or from {@link pollBudget}. */
+    intervalMs?: number;
+    /** Total timeout in ms. Default 15 minutes, or from {@link pollBudget}. */
+    timeoutMs?: number;
+    /**
+     * Custom predicate to decide when polling is "done". Default: a forwarded
+     * message once Circle's relayer is done or has failed, otherwise once the
+     * attestation is complete.
+     */
+    isDone?: (message: IrisMessage) => boolean;
+    /**
+     * Called when a 429 makes the poll stand down, with the time it resumes.
+     * The wait does not count against `timeoutMs`.
+     */
+    onRateLimited?: (retryAt: number) => void;
+};
+/**
+ * How often and how long to poll for a route whose attestation takes
+ * `eta` seconds. Fast routes poll often so the payer hears at once; hour-long
+ * ones poll gently so they do not eat the shared rate limit.
+ */
+declare function pollBudget(eta: SecondsRange): {
+    intervalMs: number;
+    timeoutMs: number;
+};
+/**
+ * Circle's relayer has minted once it reports the mint `CONFIRMED` or
+ * `COMPLETE` with its tx hash. `PENDING` can carry a hash that is not mined.
+ */
+declare function isForwardDone(message: IrisMessage): boolean;
+/**
+ * Returns the message once `isDone` holds, or on timeout the latest one
+ * seen (`null` if none). Throws if Iris keeps failing; a slow attestation
+ * only times out.
+ */
+declare function pollMessages(query: GetMessagesQuery, options: PollMessageOptions): Promise<IrisMessage | null>;
+
+/**
+ * Iris reattest endpoint.
+ *
+ * POST /v2/reattest/{nonce}
+ *
+ * Asks Circle to sign an expired or pre-finality message again. Circle only
+ * acknowledges the request; the new attestation is then read from
+ * `/v2/messages` by nonce.
+ */
+
+type ReattestOptions = FetchJsonOptions & {
+    network: Network;
+};
+/** Returns Circle's acknowledgement, or `null` when Iris has no such nonce. */
+declare function reattest(nonce: string, options: ReattestOptions): Promise<{
+    nonce: string;
+} | null>;
+
+type UpfrontFeeType = "FORWARD" | "PRE_FINALITY";
+type SignedBurnQuoteRequest = {
+    /** The burn amount in USDC subunits. The quote is bound to it. */
+    amount: bigint;
+    /** The source chain's USDC: Whisk pays fees in USDC, never native gas. */
+    feeToken: Address;
+    requests: readonly UpfrontFeeType[];
+};
+type SignedQuoteExpiry = {
+    mode: "TIMESTAMP";
+    expiresAt: number;
+} | {
+    mode: "BLOCK_NUMBER";
+    expiresAtBlock: bigint;
+};
+type SignedBurnQuote = {
+    /** Submitted as-is to `TokenMessengerWithFees`. */
+    signedQuote: `0x${string}`;
+    /** Circle's clock, in Unix seconds. */
+    issuedAt: number;
+    expiry: SignedQuoteExpiry;
+    feeTotalAmount: bigint;
+    feeToken: Address;
+    /**
+     * Absent from Circle's schema but present in its replies. When it is
+     * missing, the contract alone holds the quote to the amount.
+     */
+    burnAmount?: bigint;
+    items: {
+        type: UpfrontFeeType;
+        amount: bigint;
+    }[];
+};
+/**
+ * `POST /v2/quote/burn/usdc/{source}/{destination}`: Circle's signed price
+ * for paying the Fast and forwarding fees on the source chain. No API key.
+ */
+declare function getSignedBurnQuote(network: Network, sourceDomain: CctpDomain, destinationDomain: CctpDomain, request: SignedBurnQuoteRequest, options?: FetchJsonOptions): Promise<SignedBurnQuote>;
+/**
+ * Circle's remaining Fast Transfer allowance, in USDC subunits rounded down.
+ * Iris sends it as a JSON number of whole USDC.
+ */
+declare function getFastBurnAllowance(network: Network, options?: FetchJsonOptions): Promise<bigint>;
+
+export { BurnFeeTier, type FetchJsonOptions, ForwarderFeeTier, type GetBurnFeesOptions, type GetMessagesOptions, GetMessagesQuery, IRIS_MAINNET_URL, IRIS_SANDBOX_URL, type IrisLimiter, type IrisLimiterOptions, IrisMessage, type PollMessageOptions, type ReattestOptions, type SignedBurnQuote, type SignedBurnQuoteRequest, type SignedQuoteExpiry, TransferSpeed, type UpfrontFeeType, createIrisLimiter, defaultIrisLimiter, fetchIrisJson, getBurnFees, getFastBurnAllowance, getMessages, getSignedBurnQuote, irisBaseUrl, isForwardDone, pickFeeTier, pickForwarderFee, pollBudget, pollMessages, reattest };