@tabai/sdk 0.2.3 → 0.2.5

package/dist/x402/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/x402/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/x402/client.ts"],"names":[],"mappings":"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"}

package/dist/x402/client.js

@@ -13,7 +13,7 @@
  *
  * ## The signing is hand-rolled, and here is the check on it
  *
- * `@x402/evm` is the reference client for this scheme and it is built on viem.
+ * `@x402/evm` is the official client for this scheme and it is built on viem.
  * This package signs with ethers, so pulling it in would ship a second EVM
  * library to sign one struct. The struct is small enough to state:
  *
@@ -23,11 +23,10 @@
  * - primary type `TransferWithAuthorization(address from, address to, uint256
  *   value, uint256 validAfter, uint256 validBefore, bytes32 nonce)` (EIP-3009);
  * - `validAfter` `0`, `validBefore` now plus `maxTimeoutSeconds`, and a random
- *   32-byte `nonce`, exactly as the reference `createEIP3009Payload` builds them.
+ *   32-byte `nonce`, exactly as `@x402/evm`'s `createEIP3009Payload` builds them.
  *
- * The test suite recovers the signer from every signature this file produces,
- * and the reference client was run over the same authorization while this was
- * written: the two signatures are byte for byte the same.
+ * The test suite recovers the signer from every signature this file produces
+ * against that domain and struct, so a drift from the scheme fails a test.
  *
  * Specification: scheme_exact_evm.md section 1, x402-specification-v2.md section 5.2.
  */
