@bankofai/x402-evm 2.6.0-beta.0

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

@@ -0,0 +1,186 @@
+"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/server/index.ts
+var server_exports = {};
+__export(server_exports, {
+  ExactPermitEvmScheme: () => ExactPermitEvmScheme,
+  registerExactPermitEvmScheme: () => registerExactPermitEvmScheme
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/constants.ts
+var PAYMENT_PERMIT_ADDRESSES = {
+  "eip155:56": "0x402085c248EeA27D92E8b30b2C58ed07f9E30001",
+  // BSC Mainnet
+  "eip155:97": "0x402085c248EeA27D92E8b30b2C58ed07f9E30002",
+  // BSC Testnet
+  "eip155:8453": "0x402085c248EeA27D92E8b30b2C58ed07f9E30003",
+  // Base
+  "eip155:84532": "0x402085c248EeA27D92E8b30b2C58ed07f9E30004"
+  // Base Sepolia
+};
+
+// src/exact_permit/server/scheme.ts
+var ExactPermitEvmScheme = class {
+  constructor() {
+    this.scheme = "exact_permit";
+    this.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) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * 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
+   */
+  async parsePrice(price, network) {
+    if (typeof price === "object" && price !== null && "amount" in price) {
+      if (!price.asset) {
+        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);
+      }
+      return {
+        amount: price.amount,
+        asset: price.asset,
+        extra: price.extra || {}
+      };
+    }
+    const amount = this.parseMoneyToDecimal(price);
+    for (const parser of this.moneyParsers) {
+      const result = await parser(amount, network);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(amount, network);
+  }
+  /**
+   * 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, supportedKind, extensionKeys) {
+    void extensionKeys;
+    const permitAddress = PAYMENT_PERMIT_ADDRESSES[paymentRequirements.network];
+    const enhanced = {
+      ...paymentRequirements,
+      extra: {
+        ...paymentRequirements.extra,
+        paymentPermitAddress: permitAddress,
+        ...supportedKind.extra || {}
+      }
+    };
+    return Promise.resolve(enhanced);
+  }
+  parseMoneyToDecimal(money) {
+    if (typeof money === "number") {
+      return money;
+    }
+    const cleanMoney = money.replace(/^\$/, "").trim();
+    const amount = parseFloat(cleanMoney);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid money format: ${money}`);
+    }
+    return amount;
+  }
+  defaultMoneyConversion(amount, network) {
+    const assetInfo = this.getDefaultAsset(network);
+    const tokenAmount = this.convertToTokenAmount(amount.toString(), assetInfo.decimals);
+    return {
+      amount: tokenAmount,
+      asset: assetInfo.address,
+      extra: {}
+    };
+  }
+  convertToTokenAmount(decimalAmount, decimals) {
+    const amount = parseFloat(decimalAmount);
+    if (isNaN(amount)) {
+      throw new Error(`Invalid amount: ${decimalAmount}`);
+    }
+    const [intPart, decPart = ""] = String(amount).split(".");
+    const paddedDec = decPart.padEnd(decimals, "0").slice(0, decimals);
+    const tokenAmount = (intPart + paddedDec).replace(/^0+/, "") || "0";
+    return tokenAmount;
+  }
+  getDefaultAsset(network) {
+    const stablecoins = {
+      "eip155:56": {
+        address: "0x55d398326f99059fF775485246999027B3197955",
+        // USDT on BSC Mainnet
+        decimals: 18
+      },
+      "eip155:97": {
+        address: "0x337610d27c682E347C9cD60BD4b3b107C9d34dDd",
+        // USDT on BSC Testnet
+        decimals: 18
+      },
+      "eip155:8453": {
+        address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        // USDC on Base
+        decimals: 6
+      },
+      "eip155:84532": {
+        address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+        // USDC on Base Sepolia
+        decimals: 6
+      }
+    };
+    const assetInfo = stablecoins[network];
+    if (!assetInfo) {
+      throw new Error(`No default asset configured for EVM network ${network}`);
+    }
+    return assetInfo;
+  }
+};
+
+// src/exact_permit/server/register.ts
+function registerExactPermitEvmScheme(server, config = {}) {
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, new ExactPermitEvmScheme());
+    });
+  } else {
+    server.register("eip155:*", new ExactPermitEvmScheme());
+  }
+  return server;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactPermitEvmScheme,
+  registerExactPermitEvmScheme
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact_permit/server/index.ts","../../../../src/constants.ts","../../../../src/exact_permit/server/scheme.ts","../../../../src/exact_permit/server/register.ts"],"sourcesContent":["export { ExactPermitEvmScheme } from \"./scheme\";\nexport { registerExactPermitEvmScheme } from \"./register\";\nexport type { EvmPermitResourceServerConfig } 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 {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from \"@bankofai/x402-core/types\";\nimport { PAYMENT_PERMIT_ADDRESSES } from \"../../constants\";\n\n/**\n * EVM server implementation for the exact_permit payment scheme.\n * Handles price parsing and payment requirements with PaymentPermit context.\n * Supports BSC and other EVM networks.\n */\nexport class ExactPermitEvmScheme implements SchemeNetworkServer {\n  readonly scheme = \"exact_permit\";\n  private moneyParsers: MoneyParser[] = [];\n\n  /**\n   * Register a custom money parser in the parser chain.\n   *\n   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)\n   * @returns The server instance for chaining\n   */\n  registerMoneyParser(parser: MoneyParser): ExactPermitEvmScheme {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parses a price into an asset amount for EVM.\n   *\n   * @param price - The price to parse\n   * @param network - The EVM network to use\n   * @returns Promise resolving to the parsed asset amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    if (typeof price === \"object\" && price !== null && \"amount\" in price) {\n      if (!price.asset) {\n        throw new Error(`Asset address must be specified for AssetAmount on network ${network}`);\n      }\n      return {\n        amount: price.amount,\n        asset: price.asset,\n        extra: price.extra || {},\n      };\n    }\n\n    const amount = this.parseMoneyToDecimal(price);\n\n    for (const parser of this.moneyParsers) {\n      const result = await parser(amount, network);\n      if (result !== null) {\n        return result;\n      }\n    }\n\n    return this.defaultMoneyConversion(amount, network);\n  }\n\n  /**\n   * Enhance payment requirements for EVM exact_permit scheme.\n   * Adds PaymentPermit contract address context.\n   *\n   * @param paymentRequirements - The base payment requirements\n   * @param supportedKind - The supported kind from facilitator\n   * @param supportedKind.x402Version - The x402 version\n   * @param supportedKind.scheme - The payment scheme\n   * @param supportedKind.network - The network identifier\n   * @param supportedKind.extra - Optional extra metadata\n   * @param extensionKeys - Extension keys supported by the facilitator\n   * @returns Enhanced payment requirements with permit context\n   */\n  enhancePaymentRequirements(\n    paymentRequirements: PaymentRequirements,\n    supportedKind: {\n      x402Version: number;\n      scheme: string;\n      network: Network;\n      extra?: Record<string, unknown>;\n    },\n    extensionKeys: string[],\n  ): Promise<PaymentRequirements> {\n    void extensionKeys;\n\n    const permitAddress = PAYMENT_PERMIT_ADDRESSES[paymentRequirements.network];\n    const enhanced: PaymentRequirements = {\n      ...paymentRequirements,\n      extra: {\n        ...paymentRequirements.extra,\n        paymentPermitAddress: permitAddress,\n        ...(supportedKind.extra || {}),\n      },\n    };\n\n    return Promise.resolve(enhanced);\n  }\n\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === \"number\") {\n      return money;\n    }\n    const cleanMoney = money.replace(/^\\$/, \"\").trim();\n    const amount = parseFloat(cleanMoney);\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`);\n    }\n    return amount;\n  }\n\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    const assetInfo = this.getDefaultAsset(network);\n    const tokenAmount = this.convertToTokenAmount(amount.toString(), assetInfo.decimals);\n\n    return {\n      amount: tokenAmount,\n      asset: assetInfo.address,\n      extra: {},\n    };\n  }\n\n  private convertToTokenAmount(decimalAmount: string, decimals: number): string {\n    const amount = parseFloat(decimalAmount);\n    if (isNaN(amount)) {\n      throw new Error(`Invalid amount: ${decimalAmount}`);\n    }\n    const [intPart, decPart = \"\"] = String(amount).split(\".\");\n    const paddedDec = decPart.padEnd(decimals, \"0\").slice(0, decimals);\n    const tokenAmount = (intPart + paddedDec).replace(/^0+/, \"\") || \"0\";\n    return tokenAmount;\n  }\n\n  private getDefaultAsset(network: Network): {\n    address: `0x${string}`;\n    decimals: number;\n  } {\n    // BSC + Base stablecoin configuration\n    const stablecoins: Record<string, { address: `0x${string}`; decimals: number }> = {\n      \"eip155:56\": {\n        address: \"0x55d398326f99059fF775485246999027B3197955\", // USDT on BSC Mainnet\n        decimals: 18,\n      },\n      \"eip155:97\": {\n        address: \"0x337610d27c682E347C9cD60BD4b3b107C9d34dDd\", // USDT on BSC Testnet\n        decimals: 18,\n      },\n      \"eip155:8453\": {\n        address: \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\", // USDC on Base\n        decimals: 6,\n      },\n      \"eip155:84532\": {\n        address: \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\", // USDC on Base Sepolia\n        decimals: 6,\n      },\n    };\n\n    const assetInfo = stablecoins[network];\n    if (!assetInfo) {\n      throw new Error(`No default asset configured for EVM network ${network}`);\n    }\n\n    return assetInfo;\n  }\n}\n","import { x402ResourceServer } from \"@bankofai/x402-core/server\";\nimport { Network } from \"@bankofai/x402-core/types\";\nimport { ExactPermitEvmScheme } from \"./scheme\";\n\n/**\n * Configuration options for registering EVM exact_permit schemes to an x402ResourceServer.\n */\nexport interface EvmPermitResourceServerConfig {\n  /**\n   * Optional specific networks to register.\n   * If not provided, registers wildcard support (eip155:*).\n   */\n  networks?: Network[];\n}\n\n/**\n * Registers EVM exact_permit payment schemes to an x402ResourceServer instance.\n *\n * @param server - The x402ResourceServer instance to register schemes to\n * @param config - Configuration for EVM permit resource server registration\n * @returns The server instance for chaining\n */\nexport function registerExactPermitEvmScheme(\n  server: x402ResourceServer,\n  config: EvmPermitResourceServerConfig = {},\n): x402ResourceServer {\n  if (config.networks && config.networks.length > 0) {\n    config.networks.forEach(network => {\n      server.register(network, new ExactPermitEvmScheme());\n    });\n  } else {\n    server.register(\"eip155:*\", new ExactPermitEvmScheme());\n  }\n\n  return server;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACkgBO,IAAM,2BAA0D;AAAA,EACrE,aAAa;AAAA;AAAA,EACb,aAAa;AAAA;AAAA,EACb,eAAe;AAAA;AAAA,EACf,gBAAgB;AAAA;AAClB;;;ACxfO,IAAM,uBAAN,MAA0D;AAAA,EAA1D;AACL,SAAS,SAAS;AAClB,SAAQ,eAA8B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQvC,oBAAoB,QAA2C;AAC7D,SAAK,aAAa,KAAK,MAAM;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,WAAW,OAAc,SAAwC;AACrE,QAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,YAAY,OAAO;AACpE,UAAI,CAAC,MAAM,OAAO;AAChB,cAAM,IAAI,MAAM,8DAA8D,OAAO,EAAE;AAAA,MACzF;AACA,aAAO;AAAA,QACL,QAAQ,MAAM;AAAA,QACd,OAAO,MAAM;AAAA,QACb,OAAO,MAAM,SAAS,CAAC;AAAA,MACzB;AAAA,IACF;AAEA,UAAM,SAAS,KAAK,oBAAoB,KAAK;AAE7C,eAAW,UAAU,KAAK,cAAc;AACtC,YAAM,SAAS,MAAM,OAAO,QAAQ,OAAO;AAC3C,UAAI,WAAW,MAAM;AACnB,eAAO;AAAA,MACT;AAAA,IACF;AAEA,WAAO,KAAK,uBAAuB,QAAQ,OAAO;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,2BACE,qBACA,eAMA,eAC8B;AAC9B,SAAK;AAEL,UAAM,gBAAgB,yBAAyB,oBAAoB,OAAO;AAC1E,UAAM,WAAgC;AAAA,MACpC,GAAG;AAAA,MACH,OAAO;AAAA,QACL,GAAG,oBAAoB;AAAA,QACvB,sBAAsB;AAAA,QACtB,GAAI,cAAc,SAAS,CAAC;AAAA,MAC9B;AAAA,IACF;AAEA,WAAO,QAAQ,QAAQ,QAAQ;AAAA,EACjC;AAAA,EAEQ,oBAAoB,OAAgC;AAC1D,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO;AAAA,IACT;AACA,UAAM,aAAa,MAAM,QAAQ,OAAO,EAAE,EAAE,KAAK;AACjD,UAAM,SAAS,WAAW,UAAU;AACpC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,yBAAyB,KAAK,EAAE;AAAA,IAClD;AACA,WAAO;AAAA,EACT;AAAA,EAEQ,uBAAuB,QAAgB,SAA+B;AAC5E,UAAM,YAAY,KAAK,gBAAgB,OAAO;AAC9C,UAAM,cAAc,KAAK,qBAAqB,OAAO,SAAS,GAAG,UAAU,QAAQ;AAEnF,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,OAAO,UAAU;AAAA,MACjB,OAAO,CAAC;AAAA,IACV;AAAA,EACF;AAAA,EAEQ,qBAAqB,eAAuB,UAA0B;AAC5E,UAAM,SAAS,WAAW,aAAa;AACvC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,mBAAmB,aAAa,EAAE;AAAA,IACpD;AACA,UAAM,CAAC,SAAS,UAAU,EAAE,IAAI,OAAO,MAAM,EAAE,MAAM,GAAG;AACxD,UAAM,YAAY,QAAQ,OAAO,UAAU,GAAG,EAAE,MAAM,GAAG,QAAQ;AACjE,UAAM,eAAe,UAAU,WAAW,QAAQ,OAAO,EAAE,KAAK;AAChE,WAAO;AAAA,EACT;AAAA,EAEQ,gBAAgB,SAGtB;AAEA,UAAM,cAA4E;AAAA,MAChF,aAAa;AAAA,QACX,SAAS;AAAA;AAAA,QACT,UAAU;AAAA,MACZ;AAAA,MACA,aAAa;AAAA,QACX,SAAS;AAAA;AAAA,QACT,UAAU;AAAA,MACZ;AAAA,MACA,eAAe;AAAA,QACb,SAAS;AAAA;AAAA,QACT,UAAU;AAAA,MACZ;AAAA,MACA,gBAAgB;AAAA,QACd,SAAS;AAAA;AAAA,QACT,UAAU;AAAA,MACZ;AAAA,IACF;AAEA,UAAM,YAAY,YAAY,OAAO;AACrC,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,+CAA+C,OAAO,EAAE;AAAA,IAC1E;AAEA,WAAO;AAAA,EACT;AACF;;;AC9IO,SAAS,6BACd,QACA,SAAwC,CAAC,GACrB;AACpB,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AACjD,WAAO,SAAS,QAAQ,aAAW;AACjC,aAAO,SAAS,SAAS,IAAI,qBAAqB,CAAC;AAAA,IACrD,CAAC;AAAA,EACH,OAAO;AACL,WAAO,SAAS,YAAY,IAAI,qBAAqB,CAAC;AAAA,EACxD;AAEA,SAAO;AACT;","names":[]}

package/dist/cjs/index.d.ts

@@ -0,0 +1,76 @@
+export { E as ExactEvmScheme, P as PERMIT2_ADDRESS, a as Permit2AllowanceParams, b as authorizationTypes, c as createPermit2ApprovalTx, e as eip3009ABI, d as erc20AllowanceAbi, g as getPermit2AllowanceReadParams, p as permit2WitnessTypes, x as x402ExactPermit2ProxyABI, f as x402ExactPermit2ProxyAddress, h as x402UptoPermit2ProxyAddress } from './permit2-CpuKY2-F.js';
+export { C as ClientEvmSigner, F as FacilitatorEvmSigner, t as toClientEvmSigner, a as toFacilitatorEvmSigner } from './signer-DC81R8wQ.js';
+import '@bankofai/x402-core/types';
+
+/**
+ * Asset transfer methods for the exact EVM scheme.
+ * - eip3009: Uses transferWithAuthorization (USDC, etc.) - recommended for compatible tokens
+ * - permit2: Uses Permit2 + x402Permit2Proxy - universal fallback for any ERC-20
+ */
+type AssetTransferMethod = "eip3009" | "permit2";
+/**
+ * EIP-3009 payload for tokens with native transferWithAuthorization support.
+ */
+type ExactEIP3009Payload = {
+    signature?: `0x${string}`;
+    authorization: {
+        from: `0x${string}`;
+        to: `0x${string}`;
+        value: string;
+        validAfter: string;
+        validBefore: string;
+        nonce: `0x${string}`;
+    };
+};
+/**
+ * Permit2 witness data structure.
+ * Matches the Witness struct in x402Permit2Proxy contract.
+ * Note: Upper time bound is enforced by Permit2's `deadline` field, not a witness field.
+ */
+type Permit2Witness = {
+    to: `0x${string}`;
+    validAfter: string;
+};
+/**
+ * Permit2 authorization parameters.
+ * Used to reconstruct the signed message for verification.
+ */
+type Permit2Authorization = {
+    permitted: {
+        token: `0x${string}`;
+        amount: string;
+    };
+    spender: `0x${string}`;
+    nonce: string;
+    deadline: string;
+    witness: Permit2Witness;
+};
+/**
+ * Permit2 payload for tokens using the Permit2 + x402Permit2Proxy flow.
+ */
+type ExactPermit2Payload = {
+    signature: `0x${string}`;
+    permit2Authorization: Permit2Authorization & {
+        from: `0x${string}`;
+    };
+};
+type ExactEvmPayloadV1 = ExactEIP3009Payload;
+type ExactEvmPayloadV2 = ExactEIP3009Payload | ExactPermit2Payload;
+/**
+ * Type guard to check if a payload is a Permit2 payload.
+ * Permit2 payloads have a `permit2Authorization` field.
+ *
+ * @param payload - The payload to check.
+ * @returns True if the payload is a Permit2 payload, false otherwise.
+ */
+declare function isPermit2Payload(payload: ExactEvmPayloadV2): payload is ExactPermit2Payload;
+/**
+ * Type guard to check if a payload is an EIP-3009 payload.
+ * EIP-3009 payloads have an `authorization` field.
+ *
+ * @param payload - The payload to check.
+ * @returns True if the payload is an EIP-3009 payload, false otherwise.
+ */
+declare function isEIP3009Payload(payload: ExactEvmPayloadV2): payload is ExactEIP3009Payload;
+
+export { type AssetTransferMethod, type ExactEIP3009Payload, type ExactEvmPayloadV1, type ExactEvmPayloadV2, type ExactPermit2Payload, type Permit2Authorization, type Permit2Witness, isEIP3009Payload, isPermit2Payload };