@bankofai/x402-evm 2.6.0-beta.0

package/dist/cjs/exact_permit/facilitator/index.js

@@ -0,0 +1,437 @@
+"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/exact_permit/facilitator/index.ts
+var facilitator_exports = {};
+__export(facilitator_exports, {
+  ExactPermitEvmScheme: () => ExactPermitEvmScheme,
+  registerExactPermitEvmScheme: () => registerExactPermitEvmScheme
+});
+module.exports = __toCommonJS(facilitator_exports);
+
+// src/constants.ts
+var paymentPermitTypes = {
+  PaymentPermitDetails: [
+    { name: "meta", type: "PermitMeta" },
+    { name: "buyer", type: "address" },
+    { name: "caller", type: "address" },
+    { name: "payment", type: "Payment" },
+    { name: "fee", type: "Fee" }
+  ],
+  PermitMeta: [
+    { name: "kind", type: "uint8" },
+    { name: "paymentId", type: "bytes16" },
+    { name: "nonce", type: "uint256" },
+    { name: "validAfter", type: "uint256" },
+    { name: "validBefore", type: "uint256" }
+  ],
+  Payment: [
+    { name: "payToken", type: "address" },
+    { name: "payAmount", type: "uint256" },
+    { name: "payTo", type: "address" }
+  ],
+  Fee: [
+    { name: "feeTo", type: "address" },
+    { name: "feeAmount", type: "uint256" }
+  ]
+};
+var paymentPermitABI = [
+  {
+    type: "function",
+    name: "permitTransferFrom",
+    inputs: [
+      {
+        name: "permit",
+        type: "tuple",
+        components: [
+          {
+            name: "meta",
+            type: "tuple",
+            components: [
+              { name: "kind", type: "uint8" },
+              { name: "paymentId", type: "bytes16" },
+              { name: "nonce", type: "uint256" },
+              { name: "validAfter", type: "uint256" },
+              { name: "validBefore", type: "uint256" }
+            ]
+          },
+          { name: "buyer", type: "address" },
+          { name: "caller", type: "address" },
+          {
+            name: "payment",
+            type: "tuple",
+            components: [
+              { name: "payToken", type: "address" },
+              { name: "payAmount", type: "uint256" },
+              { name: "payTo", type: "address" }
+            ]
+          },
+          {
+            name: "fee",
+            type: "tuple",
+            components: [
+              { name: "feeTo", type: "address" },
+              { name: "feeAmount", type: "uint256" }
+            ]
+          }
+        ]
+      },
+      { name: "owner", type: "address" },
+      { name: "signature", type: "bytes" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "balanceOf",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "", type: "uint256" }],
+    stateMutability: "view"
+  }
+];
+var PAYMENT_PERMIT_ADDRESSES = {
+  "eip155:56": "0x402085c248EeA27D92E8b30b2C58ed07f9E30001",
+  // BSC Mainnet
+  "eip155:97": "0x402085c248EeA27D92E8b30b2C58ed07f9E30002",
+  // BSC Testnet
+  "eip155:8453": "0x402085c248EeA27D92E8b30b2C58ed07f9E30003",
+  // Base
+  "eip155:84532": "0x402085c248EeA27D92E8b30b2C58ed07f9E30004"
+  // Base Sepolia
+};
+
+// src/utils.ts
+var import_viem = require("viem");
+function getEvmChainId(network) {
+  if (network.startsWith("eip155:")) {
+    const idStr = network.split(":")[1];
+    const chainId = parseInt(idStr, 10);
+    if (isNaN(chainId)) {
+      throw new Error(`Invalid CAIP-2 chain ID: ${network}`);
+    }
+    return chainId;
+  }
+  throw new Error(`Unsupported network format: ${network} (expected eip155:CHAIN_ID)`);
+}
+
+// src/exact_permit/facilitator/errors.ts
+var INVALID_SCHEME = "invalid_exact_permit_evm_scheme";
+var MISSING_PERMIT_ADDRESS = "missing_payment_permit_address";
+var NETWORK_MISMATCH = "invalid_exact_permit_evm_network_mismatch";
+var INVALID_SIGNATURE = "invalid_exact_permit_evm_payload_signature";
+var RECIPIENT_MISMATCH = "invalid_exact_permit_evm_payload_recipient_mismatch";
+var TOKEN_MISMATCH = "invalid_exact_permit_evm_payload_token_mismatch";
+var VALID_BEFORE_EXPIRED = "invalid_exact_permit_evm_payload_valid_before";
+var VALID_AFTER_FUTURE = "invalid_exact_permit_evm_payload_valid_after";
+var VALUE_MISMATCH = "invalid_exact_permit_evm_payload_value_mismatch";
+var FEE_EXCEEDS_LIMIT = "invalid_exact_permit_evm_fee_exceeds_limit";
+var INSUFFICIENT_FUNDS = "insufficient_funds";
+var INVALID_TRANSACTION_STATE = "invalid_transaction_state";
+var TRANSACTION_FAILED = "transaction_failed";
+
+// src/exact_permit/facilitator/eip712.ts
+async function verifyPermitEIP712(signer, payload, requirements, evmPayload, baseFeeLimit) {
+  const payer = evmPayload.permit.buyer;
+  if (payload.accepted.scheme !== "exact_permit" || requirements.scheme !== "exact_permit") {
+    return {
+      isValid: false,
+      invalidReason: INVALID_SCHEME,
+      payer
+    };
+  }
+  if (payload.accepted.network !== requirements.network) {
+    return {
+      isValid: false,
+      invalidReason: NETWORK_MISMATCH,
+      payer
+    };
+  }
+  const permitAddress = PAYMENT_PERMIT_ADDRESSES[requirements.network];
+  if (!permitAddress) {
+    return {
+      isValid: false,
+      invalidReason: MISSING_PERMIT_ADDRESS,
+      payer
+    };
+  }
+  const chainId = getEvmChainId(requirements.network);
+  const typedData = {
+    address: evmPayload.permit.buyer,
+    types: paymentPermitTypes,
+    primaryType: "PaymentPermitDetails",
+    domain: {
+      name: "PaymentPermit",
+      chainId,
+      verifyingContract: permitAddress
+    },
+    message: {
+      meta: {
+        kind: evmPayload.permit.meta.kind,
+        paymentId: evmPayload.permit.meta.paymentId,
+        nonce: BigInt(evmPayload.permit.meta.nonce),
+        validAfter: BigInt(evmPayload.permit.meta.validAfter),
+        validBefore: BigInt(evmPayload.permit.meta.validBefore)
+      },
+      buyer: evmPayload.permit.buyer,
+      caller: evmPayload.permit.caller,
+      payment: {
+        payToken: evmPayload.permit.payment.payToken,
+        payAmount: BigInt(evmPayload.permit.payment.payAmount),
+        payTo: evmPayload.permit.payment.payTo
+      },
+      fee: {
+        feeTo: evmPayload.permit.fee.feeTo,
+        feeAmount: BigInt(evmPayload.permit.fee.feeAmount)
+      }
+    },
+    signature: evmPayload.signature
+  };
+  try {
+    const isValid = await signer.verifyTypedData(typedData);
+    if (!isValid) {
+      return {
+        isValid: false,
+        invalidReason: INVALID_SIGNATURE,
+        payer
+      };
+    }
+  } catch {
+    return {
+      isValid: false,
+      invalidReason: INVALID_SIGNATURE,
+      payer
+    };
+  }
+  const payloadToken = evmPayload.permit.payment.payToken.toLowerCase();
+  const requiresAsset = requirements.asset.toLowerCase();
+  if (payloadToken !== requiresAsset) {
+    return {
+      isValid: false,
+      invalidReason: TOKEN_MISMATCH,
+      payer
+    };
+  }
+  const payloadPayTo = evmPayload.permit.payment.payTo.toLowerCase();
+  const requiresPayTo = requirements.payTo.toLowerCase();
+  if (payloadPayTo !== requiresPayTo) {
+    return {
+      isValid: false,
+      invalidReason: RECIPIENT_MISMATCH,
+      payer
+    };
+  }
+  const now = Math.floor(Date.now() / 1e3);
+  if (BigInt(evmPayload.permit.meta.validBefore) < BigInt(now + 6)) {
+    return {
+      isValid: false,
+      invalidReason: VALID_BEFORE_EXPIRED,
+      payer
+    };
+  }
+  if (BigInt(evmPayload.permit.meta.validAfter) > BigInt(now)) {
+    return {
+      isValid: false,
+      invalidReason: VALID_AFTER_FUTURE,
+      payer
+    };
+  }
+  if (BigInt(evmPayload.permit.payment.payAmount) !== BigInt(requirements.amount)) {
+    return {
+      isValid: false,
+      invalidReason: VALUE_MISMATCH,
+      payer
+    };
+  }
+  if (baseFeeLimit !== void 0 && BigInt(evmPayload.permit.fee.feeAmount) > baseFeeLimit) {
+    return {
+      isValid: false,
+      invalidReason: FEE_EXCEEDS_LIMIT,
+      payer
+    };
+  }
+  try {
+    const totalNeeded = BigInt(evmPayload.permit.payment.payAmount) + BigInt(evmPayload.permit.fee.feeAmount);
+    const balance = await signer.readContract({
+      address: evmPayload.permit.payment.payToken,
+      abi: paymentPermitABI,
+      functionName: "balanceOf",
+      args: [evmPayload.permit.buyer]
+    });
+    if (BigInt(balance) < totalNeeded) {
+      return {
+        isValid: false,
+        invalidReason: INSUFFICIENT_FUNDS,
+        invalidMessage: `Insufficient funds. Required: ${totalNeeded.toString()}, Available: ${balance.toString()}`,
+        payer
+      };
+    }
+  } catch {
+  }
+  return {
+    isValid: true,
+    invalidReason: void 0,
+    payer
+  };
+}
+async function settlePermitEIP712(signer, payload, requirements, evmPayload, baseFeeLimit) {
+  const payer = evmPayload.permit.buyer;
+  const valid = await verifyPermitEIP712(signer, payload, requirements, evmPayload, baseFeeLimit);
+  if (!valid.isValid) {
+    return {
+      success: false,
+      network: payload.accepted.network,
+      transaction: "",
+      errorReason: valid.invalidReason ?? INVALID_SCHEME,
+      payer
+    };
+  }
+  try {
+    const permitAddress = PAYMENT_PERMIT_ADDRESSES[requirements.network];
+    const permitTuple = {
+      meta: {
+        kind: evmPayload.permit.meta.kind,
+        paymentId: evmPayload.permit.meta.paymentId,
+        nonce: BigInt(evmPayload.permit.meta.nonce),
+        validAfter: BigInt(evmPayload.permit.meta.validAfter),
+        validBefore: BigInt(evmPayload.permit.meta.validBefore)
+      },
+      buyer: evmPayload.permit.buyer,
+      caller: evmPayload.permit.caller,
+      payment: {
+        payToken: evmPayload.permit.payment.payToken,
+        payAmount: BigInt(evmPayload.permit.payment.payAmount),
+        payTo: evmPayload.permit.payment.payTo
+      },
+      fee: {
+        feeTo: evmPayload.permit.fee.feeTo,
+        feeAmount: BigInt(evmPayload.permit.fee.feeAmount)
+      }
+    };
+    const tx = await signer.writeContract({
+      address: permitAddress,
+      abi: paymentPermitABI,
+      functionName: "permitTransferFrom",
+      args: [permitTuple, evmPayload.permit.buyer, evmPayload.signature]
+    });
+    const receipt = await signer.waitForTransactionReceipt({ hash: tx });
+    if (receipt.status !== "success") {
+      return {
+        success: false,
+        errorReason: INVALID_TRANSACTION_STATE,
+        transaction: tx,
+        network: payload.accepted.network,
+        payer
+      };
+    }
+    return {
+      success: true,
+      transaction: tx,
+      network: payload.accepted.network,
+      payer
+    };
+  } catch {
+    return {
+      success: false,
+      errorReason: TRANSACTION_FAILED,
+      transaction: "",
+      network: payload.accepted.network,
+      payer
+    };
+  }
+}
+
+// src/exact_permit/facilitator/scheme.ts
+var ExactPermitEvmScheme = class {
+  /**
+   * Creates a new ExactPermitEvmScheme facilitator instance.
+   *
+   * @param signer - The EVM signer for facilitator operations
+   * @param baseFeeLimit - Optional maximum fee amount the facilitator accepts
+   */
+  constructor(signer, baseFeeLimit) {
+    this.signer = signer;
+    this.baseFeeLimit = baseFeeLimit;
+    this.scheme = "exact_permit";
+    this.caipFamily = "eip155:*";
+  }
+  /**
+   * Returns the PaymentPermit contract address for the network.
+   *
+   * @param network - The network identifier
+   * @returns Extra data containing the permit contract address
+   */
+  getExtra(network) {
+    const permitAddress = PAYMENT_PERMIT_ADDRESSES[network];
+    if (!permitAddress) {
+      return void 0;
+    }
+    return {
+      paymentPermitAddress: permitAddress
+    };
+  }
+  /**
+   * Returns facilitator wallet addresses.
+   *
+   * @param _ - The network identifier (unused)
+   * @returns Array of facilitator wallet addresses
+   */
+  getSigners(_) {
+    return [...this.signer.getAddresses()];
+  }
+  /**
+   * Verifies an EVM exact_permit payment payload.
+   *
+   * @param payload - The payment payload to verify
+   * @param requirements - The payment requirements
+   * @param _context - Optional facilitator context (unused)
+   * @returns Promise resolving to verification response
+   */
+  async verify(payload, requirements, _context) {
+    const evmPayload = payload.payload;
+    return verifyPermitEIP712(this.signer, payload, requirements, evmPayload, this.baseFeeLimit);
+  }
+  /**
+   * Settles an EVM exact_permit payment by calling permitTransferFrom.
+   *
+   * @param payload - The payment payload to settle
+   * @param requirements - The payment requirements
+   * @param _context - Optional facilitator context (unused)
+   * @returns Promise resolving to settlement response
+   */
+  async settle(payload, requirements, _context) {
+    const evmPayload = payload.payload;
+    return settlePermitEIP712(this.signer, payload, requirements, evmPayload, this.baseFeeLimit);
+  }
+};
+
+// src/exact_permit/facilitator/register.ts
+function registerExactPermitEvmScheme(facilitator, config) {
+  facilitator.register(
+    config.networks,
+    new ExactPermitEvmScheme(config.signer, config.baseFeeLimit)
+  );
+  return facilitator;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactPermitEvmScheme,
+  registerExactPermitEvmScheme
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/exact_permit/facilitator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact_permit/facilitator/index.ts","../../../../src/constants.ts","../../../../src/utils.ts","../../../../src/exact_permit/facilitator/errors.ts","../../../../src/exact_permit/facilitator/eip712.ts","../../../../src/exact_permit/facilitator/scheme.ts","../../../../src/exact_permit/facilitator/register.ts"],"sourcesContent":["export { ExactPermitEvmScheme } from \"./scheme\";\nexport { registerExactPermitEvmScheme } from \"./register\";\nexport type { EvmPermitFacilitatorConfig } from \"./register\";\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.\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// 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] 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 = \"0x402039b3d6E6BEC5A02c2C9fd937ac17A6940002\" as const;\n\n/**\n * Shared ABI components for the Permit2 witness tuple.\n * Used in both x402ExactPermit2ProxyABI and x402UptoPermit2ProxyABI to keep them in sync.\n * The upto contract's witness struct is identical to exact (both remove 'extra' post-audit).\n */\nconst permit2WitnessABIComponents = [\n  { name: \"to\", type: \"address\", internalType: \"address\" },\n  { name: \"validAfter\", type: \"uint256\", internalType: \"uint256\" },\n] as const;\n\n/**\n * x402UptoPermit2Proxy ABI - settle function for upto payment scheme (variable amounts).\n * Updated post-audit: 'extra' removed from witness struct, 'initialize()' removed (now\n * a constructor arg), and error names aligned with x402ExactPermit2Proxy.\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: \"owner\", type: \"address\", internalType: \"address\" },\n      {\n        name: \"witness\",\n        type: \"tuple\",\n        internalType: \"struct x402UptoPermit2Proxy.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 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: \"owner\", type: \"address\", internalType: \"address\" },\n      {\n        name: \"witness\",\n        type: \"tuple\",\n        internalType: \"struct x402UptoPermit2Proxy.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/**\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// --- PaymentPermit (exact_permit) constants ---\n\n/**\n * EIP-712 type definitions for PaymentPermit on EVM.\n * Used by the exact_permit scheme for structured permit signing.\n */\nexport const paymentPermitTypes = {\n  PaymentPermitDetails: [\n    { name: \"meta\", type: \"PermitMeta\" },\n    { name: \"buyer\", type: \"address\" },\n    { name: \"caller\", type: \"address\" },\n    { name: \"payment\", type: \"Payment\" },\n    { name: \"fee\", type: \"Fee\" },\n  ],\n  PermitMeta: [\n    { name: \"kind\", type: \"uint8\" },\n    { name: \"paymentId\", type: \"bytes16\" },\n    { name: \"nonce\", type: \"uint256\" },\n    { name: \"validAfter\", type: \"uint256\" },\n    { name: \"validBefore\", type: \"uint256\" },\n  ],\n  Payment: [\n    { name: \"payToken\", type: \"address\" },\n    { name: \"payAmount\", type: \"uint256\" },\n    { name: \"payTo\", type: \"address\" },\n  ],\n  Fee: [\n    { name: \"feeTo\", type: \"address\" },\n    { name: \"feeAmount\", type: \"uint256\" },\n  ],\n} as const;\n\n/**\n * ABI for PaymentPermit contract on EVM.\n */\nexport const paymentPermitABI = [\n  {\n    type: \"function\",\n    name: \"permitTransferFrom\",\n    inputs: [\n      {\n        name: \"permit\",\n        type: \"tuple\",\n        components: [\n          {\n            name: \"meta\",\n            type: \"tuple\",\n            components: [\n              { name: \"kind\", type: \"uint8\" },\n              { name: \"paymentId\", type: \"bytes16\" },\n              { name: \"nonce\", type: \"uint256\" },\n              { name: \"validAfter\", type: \"uint256\" },\n              { name: \"validBefore\", type: \"uint256\" },\n            ],\n          },\n          { name: \"buyer\", type: \"address\" },\n          { name: \"caller\", type: \"address\" },\n          {\n            name: \"payment\",\n            type: \"tuple\",\n            components: [\n              { name: \"payToken\", type: \"address\" },\n              { name: \"payAmount\", type: \"uint256\" },\n              { name: \"payTo\", type: \"address\" },\n            ],\n          },\n          {\n            name: \"fee\",\n            type: \"tuple\",\n            components: [\n              { name: \"feeTo\", type: \"address\" },\n              { name: \"feeAmount\", type: \"uint256\" },\n            ],\n          },\n        ],\n      },\n      { name: \"owner\", type: \"address\" },\n      { name: \"signature\", type: \"bytes\" },\n    ],\n    outputs: [],\n    stateMutability: \"nonpayable\",\n  },\n  {\n    type: \"function\",\n    name: \"balanceOf\",\n    inputs: [{ name: \"account\", type: \"address\" }],\n    outputs: [{ name: \"\", type: \"uint256\" }],\n    stateMutability: \"view\",\n  },\n] as const;\n\n/**\n * PaymentPermit contract addresses per EVM network.\n */\nexport const PAYMENT_PERMIT_ADDRESSES: Record<string, `0x${string}`> = {\n  \"eip155:56\": \"0x402085c248EeA27D92E8b30b2C58ed07f9E30001\", // BSC Mainnet\n  \"eip155:97\": \"0x402085c248EeA27D92E8b30b2C58ed07f9E30002\", // BSC Testnet\n  \"eip155:8453\": \"0x402085c248EeA27D92E8b30b2C58ed07f9E30003\", // Base\n  \"eip155:84532\": \"0x402085c248EeA27D92E8b30b2C58ed07f9E30004\", // Base Sepolia\n};\n\n/**\n * PaymentPermit kind constants.\n */\nexport const PERMIT_KIND = {\n  PAYMENT_ONLY: 0,\n} as const;\n\n/**\n * Zero address constant.\n */\nexport const ZERO_ADDRESS = \"0x0000000000000000000000000000000000000000\" as `0x${string}`;\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","// Verification error reasons for EVM exact_permit scheme.\nexport const INVALID_SCHEME = \"invalid_exact_permit_evm_scheme\";\nexport const MISSING_PERMIT_ADDRESS = \"missing_payment_permit_address\";\nexport const NETWORK_MISMATCH = \"invalid_exact_permit_evm_network_mismatch\";\nexport const INVALID_SIGNATURE = \"invalid_exact_permit_evm_payload_signature\";\nexport const RECIPIENT_MISMATCH = \"invalid_exact_permit_evm_payload_recipient_mismatch\";\nexport const TOKEN_MISMATCH = \"invalid_exact_permit_evm_payload_token_mismatch\";\nexport const VALID_BEFORE_EXPIRED = \"invalid_exact_permit_evm_payload_valid_before\";\nexport const VALID_AFTER_FUTURE = \"invalid_exact_permit_evm_payload_valid_after\";\nexport const VALUE_MISMATCH = \"invalid_exact_permit_evm_payload_value_mismatch\";\nexport const FEE_EXCEEDS_LIMIT = \"invalid_exact_permit_evm_fee_exceeds_limit\";\nexport const INSUFFICIENT_FUNDS = \"insufficient_funds\";\nexport const INVALID_TRANSACTION_STATE = \"invalid_transaction_state\";\nexport const TRANSACTION_FAILED = \"transaction_failed\";\n","import {\n  PaymentPayload,\n  PaymentRequirements,\n  SettleResponse,\n  VerifyResponse,\n} from \"@bankofai/x402-core/types\";\nimport {\n  paymentPermitTypes,\n  paymentPermitABI,\n  PAYMENT_PERMIT_ADDRESSES,\n} from \"../../constants\";\nimport { FacilitatorEvmSigner } from \"../../signer\";\nimport { ExactPermitEvmPayload } from \"../../types\";\nimport { getEvmChainId } from \"../../utils\";\nimport * as errors from \"./errors\";\n\n/**\n * Verifies an EIP-712 PaymentPermit payload on EVM.\n *\n * @param signer - The facilitator signer for contract reads and signature verification\n * @param payload - The payment payload to verify\n * @param requirements - The payment requirements\n * @param evmPayload - The EVM-specific permit payload data\n * @param baseFeeLimit - Optional maximum fee amount the facilitator accepts\n * @returns Promise resolving to verification response\n */\nexport async function verifyPermitEIP712(\n  signer: FacilitatorEvmSigner,\n  payload: PaymentPayload,\n  requirements: PaymentRequirements,\n  evmPayload: ExactPermitEvmPayload,\n  baseFeeLimit?: bigint,\n): Promise<VerifyResponse> {\n  const payer = evmPayload.permit.buyer;\n\n  // Verify scheme matches\n  if (payload.accepted.scheme !== \"exact_permit\" || requirements.scheme !== \"exact_permit\") {\n    return {\n      isValid: false,\n      invalidReason: errors.INVALID_SCHEME,\n      payer,\n    };\n  }\n\n  // Verify network matches\n  if (payload.accepted.network !== requirements.network) {\n    return {\n      isValid: false,\n      invalidReason: errors.NETWORK_MISMATCH,\n      payer,\n    };\n  }\n\n  // Verify PaymentPermit contract exists for the network\n  const permitAddress = PAYMENT_PERMIT_ADDRESSES[requirements.network];\n  if (!permitAddress) {\n    return {\n      isValid: false,\n      invalidReason: errors.MISSING_PERMIT_ADDRESS,\n      payer,\n    };\n  }\n\n  const chainId = getEvmChainId(requirements.network);\n\n  // Build EIP-712 typed data for signature verification\n  const typedData = {\n    address: evmPayload.permit.buyer,\n    types: paymentPermitTypes,\n    primaryType: \"PaymentPermitDetails\" as const,\n    domain: {\n      name: \"PaymentPermit\",\n      chainId,\n      verifyingContract: permitAddress,\n    },\n    message: {\n      meta: {\n        kind: evmPayload.permit.meta.kind,\n        paymentId: evmPayload.permit.meta.paymentId,\n        nonce: BigInt(evmPayload.permit.meta.nonce),\n        validAfter: BigInt(evmPayload.permit.meta.validAfter),\n        validBefore: BigInt(evmPayload.permit.meta.validBefore),\n      },\n      buyer: evmPayload.permit.buyer,\n      caller: evmPayload.permit.caller,\n      payment: {\n        payToken: evmPayload.permit.payment.payToken,\n        payAmount: BigInt(evmPayload.permit.payment.payAmount),\n        payTo: evmPayload.permit.payment.payTo,\n      },\n      fee: {\n        feeTo: evmPayload.permit.fee.feeTo,\n        feeAmount: BigInt(evmPayload.permit.fee.feeAmount),\n      },\n    },\n    signature: evmPayload.signature!,\n  };\n\n  // Verify signature\n  try {\n    const isValid = await signer.verifyTypedData(typedData);\n    if (!isValid) {\n      return {\n        isValid: false,\n        invalidReason: errors.INVALID_SIGNATURE,\n        payer,\n      };\n    }\n  } catch {\n    return {\n      isValid: false,\n      invalidReason: errors.INVALID_SIGNATURE,\n      payer,\n    };\n  }\n\n  // Verify payment token matches asset\n  const payloadToken = evmPayload.permit.payment.payToken.toLowerCase();\n  const requiresAsset = (requirements.asset as string).toLowerCase();\n  if (payloadToken !== requiresAsset) {\n    return {\n      isValid: false,\n      invalidReason: errors.TOKEN_MISMATCH,\n      payer,\n    };\n  }\n\n  // Verify recipient matches payTo\n  const payloadPayTo = evmPayload.permit.payment.payTo.toLowerCase();\n  const requiresPayTo = (requirements.payTo as string).toLowerCase();\n  if (payloadPayTo !== requiresPayTo) {\n    return {\n      isValid: false,\n      invalidReason: errors.RECIPIENT_MISMATCH,\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(evmPayload.permit.meta.validBefore) < BigInt(now + 6)) {\n    return {\n      isValid: false,\n      invalidReason: errors.VALID_BEFORE_EXPIRED,\n      payer,\n    };\n  }\n\n  // Verify validAfter is not in the future\n  if (BigInt(evmPayload.permit.meta.validAfter) > BigInt(now)) {\n    return {\n      isValid: false,\n      invalidReason: errors.VALID_AFTER_FUTURE,\n      payer,\n    };\n  }\n\n  // Verify payment amount matches requirements\n  if (BigInt(evmPayload.permit.payment.payAmount) !== BigInt(requirements.amount)) {\n    return {\n      isValid: false,\n      invalidReason: errors.VALUE_MISMATCH,\n      payer,\n    };\n  }\n\n  // Verify fee does not exceed configured limit\n  if (baseFeeLimit !== undefined && BigInt(evmPayload.permit.fee.feeAmount) > baseFeeLimit) {\n    return {\n      isValid: false,\n      invalidReason: errors.FEE_EXCEEDS_LIMIT,\n      payer,\n    };\n  }\n\n  // Check balance (payAmount + feeAmount)\n  try {\n    const totalNeeded =\n      BigInt(evmPayload.permit.payment.payAmount) + BigInt(evmPayload.permit.fee.feeAmount);\n    const balance = (await signer.readContract({\n      address: evmPayload.permit.payment.payToken,\n      abi: paymentPermitABI,\n      functionName: \"balanceOf\",\n      args: [evmPayload.permit.buyer],\n    })) as bigint;\n\n    if (BigInt(balance) < totalNeeded) {\n      return {\n        isValid: false,\n        invalidReason: errors.INSUFFICIENT_FUNDS,\n        invalidMessage: `Insufficient funds. Required: ${totalNeeded.toString()}, Available: ${balance.toString()}`,\n        payer,\n      };\n    }\n  } catch {\n    // If balance check fails, continue with other validations\n  }\n\n  return {\n    isValid: true,\n    invalidReason: undefined,\n    payer,\n  };\n}\n\n/**\n * Settles an EIP-712 PaymentPermit payment on EVM.\n * Calls the PaymentPermit contract's permitTransferFrom function.\n *\n * @param signer - The facilitator signer for contract writes\n * @param payload - The payment payload to settle\n * @param requirements - The payment requirements\n * @param evmPayload - The EVM-specific permit payload data\n * @param baseFeeLimit - Optional maximum fee amount the facilitator accepts\n * @returns Promise resolving to settlement response\n */\nexport async function settlePermitEIP712(\n  signer: FacilitatorEvmSigner,\n  payload: PaymentPayload,\n  requirements: PaymentRequirements,\n  evmPayload: ExactPermitEvmPayload,\n  baseFeeLimit?: bigint,\n): Promise<SettleResponse> {\n  const payer = evmPayload.permit.buyer;\n\n  // Re-verify before settling\n  const valid = await verifyPermitEIP712(signer, payload, requirements, evmPayload, baseFeeLimit);\n  if (!valid.isValid) {\n    return {\n      success: false,\n      network: payload.accepted.network,\n      transaction: \"\",\n      errorReason: valid.invalidReason ?? errors.INVALID_SCHEME,\n      payer,\n    };\n  }\n\n  try {\n    const permitAddress = PAYMENT_PERMIT_ADDRESSES[requirements.network];\n\n    // Build the permit tuple for the contract call\n    const permitTuple = {\n      meta: {\n        kind: evmPayload.permit.meta.kind,\n        paymentId: evmPayload.permit.meta.paymentId,\n        nonce: BigInt(evmPayload.permit.meta.nonce),\n        validAfter: BigInt(evmPayload.permit.meta.validAfter),\n        validBefore: BigInt(evmPayload.permit.meta.validBefore),\n      },\n      buyer: evmPayload.permit.buyer,\n      caller: evmPayload.permit.caller,\n      payment: {\n        payToken: evmPayload.permit.payment.payToken,\n        payAmount: BigInt(evmPayload.permit.payment.payAmount),\n        payTo: evmPayload.permit.payment.payTo,\n      },\n      fee: {\n        feeTo: evmPayload.permit.fee.feeTo,\n        feeAmount: BigInt(evmPayload.permit.fee.feeAmount),\n      },\n    };\n\n    // Call permitTransferFrom on the PaymentPermit contract\n    const tx = await signer.writeContract({\n      address: permitAddress,\n      abi: paymentPermitABI,\n      functionName: \"permitTransferFrom\",\n      args: [permitTuple, evmPayload.permit.buyer, evmPayload.signature!],\n    });\n\n    // Wait for transaction confirmation\n    const receipt = await signer.waitForTransactionReceipt({ hash: tx as `0x${string}` });\n\n    if (receipt.status !== \"success\") {\n      return {\n        success: false,\n        errorReason: errors.INVALID_TRANSACTION_STATE,\n        transaction: tx,\n        network: payload.accepted.network,\n        payer,\n      };\n    }\n\n    return {\n      success: true,\n      transaction: tx,\n      network: payload.accepted.network,\n      payer,\n    };\n  } catch {\n    return {\n      success: false,\n      errorReason: errors.TRANSACTION_FAILED,\n      transaction: \"\",\n      network: payload.accepted.network,\n      payer,\n    };\n  }\n}\n","import {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  FacilitatorContext,\n  SettleResponse,\n  VerifyResponse,\n} from \"@bankofai/x402-core/types\";\nimport { PAYMENT_PERMIT_ADDRESSES } from \"../../constants\";\nimport { FacilitatorEvmSigner } from \"../../signer\";\nimport { ExactPermitEvmPayload } from \"../../types\";\nimport { verifyPermitEIP712, settlePermitEIP712 } from \"./eip712\";\n\n/**\n * EVM facilitator implementation for the exact_permit payment scheme.\n * Verifies EIP-712 PaymentPermit signatures and executes on-chain settlement\n * via the PaymentPermit contract's permitTransferFrom.\n */\nexport class ExactPermitEvmScheme implements SchemeNetworkFacilitator {\n  readonly scheme = \"exact_permit\";\n  readonly caipFamily = \"eip155:*\";\n\n  /**\n   * Creates a new ExactPermitEvmScheme facilitator instance.\n   *\n   * @param signer - The EVM signer for facilitator operations\n   * @param baseFeeLimit - Optional maximum fee amount the facilitator accepts\n   */\n  constructor(\n    private readonly signer: FacilitatorEvmSigner,\n    private readonly baseFeeLimit?: bigint,\n  ) {}\n\n  /**\n   * Returns the PaymentPermit contract address for the network.\n   *\n   * @param network - The network identifier\n   * @returns Extra data containing the permit contract address\n   */\n  getExtra(network: string): Record<string, unknown> | undefined {\n    const permitAddress = PAYMENT_PERMIT_ADDRESSES[network];\n    if (!permitAddress) {\n      return undefined;\n    }\n    return {\n      paymentPermitAddress: permitAddress,\n    };\n  }\n\n  /**\n   * Returns facilitator wallet addresses.\n   *\n   * @param _ - The network identifier (unused)\n   * @returns Array of facilitator wallet addresses\n   */\n  getSigners(_: string): string[] {\n    return [...this.signer.getAddresses()];\n  }\n\n  /**\n   * Verifies an EVM exact_permit payment payload.\n   *\n   * @param payload - The payment payload to verify\n   * @param requirements - The payment requirements\n   * @param _context - Optional facilitator context (unused)\n   * @returns Promise resolving to verification response\n   */\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n    _context?: FacilitatorContext,\n  ): Promise<VerifyResponse> {\n    const evmPayload = payload.payload as ExactPermitEvmPayload;\n    return verifyPermitEIP712(this.signer, payload, requirements, evmPayload, this.baseFeeLimit);\n  }\n\n  /**\n   * Settles an EVM exact_permit payment by calling permitTransferFrom.\n   *\n   * @param payload - The payment payload to settle\n   * @param requirements - The payment requirements\n   * @param _context - Optional facilitator context (unused)\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 evmPayload = payload.payload as ExactPermitEvmPayload;\n    return settlePermitEIP712(this.signer, payload, requirements, evmPayload, this.baseFeeLimit);\n  }\n}\n","import { x402Facilitator } from \"@bankofai/x402-core/facilitator\";\nimport { Network } from \"@bankofai/x402-core/types\";\nimport { FacilitatorEvmSigner } from \"../../signer\";\nimport { ExactPermitEvmScheme } from \"./scheme\";\n\n/**\n * Configuration options for registering EVM exact_permit schemes to an x402Facilitator.\n */\nexport interface EvmPermitFacilitatorConfig {\n  /**\n   * The EVM signer for facilitator operations (verify and settle).\n   */\n  signer: FacilitatorEvmSigner;\n\n  /**\n   * Networks to register (single network or array of networks).\n   */\n  networks: Network | Network[];\n\n  /**\n   * Optional maximum fee amount the facilitator accepts.\n   */\n  baseFeeLimit?: bigint;\n}\n\n/**\n * Registers EVM exact_permit payment schemes to an x402Facilitator instance.\n *\n * @param facilitator - The x402Facilitator instance to register schemes to\n * @param config - Configuration for EVM permit facilitator registration\n * @returns The facilitator instance for chaining\n */\nexport function registerExactPermitEvmScheme(\n  facilitator: x402Facilitator,\n  config: EvmPermitFacilitatorConfig,\n): x402Facilitator {\n  facilitator.register(\n    config.networks,\n    new ExactPermitEvmScheme(config.signer, config.baseFeeLimit),\n  );\n\n  return facilitator;\n}\n"],"mappings":"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","names":[]}

