@bankofai/x402-evm 1.0.0-beta.0

package/dist/cjs/v1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/v1/index.ts","../../../src/exact/v1/client/scheme.ts","../../../src/constants.ts","../../../src/utils.ts","../../../src/shared/extensions/gasSponsoring.ts","../../../src/exact/client/eip2612.ts","../../../src/exact/client/erc20approval.ts","../../../src/shared/rpc.ts","../../../src/exact/v1/facilitator/scheme.ts","../../../src/exact/facilitator/eip3009-utils.ts","../../../src/multicall.ts"],"sourcesContent":["export { ExactEvmSchemeV1 } from \"../exact/v1\";\n\nexport const EVM_NETWORK_CHAIN_ID_MAP = {\n  ethereum: 1,\n  sepolia: 11155111,\n  abstract: 2741,\n  \"abstract-testnet\": 11124,\n  \"base-sepolia\": 84532,\n  base: 8453,\n  \"avalanche-fuji\": 43113,\n  avalanche: 43114,\n  iotex: 4689,\n  sei: 1329,\n  \"sei-testnet\": 1328,\n  polygon: 137,\n  \"polygon-amoy\": 80002,\n  peaq: 3338,\n  story: 1514,\n  educhain: 41923,\n  \"skale-base-sepolia\": 324705682,\n  megaeth: 4326,\n  monad: 143,\n  stable: 988,\n  \"stable-testnet\": 2201,\n} as const;\n\nexport type EvmNetworkV1 = keyof typeof EVM_NETWORK_CHAIN_ID_MAP;\n\nexport const NETWORKS: string[] = Object.keys(EVM_NETWORK_CHAIN_ID_MAP);\n\n/**\n * Extract chain ID from a v1 legacy network name.\n *\n * @param network - The v1 network name (e.g., \"base-sepolia\", \"polygon\")\n * @returns The numeric chain ID\n * @throws Error if the network name is not a known v1 network\n */\nexport function getEvmChainIdV1(network: string): number {\n  const chainId = EVM_NETWORK_CHAIN_ID_MAP[network as EvmNetworkV1];\n  if (!chainId) {\n    throw new Error(`Unsupported v1 network: ${network}`);\n  }\n  return chainId;\n}\n","import {\n  Network,\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkClient,\n} from \"@bankofai/x402-core/types\";\nimport { PaymentRequirementsV1 } from \"@bankofai/x402-core/types/v1\";\nimport { getAddress } from \"viem\";\nimport { authorizationTypes } from \"../../../constants\";\nimport { ClientEvmSigner } from \"../../../signer\";\nimport { ExactEvmPayloadV1 } from \"../../../types\";\nimport { createNonce } from \"../../../utils\";\nimport { EvmNetworkV1, getEvmChainIdV1 } from \"../../../v1\";\n\n/**\n * EVM client implementation for the Exact payment scheme (V1).\n */\nexport class ExactEvmSchemeV1 implements SchemeNetworkClient {\n  readonly scheme = \"exact\";\n\n  /**\n   * Creates a new ExactEvmClientV1 instance.\n   *\n   * @param signer - The EVM signer for client operations\n   */\n  constructor(private readonly signer: ClientEvmSigner) {}\n\n  /**\n   * Creates a payment payload for the Exact scheme (V1).\n   *\n   * @param x402Version - The x402 protocol version\n   * @param paymentRequirements - The payment requirements\n   * @returns Promise resolving to a payment payload\n   */\n  async createPaymentPayload(\n    x402Version: number,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<\n    Pick<PaymentPayload, \"x402Version\" | \"payload\"> & { scheme: string; network: Network }\n  > {\n    const selectedV1 = paymentRequirements as unknown as PaymentRequirementsV1;\n    const nonce = createNonce();\n    const now = Math.floor(Date.now() / 1000);\n\n    const authorization: ExactEvmPayloadV1[\"authorization\"] = {\n      from: this.signer.address,\n      to: getAddress(selectedV1.payTo),\n      value: selectedV1.maxAmountRequired,\n      validAfter: (now - 600).toString(), // 10 minutes before\n      validBefore: (now + selectedV1.maxTimeoutSeconds).toString(),\n      nonce,\n    };\n\n    // Sign the authorization\n    const signature = await this.signAuthorization(authorization, selectedV1);\n\n    const payload: ExactEvmPayloadV1 = {\n      authorization,\n      signature,\n    };\n\n    return {\n      x402Version,\n      scheme: selectedV1.scheme,\n      network: selectedV1.network,\n      payload,\n    };\n  }\n\n  /**\n   * Sign the EIP-3009 authorization using EIP-712\n   *\n   * @param authorization - The authorization to sign\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to the signature\n   */\n  private async signAuthorization(\n    authorization: ExactEvmPayloadV1[\"authorization\"],\n    requirements: PaymentRequirementsV1,\n  ): Promise<`0x${string}`> {\n    const chainId = getEvmChainIdV1(requirements.network as EvmNetworkV1);\n\n    if (!requirements.extra?.name || !requirements.extra?.version) {\n      throw new Error(\n        `EIP-712 domain parameters (name, version) are required in payment requirements for asset ${requirements.asset}`,\n      );\n    }\n\n    const { name, version } = requirements.extra;\n\n    const domain = {\n      name,\n      version,\n      chainId,\n      verifyingContract: getAddress(requirements.asset),\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 await this.signer.signTypedData({\n      domain,\n      types: authorizationTypes,\n      primaryType: \"TransferWithAuthorization\",\n      message,\n    });\n  }\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","import { toHex } from \"viem\";\n\n/**\n * Extract chain ID from a CAIP-2 network identifier (eip155:CHAIN_ID).\n *\n * @param network - The network identifier in CAIP-2 format (e.g., \"eip155:8453\")\n * @returns The numeric chain ID\n * @throws Error if the network format is invalid\n */\nexport function getEvmChainId(network: string): number {\n  if (network.startsWith(\"eip155:\")) {\n    const idStr = network.split(\":\")[1];\n    const chainId = parseInt(idStr, 10);\n    if (isNaN(chainId)) {\n      throw new Error(`Invalid CAIP-2 chain ID: ${network}`);\n    }\n    return chainId;\n  }\n\n  throw new Error(`Unsupported network format: ${network} (expected eip155:CHAIN_ID)`);\n}\n\n/**\n * Get the crypto object from the global scope.\n *\n * @returns The crypto object\n * @throws Error if crypto API is not available\n */\nfunction getCrypto(): Crypto {\n  const cryptoObj = globalThis.crypto as Crypto | undefined;\n  if (!cryptoObj) {\n    throw new Error(\"Crypto API not available\");\n  }\n  return cryptoObj;\n}\n\n/**\n * Create a random 32-byte nonce for EIP-3009 authorization.\n *\n * @returns A hex-encoded 32-byte nonce\n */\nexport function createNonce(): `0x${string}` {\n  return toHex(getCrypto().getRandomValues(new Uint8Array(32)));\n}\n\n/**\n * Creates a random 256-bit nonce for Permit2.\n * Permit2 uses uint256 nonces (not bytes32 like EIP-3009).\n *\n * @returns A string representation of the random nonce\n */\nexport function createPermit2Nonce(): string {\n  const randomBytes = getCrypto().getRandomValues(new Uint8Array(32));\n  return BigInt(toHex(randomBytes)).toString();\n}\n","import type {\n  PaymentRequirements,\n  PaymentPayloadResult,\n  PaymentPayloadContext,\n} from \"@bankofai/x402-core/types\";\nimport {\n  EIP2612_GAS_SPONSORING_KEY,\n  ERC20_APPROVAL_GAS_SPONSORING_KEY,\n} from \"../../exact/extensions\";\nimport { getAddress } from \"viem\";\nimport { PERMIT2_ADDRESS, erc20AllowanceAbi } from \"../../constants\";\nimport { getEvmChainId } from \"../../utils\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport { signEip2612Permit } from \"../../exact/client/eip2612\";\nimport { signErc20ApprovalTransaction } from \"../../exact/client/erc20approval\";\nimport { resolveExtensionRpcCapabilities, type ExactEvmSchemeOptions } from \"../rpc\";\n\n/**\n * Attempts to sign an EIP-2612 permit for gasless Permit2 approval.\n *\n * @param signer - The EVM client signer\n * @param options - Optional RPC configuration for backfilling capabilities\n * @param requirements - The payment requirements from the server\n * @param result - The payment payload result from the scheme\n * @param context - Optional context containing server extensions and metadata\n * @param approvalAmount - Optional amount to approve instead of `requirements.amount`\n * @returns Extension data for EIP-2612 gas sponsoring, or undefined if not applicable\n */\nexport async function trySignEip2612PermitExtension(\n  signer: ClientEvmSigner,\n  options: ExactEvmSchemeOptions | undefined,\n  requirements: PaymentRequirements,\n  result: PaymentPayloadResult,\n  context?: PaymentPayloadContext,\n  approvalAmount?: string,\n): Promise<Record<string, unknown> | undefined> {\n  const capabilities = resolveExtensionRpcCapabilities(requirements.network, signer, options);\n\n  if (!capabilities.readContract) {\n    return undefined;\n  }\n\n  if (!context?.extensions?.[EIP2612_GAS_SPONSORING_KEY]) {\n    return undefined;\n  }\n\n  const tokenName = requirements.extra?.name as string | undefined;\n  const tokenVersion = requirements.extra?.version as string | undefined;\n  if (!tokenName || !tokenVersion) {\n    return undefined;\n  }\n\n  const chainId = getEvmChainId(requirements.network);\n  const tokenAddress = getAddress(requirements.asset) as `0x${string}`;\n  const requiredAllowance = approvalAmount ?? requirements.amount;\n\n  try {\n    const allowance = (await capabilities.readContract({\n      address: tokenAddress,\n      abi: erc20AllowanceAbi,\n      functionName: \"allowance\",\n      args: [signer.address, PERMIT2_ADDRESS],\n    })) as bigint;\n\n    if (allowance >= BigInt(requiredAllowance)) {\n      return undefined;\n    }\n  } catch {\n    // Allowance check failed, proceed with signing\n  }\n\n  const permit2Auth = result.payload?.permit2Authorization as Record<string, unknown> | undefined;\n  const deadline =\n    (permit2Auth?.deadline as string) ??\n    Math.floor(Date.now() / 1000 + requirements.maxTimeoutSeconds).toString();\n\n  const info = await signEip2612Permit(\n    {\n      address: signer.address,\n      signTypedData: msg => signer.signTypedData(msg),\n      readContract: capabilities.readContract,\n    },\n    tokenAddress,\n    tokenName,\n    tokenVersion,\n    chainId,\n    deadline,\n    requiredAllowance,\n  );\n\n  return {\n    [EIP2612_GAS_SPONSORING_KEY]: { info },\n  };\n}\n\n/**\n * Attempts to sign an ERC-20 approval transaction for gasless Permit2 approval.\n *\n * @param signer - The EVM client signer\n * @param options - Optional RPC configuration for backfilling capabilities\n * @param requirements - The payment requirements from the server\n * @param context - Optional context containing server extensions and metadata\n * @param approvalAmount - Optional amount to check for Permit2 allowance\n * @returns Extension data for ERC-20 approval gas sponsoring, or undefined if not applicable\n */\nexport async function trySignErc20ApprovalExtension(\n  signer: ClientEvmSigner,\n  options: ExactEvmSchemeOptions | undefined,\n  requirements: PaymentRequirements,\n  context?: PaymentPayloadContext,\n  approvalAmount?: string,\n): Promise<Record<string, unknown> | undefined> {\n  const capabilities = resolveExtensionRpcCapabilities(requirements.network, signer, options);\n\n  if (!capabilities.readContract) {\n    return undefined;\n  }\n\n  if (!context?.extensions?.[ERC20_APPROVAL_GAS_SPONSORING_KEY]) {\n    return undefined;\n  }\n\n  if (!capabilities.signTransaction || !capabilities.getTransactionCount) {\n    return undefined;\n  }\n\n  const chainId = getEvmChainId(requirements.network);\n  const tokenAddress = getAddress(requirements.asset) as `0x${string}`;\n  const requiredAllowance = approvalAmount ?? requirements.amount;\n\n  try {\n    const allowance = (await capabilities.readContract({\n      address: tokenAddress,\n      abi: erc20AllowanceAbi,\n      functionName: \"allowance\",\n      args: [signer.address, PERMIT2_ADDRESS],\n    })) as bigint;\n\n    if (allowance >= BigInt(requiredAllowance)) {\n      return undefined;\n    }\n  } catch {\n    // Allowance check failed, proceed with signing\n  }\n\n  const info = await signErc20ApprovalTransaction(\n    {\n      address: signer.address,\n      signTransaction: capabilities.signTransaction,\n      getTransactionCount: capabilities.getTransactionCount,\n      estimateFeesPerGas: capabilities.estimateFeesPerGas,\n    },\n    tokenAddress,\n    chainId,\n  );\n\n  return {\n    [ERC20_APPROVAL_GAS_SPONSORING_KEY]: { info },\n  };\n}\n","import { getAddress } from \"viem\";\nimport { eip2612PermitTypes, eip2612NoncesAbi, PERMIT2_ADDRESS } from \"../../constants\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport type { Eip2612GasSponsoringInfo } from \"../extensions\";\n\nexport type Eip2612PermitSigner = Pick<ClientEvmSigner, \"address\" | \"signTypedData\"> & {\n  readContract: NonNullable<ClientEvmSigner[\"readContract\"]>;\n};\n\n/**\n * Signs an EIP-2612 permit authorizing the Permit2 contract to spend tokens.\n *\n * This creates a gasless off-chain signature that the facilitator can submit\n * on-chain via `x402Permit2Proxy.settleWithPermit()`.\n *\n * The `permittedAmount` must match the Permit2 `permitted.amount` exactly, as the\n * proxy contract enforces `permit2612.value == permittedAmount`.\n *\n * @param signer - The client EVM signer (must support readContract for nonce query)\n * @param tokenAddress - The ERC-20 token contract address\n * @param tokenName - The token name (from paymentRequirements.extra.name)\n * @param tokenVersion - The token version (from paymentRequirements.extra.version)\n * @param chainId - The chain ID\n * @param deadline - The deadline for the permit (unix timestamp as string)\n * @param permittedAmount - The Permit2 permitted amount (must match exactly)\n * @returns The EIP-2612 gas sponsoring info object\n */\nexport async function signEip2612Permit(\n  signer: Eip2612PermitSigner,\n  tokenAddress: `0x${string}`,\n  tokenName: string,\n  tokenVersion: string,\n  chainId: number,\n  deadline: string,\n  permittedAmount: string,\n): Promise<Eip2612GasSponsoringInfo> {\n  const owner = signer.address;\n  const spender = getAddress(PERMIT2_ADDRESS);\n\n  // Query the current EIP-2612 nonce from the token contract\n  const nonce = (await signer.readContract({\n    address: tokenAddress,\n    abi: eip2612NoncesAbi,\n    functionName: \"nonces\",\n    args: [owner],\n  })) as bigint;\n\n  // Construct EIP-712 domain for the token's permit function\n  const domain = {\n    name: tokenName,\n    version: tokenVersion,\n    chainId,\n    verifyingContract: tokenAddress,\n  };\n\n  const approvalAmount = BigInt(permittedAmount);\n\n  const message = {\n    owner,\n    spender,\n    value: approvalAmount,\n    nonce,\n    deadline: BigInt(deadline),\n  };\n\n  // Sign the EIP-2612 permit\n  const signature = await signer.signTypedData({\n    domain,\n    types: eip2612PermitTypes,\n    primaryType: \"Permit\",\n    message,\n  });\n\n  return {\n    from: owner,\n    asset: tokenAddress,\n    spender,\n    amount: approvalAmount.toString(),\n    nonce: nonce.toString(),\n    deadline,\n    signature,\n    version: \"1\",\n  };\n}\n","import { encodeFunctionData, getAddress, maxUint256 } from \"viem\";\nimport {\n  PERMIT2_ADDRESS,\n  erc20ApproveAbi,\n  ERC20_APPROVE_GAS_LIMIT,\n  DEFAULT_MAX_FEE_PER_GAS,\n  DEFAULT_MAX_PRIORITY_FEE_PER_GAS,\n} from \"../../constants\";\nimport { ClientEvmSigner } from \"../../signer\";\nimport {\n  ERC20_APPROVAL_GAS_SPONSORING_VERSION,\n  type Erc20ApprovalGasSponsoringInfo,\n} from \"../extensions\";\n\nexport type Erc20ApprovalTxSigner = Pick<ClientEvmSigner, \"address\"> & {\n  signTransaction: NonNullable<ClientEvmSigner[\"signTransaction\"]>;\n  getTransactionCount: NonNullable<ClientEvmSigner[\"getTransactionCount\"]>;\n  estimateFeesPerGas?: NonNullable<ClientEvmSigner[\"estimateFeesPerGas\"]>;\n};\n\n/**\n * Signs an EIP-1559 `approve(Permit2, MaxUint256)` transaction for the given token.\n *\n * The signed transaction is NOT broadcast here — the facilitator broadcasts it\n * atomically before settling the Permit2 payment. This enables Permit2 payments\n * for generic ERC-20 tokens that do NOT implement EIP-2612.\n *\n * Always approves MaxUint256 regardless of the payment amount.\n *\n * @param signer - The client EVM signer (must support signTransaction, getTransactionCount)\n * @param tokenAddress - The ERC-20 token contract address\n * @param chainId - The chain ID\n * @returns The ERC-20 approval gas sponsoring info object\n */\nexport async function signErc20ApprovalTransaction(\n  signer: Erc20ApprovalTxSigner,\n  tokenAddress: `0x${string}`,\n  chainId: number,\n): Promise<Erc20ApprovalGasSponsoringInfo> {\n  const from = signer.address;\n  const spender = getAddress(PERMIT2_ADDRESS);\n\n  // Encode approve(PERMIT2_ADDRESS, MaxUint256) calldata\n  const data = encodeFunctionData({\n    abi: erc20ApproveAbi,\n    functionName: \"approve\",\n    args: [spender, maxUint256],\n  });\n\n  // Get current nonce for the sender\n  const nonce = await signer.getTransactionCount({ address: from });\n\n  // Get current fee estimates, with fallback values\n  let maxFeePerGas: bigint;\n  let maxPriorityFeePerGas: bigint;\n  try {\n    const fees = await signer.estimateFeesPerGas?.();\n    if (!fees) {\n      throw new Error(\"no fee estimates available\");\n    }\n    maxFeePerGas = fees.maxFeePerGas;\n    maxPriorityFeePerGas = fees.maxPriorityFeePerGas;\n  } catch {\n    maxFeePerGas = DEFAULT_MAX_FEE_PER_GAS;\n    maxPriorityFeePerGas = DEFAULT_MAX_PRIORITY_FEE_PER_GAS;\n  }\n\n  // Sign the EIP-1559 transaction (not broadcast)\n  const signedTransaction = await signer.signTransaction({\n    to: tokenAddress,\n    data,\n    nonce,\n    gas: ERC20_APPROVE_GAS_LIMIT,\n    maxFeePerGas,\n    maxPriorityFeePerGas,\n    chainId,\n  });\n\n  return {\n    from,\n    asset: tokenAddress,\n    spender,\n    amount: maxUint256.toString(),\n    signedTransaction,\n    version: ERC20_APPROVAL_GAS_SPONSORING_VERSION,\n  };\n}\n","import { createPublicClient, http } from \"viem\";\nimport type { ClientEvmSigner } from \"../signer\";\nimport { getEvmChainId } from \"../utils\";\n\nexport type EvmSchemeConfig = {\n  rpcUrl?: string;\n};\n\nexport type EvmSchemeConfigByChainId = Record<number, EvmSchemeConfig>;\n\nexport type EvmSchemeOptions = EvmSchemeConfig | EvmSchemeConfigByChainId;\n\n/** @deprecated Use EvmSchemeConfig */\nexport type ExactEvmSchemeConfig = EvmSchemeConfig;\n/** @deprecated Use EvmSchemeConfigByChainId */\nexport type ExactEvmSchemeConfigByChainId = EvmSchemeConfigByChainId;\n/** @deprecated Use EvmSchemeOptions */\nexport type ExactEvmSchemeOptions = EvmSchemeOptions;\n\ntype ExtensionRpcCapabilities = Pick<\n  ClientEvmSigner,\n  \"readContract\" | \"signTransaction\" | \"getTransactionCount\" | \"estimateFeesPerGas\"\n>;\n\nconst rpcClientCache = new Map<string, ReturnType<typeof createPublicClient>>();\n\n/**\n * Check if options is a per-chain-id configuration map.\n *\n * @param options - The EVM scheme options to check\n * @returns True if the options are keyed by chain ID\n */\nfunction isConfigByChainId(options: EvmSchemeOptions): options is EvmSchemeConfigByChainId {\n  const keys = Object.keys(options);\n  return keys.length > 0 && keys.every(key => /^\\d+$/.test(key));\n}\n\n/**\n * Get or create a cached viem public client for the given RPC URL.\n *\n * @param rpcUrl - The JSON-RPC endpoint URL\n * @returns A viem PublicClient instance\n */\nfunction getRpcClient(rpcUrl: string): ReturnType<typeof createPublicClient> {\n  const existing = rpcClientCache.get(rpcUrl);\n  if (existing) {\n    return existing;\n  }\n\n  const client = createPublicClient({\n    transport: http(rpcUrl),\n  });\n  rpcClientCache.set(rpcUrl, client);\n  return client;\n}\n\n/**\n * Resolve an RPC URL from scheme options for the given network.\n *\n * @param network - The CAIP-2 network identifier\n * @param options - Optional EVM scheme options (flat or per-chain-id)\n * @returns The resolved RPC URL, or undefined if not configured\n */\nexport function resolveRpcUrl(network: string, options?: EvmSchemeOptions): string | undefined {\n  if (!options) {\n    return undefined;\n  }\n\n  if (isConfigByChainId(options)) {\n    const chainId = getEvmChainId(network);\n    const optionsByChainId = options as EvmSchemeConfigByChainId;\n    return optionsByChainId[chainId]?.rpcUrl;\n  }\n\n  return (options as EvmSchemeConfig).rpcUrl;\n}\n\n/**\n * Resolve RPC capabilities for extensions, backfilling from a public RPC client when the signer lacks them.\n *\n * @param network - The CAIP-2 network identifier\n * @param signer - The client EVM signer\n * @param options - Optional EVM scheme options for RPC URL resolution\n * @returns Extension RPC capabilities (readContract, signTransaction, etc.)\n */\nexport function resolveExtensionRpcCapabilities(\n  network: string,\n  signer: ClientEvmSigner,\n  options?: EvmSchemeOptions,\n): ExtensionRpcCapabilities {\n  const capabilities: ExtensionRpcCapabilities = {\n    signTransaction: signer.signTransaction,\n    readContract: signer.readContract,\n    getTransactionCount: signer.getTransactionCount,\n    estimateFeesPerGas: signer.estimateFeesPerGas,\n  };\n\n  const needsRpcBackfill =\n    !capabilities.readContract ||\n    !capabilities.getTransactionCount ||\n    !capabilities.estimateFeesPerGas;\n  if (!needsRpcBackfill) {\n    return capabilities;\n  }\n\n  const rpcUrl = resolveRpcUrl(network, options);\n  if (!rpcUrl) {\n    return capabilities;\n  }\n  const rpcClient = getRpcClient(rpcUrl);\n  if (!capabilities.readContract) {\n    capabilities.readContract = args => rpcClient.readContract(args as never) as Promise<unknown>;\n  }\n  if (!capabilities.getTransactionCount) {\n    capabilities.getTransactionCount = async args =>\n      rpcClient.getTransactionCount({ address: args.address });\n  }\n  if (!capabilities.estimateFeesPerGas) {\n    capabilities.estimateFeesPerGas = async () => rpcClient.estimateFeesPerGas();\n  }\n\n  return capabilities;\n}\n","import {\n  PaymentPayload,\n  PaymentPayloadV1,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  FacilitatorContext,\n  SettleResponse,\n  VerifyResponse,\n} from \"@bankofai/x402-core/types\";\nimport { resolveDataSuffix } from \"../../../shared/extensions\";\nimport { PaymentRequirementsV1 } from \"@bankofai/x402-core/types/v1\";\nimport { getAddress, Hex, isAddressEqual, parseErc6492Signature } from \"viem\";\nimport { authorizationTypes } from \"../../../constants\";\nimport { FacilitatorEvmSigner } from \"../../../signer\";\nimport { ExactEvmPayloadV1 } from \"../../../types\";\nimport { EvmNetworkV1, getEvmChainIdV1 } from \"../../../v1\";\nimport * as Errors from \"../../facilitator/errors\";\nimport {\n  diagnoseEip3009SimulationFailure,\n  executeTransferWithAuthorization,\n  simulateEip3009Transfer,\n} from \"../../facilitator/eip3009-utils\";\n\nexport interface VerifyV1Options {\n  /** Run onchain simulation. Defaults to true. */\n  simulate?: boolean;\n}\n\nexport interface ExactEvmSchemeV1Config {\n  /**\n   * Allowlist of factory contract addresses (hex strings, case-insensitive) that the facilitator\n   * will call when deploying an undeployed smart wallet via ERC-6492.\n   *\n   * A non-empty list enables ERC-4337 smart wallet deployment via EIP-6492. Facilitators must\n   * explicitly list every factory they trust to prevent arbitrary transaction injection via\n   * attacker-controlled ERC-6492 signature wrappers. An empty or omitted list denies all factory\n   * deployment calls.\n   *\n   * @default []\n   */\n  eip6492AllowedFactories?: string[];\n  /**\n   * If enabled, simulates transaction before settling. Defaults to false, ie only simulate during verify.\n   *\n   * @default false\n   */\n  simulateInSettle?: boolean;\n}\n\n/**\n * EVM facilitator implementation for the Exact payment scheme (V1).\n */\nexport class ExactEvmSchemeV1 implements SchemeNetworkFacilitator {\n  readonly scheme = \"exact\";\n  readonly caipFamily = \"eip155:*\";\n  private readonly config: Required<ExactEvmSchemeV1Config>;\n\n  /**\n   * Creates a new ExactEvmFacilitatorV1 instance.\n   *\n   * @param signer - The EVM signer for facilitator operations\n   * @param config - Optional configuration for the facilitator\n   */\n  constructor(\n    private readonly signer: FacilitatorEvmSigner,\n    config?: ExactEvmSchemeV1Config,\n  ) {\n    this.config = {\n      eip6492AllowedFactories: config?.eip6492AllowedFactories ?? [],\n      simulateInSettle: config?.simulateInSettle ?? false,\n    };\n  }\n\n  /**\n   * Get mechanism-specific extra data for the supported kinds endpoint.\n   * For EVM, no extra data is needed.\n   *\n   * @param _ - The network identifier (unused for EVM)\n   * @returns undefined (EVM has no extra data)\n   */\n  getExtra(_: string): Record<string, unknown> | undefined {\n    return undefined;\n  }\n\n  /**\n   * Get signer addresses used by this facilitator.\n   * Returns all addresses this facilitator can use for signing/settling transactions.\n   *\n   * @param _ - The network identifier (unused for EVM, addresses are network-agnostic)\n   * @returns Array of facilitator wallet addresses\n   */\n  getSigners(_: string): string[] {\n    return [...this.signer.getAddresses()];\n  }\n\n  /**\n   * Verifies a payment payload (V1).\n   *\n   * @param payload - The payment payload to verify\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to verification response\n   */\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<VerifyResponse> {\n    return this._verify(payload, requirements);\n  }\n\n  /**\n   * Settles a payment by executing the transfer (V1).\n   *\n   * @param payload - The payment payload to settle\n   * @param requirements - The payment requirements\n   * @param context - Optional facilitator context for extension capabilities\n   * @returns Promise resolving to settlement response\n   */\n  async settle(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n    context?: FacilitatorContext,\n  ): Promise<SettleResponse> {\n    const payloadV1 = payload as unknown as PaymentPayloadV1;\n    const exactEvmPayload = payload.payload as ExactEvmPayloadV1;\n\n    // Re-verify before settling\n    const valid = await this._verify(payload, requirements, {\n      simulate: this.config.simulateInSettle ?? false,\n    });\n    if (!valid.isValid) {\n      return {\n        success: false,\n        network: payloadV1.network,\n        transaction: \"\",\n        errorReason: valid.invalidReason ?? Errors.ErrInvalidScheme,\n        payer: exactEvmPayload.authorization.from,\n      };\n    }\n\n    try {\n      // Parse ERC-6492 signature if applicable (for optional deployment)\n      const { address: factoryAddress, data: factoryCalldata } = parseErc6492Signature(\n        exactEvmPayload.signature!,\n      );\n\n      // Deploy ERC-4337 smart wallet via EIP-6492 if factory is in the allowlist\n      if (\n        factoryAddress &&\n        factoryCalldata &&\n        !isAddressEqual(factoryAddress, \"0x0000000000000000000000000000000000000000\")\n      ) {\n        // Check if smart wallet is already deployed\n        const payerAddress = exactEvmPayload.authorization.from;\n        const bytecode = await this.signer.getCode({ address: payerAddress });\n\n        if (!bytecode || bytecode === \"0x\") {\n          const normalizedFactory = factoryAddress.toLowerCase();\n          const isAllowed = (this.config.eip6492AllowedFactories ?? []).some(\n            allowed => allowed.toLowerCase() === normalizedFactory,\n          );\n          if (!isAllowed) {\n            return {\n              success: false,\n              errorReason: Errors.ErrFactoryNotAllowed,\n              transaction: \"\",\n              network: payloadV1.network,\n              payer: exactEvmPayload.authorization.from,\n            };\n          }\n\n          // Send the factory calldata directly as a transaction\n          // The factoryCalldata already contains the complete encoded function call\n          const deployTx = await this.signer.sendTransaction({\n            to: factoryAddress as Hex,\n            data: factoryCalldata as Hex,\n          });\n\n          // Wait for deployment transaction\n          await this.signer.waitForTransactionReceipt({ hash: deployTx });\n        }\n      }\n\n      // V1 payloads carry no extensions, so the builder-code suffix can only contain the\n      // facilitator's own wallet code (`w`); client app (`a`) and service (`s`) codes are\n      // always absent.\n      const dataSuffix = await resolveDataSuffix(context, {\n        paymentPayload: payload,\n        paymentRequirements: requirements,\n      });\n\n      const tx = await executeTransferWithAuthorization(\n        this.signer,\n        getAddress(requirements.asset),\n        exactEvmPayload,\n        dataSuffix,\n      );\n\n      // Wait for transaction confirmation\n      const receipt = await this.signer.waitForTransactionReceipt({ hash: tx });\n\n      if (receipt.status !== \"success\") {\n        return {\n          success: false,\n          errorReason: Errors.ErrTransactionFailed,\n          transaction: tx,\n          network: payloadV1.network,\n          payer: exactEvmPayload.authorization.from,\n        };\n      }\n\n      return {\n        success: true,\n        transaction: tx,\n        network: payloadV1.network,\n        payer: exactEvmPayload.authorization.from,\n      };\n    } catch (error) {\n      return {\n        success: false,\n        errorReason: error instanceof Error ? error.message : Errors.ErrTransactionFailed,\n        transaction: \"\",\n        network: payloadV1.network,\n        payer: exactEvmPayload.authorization.from,\n      };\n    }\n  }\n\n  /**\n   * Internal verify with optional simulation control.\n   *\n   * @param payload - The payment payload to verify\n   * @param requirements - The payment requirements\n   * @param options - Verification options (e.g. simulate)\n   * @returns Promise resolving to verification response\n   */\n  private async _verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n    options?: VerifyV1Options,\n  ): Promise<VerifyResponse> {\n    const requirementsV1 = requirements as unknown as PaymentRequirementsV1;\n    const payloadV1 = payload as unknown as PaymentPayloadV1;\n    const exactEvmPayload = payload.payload as ExactEvmPayloadV1;\n    const payer = exactEvmPayload.authorization.from;\n    let eip6492Deployment:\n      | { factoryAddress: `0x${string}`; factoryCalldata: `0x${string}` }\n      | undefined;\n\n    // Verify scheme matches\n    if (payloadV1.scheme !== \"exact\" || requirements.scheme !== \"exact\") {\n      return {\n        isValid: false,\n        invalidReason: Errors.ErrInvalidScheme,\n        payer,\n      };\n    }\n\n    // Get chain configuration\n    let chainId: number;\n    try {\n      chainId = getEvmChainIdV1(payloadV1.network as EvmNetworkV1);\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: Errors.ErrNetworkMismatch,\n        payer,\n      };\n    }\n\n    if (!requirements.extra?.name || !requirements.extra?.version) {\n      return {\n        isValid: false,\n        invalidReason: Errors.ErrMissingEip712Domain,\n        payer,\n      };\n    }\n\n    const { name, version } = requirements.extra;\n    const erc20Address = getAddress(requirements.asset);\n\n    // Verify network matches\n    if (payloadV1.network !== requirements.network) {\n      return {\n        isValid: false,\n        invalidReason: Errors.ErrNetworkMismatch,\n        payer,\n      };\n    }\n\n    // Build typed data for signature verification\n    const permitTypedData = {\n      types: authorizationTypes,\n      primaryType: \"TransferWithAuthorization\" as const,\n      domain: {\n        name,\n        version,\n        chainId,\n        verifyingContract: erc20Address,\n      },\n      message: {\n        from: exactEvmPayload.authorization.from,\n        to: exactEvmPayload.authorization.to,\n        value: BigInt(exactEvmPayload.authorization.value),\n        validAfter: BigInt(exactEvmPayload.authorization.validAfter),\n        validBefore: BigInt(exactEvmPayload.authorization.validBefore),\n        nonce: exactEvmPayload.authorization.nonce,\n      },\n    };\n\n    // Verify signature (flatten EIP-6492 handling out of catch block)\n    let isValid = false;\n    try {\n      isValid = await this.signer.verifyTypedData({\n        address: payer,\n        ...permitTypedData,\n        signature: exactEvmPayload.signature!,\n      });\n    } catch {\n      isValid = false;\n    }\n\n    const signature = exactEvmPayload.signature!;\n    const sigLen = signature.startsWith(\"0x\") ? signature.length - 2 : signature.length;\n\n    // Extract EIP-6492 deployment info (factory address + calldata) if present\n    const erc6492Data = parseErc6492Signature(signature);\n    const hasDeploymentInfo =\n      erc6492Data.address &&\n      erc6492Data.data &&\n      !isAddressEqual(erc6492Data.address, \"0x0000000000000000000000000000000000000000\");\n\n    if (hasDeploymentInfo) {\n      eip6492Deployment = {\n        factoryAddress: erc6492Data.address!,\n        factoryCalldata: erc6492Data.data!,\n      };\n    }\n\n    if (!isValid) {\n      const isSmartWallet = sigLen > 130; // 65 bytes = 130 hex chars for EOA\n\n      if (!isSmartWallet) {\n        return {\n          isValid: false,\n          invalidReason: Errors.ErrInvalidSignature,\n          payer,\n        };\n      }\n\n      const bytecode = await this.signer.getCode({ address: payer });\n      const isDeployed = bytecode && bytecode !== \"0x\";\n\n      if (!isDeployed && !hasDeploymentInfo) {\n        return {\n          isValid: false,\n          invalidReason: Errors.ErrUndeployedSmartWallet,\n          payer,\n        };\n      }\n    }\n\n    // Verify payment recipient matches\n    if (getAddress(exactEvmPayload.authorization.to) !== getAddress(requirements.payTo)) {\n      return {\n        isValid: false,\n        invalidReason: Errors.ErrRecipientMismatch,\n        payer,\n      };\n    }\n\n    // Verify validBefore is in the future (with 6 second buffer for block time)\n    const now = Math.floor(Date.now() / 1000);\n    if (BigInt(exactEvmPayload.authorization.validBefore) < BigInt(now + 6)) {\n      return {\n        isValid: false,\n        invalidReason: Errors.ErrValidBeforeExpired,\n        payer,\n      };\n    }\n\n    // Verify validAfter is not in the future\n    if (BigInt(exactEvmPayload.authorization.validAfter) > BigInt(now)) {\n      return {\n        isValid: false,\n        invalidReason: Errors.ErrValidAfterInFuture,\n        payer,\n      };\n    }\n\n    // Verify amount exactly matches requirements\n    if (BigInt(exactEvmPayload.authorization.value) !== BigInt(requirementsV1.maxAmountRequired)) {\n      return {\n        isValid: false,\n        invalidReason: Errors.ErrInvalidAuthorizationValue,\n        payer,\n      };\n    }\n\n    // Transaction simulation\n    if (options?.simulate !== false) {\n      const simulationSucceeded = await simulateEip3009Transfer(\n        this.signer,\n        erc20Address,\n        exactEvmPayload,\n        eip6492Deployment,\n      );\n      if (!simulationSucceeded) {\n        return diagnoseEip3009SimulationFailure(\n          this.signer,\n          erc20Address,\n          exactEvmPayload,\n          requirements,\n          requirementsV1.maxAmountRequired,\n        );\n      }\n    }\n\n    return {\n      isValid: true,\n      invalidReason: undefined,\n      payer,\n    };\n  }\n}\n","import { PaymentRequirements, VerifyResponse } from \"@bankofai/x402-core/types\";\nimport { encodeFunctionData, getAddress, Hex, parseErc6492Signature, parseSignature } from \"viem\";\nimport { eip3009ABI } from \"../../constants\";\nimport { multicall, ContractCall, RawContractCall } from \"../../multicall\";\nimport { FacilitatorEvmSigner } from \"../../signer\";\nimport { ExactEIP3009Payload } from \"../../types\";\nimport * as Errors from \"./errors\";\n\nexport interface Eip6492Deployment {\n  factoryAddress: `0x${string}`;\n  factoryCalldata: `0x${string}`;\n}\n\n/**\n * Simulates transferWithAuthorization via eth_call.\n * Returns true if simulation succeeded, false if it failed.\n *\n * @param signer - EVM signer for contract reads\n * @param erc20Address - ERC-20 token contract address\n * @param payload - EIP-3009 transfer authorization payload\n * @param eip6492Deployment - Optional EIP-6492 factory info for undeployed smart wallets\n *\n * @returns true if simulation succeeded, false if it failed\n */\nexport async function simulateEip3009Transfer(\n  signer: FacilitatorEvmSigner,\n  erc20Address: `0x${string}`,\n  payload: ExactEIP3009Payload,\n  eip6492Deployment?: Eip6492Deployment,\n): Promise<boolean> {\n  const auth = payload.authorization;\n  const transferArgs = [\n    getAddress(auth.from),\n    getAddress(auth.to),\n    BigInt(auth.value),\n    BigInt(auth.validAfter),\n    BigInt(auth.validBefore),\n    auth.nonce,\n  ] as const;\n\n  if (eip6492Deployment) {\n    const { signature: innerSignature } = parseErc6492Signature(payload.signature!);\n    const transferCalldata = encodeFunctionData({\n      abi: eip3009ABI,\n      functionName: \"transferWithAuthorization\",\n      args: [...transferArgs, innerSignature],\n    });\n\n    try {\n      const results = await multicall(signer.readContract.bind(signer), [\n        {\n          address: getAddress(eip6492Deployment.factoryAddress),\n          callData: eip6492Deployment.factoryCalldata,\n        } satisfies RawContractCall,\n        {\n          address: erc20Address,\n          callData: transferCalldata,\n        } satisfies RawContractCall,\n      ]);\n\n      return results[1]?.status === \"success\";\n    } catch {\n      return false;\n    }\n  }\n\n  const sig = payload.signature!;\n  const sigLength = sig.startsWith(\"0x\") ? sig.length - 2 : sig.length;\n  const isECDSA = sigLength === 130;\n\n  try {\n    if (isECDSA) {\n      const parsedSig = parseSignature(sig);\n      await signer.readContract({\n        address: erc20Address,\n        abi: eip3009ABI,\n        functionName: \"transferWithAuthorization\",\n        args: [\n          ...transferArgs,\n          (parsedSig.v as number | undefined) ?? parsedSig.yParity,\n          parsedSig.r,\n          parsedSig.s,\n        ],\n      });\n    } else {\n      await signer.readContract({\n        address: erc20Address,\n        abi: eip3009ABI,\n        functionName: \"transferWithAuthorization\",\n        args: [...transferArgs, sig],\n      });\n    }\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * After simulation fails, runs a single diagnostic multicall to determine the most specific error reason.\n * Checks balanceOf, name, version and authorizationState in one RPC round-trip.\n *\n * @param signer - EVM signer used for the payment\n * @param erc20Address - Address of the ERC-20 token contract\n * @param payload - The EIP-3009 transfer authorization payload\n * @param requirements - Payment requirements to validate against\n * @param amountRequired - Required amount for the payment (balance check)\n *\n * @returns Promise resolving to the verification result with validity and optional invalid reason\n */\nexport async function diagnoseEip3009SimulationFailure(\n  signer: FacilitatorEvmSigner,\n  erc20Address: `0x${string}`,\n  payload: ExactEIP3009Payload,\n  requirements: PaymentRequirements,\n  amountRequired: string,\n): Promise<VerifyResponse> {\n  const payer = payload.authorization.from;\n\n  const diagnosticCalls: ContractCall[] = [\n    {\n      address: erc20Address,\n      abi: eip3009ABI,\n      functionName: \"balanceOf\",\n      args: [payload.authorization.from],\n    },\n    {\n      address: erc20Address,\n      abi: eip3009ABI,\n      functionName: \"name\",\n    },\n    {\n      address: erc20Address,\n      abi: eip3009ABI,\n      functionName: \"version\",\n    },\n    {\n      address: erc20Address,\n      abi: eip3009ABI,\n      functionName: \"authorizationState\",\n      args: [payload.authorization.from, payload.authorization.nonce],\n    },\n  ];\n\n  try {\n    const results = await multicall(signer.readContract.bind(signer), diagnosticCalls);\n\n    const [balanceResult, nameResult, versionResult, authStateResult] = results;\n\n    if (authStateResult.status === \"failure\") {\n      return { isValid: false, invalidReason: Errors.ErrEip3009NotSupported, payer };\n    }\n\n    if (authStateResult.status === \"success\" && authStateResult.result === true) {\n      return { isValid: false, invalidReason: Errors.ErrEip3009NonceAlreadyUsed, payer };\n    }\n\n    if (\n      nameResult.status === \"success\" &&\n      requirements.extra?.name &&\n      nameResult.result !== requirements.extra.name\n    ) {\n      return { isValid: false, invalidReason: Errors.ErrEip3009TokenNameMismatch, payer };\n    }\n\n    if (\n      versionResult.status === \"success\" &&\n      requirements.extra?.version &&\n      versionResult.result !== requirements.extra.version\n    ) {\n      return { isValid: false, invalidReason: Errors.ErrEip3009TokenVersionMismatch, payer };\n    }\n\n    if (balanceResult.status === \"success\") {\n      const balance = balanceResult.result as bigint;\n      if (balance < BigInt(amountRequired)) {\n        return {\n          isValid: false,\n          invalidReason: Errors.ErrEip3009InsufficientBalance,\n          payer,\n        };\n      }\n    }\n  } catch {\n    // Diagnostic multicall failed — fall through to generic error\n  }\n\n  return { isValid: false, invalidReason: Errors.ErrEip3009SimulationFailed, payer };\n}\n\n/**\n * Maps an EIP-3009 contract revert error to a specific error code.\n * Falls back to ErrTransactionFailed when the revert reason is unknown.\n *\n * @param error - The error thrown during transfer execution\n * @returns A specific error reason string\n */\nexport function parseEip3009TransferError(error: unknown): string {\n  const msg = error instanceof Error ? error.message : String(error);\n  if (/authorization.*(expired|valid before)/i.test(msg) || /AuthorizationExpired/i.test(msg)) {\n    return Errors.ErrValidBeforeExpired;\n  }\n  if (/authorization.*not.*valid|AuthorizationNotYetValid/i.test(msg)) {\n    return Errors.ErrValidAfterInFuture;\n  }\n  if (/authorization.*used|AuthorizationAlreadyUsed|AuthorizationUsedOrCanceled/i.test(msg)) {\n    return Errors.ErrEip3009NonceAlreadyUsed;\n  }\n  if (/transfer.*exceeds.*balance|insufficient.*balance|ERC20InsufficientBalance/i.test(msg)) {\n    return Errors.ErrEip3009InsufficientBalance;\n  }\n  if (/invalid.*signature|SignerMismatch|InvalidSignatureV|InvalidSignatureS/i.test(msg)) {\n    return Errors.ErrInvalidSignature;\n  }\n  return Errors.ErrTransactionFailed;\n}\n\n/**\n * Executes transferWithAuthorization onchain.\n *\n * @param signer - EVM signer for contract writes\n * @param erc20Address - ERC-20 token contract address\n * @param payload - EIP-3009 transfer authorization payload\n * @param dataSuffix - Optional hex bytes to append after the ABI-encoded calldata\n *\n * @returns Transaction hash\n */\nexport async function executeTransferWithAuthorization(\n  signer: FacilitatorEvmSigner,\n  erc20Address: `0x${string}`,\n  payload: ExactEIP3009Payload,\n  dataSuffix?: Hex,\n): Promise<Hex> {\n  const { signature } = parseErc6492Signature(payload.signature!);\n  const signatureLength = signature.startsWith(\"0x\") ? signature.length - 2 : signature.length;\n  const isECDSA = signatureLength === 130;\n\n  const auth = payload.authorization;\n  const baseArgs = [\n    getAddress(auth.from),\n    getAddress(auth.to),\n    BigInt(auth.value),\n    BigInt(auth.validAfter),\n    BigInt(auth.validBefore),\n    auth.nonce,\n  ] as const;\n\n  let signatureArgs: readonly unknown[];\n  if (isECDSA) {\n    const parsedSig = parseSignature(signature);\n    signatureArgs = [\n      (parsedSig.v as number | undefined) || parsedSig.yParity,\n      parsedSig.r,\n      parsedSig.s,\n    ];\n  } else {\n    signatureArgs = [signature];\n  }\n\n  return signer.writeContract({\n    address: erc20Address,\n    abi: eip3009ABI,\n    functionName: \"transferWithAuthorization\",\n    args: [...baseArgs, ...signatureArgs],\n    dataSuffix,\n  });\n}\n","import { encodeFunctionData, decodeFunctionResult } from \"viem\";\n\n/**\n * Multicall3 contract address.\n * Same address on all EVM chains via CREATE2 deployment.\n *\n * @see https://github.com/mds1/multicall\n */\nexport const MULTICALL3_ADDRESS = \"0xcA11bde05977b3631167028862bE2a173976CA11\" as const;\n\n/** Multicall3 getEthBalance ABI for querying native token balance. */\nexport const multicall3GetEthBalanceAbi = [\n  {\n    name: \"getEthBalance\",\n    inputs: [{ name: \"addr\", type: \"address\" }],\n    outputs: [{ name: \"balance\", type: \"uint256\" }],\n    stateMutability: \"view\",\n    type: \"function\",\n  },\n] as const;\n\n/** Multicall3 tryAggregate ABI for batching calls. */\nconst multicall3ABI = [\n  {\n    inputs: [\n      { name: \"requireSuccess\", type: \"bool\" },\n      {\n        name: \"calls\",\n        type: \"tuple[]\",\n        components: [\n          { name: \"target\", type: \"address\" },\n          { name: \"callData\", type: \"bytes\" },\n        ],\n      },\n    ],\n    name: \"tryAggregate\",\n    outputs: [\n      {\n        name: \"returnData\",\n        type: \"tuple[]\",\n        components: [\n          { name: \"success\", type: \"bool\" },\n          { name: \"returnData\", type: \"bytes\" },\n        ],\n      },\n    ],\n    stateMutability: \"payable\",\n    type: \"function\",\n  },\n] as const;\n\nexport type ContractCall = {\n  address: `0x${string}`;\n  abi: readonly unknown[];\n  functionName: string;\n  args?: readonly unknown[];\n};\n\nexport type RawContractCall = {\n  address: `0x${string}`;\n  callData: `0x${string}`;\n};\n\nexport type MulticallSuccess = { status: \"success\"; result: unknown };\nexport type MulticallFailure = { status: \"failure\"; error: Error };\nexport type MulticallResult = MulticallSuccess | MulticallFailure;\n\n/**\n * Batches contract calls via Multicall3 `tryAggregate(false, ...)`.\n *\n * Accepts a mix of typed ContractCall (ABI-encoded + decoded) and\n * RawContractCall (pre-encoded calldata, no decoding) entries.\n * Raw calls are useful for the EIP-6492 factory deployment case\n * where calldata is pre-encoded with no ABI available.\n */\ntype ReadContractFn = (args: {\n  address: `0x${string}`;\n  abi: readonly unknown[];\n  functionName: string;\n  args?: readonly unknown[];\n}) => Promise<unknown>;\n\n/**\n * Executes multiple contract read calls in a single RPC round-trip using Multicall3.\n *\n * @param readContract - Function that performs a single contract read (e.g. viem readContract)\n * @param calls - Array of contract calls to batch (ContractCall or RawContractCall)\n * @returns A promise that resolves to an array of decoded results, one per call\n */\nexport async function multicall(\n  readContract: ReadContractFn,\n  calls: ReadonlyArray<ContractCall | RawContractCall>,\n): Promise<MulticallResult[]> {\n  const aggregateCalls = calls.map(call => {\n    if (\"callData\" in call) {\n      return { target: call.address, callData: call.callData };\n    }\n    const callData = encodeFunctionData({\n      abi: call.abi,\n      functionName: call.functionName,\n      args: call.args as unknown[],\n    });\n    return { target: call.address, callData };\n  });\n\n  const rawResults = (await readContract({\n    address: MULTICALL3_ADDRESS,\n    abi: multicall3ABI,\n    functionName: \"tryAggregate\",\n    args: [false, aggregateCalls],\n  })) as { success: boolean; returnData: `0x${string}` }[];\n\n  return rawResults.map((raw, i) => {\n    if (!raw.success) {\n      return {\n        status: \"failure\" as const,\n        error: new Error(`multicall: call reverted (returnData: ${raw.returnData})`),\n      };\n    }\n\n    const call = calls[i];\n    if (\"callData\" in call) {\n      return { status: \"success\" as const, result: undefined };\n    }\n\n    try {\n      const decoded = decodeFunctionResult({\n        abi: call.abi,\n        functionName: call.functionName,\n        data: raw.returnData,\n      });\n      return { status: \"success\" as const, result: decoded };\n    } catch (err) {\n      return {\n        status: \"failure\" as const,\n        error: err instanceof Error ? err : new Error(String(err)),\n      };\n    }\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOA,IAAAA,eAA2B;;;ACNpB,IAAM,qBAAqB;AAAA,EAChC,2BAA2B;AAAA,IACzB,EAAE,MAAM,QAAQ,MAAM,UAAU;AAAA,IAChC,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,IAC9B,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,IACjC,EAAE,MAAM,cAAc,MAAM,UAAU;AAAA,IACtC,EAAE,MAAM,eAAe,MAAM,UAAU;AAAA,IACvC,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,EACnC;AACF;;;ACVA,kBAAsB;AA4BtB,SAAS,YAAoB;AAC3B,QAAM,YAAY,WAAW;AAC7B,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,0BAA0B;AAAA,EAC5C;AACA,SAAO;AACT;AAOO,SAAS,cAA6B;AAC3C,aAAO,mBAAM,UAAU,EAAE,gBAAgB,IAAI,WAAW,EAAE,CAAC,CAAC;AAC9D;;;AF1BO,IAAM,mBAAN,MAAsD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ3D,YAA6B,QAAyB;AAAzB;AAP7B,SAAS,SAAS;AAAA,EAOqC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASvD,MAAM,qBACJ,aACA,qBAGA;AACA,UAAM,aAAa;AACnB,UAAM,QAAQ,YAAY;AAC1B,UAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AAExC,UAAM,gBAAoD;AAAA,MACxD,MAAM,KAAK,OAAO;AAAA,MAClB,QAAI,yBAAW,WAAW,KAAK;AAAA,MAC/B,OAAO,WAAW;AAAA,MAClB,aAAa,MAAM,KAAK,SAAS;AAAA;AAAA,MACjC,cAAc,MAAM,WAAW,mBAAmB,SAAS;AAAA,MAC3D;AAAA,IACF;AAGA,UAAM,YAAY,MAAM,KAAK,kBAAkB,eAAe,UAAU;AAExE,UAAM,UAA6B;AAAA,MACjC;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA,QAAQ,WAAW;AAAA,MACnB,SAAS,WAAW;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAc,kBACZ,eACA,cACwB;AACxB,UAAM,UAAU,gBAAgB,aAAa,OAAuB;AAEpE,QAAI,CAAC,aAAa,OAAO,QAAQ,CAAC,aAAa,OAAO,SAAS;AAC7D,YAAM,IAAI;AAAA,QACR,4FAA4F,aAAa,KAAK;AAAA,MAChH;AAAA,IACF;AAEA,UAAM,EAAE,MAAM,QAAQ,IAAI,aAAa;AAEvC,UAAM,SAAS;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,MACA,uBAAmB,yBAAW,aAAa,KAAK;AAAA,IAClD;AAEA,UAAM,UAAU;AAAA,MACd,UAAM,yBAAW,cAAc,IAAI;AAAA,MACnC,QAAI,yBAAW,cAAc,EAAE;AAAA,MAC/B,OAAO,OAAO,cAAc,KAAK;AAAA,MACjC,YAAY,OAAO,cAAc,UAAU;AAAA,MAC3C,aAAa,OAAO,cAAc,WAAW;AAAA,MAC7C,OAAO,cAAc;AAAA,IACvB;AAEA,WAAO,MAAM,KAAK,OAAO,cAAc;AAAA,MACrC;AAAA,MACA,OAAO;AAAA,MACP,aAAa;AAAA,MACb;AAAA,IACF,CAAC;AAAA,EACH;AACF;;;AGxGA,IAAAC,eAA2B;;;ACT3B,IAAAC,eAA2B;;;ACA3B,IAAAC,eAA2D;;;ACA3D,IAAAC,eAAyC;;;ACWzC,IAAAC,eAAuE;;;ACVvE,IAAAC,eAA2F;;;ACD3F,IAAAC,eAAyD;;;AVElD,IAAM,2BAA2B;AAAA,EACtC,UAAU;AAAA,EACV,SAAS;AAAA,EACT,UAAU;AAAA,EACV,oBAAoB;AAAA,EACpB,gBAAgB;AAAA,EAChB,MAAM;AAAA,EACN,kBAAkB;AAAA,EAClB,WAAW;AAAA,EACX,OAAO;AAAA,EACP,KAAK;AAAA,EACL,eAAe;AAAA,EACf,SAAS;AAAA,EACT,gBAAgB;AAAA,EAChB,MAAM;AAAA,EACN,OAAO;AAAA,EACP,UAAU;AAAA,EACV,sBAAsB;AAAA,EACtB,SAAS;AAAA,EACT,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,kBAAkB;AACpB;AAIO,IAAM,WAAqB,OAAO,KAAK,wBAAwB;AAS/D,SAAS,gBAAgB,SAAyB;AACvD,QAAM,UAAU,yBAAyB,OAAuB;AAChE,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,2BAA2B,OAAO,EAAE;AAAA,EACtD;AACA,SAAO;AACT;","names":["import_viem","import_viem","import_viem","import_viem","import_viem","import_viem","import_viem","import_viem"]}