@@ -74,7 +73,7 @@ export const TRANSFER_WITH_AUTHORIZATION_TYPES = {
 /**
  * Signs one `exact` requirement.
  *
- * The domain and the struct are exactly what the reference client signs, so
+ * The domain and the struct are exactly what `@x402/evm` signs, so
  * the facilitator's recovery lands on `authorization.from`. The requirement is
  * re-validated here rather than trusted, because it arrived over the network.
  */
@@ -134,7 +133,7 @@ export async function signExactPayment(options) {
         resource: options.required.resource,
         accepted,
         payload: { signature: signature.value, authorization },
-        // Echoed unchanged, as the reference client does: the server advertised
+        // Echoed unchanged, as `@x402/evm` does: the server advertised
         // them and validates that what comes back carries at least what it sent.
         ...(options.required.extensions === undefined ? {} : { extensions: options.required.extensions }),
     };

package/dist/x402/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/x402/client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The x402 client: sign an EIP-3009 authorization for an `exact` requirement\n * and repeat the request with it.\n *\n * ## Where this sits in Tab\n *\n * Tab never asks an Agent to prepay. This client exists for the two moments a\n * prepayment is the right answer anyway: an Agent with no headroom that would\n * rather pay for one call than settle a tab first, and a Service fronting an\n * x402 upstream that has to pay the upstream before it can meter the Agent.\n * In both, the payment is one call's worth, signed by whoever holds the key,\n * and nothing about the Open Tab changes.\n *\n * ## The signing is hand-rolled, and here is the check on it\n *\n * `@x402/evm` is the reference client for this scheme and it is built on viem.\n * This package signs with ethers, so pulling it in would ship a second EVM\n * library to sign one struct. The struct is small enough to state:\n *\n * - EIP-712 domain `{ name, version, chainId, verifyingContract }`, with `name`\n *   and `version` from `requirements.extra`, `chainId` from the CAIP-2 network,\n *   and `verifyingContract` the token (`scheme_exact_evm.md`, section 1);\n * - primary type `TransferWithAuthorization(address from, address to, uint256\n *   value, uint256 validAfter, uint256 validBefore, bytes32 nonce)` (EIP-3009);\n * - `validAfter` `0`, `validBefore` now plus `maxTimeoutSeconds`, and a random\n *   32-byte `nonce`, exactly as the reference `createEIP3009Payload` builds them.\n *\n * The test suite recovers the signer from every signature this file produces,\n * and the reference client was run over the same authorization while this was\n * written: the two signatures are byte for byte the same.\n *\n * Specification: scheme_exact_evm.md section 1, x402-specification-v2.md section 5.2.\n */\n\nimport { getAddress, hexlify, randomBytes, type Signer } from \"ethers\";\nimport { causeOf, ok, wrap, type Address, type Hex, type Result } from \"../_shared/index.js\";\n\nimport { fail, upstreamError, validationError } from \"../errors.js\";\nimport { headerReaderOf, type HeaderReader, type HeaderRecord } from \"../http/headers.js\";\nimport { defaultLogger, type Logger } from \"../logger.js\";\nimport {\n  X402_HEADER,\n  X402_VERSION,\n  chainIdOfNetwork,\n  encodePaymentSignature,\n  readPaymentRequired,\n  readPaymentResponse,\n  selectExactRequirement,\n  type PaymentPayload,\n  type PaymentRequired,\n  type PaymentRequirements,\n  type RequirementFilter,\n  type SettleResponse,\n} from \"./wire.js\";\n\n/**\n * What signs an x402 payment.\n *\n * Structural rather than the `ethers` class, so a test double or any wallet\n * that can sign typed data satisfies it. An `ethers.Signer` does as it stands;\n * the assertion below fails to compile if that ever stops being true.\n */\nexport interface X402Signer {\n  getAddress(): Promise<string>;\n  signTypedData(\n    domain: { name: string; version: string; chainId: bigint | number; verifyingContract: string },\n    types: Record<string, readonly { name: string; type: string }[]>,\n    value: Record<string, unknown>,\n  ): Promise<string>;\n}\n\ntype Assert<T extends true> = T;\ntype SignerIsAccepted = Assert<Signer extends X402Signer ? true : false>;\nexport type X402SignerAcceptsEthersSigner = SignerIsAccepted;\n\n/**\n * A signer built only when a payment is about to be signed.\n *\n * Returning `undefined` means \"not available here\", the same answer a payment\n * strategy factory may give: the offer is declined and the `402` stands as the\n * credit decision it was. That is what keeps every read keyless: a config file\n * declares the factory, and nothing calls it until a prepayment is the answer.\n */\nexport type X402SignerFactory = () => X402Signer | undefined | Promise<X402Signer | undefined>;\n\n/** A signer, or a factory that may produce one. */\nexport type X402SignerSource = X402Signer | X402SignerFactory;\n\n/** Resolves a source. `ok(undefined)` is a factory declining; `err` is a factory that threw. */\nexport async function resolveX402Signer(source: X402SignerSource | undefined): Promise<Result<X402Signer | undefined>> {\n  if (source === undefined) return ok(undefined);\n  if (typeof source !== \"function\") return ok(source);\n  const produced = await wrap(\n    async () => (await source()) as unknown,\n    (error) => ({\n      category: \"UPSTREAM\" as const,\n      code: \"X402_SIGNER_FACTORY_FAILED\",\n      message: \"the x402 signer factory threw\",\n      retryable: false,\n      cause: causeOf(error),\n    }),\n  );\n  if (!produced.ok) return produced;\n  if (produced.value === undefined || produced.value === null) return ok(undefined);\n  const candidate = produced.value as Partial<X402Signer>;\n  if (typeof candidate.getAddress !== \"function\" || typeof candidate.signTypedData !== \"function\") {\n    return validationError(\"X402_SIGNER_INVALID\", \"the x402 signer factory returned something without getAddress() and signTypedData()\");\n  }\n  return ok(candidate as X402Signer);\n}\n\n/** The EIP-712 type of the struct EIP-3009 `transferWithAuthorization` verifies. */\nexport const TRANSFER_WITH_AUTHORIZATION_TYPES = {\n  TransferWithAuthorization: [\n    { name: \"from\", type: \"address\" },\n    { name: \"to\", type: \"address\" },\n    { name: \"value\", type: \"uint256\" },\n    { name: \"validAfter\", type: \"uint256\" },\n    { name: \"validBefore\", type: \"uint256\" },\n    { name: \"nonce\", type: \"bytes32\" },\n  ],\n} as const;\n\n/** The authorization as it goes on the wire: every number a decimal string. */\nexport interface Eip3009Authorization {\n  readonly from: string;\n  readonly to: string;\n  readonly value: string;\n  readonly validAfter: string;\n  readonly validBefore: string;\n  readonly nonce: Hex;\n}\n\nexport interface SignExactPaymentOptions {\n  readonly signer: X402Signer;\n  /** The server's `PaymentRequired`, echoed into the payload as `resource` and `extensions`. */\n  readonly required: PaymentRequired;\n  /** The entry of `required.accepts` being paid. */\n  readonly accepted: PaymentRequirements;\n  /** Seconds since the epoch. Defaults to the wall clock. */\n  readonly now?: () => number;\n  /** A 32-byte nonce. Defaults to random. A test passes a fixed one. */\n  readonly nonce?: () => Hex;\n}\n\n/** What a signature is for, kept beside the payload so a receipt can be built without re-reading it. */\nexport interface SignedExactPayment {\n  readonly payload: PaymentPayload;\n  readonly authorization: Eip3009Authorization;\n  readonly chainId: bigint;\n  readonly payer: Address;\n}\n\n/**\n * Signs one `exact` requirement.\n *\n * The domain and the struct are exactly what the reference client signs, so\n * the facilitator's recovery lands on `authorization.from`. The requirement is\n * re-validated here rather than trusted, because it arrived over the network.\n */\nexport async function signExactPayment(options: SignExactPaymentOptions): Promise<Result<SignedExactPayment>> {\n  const { accepted } = options;\n  const chainId = chainIdOfNetwork(accepted.network);\n  if (!chainId.ok) return chainId;\n  const name = accepted.extra?.[\"name\"];\n  const version = accepted.extra?.[\"version\"];\n  if (typeof name !== \"string\" || typeof version !== \"string\") {\n    return validationError(\n      \"X402_DOMAIN_MISSING\",\n      `the requirement for ${accepted.asset} carries no EIP-712 domain name and version in extra, so an EIP-3009 authorization cannot be signed for it`,\n      { details: { asset: accepted.asset, network: accepted.network } },\n    );\n  }\n  if (!/^[0-9]+$/.test(accepted.amount)) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", `amount \\`${accepted.amount}\\` is not a decimal integer of atomic units`);\n  }\n\n  const from = await wrap(\n    async () => options.signer.getAddress(),\n    (error) => ({\n      category: \"UPSTREAM\" as const,\n      code: \"X402_SIGNER_UNAVAILABLE\",\n      message: \"the x402 signer could not report its address\",\n      retryable: false,\n      cause: causeOf(error),\n    }),\n  );\n  if (!from.ok) return from;\n\n  const checksummed = wrapAddresses(from.value, accepted.payTo, accepted.asset);\n  if (!checksummed.ok) return checksummed;\n  const [payer, payTo, asset] = checksummed.value;\n\n  const nowSeconds = options.now === undefined ? Math.floor(Date.now() / 1000) : options.now();\n  const authorization: Eip3009Authorization = {\n    from: payer,\n    to: payTo,\n    value: accepted.amount,\n    validAfter: \"0\",\n    validBefore: (nowSeconds + Math.floor(accepted.maxTimeoutSeconds)).toString(10),\n    nonce: options.nonce === undefined ? (hexlify(randomBytes(32)) as Hex) : options.nonce(),\n  };\n\n  const signature = await wrap(\n    async () =>\n      options.signer.signTypedData(\n        { name, version, chainId: chainId.value, verifyingContract: asset },\n        TRANSFER_WITH_AUTHORIZATION_TYPES,\n        {\n          from: authorization.from,\n          to: authorization.to,\n          value: BigInt(authorization.value),\n          validAfter: BigInt(authorization.validAfter),\n          validBefore: BigInt(authorization.validBefore),\n          nonce: authorization.nonce,\n        },\n      ),\n    (error) => ({\n      category: \"UPSTREAM\" as const,\n      code: \"X402_SIGNING_FAILED\",\n      message: \"the x402 signer refused to sign the EIP-3009 authorization\",\n      retryable: false,\n      cause: causeOf(error),\n    }),\n  );\n  if (!signature.ok) return signature;\n\n  const payload: PaymentPayload = {\n    x402Version: X402_VERSION,\n    resource: options.required.resource,\n    accepted,\n    payload: { signature: signature.value, authorization },\n    // Echoed unchanged, as the reference client does: the server advertised\n    // them and validates that what comes back carries at least what it sent.\n    ...(options.required.extensions === undefined ? {} : { extensions: options.required.extensions }),\n  };\n  return ok({ payload, authorization, chainId: chainId.value, payer: payer.toLowerCase() as Address });\n}\n\n/** Checksums the three addresses a payload carries, or names the one that is not an address. */\nfunction wrapAddresses(from: string, payTo: string, asset: string): Result<[string, string, string]> {\n  const checked: string[] = [];\n  for (const [label, value] of [\n    [\"signer address\", from],\n    [\"payTo\", payTo],\n    [\"asset\", asset],\n  ] as const) {\n    try {\n      checked.push(getAddress(value));\n    } catch {\n      return validationError(\"X402_REQUIREMENTS_INVALID\", `${label} \\`${value}\\` is not a 20-byte address`, {\n        details: { field: label, value },\n      });\n    }\n  }\n  return ok(checked as [string, string, string]);\n}\n\n/** One payment this client made, as the facilitator reported it back. */\nexport interface X402PaymentReceipt {\n  /** The settlement transaction hash. Empty when the server reported success without one. */\n  readonly txHash: string;\n  readonly network: string;\n  readonly chainId: bigint;\n  /** Atomic units of `asset`, as the requirement priced it. */\n  readonly amount: bigint;\n  readonly asset: Address;\n  readonly payTo: Address;\n  readonly payer: Address;\n  /** The absolute URL the payment bought. */\n  readonly url: string;\n  readonly requirement: PaymentRequirements;\n  readonly settlement: SettleResponse;\n  readonly observedAt: number;\n}\n\n/** The little of a response this client reads. Structural, as in `client-402.ts`. */\nexport interface X402Response {\n  readonly status: number;\n  readonly headers: HeaderReader | HeaderRecord;\n  readonly body?: unknown;\n  readonly bodyUsed?: unknown;\n}\n\nexport interface X402FetchInit {\n  readonly headers: Readonly<Record<string, string>>;\n  readonly [option: string]: unknown;\n}\n\nexport type X402Fetch<Res extends X402Response> = (url: string, init: X402FetchInit) => Promise<Res>;\n\nexport interface X402ClientOptions<Res extends X402Response = X402Response> extends RequirementFilter {\n  readonly signer: X402Signer;\n  readonly fetchImpl?: X402Fetch<Res>;\n  /**\n   * Consulted after the server's `402` and before anything is signed. A refusal\n   * stops the payment and is returned as the error. This is where a Service\n   * fronting an upstream checks that the Agent it will meter has the headroom\n   * before the Service's own funds move.\n   */\n  readonly authorise?: (requirement: PaymentRequirements, required: PaymentRequired) => Promise<Result<void>> | Result<void>;\n  readonly onPayment?: (receipt: X402PaymentReceipt) => void;\n  readonly logger?: Logger;\n  /** Milliseconds since the epoch, for `observedAt`. Defaults to `Date.now`. */\n  readonly now?: () => number;\n  /** Seconds since the epoch, for `validBefore`. Defaults to the wall clock. */\n  readonly nowSeconds?: () => number;\n  readonly nonce?: () => Hex;\n}\n\n/** What one call did: the response, and the payment that bought it if one did. */\nexport interface X402FetchResult<Res extends X402Response = X402Response> {\n  readonly response: Res;\n  readonly payment?: X402PaymentReceipt;\n}\n\nexport interface X402Client<Res extends X402Response = X402Response> {\n  /**\n   * Sends the request; on a `402` carrying `PAYMENT-REQUIRED`, signs and sends\n   * it once more with `PAYMENT-SIGNATURE`. Exactly once: a second `402` means\n   * the payment was refused, and that is returned as an error naming why.\n   */\n  fetch(url: string, init?: X402FetchInit): Promise<Result<X402FetchResult<Res>>>;\n  /**\n   * Pays a `402` the caller already holds: the same second step, for a caller\n   * that made the first request itself.\n   */\n  pay(url: string, init: X402FetchInit, required: PaymentRequired): Promise<Result<X402FetchResult<Res>>>;\n  /** Every payment made, oldest first. */\n  payments(): readonly X402PaymentReceipt[];\n}\n\n/**\n * Builds the client. Construction is total; every failure belongs to a call.\n */\nexport function createX402Client<Res extends X402Response = X402Response>(\n  options: X402ClientOptions<Res>,\n): X402Client<Res> {\n  const logger = options.logger ?? defaultLogger;\n  const now = options.now ?? (() => Date.now());\n  const history: X402PaymentReceipt[] = [];\n  const filter: RequirementFilter = {\n    ...(options.chainId === undefined ? {} : { chainId: options.chainId }),\n    ...(options.asset === undefined ? {} : { asset: options.asset }),\n    ...(options.maxAmount === undefined ? {} : { maxAmount: options.maxAmount }),\n  };\n\n  const send = async (url: string, init: X402FetchInit, attempt: 1 | 2): Promise<Result<Res>> => {\n    const impl = options.fetchImpl ?? hostFetch<Res>();\n    if (impl === undefined) {\n      return upstreamError(\"FETCH_UNAVAILABLE\", \"this host has no global fetch; supply fetchImpl, or run on Node 20.10 or later\");\n    }\n    const sent = await wrap(\n      async () => impl(url, init),\n      (error) => ({\n        category: \"UPSTREAM\" as const,\n        code: \"FETCH_FAILED\",\n        message: `the request to ${url} did not complete`,\n        retryable: true,\n        details: { url, attempt },\n        cause: causeOf(error),\n      }),\n    );\n    if (!sent.ok) return sent;\n    if (!looksLikeResponse(sent.value)) {\n      return upstreamError(\"FETCH_RESPONSE_INVALID\", `the fetch given to this client returned something that is not a response for ${url}`, {\n        details: { url, attempt },\n      });\n    }\n    return ok(sent.value);\n  };\n\n  const pay = async (url: string, init: X402FetchInit, required: PaymentRequired): Promise<Result<X402FetchResult<Res>>> => {\n    const accepted = selectExactRequirement(required, filter);\n    if (!accepted.ok) return accepted;\n\n    if (options.authorise !== undefined) {\n      const allowed = await wrap(\n        async () => options.authorise?.(accepted.value, required),\n        (error) => ({\n          category: \"INTERNAL\" as const,\n          code: \"X402_AUTHORISE_THREW\",\n          message: \"the authorise hook threw, so nothing was signed\",\n          retryable: false,\n          cause: causeOf(error),\n        }),\n      );\n      if (!allowed.ok) return allowed;\n      if (allowed.value !== undefined && !allowed.value.ok) return allowed.value;\n    }\n\n    if (!isReplayable(init[\"body\"])) {\n      return validationError(\n        \"REQUEST_BODY_NOT_REPLAYABLE\",\n        `${url} asks for payment and the request body is a stream, which cannot be sent a second time; buffer the body before calling`,\n        { details: { url } },\n      );\n    }\n\n    const signed = await signExactPayment({\n      signer: options.signer,\n      required,\n      accepted: accepted.value,\n      ...(options.nowSeconds === undefined ? {} : { now: options.nowSeconds }),\n      ...(options.nonce === undefined ? {} : { nonce: options.nonce }),\n    });\n    if (!signed.ok) return signed;\n\n    const header = encodePaymentSignature(signed.value.payload);\n    if (!header.ok) return header;\n\n    const paid = await send(url, { ...init, headers: { ...init.headers, [X402_HEADER.paymentSignature]: header.value } }, 2);\n    if (!paid.ok) return paid;\n    const response = paid.value;\n\n    const settlement = readPaymentResponse(headerReaderOf(response.headers));\n    if (!settlement.ok) {\n      discard(response, logger);\n      return settlement;\n    }\n\n    if (response.status === 402) {\n      discard(response, logger);\n      const reason = settlement.value?.errorReason ?? readError(response.headers) ?? \"the server did not say why\";\n      return fail(\"LIMIT\", \"X402_PAYMENT_REJECTED\", `${url} refused the signed payment: ${reason}`, {\n        retryable: false,\n        details: {\n          url,\n          reason,\n          amount: accepted.value.amount,\n          asset: accepted.value.asset.toLowerCase(),\n          network: accepted.value.network,\n        },\n      });\n    }\n\n    const receipt: X402PaymentReceipt = {\n      txHash: settlement.value?.transaction ?? \"\",\n      network: accepted.value.network,\n      chainId: signed.value.chainId,\n      amount: BigInt(accepted.value.amount),\n      asset: accepted.value.asset.toLowerCase() as Address,\n      payTo: accepted.value.payTo.toLowerCase() as Address,\n      payer: signed.value.payer,\n      url,\n      requirement: accepted.value,\n      settlement: settlement.value ?? { success: response.status < 400, transaction: \"\", network: accepted.value.network },\n      observedAt: now(),\n    };\n    history.push(receipt);\n    if (options.onPayment !== undefined) {\n      try {\n        options.onPayment(receipt);\n      } catch (error) {\n        logger.warn(\"onPayment threw and the payment was recorded anyway\", { url, error: causeOf(error).message });\n      }\n    }\n    return ok({ response, payment: receipt });\n  };\n\n  return {\n    async fetch(url, init = { headers: {} }) {\n      const first = await send(url, init, 1);\n      if (!first.ok) return first;\n      if (first.value.status !== 402) return ok({ response: first.value });\n\n      const required = readPaymentRequired(headerReaderOf(first.value.headers));\n      discard(first.value, logger);\n      if (!required.ok) return required;\n      if (required.value === undefined) {\n        return fail(\"LIMIT\", \"X402_PAYMENT_REQUIRED_MISSING\", `${url} answered 402 without a ${X402_HEADER.paymentRequired} header, so there is nothing to pay`, {\n          retryable: false,\n          details: { url },\n        });\n      }\n      return pay(url, init, required.value);\n    },\n    pay,\n    payments: () => [...history],\n  };\n}\n\n/** The `error` field of a `PAYMENT-REQUIRED` a refusal may carry, when it carries one. */\nfunction readError(headers: HeaderReader | HeaderRecord): string | undefined {\n  const required = readPaymentRequired(headers);\n  return required.ok ? required.value?.error : undefined;\n}\n\nfunction looksLikeResponse(value: unknown): boolean {\n  if (typeof value !== \"object\" || value === null) return false;\n  const candidate = value as { status?: unknown; headers?: unknown };\n  return typeof candidate.status === \"number\" && typeof candidate.headers === \"object\" && candidate.headers !== null;\n}\n\n/** A stream cannot be sent twice; everything else can. */\nfunction isReplayable(body: unknown): boolean {\n  if (body === undefined || body === null || typeof body !== \"object\") return true;\n  const candidate = body as { getReader?: unknown; [Symbol.asyncIterator]?: unknown };\n  return typeof candidate.getReader !== \"function\" && typeof candidate[Symbol.asyncIterator] !== \"function\";\n}\n\n/** Releases a response that is not going out, so its connection does not wait for the collector. */\nfunction discard(response: X402Response, logger: Logger): void {\n  const body = response.body as { cancel?: unknown } | null | undefined;\n  if (body === null || body === undefined || typeof body.cancel !== \"function\" || response.bodyUsed === true) return;\n  try {\n    const cancelled = (body.cancel as () => unknown)();\n    if (typeof (cancelled as { catch?: unknown })?.catch === \"function\") {\n      (cancelled as Promise<unknown>).catch((error: unknown) => {\n        logger.debug(\"discarded response body could not be cancelled\", causeOf(error));\n      });\n    }\n  } catch (error) {\n    logger.debug(\"discarded response body could not be cancelled\", causeOf(error));\n  }\n}\n\nfunction hostFetch<Res extends X402Response>(): X402Fetch<Res> | undefined {\n  const candidate = (globalThis as { fetch?: unknown }).fetch;\n  return typeof candidate === \"function\" ? (candidate as X402Fetch<Res>) : undefined;\n}\n"]}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/x402/client.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The x402 client: sign an EIP-3009 authorization for an `exact` requirement\n * and repeat the request with it.\n *\n * ## Where this sits in Tab\n *\n * Tab never asks an Agent to prepay. This client exists for the two moments a\n * prepayment is the right answer anyway: an Agent with no headroom that would\n * rather pay for one call than settle a tab first, and a Service fronting an\n * x402 upstream that has to pay the upstream before it can meter the Agent.\n * In both, the payment is one call's worth, signed by whoever holds the key,\n * and nothing about the Open Tab changes.\n *\n * ## The signing is hand-rolled, and here is the check on it\n *\n * `@x402/evm` is the official client for this scheme and it is built on viem.\n * This package signs with ethers, so pulling it in would ship a second EVM\n * library to sign one struct. The struct is small enough to state:\n *\n * - EIP-712 domain `{ name, version, chainId, verifyingContract }`, with `name`\n *   and `version` from `requirements.extra`, `chainId` from the CAIP-2 network,\n *   and `verifyingContract` the token (`scheme_exact_evm.md`, section 1);\n * - primary type `TransferWithAuthorization(address from, address to, uint256\n *   value, uint256 validAfter, uint256 validBefore, bytes32 nonce)` (EIP-3009);\n * - `validAfter` `0`, `validBefore` now plus `maxTimeoutSeconds`, and a random\n *   32-byte `nonce`, exactly as `@x402/evm`'s `createEIP3009Payload` builds them.\n *\n * The test suite recovers the signer from every signature this file produces\n * against that domain and struct, so a drift from the scheme fails a test.\n *\n * Specification: scheme_exact_evm.md section 1, x402-specification-v2.md section 5.2.\n */\n\nimport { getAddress, hexlify, randomBytes, type Signer } from \"ethers\";\nimport { causeOf, ok, wrap, type Address, type Hex, type Result } from \"../_shared/index.js\";\n\nimport { fail, upstreamError, validationError } from \"../errors.js\";\nimport { headerReaderOf, type HeaderReader, type HeaderRecord } from \"../http/headers.js\";\nimport { defaultLogger, type Logger } from \"../logger.js\";\nimport {\n  X402_HEADER,\n  X402_VERSION,\n  chainIdOfNetwork,\n  encodePaymentSignature,\n  readPaymentRequired,\n  readPaymentResponse,\n  selectExactRequirement,\n  type PaymentPayload,\n  type PaymentRequired,\n  type PaymentRequirements,\n  type RequirementFilter,\n  type SettleResponse,\n} from \"./wire.js\";\n\n/**\n * What signs an x402 payment.\n *\n * Structural rather than the `ethers` class, so a test double or any wallet\n * that can sign typed data satisfies it. An `ethers.Signer` does as it stands;\n * the assertion below fails to compile if that ever stops being true.\n */\nexport interface X402Signer {\n  getAddress(): Promise<string>;\n  signTypedData(\n    domain: { name: string; version: string; chainId: bigint | number; verifyingContract: string },\n    types: Record<string, readonly { name: string; type: string }[]>,\n    value: Record<string, unknown>,\n  ): Promise<string>;\n}\n\ntype Assert<T extends true> = T;\ntype SignerIsAccepted = Assert<Signer extends X402Signer ? true : false>;\nexport type X402SignerAcceptsEthersSigner = SignerIsAccepted;\n\n/**\n * A signer built only when a payment is about to be signed.\n *\n * Returning `undefined` means \"not available here\", the same answer a payment\n * strategy factory may give: the offer is declined and the `402` stands as the\n * credit decision it was. That is what keeps every read keyless: a config file\n * declares the factory, and nothing calls it until a prepayment is the answer.\n */\nexport type X402SignerFactory = () => X402Signer | undefined | Promise<X402Signer | undefined>;\n\n/** A signer, or a factory that may produce one. */\nexport type X402SignerSource = X402Signer | X402SignerFactory;\n\n/** Resolves a source. `ok(undefined)` is a factory declining; `err` is a factory that threw. */\nexport async function resolveX402Signer(source: X402SignerSource | undefined): Promise<Result<X402Signer | undefined>> {\n  if (source === undefined) return ok(undefined);\n  if (typeof source !== \"function\") return ok(source);\n  const produced = await wrap(\n    async () => (await source()) as unknown,\n    (error) => ({\n      category: \"UPSTREAM\" as const,\n      code: \"X402_SIGNER_FACTORY_FAILED\",\n      message: \"the x402 signer factory threw\",\n      retryable: false,\n      cause: causeOf(error),\n    }),\n  );\n  if (!produced.ok) return produced;\n  if (produced.value === undefined || produced.value === null) return ok(undefined);\n  const candidate = produced.value as Partial<X402Signer>;\n  if (typeof candidate.getAddress !== \"function\" || typeof candidate.signTypedData !== \"function\") {\n    return validationError(\"X402_SIGNER_INVALID\", \"the x402 signer factory returned something without getAddress() and signTypedData()\");\n  }\n  return ok(candidate as X402Signer);\n}\n\n/** The EIP-712 type of the struct EIP-3009 `transferWithAuthorization` verifies. */\nexport const TRANSFER_WITH_AUTHORIZATION_TYPES = {\n  TransferWithAuthorization: [\n    { name: \"from\", type: \"address\" },\n    { name: \"to\", type: \"address\" },\n    { name: \"value\", type: \"uint256\" },\n    { name: \"validAfter\", type: \"uint256\" },\n    { name: \"validBefore\", type: \"uint256\" },\n    { name: \"nonce\", type: \"bytes32\" },\n  ],\n} as const;\n\n/** The authorization as it goes on the wire: every number a decimal string. */\nexport interface Eip3009Authorization {\n  readonly from: string;\n  readonly to: string;\n  readonly value: string;\n  readonly validAfter: string;\n  readonly validBefore: string;\n  readonly nonce: Hex;\n}\n\nexport interface SignExactPaymentOptions {\n  readonly signer: X402Signer;\n  /** The server's `PaymentRequired`, echoed into the payload as `resource` and `extensions`. */\n  readonly required: PaymentRequired;\n  /** The entry of `required.accepts` being paid. */\n  readonly accepted: PaymentRequirements;\n  /** Seconds since the epoch. Defaults to the wall clock. */\n  readonly now?: () => number;\n  /** A 32-byte nonce. Defaults to random. A test passes a fixed one. */\n  readonly nonce?: () => Hex;\n}\n\n/** What a signature is for, kept beside the payload so a receipt can be built without re-reading it. */\nexport interface SignedExactPayment {\n  readonly payload: PaymentPayload;\n  readonly authorization: Eip3009Authorization;\n  readonly chainId: bigint;\n  readonly payer: Address;\n}\n\n/**\n * Signs one `exact` requirement.\n *\n * The domain and the struct are exactly what `@x402/evm` signs, so\n * the facilitator's recovery lands on `authorization.from`. The requirement is\n * re-validated here rather than trusted, because it arrived over the network.\n */\nexport async function signExactPayment(options: SignExactPaymentOptions): Promise<Result<SignedExactPayment>> {\n  const { accepted } = options;\n  const chainId = chainIdOfNetwork(accepted.network);\n  if (!chainId.ok) return chainId;\n  const name = accepted.extra?.[\"name\"];\n  const version = accepted.extra?.[\"version\"];\n  if (typeof name !== \"string\" || typeof version !== \"string\") {\n    return validationError(\n      \"X402_DOMAIN_MISSING\",\n      `the requirement for ${accepted.asset} carries no EIP-712 domain name and version in extra, so an EIP-3009 authorization cannot be signed for it`,\n      { details: { asset: accepted.asset, network: accepted.network } },\n    );\n  }\n  if (!/^[0-9]+$/.test(accepted.amount)) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", `amount \\`${accepted.amount}\\` is not a decimal integer of atomic units`);\n  }\n\n  const from = await wrap(\n    async () => options.signer.getAddress(),\n    (error) => ({\n      category: \"UPSTREAM\" as const,\n      code: \"X402_SIGNER_UNAVAILABLE\",\n      message: \"the x402 signer could not report its address\",\n      retryable: false,\n      cause: causeOf(error),\n    }),\n  );\n  if (!from.ok) return from;\n\n  const checksummed = wrapAddresses(from.value, accepted.payTo, accepted.asset);\n  if (!checksummed.ok) return checksummed;\n  const [payer, payTo, asset] = checksummed.value;\n\n  const nowSeconds = options.now === undefined ? Math.floor(Date.now() / 1000) : options.now();\n  const authorization: Eip3009Authorization = {\n    from: payer,\n    to: payTo,\n    value: accepted.amount,\n    validAfter: \"0\",\n    validBefore: (nowSeconds + Math.floor(accepted.maxTimeoutSeconds)).toString(10),\n    nonce: options.nonce === undefined ? (hexlify(randomBytes(32)) as Hex) : options.nonce(),\n  };\n\n  const signature = await wrap(\n    async () =>\n      options.signer.signTypedData(\n        { name, version, chainId: chainId.value, verifyingContract: asset },\n        TRANSFER_WITH_AUTHORIZATION_TYPES,\n        {\n          from: authorization.from,\n          to: authorization.to,\n          value: BigInt(authorization.value),\n          validAfter: BigInt(authorization.validAfter),\n          validBefore: BigInt(authorization.validBefore),\n          nonce: authorization.nonce,\n        },\n      ),\n    (error) => ({\n      category: \"UPSTREAM\" as const,\n      code: \"X402_SIGNING_FAILED\",\n      message: \"the x402 signer refused to sign the EIP-3009 authorization\",\n      retryable: false,\n      cause: causeOf(error),\n    }),\n  );\n  if (!signature.ok) return signature;\n\n  const payload: PaymentPayload = {\n    x402Version: X402_VERSION,\n    resource: options.required.resource,\n    accepted,\n    payload: { signature: signature.value, authorization },\n    // Echoed unchanged, as `@x402/evm` does: the server advertised\n    // them and validates that what comes back carries at least what it sent.\n    ...(options.required.extensions === undefined ? {} : { extensions: options.required.extensions }),\n  };\n  return ok({ payload, authorization, chainId: chainId.value, payer: payer.toLowerCase() as Address });\n}\n\n/** Checksums the three addresses a payload carries, or names the one that is not an address. */\nfunction wrapAddresses(from: string, payTo: string, asset: string): Result<[string, string, string]> {\n  const checked: string[] = [];\n  for (const [label, value] of [\n    [\"signer address\", from],\n    [\"payTo\", payTo],\n    [\"asset\", asset],\n  ] as const) {\n    try {\n      checked.push(getAddress(value));\n    } catch {\n      return validationError(\"X402_REQUIREMENTS_INVALID\", `${label} \\`${value}\\` is not a 20-byte address`, {\n        details: { field: label, value },\n      });\n    }\n  }\n  return ok(checked as [string, string, string]);\n}\n\n/** One payment this client made, as the facilitator reported it back. */\nexport interface X402PaymentReceipt {\n  /** The settlement transaction hash. Empty when the server reported success without one. */\n  readonly txHash: string;\n  readonly network: string;\n  readonly chainId: bigint;\n  /** Atomic units of `asset`, as the requirement priced it. */\n  readonly amount: bigint;\n  readonly asset: Address;\n  readonly payTo: Address;\n  readonly payer: Address;\n  /** The absolute URL the payment bought. */\n  readonly url: string;\n  readonly requirement: PaymentRequirements;\n  readonly settlement: SettleResponse;\n  readonly observedAt: number;\n}\n\n/** The little of a response this client reads. Structural, as in `client-402.ts`. */\nexport interface X402Response {\n  readonly status: number;\n  readonly headers: HeaderReader | HeaderRecord;\n  readonly body?: unknown;\n  readonly bodyUsed?: unknown;\n}\n\nexport interface X402FetchInit {\n  readonly headers: Readonly<Record<string, string>>;\n  readonly [option: string]: unknown;\n}\n\nexport type X402Fetch<Res extends X402Response> = (url: string, init: X402FetchInit) => Promise<Res>;\n\nexport interface X402ClientOptions<Res extends X402Response = X402Response> extends RequirementFilter {\n  readonly signer: X402Signer;\n  readonly fetchImpl?: X402Fetch<Res>;\n  /**\n   * Consulted after the server's `402` and before anything is signed. A refusal\n   * stops the payment and is returned as the error. This is where a Service\n   * fronting an upstream checks that the Agent it will meter has the headroom\n   * before the Service's own funds move.\n   */\n  readonly authorise?: (requirement: PaymentRequirements, required: PaymentRequired) => Promise<Result<void>> | Result<void>;\n  readonly onPayment?: (receipt: X402PaymentReceipt) => void;\n  readonly logger?: Logger;\n  /** Milliseconds since the epoch, for `observedAt`. Defaults to `Date.now`. */\n  readonly now?: () => number;\n  /** Seconds since the epoch, for `validBefore`. Defaults to the wall clock. */\n  readonly nowSeconds?: () => number;\n  readonly nonce?: () => Hex;\n}\n\n/** What one call did: the response, and the payment that bought it if one did. */\nexport interface X402FetchResult<Res extends X402Response = X402Response> {\n  readonly response: Res;\n  readonly payment?: X402PaymentReceipt;\n}\n\nexport interface X402Client<Res extends X402Response = X402Response> {\n  /**\n   * Sends the request; on a `402` carrying `PAYMENT-REQUIRED`, signs and sends\n   * it once more with `PAYMENT-SIGNATURE`. Exactly once: a second `402` means\n   * the payment was refused, and that is returned as an error naming why.\n   */\n  fetch(url: string, init?: X402FetchInit): Promise<Result<X402FetchResult<Res>>>;\n  /**\n   * Pays a `402` the caller already holds: the same second step, for a caller\n   * that made the first request itself.\n   */\n  pay(url: string, init: X402FetchInit, required: PaymentRequired): Promise<Result<X402FetchResult<Res>>>;\n  /** Every payment made, oldest first. */\n  payments(): readonly X402PaymentReceipt[];\n}\n\n/**\n * Builds the client. Construction is total; every failure belongs to a call.\n */\nexport function createX402Client<Res extends X402Response = X402Response>(\n  options: X402ClientOptions<Res>,\n): X402Client<Res> {\n  const logger = options.logger ?? defaultLogger;\n  const now = options.now ?? (() => Date.now());\n  const history: X402PaymentReceipt[] = [];\n  const filter: RequirementFilter = {\n    ...(options.chainId === undefined ? {} : { chainId: options.chainId }),\n    ...(options.asset === undefined ? {} : { asset: options.asset }),\n    ...(options.maxAmount === undefined ? {} : { maxAmount: options.maxAmount }),\n  };\n\n  const send = async (url: string, init: X402FetchInit, attempt: 1 | 2): Promise<Result<Res>> => {\n    const impl = options.fetchImpl ?? hostFetch<Res>();\n    if (impl === undefined) {\n      return upstreamError(\"FETCH_UNAVAILABLE\", \"this host has no global fetch; supply fetchImpl, or run on Node 20.10 or later\");\n    }\n    const sent = await wrap(\n      async () => impl(url, init),\n      (error) => ({\n        category: \"UPSTREAM\" as const,\n        code: \"FETCH_FAILED\",\n        message: `the request to ${url} did not complete`,\n        retryable: true,\n        details: { url, attempt },\n        cause: causeOf(error),\n      }),\n    );\n    if (!sent.ok) return sent;\n    if (!looksLikeResponse(sent.value)) {\n      return upstreamError(\"FETCH_RESPONSE_INVALID\", `the fetch given to this client returned something that is not a response for ${url}`, {\n        details: { url, attempt },\n      });\n    }\n    return ok(sent.value);\n  };\n\n  const pay = async (url: string, init: X402FetchInit, required: PaymentRequired): Promise<Result<X402FetchResult<Res>>> => {\n    const accepted = selectExactRequirement(required, filter);\n    if (!accepted.ok) return accepted;\n\n    if (options.authorise !== undefined) {\n      const allowed = await wrap(\n        async () => options.authorise?.(accepted.value, required),\n        (error) => ({\n          category: \"INTERNAL\" as const,\n          code: \"X402_AUTHORISE_THREW\",\n          message: \"the authorise hook threw, so nothing was signed\",\n          retryable: false,\n          cause: causeOf(error),\n        }),\n      );\n      if (!allowed.ok) return allowed;\n      if (allowed.value !== undefined && !allowed.value.ok) return allowed.value;\n    }\n\n    if (!isReplayable(init[\"body\"])) {\n      return validationError(\n        \"REQUEST_BODY_NOT_REPLAYABLE\",\n        `${url} asks for payment and the request body is a stream, which cannot be sent a second time; buffer the body before calling`,\n        { details: { url } },\n      );\n    }\n\n    const signed = await signExactPayment({\n      signer: options.signer,\n      required,\n      accepted: accepted.value,\n      ...(options.nowSeconds === undefined ? {} : { now: options.nowSeconds }),\n      ...(options.nonce === undefined ? {} : { nonce: options.nonce }),\n    });\n    if (!signed.ok) return signed;\n\n    const header = encodePaymentSignature(signed.value.payload);\n    if (!header.ok) return header;\n\n    const paid = await send(url, { ...init, headers: { ...init.headers, [X402_HEADER.paymentSignature]: header.value } }, 2);\n    if (!paid.ok) return paid;\n    const response = paid.value;\n\n    const settlement = readPaymentResponse(headerReaderOf(response.headers));\n    if (!settlement.ok) {\n      discard(response, logger);\n      return settlement;\n    }\n\n    if (response.status === 402) {\n      discard(response, logger);\n      const reason = settlement.value?.errorReason ?? readError(response.headers) ?? \"the server did not say why\";\n      return fail(\"LIMIT\", \"X402_PAYMENT_REJECTED\", `${url} refused the signed payment: ${reason}`, {\n        retryable: false,\n        details: {\n          url,\n          reason,\n          amount: accepted.value.amount,\n          asset: accepted.value.asset.toLowerCase(),\n          network: accepted.value.network,\n        },\n      });\n    }\n\n    const receipt: X402PaymentReceipt = {\n      txHash: settlement.value?.transaction ?? \"\",\n      network: accepted.value.network,\n      chainId: signed.value.chainId,\n      amount: BigInt(accepted.value.amount),\n      asset: accepted.value.asset.toLowerCase() as Address,\n      payTo: accepted.value.payTo.toLowerCase() as Address,\n      payer: signed.value.payer,\n      url,\n      requirement: accepted.value,\n      settlement: settlement.value ?? { success: response.status < 400, transaction: \"\", network: accepted.value.network },\n      observedAt: now(),\n    };\n    history.push(receipt);\n    if (options.onPayment !== undefined) {\n      try {\n        options.onPayment(receipt);\n      } catch (error) {\n        logger.warn(\"onPayment threw and the payment was recorded anyway\", { url, error: causeOf(error).message });\n      }\n    }\n    return ok({ response, payment: receipt });\n  };\n\n  return {\n    async fetch(url, init = { headers: {} }) {\n      const first = await send(url, init, 1);\n      if (!first.ok) return first;\n      if (first.value.status !== 402) return ok({ response: first.value });\n\n      const required = readPaymentRequired(headerReaderOf(first.value.headers));\n      discard(first.value, logger);\n      if (!required.ok) return required;\n      if (required.value === undefined) {\n        return fail(\"LIMIT\", \"X402_PAYMENT_REQUIRED_MISSING\", `${url} answered 402 without a ${X402_HEADER.paymentRequired} header, so there is nothing to pay`, {\n          retryable: false,\n          details: { url },\n        });\n      }\n      return pay(url, init, required.value);\n    },\n    pay,\n    payments: () => [...history],\n  };\n}\n\n/** The `error` field of a `PAYMENT-REQUIRED` a refusal may carry, when it carries one. */\nfunction readError(headers: HeaderReader | HeaderRecord): string | undefined {\n  const required = readPaymentRequired(headers);\n  return required.ok ? required.value?.error : undefined;\n}\n\nfunction looksLikeResponse(value: unknown): boolean {\n  if (typeof value !== \"object\" || value === null) return false;\n  const candidate = value as { status?: unknown; headers?: unknown };\n  return typeof candidate.status === \"number\" && typeof candidate.headers === \"object\" && candidate.headers !== null;\n}\n\n/** A stream cannot be sent twice; everything else can. */\nfunction isReplayable(body: unknown): boolean {\n  if (body === undefined || body === null || typeof body !== \"object\") return true;\n  const candidate = body as { getReader?: unknown; [Symbol.asyncIterator]?: unknown };\n  return typeof candidate.getReader !== \"function\" && typeof candidate[Symbol.asyncIterator] !== \"function\";\n}\n\n/** Releases a response that is not going out, so its connection does not wait for the collector. */\nfunction discard(response: X402Response, logger: Logger): void {\n  const body = response.body as { cancel?: unknown } | null | undefined;\n  if (body === null || body === undefined || typeof body.cancel !== \"function\" || response.bodyUsed === true) return;\n  try {\n    const cancelled = (body.cancel as () => unknown)();\n    if (typeof (cancelled as { catch?: unknown })?.catch === \"function\") {\n      (cancelled as Promise<unknown>).catch((error: unknown) => {\n        logger.debug(\"discarded response body could not be cancelled\", causeOf(error));\n      });\n    }\n  } catch (error) {\n    logger.debug(\"discarded response body could not be cancelled\", causeOf(error));\n  }\n}\n\nfunction hostFetch<Res extends X402Response>(): X402Fetch<Res> | undefined {\n  const candidate = (globalThis as { fetch?: unknown }).fetch;\n  return typeof candidate === \"function\" ? (candidate as X402Fetch<Res>) : undefined;\n}\n"]}

package/dist/x402/server.d.ts

@@ -26,7 +26,7 @@
  * The facilitator client is `@x402/core`'s `HTTPFacilitatorClient`, wrapped so
  * a thrown `VerifyError` or `SettleError` comes back as a `Result` carrying the
  * facilitator's reason. Requirement construction and the request handling are
- * this package's own, because the reference server middleware gates every
+ * this package's own, because the official server middleware gates every
  * request on payment, which is the model Tab exists to replace.
  *
  * Specification: x402-specification-v2.md sections 5, 6.1 and 7, transports-v2/http.md.
@@ -43,18 +43,18 @@ export declare const DEFAULT_MAX_TIMEOUT_SECONDS = 300;
 /**
  * What verifies and settles payments.
  *
- * The reference interface, re-exported so a fake in a test and the HTTP client
- * in production are the same type. The methods throw, as the reference does;
+ * `@x402/core`'s interface, re-exported so a fake in a test and the HTTP client
+ * in production are the same type. The methods throw, as `@x402/core`'s do;
  * {@link verifyPayment} and {@link settlePayment} are the zero-throw doors.
  */
 export type X402FacilitatorClient = FacilitatorClient;
 export interface X402FacilitatorOptions {
     /** Defaults to {@link MONAD_FACILITATOR_URL}. */
     readonly url?: string;
-    /** Per-request timeout. Defaults to the reference client's 90 seconds. */
+    /** Per-request timeout. Defaults to `@x402/core`'s 90 seconds. */
     readonly timeoutMs?: number;
 }
-/** The reference HTTP client over a facilitator's `/verify`, `/settle` and `/supported`. */
+/** `@x402/core`'s HTTP client over a facilitator's `/verify`, `/settle` and `/supported`. */
 export declare function createX402Facilitator(options?: X402FacilitatorOptions): X402FacilitatorClient;
 export interface ExactRequirementOptions {
     readonly chainId: bigint;

package/dist/x402/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/x402/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/x402/server.ts"],"names":[],"mappings":"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"}

package/dist/x402/server.js

@@ -26,7 +26,7 @@
  * The facilitator client is `@x402/core`'s `HTTPFacilitatorClient`, wrapped so
  * a thrown `VerifyError` or `SettleError` comes back as a `Result` carrying the
  * facilitator's reason. Requirement construction and the request handling are
- * this package's own, because the reference server middleware gates every
+ * this package's own, because the official server middleware gates every
  * request on payment, which is the model Tab exists to replace.
  *
  * Specification: x402-specification-v2.md sections 5, 6.1 and 7, transports-v2/http.md.
@@ -40,7 +40,7 @@ import { X402_HEADER, X402_SCHEME_EXACT, X402_VERSION, encodePaymentRequired, en
 export const MONAD_FACILITATOR_URL = "https://x402-facilitator.molandak.org";
 /** How long an authorization stays valid when the Service does not say. */
 export const DEFAULT_MAX_TIMEOUT_SECONDS = 300;
-/** The reference HTTP client over a facilitator's `/verify`, `/settle` and `/supported`. */
+/** `@x402/core`'s HTTP client over a facilitator's `/verify`, `/settle` and `/supported`. */
 export function createX402Facilitator(options = {}) {
     return new HTTPFacilitatorClient({
         url: options.url ?? MONAD_FACILITATOR_URL,

package/dist/x402/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/x402/server.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The x402 server side: build what a `402` must carry, and take a signed\n * payment through a facilitator.\n *\n * ## The flow, and why the order is fixed\n *\n * x402's default `authorization` flow is verify, then resource, then settle:\n * the facilitator confirms the signature and the balance before the work is\n * done, and moves the funds only after the work succeeded. {@link handlePrepaidRequest}\n * runs exactly that. It never settles a payment for a response that was not a\n * delivery, for the same reason the post-paid plugin never meters one: an\n * Agent is not charged for a call that failed.\n *\n * ## What a Tab Service does with this\n *\n * A Tab Service delivers on credit and refuses on `LimitExceeded` alone. With\n * this module, that refusal can also carry a `PAYMENT-REQUIRED` naming the same\n * charge as an x402 `exact` requirement, so an Agent that has no headroom and\n * would rather not settle first can pay for the one call. When it does, the\n * call is prepaid in full, the facilitator moves the Asset to the Service's\n * Collection address, and nothing lands on the Open Tab, because nothing is\n * owed.\n *\n * ## Official and hand-rolled\n *\n * The facilitator client is `@x402/core`'s `HTTPFacilitatorClient`, wrapped so\n * a thrown `VerifyError` or `SettleError` comes back as a `Result` carrying the\n * facilitator's reason. Requirement construction and the request handling are\n * this package's own, because the reference server middleware gates every\n * request on payment, which is the model Tab exists to replace.\n *\n * Specification: x402-specification-v2.md sections 5, 6.1 and 7, transports-v2/http.md.\n */\n\nimport { HTTPFacilitatorClient, type FacilitatorClient } from \"@x402/core/server\";\nimport { causeOf, isAddress, ok, wrap, type Address, type Result, type TabError } from \"../_shared/index.js\";\n\nimport { fail, tabError, validationError } from \"../errors.js\";\nimport { defaultLogger, type Logger } from \"../logger.js\";\nimport type { AssetRef } from \"../payments/strategy.js\";\nimport {\n  X402_HEADER,\n  X402_SCHEME_EXACT,\n  X402_VERSION,\n  encodePaymentRequired,\n  encodePaymentResponse,\n  networkOf,\n  type PaymentPayload,\n  type PaymentRequired,\n  type PaymentRequirements,\n  type ResourceInfo,\n  type SettleResponse,\n  type SupportedResponse,\n  type VerifyResponse,\n} from \"./wire.js\";\n\n/** Monad's facilitator, which settles `exact` and `upto` on Mainnet and Testnet. */\nexport const MONAD_FACILITATOR_URL = \"https://x402-facilitator.molandak.org\";\n\n/** How long an authorization stays valid when the Service does not say. */\nexport const DEFAULT_MAX_TIMEOUT_SECONDS = 300;\n\n/**\n * What verifies and settles payments.\n *\n * The reference interface, re-exported so a fake in a test and the HTTP client\n * in production are the same type. The methods throw, as the reference does;\n * {@link verifyPayment} and {@link settlePayment} are the zero-throw doors.\n */\nexport type X402FacilitatorClient = FacilitatorClient;\n\nexport interface X402FacilitatorOptions {\n  /** Defaults to {@link MONAD_FACILITATOR_URL}. */\n  readonly url?: string;\n  /** Per-request timeout. Defaults to the reference client's 90 seconds. */\n  readonly timeoutMs?: number;\n}\n\n/** The reference HTTP client over a facilitator's `/verify`, `/settle` and `/supported`. */\nexport function createX402Facilitator(options: X402FacilitatorOptions = {}): X402FacilitatorClient {\n  return new HTTPFacilitatorClient({\n    url: options.url ?? MONAD_FACILITATOR_URL,\n    ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),\n  });\n}\n\n/** The EIP-712 domain of the two USDC deployments Monad's facilitator settles. */\nconst KNOWN_DOMAINS: Readonly<Record<string, { readonly name: string; readonly version: string }>> = {\n  USDC: { name: \"USDC\", version: \"2\" },\n  // The Testnet mock's constructor names it `USDC` v2 to match Circle's; the\n  // rail calls it `mUSDC` so the two are never confused on a page.\n  MUSDC: { name: \"USDC\", version: \"2\" },\n};\n\nexport interface ExactRequirementOptions {\n  readonly chainId: bigint;\n  /** The token. `symbol` picks the EIP-712 domain when `extra` is not given. */\n  readonly asset: Pick<AssetRef, \"address\" | \"symbol\">;\n  /** Atomic units of the token. */\n  readonly amount: bigint;\n  /** Where the facilitator sends the funds: the Service's Collection address for the Asset. */\n  readonly payTo: Address;\n  readonly maxTimeoutSeconds?: number;\n  /**\n   * The requirement's `extra`. Must carry the token's EIP-712 domain `name` and\n   * `version`, which EIP-3009 signing needs. Defaults to USDC's when the Asset's\n   * symbol is `USDC`, and is required otherwise.\n   */\n  readonly extra?: Readonly<Record<string, unknown>>;\n}\n\n/** One `exact` requirement, EIP-3009, on an EVM chain. */\nexport function exactRequirementFor(options: ExactRequirementOptions): Result<PaymentRequirements> {\n  if (typeof options.chainId !== \"bigint\" || options.chainId <= 0n) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", \"chainId must be a positive bigint\");\n  }\n  if (!isAddress(options.asset.address)) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", `asset \\`${String(options.asset.address)}\\` is not a 20-byte address`);\n  }\n  if (!isAddress(options.payTo)) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", `payTo \\`${String(options.payTo)}\\` is not a 20-byte address`);\n  }\n  if (typeof options.amount !== \"bigint\" || options.amount <= 0n) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", \"amount must be a positive bigint of atomic units, never a number\");\n  }\n  const timeout = options.maxTimeoutSeconds ?? DEFAULT_MAX_TIMEOUT_SECONDS;\n  if (!Number.isInteger(timeout) || timeout <= 0) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", \"maxTimeoutSeconds must be a positive integer\");\n  }\n  const extra = options.extra ?? KNOWN_DOMAINS[options.asset.symbol.toUpperCase()];\n  if (extra === undefined || typeof extra[\"name\"] !== \"string\" || typeof extra[\"version\"] !== \"string\") {\n    return validationError(\n      \"X402_DOMAIN_MISSING\",\n      `no EIP-712 domain is known for ${options.asset.symbol}; pass extra: { name, version } from the token contract`,\n      { details: { asset: options.asset.address, symbol: options.asset.symbol } },\n    );\n  }\n  return ok({\n    scheme: X402_SCHEME_EXACT,\n    network: networkOf(options.chainId),\n    amount: options.amount.toString(10),\n    asset: options.asset.address,\n    payTo: options.payTo,\n    maxTimeoutSeconds: timeout,\n    extra: { ...extra },\n  });\n}\n\nexport interface PaymentRequiredOptions {\n  readonly resource: ResourceInfo;\n  readonly accepts: readonly PaymentRequirements[];\n  /** Why payment is being asked for, for a person reading the header. */\n  readonly error?: string;\n}\n\n/** The object a `402` carries in `PAYMENT-REQUIRED`. */\nexport const paymentRequiredFor = (options: PaymentRequiredOptions): PaymentRequired => ({\n  x402Version: X402_VERSION,\n  ...(options.error === undefined ? {} : { error: options.error }),\n  resource: options.resource,\n  accepts: [...options.accepts],\n});\n\n/** The `PAYMENT-REQUIRED` header, ready to merge onto a response. */\nexport function paymentRequiredHeaders(required: PaymentRequired): Result<Record<string, string>> {\n  const encoded = encodePaymentRequired(required);\n  if (!encoded.ok) return encoded;\n  return ok({ [X402_HEADER.paymentRequired]: encoded.value });\n}\n\n/** The `PAYMENT-RESPONSE` header, ready to merge onto a response. */\nexport function paymentResponseHeaders(settlement: SettleResponse): Result<Record<string, string>> {\n  const encoded = encodePaymentResponse(settlement);\n  if (!encoded.ok) return encoded;\n  return ok({ [X402_HEADER.paymentResponse]: encoded.value });\n}\n\n/** What a thrown facilitator error carries, read without depending on its class. */\ninterface ThrownFacilitatorError {\n  readonly invalidReason?: unknown;\n  readonly errorReason?: unknown;\n  readonly invalidMessage?: unknown;\n  readonly errorMessage?: unknown;\n  readonly payer?: unknown;\n  readonly transaction?: unknown;\n  readonly statusCode?: unknown;\n}\n\nconst facilitatorFailure = (what: \"verify\" | \"settle\") => (error: unknown): TabError => {\n  const thrown = (typeof error === \"object\" && error !== null ? error : {}) as ThrownFacilitatorError;\n  const reason = [thrown.invalidReason, thrown.errorReason].find((value) => typeof value === \"string\") as string | undefined;\n  const detail = [thrown.invalidMessage, thrown.errorMessage].find((value) => typeof value === \"string\") as string | undefined;\n  return tabError(\n    reason === undefined ? \"UPSTREAM\" : \"LIMIT\",\n    reason === undefined ? `X402_FACILITATOR_${what.toUpperCase()}_FAILED` : `X402_${what.toUpperCase()}_REJECTED`,\n    reason === undefined\n      ? `the facilitator could not ${what} the payment`\n      : `the facilitator refused to ${what} the payment: ${reason}${detail === undefined ? \"\" : ` (${detail})`}`,\n    {\n      retryable: reason === undefined,\n      details: {\n        ...(reason === undefined ? {} : { reason }),\n        ...(typeof thrown.payer === \"string\" ? { payer: thrown.payer } : {}),\n        ...(typeof thrown.transaction === \"string\" && thrown.transaction.length > 0 ? { transaction: thrown.transaction } : {}),\n        ...(typeof thrown.statusCode === \"number\" ? { statusCode: thrown.statusCode } : {}),\n      },\n      cause: causeOf(error),\n    },\n  );\n};\n\n/** `POST /verify`, as a `Result`. An invalid payment is a `LIMIT` error naming the facilitator's reason. */\nexport async function verifyPayment(\n  facilitator: X402FacilitatorClient,\n  payload: PaymentPayload,\n  requirements: PaymentRequirements,\n): Promise<Result<VerifyResponse>> {\n  const verified = await wrap(async () => facilitator.verify(payload, requirements), facilitatorFailure(\"verify\"));\n  if (!verified.ok) return verified;\n  if (verified.value.isValid !== true) {\n    const reason = verified.value.invalidReason ?? \"invalid_payload\";\n    return fail(\"LIMIT\", \"X402_VERIFY_REJECTED\", `the facilitator refused to verify the payment: ${reason}`, {\n      retryable: false,\n      details: { reason, ...(verified.value.payer === undefined ? {} : { payer: verified.value.payer }) },\n    });\n  }\n  return verified;\n}\n\n/** `POST /settle`, as a `Result`. A failed settlement carries the facilitator's reason and any broadcast hash. */\nexport async function settlePayment(\n  facilitator: X402FacilitatorClient,\n  payload: PaymentPayload,\n  requirements: PaymentRequirements,\n): Promise<Result<SettleResponse>> {\n  const settled = await wrap(async () => facilitator.settle(payload, requirements), facilitatorFailure(\"settle\"));\n  if (!settled.ok) return settled;\n  if (settled.value.success !== true) {\n    const reason = settled.value.errorReason ?? \"unexpected_settle_error\";\n    return fail(\n      reason === \"settlement_pending\" ? \"UNAVAILABLE\" : \"LIMIT\",\n      \"X402_SETTLE_REJECTED\",\n      `the facilitator did not settle the payment: ${reason}`,\n      {\n        retryable: reason === \"settlement_pending\",\n        details: {\n          reason,\n          transaction: settled.value.transaction,\n          network: settled.value.network,\n          ...(settled.value.payer === undefined ? {} : { payer: settled.value.payer }),\n        },\n      },\n    );\n  }\n  return settled;\n}\n\n/** `GET /supported`, as a `Result`. */\nexport const facilitatorSupports = (facilitator: X402FacilitatorClient): Promise<Result<SupportedResponse>> =>\n  wrap(async () => facilitator.getSupported(), (error) =>\n    tabError(\"UPSTREAM\", \"X402_FACILITATOR_UNREACHABLE\", \"the facilitator did not answer /supported\", {\n      retryable: true,\n      cause: causeOf(error),\n    }),\n  );\n\n/**\n * Checks that what the client says it accepted is what this server requires.\n *\n * The facilitator verifies the signature against the server's requirements, so\n * a mismatch would be caught there; catching it here saves the round trip and\n * names the field. `extra` and `maxTimeoutSeconds` are not compared: they are\n * the server's inputs to signing and the facilitator reads them from the\n * server's copy, never the client's.\n */\nexport function matchAccepted(accepted: PaymentRequirements, requirements: PaymentRequirements): Result<void> {\n  const mismatches: string[] = [];\n  if (accepted.scheme !== requirements.scheme) mismatches.push(`scheme ${accepted.scheme} is not ${requirements.scheme}`);\n  if (accepted.network !== requirements.network) mismatches.push(`network ${accepted.network} is not ${requirements.network}`);\n  if (accepted.asset.toLowerCase() !== requirements.asset.toLowerCase()) mismatches.push(`asset ${accepted.asset} is not ${requirements.asset}`);\n  if (accepted.payTo.toLowerCase() !== requirements.payTo.toLowerCase()) mismatches.push(`payTo ${accepted.payTo} is not ${requirements.payTo}`);\n  if (BigInt(accepted.amount) !== BigInt(requirements.amount)) mismatches.push(`amount ${accepted.amount} is not ${requirements.amount}`);\n  if (mismatches.length === 0) return ok(undefined);\n  return fail(\"LIMIT\", \"X402_ACCEPTED_MISMATCH\", `the signed payment does not match this call's requirement: ${mismatches.join(\", \")}`, {\n    retryable: false,\n    details: { mismatches: mismatches.join(\"; \") },\n  });\n}\n\n/** The response, reduced to what the billability decision needs. */\nexport interface X402DeliveredResponse {\n  readonly status: number;\n}\n\nexport interface PrepaidRequestOptions {\n  readonly facilitator: X402FacilitatorClient;\n  /** The decoded `PAYMENT-SIGNATURE`. */\n  readonly payload: PaymentPayload;\n  /** What this call costs, built by the server and never taken from the client. */\n  readonly requirements: PaymentRequirements;\n  readonly resource: ResourceInfo;\n  /** The work. Runs only after the payment verified. */\n  readonly deliver: () => Promise<Response> | Response;\n  /** Whether a response is a delivery worth settling for. Defaults to `status < 400`. */\n  readonly billable?: (response: X402DeliveredResponse) => boolean;\n  readonly logger?: Logger;\n}\n\nexport type PrepaidOutcome =\n  /** Verified, delivered, settled. The response carries `PAYMENT-RESPONSE`. */\n  | { readonly kind: \"paid\"; readonly response: Response; readonly settlement: SettleResponse; readonly payer: string | undefined }\n  /** The payment did not verify. The response is a `402` carrying `PAYMENT-REQUIRED` with the reason. */\n  | { readonly kind: \"rejected\"; readonly response: Response; readonly error: TabError }\n  /** The work was not a delivery, so nothing was settled and the handler's own response goes out. */\n  | { readonly kind: \"not-delivered\"; readonly response: Response }\n  /** The handler threw. Nothing was settled. */\n  | { readonly kind: \"handler-failed\"; readonly thrown: unknown; readonly error: TabError }\n  /** Delivered, but the facilitator would not settle. The response is a `402` carrying the failed `PAYMENT-RESPONSE`. */\n  | { readonly kind: \"settlement-failed\"; readonly response: Response; readonly error: TabError };\n\n/**\n * Takes one prepaid request through verify, deliver, settle.\n *\n * Never throws and never rejects. A thrown handler is an outcome, not an\n * exception, so a host adapter can re-raise it the way its framework expects.\n */\nexport async function handlePrepaidRequest(options: PrepaidRequestOptions): Promise<PrepaidOutcome> {\n  const logger = options.logger ?? defaultLogger;\n  const billable = options.billable ?? ((response: X402DeliveredResponse) => response.status < 400);\n  const required = paymentRequiredFor({ resource: options.resource, accepts: [options.requirements] });\n\n  const rejected = (error: TabError): PrepaidOutcome => ({\n    kind: \"rejected\",\n    response: paymentRequiredResponse({ ...required, error: error.message }, error),\n    error,\n  });\n\n  const matched = matchAccepted(options.payload.accepted, options.requirements);\n  if (!matched.ok) return rejected(matched.error);\n\n  const verified = await verifyPayment(options.facilitator, options.payload, options.requirements);\n  if (!verified.ok) return rejected(verified.error);\n\n  let response: Response;\n  try {\n    response = await options.deliver();\n  } catch (thrown) {\n    logger.debug(\"x402 prepaid call settled nothing because the handler failed\");\n    return {\n      kind: \"handler-failed\",\n      thrown,\n      error: tabError(\"INTERNAL\", \"HANDLER_FAILED\", \"the handler failed, so the verified payment was not settled\", {\n        details: { settled: false },\n        cause: causeOf(thrown),\n      }),\n    };\n  }\n\n  let deliverable: boolean;\n  try {\n    deliverable = billable(response) === true;\n  } catch (thrown) {\n    logger.error(\"x402 billable predicate threw and was read as not billable\", causeOf(thrown));\n    deliverable = false;\n  }\n  if (!deliverable) return { kind: \"not-delivered\", response };\n\n  const settled = await settlePayment(options.facilitator, options.payload, options.requirements);\n  if (!settled.ok) {\n    discard(response, logger);\n    const failure: SettleResponse = {\n      success: false,\n      errorReason: String(settled.error.details?.[\"reason\"] ?? settled.error.code),\n      transaction: String(settled.error.details?.[\"transaction\"] ?? \"\"),\n      network: options.requirements.network,\n      ...(typeof settled.error.details?.[\"payer\"] === \"string\" ? { payer: settled.error.details[\"payer\"] } : {}),\n    };\n    return { kind: \"settlement-failed\", response: settlementFailedResponse(failure, settled.error), error: settled.error };\n  }\n\n  const headers = paymentResponseHeaders(settled.value);\n  if (!headers.ok) {\n    // The funds moved and the work is delivered; a header that will not encode\n    // costs the caller the receipt and nothing else.\n    logger.error(\"x402 settlement succeeded but PAYMENT-RESPONSE would not encode\", { code: headers.error.code });\n    return { kind: \"paid\", response, settlement: settled.value, payer: settled.value.payer };\n  }\n  return { kind: \"paid\", response: withHeaders(response, headers.value, logger), settlement: settled.value, payer: settled.value.payer };\n}\n\n/** A `402` carrying `PAYMENT-REQUIRED` and a JSON body naming the error. */\nexport function paymentRequiredResponse(required: PaymentRequired, error: TabError, extraHeaders: Readonly<Record<string, string>> = {}): Response {\n  const encoded = paymentRequiredHeaders(required);\n  return new Response(JSON.stringify({ ok: false, error }), {\n    status: 402,\n    headers: {\n      ...extraHeaders,\n      ...(encoded.ok ? encoded.value : {}),\n      \"Content-Type\": \"application/json; charset=utf-8\",\n    },\n  });\n}\n\n/** A `402` carrying a failed `PAYMENT-RESPONSE`, as the HTTP transport specification shows. */\nfunction settlementFailedResponse(failure: SettleResponse, error: TabError): Response {\n  const encoded = paymentResponseHeaders(failure);\n  return new Response(JSON.stringify({ ok: false, error }), {\n    status: 402,\n    headers: { ...(encoded.ok ? encoded.value : {}), \"Content-Type\": \"application/json; charset=utf-8\" },\n  });\n}\n\n/** Puts headers on a response, copying it when its headers are immutable. */\nfunction withHeaders(response: Response, headers: Readonly<Record<string, string>>, logger: Logger): Response {\n  try {\n    for (const [name, value] of Object.entries(headers)) response.headers.set(name, value);\n    return response;\n  } catch {\n    logger.debug(\"response headers were immutable, so PAYMENT-RESPONSE went onto a copy\");\n    const merged = new Headers(response.headers);\n    for (const [name, value] of Object.entries(headers)) merged.set(name, value);\n    return new Response(response.body, { status: response.status, statusText: response.statusText, headers: merged });\n  }\n}\n\nfunction discard(response: Response, logger: Logger): void {\n  const body = response.body;\n  if (body === null || response.bodyUsed) return;\n  try {\n    body.cancel().catch((error: unknown) => logger.debug(\"discarded response body could not be cancelled\", causeOf(error)));\n  } catch (error) {\n    logger.debug(\"discarded response body could not be cancelled\", causeOf(error));\n  }\n}\n"]}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/x402/server.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The x402 server side: build what a `402` must carry, and take a signed\n * payment through a facilitator.\n *\n * ## The flow, and why the order is fixed\n *\n * x402's default `authorization` flow is verify, then resource, then settle:\n * the facilitator confirms the signature and the balance before the work is\n * done, and moves the funds only after the work succeeded. {@link handlePrepaidRequest}\n * runs exactly that. It never settles a payment for a response that was not a\n * delivery, for the same reason the post-paid plugin never meters one: an\n * Agent is not charged for a call that failed.\n *\n * ## What a Tab Service does with this\n *\n * A Tab Service delivers on credit and refuses on `LimitExceeded` alone. With\n * this module, that refusal can also carry a `PAYMENT-REQUIRED` naming the same\n * charge as an x402 `exact` requirement, so an Agent that has no headroom and\n * would rather not settle first can pay for the one call. When it does, the\n * call is prepaid in full, the facilitator moves the Asset to the Service's\n * Collection address, and nothing lands on the Open Tab, because nothing is\n * owed.\n *\n * ## Official and hand-rolled\n *\n * The facilitator client is `@x402/core`'s `HTTPFacilitatorClient`, wrapped so\n * a thrown `VerifyError` or `SettleError` comes back as a `Result` carrying the\n * facilitator's reason. Requirement construction and the request handling are\n * this package's own, because the official server middleware gates every\n * request on payment, which is the model Tab exists to replace.\n *\n * Specification: x402-specification-v2.md sections 5, 6.1 and 7, transports-v2/http.md.\n */\n\nimport { HTTPFacilitatorClient, type FacilitatorClient } from \"@x402/core/server\";\nimport { causeOf, isAddress, ok, wrap, type Address, type Result, type TabError } from \"../_shared/index.js\";\n\nimport { fail, tabError, validationError } from \"../errors.js\";\nimport { defaultLogger, type Logger } from \"../logger.js\";\nimport type { AssetRef } from \"../payments/strategy.js\";\nimport {\n  X402_HEADER,\n  X402_SCHEME_EXACT,\n  X402_VERSION,\n  encodePaymentRequired,\n  encodePaymentResponse,\n  networkOf,\n  type PaymentPayload,\n  type PaymentRequired,\n  type PaymentRequirements,\n  type ResourceInfo,\n  type SettleResponse,\n  type SupportedResponse,\n  type VerifyResponse,\n} from \"./wire.js\";\n\n/** Monad's facilitator, which settles `exact` and `upto` on Mainnet and Testnet. */\nexport const MONAD_FACILITATOR_URL = \"https://x402-facilitator.molandak.org\";\n\n/** How long an authorization stays valid when the Service does not say. */\nexport const DEFAULT_MAX_TIMEOUT_SECONDS = 300;\n\n/**\n * What verifies and settles payments.\n *\n * `@x402/core`'s interface, re-exported so a fake in a test and the HTTP client\n * in production are the same type. The methods throw, as `@x402/core`'s do;\n * {@link verifyPayment} and {@link settlePayment} are the zero-throw doors.\n */\nexport type X402FacilitatorClient = FacilitatorClient;\n\nexport interface X402FacilitatorOptions {\n  /** Defaults to {@link MONAD_FACILITATOR_URL}. */\n  readonly url?: string;\n  /** Per-request timeout. Defaults to `@x402/core`'s 90 seconds. */\n  readonly timeoutMs?: number;\n}\n\n/** `@x402/core`'s HTTP client over a facilitator's `/verify`, `/settle` and `/supported`. */\nexport function createX402Facilitator(options: X402FacilitatorOptions = {}): X402FacilitatorClient {\n  return new HTTPFacilitatorClient({\n    url: options.url ?? MONAD_FACILITATOR_URL,\n    ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),\n  });\n}\n\n/** The EIP-712 domain of the two USDC deployments Monad's facilitator settles. */\nconst KNOWN_DOMAINS: Readonly<Record<string, { readonly name: string; readonly version: string }>> = {\n  USDC: { name: \"USDC\", version: \"2\" },\n  // The Testnet mock's constructor names it `USDC` v2 to match Circle's; the\n  // rail calls it `mUSDC` so the two are never confused on a page.\n  MUSDC: { name: \"USDC\", version: \"2\" },\n};\n\nexport interface ExactRequirementOptions {\n  readonly chainId: bigint;\n  /** The token. `symbol` picks the EIP-712 domain when `extra` is not given. */\n  readonly asset: Pick<AssetRef, \"address\" | \"symbol\">;\n  /** Atomic units of the token. */\n  readonly amount: bigint;\n  /** Where the facilitator sends the funds: the Service's Collection address for the Asset. */\n  readonly payTo: Address;\n  readonly maxTimeoutSeconds?: number;\n  /**\n   * The requirement's `extra`. Must carry the token's EIP-712 domain `name` and\n   * `version`, which EIP-3009 signing needs. Defaults to USDC's when the Asset's\n   * symbol is `USDC`, and is required otherwise.\n   */\n  readonly extra?: Readonly<Record<string, unknown>>;\n}\n\n/** One `exact` requirement, EIP-3009, on an EVM chain. */\nexport function exactRequirementFor(options: ExactRequirementOptions): Result<PaymentRequirements> {\n  if (typeof options.chainId !== \"bigint\" || options.chainId <= 0n) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", \"chainId must be a positive bigint\");\n  }\n  if (!isAddress(options.asset.address)) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", `asset \\`${String(options.asset.address)}\\` is not a 20-byte address`);\n  }\n  if (!isAddress(options.payTo)) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", `payTo \\`${String(options.payTo)}\\` is not a 20-byte address`);\n  }\n  if (typeof options.amount !== \"bigint\" || options.amount <= 0n) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", \"amount must be a positive bigint of atomic units, never a number\");\n  }\n  const timeout = options.maxTimeoutSeconds ?? DEFAULT_MAX_TIMEOUT_SECONDS;\n  if (!Number.isInteger(timeout) || timeout <= 0) {\n    return validationError(\"X402_REQUIREMENTS_INVALID\", \"maxTimeoutSeconds must be a positive integer\");\n  }\n  const extra = options.extra ?? KNOWN_DOMAINS[options.asset.symbol.toUpperCase()];\n  if (extra === undefined || typeof extra[\"name\"] !== \"string\" || typeof extra[\"version\"] !== \"string\") {\n    return validationError(\n      \"X402_DOMAIN_MISSING\",\n      `no EIP-712 domain is known for ${options.asset.symbol}; pass extra: { name, version } from the token contract`,\n      { details: { asset: options.asset.address, symbol: options.asset.symbol } },\n    );\n  }\n  return ok({\n    scheme: X402_SCHEME_EXACT,\n    network: networkOf(options.chainId),\n    amount: options.amount.toString(10),\n    asset: options.asset.address,\n    payTo: options.payTo,\n    maxTimeoutSeconds: timeout,\n    extra: { ...extra },\n  });\n}\n\nexport interface PaymentRequiredOptions {\n  readonly resource: ResourceInfo;\n  readonly accepts: readonly PaymentRequirements[];\n  /** Why payment is being asked for, for a person reading the header. */\n  readonly error?: string;\n}\n\n/** The object a `402` carries in `PAYMENT-REQUIRED`. */\nexport const paymentRequiredFor = (options: PaymentRequiredOptions): PaymentRequired => ({\n  x402Version: X402_VERSION,\n  ...(options.error === undefined ? {} : { error: options.error }),\n  resource: options.resource,\n  accepts: [...options.accepts],\n});\n\n/** The `PAYMENT-REQUIRED` header, ready to merge onto a response. */\nexport function paymentRequiredHeaders(required: PaymentRequired): Result<Record<string, string>> {\n  const encoded = encodePaymentRequired(required);\n  if (!encoded.ok) return encoded;\n  return ok({ [X402_HEADER.paymentRequired]: encoded.value });\n}\n\n/** The `PAYMENT-RESPONSE` header, ready to merge onto a response. */\nexport function paymentResponseHeaders(settlement: SettleResponse): Result<Record<string, string>> {\n  const encoded = encodePaymentResponse(settlement);\n  if (!encoded.ok) return encoded;\n  return ok({ [X402_HEADER.paymentResponse]: encoded.value });\n}\n\n/** What a thrown facilitator error carries, read without depending on its class. */\ninterface ThrownFacilitatorError {\n  readonly invalidReason?: unknown;\n  readonly errorReason?: unknown;\n  readonly invalidMessage?: unknown;\n  readonly errorMessage?: unknown;\n  readonly payer?: unknown;\n  readonly transaction?: unknown;\n  readonly statusCode?: unknown;\n}\n\nconst facilitatorFailure = (what: \"verify\" | \"settle\") => (error: unknown): TabError => {\n  const thrown = (typeof error === \"object\" && error !== null ? error : {}) as ThrownFacilitatorError;\n  const reason = [thrown.invalidReason, thrown.errorReason].find((value) => typeof value === \"string\") as string | undefined;\n  const detail = [thrown.invalidMessage, thrown.errorMessage].find((value) => typeof value === \"string\") as string | undefined;\n  return tabError(\n    reason === undefined ? \"UPSTREAM\" : \"LIMIT\",\n    reason === undefined ? `X402_FACILITATOR_${what.toUpperCase()}_FAILED` : `X402_${what.toUpperCase()}_REJECTED`,\n    reason === undefined\n      ? `the facilitator could not ${what} the payment`\n      : `the facilitator refused to ${what} the payment: ${reason}${detail === undefined ? \"\" : ` (${detail})`}`,\n    {\n      retryable: reason === undefined,\n      details: {\n        ...(reason === undefined ? {} : { reason }),\n        ...(typeof thrown.payer === \"string\" ? { payer: thrown.payer } : {}),\n        ...(typeof thrown.transaction === \"string\" && thrown.transaction.length > 0 ? { transaction: thrown.transaction } : {}),\n        ...(typeof thrown.statusCode === \"number\" ? { statusCode: thrown.statusCode } : {}),\n      },\n      cause: causeOf(error),\n    },\n  );\n};\n\n/** `POST /verify`, as a `Result`. An invalid payment is a `LIMIT` error naming the facilitator's reason. */\nexport async function verifyPayment(\n  facilitator: X402FacilitatorClient,\n  payload: PaymentPayload,\n  requirements: PaymentRequirements,\n): Promise<Result<VerifyResponse>> {\n  const verified = await wrap(async () => facilitator.verify(payload, requirements), facilitatorFailure(\"verify\"));\n  if (!verified.ok) return verified;\n  if (verified.value.isValid !== true) {\n    const reason = verified.value.invalidReason ?? \"invalid_payload\";\n    return fail(\"LIMIT\", \"X402_VERIFY_REJECTED\", `the facilitator refused to verify the payment: ${reason}`, {\n      retryable: false,\n      details: { reason, ...(verified.value.payer === undefined ? {} : { payer: verified.value.payer }) },\n    });\n  }\n  return verified;\n}\n\n/** `POST /settle`, as a `Result`. A failed settlement carries the facilitator's reason and any broadcast hash. */\nexport async function settlePayment(\n  facilitator: X402FacilitatorClient,\n  payload: PaymentPayload,\n  requirements: PaymentRequirements,\n): Promise<Result<SettleResponse>> {\n  const settled = await wrap(async () => facilitator.settle(payload, requirements), facilitatorFailure(\"settle\"));\n  if (!settled.ok) return settled;\n  if (settled.value.success !== true) {\n    const reason = settled.value.errorReason ?? \"unexpected_settle_error\";\n    return fail(\n      reason === \"settlement_pending\" ? \"UNAVAILABLE\" : \"LIMIT\",\n      \"X402_SETTLE_REJECTED\",\n      `the facilitator did not settle the payment: ${reason}`,\n      {\n        retryable: reason === \"settlement_pending\",\n        details: {\n          reason,\n          transaction: settled.value.transaction,\n          network: settled.value.network,\n          ...(settled.value.payer === undefined ? {} : { payer: settled.value.payer }),\n        },\n      },\n    );\n  }\n  return settled;\n}\n\n/** `GET /supported`, as a `Result`. */\nexport const facilitatorSupports = (facilitator: X402FacilitatorClient): Promise<Result<SupportedResponse>> =>\n  wrap(async () => facilitator.getSupported(), (error) =>\n    tabError(\"UPSTREAM\", \"X402_FACILITATOR_UNREACHABLE\", \"the facilitator did not answer /supported\", {\n      retryable: true,\n      cause: causeOf(error),\n    }),\n  );\n\n/**\n * Checks that what the client says it accepted is what this server requires.\n *\n * The facilitator verifies the signature against the server's requirements, so\n * a mismatch would be caught there; catching it here saves the round trip and\n * names the field. `extra` and `maxTimeoutSeconds` are not compared: they are\n * the server's inputs to signing and the facilitator reads them from the\n * server's copy, never the client's.\n */\nexport function matchAccepted(accepted: PaymentRequirements, requirements: PaymentRequirements): Result<void> {\n  const mismatches: string[] = [];\n  if (accepted.scheme !== requirements.scheme) mismatches.push(`scheme ${accepted.scheme} is not ${requirements.scheme}`);\n  if (accepted.network !== requirements.network) mismatches.push(`network ${accepted.network} is not ${requirements.network}`);\n  if (accepted.asset.toLowerCase() !== requirements.asset.toLowerCase()) mismatches.push(`asset ${accepted.asset} is not ${requirements.asset}`);\n  if (accepted.payTo.toLowerCase() !== requirements.payTo.toLowerCase()) mismatches.push(`payTo ${accepted.payTo} is not ${requirements.payTo}`);\n  if (BigInt(accepted.amount) !== BigInt(requirements.amount)) mismatches.push(`amount ${accepted.amount} is not ${requirements.amount}`);\n  if (mismatches.length === 0) return ok(undefined);\n  return fail(\"LIMIT\", \"X402_ACCEPTED_MISMATCH\", `the signed payment does not match this call's requirement: ${mismatches.join(\", \")}`, {\n    retryable: false,\n    details: { mismatches: mismatches.join(\"; \") },\n  });\n}\n\n/** The response, reduced to what the billability decision needs. */\nexport interface X402DeliveredResponse {\n  readonly status: number;\n}\n\nexport interface PrepaidRequestOptions {\n  readonly facilitator: X402FacilitatorClient;\n  /** The decoded `PAYMENT-SIGNATURE`. */\n  readonly payload: PaymentPayload;\n  /** What this call costs, built by the server and never taken from the client. */\n  readonly requirements: PaymentRequirements;\n  readonly resource: ResourceInfo;\n  /** The work. Runs only after the payment verified. */\n  readonly deliver: () => Promise<Response> | Response;\n  /** Whether a response is a delivery worth settling for. Defaults to `status < 400`. */\n  readonly billable?: (response: X402DeliveredResponse) => boolean;\n  readonly logger?: Logger;\n}\n\nexport type PrepaidOutcome =\n  /** Verified, delivered, settled. The response carries `PAYMENT-RESPONSE`. */\n  | { readonly kind: \"paid\"; readonly response: Response; readonly settlement: SettleResponse; readonly payer: string | undefined }\n  /** The payment did not verify. The response is a `402` carrying `PAYMENT-REQUIRED` with the reason. */\n  | { readonly kind: \"rejected\"; readonly response: Response; readonly error: TabError }\n  /** The work was not a delivery, so nothing was settled and the handler's own response goes out. */\n  | { readonly kind: \"not-delivered\"; readonly response: Response }\n  /** The handler threw. Nothing was settled. */\n  | { readonly kind: \"handler-failed\"; readonly thrown: unknown; readonly error: TabError }\n  /** Delivered, but the facilitator would not settle. The response is a `402` carrying the failed `PAYMENT-RESPONSE`. */\n  | { readonly kind: \"settlement-failed\"; readonly response: Response; readonly error: TabError };\n\n/**\n * Takes one prepaid request through verify, deliver, settle.\n *\n * Never throws and never rejects. A thrown handler is an outcome, not an\n * exception, so a host adapter can re-raise it the way its framework expects.\n */\nexport async function handlePrepaidRequest(options: PrepaidRequestOptions): Promise<PrepaidOutcome> {\n  const logger = options.logger ?? defaultLogger;\n  const billable = options.billable ?? ((response: X402DeliveredResponse) => response.status < 400);\n  const required = paymentRequiredFor({ resource: options.resource, accepts: [options.requirements] });\n\n  const rejected = (error: TabError): PrepaidOutcome => ({\n    kind: \"rejected\",\n    response: paymentRequiredResponse({ ...required, error: error.message }, error),\n    error,\n  });\n\n  const matched = matchAccepted(options.payload.accepted, options.requirements);\n  if (!matched.ok) return rejected(matched.error);\n\n  const verified = await verifyPayment(options.facilitator, options.payload, options.requirements);\n  if (!verified.ok) return rejected(verified.error);\n\n  let response: Response;\n  try {\n    response = await options.deliver();\n  } catch (thrown) {\n    logger.debug(\"x402 prepaid call settled nothing because the handler failed\");\n    return {\n      kind: \"handler-failed\",\n      thrown,\n      error: tabError(\"INTERNAL\", \"HANDLER_FAILED\", \"the handler failed, so the verified payment was not settled\", {\n        details: { settled: false },\n        cause: causeOf(thrown),\n      }),\n    };\n  }\n\n  let deliverable: boolean;\n  try {\n    deliverable = billable(response) === true;\n  } catch (thrown) {\n    logger.error(\"x402 billable predicate threw and was read as not billable\", causeOf(thrown));\n    deliverable = false;\n  }\n  if (!deliverable) return { kind: \"not-delivered\", response };\n\n  const settled = await settlePayment(options.facilitator, options.payload, options.requirements);\n  if (!settled.ok) {\n    discard(response, logger);\n    const failure: SettleResponse = {\n      success: false,\n      errorReason: String(settled.error.details?.[\"reason\"] ?? settled.error.code),\n      transaction: String(settled.error.details?.[\"transaction\"] ?? \"\"),\n      network: options.requirements.network,\n      ...(typeof settled.error.details?.[\"payer\"] === \"string\" ? { payer: settled.error.details[\"payer\"] } : {}),\n    };\n    return { kind: \"settlement-failed\", response: settlementFailedResponse(failure, settled.error), error: settled.error };\n  }\n\n  const headers = paymentResponseHeaders(settled.value);\n  if (!headers.ok) {\n    // The funds moved and the work is delivered; a header that will not encode\n    // costs the caller the receipt and nothing else.\n    logger.error(\"x402 settlement succeeded but PAYMENT-RESPONSE would not encode\", { code: headers.error.code });\n    return { kind: \"paid\", response, settlement: settled.value, payer: settled.value.payer };\n  }\n  return { kind: \"paid\", response: withHeaders(response, headers.value, logger), settlement: settled.value, payer: settled.value.payer };\n}\n\n/** A `402` carrying `PAYMENT-REQUIRED` and a JSON body naming the error. */\nexport function paymentRequiredResponse(required: PaymentRequired, error: TabError, extraHeaders: Readonly<Record<string, string>> = {}): Response {\n  const encoded = paymentRequiredHeaders(required);\n  return new Response(JSON.stringify({ ok: false, error }), {\n    status: 402,\n    headers: {\n      ...extraHeaders,\n      ...(encoded.ok ? encoded.value : {}),\n      \"Content-Type\": \"application/json; charset=utf-8\",\n    },\n  });\n}\n\n/** A `402` carrying a failed `PAYMENT-RESPONSE`, as the HTTP transport specification shows. */\nfunction settlementFailedResponse(failure: SettleResponse, error: TabError): Response {\n  const encoded = paymentResponseHeaders(failure);\n  return new Response(JSON.stringify({ ok: false, error }), {\n    status: 402,\n    headers: { ...(encoded.ok ? encoded.value : {}), \"Content-Type\": \"application/json; charset=utf-8\" },\n  });\n}\n\n/** Puts headers on a response, copying it when its headers are immutable. */\nfunction withHeaders(response: Response, headers: Readonly<Record<string, string>>, logger: Logger): Response {\n  try {\n    for (const [name, value] of Object.entries(headers)) response.headers.set(name, value);\n    return response;\n  } catch {\n    logger.debug(\"response headers were immutable, so PAYMENT-RESPONSE went onto a copy\");\n    const merged = new Headers(response.headers);\n    for (const [name, value] of Object.entries(headers)) merged.set(name, value);\n    return new Response(response.body, { status: response.status, statusText: response.statusText, headers: merged });\n  }\n}\n\nfunction discard(response: Response, logger: Logger): void {\n  const body = response.body;\n  if (body === null || response.bodyUsed) return;\n  try {\n    body.cancel().catch((error: unknown) => logger.debug(\"discarded response body could not be cancelled\", causeOf(error)));\n  } catch (error) {\n    logger.debug(\"discarded response body could not be cancelled\", causeOf(error));\n  }\n}\n"]}

package/dist/x402/wire.d.ts

@@ -12,7 +12,7 @@
  *
  * ## What is official and what is not
  *
- * The types and the three header codecs come from `@x402/core`, the reference
+ * The types and the three header codecs come from `@x402/core`, the official
  * implementation, so a `PaymentRequired` built here is what an x402 client
  * elsewhere decodes and a `PaymentPayload` decoded here is what one sent. The
  * codecs throw on malformed input; every wrapper below turns that into a

package/dist/x402/wire.js

@@ -12,7 +12,7 @@
  *
  * ## What is official and what is not
  *
- * The types and the three header codecs come from `@x402/core`, the reference
+ * The types and the three header codecs come from `@x402/core`, the official
  * implementation, so a `PaymentRequired` built here is what an x402 client
  * elsewhere decodes and a `PaymentPayload` decoded here is what one sent. The
  * codecs throw on malformed input; every wrapper below turns that into a