kawasekit 0.1.0-beta.2 → 0.1.0-beta.3

package/dist/{chunk-ZY6RT2DB.js → chunk-CD6SQBZN.js}

@@ -1,4 +1,5 @@
-import { polygonAmoy, polygon, isSupportedChainId } from './chunk-SA7LMQFG.js';
+import { chainIdToX402Network, X402_VERSION, createInMemoryIdempotencyStore, KAWASEKIT_IDEMPOTENCY_RECORD_VERSION } from './chunk-WMFCI6KC.js';
+import { polygonAmoy, polygon } from './chunk-SA7LMQFG.js';
 import { invokeHookSafely, extractAcceptedNetworks } from './chunk-LEHWRDVS.js';
 import { isAddress, getAddress } from 'viem';
 
@@ -226,35 +227,11 @@ var X402InvalidConfigError = class extends Error {
   }
 };
 
-// src/x402/types.ts
-var X402_VERSION = 2;
-var EIP155_PREFIX = "eip155:";
-function chainIdToX402Network(chainId) {
-  return `${EIP155_PREFIX}${chainId}`;
-}
-function isX402Network(value) {
-  if (!value.startsWith(EIP155_PREFIX)) {
-    return false;
-  }
-  const rest = value.slice(EIP155_PREFIX.length);
-  if (rest.length === 0 || /^0\d/.test(rest)) {
-    return false;
-  }
-  const parsed = Number(rest);
-  if (!Number.isInteger(parsed) || parsed < 0) {
-    return false;
-  }
-  return isSupportedChainId(parsed);
-}
-function x402NetworkToChainId(network) {
-  const rest = network.slice(EIP155_PREFIX.length);
-  return Number(rest);
-}
-
 // src/x402/encoding.ts
 var X402_HEADER_PAYMENT_REQUIRED = "PAYMENT-REQUIRED";
 var X402_HEADER_PAYMENT_SIGNATURE = "PAYMENT-SIGNATURE";
 var X402_HEADER_PAYMENT_RESPONSE = "PAYMENT-RESPONSE";
+var X402_HEADER_IDEMPOTENCY_KEY = "Idempotency-Key";
 var BASE64_REGEX = /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})?$/;
 function bigIntReplacer(_key, value) {
   return typeof value === "bigint" ? value.toString() : value;
@@ -460,8 +437,168 @@ function withPaymentResponseHeader(innerResponse, settlement) {
     headers
   });
 }