package/dist/esm/auth-capture/client/index.d.mts

@@ -0,0 +1,44 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayloadContext, PaymentPayloadResult } from '@bankofai/x402-core/types';
+import { C as ClientEvmSigner } from '../../signer-BFelv8DL.mjs';
+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/esm/auth-capture/client/index.mjs

@@ -0,0 +1,8 @@
+import {
+  AuthCaptureEvmScheme
+} from "../../chunk-E4Z7PNXC.mjs";
+import "../../chunk-MACPBXCT.mjs";
+export {
+  AuthCaptureEvmScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/auth-capture/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/batch-settlement/client/file-storage.d.mts

@@ -0,0 +1,47 @@
+import { F as FileChannelStorageOptions } from '../../types-DIt9uAUy.mjs';
+import { C as ClientChannelStorage, B as BatchSettlementClientContext } from '../../storage-6W5MO46W.mjs';
+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 };

package/dist/esm/batch-settlement/client/file-storage.mjs

@@ -0,0 +1,63 @@
+import {
+  isNodeEnoent,
+  readJsonFile,
+  writeJsonAtomic
+} from "../../chunk-2EUQTNJO.mjs";
+
+// src/batch-settlement/client/fileStorage.ts
+import { unlink } from "fs/promises";
+import { join } from "path";
+var FileClientChannelStorage = class {
+  /**
+   * Creates file-backed client channel storage under the given root directory.
+   *
+   * @param options - Configuration including the storage root directory.
+   */
+  constructor(options) {
+    this.root = options.directory;
+  }
+  /**
+   * 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.
+   */
+  async get(key) {
+    return readJsonFile(this.filePath(key));
+  }
+  /**
+   * Persists the client context for a channel.
+   *
+   * @param key - Channel storage key.
+   * @param context - Context record to write.
+   */
+  async set(key, context) {
+    await writeJsonAtomic(this.filePath(key), context);
+  }
+  /**
+   * Removes the persisted context file for a channel, if it exists.
+   *
+   * @param key - Channel storage key.
+   */
+  async delete(key) {
+    try {
+      await unlink(this.filePath(key));
+    } catch (err) {
+      if (isNodeEnoent(err)) return;
+      throw err;
+    }
+  }
+  /**
+   * Absolute path to the JSON file for a channel.
+   *
+   * @param key - Channel storage key.
+   * @returns Filesystem path under `{root}/client/...`.
+   */
+  filePath(key) {
+    return join(this.root, "client", `${key.toLowerCase()}.json`);
+  }
+};
+export {
+  FileClientChannelStorage
+};
+//# sourceMappingURL=file-storage.mjs.map

