x402-evm-mantle 2.1.1-mantle

package/dist/esm/exact/server/index.d.mts

@@ -0,0 +1,140 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from 'x402-core-mantle/types';
+import { x402ResourceServer } from 'x402-core-mantle/server';
+
+/**
+ * EVM server implementation for the Exact payment scheme.
+ */
+declare class ExactEvmScheme implements SchemeNetworkServer {
+    readonly scheme = "exact";
+    private moneyParsers;
+    /**
+     * Register a custom money parser in the parser chain.
+     * Multiple parsers can be registered - they will be tried in registration order.
+     * Each parser receives a decimal amount (e.g., 1.50 for $1.50).
+     * If a parser returns null, the next parser in the chain will be tried.
+     * The default parser is always the final fallback.
+     *
+     * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+     * @returns The server instance for chaining
+     *
+     * @example
+     * evmServer.registerMoneyParser(async (amount, network) => {
+     *   // Custom conversion logic
+     *   if (amount > 100) {
+     *     // Use different token for large amounts
+     *     return { amount: (amount * 1e18).toString(), asset: "0xCustomToken" };
+     *   }
+     *   return null; // Use next parser
+     * });
+     */
+    registerMoneyParser(parser: MoneyParser): ExactEvmScheme;
+    /**
+     * Parses a price into an asset amount.
+     * If price is already an AssetAmount, returns it directly.
+     * If price is Money (string | number), parses to decimal and tries custom parsers.
+     * Falls back to default conversion if all custom parsers return null.
+     *
+     * @param price - The price to parse
+     * @param network - The network to use
+     * @returns Promise that resolves to the parsed asset amount
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Build payment requirements for this scheme/network combination
+     *
+     * @param paymentRequirements - The base payment requirements
+     * @param supportedKind - The supported kind from facilitator (unused)
+     * @param supportedKind.x402Version - The x402 version
+     * @param supportedKind.scheme - The logical payment scheme
+     * @param supportedKind.network - The network identifier in CAIP-2 format
+     * @param supportedKind.extra - Optional extra metadata regarding scheme/network implementation details
+     * @param extensionKeys - Extension keys supported by the facilitator (unused)
+     * @returns Payment requirements ready to be sent to clients
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        x402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, extensionKeys: string[]): Promise<PaymentRequirements>;
+    /**
+     * Parse Money (string | number) to a decimal number.
+     * Handles formats like "$1.50", "1.50", 1.50, etc.
+     *
+     * @param money - The money value to parse
+     * @returns Decimal number
+     */
+    private parseMoneyToDecimal;
+    /**
+     * Default money conversion implementation.
+     * Converts decimal amount to USDC on the specified network.
+     *
+     * @param amount - The decimal amount (e.g., 1.50)
+     * @param network - The network to use
+     * @returns The parsed asset amount in USDC
+     */
+    private defaultMoneyConversion;
+    /**
+     * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal USDC)
+     *
+     * @param decimalAmount - The decimal amount to convert
+     * @param network - The network to use
+     * @returns The token amount as a string
+     */
+    private convertToTokenAmount;
+    /**
+     * Get the default asset info for a network (typically USDC)
+     *
+     * @param network - The network to get asset info for
+     * @returns The asset information including address, name, and version
+     */
+    private getDefaultAsset;
+    /**
+     * Get asset info for a given symbol on a network
+     *
+     * @param symbol - The asset symbol
+     * @param network - The network to use
+     * @returns The asset information including address, name, and version
+     */
+    private getAssetInfo;
+    /**
+     * Get the number of decimals for the asset
+     *
+     * @param _ - The network to use (unused)
+     * @returns The number of decimals for the asset
+     */
+    private getAssetDecimals;
+}
+
+/**
+ * Configuration options for registering EVM schemes to an x402ResourceServer
+ */
+interface EvmResourceServerConfig {
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (eip155:*)
+     */
+    networks?: Network[];
+}
+/**
+ * Registers EVM exact payment schemes to an x402ResourceServer instance.
+ *
+ * This function registers:
+ * - V2: eip155:* wildcard scheme with ExactEvmScheme (or specific networks if provided)
+ *
+ * @param server - The x402ResourceServer instance to register schemes to
+ * @param config - Configuration for EVM resource server registration
+ * @returns The server instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactEvmScheme } from "@x402/evm/exact/server/register";
+ * import { x402ResourceServer } from "x402-core-mantle/server";
+ *
+ * const server = new x402ResourceServer(facilitatorClient);
+ * registerExactEvmScheme(server, {});
+ * ```
+ */
+declare function registerExactEvmScheme(server: x402ResourceServer, config?: EvmResourceServerConfig): x402ResourceServer;
+
+export { type EvmResourceServerConfig, ExactEvmScheme, registerExactEvmScheme };