package/dist/cjs/exact_permit/server/index.d.ts

@@ -0,0 +1,71 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@bankofai/x402-core/types';
+import { x402ResourceServer } from '@bankofai/x402-core/server';
+
+/**
+ * EVM server implementation for the exact_permit payment scheme.
+ * Handles price parsing and payment requirements with PaymentPermit context.
+ * Supports BSC and other EVM networks.
+ */
+declare class ExactPermitEvmScheme implements SchemeNetworkServer {
+    readonly scheme = "exact_permit";
+    private moneyParsers;
+    /**
+     * Register a custom money parser in the parser chain.
+     *
+     * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+     * @returns The server instance for chaining
+     */
+    registerMoneyParser(parser: MoneyParser): ExactPermitEvmScheme;
+    /**
+     * Parses a price into an asset amount for EVM.
+     *
+     * @param price - The price to parse
+     * @param network - The EVM network to use
+     * @returns Promise resolving to the parsed asset amount
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Enhance payment requirements for EVM exact_permit scheme.
+     * Adds PaymentPermit contract address context.
+     *
+     * @param paymentRequirements - The base payment requirements
+     * @param supportedKind - The supported kind from facilitator
+     * @param supportedKind.x402Version - The x402 version
+     * @param supportedKind.scheme - The payment scheme
+     * @param supportedKind.network - The network identifier
+     * @param supportedKind.extra - Optional extra metadata
+     * @param extensionKeys - Extension keys supported by the facilitator
+     * @returns Enhanced payment requirements with permit context
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        x402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, extensionKeys: string[]): Promise<PaymentRequirements>;
+    private parseMoneyToDecimal;
+    private defaultMoneyConversion;
+    private convertToTokenAmount;
+    private getDefaultAsset;
+}
+
+/**
+ * Configuration options for registering EVM exact_permit schemes to an x402ResourceServer.
+ */
+interface EvmPermitResourceServerConfig {
+    /**
+     * Optional specific networks to register.
+     * If not provided, registers wildcard support (eip155:*).
+     */
+    networks?: Network[];
+}
+/**
+ * Registers EVM exact_permit payment schemes to an x402ResourceServer instance.
+ *
+ * @param server - The x402ResourceServer instance to register schemes to
+ * @param config - Configuration for EVM permit resource server registration
+ * @returns The server instance for chaining
+ */
+declare function registerExactPermitEvmScheme(server: x402ResourceServer, config?: EvmPermitResourceServerConfig): x402ResourceServer;
+
+export { type EvmPermitResourceServerConfig, ExactPermitEvmScheme, registerExactPermitEvmScheme };