package/dist/esm/batch-settlement/client/file-storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/batch-settlement/client/fileStorage.ts"],"sourcesContent":["import { unlink } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\nimport { isNodeEnoent, readJsonFile, writeJsonAtomic } from \"../storage-utils\";\nimport type { FileChannelStorageOptions } from \"../types\";\nimport type { ClientChannelStorage, BatchSettlementClientContext } from \"./storage\";\n\nexport type { FileChannelStorageOptions };\n\n/**\n * Node.js file-backed {@link ClientChannelStorage} for the batched client scheme.\n * Each channel's context is persisted as `{root}/client/{channelId}.json` so that channel\n * records survive process restarts.\n */\nexport class FileClientChannelStorage implements ClientChannelStorage {\n  private readonly root: string;\n\n  /**\n   * Creates file-backed client channel storage under the given root directory.\n   *\n   * @param options - Configuration including the storage root directory.\n   */\n  constructor(options: FileChannelStorageOptions) {\n    this.root = options.directory;\n  }\n\n  /**\n   * Loads the stored client context for a channel, if present.\n   *\n   * @param key - Channel storage key (typically a lowercased channelId).\n   * @returns Parsed context or `undefined` when the file is missing.\n   */\n  async get(key: string): Promise<BatchSettlementClientContext | undefined> {\n    return readJsonFile<BatchSettlementClientContext>(this.filePath(key));\n  }\n\n  /**\n   * Persists the client context for a channel.\n   *\n   * @param key - Channel storage key.\n   * @param context - Context record to write.\n   */\n  async set(key: string, context: BatchSettlementClientContext): Promise<void> {\n    await writeJsonAtomic(this.filePath(key), context);\n  }\n\n  /**\n   * Removes the persisted context file for a channel, if it exists.\n   *\n   * @param key - Channel storage key.\n   */\n  async delete(key: string): Promise<void> {\n    try {\n      await unlink(this.filePath(key));\n    } catch (err: unknown) {\n      if (isNodeEnoent(err)) return;\n      throw err;\n    }\n  }\n\n  /**\n   * Absolute path to the JSON file for a channel.\n   *\n   * @param key - Channel storage key.\n   * @returns Filesystem path under `{root}/client/...`.\n   */\n  private filePath(key: string): string {\n    return join(this.root, \"client\", `${key.toLowerCase()}.json`);\n  }\n}\n"],"mappings":";;;;;;;AAAA,SAAS,cAAc;AACvB,SAAS,YAAY;AAad,IAAM,2BAAN,MAA+D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQpE,YAAY,SAAoC;AAC9C,SAAK,OAAO,QAAQ;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,KAAgE;AACxE,WAAO,aAA2C,KAAK,SAAS,GAAG,CAAC;AAAA,EACtE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,KAAa,SAAsD;AAC3E,UAAM,gBAAgB,KAAK,SAAS,GAAG,GAAG,OAAO;AAAA,EACnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAO,KAA4B;AACvC,QAAI;AACF,YAAM,OAAO,KAAK,SAAS,GAAG,CAAC;AAAA,IACjC,SAAS,KAAc;AACrB,UAAI,aAAa,GAAG,EAAG;AACvB,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,SAAS,KAAqB;AACpC,WAAO,KAAK,KAAK,MAAM,UAAU,GAAG,IAAI,YAAY,CAAC,OAAO;AAAA,EAC9D;AACF;","names":[]}

