@bankofai/x402-evm 1.0.0-beta.0

package/README.md

@@ -0,0 +1,172 @@
+# `@bankofai/x402-evm` [![npm version](https://img.shields.io/npm/v/%40bankofai%2Fx402-evm.svg)](https://www.npmjs.com/package/@bankofai/x402-evm)
+
+EVM (Ethereum Virtual Machine) implementation of the x402 payment protocol using the **Exact** payment scheme with EIP-3009 TransferWithAuthorization.
+
+## Installation
+
+```bash
+npm install @bankofai/x402-evm
+```
+
+## Overview
+
+This package provides three main components for handling x402 payments on EVM-compatible blockchains:
+
+- **Client** - For applications that need to make payments (have wallets/signers)
+- **Facilitator** - For payment processors that verify and execute on-chain transactions  
+- **Service** - For resource servers that accept payments and build payment requirements
+
+## Package Exports
+
+### Main Package (`@bankofai/x402-evm`)
+
+**V2 Protocol Support** - Modern x402 protocol with CAIP-2 network identifiers
+
+**Client:**
+- `ExactEvmClient` - V2 client implementation using EIP-3009
+- `toClientEvmSigner(account)` - Converts viem accounts to x402 signers
+- `ClientEvmSigner` - TypeScript type for client signers
+
+**Facilitator:**
+- `ExactEvmFacilitator` - V2 facilitator for payment verification and settlement
+- `toFacilitatorEvmSigner(wallet)` - Converts viem wallets to facilitator signers
+- `FacilitatorEvmSigner` - TypeScript type for facilitator signers
+
+**Service:**
+- `ExactEvmServer` - V2 service for building payment requirements
+
+### V1 Package (`@bankofai/x402-evm/v1`)
+
+**V1 Protocol Support** - Legacy x402 protocol with simple network names
+
+**Exports:**
+- `ExactEvmClientV1` - V1 client implementation
+- `ExactEvmFacilitatorV1` - V1 facilitator implementation  
+- `NETWORKS` - Array of all supported V1 network names
+
+**Supported V1 Networks:**
+```typescript
+[
+  "abstract", "abstract-testnet",
+  "base-sepolia", "base",
+  "avalanche-fuji", "avalanche",
+  "iotex", "sei", "sei-testnet",
+  "polygon", "polygon-amoy",
+  "peaq", "story", "educhain",
+  "skale-base-sepolia"
+]
+```
+
+## Version Differences
+
+### V2 (Main Package)
+- Network format: CAIP-2 (`eip155:8453`)
+- Wildcard support: Yes (`eip155:*`)
+- Payload structure: Partial (core wraps with metadata)
+- Extensions: Full support
+- Validity window: 1 hour (default)
+
+### V1 (V1 Package)  
+- Network format: Simple names (`base-sepolia`)
+- Wildcard support: No (fixed list)
+- Payload structure: Complete
+- Extensions: Limited
+- Validity window: 10 minutes with buffer
+
+## Usage Patterns
+
+### 1. Direct Registration (Full Control)
+
+```typescript
+import { x402Client } from "@bankofai/x402-core/client";
+import { ExactEvmClient } from "@bankofai/x402-evm";
+import { ExactEvmClientV1 } from "@bankofai/x402-evm/v1";
+
+const client = new x402Client()
+  .register("eip155:*", new ExactEvmClient(signer))
+  .registerSchemeV1("base-sepolia", new ExactEvmClientV1(signer))
+  .registerSchemeV1("base", new ExactEvmClientV1(signer));
+```
+
+### Extension RPC Configuration (Optional)
+
+`ExactEvmClient` only requires signer support for `address` + `signTypedData`.
+Permit2 extension enrichment (EIP-2612 / ERC-20 approval gas sponsoring) can
+optionally use explicit RPC config when signer read/fee helpers are unavailable.
+
+No chain-default RPC fallback is applied by the SDK.
+
+```typescript
+// Per-network explicit registration
+const client = new x402Client()
+  .register("eip155:137", new ExactEvmClient(signer, { rpcUrl: polygonRpcUrl }))
+  .register("eip155:8453", new ExactEvmClient(signer, { rpcUrl: baseRpcUrl }));
+
+// Wildcard registration with chain-id keyed config map
+const wildcardClient = new x402Client().register(
+  "eip155:*",
+  new ExactEvmClient(signer, {
+    137: { rpcUrl: polygonRpcUrl },
+    8453: { rpcUrl: baseRpcUrl },
+  }),
+);
+```
+
+### 2. Using Config (Flexible)
+
+```typescript
+import { x402Client } from "@bankofai/x402-core/client";
+import { ExactEvmClient } from "@bankofai/x402-evm";
+
+const client = x402Client.fromConfig({
+  schemes: [
+    { network: "eip155:*", client: new ExactEvmClient(signer) },
+    { network: "base-sepolia", client: new ExactEvmClientV1(signer), x402Version: 1 }
+  ],
+  policies: [myCustomPolicy]
+});
+```
+
+## Supported Networks
+
+**V2 Networks** (via CAIP-2):
+- `eip155:1` - Ethereum Mainnet
+- `eip155:8453` - Base Mainnet  
+- `eip155:84532` - Base Sepolia
+- `eip155:*` - Wildcard (matches all EVM chains)
+- Any `eip155:<chainId>` network
+
+**V1 Networks** (simple names):
+See `NETWORKS` constant in `@bankofai/x402-evm/v1`
+
+## Asset Support
+
+Supports two asset transfer methods:
+- **EIP-3009**: Tokens with native `transferWithAuthorization()` (e.g., USDC, EURC) — simplest, truly gasless
+- **Permit2**: Any ERC-20 token — universal fallback, requires one-time approval
+
+For the current list of chains with default assets configured, see [Default Assets for Dollar-String Pricing](../../../../docs/core-concepts/network-and-token-support.mdx#default-assets-for-dollar-string-pricing) in the x402 docs. To add default asset support for a new chain, see [Adding Support for New Networks](../../../../docs/core-concepts/network-and-token-support.mdx#adding-support-for-new-networks).
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Test
+npm run test
+
+# Integration tests
+npm run test:integration
+
+# Lint & Format
+npm run lint
+npm run format
+```
+
+## Related Packages
+
+- `@bankofai/x402-core` - Core protocol types and client
+- `@bankofai/x402-fetch` - HTTP wrapper with automatic payment handling
+- `@bankofai/x402-svm` - Solana/SVM implementation
+- `@bankofai/x402-stellar` - Stellar implementation

package/dist/cjs/auth-capture/client/index.d.ts

@@ -0,0 +1,44 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayloadContext, PaymentPayloadResult } from '@bankofai/x402-core/types';
+import { C as ClientEvmSigner } from '../../signer-BFelv8DL.js';
+import 'viem';
+
+/**
+ * AuthCapture Scheme - Client
+ * Builds payment payloads for auth-capture payments.
+ *
+ * Implements x402's SchemeNetworkClient interface so it can be registered
+ * on an x402Client via client.register('eip155:84532', new AuthCaptureEvmScheme(signer)).
+ */
+
+/**
+ * Client-side implementation of the auth-capture scheme: derives the canonical
+ * payer-agnostic PaymentInfo hash, signs an ERC-3009 ReceiveWithAuthorization
+ * (default) or a Permit2 PermitTransferFrom against it, and returns a wire
+ * payload the facilitator can settle. Implements `SchemeNetworkClient`.
+ */
+declare class AuthCaptureEvmScheme implements SchemeNetworkClient {
+    private readonly signer;
+    readonly scheme: "auth-capture";
+    /**
+     * Construct a client-side auth-capture scheme bound to a specific signer.
+     *
+     * @param signer - Client-side signer that exposes `address` and `signTypedData`.
+     */
+    constructor(signer: ClientEvmSigner);
+    /**
+     * Build and sign an auth-capture payment payload for the given requirements.
+     * Validates all spec-mandated `extra` fields and the asset-transfer method
+     * (default `eip3009`, alternative `permit2`), reconstructs the on-chain
+     * PaymentInfo struct, computes its payer-agnostic hash, and returns the
+     * signed wire payload.
+     *
+     * @param x402Version - Wire protocol version; only `2` is supported.
+     * @param requirements - Resource server's payment requirements (includes scheme `extra`).
+     * @param _ - Unused FacilitatorContext (interface compatibility).
+     * @returns The signed wire payload tagged with the x402 protocol version.
+     * @throws If `x402Version !== 2` or any required `extra` field is missing.
+     */
+    createPaymentPayload(x402Version: number, requirements: PaymentRequirements, _?: PaymentPayloadContext): Promise<PaymentPayloadResult>;
+}
+
+export { AuthCaptureEvmScheme };

package/dist/cjs/auth-capture/client/index.js

@@ -0,0 +1,298 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/auth-capture/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  AuthCaptureEvmScheme: () => AuthCaptureEvmScheme
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/auth-capture/client/scheme.ts
+var import_viem2 = require("viem");
+
+// src/auth-capture/constants.ts
+var AUTH_CAPTURE_SCHEME = "auth-capture";
+var AUTH_CAPTURE_ESCROW_ADDRESS = "0xBdEA0D1bcC5966192B070Fdf62aB4EF5b4420cff";
+var EIP3009_TOKEN_COLLECTOR_ADDRESS = "0x0E3dF9510de65469C4518D7843919c0b8C7A7757";
+var PERMIT2_TOKEN_COLLECTOR_ADDRESS = "0x992476B9Ee81d52a5BdA0622C333938D0Af0aB26";
+var RECEIVE_AUTHORIZATION_TYPES = {
+  ReceiveWithAuthorization: [
+    { name: "from", type: "address" },
+    { name: "to", type: "address" },
+    { name: "value", type: "uint256" },
+    { name: "validAfter", type: "uint256" },
+    { name: "validBefore", type: "uint256" },
+    { name: "nonce", type: "bytes32" }
+  ]
+};
+var PERMIT2_TRANSFER_FROM_TYPES = {
+  PermitTransferFrom: [
+    { name: "permitted", type: "TokenPermissions" },
+    { name: "spender", type: "address" },
+    { name: "nonce", type: "uint256" },
+    { name: "deadline", type: "uint256" }
+  ],
+  TokenPermissions: [
+    { name: "token", type: "address" },
+    { name: "amount", type: "uint256" }
+  ]
+};
+
+// src/auth-capture/nonce.ts
+var import_viem = require("viem");
+
+// src/constants.ts
+var PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+
+// src/auth-capture/nonce.ts
+var PAYMENT_INFO_TYPEHASH = (0, import_viem.keccak256)(
+  new TextEncoder().encode(
+    "PaymentInfo(address operator,address payer,address receiver,address token,uint120 maxAmount,uint48 preApprovalExpiry,uint48 authorizationExpiry,uint48 refundExpiry,uint16 minFeeBps,uint16 maxFeeBps,address feeReceiver,uint256 salt)"
+  )
+);
+function computePayerAgnosticPaymentInfoHash(chainId, paymentInfo) {
+  const paymentInfoEncoded = (0, import_viem.encodeAbiParameters)(
+    [
+      { name: "typehash", type: "bytes32" },
+      { name: "operator", type: "address" },
+      { name: "payer", type: "address" },
+      { name: "receiver", type: "address" },
+      { name: "token", type: "address" },
+      { name: "maxAmount", type: "uint120" },
+      { name: "preApprovalExpiry", type: "uint48" },
+      { name: "authorizationExpiry", type: "uint48" },
+      { name: "refundExpiry", type: "uint48" },
+      { name: "minFeeBps", type: "uint16" },
+      { name: "maxFeeBps", type: "uint16" },
+      { name: "feeReceiver", type: "address" },
+      { name: "salt", type: "uint256" }
+    ],
+    [
+      PAYMENT_INFO_TYPEHASH,
+      paymentInfo.operator,
+      import_viem.zeroAddress,
+      paymentInfo.receiver,
+      paymentInfo.token,
+      BigInt(paymentInfo.maxAmount),
+      paymentInfo.preApprovalExpiry,
+      paymentInfo.authorizationExpiry,
+      paymentInfo.refundExpiry,
+      paymentInfo.minFeeBps,
+      paymentInfo.maxFeeBps,
+      paymentInfo.feeReceiver,
+      BigInt(paymentInfo.salt)
+    ]
+  );
+  const paymentInfoHash = (0, import_viem.keccak256)(paymentInfoEncoded);
+  const outerEncoded = (0, import_viem.encodeAbiParameters)(
+    [
+      { name: "chainId", type: "uint256" },
+      { name: "escrow", type: "address" },
+      { name: "paymentInfoHash", type: "bytes32" }
+    ],
+    [BigInt(chainId), AUTH_CAPTURE_ESCROW_ADDRESS, paymentInfoHash]
+  );
+  return (0, import_viem.keccak256)(outerEncoded);
+}
+async function signERC3009(signer, authorization, extra, tokenAddress, chainId) {
+  const domain = {
+    name: extra.name,
+    version: extra.version,
+    chainId,
+    verifyingContract: (0, import_viem.getAddress)(tokenAddress)
+  };
+  const message = {
+    from: (0, import_viem.getAddress)(authorization.from),
+    to: (0, import_viem.getAddress)(authorization.to),
+    value: BigInt(authorization.value),
+    validAfter: BigInt(authorization.validAfter),
+    validBefore: BigInt(authorization.validBefore),
+    nonce: authorization.nonce
+  };
+  return signer.signTypedData({
+    domain,
+    types: RECEIVE_AUTHORIZATION_TYPES,
+    primaryType: "ReceiveWithAuthorization",
+    message
+  });
+}
+async function signPermit2(signer, permit, chainId) {
+  const domain = {
+    name: "Permit2",
+    chainId,
+    verifyingContract: PERMIT2_ADDRESS
+  };
+  const message = {
+    permitted: {
+      token: (0, import_viem.getAddress)(permit.permitted.token),
+      amount: BigInt(permit.permitted.amount)
+    },
+    spender: (0, import_viem.getAddress)(permit.spender),
+    nonce: BigInt(permit.nonce),
+    deadline: BigInt(permit.deadline)
+  };
+  return signer.signTypedData({
+    domain,
+    types: PERMIT2_TRANSFER_FROM_TYPES,
+    primaryType: "PermitTransferFrom",
+    message
+  });
+}
+function generateSalt() {
+  const bytes = new Uint8Array(32);
+  crypto.getRandomValues(bytes);
+  return (0, import_viem.toHex)(bytes);
+}
+
+// src/auth-capture/utils.ts
+function parseChainId(network) {
+  const parts = network.split(":");
+  if (parts.length !== 2 || parts[0] !== "eip155") {
+    throw new Error(`Invalid network format: ${network}. Expected 'eip155:<chainId>'`);
+  }
+  const chainId = parseInt(parts[1], 10);
+  if (isNaN(chainId)) {
+    throw new Error(`Invalid chainId in network: ${network}`);
+  }
+  return chainId;
+}
+
+// src/auth-capture/client/scheme.ts
+var AuthCaptureEvmScheme = class {
+  /**
+   * Construct a client-side auth-capture scheme bound to a specific signer.
+   *
+   * @param signer - Client-side signer that exposes `address` and `signTypedData`.
+   */
+  constructor(signer) {
+    this.signer = signer;
+    this.scheme = AUTH_CAPTURE_SCHEME;
+  }
+  /**
+   * Build and sign an auth-capture payment payload for the given requirements.
+   * Validates all spec-mandated `extra` fields and the asset-transfer method
+   * (default `eip3009`, alternative `permit2`), reconstructs the on-chain
+   * PaymentInfo struct, computes its payer-agnostic hash, and returns the
+   * signed wire payload.
+   *
+   * @param x402Version - Wire protocol version; only `2` is supported.
+   * @param requirements - Resource server's payment requirements (includes scheme `extra`).
+   * @param _ - Unused FacilitatorContext (interface compatibility).
+   * @returns The signed wire payload tagged with the x402 protocol version.
+   * @throws If `x402Version !== 2` or any required `extra` field is missing.
+   */
+  async createPaymentPayload(x402Version, requirements, _) {
+    if (x402Version !== 2) {
+      throw new Error(`Unsupported x402Version: ${x402Version}. Only version 2 is supported.`);
+    }
+    const extra = requirements.extra;
+    if (!extra.name) {
+      throw new Error(
+        `EIP-712 domain parameter 'name' is required in payment requirements for asset ${requirements.asset}`
+      );
+    }
+    if (!extra.version) {
+      throw new Error(
+        `EIP-712 domain parameter 'version' is required in payment requirements for asset ${requirements.asset}`
+      );
+    }
+    if (!extra.captureAuthorizer) {
+      throw new Error(`'captureAuthorizer' is required in payment requirements extra`);
+    }
+    if (!extra.feeRecipient) {
+      throw new Error(`'feeRecipient' is required in payment requirements extra`);
+    }
+    if (typeof extra.captureDeadline !== "number") {
+      throw new Error(`'captureDeadline' is required in payment requirements extra`);
+    }
+    if (typeof extra.refundDeadline !== "number") {
+      throw new Error(`'refundDeadline' is required in payment requirements extra`);
+    }
+    if (typeof extra.minFeeBps !== "number") {
+      throw new Error(`'minFeeBps' is required in payment requirements extra`);
+    }
+    if (typeof extra.maxFeeBps !== "number") {
+      throw new Error(`'maxFeeBps' is required in payment requirements extra`);
+    }
+    if (typeof requirements.maxTimeoutSeconds !== "number") {
+      throw new Error(
+        `'maxTimeoutSeconds' is required in PaymentRequirements (used to derive preApprovalExpiry)`
+      );
+    }
+    const chainId = parseChainId(requirements.network);
+    const maxAmount = requirements.amount;
+    const nowSeconds = Math.floor(Date.now() / 1e3);
+    const preApprovalExpiry = nowSeconds + requirements.maxTimeoutSeconds;
+    const salt = generateSalt();
+    const assetTransferMethod = extra.assetTransferMethod ?? "eip3009";
+    const paymentInfo = {
+      operator: extra.captureAuthorizer,
+      payer: this.signer.address,
+      receiver: requirements.payTo,
+      token: requirements.asset,
+      maxAmount,
+      preApprovalExpiry,
+      authorizationExpiry: extra.captureDeadline,
+      refundExpiry: extra.refundDeadline,
+      minFeeBps: extra.minFeeBps,
+      maxFeeBps: extra.maxFeeBps,
+      feeReceiver: extra.feeRecipient,
+      salt
+    };
+    const nonce = computePayerAgnosticPaymentInfoHash(chainId, paymentInfo);
+    if (assetTransferMethod === "permit2") {
+      const permit2Authorization = {
+        from: this.signer.address,
+        permitted: {
+          token: requirements.asset,
+          amount: maxAmount
+        },
+        spender: PERMIT2_TOKEN_COLLECTOR_ADDRESS,
+        nonce: (0, import_viem2.hexToBigInt)(nonce).toString(),
+        deadline: String(preApprovalExpiry)
+      };
+      const signature2 = await signPermit2(this.signer, permit2Authorization, chainId);
+      const payload2 = { permit2Authorization, signature: signature2, salt };
+      return { x402Version, payload: payload2 };
+    }
+    const authorization = {
+      from: this.signer.address,
+      to: EIP3009_TOKEN_COLLECTOR_ADDRESS,
+      value: maxAmount,
+      validAfter: "0",
+      validBefore: String(preApprovalExpiry),
+      nonce
+    };
+    const signature = await signERC3009(
+      this.signer,
+      authorization,
+      extra,
+      requirements.asset,
+      chainId
+    );
+    const payload = { authorization, signature, salt };
+    return { x402Version, payload };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthCaptureEvmScheme
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/auth-capture/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/auth-capture/client/index.ts","../../../../src/auth-capture/client/scheme.ts","../../../../src/auth-capture/constants.ts","../../../../src/auth-capture/nonce.ts","../../../../src/constants.ts","../../../../src/auth-capture/utils.ts"],"sourcesContent":["export { AuthCaptureEvmScheme } from \"./scheme\";\n","/**\n * AuthCapture Scheme - Client\n * Builds payment payloads for auth-capture payments.\n *\n * Implements x402's SchemeNetworkClient interface so it can be registered\n * on an x402Client via client.register('eip155:84532', new AuthCaptureEvmScheme(signer)).\n */\n\nimport type {\n  PaymentPayloadContext,\n  PaymentPayloadResult,\n  PaymentRequirements,\n  SchemeNetworkClient,\n} from \"@bankofai/x402-core/types\";\nimport type { ClientEvmSigner } from \"../../signer\";\nimport { hexToBigInt } from \"viem\";\nimport {\n  AUTH_CAPTURE_SCHEME,\n  EIP3009_TOKEN_COLLECTOR_ADDRESS,\n  PERMIT2_TOKEN_COLLECTOR_ADDRESS,\n} from \"../constants\";\nimport {\n  computePayerAgnosticPaymentInfoHash,\n  generateSalt,\n  signERC3009,\n  signPermit2,\n} from \"../nonce\";\nimport type { AuthCaptureExtra, Eip3009Payload, PaymentInfoStruct, Permit2Payload } from \"../types\";\nimport { parseChainId } from \"../utils\";\n\n/**\n * Client-side implementation of the auth-capture scheme: derives the canonical\n * payer-agnostic PaymentInfo hash, signs an ERC-3009 ReceiveWithAuthorization\n * (default) or a Permit2 PermitTransferFrom against it, and returns a wire\n * payload the facilitator can settle. Implements `SchemeNetworkClient`.\n */\nexport class AuthCaptureEvmScheme implements SchemeNetworkClient {\n  readonly scheme = AUTH_CAPTURE_SCHEME;\n\n  /**\n   * Construct a client-side auth-capture scheme bound to a specific signer.\n   *\n   * @param signer - Client-side signer that exposes `address` and `signTypedData`.\n   */\n  constructor(private readonly signer: ClientEvmSigner) {}\n\n  /**\n   * Build and sign an auth-capture payment payload for the given requirements.\n   * Validates all spec-mandated `extra` fields and the asset-transfer method\n   * (default `eip3009`, alternative `permit2`), reconstructs the on-chain\n   * PaymentInfo struct, computes its payer-agnostic hash, and returns the\n   * signed wire payload.\n   *\n   * @param x402Version - Wire protocol version; only `2` is supported.\n   * @param requirements - Resource server's payment requirements (includes scheme `extra`).\n   * @param _ - Unused FacilitatorContext (interface compatibility).\n   * @returns The signed wire payload tagged with the x402 protocol version.\n   * @throws If `x402Version !== 2` or any required `extra` field is missing.\n   */\n  async createPaymentPayload(\n    x402Version: number,\n    requirements: PaymentRequirements,\n    _?: PaymentPayloadContext,\n  ): Promise<PaymentPayloadResult> {\n    if (x402Version !== 2) {\n      throw new Error(`Unsupported x402Version: ${x402Version}. Only version 2 is supported.`);\n    }\n\n    const extra = requirements.extra as unknown as AuthCaptureExtra;\n\n    // Validate required EIP-712 token-domain parameters\n    if (!extra.name) {\n      throw new Error(\n        `EIP-712 domain parameter 'name' is required in payment requirements for asset ${requirements.asset}`,\n      );\n    }\n    if (!extra.version) {\n      throw new Error(\n        `EIP-712 domain parameter 'version' is required in payment requirements for asset ${requirements.asset}`,\n      );\n    }\n    if (!extra.captureAuthorizer) {\n      throw new Error(`'captureAuthorizer' is required in payment requirements extra`);\n    }\n    if (!extra.feeRecipient) {\n      throw new Error(`'feeRecipient' is required in payment requirements extra`);\n    }\n    if (typeof extra.captureDeadline !== \"number\") {\n      throw new Error(`'captureDeadline' is required in payment requirements extra`);\n    }\n    if (typeof extra.refundDeadline !== \"number\") {\n      throw new Error(`'refundDeadline' is required in payment requirements extra`);\n    }\n    if (typeof extra.minFeeBps !== \"number\") {\n      throw new Error(`'minFeeBps' is required in payment requirements extra`);\n    }\n    if (typeof extra.maxFeeBps !== \"number\") {\n      throw new Error(`'maxFeeBps' is required in payment requirements extra`);\n    }\n    if (typeof requirements.maxTimeoutSeconds !== \"number\") {\n      throw new Error(\n        `'maxTimeoutSeconds' is required in PaymentRequirements (used to derive preApprovalExpiry)`,\n      );\n    }\n\n    const chainId = parseChainId(requirements.network);\n    const maxAmount = requirements.amount;\n    const nowSeconds = Math.floor(Date.now() / 1000);\n    const preApprovalExpiry = nowSeconds + requirements.maxTimeoutSeconds;\n    const salt = generateSalt();\n    const assetTransferMethod = extra.assetTransferMethod ?? \"eip3009\";\n\n    // Build the canonical PaymentInfo struct (Solidity field names — do not rename).\n    const paymentInfo: PaymentInfoStruct = {\n      operator: extra.captureAuthorizer,\n      payer: this.signer.address,\n      receiver: requirements.payTo as `0x${string}`,\n      token: requirements.asset as `0x${string}`,\n      maxAmount,\n      preApprovalExpiry,\n      authorizationExpiry: extra.captureDeadline,\n      refundExpiry: extra.refundDeadline,\n      minFeeBps: extra.minFeeBps,\n      maxFeeBps: extra.maxFeeBps,\n      feeReceiver: extra.feeRecipient,\n      salt,\n    };\n\n    // Payer-agnostic PaymentInfo hash — used as ERC-3009 nonce or Permit2 nonce.\n    const nonce = computePayerAgnosticPaymentInfoHash(chainId, paymentInfo);\n\n    if (assetTransferMethod === \"permit2\") {\n      const permit2Authorization: Permit2Payload[\"permit2Authorization\"] = {\n        from: this.signer.address,\n        permitted: {\n          token: requirements.asset as `0x${string}`,\n          amount: maxAmount,\n        },\n        spender: PERMIT2_TOKEN_COLLECTOR_ADDRESS,\n        nonce: hexToBigInt(nonce).toString(),\n        deadline: String(preApprovalExpiry),\n      };\n      const signature = await signPermit2(this.signer, permit2Authorization, chainId);\n      const payload: Permit2Payload = { permit2Authorization, signature, salt };\n      return { x402Version, payload: payload as unknown as Record<string, unknown> };\n    }\n\n    // Default: EIP-3009 ReceiveWithAuthorization to the canonical EIP-3009 token collector.\n    const authorization: Eip3009Payload[\"authorization\"] = {\n      from: this.signer.address,\n      to: EIP3009_TOKEN_COLLECTOR_ADDRESS,\n      value: maxAmount,\n      validAfter: \"0\",\n      validBefore: String(preApprovalExpiry),\n      nonce,\n    };\n    const signature = await signERC3009(\n      this.signer,\n      authorization,\n      extra,\n      requirements.asset as `0x${string}`,\n      chainId,\n    );\n    const payload: Eip3009Payload = { authorization, signature, salt };\n    return { x402Version, payload: payload as unknown as Record<string, unknown> };\n  }\n}\n","// Scheme identifier for the auth-capture payment scheme.\nexport const AUTH_CAPTURE_SCHEME = \"auth-capture\" as const;\n\n// Canonical AuthCaptureEscrow + token collector deployments from\n// base/commerce-payments (https://github.com/base/commerce-payments). These are\n// the audited, live addresses listed in the upstream README and are the source\n// of truth for this scheme. They are universal constants, not configurable per\n// merchant.\nexport const AUTH_CAPTURE_ESCROW_ADDRESS =\n  \"0xBdEA0D1bcC5966192B070Fdf62aB4EF5b4420cff\" as const satisfies `0x${string}`;\nexport const EIP3009_TOKEN_COLLECTOR_ADDRESS =\n  \"0x0E3dF9510de65469C4518D7843919c0b8C7A7757\" as const satisfies `0x${string}`;\nexport const PERMIT2_TOKEN_COLLECTOR_ADDRESS =\n  \"0x992476B9Ee81d52a5BdA0622C333938D0Af0aB26\" as const satisfies `0x${string}`;\n\n// ERC-3009 ReceiveWithAuthorization EIP-712 types\nexport const RECEIVE_AUTHORIZATION_TYPES = {\n  ReceiveWithAuthorization: [\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// Uniswap Permit2 PermitTransferFrom EIP-712 types\nexport const PERMIT2_TRANSFER_FROM_TYPES = {\n  PermitTransferFrom: [\n    { name: \"permitted\", type: \"TokenPermissions\" },\n    { name: \"spender\", type: \"address\" },\n    { name: \"nonce\", type: \"uint256\" },\n    { name: \"deadline\", type: \"uint256\" },\n  ],\n  TokenPermissions: [\n    { name: \"token\", type: \"address\" },\n    { name: \"amount\", type: \"uint256\" },\n  ],\n} as const;\n","/**\n * Nonce computation, salt generation, and signing helpers.\n */\n\nimport { encodeAbiParameters, getAddress, keccak256, toHex, zeroAddress } from \"viem\";\nimport type { ClientEvmSigner } from \"../signer\";\nimport { PERMIT2_ADDRESS } from \"../constants\";\nimport {\n  AUTH_CAPTURE_ESCROW_ADDRESS,\n  PERMIT2_TRANSFER_FROM_TYPES,\n  RECEIVE_AUTHORIZATION_TYPES,\n} from \"./constants\";\nimport type { AuthCaptureExtra, Eip3009Payload, PaymentInfoStruct, Permit2Payload } from \"./types\";\n\n/**\n * PaymentInfo typehash — must match AuthCaptureEscrow.PAYMENT_INFO_TYPEHASH.\n */\nconst PAYMENT_INFO_TYPEHASH = keccak256(\n  new TextEncoder().encode(\n    \"PaymentInfo(address operator,address payer,address receiver,address token,uint120 maxAmount,uint48 preApprovalExpiry,uint48 authorizationExpiry,uint48 refundExpiry,uint16 minFeeBps,uint16 maxFeeBps,address feeReceiver,uint256 salt)\",\n  ),\n);\n\n/**\n * Compute the payer-agnostic PaymentInfo hash that auth-capture uses as both\n * the ERC-3009 nonce (`bytes32`) and the Permit2 nonce (`uint256`, via the\n * same 32 bytes interpreted as an integer). The payer field is zeroed before\n * hashing so the facilitator can reconstruct the same hash on the verify side\n * without knowing payer identity in advance.\n *\n * Freshness comes from `paymentInfo.salt`; generate a new salt per signing\n * call via `generateSalt`. Identical extras + same salt would collide across\n * payers.\n *\n * @param chainId - EVM chain id; binds the hash to a specific chain.\n * @param paymentInfo - The reconstructed PaymentInfo struct (canonical Solidity field names).\n * @returns The 32-byte hash to use as the nonce on the wire.\n */\nexport function computePayerAgnosticPaymentInfoHash(\n  chainId: number,\n  paymentInfo: PaymentInfoStruct,\n): `0x${string}` {\n  const paymentInfoEncoded = encodeAbiParameters(\n    [\n      { name: \"typehash\", type: \"bytes32\" },\n      { name: \"operator\", type: \"address\" },\n      { name: \"payer\", type: \"address\" },\n      { name: \"receiver\", type: \"address\" },\n      { name: \"token\", type: \"address\" },\n      { name: \"maxAmount\", type: \"uint120\" },\n      { name: \"preApprovalExpiry\", type: \"uint48\" },\n      { name: \"authorizationExpiry\", type: \"uint48\" },\n      { name: \"refundExpiry\", type: \"uint48\" },\n      { name: \"minFeeBps\", type: \"uint16\" },\n      { name: \"maxFeeBps\", type: \"uint16\" },\n      { name: \"feeReceiver\", type: \"address\" },\n      { name: \"salt\", type: \"uint256\" },\n    ],\n    [\n      PAYMENT_INFO_TYPEHASH,\n      paymentInfo.operator,\n      zeroAddress,\n      paymentInfo.receiver,\n      paymentInfo.token,\n      BigInt(paymentInfo.maxAmount),\n      paymentInfo.preApprovalExpiry,\n      paymentInfo.authorizationExpiry,\n      paymentInfo.refundExpiry,\n      paymentInfo.minFeeBps,\n      paymentInfo.maxFeeBps,\n      paymentInfo.feeReceiver,\n      BigInt(paymentInfo.salt),\n    ],\n  );\n  const paymentInfoHash = keccak256(paymentInfoEncoded);\n\n  const outerEncoded = encodeAbiParameters(\n    [\n      { name: \"chainId\", type: \"uint256\" },\n      { name: \"escrow\", type: \"address\" },\n      { name: \"paymentInfoHash\", type: \"bytes32\" },\n    ],\n    [BigInt(chainId), AUTH_CAPTURE_ESCROW_ADDRESS, paymentInfoHash],\n  );\n\n  return keccak256(outerEncoded);\n}\n\n/**\n * Sign an ERC-3009 `ReceiveWithAuthorization` over the supplied authorization\n * fields. The EIP-712 domain is bound to the **token contract** (not the\n * escrow), so the token's `name` and `version` come from `extra` because they\n * vary per asset (e.g. `\"USDC\"` on Sepolia vs `\"USD Coin\"` on mainnet).\n *\n * @param signer - Client signer with `signTypedData`.\n * @param authorization - The ERC-3009 authorization to sign.\n * @param extra - Carries the token EIP-712 domain `name` + `version`.\n * @param tokenAddress - Address of the token contract (verifyingContract in the domain).\n * @param chainId - EVM chain id (chainId in the domain).\n * @returns The 65-byte ECDSA signature (or EIP-1271 / EIP-6492 envelope, depending on the signer).\n */\nexport async function signERC3009(\n  signer: ClientEvmSigner,\n  authorization: Eip3009Payload[\"authorization\"],\n  extra: AuthCaptureExtra,\n  tokenAddress: `0x${string}`,\n  chainId: number,\n): Promise<`0x${string}`> {\n  const domain = {\n    name: extra.name,\n    version: extra.version,\n    chainId,\n    verifyingContract: getAddress(tokenAddress),\n  };\n\n  const message = {\n    from: getAddress(authorization.from),\n    to: getAddress(authorization.to),\n    value: BigInt(authorization.value),\n    validAfter: BigInt(authorization.validAfter),\n    validBefore: BigInt(authorization.validBefore),\n    nonce: authorization.nonce,\n  };\n\n  return signer.signTypedData({\n    domain,\n    types: RECEIVE_AUTHORIZATION_TYPES,\n    primaryType: \"ReceiveWithAuthorization\",\n    message,\n  });\n}\n\n/**\n * Sign a Permit2 `PermitTransferFrom` over the supplied permit fields. Domain\n * is bound to the canonical Permit2 contract. No witness struct is needed —\n * the deterministic nonce (the payer-agnostic PaymentInfo hash, packed into\n * uint256) cryptographically binds all payment parameters including receiver,\n * amount, and deadlines.\n *\n * @param signer - Client signer with `signTypedData`.\n * @param permit - The Permit2 PermitTransferFrom message to sign.\n * @param chainId - EVM chain id (chainId in the Permit2 domain).\n * @returns The 65-byte ECDSA signature (or EIP-1271 / EIP-6492 envelope, depending on the signer).\n */\nexport async function signPermit2(\n  signer: ClientEvmSigner,\n  permit: Permit2Payload[\"permit2Authorization\"],\n  chainId: number,\n): Promise<`0x${string}`> {\n  const domain = {\n    name: \"Permit2\",\n    chainId,\n    verifyingContract: PERMIT2_ADDRESS,\n  };\n\n  const message = {\n    permitted: {\n      token: getAddress(permit.permitted.token),\n      amount: BigInt(permit.permitted.amount),\n    },\n    spender: getAddress(permit.spender),\n    nonce: BigInt(permit.nonce),\n    deadline: BigInt(permit.deadline),\n  };\n\n  return signer.signTypedData({\n    domain,\n    types: PERMIT2_TRANSFER_FROM_TYPES,\n    primaryType: \"PermitTransferFrom\",\n    message,\n  });\n}\n\n/**\n * Generate a fresh cryptographically-random 32-byte salt. MUST be called once\n * per signing request — never reuse across requests. Freshness is required\n * because the nonce derivation zeroes the payer field; identical extras with\n * the same salt would collide across payers.\n *\n * @returns A new 32-byte salt as a `0x`-prefixed hex string.\n */\nexport function generateSalt(): `0x${string}` {\n  const bytes = new Uint8Array(32);\n  crypto.getRandomValues(bytes);\n  return toHex(bytes);\n}\n","// EIP-3009 TransferWithAuthorization types for EIP-712 signing\nexport const authorizationTypes = {\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/**\n * Permit2 EIP-712 types for signing PermitWitnessTransferFrom (exact scheme).\n * Must match the exact format expected by the Permit2 contract.\n * Note: Types must be in ALPHABETICAL order after the primary type (TokenPermissions < Witness).\n */\nexport const permit2WitnessTypes = {\n  PermitWitnessTransferFrom: [\n    { name: \"permitted\", type: \"TokenPermissions\" },\n    { name: \"spender\", type: \"address\" },\n    { name: \"nonce\", type: \"uint256\" },\n    { name: \"deadline\", type: \"uint256\" },\n    { name: \"witness\", type: \"Witness\" },\n  ],\n  TokenPermissions: [\n    { name: \"token\", type: \"address\" },\n    { name: \"amount\", type: \"uint256\" },\n  ],\n  Witness: [\n    { name: \"to\", type: \"address\" },\n    { name: \"validAfter\", type: \"uint256\" },\n  ],\n} as const;\n\n/**\n * Permit2 EIP-712 types for signing PermitWitnessTransferFrom (upto scheme).\n * The upto witness includes a `facilitator` field that the exact witness does not.\n * This ensures only the authorized facilitator can settle the payment.\n * Must match: Witness(address to,address facilitator,uint256 validAfter)\n */\nexport const uptoPermit2WitnessTypes = {\n  PermitWitnessTransferFrom: [\n    { name: \"permitted\", type: \"TokenPermissions\" },\n    { name: \"spender\", type: \"address\" },\n    { name: \"nonce\", type: \"uint256\" },\n    { name: \"deadline\", type: \"uint256\" },\n    { name: \"witness\", type: \"Witness\" },\n  ],\n  TokenPermissions: [\n    { name: \"token\", type: \"address\" },\n    { name: \"amount\", type: \"uint256\" },\n  ],\n  Witness: [\n    { name: \"to\", type: \"address\" },\n    { name: \"facilitator\", type: \"address\" },\n    { name: \"validAfter\", type: \"uint256\" },\n  ],\n} as const;\n\n// EIP3009 ABI for transferWithAuthorization function\nexport const eip3009ABI = [\n  {\n    inputs: [\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      { name: \"v\", type: \"uint8\" },\n      { name: \"r\", type: \"bytes32\" },\n      { name: \"s\", type: \"bytes32\" },\n    ],\n    name: \"transferWithAuthorization\",\n    outputs: [],\n    stateMutability: \"nonpayable\",\n    type: \"function\",\n  },\n  {\n    inputs: [\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      { name: \"signature\", type: \"bytes\" },\n    ],\n    name: \"transferWithAuthorization\",\n    outputs: [],\n    stateMutability: \"nonpayable\",\n    type: \"function\",\n  },\n  {\n    inputs: [{ name: \"account\", type: \"address\" }],\n    name: \"balanceOf\",\n    outputs: [{ name: \"\", type: \"uint256\" }],\n    stateMutability: \"view\",\n    type: \"function\",\n  },\n  {\n    inputs: [],\n    name: \"version\",\n    outputs: [{ name: \"\", type: \"string\" }],\n    stateMutability: \"view\",\n    type: \"function\",\n  },\n  {\n    inputs: [],\n    name: \"name\",\n    outputs: [{ name: \"\", type: \"string\" }],\n    stateMutability: \"view\",\n    type: \"function\",\n  },\n  {\n    inputs: [\n      { name: \"authorizer\", type: \"address\" },\n      { name: \"nonce\", type: \"bytes32\" },\n    ],\n    name: \"authorizationState\",\n    outputs: [{ name: \"\", type: \"bool\" }],\n    stateMutability: \"view\",\n    type: \"function\",\n  },\n] as const;\n\n/**\n * EIP-2612 Permit EIP-712 types for signing token.permit().\n */\nexport const eip2612PermitTypes = {\n  Permit: [\n    { name: \"owner\", type: \"address\" },\n    { name: \"spender\", type: \"address\" },\n    { name: \"value\", type: \"uint256\" },\n    { name: \"nonce\", type: \"uint256\" },\n    { name: \"deadline\", type: \"uint256\" },\n  ],\n} as const;\n\n/**\n * EIP-2612 nonces ABI for querying current nonce.\n */\nexport const eip2612NoncesAbi = [\n  {\n    type: \"function\",\n    name: \"nonces\",\n    inputs: [{ name: \"owner\", type: \"address\" }],\n    outputs: [{ type: \"uint256\" }],\n    stateMutability: \"view\",\n  },\n] as const;\n\n/** ERC-20 approve(address,uint256) ABI for encoding/decoding approval calldata. */\nexport const erc20ApproveAbi = [\n  {\n    type: \"function\",\n    name: \"approve\",\n    inputs: [\n      { name: \"spender\", type: \"address\" },\n      { name: \"amount\", type: \"uint256\" },\n    ],\n    outputs: [{ type: \"bool\" }],\n    stateMutability: \"nonpayable\",\n  },\n] as const;\n\n/** ERC-20 allowance(address,address) ABI for checking spender approval. */\nexport const erc20AllowanceAbi = [\n  {\n    type: \"function\",\n    name: \"allowance\",\n    inputs: [\n      { name: \"owner\", type: \"address\" },\n      { name: \"spender\", type: \"address\" },\n    ],\n    outputs: [{ type: \"uint256\" }],\n    stateMutability: \"view\",\n  },\n] as const;\n\n/** Gas limit for a standard ERC-20 approve() transaction. */\nexport const ERC20_APPROVE_GAS_LIMIT = 70_000n;\n\n/** Fallback max fee per gas (1 gwei) when fee estimation fails. */\nexport const DEFAULT_MAX_FEE_PER_GAS = 1_000_000_000n;\n\n/** Fallback max priority fee per gas (0.1 gwei) when fee estimation fails. */\nexport const DEFAULT_MAX_PRIORITY_FEE_PER_GAS = 100_000_000n;\n\n/**\n * Canonical Permit2 contract address.\n * Same address on all EVM chains via CREATE2 deployment.\n *\n * @see https://github.com/Uniswap/permit2\n */\nexport const PERMIT2_ADDRESS = \"0x000000000022D473030F116dDEE9F6B43aC78BA3\" as const;\n\n/**\n * x402ExactPermit2Proxy contract address.\n * Vanity address: 0x4020...0001 for easy recognition.\n * This address is deterministic based on:\n * - Arachnid's deterministic deployer (0x4e59b44847b379578588920cA78FbF26c0B4956C)\n * - Vanity-mined salt for prefix 0x4020 and suffix 0001\n * - Contract bytecode + constructor args (PERMIT2_ADDRESS)\n */\nexport const x402ExactPermit2ProxyAddress = \"0x402085c248EeA27D92E8b30b2C58ed07f9E20001\" as const;\n\n/**\n * x402UptoPermit2Proxy contract address.\n * Vanity address: 0x4020...0002 for easy recognition.\n * This address is deterministic based on:\n * - Arachnid's deterministic deployer (0x4e59b44847b379578588920cA78FbF26c0B4956C)\n * - Vanity-mined salt for prefix 0x4020 and suffix 0002\n * - Contract bytecode + constructor args (PERMIT2_ADDRESS)\n */\nexport const x402UptoPermit2ProxyAddress = \"0x4020A4f3b7b90ccA423B9fabCc0CE57C6C240002\" as const;\n\n/**\n * ABI components for the exact Permit2 witness tuple: Witness(address to, uint256 validAfter).\n */\nconst permit2WitnessABIComponents = [\n  { name: \"to\", type: \"address\", internalType: \"address\" },\n  { name: \"validAfter\", type: \"uint256\", internalType: \"uint256\" },\n] as const;\n\n/**\n * ABI components for the upto Permit2 witness tuple:\n * Witness(address to, address facilitator, uint256 validAfter).\n */\nconst uptoPermit2WitnessABIComponents = [\n  { name: \"to\", type: \"address\", internalType: \"address\" },\n  { name: \"facilitator\", type: \"address\", internalType: \"address\" },\n  { name: \"validAfter\", type: \"uint256\", internalType: \"uint256\" },\n] as const;\n\n/**\n * x402UptoPermit2Proxy ABI — settle/settleWithPermit for the upto payment scheme.\n * Key differences from exact: settle() takes a `uint256 amount` parameter, and the\n * Witness struct includes an `address facilitator` field.\n */\nexport const x402UptoPermit2ProxyABI = [\n  {\n    type: \"function\",\n    name: \"PERMIT2\",\n    inputs: [],\n    outputs: [{ name: \"\", type: \"address\", internalType: \"contract ISignatureTransfer\" }],\n    stateMutability: \"view\",\n  },\n  {\n    type: \"function\",\n    name: \"WITNESS_TYPEHASH\",\n    inputs: [],\n    outputs: [{ name: \"\", type: \"bytes32\", internalType: \"bytes32\" }],\n    stateMutability: \"view\",\n  },\n  {\n    type: \"function\",\n    name: \"WITNESS_TYPE_STRING\",\n    inputs: [],\n    outputs: [{ name: \"\", type: \"string\", internalType: \"string\" }],\n    stateMutability: \"view\",\n  },\n  {\n    type: \"function\",\n    name: \"settle\",\n    inputs: [\n      {\n        name: \"permit\",\n        type: \"tuple\",\n        internalType: \"struct ISignatureTransfer.PermitTransferFrom\",\n        components: [\n          {\n            name: \"permitted\",\n            type: \"tuple\",\n            internalType: \"struct ISignatureTransfer.TokenPermissions\",\n            components: [\n              { name: \"token\", type: \"address\", internalType: \"address\" },\n              { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n            ],\n          },\n          { name: \"nonce\", type: \"uint256\", internalType: \"uint256\" },\n          { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n        ],\n      },\n      { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n      { name: \"owner\", type: \"address\", internalType: \"address\" },\n      {\n        name: \"witness\",\n        type: \"tuple\",\n        internalType: \"struct x402UptoPermit2Proxy.Witness\",\n        components: uptoPermit2WitnessABIComponents,\n      },\n      { name: \"signature\", type: \"bytes\", internalType: \"bytes\" },\n    ],\n    outputs: [],\n    stateMutability: \"nonpayable\",\n  },\n  {\n    type: \"function\",\n    name: \"settleWithPermit\",\n    inputs: [\n      {\n        name: \"permit2612\",\n        type: \"tuple\",\n        internalType: \"struct x402UptoPermit2Proxy.EIP2612Permit\",\n        components: [\n          { name: \"value\", type: \"uint256\", internalType: \"uint256\" },\n          { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n          { name: \"r\", type: \"bytes32\", internalType: \"bytes32\" },\n          { name: \"s\", type: \"bytes32\", internalType: \"bytes32\" },\n          { name: \"v\", type: \"uint8\", internalType: \"uint8\" },\n        ],\n      },\n      {\n        name: \"permit\",\n        type: \"tuple\",\n        internalType: \"struct ISignatureTransfer.PermitTransferFrom\",\n        components: [\n          {\n            name: \"permitted\",\n            type: \"tuple\",\n            internalType: \"struct ISignatureTransfer.TokenPermissions\",\n            components: [\n              { name: \"token\", type: \"address\", internalType: \"address\" },\n              { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n            ],\n          },\n          { name: \"nonce\", type: \"uint256\", internalType: \"uint256\" },\n          { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n        ],\n      },\n      { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n      { name: \"owner\", type: \"address\", internalType: \"address\" },\n      {\n        name: \"witness\",\n        type: \"tuple\",\n        internalType: \"struct x402UptoPermit2Proxy.Witness\",\n        components: uptoPermit2WitnessABIComponents,\n      },\n      { name: \"signature\", type: \"bytes\", internalType: \"bytes\" },\n    ],\n    outputs: [],\n    stateMutability: \"nonpayable\",\n  },\n  { type: \"event\", name: \"Settled\", inputs: [], anonymous: false },\n  { type: \"event\", name: \"SettledWithPermit\", inputs: [], anonymous: false },\n  { type: \"error\", name: \"AmountExceedsPermitted\", inputs: [] },\n  { type: \"error\", name: \"InvalidDestination\", inputs: [] },\n  { type: \"error\", name: \"InvalidOwner\", inputs: [] },\n  { type: \"error\", name: \"InvalidPermit2Address\", inputs: [] },\n  { type: \"error\", name: \"PaymentTooEarly\", inputs: [] },\n  { type: \"error\", name: \"Permit2612AmountMismatch\", inputs: [] },\n  { type: \"error\", name: \"ReentrancyGuardReentrantCall\", inputs: [] },\n  { type: \"error\", name: \"UnauthorizedFacilitator\", inputs: [] },\n] as const;\n\n/**\n * x402ExactPermit2Proxy ABI - settle function for exact payment scheme.\n */\nexport const x402ExactPermit2ProxyABI = [\n  {\n    type: \"function\",\n    name: \"PERMIT2\",\n    inputs: [],\n    outputs: [{ name: \"\", type: \"address\", internalType: \"contract ISignatureTransfer\" }],\n    stateMutability: \"view\",\n  },\n  {\n    type: \"function\",\n    name: \"WITNESS_TYPEHASH\",\n    inputs: [],\n    outputs: [{ name: \"\", type: \"bytes32\", internalType: \"bytes32\" }],\n    stateMutability: \"view\",\n  },\n  {\n    type: \"function\",\n    name: \"WITNESS_TYPE_STRING\",\n    inputs: [],\n    outputs: [{ name: \"\", type: \"string\", internalType: \"string\" }],\n    stateMutability: \"view\",\n  },\n  {\n    type: \"function\",\n    name: \"settle\",\n    inputs: [\n      {\n        name: \"permit\",\n        type: \"tuple\",\n        internalType: \"struct ISignatureTransfer.PermitTransferFrom\",\n        components: [\n          {\n            name: \"permitted\",\n            type: \"tuple\",\n            internalType: \"struct ISignatureTransfer.TokenPermissions\",\n            components: [\n              { name: \"token\", type: \"address\", internalType: \"address\" },\n              { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n            ],\n          },\n          { name: \"nonce\", type: \"uint256\", internalType: \"uint256\" },\n          { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n        ],\n      },\n      { name: \"owner\", type: \"address\", internalType: \"address\" },\n      {\n        name: \"witness\",\n        type: \"tuple\",\n        internalType: \"struct x402ExactPermit2Proxy.Witness\",\n        components: permit2WitnessABIComponents,\n      },\n      { name: \"signature\", type: \"bytes\", internalType: \"bytes\" },\n    ],\n    outputs: [],\n    stateMutability: \"nonpayable\",\n  },\n  {\n    type: \"function\",\n    name: \"settleWithPermit\",\n    inputs: [\n      {\n        name: \"permit2612\",\n        type: \"tuple\",\n        internalType: \"struct x402ExactPermit2Proxy.EIP2612Permit\",\n        components: [\n          { name: \"value\", type: \"uint256\", internalType: \"uint256\" },\n          { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n          { name: \"r\", type: \"bytes32\", internalType: \"bytes32\" },\n          { name: \"s\", type: \"bytes32\", internalType: \"bytes32\" },\n          { name: \"v\", type: \"uint8\", internalType: \"uint8\" },\n        ],\n      },\n      {\n        name: \"permit\",\n        type: \"tuple\",\n        internalType: \"struct ISignatureTransfer.PermitTransferFrom\",\n        components: [\n          {\n            name: \"permitted\",\n            type: \"tuple\",\n            internalType: \"struct ISignatureTransfer.TokenPermissions\",\n            components: [\n              { name: \"token\", type: \"address\", internalType: \"address\" },\n              { name: \"amount\", type: \"uint256\", internalType: \"uint256\" },\n            ],\n          },\n          { name: \"nonce\", type: \"uint256\", internalType: \"uint256\" },\n          { name: \"deadline\", type: \"uint256\", internalType: \"uint256\" },\n        ],\n      },\n      { name: \"owner\", type: \"address\", internalType: \"address\" },\n      {\n        name: \"witness\",\n        type: \"tuple\",\n        internalType: \"struct x402ExactPermit2Proxy.Witness\",\n        components: permit2WitnessABIComponents,\n      },\n      { name: \"signature\", type: \"bytes\", internalType: \"bytes\" },\n    ],\n    outputs: [],\n    stateMutability: \"nonpayable\",\n  },\n  { type: \"event\", name: \"Settled\", inputs: [], anonymous: false },\n  { type: \"event\", name: \"SettledWithPermit\", inputs: [], anonymous: false },\n  { type: \"error\", name: \"InvalidAmount\", inputs: [] },\n  { type: \"error\", name: \"InvalidDestination\", inputs: [] },\n  { type: \"error\", name: \"InvalidOwner\", inputs: [] },\n  { type: \"error\", name: \"InvalidPermit2Address\", inputs: [] },\n  { type: \"error\", name: \"PaymentTooEarly\", inputs: [] },\n  { type: \"error\", name: \"Permit2612AmountMismatch\", inputs: [] },\n  { type: \"error\", name: \"ReentrancyGuardReentrantCall\", inputs: [] },\n] as const;\n","/**\n * Parse chainId from CAIP-2 network identifier\n *\n * @param network - CAIP-2 network identifier (e.g., 'eip155:84532')\n * @returns The chain ID as a number\n */\nexport function parseChainId(network: string): number {\n  const parts = network.split(\":\");\n  if (parts.length !== 2 || parts[0] !== \"eip155\") {\n    throw new Error(`Invalid network format: ${network}. Expected 'eip155:<chainId>'`);\n  }\n  const chainId = parseInt(parts[1], 10);\n  if (isNaN(chainId)) {\n    throw new Error(`Invalid chainId in network: ${network}`);\n  }\n  return chainId;\n}\n"],"mappings":"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","names":["import_viem","signature","payload"]}