+var SNAPSHOT_HEADER_ALLOWLIST = ["content-type", X402_HEADER_PAYMENT_RESPONSE];
+var IDEMPOTENCY_REPLAYED_HEADER = "Idempotency-Replayed";
+var DEFAULT_MAX_SNAPSHOT_BYTES = 64 * 1024;
+var DEFAULT_FALLBACK_TTL_SECONDS = 86400;
+function resolveIdempotency(config) {
+  if (config?.store === "none") {
+    return null;
+  }
+  return {
+    store: config?.store ?? createInMemoryIdempotencyStore(),
+    inFlight: config?.inFlight ?? "reject",
+    maxSnapshotBytes: config?.maxSnapshotBytes ?? DEFAULT_MAX_SNAPSHOT_BYTES,
+    fallbackTtlSeconds: config?.fallbackTtlSeconds ?? DEFAULT_FALLBACK_TTL_SECONDS
+  };
+}
+function bytesToBase64(bytes) {
+  let binary = "";
+  for (const b of bytes) {
+    binary += String.fromCharCode(b);
+  }
+  return btoa(binary);
+}
+function base64ToBytes(b64) {
+  const binary = atob(b64);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i += 1) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  return bytes;
+}
+function readAuthorization(payload) {
+  const inner = payload.payload;
+  if (typeof inner !== "object" || inner === null) {
+    return null;
+  }
+  const auth = inner.authorization;
+  if (typeof auth !== "object" || auth === null) {
+    return null;
+  }
+  const a = auth;
+  if (typeof a.nonce !== "string" || a.nonce === "") {
+    return null;
+  }
+  const validBefore = typeof a.validBefore === "string" && /^[0-9]+$/.test(a.validBefore) ? BigInt(a.validBefore) : 0n;
+  return { nonce: a.nonce, validBefore };
+}
+function computeServerKey(request, requirements, auth) {
+  const header = request.headers.get(X402_HEADER_IDEMPOTENCY_KEY);
+  let material;
+  if (header !== null && header !== "") {
+    material = `hdr:${header}`;
+  } else if (auth !== null) {
+    material = `nonce:${auth.nonce}`;
+  } else {
+    return null;
+  }
+  return JSON.stringify([
+    requirements.network,
+    getAddress(requirements.payTo),
+    getAddress(requirements.asset),
+    material
+  ]);
+}
+async function snapshotResponse(response, maxBytes) {
+  const contentLength = response.headers.get("content-length");
+  if (contentLength !== null && Number(contentLength) > maxBytes) {
+    return void 0;
+  }
+  const buffer = await response.clone().arrayBuffer();
+  if (buffer.byteLength > maxBytes) {
+    return void 0;
+  }
+  const headers = [];
+  for (const name of SNAPSHOT_HEADER_ALLOWLIST) {
+    const value = response.headers.get(name);
+    if (value !== null) {
+      headers.push([name, value]);
+    }
+  }
+  return { status: response.status, headers, bodyBase64: bytesToBase64(new Uint8Array(buffer)) };
+}
+function replayResponse(record) {
+  const snapshot = record.responseSnapshot;
+  if (snapshot !== void 0) {
+    const headers2 = new Headers();
+    for (const [name, value] of snapshot.headers) {
+      headers2.set(name, value);
+    }
+    headers2.set(IDEMPOTENCY_REPLAYED_HEADER, "true");
+    return new Response(base64ToBytes(snapshot.bodyBase64), { status: snapshot.status, headers: headers2 });
+  }
+  const headers = new Headers({ [IDEMPOTENCY_REPLAYED_HEADER]: "true" });
+  headers.set(
+    X402_HEADER_PAYMENT_RESPONSE,
+    encodePaymentResponseHeader({
+      success: true,
+      transaction: record.txHash,
+      network: record.network,
+      payer: record.payer,
+      amount: record.amount
+    })
+  );
+  return new Response(null, { status: 200, headers });
+}
+function buildRecord(key, settlement, requirements, validBefore, fallbackTtlSeconds, snapshot) {
+  if (settlement.transaction === "" || settlement.payer === void 0) {
+    return null;
+  }
+  const nowSec = BigInt(Math.floor(Date.now() / 1e3));
+  const expiresAt = validBefore > nowSec ? validBefore : nowSec + BigInt(fallbackTtlSeconds);
+  return {
+    kawasekitVersion: KAWASEKIT_IDEMPOTENCY_RECORD_VERSION,
+    key,
+    // settlement.transaction is the on-chain tx hash (0x-hex) the facilitator broadcast.
+    txHash: settlement.transaction,
+    payer: settlement.payer,
+    amount: settlement.amount ?? requirements.amount,
+    network: requirements.network,
+    ...snapshot !== void 0 ? { responseSnapshot: snapshot } : {},
+    expiresAt
+  };
+}
+function sleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+var IN_FLIGHT_POLL_MS = 100;
+var IN_FLIGHT_MAX_POLLS = 50;
+async function releaseLease(idem, key, lease) {
+  if (idem !== null && key !== null && lease !== null) {
+    try {
+      await idem.store.abandon(key, lease);
+    } catch {
+    }
+  }
+}
+async function resolveInFlight(idem, key) {
+  if (idem.inFlight !== "await") {
+    return null;
+  }
+  for (let i = 0; i < IN_FLIGHT_MAX_POLLS; i += 1) {
+    await sleep(IN_FLIGHT_POLL_MS);
+    let lookup;
+    try {
+      lookup = await idem.store.begin(key);
+    } catch {
+      return null;
+    }
+    if (lookup.status === "completed") {
+      return lookup.record;
+    }
+    if (lookup.status === "fresh") {
+      await releaseLease(idem, key, lookup.lease);
+      return null;
+    }
+  }
+  return null;
+}
 function createX402Handler(params) {
   const { facilitator, requirementsFor, handler, resourceFor, hooks } = params;
+  const idempotency = resolveIdempotency(params.idempotency);
   return async function x402Handler(request) {
     const startedAtMs = Date.now();
     const emitPaymentRequired = (reqs, error) => {
@@ -517,6 +654,28 @@ function createX402Handler(params) {
     if (!verifyResult.isValid) {
       return emitPaymentRequired(requirements, verifyResult.invalidReason ?? "verify failed");
     }
+    const auth = readAuthorization(paymentPayload);
+    const idemKey = idempotency !== null ? computeServerKey(request, matchedRequirements, auth) : null;
+    let lease = null;
+    if (idempotency !== null && idemKey !== null) {
+      let lookup;
+      try {
+        lookup = await idempotency.store.begin(idemKey);
+      } catch (cause) {
+        return internalError("idempotency_store_failed", cause);
+      }
+      if (lookup.status === "completed") {
+        return replayResponse(lookup.record);
+      }
+      if (lookup.status === "in_flight") {
+        const awaited = await resolveInFlight(idempotency, idemKey);
+        if (awaited !== null) {
+          return replayResponse(awaited);
+        }
+        return emitPaymentRequired(requirements, "payment_in_progress");
+      }
+      lease = lookup.lease;
+    }
     let settleResult;
     try {
       settleResult = await facilitator.settle({
@@ -525,9 +684,11 @@ function createX402Handler(params) {
         paymentRequirements: matchedRequirements
       });
     } catch (cause) {
+      await releaseLease(idempotency, idemKey, lease);
       return internalError("facilitator_settle_failed", cause);
     }
     if (!settleResult.success) {
+      await releaseLease(idempotency, idemKey, lease);
       return emitPaymentRequired(requirements, settleResult.errorReason ?? "settle failed");
     }
     if (settleResult.payer !== void 0) {
@@ -549,10 +710,30 @@ function createX402Handler(params) {
       settlement: settleResult
     };
     const innerResponse = await handler(request, context);
-    return withPaymentResponseHeader(innerResponse, settleResult);
+    const finalResponse = withPaymentResponseHeader(innerResponse, settleResult);
+    if (idempotency !== null && idemKey !== null && lease !== null) {
+      const snapshot = await snapshotResponse(finalResponse, idempotency.maxSnapshotBytes);
+      const record = buildRecord(
+        idemKey,
+        settleResult,
+        matchedRequirements,
+        auth?.validBefore ?? 0n,
+        idempotency.fallbackTtlSeconds,
+        snapshot
+      );
+      if (record !== null) {
+        try {
+          await idempotency.store.complete(idemKey, record, lease);
+        } catch {
+        }
+      } else {
+        await releaseLease(idempotency, idemKey, lease);
+      }
+    }
+    return finalResponse;
   };
 }
 
-export { JPYC_DECIMALS, JPYC_EIP712_DOMAIN_HINT, JPYC_V2_ADDRESS, JpycNotAvailableError, X402InvalidConfigError, X402InvalidPayloadError, X402_DEFAULT_MAX_TIMEOUT_SECONDS, X402_HEADER_PAYMENT_REQUIRED, X402_HEADER_PAYMENT_RESPONSE, X402_HEADER_PAYMENT_SIGNATURE, X402_VERSION, buildPaymentRequiredResponse, buildPaymentRequirements, chainIdToX402Network, createX402Handler, decodePaymentRequiredHeader, decodePaymentResponseHeader, decodePaymentSignatureHeader, encodePaymentRequiredHeader, encodePaymentResponseHeader, encodePaymentSignatureHeader, getJpycAddress, isX402Network, jpycAbi, jpycDeployments, x402NetworkToChainId };
-//# sourceMappingURL=chunk-ZY6RT2DB.js.map
-//# sourceMappingURL=chunk-ZY6RT2DB.js.map
+export { JPYC_DECIMALS, JPYC_EIP712_DOMAIN_HINT, JPYC_V2_ADDRESS, JpycNotAvailableError, X402InvalidConfigError, X402InvalidPayloadError, X402_DEFAULT_MAX_TIMEOUT_SECONDS, X402_HEADER_IDEMPOTENCY_KEY, X402_HEADER_PAYMENT_REQUIRED, X402_HEADER_PAYMENT_RESPONSE, X402_HEADER_PAYMENT_SIGNATURE, buildPaymentRequiredResponse, buildPaymentRequirements, createX402Handler, decodePaymentRequiredHeader, decodePaymentResponseHeader, decodePaymentSignatureHeader, encodePaymentRequiredHeader, encodePaymentResponseHeader, encodePaymentSignatureHeader, getJpycAddress, jpycAbi, jpycDeployments };
+//# sourceMappingURL=chunk-CD6SQBZN.js.map
+//# sourceMappingURL=chunk-CD6SQBZN.js.map

package/dist/chunk-CD6SQBZN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tokens/jpyc.ts","../src/x402/errors.ts","../src/x402/encoding.ts","../src/x402/payment-requirements.ts","../src/x402/server.ts"],"names":["getAddress","headers"],"mappings":"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","file":"chunk-CD6SQBZN.js","sourcesContent":["/**\n * JPYC stablecoin metadata, deployments, and ABI.\n *\n * JPYC is a Japanese yen-pegged stablecoin issued by JPYC Inc. under the\n * revised Payment Services Act as 電子決済手段 (electronic payment\n * instrument). The new (\"v2\") JPYC, launched 2025-10, lives at the same\n * address on every chain where it is deployed.\n *\n * @packageDocumentation\n */\n\nimport type { Address } from \"viem\";\nimport type { SupportedChainId } from \"../chains\";\nimport { polygon, polygonAmoy } from \"../chains\";\n\n/** ERC-20 decimals for JPYC. Constant across every chain. */\nexport const JPYC_DECIMALS = 18;\n\n/**\n * EIP-712 domain hint for off-chain authorization signing (EIP-3009, EIP-2612).\n *\n * The real JPYC contract does not expose `version()` publicly — it lives in an\n * `internal VERSION` state variable set during proxy initialization. The\n * canonical value is `\"1\"`, matching the FiatToken lineage; the\n * {@link signTransferWithAuthorization} helper accepts an override if a future\n * deployment changes this.\n *\n * `name` is \"JPY Coin\" — the on-chain `name()` value on every live deployment.\n */\nexport const JPYC_EIP712_DOMAIN_HINT = {\n\tname: \"JPY Coin\",\n\tversion: \"1\",\n} as const;\n\n/**\n * Address shared by every live JPYC deployment.\n *\n * Verified on:\n * - Ethereum  : https://etherscan.io/token/0xE7C3D8C9a439feDe00D2600032D5dB0Be71C3c29\n * - Polygon   : https://polygonscan.com/token/0xe7c3d8c9a439fede00d2600032d5db0be71c3c29\n * - Polygon Amoy : https://amoy.polygonscan.com/token/0xe7c3d8c9a439fede00d2600032d5db0be71c3c29\n * - Avalanche : https://snowtrace.io/token/0xE7C3D8C9a439feDe00D2600032D5dB0Be71C3c29\n *\n * Do NOT confuse with the legacy 前払式支払手段 JPYC at `0x431D5dFF...`.\n */\nexport const JPYC_V2_ADDRESS: Address = \"0xE7C3D8C9a439feDe00D2600032D5dB0Be71C3c29\";\n\n/** A JPYC deployment on a single chain. */\nexport interface JpycDeployment {\n\treadonly chainId: SupportedChainId;\n\treadonly address: Address;\n\t/** `true` if the token is live on this chain right now. */\n\treadonly isLive: boolean;\n}\n\n/**\n * JPYC deployments keyed by chain.\n *\n * Only chains in {@link SupportedChainId} appear here — adding Avalanche /\n * Ethereum requires first adding them to `src/chains/`.\n */\nexport const jpycDeployments: { readonly [chainId in SupportedChainId]: JpycDeployment } = {\n\t[polygon.id]: { chainId: polygon.id, address: JPYC_V2_ADDRESS, isLive: true },\n\t[polygonAmoy.id]: { chainId: polygonAmoy.id, address: JPYC_V2_ADDRESS, isLive: true },\n};\n\n/**\n * Thrown when JPYC is not deployed on the requested chain.\n *\n * Today this is unreachable (every {@link SupportedChainId} has a live\n * deployment), but the error class is exported for future chains (Kaia) where\n * JPYC is still in development.\n */\nexport class JpycNotAvailableError extends Error {\n\tconstructor(chainId: number) {\n\t\tsuper(`JPYC is not yet deployed on chain ID ${chainId}.`);\n\t\tthis.name = \"JpycNotAvailableError\";\n\t}\n}\n\n/**\n * Returns the JPYC contract address for a kawasekit-supported chain.\n *\n * @param chainId - A {@link SupportedChainId}.\n * @returns The JPYC contract address on that chain.\n * @throws {JpycNotAvailableError} If JPYC is not live on the chain.\n *\n * @example\n * ```ts\n * import { getJpycAddress, polygonAmoy } from \"kawasekit\";\n *\n * const address = getJpycAddress(polygonAmoy.id);\n * ```\n */\nexport function getJpycAddress(chainId: SupportedChainId): Address {\n\tconst deployment = jpycDeployments[chainId];\n\tif (!deployment.isLive) {\n\t\tthrow new JpycNotAvailableError(chainId);\n\t}\n\treturn deployment.address;\n}\n\n/**\n * Minimal JPYC ABI: ERC-20 + EIP-3009 surface that kawasekit needs.\n *\n * Excludes permit / mint / blocklist / pause — kawasekit only reads balance,\n * sends `transfer()` via UserOp, and constructs / submits EIP-3009\n * authorizations. Bringing in the full FiatTokenV1 ABI would be wasted bytes.\n */\nexport const jpycAbi = [\n\t// ----- ERC-20 read -----\n\t{\n\t\ttype: \"function\",\n\t\tname: \"name\",\n\t\tstateMutability: \"view\",\n\t\tinputs: [],\n\t\toutputs: [{ name: \"\", type: \"string\" }],\n\t},\n\t{\n\t\ttype: \"function\",\n\t\tname: \"symbol\",\n\t\tstateMutability: \"view\",\n\t\tinputs: [],\n\t\toutputs: [{ name: \"\", type: \"string\" }],\n\t},\n\t{\n\t\ttype: \"function\",\n\t\tname: \"decimals\",\n\t\tstateMutability: \"view\",\n\t\tinputs: [],\n\t\toutputs: [{ name: \"\", type: \"uint8\" }],\n\t},\n\t{\n\t\ttype: \"function\",\n\t\tname: \"totalSupply\",\n\t\tstateMutability: \"view\",\n\t\tinputs: [],\n\t\toutputs: [{ name: \"\", type: \"uint256\" }],\n\t},\n\t{\n\t\ttype: \"function\",\n\t\tname: \"balanceOf\",\n\t\tstateMutability: \"view\",\n\t\tinputs: [{ name: \"account\", type: \"address\" }],\n\t\toutputs: [{ name: \"\", type: \"uint256\" }],\n\t},\n\t{\n\t\ttype: \"function\",\n\t\tname: \"allowance\",\n\t\tstateMutability: \"view\",\n\t\tinputs: [\n\t\t\t{ name: \"owner\", type: \"address\" },\n\t\t\t{ name: \"spender\", type: \"address\" },\n\t\t],\n\t\toutputs: [{ name: \"\", type: \"uint256\" }],\n\t},\n\t// ----- ERC-20 write -----\n\t{\n\t\ttype: \"function\",\n\t\tname: \"transfer\",\n\t\tstateMutability: \"nonpayable\",\n\t\tinputs: [\n\t\t\t{ name: \"to\", type: \"address\" },\n\t\t\t{ name: \"value\", type: \"uint256\" },\n\t\t],\n\t\toutputs: [{ name: \"\", type: \"bool\" }],\n\t},\n\t{\n\t\ttype: \"function\",\n\t\tname: \"transferFrom\",\n\t\tstateMutability: \"nonpayable\",\n\t\tinputs: [\n\t\t\t{ name: \"from\", type: \"address\" },\n\t\t\t{ name: \"to\", type: \"address\" },\n\t\t\t{ name: \"value\", type: \"uint256\" },\n\t\t],\n\t\toutputs: [{ name: \"\", type: \"bool\" }],\n\t},\n\t{\n\t\ttype: \"function\",\n\t\tname: \"approve\",\n\t\tstateMutability: \"nonpayable\",\n\t\tinputs: [\n\t\t\t{ name: \"spender\", type: \"address\" },\n\t\t\t{ name: \"value\", type: \"uint256\" },\n\t\t],\n\t\toutputs: [{ name: \"\", type: \"bool\" }],\n\t},\n\t// ----- EIP-3009 -----\n\t{\n\t\ttype: \"function\",\n\t\tname: \"transferWithAuthorization\",\n\t\tstateMutability: \"nonpayable\",\n\t\tinputs: [\n\t\t\t{ name: \"from\", type: \"address\" },\n\t\t\t{ name: \"to\", type: \"address\" },\n\t\t\t{ name: \"value\", type: \"uint256\" },\n\t\t\t{ name: \"validAfter\", type: \"uint256\" },\n\t\t\t{ name: \"validBefore\", type: \"uint256\" },\n\t\t\t{ name: \"nonce\", type: \"bytes32\" },\n\t\t\t{ name: \"v\", type: \"uint8\" },\n\t\t\t{ name: \"r\", type: \"bytes32\" },\n\t\t\t{ name: \"s\", type: \"bytes32\" },\n\t\t],\n\t\toutputs: [],\n\t},\n\t{\n\t\ttype: \"function\",\n\t\tname: \"receiveWithAuthorization\",\n\t\tstateMutability: \"nonpayable\",\n\t\tinputs: [\n\t\t\t{ name: \"from\", type: \"address\" },\n\t\t\t{ name: \"to\", type: \"address\" },\n\t\t\t{ name: \"value\", type: \"uint256\" },\n\t\t\t{ name: \"validAfter\", type: \"uint256\" },\n\t\t\t{ name: \"validBefore\", type: \"uint256\" },\n\t\t\t{ name: \"nonce\", type: \"bytes32\" },\n\t\t\t{ name: \"v\", type: \"uint8\" },\n\t\t\t{ name: \"r\", type: \"bytes32\" },\n\t\t\t{ name: \"s\", type: \"bytes32\" },\n\t\t],\n\t\toutputs: [],\n\t},\n\t{\n\t\ttype: \"function\",\n\t\tname: \"cancelAuthorization\",\n\t\tstateMutability: \"nonpayable\",\n\t\tinputs: [\n\t\t\t{ name: \"authorizer\", type: \"address\" },\n\t\t\t{ name: \"nonce\", type: \"bytes32\" },\n\t\t\t{ name: \"v\", type: \"uint8\" },\n\t\t\t{ name: \"r\", type: \"bytes32\" },\n\t\t\t{ name: \"s\", type: \"bytes32\" },\n\t\t],\n\t\toutputs: [],\n\t},\n\t{\n\t\ttype: \"function\",\n\t\tname: \"authorizationState\",\n\t\tstateMutability: \"view\",\n\t\tinputs: [\n\t\t\t{ name: \"authorizer\", type: \"address\" },\n\t\t\t{ name: \"nonce\", type: \"bytes32\" },\n\t\t],\n\t\toutputs: [{ name: \"\", type: \"bool\" }],\n\t},\n\t// ----- Events kawasekit needs to decode -----\n\t{\n\t\ttype: \"event\",\n\t\tname: \"Transfer\",\n\t\tinputs: [\n\t\t\t{ name: \"from\", type: \"address\", indexed: true },\n\t\t\t{ name: \"to\", type: \"address\", indexed: true },\n\t\t\t{ name: \"value\", type: \"uint256\", indexed: false },\n\t\t],\n\t},\n\t{\n\t\ttype: \"event\",\n\t\tname: \"Approval\",\n\t\tinputs: [\n\t\t\t{ name: \"owner\", type: \"address\", indexed: true },\n\t\t\t{ name: \"spender\", type: \"address\", indexed: true },\n\t\t\t{ name: \"value\", type: \"uint256\", indexed: false },\n\t\t],\n\t},\n\t{\n\t\ttype: \"event\",\n\t\tname: \"AuthorizationUsed\",\n\t\tinputs: [\n\t\t\t{ name: \"authorizer\", type: \"address\", indexed: true },\n\t\t\t{ name: \"nonce\", type: \"bytes32\", indexed: true },\n\t\t],\n\t},\n\t{\n\t\ttype: \"event\",\n\t\tname: \"AuthorizationCanceled\",\n\t\tinputs: [\n\t\t\t{ name: \"authorizer\", type: \"address\", indexed: true },\n\t\t\t{ name: \"nonce\", type: \"bytes32\", indexed: true },\n\t\t],\n\t},\n] as const;\n","/**\n * Typed errors thrown by the `kawasekit/x402` modules.\n *\n * Centralised so that consumers can `instanceof`-discriminate without importing\n * deep paths. Additional error classes are added here as the corresponding\n * modules come online (server, facilitator, …).\n *\n * @packageDocumentation\n */\n\n/**\n * Thrown when an x402 wire-format payload is malformed: invalid base64, invalid\n * JSON, or a value that cannot represent the expected schema.\n *\n * Carries the offending header / context name so callers can produce actionable\n * log lines without re-parsing the message string.\n *\n * @example\n * ```ts\n * import { decodePaymentSignatureHeader, X402InvalidPayloadError } from \"kawasekit\";\n *\n * try {\n *   decodePaymentSignatureHeader(headerValue);\n * } catch (error) {\n *   if (error instanceof X402InvalidPayloadError) {\n *     console.warn(`reject ${error.context}: ${error.reason}`);\n *   }\n * }\n * ```\n */\nexport class X402InvalidPayloadError extends Error {\n\t/** Logical name of the payload that failed (e.g. `\"PAYMENT-SIGNATURE\"`). */\n\treadonly context: string;\n\t/** Short machine-readable reason code. */\n\treadonly reason: string;\n\n\tconstructor(context: string, reason: string, options?: { cause?: unknown }) {\n\t\tsuper(`Invalid ${context} payload: ${reason}`, options);\n\t\tthis.name = \"X402InvalidPayloadError\";\n\t\tthis.context = context;\n\t\tthis.reason = reason;\n\t}\n}\n\n/**\n * Thrown when an x402 SDK construction-time configuration is invalid: an\n * unknown `asset.kind`, a known asset id that kawasekit does not ship a\n * domain for, missing required fields on an `unsafeOverride`, etc.\n *\n * Distinct from {@link X402InvalidPayloadError} (which describes wire-format\n * problems): config errors are integrator bugs, not adversarial inputs.\n *\n * @example\n * ```ts\n * import { createX402PaymentSigner, X402InvalidConfigError } from \"kawasekit\";\n *\n * try {\n *   createX402PaymentSigner({\n *     network: \"testnet\",\n *     account,\n *     // @ts-expect-error — kind: \"foo\" is not a known kind\n *     asset: { kind: \"foo\" },\n *   });\n * } catch (error) {\n *   if (error instanceof X402InvalidConfigError) {\n *     console.error(`${error.field}: ${error.reason}`);\n *   }\n * }\n * ```\n */\nexport class X402InvalidConfigError extends Error {\n\t/** Logical name of the config field that failed (e.g. `\"asset\"`). */\n\treadonly field: string;\n\t/** Short machine-readable reason code. */\n\treadonly reason: string;\n\n\tconstructor(field: string, reason: string, options?: { cause?: unknown }) {\n\t\tsuper(`Invalid ${field} config: ${reason}`, options);\n\t\tthis.name = \"X402InvalidConfigError\";\n\t\tthis.field = field;\n\t\tthis.reason = reason;\n\t}\n}\n","/**\n * Wire-format encoding for x402 v2 headers.\n *\n * Three pairs of `encode*` / `decode*` helpers, one per x402 v2 HTTP header:\n *\n * | Direction        | Header              | Payload type                     |\n * | ---------------- | ------------------- | -------------------------------- |\n * | server → client  | `PAYMENT-REQUIRED`  | {@link X402PaymentRequiredResponse} |\n * | client → server  | `PAYMENT-SIGNATURE` | {@link X402PaymentPayload}          |\n * | server → client  | `PAYMENT-RESPONSE`  | {@link X402SettlementResponse}      |\n *\n * Encoding rules (match `@x402/core@2.13.0` byte-for-byte so kawasekit payloads\n * decode in any spec-compliant client / facilitator):\n *\n * - The payload is JSON-stringified, then UTF-8 → base64 encoded.\n * - **Standard base64** with `+` / `/` and `=` padding, **not** URL-safe base64.\n *   (Header values flow through `Authorization`-style positions where `+` is\n *   acceptable in the v2 spec.)\n * - The replacer used by `JSON.stringify` rewrites any stray `bigint` value to\n *   its decimal string form, so kawasekit callers can hand a payload whose\n *   `value` / `validAfter` / `validBefore` are bigints by mistake and the\n *   encoder still produces a spec-conformant string — silent corruption\n *   surfaces as a type error in `tsc`, not a runtime crash.\n *\n * Decoders are intentionally minimal: base64 syntax check + `JSON.parse` + a\n * \"must be a plain object\" sanity check. Schema-level validation lives one\n * layer up (in `server.ts` and `client.ts`) so that this module stays a small,\n * dependency-free wire codec.\n *\n * @packageDocumentation\n */\n\nimport { X402InvalidPayloadError } from \"./errors\";\nimport type {\n\tX402PaymentPayload,\n\tX402PaymentRequiredResponse,\n\tX402SettlementResponse,\n} from \"./types\";\n\n// ---------------------------------------------------------------------------\n// HTTP header names (x402 v2 transport spec)\n// ---------------------------------------------------------------------------\n\n/**\n * Name of the response header that carries the base64-encoded\n * {@link X402PaymentRequiredResponse} alongside the HTTP 402 status.\n */\nexport const X402_HEADER_PAYMENT_REQUIRED = \"PAYMENT-REQUIRED\" as const;\n\n/**\n * Name of the request header that carries the client's base64-encoded\n * {@link X402PaymentPayload}.\n *\n * Note: x402 v1 used `X-PAYMENT`. v2 drops the `X-` prefix. Servers may accept\n * both during transition; clients should send only this v2 name.\n */\nexport const X402_HEADER_PAYMENT_SIGNATURE = \"PAYMENT-SIGNATURE\" as const;\n\n/**\n * Name of the response header that carries the base64-encoded\n * {@link X402SettlementResponse} after a successful settlement.\n */\nexport const X402_HEADER_PAYMENT_RESPONSE = \"PAYMENT-RESPONSE\" as const;\n\n/**\n * Name of the optional request header that carries a reasoning-step idempotency\n * key (M5-1). Standard `Idempotency-Key` (IETF draft / Stripe-compatible). When\n * present, the x402 server deduplicates on this logical key; the EIP-3009 nonce\n * remains the on-chain fund backstop. See `docs/rfc/m5-1-reasoning-step-idempotency.md`.\n */\nexport const X402_HEADER_IDEMPOTENCY_KEY = \"Idempotency-Key\" as const;\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\n// Canonical base64 per RFC 4648 §4: encoded length is a multiple of 4 and the\n// only legal trailing forms are `XX==`, `XXX=`, or `XXXX` (no padding). The\n// outer prefix is zero or more 4-char groups; the optional inner alternation\n// matches a single final group of 4 chars or a properly padded 2-or-3 char\n// group. This shape rejects the non-canonical forms an adversary could try\n// to smuggle past the decoder — overlong padding (`X===`), misplaced padding\n// (`X=XX`), short tails (`XXX` with no `=`), or non-mod-4 lengths.\n//\n// See `docs/THREAT_MODEL.md` §6.7 for the M4 review trail and\n// `src/x402/encoding.test.ts` \"RFC 4648 canonical enforcement\" for the\n// adversarial corpus.\n/**\n * Strict RFC 4648 §4 canonical base64 matcher. Exported for the\n * property-based test in `encoding.test.ts` (Threat 1.7 / §6.7\n * regex-vs-decoder agreement); not intended as part of the public API.\n *\n * @internal\n */\nexport const BASE64_REGEX =\n\t/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{4})?$/;\n\nfunction bigIntReplacer(_key: string, value: unknown): unknown {\n\treturn typeof value === \"bigint\" ? value.toString() : value;\n}\n\nfunction stringifyBigIntSafe(value: unknown): string {\n\treturn JSON.stringify(value, bigIntReplacer);\n}\n\nfunction utf8ToBase64(input: string): string {\n\t// Cross-env: prefer `btoa` (browsers, Workers, Bun, modern Node 18+) and\n\t// fall back to `Buffer` for older Node where `btoa` was Latin-1-only.\n\tif (typeof globalThis.btoa === \"function\") {\n\t\tconst bytes = new TextEncoder().encode(input);\n\t\tlet binary = \"\";\n\t\tfor (const byte of bytes) {\n\t\t\tbinary += String.fromCharCode(byte);\n\t\t}\n\t\treturn globalThis.btoa(binary);\n\t}\n\treturn Buffer.from(input, \"utf8\").toString(\"base64\");\n}\n\n/**\n * Internal helper exported for the regex-vs-decoder property-based test.\n * Not part of the public API.\n *\n * @internal\n */\nexport function base64ToUtf8(input: string): string {\n\tif (typeof globalThis.atob === \"function\") {\n\t\tconst binary = globalThis.atob(input);\n\t\tconst bytes = new Uint8Array(binary.length);\n\t\tfor (let i = 0; i < binary.length; i++) {\n\t\t\tbytes[i] = binary.charCodeAt(i);\n\t\t}\n\t\treturn new TextDecoder(\"utf-8\").decode(bytes);\n\t}\n\treturn Buffer.from(input, \"base64\").toString(\"utf8\");\n}\n\nfunction decodeHeader<T>(headerName: string, headerValue: string): T {\n\tif (!BASE64_REGEX.test(headerValue)) {\n\t\tthrow new X402InvalidPayloadError(headerName, \"header is not valid base64\");\n\t}\n\tlet json: string;\n\ttry {\n\t\tjson = base64ToUtf8(headerValue);\n\t} catch (cause) {\n\t\tthrow new X402InvalidPayloadError(headerName, \"base64 decode failed\", { cause });\n\t}\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(json);\n\t} catch (cause) {\n\t\tthrow new X402InvalidPayloadError(headerName, \"decoded value is not valid JSON\", { cause });\n\t}\n\tif (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n\t\tthrow new X402InvalidPayloadError(headerName, \"decoded value is not a JSON object\");\n\t}\n\treturn parsed as T;\n}\n\n// ---------------------------------------------------------------------------\n// PAYMENT-REQUIRED\n// ---------------------------------------------------------------------------\n\n/**\n * Encodes an {@link X402PaymentRequiredResponse} as a base64 string suitable\n * for the `PAYMENT-REQUIRED` response header.\n *\n * @example\n * ```ts\n * import { encodePaymentRequiredHeader } from \"kawasekit\";\n *\n * const headerValue = encodePaymentRequiredHeader({\n *   x402Version: 2,\n *   resource: { url: \"https://api.example.com/data\" },\n *   accepts: [],\n * });\n * res.setHeader(\"PAYMENT-REQUIRED\", headerValue);\n * ```\n */\nexport function encodePaymentRequiredHeader(payload: X402PaymentRequiredResponse): string {\n\treturn utf8ToBase64(stringifyBigIntSafe(payload));\n}\n\n/**\n * Decodes a `PAYMENT-REQUIRED` header value.\n *\n * @throws {X402InvalidPayloadError} If the header is not valid base64 / JSON /\n *   object.\n */\nexport function decodePaymentRequiredHeader(headerValue: string): X402PaymentRequiredResponse {\n\treturn decodeHeader<X402PaymentRequiredResponse>(X402_HEADER_PAYMENT_REQUIRED, headerValue);\n}\n\n// ---------------------------------------------------------------------------\n// PAYMENT-SIGNATURE\n// ---------------------------------------------------------------------------\n\n/**\n * Encodes an {@link X402PaymentPayload} as a base64 string suitable for the\n * `PAYMENT-SIGNATURE` request header.\n *\n * @example\n * ```ts\n * import { encodePaymentSignatureHeader } from \"kawasekit\";\n *\n * const headerValue = encodePaymentSignatureHeader(paymentPayload);\n * await fetch(url, { headers: { \"PAYMENT-SIGNATURE\": headerValue } });\n * ```\n */\nexport function encodePaymentSignatureHeader(payload: X402PaymentPayload): string {\n\treturn utf8ToBase64(stringifyBigIntSafe(payload));\n}\n\n/**\n * Decodes a `PAYMENT-SIGNATURE` header value.\n *\n * @throws {X402InvalidPayloadError} If the header is not valid base64 / JSON /\n *   object.\n */\nexport function decodePaymentSignatureHeader(headerValue: string): X402PaymentPayload {\n\treturn decodeHeader<X402PaymentPayload>(X402_HEADER_PAYMENT_SIGNATURE, headerValue);\n}\n\n// ---------------------------------------------------------------------------\n// PAYMENT-RESPONSE\n// ---------------------------------------------------------------------------\n\n/**\n * Encodes an {@link X402SettlementResponse} as a base64 string suitable for\n * the `PAYMENT-RESPONSE` response header.\n */\nexport function encodePaymentResponseHeader(payload: X402SettlementResponse): string {\n\treturn utf8ToBase64(stringifyBigIntSafe(payload));\n}\n\n/**\n * Decodes a `PAYMENT-RESPONSE` header value.\n *\n * @throws {X402InvalidPayloadError} If the header is not valid base64 / JSON /\n *   object.\n */\nexport function decodePaymentResponseHeader(headerValue: string): X402SettlementResponse {\n\treturn decodeHeader<X402SettlementResponse>(X402_HEADER_PAYMENT_RESPONSE, headerValue);\n}\n","/**\n * Server-side builders for x402 v2 `PAYMENT-REQUIRED` payloads.\n *\n * `buildPaymentRequirements()` produces one accepted-payment entry; servers\n * call it once per (chain × asset) they want to advertise. `buildPaymentRequiredResponse()`\n * wraps a list of those entries into the full body the server returns alongside\n * an HTTP 402 status (typically also encoded into the `PAYMENT-REQUIRED`\n * header — see `src/x402/encoding.ts`).\n *\n * These factories live on the **server** side. The mirror-image client-side\n * factory is `createX402PaymentSigner()` in `client.ts`.\n *\n * @packageDocumentation\n */\n\nimport type { Address } from \"viem\";\nimport { getAddress, isAddress } from \"viem\";\nimport type { SupportedChainId } from \"../chains\";\nimport { JPYC_V2_ADDRESS } from \"../tokens/jpyc\";\nimport { X402InvalidPayloadError } from \"./errors\";\nimport type {\n\tX402PaymentRequiredResponse,\n\tX402PaymentRequirements,\n\tX402ResourceInfo,\n} from \"./types\";\nimport { chainIdToX402Network, X402_VERSION } from \"./types\";\n\n// ---------------------------------------------------------------------------\n// Defaults\n// ---------------------------------------------------------------------------\n\n/**\n * Default value for `maxTimeoutSeconds` when {@link BuildPaymentRequirementsParams.maxTimeoutSeconds}\n * is not supplied. Matches the x402 spec example for short-lived authorizations.\n *\n * Increase to 300 (the client-side default) when targeting Polygon Amoy in the\n * M3 demo — bundler inclusion latency can spike above 60 s on testnet.\n */\nexport const X402_DEFAULT_MAX_TIMEOUT_SECONDS = 60;\n\n/** Default `extra` payload kawasekit injects when the asset is JPYC. */\nconst JPYC_EXACT_EVM_EXTRA = {\n\tassetTransferMethod: \"eip3009\",\n\tname: \"JPY Coin\",\n\tversion: \"1\",\n} as const;\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Parameters for {@link buildPaymentRequirements}. */\nexport interface BuildPaymentRequirementsParams {\n\t/** Numeric chain ID; converted to the CAIP-2 `eip155:{chainId}` form. */\n\treadonly chainId: SupportedChainId;\n\t/** ERC-20 contract address of the token to be transferred. */\n\treadonly asset: Address;\n\t/** Recipient wallet address. */\n\treadonly payTo: Address;\n\t/** Atomic-unit amount. Accepts `bigint` (preferred) or a decimal `string`. */\n\treadonly amount: bigint | string;\n\t/**\n\t * Optional. Defaults to {@link X402_DEFAULT_MAX_TIMEOUT_SECONDS}.\n\t *\n\t * The maximum wall-clock time the client may take to produce a signed\n\t * payload after receiving this 402 response.\n\t */\n\treadonly maxTimeoutSeconds?: number;\n\t/**\n\t * Optional explicit `extra` payload. When omitted and `asset` is JPYC,\n\t * kawasekit injects a default `{ assetTransferMethod: \"eip3009\", name: \"JPY Coin\", version: \"1\" }`.\n\t * For non-JPYC assets `extra` is required (the client needs at least\n\t * `name` / `version` to reconstruct the EIP-712 domain).\n\t */\n\treadonly extra?: Record<string, unknown>;\n}\n\n/** Parameters for {@link buildPaymentRequiredResponse}. */\nexport interface BuildPaymentRequiredResponseParams {\n\t/** The protected resource the client is being asked to pay for. */\n\treadonly resource: X402ResourceInfo;\n\t/** One or more acceptable payment methods. */\n\treadonly accepts: readonly X402PaymentRequirements[];\n\t/** Optional human-readable reason for the 402, echoed in the response body. */\n\treadonly error?: string;\n\t/** Optional protocol extensions (advanced; rarely set). */\n\treadonly extensions?: Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nconst UINT256_MAX = (1n << 256n) - 1n;\nconst UINT256_DECIMAL = /^(0|[1-9][0-9]*)$/;\n\nfunction coerceAmount(amount: bigint | string): string {\n\tif (typeof amount === \"bigint\") {\n\t\tif (amount <= 0n) {\n\t\t\tthrow new X402InvalidPayloadError(\n\t\t\t\t\"PaymentRequirements\",\n\t\t\t\t`\\`amount\\` must be positive, got ${amount}`,\n\t\t\t);\n\t\t}\n\t\tif (amount > UINT256_MAX) {\n\t\t\tthrow new X402InvalidPayloadError(\n\t\t\t\t\"PaymentRequirements\",\n\t\t\t\t`\\`amount\\` exceeds uint256, got ${amount}`,\n\t\t\t);\n\t\t}\n\t\treturn amount.toString();\n\t}\n\tif (!UINT256_DECIMAL.test(amount)) {\n\t\tthrow new X402InvalidPayloadError(\n\t\t\t\"PaymentRequirements\",\n\t\t\t`\\`amount\\` must be a non-negative decimal string, got ${JSON.stringify(amount)}`,\n\t\t);\n\t}\n\tconst parsed = BigInt(amount);\n\tif (parsed === 0n) {\n\t\tthrow new X402InvalidPayloadError(\"PaymentRequirements\", \"`amount` must be positive\");\n\t}\n\tif (parsed > UINT256_MAX) {\n\t\tthrow new X402InvalidPayloadError(\n\t\t\t\"PaymentRequirements\",\n\t\t\t`\\`amount\\` exceeds uint256, got ${amount}`,\n\t\t);\n\t}\n\treturn amount;\n}\n\nfunction assertAddress(value: string, field: string): Address {\n\tif (!isAddress(value, { strict: false })) {\n\t\tthrow new X402InvalidPayloadError(\n\t\t\t\"PaymentRequirements\",\n\t\t\t`\\`${field}\\` is not a valid address: ${value}`,\n\t\t);\n\t}\n\treturn value as Address;\n}\n\nfunction resolveExtra(\n\tasset: Address,\n\texplicit: Record<string, unknown> | undefined,\n): Record<string, unknown> {\n\tif (explicit) {\n\t\treturn explicit;\n\t}\n\tif (getAddress(asset) === getAddress(JPYC_V2_ADDRESS)) {\n\t\treturn { ...JPYC_EXACT_EVM_EXTRA };\n\t}\n\tthrow new X402InvalidPayloadError(\n\t\t\"PaymentRequirements\",\n\t\t\"`extra` is required for non-JPYC assets (clients need at least `name` and `version` for EIP-712 domain reconstruction)\",\n\t);\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Builds one {@link X402PaymentRequirements} entry suitable for the `accepts`\n * array of a `PAYMENT-REQUIRED` response.\n *\n * @example Single-chain JPYC (defaults extra automatically)\n * ```ts\n * import { parseUnits } from \"viem\";\n * import {\n *   buildPaymentRequirements,\n *   JPYC_DECIMALS,\n *   JPYC_V2_ADDRESS,\n *   polygonAmoy,\n * } from \"kawasekit\";\n *\n * const requirements = buildPaymentRequirements({\n *   chainId: polygonAmoy.id,\n *   asset: JPYC_V2_ADDRESS,\n *   payTo: \"0x209693Bc6afc0C5328bA36FaF03C514EF312287C\",\n *   amount: parseUnits(\"0.001\", JPYC_DECIMALS),\n * });\n * ```\n */\nexport function buildPaymentRequirements(\n\tparams: BuildPaymentRequirementsParams,\n): X402PaymentRequirements {\n\tconst asset = assertAddress(params.asset, \"asset\");\n\tconst payTo = assertAddress(params.payTo, \"payTo\");\n\tconst amount = coerceAmount(params.amount);\n\tconst maxTimeoutSeconds = params.maxTimeoutSeconds ?? X402_DEFAULT_MAX_TIMEOUT_SECONDS;\n\tif (maxTimeoutSeconds <= 0) {\n\t\tthrow new X402InvalidPayloadError(\n\t\t\t\"PaymentRequirements\",\n\t\t\t`\\`maxTimeoutSeconds\\` must be positive, got ${maxTimeoutSeconds}`,\n\t\t);\n\t}\n\tconst extra = resolveExtra(asset, params.extra);\n\n\treturn {\n\t\tscheme: \"exact\",\n\t\tnetwork: chainIdToX402Network(params.chainId),\n\t\tamount,\n\t\tasset,\n\t\tpayTo,\n\t\tmaxTimeoutSeconds,\n\t\textra,\n\t};\n}\n\n/**\n * Builds the full {@link X402PaymentRequiredResponse} body the server returns\n * alongside HTTP 402.\n *\n * @example\n * ```ts\n * import {\n *   buildPaymentRequiredResponse,\n *   buildPaymentRequirements,\n *   encodePaymentRequiredHeader,\n *   polygonAmoy,\n * } from \"kawasekit\";\n *\n * const response = buildPaymentRequiredResponse({\n *   resource: { url: \"https://api.example.com/weather\", description: \"Real-time weather\" },\n *   accepts: [\n *     buildPaymentRequirements({ chainId: polygonAmoy.id, ... }),\n *   ],\n *   error: \"PAYMENT-SIGNATURE header is required\",\n * });\n *\n * res.statusCode = 402;\n * res.setHeader(\"PAYMENT-REQUIRED\", encodePaymentRequiredHeader(response));\n * res.setHeader(\"content-type\", \"application/json\");\n * res.end(JSON.stringify(response));\n * ```\n */\nexport function buildPaymentRequiredResponse(\n\tparams: BuildPaymentRequiredResponseParams,\n): X402PaymentRequiredResponse {\n\tif (params.accepts.length === 0) {\n\t\tthrow new X402InvalidPayloadError(\n\t\t\t\"PaymentRequired\",\n\t\t\t\"`accepts` must contain at least one PaymentRequirements entry\",\n\t\t);\n\t}\n\t// Object literal is built conditionally so optional fields are *absent* (not\n\t// `undefined`) when not provided — required by `exactOptionalPropertyTypes`.\n\tconst base: Pick<X402PaymentRequiredResponse, \"x402Version\" | \"resource\" | \"accepts\"> = {\n\t\tx402Version: X402_VERSION,\n\t\tresource: params.resource,\n\t\taccepts: params.accepts,\n\t};\n\tif (params.error !== undefined && params.extensions !== undefined) {\n\t\treturn { ...base, error: params.error, extensions: params.extensions };\n\t}\n\tif (params.error !== undefined) {\n\t\treturn { ...base, error: params.error };\n\t}\n\tif (params.extensions !== undefined) {\n\t\treturn { ...base, extensions: params.extensions };\n\t}\n\treturn base;\n}\n","/**\n * `createX402Handler()` — framework-agnostic x402 v2 resource-server adapter.\n *\n * The returned function maps any WHATWG `Request` to a `Response`, gating the\n * caller-supplied inner handler behind an x402 payment flow:\n *\n * 1. Compute requirements for the request (via `requirementsFor`).\n *    `null` / empty array → no payment, pass through to inner handler.\n * 2. Look for the `PAYMENT-SIGNATURE` header. If missing or malformed →\n *    `402 Payment Required` with a `PAYMENT-REQUIRED` header carrying the\n *    encoded {@link X402PaymentRequiredResponse}.\n * 3. The client's `paymentPayload.accepted` must match one entry in our\n *    requirements list (scheme / network / amount / asset / payTo).\n * 4. Call `facilitator.verify`. On failure → 402 with a reason.\n * 5. Call `facilitator.settle`. On failure → 402 with a reason. On success →\n *    invoke the inner handler, attach the `PAYMENT-RESPONSE` header, return.\n *\n * Because the contract is `Request → Response`, the handler runs unchanged on\n * Node (via `@hono/node-server` or a hand-rolled adapter), Bun, Deno, Cloudflare\n * Workers, and Vercel Edge.\n *\n * @packageDocumentation\n */\n\nimport type { Hex } from \"viem\";\nimport { getAddress } from \"viem\";\nimport {\n\tcreateInMemoryIdempotencyStore,\n\ttype IdempotencyLease,\n\ttype IdempotencyLookupResult,\n\ttype IdempotencyRecord,\n\ttype IdempotencyResponseSnapshot,\n\ttype IdempotencyStore,\n\tKAWASEKIT_IDEMPOTENCY_RECORD_VERSION,\n} from \"../idempotency\";\nimport {\n\textractAcceptedNetworks,\n\tinvokeHookSafely,\n\ttype ObservabilityHooks,\n\ttype PaymentAcceptedEvent,\n\ttype PaymentRequiredEvent,\n} from \"../observability/hooks\";\nimport {\n\tdecodePaymentSignatureHeader,\n\tencodePaymentRequiredHeader,\n\tencodePaymentResponseHeader,\n\tX402_HEADER_IDEMPOTENCY_KEY,\n\tX402_HEADER_PAYMENT_REQUIRED,\n\tX402_HEADER_PAYMENT_RESPONSE,\n\tX402_HEADER_PAYMENT_SIGNATURE,\n} from \"./encoding\";\nimport { X402InvalidPayloadError } from \"./errors\";\nimport { buildPaymentRequiredResponse } from \"./payment-requirements\";\nimport type {\n\tFacilitator,\n\tX402PaymentPayload,\n\tX402PaymentRequirements,\n\tX402ResourceInfo,\n\tX402SettlementResponse,\n} from \"./types\";\nimport { X402_VERSION } from \"./types\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * Context passed to the inner handler **after** a payment has been verified\n * and settled. `null` when the request bypassed the payment flow because\n * `requirementsFor` returned `null` / `[]`.\n */\nexport interface X402HandlerContext {\n\t/** The client's signed payment payload. */\n\treadonly paymentPayload: X402PaymentPayload;\n\t/** The matching requirements entry the client targeted. */\n\treadonly matchedRequirements: X402PaymentRequirements;\n\t/** Facilitator's settlement response (broadcast already happened). */\n\treadonly settlement: X402SettlementResponse;\n}\n\n/**\n * The inner business-logic handler. Receives the same `Request` plus a context\n * that is present when a payment was made for this request, and `null`\n * otherwise (pass-through case).\n */\nexport type X402InnerHandler = (\n\trequest: Request,\n\tcontext: X402HandlerContext | null,\n) => Promise<Response> | Response;\n\n/** Parameters for {@link createX402Handler}. */\nexport interface CreateX402HandlerParams {\n\t/** Facilitator that performs verify and settle (self or HTTP-proxied). */\n\treadonly facilitator: Facilitator;\n\t/**\n\t * Returns the {@link X402PaymentRequirements} that apply to this request.\n\t *\n\t * - Return one or more entries to require payment (client picks one).\n\t * - Return `null` or `[]` to skip the payment flow entirely for this\n\t *   request — the inner handler is invoked with `context = null`.\n\t */\n\treadonly requirementsFor: (\n\t\trequest: Request,\n\t) =>\n\t\t| Promise<readonly X402PaymentRequirements[] | null>\n\t\t| readonly X402PaymentRequirements[]\n\t\t| null;\n\t/** The protected business-logic handler. Invoked after settlement. */\n\treadonly handler: X402InnerHandler;\n\t/**\n\t * Optional builder for the {@link X402ResourceInfo} echoed in the 402\n\t * response. Defaults to `{ url: request.url }`.\n\t */\n\treadonly resourceFor?: (request: Request) => Promise<X402ResourceInfo> | X402ResourceInfo;\n\t/**\n\t * Optional observability callbacks. The handler emits `onPaymentRequired`\n\t * each time it returns a 402, and `onPaymentAccepted` after a settled\n\t * payment unlocks the inner handler. Hooks are fire-and-forget — see\n\t * {@link ObservabilityHooks}.\n\t */\n\treadonly hooks?: ObservabilityHooks;\n\t/**\n\t * Reasoning-step idempotency (M5-1, Half A). **Default-on**: when omitted, an\n\t * in-memory store deduplicates re-sent / concurrent paid requests — replaying\n\t * the cached response and closing the verify→settle TOCTOU. Pass\n\t * `{ store: \"none\" }` to disable, or a shared store (Redis/SQL adapter) for\n\t * multi-replica deployments (the in-memory default is single-process).\n\t * Fund-correctness never depends on this store — the on-chain EIP-3009 nonce\n\t * is the backstop.\n\t */\n\treadonly idempotency?: IdempotencyServerConfig;\n}\n\n/** Server-side idempotency configuration (M5-1). See {@link CreateX402HandlerParams.idempotency}. */\nexport interface IdempotencyServerConfig {\n\t/** The store, or `\"none\"` to disable. Default: a fresh in-memory bounded LRU. */\n\treadonly store?: IdempotencyStore | \"none\";\n\t/**\n\t * What to do when a concurrent request holds the in-flight lease for the same\n\t * key. `\"reject\"` (default) returns a `payment_in_progress` 402 (the client\n\t * retries and gets the cached result); `\"await\"` polls briefly for the twin\n\t * to complete, then replays its response.\n\t */\n\treadonly inFlight?: \"await\" | \"reject\";\n\t/** Max captured response body size for replay, in bytes. Default 65536 (64 KiB). */\n\treadonly maxSnapshotBytes?: number;\n\t/** Fallback record TTL in seconds when the authorization `validBefore` is unreadable. Default 86400. */\n\treadonly fallbackTtlSeconds?: number;\n}\n\n/** The function returned by {@link createX402Handler}. */\nexport type X402RequestHandler = (request: Request) => Promise<Response>;\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nfunction defaultResource(request: Request): X402ResourceInfo {\n\treturn { url: request.url };\n}\n\nfunction isSameRequirements(\n\toffered: X402PaymentRequirements,\n\tchosen: X402PaymentRequirements,\n): boolean {\n\treturn (\n\t\toffered.scheme === chosen.scheme &&\n\t\toffered.network === chosen.network &&\n\t\toffered.amount === chosen.amount &&\n\t\tgetAddress(offered.asset) === getAddress(chosen.asset) &&\n\t\tgetAddress(offered.payTo) === getAddress(chosen.payTo)\n\t);\n}\n\nasync function paymentRequired(\n\trequest: Request,\n\trequirements: readonly X402PaymentRequirements[],\n\tresourceFor: ((r: Request) => Promise<X402ResourceInfo> | X402ResourceInfo) | undefined,\n\terror: string,\n): Promise<Response> {\n\tconst resource = resourceFor ? await resourceFor(request) : defaultResource(request);\n\tconst body = buildPaymentRequiredResponse({ resource, accepts: requirements, error });\n\tconst headers = new Headers({ \"content-type\": \"application/json\" });\n\theaders.set(X402_HEADER_PAYMENT_REQUIRED, encodePaymentRequiredHeader(body));\n\treturn new Response(JSON.stringify(body), { status: 402, headers });\n}\n\nfunction internalError(reason: string, cause: unknown): Response {\n\tconst message = cause instanceof Error ? cause.message : String(cause);\n\treturn new Response(JSON.stringify({ error: reason, message }), {\n\t\tstatus: 500,\n\t\theaders: { \"content-type\": \"application/json\" },\n\t});\n}\n\nfunction withPaymentResponseHeader(\n\tinnerResponse: Response,\n\tsettlement: X402SettlementResponse,\n): Response {\n\tconst headers = new Headers(innerResponse.headers);\n\theaders.set(X402_HEADER_PAYMENT_RESPONSE, encodePaymentResponseHeader(settlement));\n\treturn new Response(innerResponse.body, {\n\t\tstatus: innerResponse.status,\n\t\tstatusText: innerResponse.statusText,\n\t\theaders,\n\t});\n}\n\n// ---------------------------------------------------------------------------\n// Idempotency (M5-1) helpers\n// ---------------------------------------------------------------------------\n\n/** Credential-safe header allowlist preserved in a replayed response. */\nconst SNAPSHOT_HEADER_ALLOWLIST = [\"content-type\", X402_HEADER_PAYMENT_RESPONSE];\nconst IDEMPOTENCY_REPLAYED_HEADER = \"Idempotency-Replayed\";\nconst DEFAULT_MAX_SNAPSHOT_BYTES = 64 * 1024;\nconst DEFAULT_FALLBACK_TTL_SECONDS = 86_400;\n\ninterface ResolvedIdempotency {\n\treadonly store: IdempotencyStore;\n\treadonly inFlight: \"await\" | \"reject\";\n\treadonly maxSnapshotBytes: number;\n\treadonly fallbackTtlSeconds: number;\n}\n\n/** Resolve the (default-on) idempotency config once per handler construction. */\nfunction resolveIdempotency(\n\tconfig: IdempotencyServerConfig | undefined,\n): ResolvedIdempotency | null {\n\tif (config?.store === \"none\") {\n\t\treturn null;\n\t}\n\treturn {\n\t\tstore: config?.store ?? createInMemoryIdempotencyStore(),\n\t\tinFlight: config?.inFlight ?? \"reject\",\n\t\tmaxSnapshotBytes: config?.maxSnapshotBytes ?? DEFAULT_MAX_SNAPSHOT_BYTES,\n\t\tfallbackTtlSeconds: config?.fallbackTtlSeconds ?? DEFAULT_FALLBACK_TTL_SECONDS,\n\t};\n}\n\nfunction bytesToBase64(bytes: Uint8Array): string {\n\tlet binary = \"\";\n\tfor (const b of bytes) {\n\t\tbinary += String.fromCharCode(b);\n\t}\n\treturn btoa(binary);\n}\n\nfunction base64ToBytes(b64: string): Uint8Array {\n\tconst binary = atob(b64);\n\tconst bytes = new Uint8Array(binary.length);\n\tfor (let i = 0; i < binary.length; i += 1) {\n\t\tbytes[i] = binary.charCodeAt(i);\n\t}\n\treturn bytes;\n}\n\n/** Defensively read the EIP-3009 nonce + validBefore from an opaque payload. */\nfunction readAuthorization(\n\tpayload: X402PaymentPayload,\n): { readonly nonce: string; readonly validBefore: bigint } | null {\n\tconst inner = payload.payload;\n\tif (typeof inner !== \"object\" || inner === null) {\n\t\treturn null;\n\t}\n\tconst auth = (inner as { authorization?: unknown }).authorization;\n\tif (typeof auth !== \"object\" || auth === null) {\n\t\treturn null;\n\t}\n\tconst a = auth as { nonce?: unknown; validBefore?: unknown };\n\tif (typeof a.nonce !== \"string\" || a.nonce === \"\") {\n\t\treturn null;\n\t}\n\tconst validBefore =\n\t\ttypeof a.validBefore === \"string\" && /^[0-9]+$/.test(a.validBefore)\n\t\t\t? BigInt(a.validBefore)\n\t\t\t: 0n;\n\treturn { nonce: a.nonce, validBefore };\n}\n\n/**\n * The server dedup key: the client `Idempotency-Key` header when present (the\n * logical reasoning-step key, working even for signers that cannot derive a\n * nonce), else the EIP-3009 nonce — both namespaced by (network, payTo, asset)\n * for cross-tenant isolation. `null` ⇒ no key can be formed; dedup is skipped\n * (the on-chain nonce still backstops fund-correctness).\n */\nfunction computeServerKey(\n\trequest: Request,\n\trequirements: X402PaymentRequirements,\n\tauth: { readonly nonce: string } | null,\n): string | null {\n\tconst header = request.headers.get(X402_HEADER_IDEMPOTENCY_KEY);\n\tlet material: string;\n\tif (header !== null && header !== \"\") {\n\t\tmaterial = `hdr:${header}`;\n\t} else if (auth !== null) {\n\t\tmaterial = `nonce:${auth.nonce}`;\n\t} else {\n\t\treturn null;\n\t}\n\treturn JSON.stringify([\n\t\trequirements.network,\n\t\tgetAddress(requirements.payTo),\n\t\tgetAddress(requirements.asset),\n\t\tmaterial,\n\t]);\n}\n\n/**\n * Snapshot a response for replay, reading from a clone so the original body\n * stays intact. `undefined` if the body exceeds `maxBytes` (the record then\n * stores only the settlement for a minimal replay).\n */\nasync function snapshotResponse(\n\tresponse: Response,\n\tmaxBytes: number,\n): Promise<IdempotencyResponseSnapshot | undefined> {\n\tconst contentLength = response.headers.get(\"content-length\");\n\tif (contentLength !== null && Number(contentLength) > maxBytes) {\n\t\treturn undefined;\n\t}\n\tconst buffer = await response.clone().arrayBuffer();\n\tif (buffer.byteLength > maxBytes) {\n\t\treturn undefined;\n\t}\n\tconst headers: Array<readonly [string, string]> = [];\n\tfor (const name of SNAPSHOT_HEADER_ALLOWLIST) {\n\t\tconst value = response.headers.get(name);\n\t\tif (value !== null) {\n\t\t\theaders.push([name, value]);\n\t\t}\n\t}\n\treturn { status: response.status, headers, bodyBase64: bytesToBase64(new Uint8Array(buffer)) };\n}\n\n/** Rebuild a response from a completed record (replay path), tagged for clients. */\nfunction replayResponse(record: IdempotencyRecord): Response {\n\tconst snapshot = record.responseSnapshot;\n\tif (snapshot !== undefined) {\n\t\tconst headers = new Headers();\n\t\tfor (const [name, value] of snapshot.headers) {\n\t\t\theaders.set(name, value);\n\t\t}\n\t\theaders.set(IDEMPOTENCY_REPLAYED_HEADER, \"true\");\n\t\treturn new Response(base64ToBytes(snapshot.bodyBase64), { status: snapshot.status, headers });\n\t}\n\tconst headers = new Headers({ [IDEMPOTENCY_REPLAYED_HEADER]: \"true\" });\n\theaders.set(\n\t\tX402_HEADER_PAYMENT_RESPONSE,\n\t\tencodePaymentResponseHeader({\n\t\t\tsuccess: true,\n\t\t\ttransaction: record.txHash,\n\t\t\tnetwork: record.network,\n\t\t\tpayer: record.payer,\n\t\t\tamount: record.amount,\n\t\t}),\n\t);\n\treturn new Response(null, { status: 200, headers });\n}\n\nfunction buildRecord(\n\tkey: string,\n\tsettlement: X402SettlementResponse,\n\trequirements: X402PaymentRequirements,\n\tvalidBefore: bigint,\n\tfallbackTtlSeconds: number,\n\tsnapshot: IdempotencyResponseSnapshot | undefined,\n): IdempotencyRecord | null {\n\tif (settlement.transaction === \"\" || settlement.payer === undefined) {\n\t\treturn null;\n\t}\n\tconst nowSec = BigInt(Math.floor(Date.now() / 1000));\n\tconst expiresAt = validBefore > nowSec ? validBefore : nowSec + BigInt(fallbackTtlSeconds);\n\treturn {\n\t\tkawasekitVersion: KAWASEKIT_IDEMPOTENCY_RECORD_VERSION,\n\t\tkey,\n\t\t// settlement.transaction is the on-chain tx hash (0x-hex) the facilitator broadcast.\n\t\ttxHash: settlement.transaction as Hex,\n\t\tpayer: settlement.payer,\n\t\tamount: settlement.amount ?? requirements.amount,\n\t\tnetwork: requirements.network,\n\t\t...(snapshot !== undefined ? { responseSnapshot: snapshot } : {}),\n\t\texpiresAt,\n\t};\n}\n\nfunction sleep(ms: number): Promise<void> {\n\treturn new Promise((resolve) => {\n\t\tsetTimeout(resolve, ms);\n\t});\n}\n\nconst IN_FLIGHT_POLL_MS = 100;\nconst IN_FLIGHT_MAX_POLLS = 50; // ~5s bounded wait for the \"await\" policy\n\n/** Release an owned in-flight lease so the step can be retried (best-effort). */\nasync function releaseLease(\n\tidem: ResolvedIdempotency | null,\n\tkey: string | null,\n\tlease: IdempotencyLease | null,\n): Promise<void> {\n\tif (idem !== null && key !== null && lease !== null) {\n\t\ttry {\n\t\t\tawait idem.store.abandon(key, lease);\n\t\t} catch {\n\t\t\t// best-effort: the lease will also expire on its own (crash-recovery TTL).\n\t\t}\n\t}\n}\n\n/**\n * For the `\"await\"` in-flight policy, poll briefly for a concurrent twin to\n * complete. Returns its record to replay, or `null` to fall back to the reject\n * path (twin still running past the budget, or it died and freed the slot).\n */\nasync function resolveInFlight(\n\tidem: ResolvedIdempotency,\n\tkey: string,\n): Promise<IdempotencyRecord | null> {\n\tif (idem.inFlight !== \"await\") {\n\t\treturn null;\n\t}\n\tfor (let i = 0; i < IN_FLIGHT_MAX_POLLS; i += 1) {\n\t\tawait sleep(IN_FLIGHT_POLL_MS);\n\t\tlet lookup: IdempotencyLookupResult;\n\t\ttry {\n\t\t\tlookup = await idem.store.begin(key);\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t\tif (lookup.status === \"completed\") {\n\t\t\treturn lookup.record;\n\t\t}\n\t\tif (lookup.status === \"fresh\") {\n\t\t\t// The twin died and we now hold the lease; release it and let the\n\t\t\t// caller reject (the client retries and settles cleanly).\n\t\t\tawait releaseLease(idem, key, lookup.lease);\n\t\t\treturn null;\n\t\t}\n\t\t// still in_flight → keep polling\n\t}\n\treturn null;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Builds an {@link X402RequestHandler} that wraps `params.handler` with the\n * x402 payment flow.\n *\n * @example\n * ```ts\n * import { createServer } from \"node:http\";\n * import { parseUnits } from \"viem\";\n * import {\n *   buildPaymentRequirements,\n *   createSelfFacilitator,\n *   createX402Handler,\n *   JPYC_DECIMALS,\n *   JPYC_V2_ADDRESS,\n *   polygonAmoy,\n * } from \"kawasekit\";\n *\n * const handler = createX402Handler({\n *   facilitator: createSelfFacilitator({ walletClient, publicClient }),\n *   requirementsFor: (req) =>\n *     new URL(req.url).pathname.startsWith(\"/weather\")\n *       ? [buildPaymentRequirements({\n *           chainId: polygonAmoy.id,\n *           asset: JPYC_V2_ADDRESS,\n *           payTo: \"0x...\",\n *           amount: parseUnits(\"0.001\", JPYC_DECIMALS),\n *         })]\n *       : null,\n *   handler: async (req) => new Response(JSON.stringify({ weather: \"sunny\" }), {\n *     headers: { \"content-type\": \"application/json\" },\n *   }),\n * });\n *\n * // Mount on any framework that exposes WHATWG Request → Response.\n * ```\n */\nexport function createX402Handler(params: CreateX402HandlerParams): X402RequestHandler {\n\tconst { facilitator, requirementsFor, handler, resourceFor, hooks } = params;\n\t// Resolved ONCE so the in-memory store persists across requests (the Hono\n\t// adapter rebuilds the handler per request, so this must live in the closure).\n\tconst idempotency = resolveIdempotency(params.idempotency);\n\n\treturn async function x402Handler(request: Request): Promise<Response> {\n\t\tconst startedAtMs = Date.now();\n\n\t\tconst emitPaymentRequired = (\n\t\t\treqs: readonly X402PaymentRequirements[],\n\t\t\terror: string,\n\t\t): Promise<Response> => {\n\t\t\tconst event: PaymentRequiredEvent = {\n\t\t\t\tkind: \"payment_required\",\n\t\t\t\tstartedAtMs,\n\t\t\t\tdurationMs: Date.now() - startedAtMs,\n\t\t\t\trequestUrl: request.url,\n\t\t\t\tacceptedNetworks: extractAcceptedNetworks(reqs),\n\t\t\t};\n\t\t\tinvokeHookSafely(hooks?.onPaymentRequired, event);\n\t\t\treturn paymentRequired(request, reqs, resourceFor, error);\n\t\t};\n\n\t\t// 1. Resolve requirements (or pass through)\n\t\tlet requirements: readonly X402PaymentRequirements[] | null;\n\t\ttry {\n\t\t\trequirements = await requirementsFor(request);\n\t\t} catch (cause) {\n\t\t\treturn internalError(\"requirements_resolution_failed\", cause);\n\t\t}\n\t\tif (requirements === null || requirements.length === 0) {\n\t\t\treturn handler(request, null);\n\t\t}\n\n\t\t// 2. Read the PAYMENT-SIGNATURE header\n\t\tconst headerValue = request.headers.get(X402_HEADER_PAYMENT_SIGNATURE);\n\t\tif (headerValue === null || headerValue === \"\") {\n\t\t\treturn emitPaymentRequired(requirements, \"PAYMENT-SIGNATURE header is required\");\n\t\t}\n\n\t\t// 3. Decode the payment payload\n\t\tlet paymentPayload: X402PaymentPayload;\n\t\ttry {\n\t\t\tpaymentPayload = decodePaymentSignatureHeader(headerValue);\n\t\t} catch (cause) {\n\t\t\tconst reason =\n\t\t\t\tcause instanceof X402InvalidPayloadError\n\t\t\t\t\t? cause.reason\n\t\t\t\t\t: \"invalid PAYMENT-SIGNATURE header\";\n\t\t\treturn emitPaymentRequired(requirements, reason);\n\t\t}\n\n\t\t// 4. Match chosen requirements to an offered entry\n\t\tconst matchedRequirements = requirements.find((offered) =>\n\t\t\tisSameRequirements(offered, paymentPayload.accepted),\n\t\t);\n\t\tif (!matchedRequirements) {\n\t\t\treturn emitPaymentRequired(\n\t\t\t\trequirements,\n\t\t\t\t\"paymentPayload.accepted does not match any offered requirements\",\n\t\t\t);\n\t\t}\n\n\t\t// 5. Verify\n\t\tlet verifyResult: Awaited<ReturnType<Facilitator[\"verify\"]>>;\n\t\ttry {\n\t\t\tverifyResult = await facilitator.verify({\n\t\t\t\tx402Version: X402_VERSION,\n\t\t\t\tpaymentPayload,\n\t\t\t\tpaymentRequirements: matchedRequirements,\n\t\t\t});\n\t\t} catch (cause) {\n\t\t\treturn internalError(\"facilitator_verify_failed\", cause);\n\t\t}\n\t\tif (!verifyResult.isValid) {\n\t\t\treturn emitPaymentRequired(requirements, verifyResult.invalidReason ?? \"verify failed\");\n\t\t}\n\n\t\t// 5b. Reasoning-step idempotency gate (M5-1, Half A). Runs AFTER verify so a\n\t\t// cached response is only released against a re-verified authorization.\n\t\tconst auth = readAuthorization(paymentPayload);\n\t\tconst idemKey =\n\t\t\tidempotency !== null ? computeServerKey(request, matchedRequirements, auth) : null;\n\t\tlet lease: IdempotencyLease | null = null;\n\t\tif (idempotency !== null && idemKey !== null) {\n\t\t\tlet lookup: IdempotencyLookupResult;\n\t\t\ttry {\n\t\t\t\tlookup = await idempotency.store.begin(idemKey);\n\t\t\t} catch (cause) {\n\t\t\t\treturn internalError(\"idempotency_store_failed\", cause);\n\t\t\t}\n\t\t\tif (lookup.status === \"completed\") {\n\t\t\t\treturn replayResponse(lookup.record);\n\t\t\t}\n\t\t\tif (lookup.status === \"in_flight\") {\n\t\t\t\tconst awaited = await resolveInFlight(idempotency, idemKey);\n\t\t\t\tif (awaited !== null) {\n\t\t\t\t\treturn replayResponse(awaited);\n\t\t\t\t}\n\t\t\t\treturn emitPaymentRequired(requirements, \"payment_in_progress\");\n\t\t\t}\n\t\t\tlease = lookup.lease;\n\t\t}\n\n\t\t// 6. Settle\n\t\tlet settleResult: Awaited<ReturnType<Facilitator[\"settle\"]>>;\n\t\ttry {\n\t\t\tsettleResult = await facilitator.settle({\n\t\t\t\tx402Version: X402_VERSION,\n\t\t\t\tpaymentPayload,\n\t\t\t\tpaymentRequirements: matchedRequirements,\n\t\t\t});\n\t\t} catch (cause) {\n\t\t\tawait releaseLease(idempotency, idemKey, lease);\n\t\t\treturn internalError(\"facilitator_settle_failed\", cause);\n\t\t}\n\t\tif (!settleResult.success) {\n\t\t\tawait releaseLease(idempotency, idemKey, lease);\n\t\t\treturn emitPaymentRequired(requirements, settleResult.errorReason ?? \"settle failed\");\n\t\t}\n\n\t\t// 7. Settled — emit onPaymentAccepted then invoke inner handler.\n\t\tif (settleResult.payer !== undefined) {\n\t\t\tconst acceptedEvent: PaymentAcceptedEvent = {\n\t\t\t\tkind: \"payment_accepted\",\n\t\t\t\tstartedAtMs,\n\t\t\t\tdurationMs: Date.now() - startedAtMs,\n\t\t\t\trequestUrl: request.url,\n\t\t\t\tpayer: settleResult.payer,\n\t\t\t\tamount: settleResult.amount ?? matchedRequirements.amount,\n\t\t\t\tnetwork: matchedRequirements.network,\n\t\t\t\ttransaction: settleResult.transaction as Hex,\n\t\t\t};\n\t\t\tinvokeHookSafely(hooks?.onPaymentAccepted, acceptedEvent);\n\t\t}\n\n\t\t// Inner handler errors propagate — settlement has already happened.\n\t\tconst context: X402HandlerContext = {\n\t\t\tpaymentPayload,\n\t\t\tmatchedRequirements,\n\t\t\tsettlement: settleResult,\n\t\t};\n\t\tconst innerResponse = await handler(request, context);\n\t\tconst finalResponse = withPaymentResponseHeader(innerResponse, settleResult);\n\n\t\t// 7b. Record the settled response for replay-on-duplicate (best-effort —\n\t\t// fund-correctness is guaranteed on-chain regardless of the store).\n\t\tif (idempotency !== null && idemKey !== null && lease !== null) {\n\t\t\tconst snapshot = await snapshotResponse(finalResponse, idempotency.maxSnapshotBytes);\n\t\t\tconst record = buildRecord(\n\t\t\t\tidemKey,\n\t\t\t\tsettleResult,\n\t\t\t\tmatchedRequirements,\n\t\t\t\tauth?.validBefore ?? 0n,\n\t\t\t\tidempotency.fallbackTtlSeconds,\n\t\t\t\tsnapshot,\n\t\t\t);\n\t\t\tif (record !== null) {\n\t\t\t\ttry {\n\t\t\t\t\tawait idempotency.store.complete(idemKey, record, lease);\n\t\t\t\t} catch {\n\t\t\t\t\t// Completing the cache is best-effort; on-chain nonce is the backstop.\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tawait releaseLease(idempotency, idemKey, lease);\n\t\t\t}\n\t\t}\n\t\treturn finalResponse;\n\t};\n}\n"]}