package/dist/esm/batch-settlement/client/index.d.mts

@@ -0,0 +1,111 @@
+import { B as BatchSettlementClientDeps } from '../../scheme-CkNhpXrG.mjs';
+export { b as BatchSettlementDepositPolicy, c as BatchSettlementDepositStrategy, d as BatchSettlementDepositStrategyContext, e as BatchSettlementDepositStrategyResult, a as BatchSettlementEvmScheme, f as BatchSettlementEvmSchemeOptions, R as RefundOptions, j as ResolvedClientOptions, k as buildChannelConfig, g as depositAmountForRequest, l as getChannel, m as hasChannel, i as isBatchSettlementEvmSchemeOptions, p as processPaymentResponse, n as processSettleResponse, o as readChannelBalanceAndTotalClaimed, q as recoverChannel, r as refundChannel, h as resolveClientOptions, u as updateChannelAfterRefund, v as validateDepositPolicy } from '../../scheme-CkNhpXrG.mjs';
+export { B as BatchSettlementClientContext, C as ClientChannelStorage, I as InMemoryClientChannelStorage } from '../../storage-6W5MO46W.mjs';
+import { PaymentRequirements, PaymentPayloadResult, SchemeClientHooks, PaymentRequired } from '@bankofai/x402-core/types';
+import { C as ClientEvmSigner } from '../../signer-BFelv8DL.mjs';
+import { C as ChannelConfig, a as BatchSettlementVoucherFields, b as BatchSettlementChannelStateExtra, c as BatchSettlementVoucherStateExtra } from '../../types-DIt9uAUy.mjs';
+import { PaymentResponseContext } from '@bankofai/x402-core/client';
+import '../../rpc-DULZzRne.mjs';
+import 'viem';
+
+/**
+ * Computes the chain-bound channel id from a {@link ChannelConfig} struct.
+ *
+ * @param config - The immutable channel configuration.
+ * @param networkOrChainId - CAIP-2 network identifier or numeric EVM chain id.
+ * @returns The `bytes32` channel id as a hex string.
+ */
+declare function computeChannelId(config: ChannelConfig, networkOrChainId: string | number): `0x${string}`;
+
+/**
+ * Creates a deposit payload that bundles an ERC-3009 `receiveWithAuthorization` approval
+ * together with a cumulative voucher signature.
+ *
+ * When the facilitator submits this payload onchain, the contract atomically transfers
+ * tokens from the payer into the channel and records the initial voucher.
+ *
+ * @param signer - Client wallet used to sign the ERC-3009 authorization (`from` = payer).
+ * @param x402Version - Protocol version to embed in the payload envelope.
+ * @param paymentRequirements - Server-provided payment requirements (asset, network, amount, etc.).
+ * @param channelConfig - Immutable channel configuration (payer, receiver, token, …).
+ * @param depositAmount - Number of tokens (decimal string) to deposit into the channel.
+ * @param maxClaimableAmount - Cumulative ceiling for the accompanying voucher.
+ * @param voucherSigner - Optional key that signs the voucher; defaults to `signer` (same as payer).
+ * @returns A {@link PaymentPayloadResult} containing the signed deposit + voucher payload.
+ */
+declare function createBatchSettlementEIP3009DepositPayload(signer: ClientEvmSigner, x402Version: number, paymentRequirements: PaymentRequirements, channelConfig: ChannelConfig, depositAmount: string, maxClaimableAmount: string, voucherSigner?: ClientEvmSigner): Promise<PaymentPayloadResult>;
+
+/**
+ * Signs a cumulative voucher using the client's wallet.
+ *
+ * The voucher authorises the receiver to claim up to `maxClaimableAmount` from the
+ * channel identified by `channelId`.  The signature covers the EIP-712 `Voucher` struct
+ * under the batched domain.
+ *
+ * @param signer - Client wallet used to produce the EIP-712 signature.
+ * @param channelId - Identifier of the payment channel. This is the EIP-712
+ * hash of the `ChannelConfig` typed data for the batch settlement domain; see
+ * `computeChannelId`.
+ * @param maxClaimableAmount - Cumulative ceiling the receiver may claim (decimal string in token units).
+ * @param network - CAIP-2 network identifier (e.g. `eip155:84532`).
+ * @returns Signed voucher fields ready to be included in a payment payload.
+ */
+declare function signVoucher(signer: ClientEvmSigner, channelId: `0x${string}`, maxClaimableAmount: string, network: string): Promise<BatchSettlementVoucherFields>;
+
+/**
+ * Creates storage-aware client hooks for batch-settlement payment responses.
+ *
+ * @param deps - Client identity and storage inputs.
+ * @returns Scheme hooks for response reconciliation and corrective recovery.
+ */
+declare function createBatchSettlementClientHooks(deps: BatchSettlementClientDeps): SchemeClientHooks;
+/**
+ * Reconciles batch-settlement client state after a paid request or refund attempt.
+ *
+ * @param deps - Client identity and storage inputs.
+ * @param ctx - Core payment response context.
+ * @returns A recovery signal when corrective recovery succeeds.
+ */
+declare function handleBatchSettlementPaymentResponse(deps: BatchSettlementClientDeps, ctx: PaymentResponseContext): Promise<void | {
+    recovered: true;
+}>;
+
+/**
+ * Handles a corrective 402 response from the server when the client's
+ * cumulative base is out of sync.
+ *
+ * Validates the server-provided state (chargedCumulativeAmount,
+ * signedMaxClaimable, signature) against onchain data and the client's own
+ * signing key, then updates the local channel state if everything checks out.
+ *
+ * @param deps - Signer + storage + identity inputs.
+ * @param paymentRequired - The decoded 402 response body.
+ * @returns `true` if the channel state was successfully resynced and the request can be retried.
+ */
+declare function processCorrectivePaymentRequired(deps: BatchSettlementClientDeps, paymentRequired: PaymentRequired): Promise<boolean>;
+/**
+ * Recovers channel state from a corrective 402 that includes a server-provided
+ * voucher signature. Verifies the signature matches the client's own signing
+ * key before accepting.
+ *
+ * @param deps - Signer + storage + identity inputs.
+ * @param accept - Batch settlement payment requirements from the corrective 402.
+ * @param channelState - Server channel snapshot from `accept.extra.channelState`.
+ * @param voucherState - Latest signed voucher proof from `accept.extra.voucherState`.
+ * @returns `true` when local channel state was updated successfully.
+ */
+declare function recoverFromSignature(deps: BatchSettlementClientDeps, accept: PaymentRequirements, channelState: BatchSettlementChannelStateExtra, voucherState: BatchSettlementVoucherStateExtra): Promise<boolean>;
+/**
+ * Recovers channel state purely from onchain state when the server has no stored
+ * voucher (e.g. after a cooperative refund deleted the channel record). The onchain
+ * `totalClaimed` becomes the new baseline — no signature verification is
+ * needed because the contract is the source of truth when no outstanding
+ * voucher exists.
+ *
+ * @param deps - Signer + storage + identity inputs.
+ * @param accept - Batch settlement payment requirements from the corrective 402.
+ * @returns `true` when local channel state was updated from onchain data.
+ */
+declare function recoverFromOnChainState(deps: BatchSettlementClientDeps, accept: PaymentRequirements): Promise<boolean>;
+
+export { BatchSettlementClientDeps, computeChannelId, createBatchSettlementClientHooks, createBatchSettlementEIP3009DepositPayload, handleBatchSettlementPaymentResponse, processCorrectivePaymentRequired, recoverFromOnChainState, recoverFromSignature, signVoucher };