package/dist/esm/exact/server/index.mjs

@@ -0,0 +1,219 @@
+// src/exact/server/scheme.ts
+var ExactEvmScheme = class {
+  constructor() {
+    this.scheme = "exact";
+    this.moneyParsers = [];
+  }
+  /**
+   * Register a custom money parser in the parser chain.
+   * Multiple parsers can be registered - they will be tried in registration order.
+   * Each parser receives a decimal amount (e.g., 1.50 for $1.50).
+   * If a parser returns null, the next parser in the chain will be tried.
+   * The default parser is always the final fallback.
+   *
+   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+   * @returns The server instance for chaining
+   *
+   * @example
+   * evmServer.registerMoneyParser(async (amount, network) => {
+   *   // Custom conversion logic
+   *   if (amount > 100) {
+   *     // Use different token for large amounts
+   *     return { amount: (amount * 1e18).toString(), asset: "0xCustomToken" };
+   *   }
+   *   return null; // Use next parser
+   * });
+   */
+  registerMoneyParser(parser) {
+    this.moneyParsers.push(parser);
+    return this;
+  }
+  /**
+   * Parses a price into an asset amount.
+   * If price is already an AssetAmount, returns it directly.
+   * If price is Money (string | number), parses to decimal and tries custom parsers.
+   * Falls back to default conversion if all custom parsers return null.
+   *
+   * @param price - The price to parse
+   * @param network - The network to use
+   * @returns Promise that resolves 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);
+  }
+  /**
+   * Build payment requirements for this scheme/network combination
+   *
+   * @param paymentRequirements - The base payment requirements
+   * @param supportedKind - The supported kind from facilitator (unused)
+   * @param supportedKind.x402Version - The x402 version
+   * @param supportedKind.scheme - The logical payment scheme
+   * @param supportedKind.network - The network identifier in CAIP-2 format
+   * @param supportedKind.extra - Optional extra metadata regarding scheme/network implementation details
+   * @param extensionKeys - Extension keys supported by the facilitator (unused)
+   * @returns Payment requirements ready to be sent to clients
+   */
+  enhancePaymentRequirements(paymentRequirements, supportedKind, extensionKeys) {
+    void supportedKind;
+    void extensionKeys;
+    return Promise.resolve(paymentRequirements);
+  }
+  /**
+   * Parse Money (string | number) to a decimal number.
+   * Handles formats like "$1.50", "1.50", 1.50, etc.
+   *
+   * @param money - The money value to parse
+   * @returns Decimal number
+   */
+  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;
+  }
+  /**
+   * Default money conversion implementation.
+   * Converts decimal amount to USDC on the specified network.
+   *
+   * @param amount - The decimal amount (e.g., 1.50)
+   * @param network - The network to use
+   * @returns The parsed asset amount in USDC
+   */
+  defaultMoneyConversion(amount, network) {
+    const tokenAmount = this.convertToTokenAmount(amount.toString(), network);
+    const assetInfo = this.getDefaultAsset(network);
+    return {
+      amount: tokenAmount,
+      asset: assetInfo.address,
+      extra: {
+        name: assetInfo.name,
+        version: assetInfo.version
+      }
+    };
+  }
+  /**
+   * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal USDC)
+   *
+   * @param decimalAmount - The decimal amount to convert
+   * @param network - The network to use
+   * @returns The token amount as a string
+   */
+  convertToTokenAmount(decimalAmount, network) {
+    const decimals = this.getAssetDecimals(network);
+    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;
+  }
+  /**
+   * Get the default asset info for a network (typically USDC)
+   *
+   * @param network - The network to get asset info for
+   * @returns The asset information including address, name, and version
+   */
+  getDefaultAsset(network) {
+    const usdcInfo = {
+      "eip155:8453": {
+        address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        name: "USD Coin",
+        version: "2"
+      },
+      // Base mainnet USDC
+      "eip155:84532": {
+        address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+        name: "USDC",
+        version: "2"
+      },
+      // Base Sepolia USDC
+      "eip155:1": {
+        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        name: "USD Coin",
+        version: "2"
+      },
+      // Ethereum mainnet USDC
+      "eip155:11155111": {
+        address: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+        name: "USDC",
+        version: "2"
+      },
+      // Sepolia USDC
+      "eip155:5003": {
+        address: "0x3D884Eca2a1E65A41Cd54b1CF55537dAe35d7BDC",
+        name: "USDC Token",
+        version: "1"
+      }
+      // Mantle testnet USDC
+    };
+    const assetInfo = usdcInfo[network];
+    if (!assetInfo) {
+      throw new Error(`No default asset configured for network ${network}`);
+    }
+    return assetInfo;
+  }
+  /**
+   * Get asset info for a given symbol on a network
+   *
+   * @param symbol - The asset symbol
+   * @param network - The network to use
+   * @returns The asset information including address, name, and version
+   */
+  getAssetInfo(symbol, network) {
+    const upperSymbol = symbol.toUpperCase();
+    if (upperSymbol === "USDC" || upperSymbol === "USD") {
+      return this.getDefaultAsset(network);
+    }
+    throw new Error(`Unsupported asset: ${symbol} on network ${network}`);
+  }
+  /**
+   * Get the number of decimals for the asset
+   *
+   * @param _ - The network to use (unused)
+   * @returns The number of decimals for the asset
+   */
+  getAssetDecimals(_) {
+    return 6;
+  }
+};
+
+// src/exact/server/register.ts
+function registerExactEvmScheme(server, config = {}) {
+  if (config.networks && config.networks.length > 0) {
+    config.networks.forEach((network) => {
+      server.register(network, new ExactEvmScheme());
+    });
+  } else {
+    server.register("eip155:*", new ExactEvmScheme());
+  }
+  return server;
+}
+export {
+  ExactEvmScheme,
+  registerExactEvmScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/server/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact/server/scheme.ts","../../../../src/exact/server/register.ts"],"sourcesContent":["import {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from \"x402-core-mantle/types\";\n\n/**\n * EVM server implementation for the Exact payment scheme.\n */\nexport class ExactEvmScheme implements SchemeNetworkServer {\n  readonly scheme = \"exact\";\n  private moneyParsers: MoneyParser[] = [];\n\n  /**\n   * Register a custom money parser in the parser chain.\n   * Multiple parsers can be registered - they will be tried in registration order.\n   * Each parser receives a decimal amount (e.g., 1.50 for $1.50).\n   * If a parser returns null, the next parser in the chain will be tried.\n   * The default parser is always the final fallback.\n   *\n   * @param parser - Custom function to convert amount to AssetAmount (or null to skip)\n   * @returns The server instance for chaining\n   *\n   * @example\n   * evmServer.registerMoneyParser(async (amount, network) => {\n   *   // Custom conversion logic\n   *   if (amount > 100) {\n   *     // Use different token for large amounts\n   *     return { amount: (amount * 1e18).toString(), asset: \"0xCustomToken\" };\n   *   }\n   *   return null; // Use next parser\n   * });\n   */\n  registerMoneyParser(parser: MoneyParser): ExactEvmScheme {\n    this.moneyParsers.push(parser);\n    return this;\n  }\n\n  /**\n   * Parses a price into an asset amount.\n   * If price is already an AssetAmount, returns it directly.\n   * If price is Money (string | number), parses to decimal and tries custom parsers.\n   * Falls back to default conversion if all custom parsers return null.\n   *\n   * @param price - The price to parse\n   * @param network - The network to use\n   * @returns Promise that resolves to the parsed asset amount\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // If already an AssetAmount, return it directly\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    // Parse Money to decimal number\n    const amount = this.parseMoneyToDecimal(price);\n\n    // Try each custom money parser in order\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    // All custom parsers returned null, use default conversion\n    return this.defaultMoneyConversion(amount, network);\n  }\n\n  /**\n   * Build payment requirements for this scheme/network combination\n   *\n   * @param paymentRequirements - The base payment requirements\n   * @param supportedKind - The supported kind from facilitator (unused)\n   * @param supportedKind.x402Version - The x402 version\n   * @param supportedKind.scheme - The logical payment scheme\n   * @param supportedKind.network - The network identifier in CAIP-2 format\n   * @param supportedKind.extra - Optional extra metadata regarding scheme/network implementation details\n   * @param extensionKeys - Extension keys supported by the facilitator (unused)\n   * @returns Payment requirements ready to be sent to clients\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    // Mark unused parameters to satisfy linter\n    void supportedKind;\n    void extensionKeys;\n    return Promise.resolve(paymentRequirements);\n  }\n\n  /**\n   * Parse Money (string | number) to a decimal number.\n   * Handles formats like \"$1.50\", \"1.50\", 1.50, etc.\n   *\n   * @param money - The money value to parse\n   * @returns Decimal number\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === \"number\") {\n      return money;\n    }\n\n    // Remove $ sign and whitespace, then parse\n    const cleanMoney = money.replace(/^\\$/, \"\").trim();\n    const amount = parseFloat(cleanMoney);\n\n    if (isNaN(amount)) {\n      throw new Error(`Invalid money format: ${money}`);\n    }\n\n    return amount;\n  }\n\n  /**\n   * Default money conversion implementation.\n   * Converts decimal amount to USDC on the specified network.\n   *\n   * @param amount - The decimal amount (e.g., 1.50)\n   * @param network - The network to use\n   * @returns The parsed asset amount in USDC\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    // Convert decimal amount to token amount (USDC has 6 decimals)\n    const tokenAmount = this.convertToTokenAmount(amount.toString(), network);\n    const assetInfo = this.getDefaultAsset(network);\n\n    return {\n      amount: tokenAmount,\n      asset: assetInfo.address,\n      extra: {\n        name: assetInfo.name,\n        version: assetInfo.version,\n      },\n    };\n  }\n\n  /**\n   * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal USDC)\n   *\n   * @param decimalAmount - The decimal amount to convert\n   * @param network - The network to use\n   * @returns The token amount as a string\n   */\n  private convertToTokenAmount(decimalAmount: string, network: Network): string {\n    const decimals = this.getAssetDecimals(network);\n    const amount = parseFloat(decimalAmount);\n    if (isNaN(amount)) {\n      throw new Error(`Invalid amount: ${decimalAmount}`);\n    }\n    // Convert to smallest unit (e.g., for USDC with 6 decimals: 0.10 * 10^6 = 100000)\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  /**\n   * Get the default asset info for a network (typically USDC)\n   *\n   * @param network - The network to get asset info for\n   * @returns The asset information including address, name, and version\n   */\n  private getDefaultAsset(network: Network): { address: string; name: string; version: string } {\n    // Map of network to USDC info including EIP-712 domain parameters\n    const usdcInfo: Record<string, { address: string; name: string; version: string }> = {\n      \"eip155:8453\": {\n        address: \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\n        name: \"USD Coin\",\n        version: \"2\",\n      }, // Base mainnet USDC\n      \"eip155:84532\": {\n        address: \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\",\n        name: \"USDC\",\n        version: \"2\",\n      }, // Base Sepolia USDC\n      \"eip155:1\": {\n        address: \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\n        name: \"USD Coin\",\n        version: \"2\",\n      }, // Ethereum mainnet USDC\n      \"eip155:11155111\": {\n        address: \"0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238\",\n        name: \"USDC\",\n        version: \"2\",\n      }, // Sepolia USDC\n      \"eip155:5003\": {\n        address: \"0x3D884Eca2a1E65A41Cd54b1CF55537dAe35d7BDC\",\n        name: \"USDC Token\",\n        version: \"1\",\n      }, // Mantle testnet USDC\n    };\n\n    const assetInfo = usdcInfo[network];\n    if (!assetInfo) {\n      throw new Error(`No default asset configured for network ${network}`);\n    }\n\n    return assetInfo;\n  }\n\n  /**\n   * Get asset info for a given symbol on a network\n   *\n   * @param symbol - The asset symbol\n   * @param network - The network to use\n   * @returns The asset information including address, name, and version\n   */\n  private getAssetInfo(\n    symbol: string,\n    network: Network,\n  ): { address: string; name: string; version: string } {\n    const upperSymbol = symbol.toUpperCase();\n\n    // For now, only support USDC\n    if (upperSymbol === \"USDC\" || upperSymbol === \"USD\") {\n      return this.getDefaultAsset(network);\n    }\n\n    // Could extend to support other tokens\n    throw new Error(`Unsupported asset: ${symbol} on network ${network}`);\n  }\n\n  /**\n   * Get the number of decimals for the asset\n   *\n   * @param _ - The network to use (unused)\n   * @returns The number of decimals for the asset\n   */\n  private getAssetDecimals(_: Network): number {\n    // USDC has 6 decimals on all EVM chains\n    return 6;\n  }\n}\n","import { x402ResourceServer } from \"x402-core-mantle/server\";\nimport { Network } from \"x402-core-mantle/types\";\nimport { ExactEvmScheme } from \"./scheme\";\n\n/**\n * Configuration options for registering EVM schemes to an x402ResourceServer\n */\nexport interface EvmResourceServerConfig {\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 payment schemes to an x402ResourceServer instance.\n *\n * This function registers:\n * - V2: eip155:* wildcard scheme with ExactEvmScheme (or specific networks if provided)\n *\n * @param server - The x402ResourceServer instance to register schemes to\n * @param config - Configuration for EVM resource server registration\n * @returns The server instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactEvmScheme } from \"@x402/evm/exact/server/register\";\n * import { x402ResourceServer } from \"x402-core-mantle/server\";\n *\n * const server = new x402ResourceServer(facilitatorClient);\n * registerExactEvmScheme(server, {});\n * ```\n */\nexport function registerExactEvmScheme(\n  server: x402ResourceServer,\n  config: EvmResourceServerConfig = {},\n): x402ResourceServer {\n  // Register V2 scheme\n  if (config.networks && config.networks.length > 0) {\n    // Register specific networks\n    config.networks.forEach(network => {\n      server.register(network, new ExactEvmScheme());\n    });\n  } else {\n    // Register wildcard for all EVM chains\n    server.register(\"eip155:*\", new ExactEvmScheme());\n  }\n\n  return server;\n}\n"],"mappings":";AAYO,IAAM,iBAAN,MAAoD;AAAA,EAApD;AACL,SAAS,SAAS;AAClB,SAAQ,eAA8B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBvC,oBAAoB,QAAqC;AACvD,SAAK,aAAa,KAAK,MAAM;AAC7B,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAM,WAAW,OAAc,SAAwC;AAErE,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;AAGA,UAAM,SAAS,KAAK,oBAAoB,KAAK;AAG7C,eAAW,UAAU,KAAK,cAAc;AACtC,YAAM,SAAS,MAAM,OAAO,QAAQ,OAAO;AAC3C,UAAI,WAAW,MAAM;AACnB,eAAO;AAAA,MACT;AAAA,IACF;AAGA,WAAO,KAAK,uBAAuB,QAAQ,OAAO;AAAA,EACpD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,2BACE,qBACA,eAMA,eAC8B;AAE9B,SAAK;AACL,SAAK;AACL,WAAO,QAAQ,QAAQ,mBAAmB;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,oBAAoB,OAAgC;AAC1D,QAAI,OAAO,UAAU,UAAU;AAC7B,aAAO;AAAA,IACT;AAGA,UAAM,aAAa,MAAM,QAAQ,OAAO,EAAE,EAAE,KAAK;AACjD,UAAM,SAAS,WAAW,UAAU;AAEpC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,yBAAyB,KAAK,EAAE;AAAA,IAClD;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,uBAAuB,QAAgB,SAA+B;AAE5E,UAAM,cAAc,KAAK,qBAAqB,OAAO,SAAS,GAAG,OAAO;AACxE,UAAM,YAAY,KAAK,gBAAgB,OAAO;AAE9C,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,OAAO,UAAU;AAAA,MACjB,OAAO;AAAA,QACL,MAAM,UAAU;AAAA,QAChB,SAAS,UAAU;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,qBAAqB,eAAuB,SAA0B;AAC5E,UAAM,WAAW,KAAK,iBAAiB,OAAO;AAC9C,UAAM,SAAS,WAAW,aAAa;AACvC,QAAI,MAAM,MAAM,GAAG;AACjB,YAAM,IAAI,MAAM,mBAAmB,aAAa,EAAE;AAAA,IACpD;AAEA,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,gBAAgB,SAAsE;AAE5F,UAAM,WAA+E;AAAA,MACnF,eAAe;AAAA,QACb,SAAS;AAAA,QACT,MAAM;AAAA,QACN,SAAS;AAAA,MACX;AAAA;AAAA,MACA,gBAAgB;AAAA,QACd,SAAS;AAAA,QACT,MAAM;AAAA,QACN,SAAS;AAAA,MACX;AAAA;AAAA,MACA,YAAY;AAAA,QACV,SAAS;AAAA,QACT,MAAM;AAAA,QACN,SAAS;AAAA,MACX;AAAA;AAAA,MACA,mBAAmB;AAAA,QACjB,SAAS;AAAA,QACT,MAAM;AAAA,QACN,SAAS;AAAA,MACX;AAAA;AAAA,MACA,eAAe;AAAA,QACb,SAAS;AAAA,QACT,MAAM;AAAA,QACN,SAAS;AAAA,MACX;AAAA;AAAA,IACF;AAEA,UAAM,YAAY,SAAS,OAAO;AAClC,QAAI,CAAC,WAAW;AACd,YAAM,IAAI,MAAM,2CAA2C,OAAO,EAAE;AAAA,IACtE;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,aACN,QACA,SACoD;AACpD,UAAM,cAAc,OAAO,YAAY;AAGvC,QAAI,gBAAgB,UAAU,gBAAgB,OAAO;AACnD,aAAO,KAAK,gBAAgB,OAAO;AAAA,IACrC;AAGA,UAAM,IAAI,MAAM,sBAAsB,MAAM,eAAe,OAAO,EAAE;AAAA,EACtE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,iBAAiB,GAAoB;AAE3C,WAAO;AAAA,EACT;AACF;;;ACvNO,SAAS,uBACd,QACA,SAAkC,CAAC,GACf;AAEpB,MAAI,OAAO,YAAY,OAAO,SAAS,SAAS,GAAG;AAEjD,WAAO,SAAS,QAAQ,aAAW;AACjC,aAAO,SAAS,SAAS,IAAI,eAAe,CAAC;AAAA,IAC/C,CAAC;AAAA,EACH,OAAO;AAEL,WAAO,SAAS,YAAY,IAAI,eAAe,CAAC;AAAA,EAClD;AAEA,SAAO;AACT;","names":[]}