package/dist/cjs/batch-settlement/client/file-storage.d.ts

@@ -0,0 +1,47 @@
+import { F as FileChannelStorageOptions } from '../../types-DIt9uAUy.js';
+import { C as ClientChannelStorage, B as BatchSettlementClientContext } from '../../storage-6W5MO46W.js';
+import 'viem';
+
+/**
+ * Node.js file-backed {@link ClientChannelStorage} for the batched client scheme.
+ * Each channel's context is persisted as `{root}/client/{channelId}.json` so that channel
+ * records survive process restarts.
+ */
+declare class FileClientChannelStorage implements ClientChannelStorage {
+    private readonly root;
+    /**
+     * Creates file-backed client channel storage under the given root directory.
+     *
+     * @param options - Configuration including the storage root directory.
+     */
+    constructor(options: FileChannelStorageOptions);
+    /**
+     * Loads the stored client context for a channel, if present.
+     *
+     * @param key - Channel storage key (typically a lowercased channelId).
+     * @returns Parsed context or `undefined` when the file is missing.
+     */
+    get(key: string): Promise<BatchSettlementClientContext | undefined>;
+    /**
+     * Persists the client context for a channel.
+     *
+     * @param key - Channel storage key.
+     * @param context - Context record to write.
+     */
+    set(key: string, context: BatchSettlementClientContext): Promise<void>;
+    /**
+     * Removes the persisted context file for a channel, if it exists.
+     *
+     * @param key - Channel storage key.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Absolute path to the JSON file for a channel.
+     *
+     * @param key - Channel storage key.
+     * @returns Filesystem path under `{root}/client/...`.
+     */
+    private filePath;
+}
+
+export { FileChannelStorageOptions, FileClientChannelStorage };