package/dist/esm/batch-settlement/client/index.mjs

@@ -0,0 +1,58 @@
+import {
+  BatchSettlementEvmScheme,
+  InMemoryClientChannelStorage,
+  buildChannelConfig,
+  createBatchSettlementClientHooks,
+  createBatchSettlementEIP3009DepositPayload,
+  depositAmountForRequest,
+  getChannel,
+  handleBatchSettlementPaymentResponse,
+  hasChannel,
+  isBatchSettlementEvmSchemeOptions,
+  processCorrectivePaymentRequired,
+  processPaymentResponse,
+  processSettleResponse,
+  readChannelBalanceAndTotalClaimed,
+  recoverChannel,
+  recoverFromOnChainState,
+  recoverFromSignature,
+  refundChannel,
+  resolveClientOptions,
+  signVoucher,
+  updateChannelAfterRefund,
+  validateDepositPolicy
+} from "../../chunk-GQVMVP4N.mjs";
+import "../../chunk-W6ON4LG2.mjs";
+import {
+  computeChannelId
+} from "../../chunk-HYABYUBD.mjs";
+import "../../chunk-U4HCGTLU.mjs";
+import "../../chunk-JNT7C46S.mjs";
+import "../../chunk-MACPBXCT.mjs";
+import "../../chunk-TW7Z65AO.mjs";
+export {
+  BatchSettlementEvmScheme,
+  InMemoryClientChannelStorage,
+  buildChannelConfig,
+  computeChannelId,
+  createBatchSettlementClientHooks,
+  createBatchSettlementEIP3009DepositPayload,
+  depositAmountForRequest,
+  getChannel,
+  handleBatchSettlementPaymentResponse,
+  hasChannel,
+  isBatchSettlementEvmSchemeOptions,
+  processCorrectivePaymentRequired,
+  processPaymentResponse,
+  processSettleResponse,
+  readChannelBalanceAndTotalClaimed,
+  recoverChannel,
+  recoverFromOnChainState,
+  recoverFromSignature,
+  refundChannel,
+  resolveClientOptions,
+  signVoucher,
+  updateChannelAfterRefund,
+  validateDepositPolicy
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/batch-settlement/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/batch-settlement/facilitator/index.d.mts

@@ -0,0 +1,72 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, FacilitatorContext, VerifyResponse, SettleResponse } from '@bankofai/x402-core/types';
+import { F as FacilitatorEvmSigner } from '../../signer-BFelv8DL.mjs';
+import { A as AuthorizerSigner } from '../../types-DIt9uAUy.mjs';
+import 'viem';
+
+/**
+ * Facilitator-side implementation of the `batch-settlement` scheme for EVM networks.
+ *
+ * Routes incoming verify/settle requests to the appropriate handler based on payload
+ * type (deposit, voucher, claim, settle, refund).
+ */
+declare class BatchSettlementEvmScheme implements SchemeNetworkFacilitator {
+    private readonly signer;
+    private readonly authorizerSigner;
+    readonly scheme: "batch-settlement";
+    readonly caipFamily = "eip155:*";
+    /**
+     * Creates a facilitator scheme for verifying and settling batch-settlement payments.
+     *
+     * @param signer - Facilitator EVM signer(s) used for tx submission and onchain reads.
+     * @param authorizerSigner - Dedicated key that provides EIP-712 signatures for
+     *   `claimWithSignature` / `refundWithSignature`.  The facilitator will sign missing
+     *   authorizer signatures using this key when the server omits them.
+     */
+    constructor(signer: FacilitatorEvmSigner, authorizerSigner: AuthorizerSigner);
+    /**
+     * Returns facilitator-specific extra fields to be merged into payment requirements.
+     *
+     * Exposes the configured `receiverAuthorizer` address so the server and client can
+     * embed it in `ChannelConfig`.
+     *
+     * @param _ - Network identifier (unused).
+     * @returns Extra fields containing `receiverAuthorizer`.
+     */
+    getExtra(_: string): {
+        receiverAuthorizer: `0x${string}`;
+    } | undefined;
+    /**
+     * Returns all facilitator signer addresses available for the given network.
+     *
+     * @param _ - Network identifier (unused).
+     * @returns Array of hex addresses.
+     */
+    getSigners(_: string): `0x${string}`[];
+    /**
+     * Verifies a payment payload (deposit or voucher) without executing settlement.
+     *
+     * @param payload - The x402 payment payload envelope.
+     * @param requirements - Server payment requirements (scheme, network, asset, amount).
+     * @param context - Optional facilitator extension context.
+     * @param _ - Payment required extensions (unused; reserved for interface parity)
+     * @returns A {@link VerifyResponse} indicating validity with payer and channel state in `extra`.
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements, context?: FacilitatorContext, _?: Record<string, unknown>): Promise<VerifyResponse>;
+    /**
+     * Executes settlement for a payment payload.
+     *
+     * Dispatches to the correct handler based on payload settle action:
+     * - `deposit` → onchain `deposit(config, amount, collector, collectorData)`
+     * - `claim` → onchain `claimWithSignature(VoucherClaim[], bytes)`
+     * - `settle` → onchain `settle(receiver, token)`
+     * - `refund` → optional claim + onchain `refundWithSignature(config, amount, nonce, sig)`
+     *
+     * @param payload - The x402 payment payload envelope.
+     * @param requirements - Server payment requirements.
+     * @param context - Optional facilitator extension context.
+     * @returns A {@link SettleResponse} with the transaction hash on success.
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements, context?: FacilitatorContext): Promise<SettleResponse>;
+}
+
+export { BatchSettlementEvmScheme };