package/dist/esm/exact/v1/client/index.d.mts

@@ -0,0 +1,37 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from 'x402-core-mantle/types';
+import { C as ClientEvmSigner } from '../../../signer-5OVDxViv.mjs';
+
+/**
+ * EVM client implementation for the Exact payment scheme (V1).
+ */
+declare class ExactEvmSchemeV1 implements SchemeNetworkClient {
+    private readonly signer;
+    readonly scheme = "exact";
+    /**
+     * Creates a new ExactEvmClientV1 instance.
+     *
+     * @param signer - The EVM signer for client operations
+     */
+    constructor(signer: ClientEvmSigner);
+    /**
+     * Creates a payment payload for the Exact scheme (V1).
+     *
+     * @param x402Version - The x402 protocol version
+     * @param paymentRequirements - The payment requirements
+     * @returns Promise resolving to a payment payload
+     */
+    createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "x402Version" | "payload"> & {
+        scheme: string;
+        network: Network;
+    }>;
+    /**
+     * Sign the EIP-3009 authorization using EIP-712
+     *
+     * @param authorization - The authorization to sign
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to the signature
+     */
+    private signAuthorization;
+}
+
+export { ExactEvmSchemeV1 };

package/dist/esm/exact/v1/client/index.mjs

@@ -0,0 +1,8 @@
+import {
+  ExactEvmSchemeV1
+} from "../../../chunk-S5OEANGR.mjs";
+import "../../../chunk-CYGMVQCG.mjs";
+export {
+  ExactEvmSchemeV1
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/v1/client/index.mjs.map

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

package/dist/esm/exact/v1/facilitator/index.d.mts

@@ -0,0 +1,62 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from 'x402-core-mantle/types';
+import { F as FacilitatorEvmSigner } from '../../../signer-5OVDxViv.mjs';
+
+interface ExactEvmSchemeV1Config {
+    /**
+     * If enabled, the facilitator will deploy ERC-4337 smart wallets
+     * via EIP-6492 when encountering undeployed contract signatures.
+     *
+     * @default false
+     */
+    deployERC4337WithEIP6492?: boolean;
+}
+/**
+ * EVM facilitator implementation for the Exact payment scheme (V1).
+ */
+declare class ExactEvmSchemeV1 implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact";
+    readonly caipFamily = "eip155:*";
+    private readonly config;
+    /**
+     * Creates a new ExactEvmFacilitatorV1 instance.
+     *
+     * @param signer - The EVM signer for facilitator operations
+     * @param config - Optional configuration for the facilitator
+     */
+    constructor(signer: FacilitatorEvmSigner, config?: ExactEvmSchemeV1Config);
+    /**
+     * Get mechanism-specific extra data for the supported kinds endpoint.
+     * For EVM, no extra data is needed.
+     *
+     * @param _ - The network identifier (unused for EVM)
+     * @returns undefined (EVM has no extra data)
+     */
+    getExtra(_: string): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses used by this facilitator.
+     * Returns all addresses this facilitator can use for signing/settling transactions.
+     *
+     * @param _ - The network identifier (unused for EVM, addresses are network-agnostic)
+     * @returns Array of facilitator wallet addresses
+     */
+    getSigners(_: string): string[];
+    /**
+     * Verifies a payment payload (V1).
+     *
+     * @param payload - The payment payload to verify
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to verification response
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settles a payment by executing the transfer (V1).
+     *
+     * @param payload - The payment payload to settle
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to settlement response
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+
+export { ExactEvmSchemeV1, type ExactEvmSchemeV1Config };

package/dist/esm/exact/v1/facilitator/index.mjs

@@ -0,0 +1,8 @@
+import {
+  ExactEvmSchemeV1
+} from "../../../chunk-DI3EK7PR.mjs";
+import "../../../chunk-CYGMVQCG.mjs";
+export {
+  ExactEvmSchemeV1
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/v1/facilitator/index.mjs.map

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

package/dist/esm/index.d.mts

@@ -0,0 +1,36 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from 'x402-core-mantle/types';
+import { C as ClientEvmSigner } from './signer-5OVDxViv.mjs';
+export { F as FacilitatorEvmSigner, t as toClientEvmSigner, a as toFacilitatorEvmSigner } from './signer-5OVDxViv.mjs';
+
+/**
+ * EVM client implementation for the Exact payment scheme.
+ *
+ */
+declare class ExactEvmScheme implements SchemeNetworkClient {
+    private readonly signer;
+    readonly scheme = "exact";
+    /**
+     * Creates a new ExactEvmClient instance.
+     *
+     * @param signer - The EVM signer for client operations
+     */
+    constructor(signer: ClientEvmSigner);
+    /**
+     * Creates a payment payload for the Exact scheme.
+     *
+     * @param x402Version - The x402 protocol version
+     * @param paymentRequirements - The payment requirements
+     * @returns Promise resolving to a payment payload
+     */
+    createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "x402Version" | "payload">>;
+    /**
+     * Sign the EIP-3009 authorization using EIP-712
+     *
+     * @param authorization - The authorization to sign
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to the signature
+     */
+    private signAuthorization;
+}
+
+export { ClientEvmSigner, ExactEvmScheme };

package/dist/esm/index.mjs

@@ -0,0 +1,21 @@
+import {
+  ExactEvmScheme
+} from "./chunk-T3FPOH7F.mjs";
+import "./chunk-CYGMVQCG.mjs";
+
+// src/signer.ts
+function toClientEvmSigner(signer) {
+  return signer;
+}
+function toFacilitatorEvmSigner(client) {
+  return {
+    ...client,
+    getAddresses: () => [client.address]
+  };
+}
+export {
+  ExactEvmScheme,
+  toClientEvmSigner,
+  toFacilitatorEvmSigner
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/signer.ts"],"sourcesContent":["/**\n * ClientEvmSigner - Used by x402 clients to sign payment authorizations\n * This is typically a LocalAccount or wallet that holds private keys\n * and can sign EIP-712 typed data for payment authorizations\n */\nexport type ClientEvmSigner = {\n  readonly address: `0x${string}`;\n  signTypedData(message: {\n    domain: Record<string, unknown>;\n    types: Record<string, unknown>;\n    primaryType: string;\n    message: Record<string, unknown>;\n  }): Promise<`0x${string}`>;\n};\n\n/**\n * FacilitatorEvmSigner - Used by x402 facilitators to verify and settle payments\n * This is typically a viem PublicClient + WalletClient combination that can\n * read contract state, verify signatures, write transactions, and wait for receipts\n *\n * Supports multiple addresses for load balancing, key rotation, and high availability\n */\nexport type FacilitatorEvmSigner = {\n  /**\n   * Get all addresses this facilitator can use for signing\n   * Enables dynamic address selection for load balancing and key rotation\n   */\n  getAddresses(): readonly `0x${string}`[];\n\n  readContract(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args?: readonly unknown[];\n  }): Promise<unknown>;\n  verifyTypedData(args: {\n    address: `0x${string}`;\n    domain: Record<string, unknown>;\n    types: Record<string, unknown>;\n    primaryType: string;\n    message: Record<string, unknown>;\n    signature: `0x${string}`;\n  }): Promise<boolean>;\n  writeContract(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args: readonly unknown[];\n  }): Promise<`0x${string}`>;\n  sendTransaction(args: { to: `0x${string}`; data: `0x${string}` }): Promise<`0x${string}`>;\n  waitForTransactionReceipt(args: { hash: `0x${string}` }): Promise<{ status: string }>;\n  getCode(args: { address: `0x${string}` }): Promise<`0x${string}` | undefined>;\n};\n\n/**\n * Converts a signer to a ClientEvmSigner\n *\n * @param signer - The signer to convert to a ClientEvmSigner\n * @returns The converted signer\n */\nexport function toClientEvmSigner(signer: ClientEvmSigner): ClientEvmSigner {\n  return signer;\n}\n\n/**\n * Converts a viem client with single address to a FacilitatorEvmSigner\n * Wraps the single address in a getAddresses() function for compatibility\n *\n * @param client - The client to convert (must have 'address' property)\n * @returns FacilitatorEvmSigner with getAddresses() support\n */\nexport function toFacilitatorEvmSigner(\n  client: Omit<FacilitatorEvmSigner, \"getAddresses\"> & { address: `0x${string}` },\n): FacilitatorEvmSigner {\n  return {\n    ...client,\n    getAddresses: () => [client.address],\n  };\n}\n"],"mappings":";;;;;;AA4DO,SAAS,kBAAkB,QAA0C;AAC1E,SAAO;AACT;AASO,SAAS,uBACd,QACsB;AACtB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,cAAc,MAAM,CAAC,OAAO,OAAO;AAAA,EACrC;AACF;","names":[]}

package/dist/esm/signer-5OVDxViv.d.mts

@@ -0,0 +1,79 @@
+/**
+ * ClientEvmSigner - Used by x402 clients to sign payment authorizations
+ * This is typically a LocalAccount or wallet that holds private keys
+ * and can sign EIP-712 typed data for payment authorizations
+ */
+type ClientEvmSigner = {
+    readonly address: `0x${string}`;
+    signTypedData(message: {
+        domain: Record<string, unknown>;
+        types: Record<string, unknown>;
+        primaryType: string;
+        message: Record<string, unknown>;
+    }): Promise<`0x${string}`>;
+};
+/**
+ * FacilitatorEvmSigner - Used by x402 facilitators to verify and settle payments
+ * This is typically a viem PublicClient + WalletClient combination that can
+ * read contract state, verify signatures, write transactions, and wait for receipts
+ *
+ * Supports multiple addresses for load balancing, key rotation, and high availability
+ */
+type FacilitatorEvmSigner = {
+    /**
+     * Get all addresses this facilitator can use for signing
+     * Enables dynamic address selection for load balancing and key rotation
+     */
+    getAddresses(): readonly `0x${string}`[];
+    readContract(args: {
+        address: `0x${string}`;
+        abi: readonly unknown[];
+        functionName: string;
+        args?: readonly unknown[];
+    }): Promise<unknown>;
+    verifyTypedData(args: {
+        address: `0x${string}`;
+        domain: Record<string, unknown>;
+        types: Record<string, unknown>;
+        primaryType: string;
+        message: Record<string, unknown>;
+        signature: `0x${string}`;
+    }): Promise<boolean>;
+    writeContract(args: {
+        address: `0x${string}`;
+        abi: readonly unknown[];
+        functionName: string;
+        args: readonly unknown[];
+    }): Promise<`0x${string}`>;
+    sendTransaction(args: {
+        to: `0x${string}`;
+        data: `0x${string}`;
+    }): Promise<`0x${string}`>;
+    waitForTransactionReceipt(args: {
+        hash: `0x${string}`;
+    }): Promise<{
+        status: string;
+    }>;
+    getCode(args: {
+        address: `0x${string}`;
+    }): Promise<`0x${string}` | undefined>;
+};
+/**
+ * Converts a signer to a ClientEvmSigner
+ *
+ * @param signer - The signer to convert to a ClientEvmSigner
+ * @returns The converted signer
+ */
+declare function toClientEvmSigner(signer: ClientEvmSigner): ClientEvmSigner;
+/**
+ * Converts a viem client with single address to a FacilitatorEvmSigner
+ * Wraps the single address in a getAddresses() function for compatibility
+ *
+ * @param client - The client to convert (must have 'address' property)
+ * @returns FacilitatorEvmSigner with getAddresses() support
+ */
+declare function toFacilitatorEvmSigner(client: Omit<FacilitatorEvmSigner, "getAddresses"> & {
+    address: `0x${string}`;
+}): FacilitatorEvmSigner;
+
+export { type ClientEvmSigner as C, type FacilitatorEvmSigner as F, toFacilitatorEvmSigner as a, toClientEvmSigner as t };

package/dist/esm/v1/index.d.mts

@@ -0,0 +1,7 @@
+export { ExactEvmSchemeV1 } from '../exact/v1/client/index.mjs';
+import 'x402-core-mantle/types';
+import '../signer-5OVDxViv.mjs';
+
+declare const NETWORKS: string[];
+
+export { NETWORKS };