@t402/evm 2.0.0

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact/server/index.ts","../../../../src/tokens.ts","../../../../src/exact/server/scheme.ts","../../../../src/exact/server/register.ts"],"sourcesContent":["export { ExactEvmScheme } from \"./scheme\";\nexport { registerExactEvmScheme } from \"./register\";\nexport type { EvmResourceServerConfig } from \"./register\";\n","/**\n * Token configuration for T402 EVM payments\n *\n * This module provides comprehensive token definitions including:\n * - USDT0 (Tether's new omnichain token with EIP-3009 support)\n * - USDC (USD Coin with EIP-3009 support)\n * - Legacy tokens configuration\n */\n\nimport type { Address } from \"viem\";\n\n/**\n * Token type classification for payment scheme selection\n */\nexport type TokenType = \"eip3009\" | \"legacy\";\n\n/**\n * Token configuration with EIP-712 domain parameters\n */\nexport interface TokenConfig {\n  /** Token contract address */\n  address: Address;\n  /** Token symbol (e.g., \"USDT0\", \"USDC\") */\n  symbol: string;\n  /** EIP-712 domain name for signing */\n  name: string;\n  /** EIP-712 domain version for signing */\n  version: string;\n  /** Number of decimal places */\n  decimals: number;\n  /** Token type for scheme selection */\n  tokenType: TokenType;\n  /** Payment priority (lower = higher priority) */\n  priority: number;\n}\n\n/**\n * Network token registry mapping network -> symbol -> config\n */\nexport type NetworkTokenRegistry = Record<string, Record<string, TokenConfig>>;\n\n/**\n * USDT0 Contract Addresses by Network\n * Source: https://docs.tether.io/usdt0/integration-guide/deployed-contracts\n *\n * USDT0 is Tether's new omnichain token using LayerZero OFT standard.\n * Key features:\n * - Supports EIP-3009 transferWithAuthorization (gasless transfers)\n * - Supports EIP-2612 permit\n * - Native cross-chain via LayerZero\n */\nexport const USDT0_ADDRESSES: Record<string, Address> = {\n  // Ethereum Mainnet - OFT Adapter (bridge endpoint)\n  \"eip155:1\": \"0x6C96dE32CEa08842dcc4058c14d3aaAD7Fa41dee\",\n  // Arbitrum One - Native USDT0\n  \"eip155:42161\": \"0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9\",\n  // Ink Mainnet\n  \"eip155:57073\": \"0x0200C29006150606B650577BBE7B6248F58470c1\",\n  // Berachain Mainnet\n  \"eip155:80094\": \"0x779Ded0c9e1022225f8E0630b35a9b54bE713736\",\n  // Unichain Mainnet\n  \"eip155:130\": \"0x588ce4F028D8e7B53B687865d6A67b3A54C75518\",\n};\n\n/**\n * USDC Contract Addresses by Network\n * Native USDC with EIP-3009 support\n */\nexport const USDC_ADDRESSES: Record<string, Address> = {\n  // Ethereum Mainnet\n  \"eip155:1\": \"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\n  // Base Mainnet\n  \"eip155:8453\": \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\n  // Base Sepolia (testnet)\n  \"eip155:84532\": \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\",\n  // Sepolia (testnet)\n  \"eip155:11155111\": \"0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238\",\n  // Arbitrum One\n  \"eip155:42161\": \"0xaf88d065e77c8cC2239327C5EDb3A432268e5831\",\n  // Polygon Mainnet\n  \"eip155:137\": \"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359\",\n};\n\n/**\n * Traditional USDT Addresses (Legacy - no EIP-3009 support)\n * These require the approve + transferFrom pattern\n */\nexport const USDT_LEGACY_ADDRESSES: Record<string, Address> = {\n  // Ethereum Mainnet\n  \"eip155:1\": \"0xdAC17F958D2ee523a2206206994597C13D831ec7\",\n  // Polygon Mainnet\n  \"eip155:137\": \"0xc2132D05D31c914a87C6611C10748AEb04B58e8F\",\n};\n\n/**\n * Complete token registry with all supported tokens per network\n */\nexport const TOKEN_REGISTRY: NetworkTokenRegistry = {\n  // Ethereum Mainnet\n  \"eip155:1\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:1\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:1\"],\n      symbol: \"USDC\",\n      name: \"USD Coin\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n    USDT: {\n      address: USDT_LEGACY_ADDRESSES[\"eip155:1\"],\n      symbol: \"USDT\",\n      name: \"TetherUSD\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"legacy\",\n      priority: 10, // Lower priority due to legacy flow\n    },\n  },\n\n  // Arbitrum One\n  \"eip155:42161\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:42161\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:42161\"],\n      symbol: \"USDC\",\n      name: \"USD Coin\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n  },\n\n  // Ink Mainnet\n  \"eip155:57073\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:57073\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Berachain Mainnet\n  \"eip155:80094\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:80094\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Unichain Mainnet\n  \"eip155:130\": {\n    USDT0: {\n      address: USDT0_ADDRESSES[\"eip155:130\"],\n      symbol: \"USDT0\",\n      name: \"TetherToken\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 1,\n    },\n  },\n\n  // Base Mainnet\n  \"eip155:8453\": {\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:8453\"],\n      symbol: \"USDC\",\n      name: \"USD Coin\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n  },\n\n  // Base Sepolia (testnet)\n  \"eip155:84532\": {\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:84532\"],\n      symbol: \"USDC\",\n      name: \"USDC\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n  },\n\n  // Sepolia (testnet)\n  \"eip155:11155111\": {\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:11155111\"],\n      symbol: \"USDC\",\n      name: \"USDC\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n  },\n\n  // Polygon Mainnet\n  \"eip155:137\": {\n    USDC: {\n      address: USDC_ADDRESSES[\"eip155:137\"],\n      symbol: \"USDC\",\n      name: \"USD Coin\",\n      version: \"2\",\n      decimals: 6,\n      tokenType: \"eip3009\",\n      priority: 2,\n    },\n    USDT: {\n      address: USDT_LEGACY_ADDRESSES[\"eip155:137\"],\n      symbol: \"USDT\",\n      name: \"TetherUSD\",\n      version: \"1\",\n      decimals: 6,\n      tokenType: \"legacy\",\n      priority: 10,\n    },\n  },\n};\n\n/**\n * Token priority for payment method selection\n * Lower number = higher priority\n */\nexport const TOKEN_PRIORITY: Record<string, number> = {\n  USDT0: 1, // Highest priority - gasless, cross-chain\n  USDC: 2, // Second - wide support, EIP-3009\n  USDT: 10, // Lower - requires approval transaction\n  DAI: 5, // Medium - good support\n};\n\n/**\n * Get token configuration for a specific token on a network\n */\nexport function getTokenConfig(network: string, symbol: string): TokenConfig | undefined {\n  return TOKEN_REGISTRY[network]?.[symbol.toUpperCase()];\n}\n\n/**\n * Get all tokens available on a network\n */\nexport function getNetworkTokens(network: string): TokenConfig[] {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens) return [];\n  return Object.values(tokens).sort((a, b) => a.priority - b.priority);\n}\n\n/**\n * Get the default/preferred token for a network\n * Prefers USDT0 > USDC > others based on priority\n */\nexport function getDefaultToken(network: string): TokenConfig | undefined {\n  const tokens = getNetworkTokens(network);\n  return tokens[0]; // Already sorted by priority\n}\n\n/**\n * Get token by contract address on a network\n */\nexport function getTokenByAddress(network: string, address: Address): TokenConfig | undefined {\n  const tokens = TOKEN_REGISTRY[network];\n  if (!tokens) return undefined;\n\n  const lowerAddress = address.toLowerCase();\n  return Object.values(tokens).find((t) => t.address.toLowerCase() === lowerAddress);\n}\n\n/**\n * Check if a token supports EIP-3009 (gasless transfers)\n */\nexport function supportsEIP3009(network: string, symbol: string): boolean {\n  const config = getTokenConfig(network, symbol);\n  return config?.tokenType === \"eip3009\";\n}\n\n/**\n * Get all networks that support a specific token\n */\nexport function getNetworksForToken(symbol: string): string[] {\n  const networks: string[] = [];\n  for (const [network, tokens] of Object.entries(TOKEN_REGISTRY)) {\n    if (tokens[symbol.toUpperCase()]) {\n      networks.push(network);\n    }\n  }\n  return networks;\n}\n\n/**\n * Get USDT0 networks (primary T402 token)\n */\nexport function getUsdt0Networks(): string[] {\n  return getNetworksForToken(\"USDT0\");\n}\n\n/**\n * EIP-712 domain configuration for a token\n */\nexport function getEIP712Domain(\n  network: string,\n  tokenAddress: Address,\n  chainId: number,\n): { name: string; version: string; chainId: number; verifyingContract: Address } | undefined {\n  const token = getTokenByAddress(network, tokenAddress);\n  if (!token) return undefined;\n\n  return {\n    name: token.name,\n    version: token.version,\n    chainId,\n    verifyingContract: token.address,\n  };\n}\n","import {\n  AssetAmount,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n  MoneyParser,\n} from \"@t402/core/types\";\nimport {\n  getDefaultToken,\n  getTokenConfig,\n  getTokenByAddress,\n  TokenConfig,\n  TOKEN_REGISTRY,\n} from \"../../tokens.js\";\n\n/**\n * Configuration options for ExactEvmScheme\n */\nexport interface ExactEvmSchemeConfig {\n  /** Preferred token symbol (e.g., \"USDT0\", \"USDC\"). Defaults to network's highest priority token. */\n  preferredToken?: string;\n}\n\n/**\n * EVM server implementation for the Exact payment scheme.\n * Supports USDT0, USDC, and other EIP-3009 compatible tokens.\n */\nexport class ExactEvmScheme implements SchemeNetworkServer {\n  readonly scheme = \"exact\";\n  private moneyParsers: MoneyParser[] = [];\n  private config: ExactEvmSchemeConfig;\n\n  constructor(config: ExactEvmSchemeConfig = {}) {\n    this.config = config;\n  }\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.t402Version - The t402 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      t402Version: 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 the preferred token on the specified network.\n   * Priority: USDT0 > USDC > other configured tokens\n   *\n   * @param amount - The decimal amount (e.g., 1.50)\n   * @param network - The network to use\n   * @returns The parsed asset amount\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    const token = this.getDefaultAsset(network);\n\n    // Convert decimal amount to token amount\n    const tokenAmount = this.convertToTokenAmount(amount.toString(), network, token.decimals);\n\n    return {\n      amount: tokenAmount,\n      asset: token.address,\n      extra: {\n        name: token.name,\n        version: token.version,\n        symbol: token.symbol,\n        tokenType: token.tokenType,\n      },\n    };\n  }\n\n  /**\n   * Convert decimal amount to token units (e.g., 0.10 -> 100000 for 6-decimal tokens)\n   *\n   * @param decimalAmount - The decimal amount to convert\n   * @param network - The network to use\n   * @param decimals - Optional number of decimals (defaults to network asset decimals)\n   * @returns The token amount as a string\n   */\n  private convertToTokenAmount(decimalAmount: string, network: Network, decimals?: number): string {\n    const tokenDecimals = 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/USDT with 6 decimals: 0.10 * 10^6 = 100000)\n    const tokenAmount = Math.floor(amount * Math.pow(10, tokenDecimals));\n    return tokenAmount.toString();\n  }\n\n  /**\n   * Get the default asset info for a network.\n   * Priority: configured preferredToken > USDT0 > USDC > first available\n   *\n   * @param network - The network to get asset info for\n   * @returns The asset information including address, name, version, and decimals\n   */\n  private getDefaultAsset(network: Network): TokenConfig {\n    // If a preferred token is configured, try to use it\n    if (this.config.preferredToken) {\n      const preferred = getTokenConfig(network, this.config.preferredToken);\n      if (preferred) return preferred;\n    }\n\n    // Use the network's default token (sorted by priority)\n    const defaultToken = getDefaultToken(network);\n    if (defaultToken) return defaultToken;\n\n    throw new Error(`No tokens configured for network ${network}`);\n  }\n\n  /**\n   * Get asset info for a given symbol on a network\n   *\n   * @param symbol - The asset symbol (e.g., \"USDT0\", \"USDC\", \"USDT\")\n   * @param network - The network to use\n   * @returns The token configuration\n   */\n  private getAssetInfo(symbol: string, network: Network): TokenConfig {\n    const token = getTokenConfig(network, symbol);\n    if (token) return token;\n\n    // Fallback: treat \"USD\" as request for default stablecoin\n    if (symbol.toUpperCase() === \"USD\") {\n      return this.getDefaultAsset(network);\n    }\n\n    throw new Error(`Unsupported asset: ${symbol} on network ${network}`);\n  }\n\n  /**\n   * Get the number of decimals for the asset on a network\n   *\n   * @param network - The network to use\n   * @param tokenAddress - Optional token address to look up\n   * @returns The number of decimals for the asset\n   */\n  private getAssetDecimals(network: Network, tokenAddress?: string): number {\n    if (tokenAddress) {\n      const token = getTokenByAddress(network, tokenAddress as `0x${string}`);\n      if (token) return token.decimals;\n    }\n    // Default to 6 decimals (USDC/USDT standard)\n    return 6;\n  }\n\n  /**\n   * Get all supported networks\n   */\n  static getSupportedNetworks(): string[] {\n    return Object.keys(TOKEN_REGISTRY);\n  }\n\n  /**\n   * Check if a network is supported\n   */\n  static isNetworkSupported(network: string): boolean {\n    return network in TOKEN_REGISTRY;\n  }\n}\n","import { t402ResourceServer } from \"@t402/core/server\";\nimport { Network } from \"@t402/core/types\";\nimport { ExactEvmScheme } from \"./scheme\";\n\n/**\n * Configuration options for registering EVM schemes to an t402ResourceServer\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 t402ResourceServer instance.\n *\n * This function registers:\n * - V2: eip155:* wildcard scheme with ExactEvmScheme (or specific networks if provided)\n *\n * @param server - The t402ResourceServer 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 \"@t402/evm/exact/server/register\";\n * import { t402ResourceServer } from \"@t402/core/server\";\n *\n * const server = new t402ResourceServer(facilitatorClient);\n * registerExactEvmScheme(server, {});\n * ```\n */\nexport function registerExactEvmScheme(\n  server: t402ResourceServer,\n  config: EvmResourceServerConfig = {},\n): t402ResourceServer {\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":"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","names":[]}

package/dist/cjs/exact/v1/client/index.d.ts

@@ -0,0 +1,37 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload, Network } from '@t402/core/types';
+import { C as ClientEvmSigner } from '../../../signer-BkcAzwYi.js';
+
+/**
+ * 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 t402Version - The t402 protocol version
+     * @param paymentRequirements - The payment requirements
+     * @returns Promise resolving to a payment payload
+     */
+    createPaymentPayload(t402Version: number, paymentRequirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "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/cjs/exact/v1/client/index.js

@@ -0,0 +1,147 @@
+"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/v1/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  ExactEvmSchemeV1: () => ExactEvmSchemeV1
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/exact/v1/client/scheme.ts
+var import_viem2 = require("viem");
+
+// src/constants.ts
+var authorizationTypes = {
+  TransferWithAuthorization: [
+    { name: "from", type: "address" },
+    { name: "to", type: "address" },
+    { name: "value", type: "uint256" },
+    { name: "validAfter", type: "uint256" },
+    { name: "validBefore", type: "uint256" },
+    { name: "nonce", type: "bytes32" }
+  ]
+};
+
+// src/utils.ts
+var import_viem = require("viem");
+function getEvmChainId(network) {
+  const networkMap = {
+    base: 8453,
+    "base-sepolia": 84532,
+    ethereum: 1,
+    sepolia: 11155111,
+    polygon: 137,
+    "polygon-amoy": 80002
+  };
+  return networkMap[network] || 1;
+}
+function createNonce() {
+  const cryptoObj = typeof globalThis.crypto !== "undefined" ? globalThis.crypto : globalThis.crypto;
+  if (!cryptoObj) {
+    throw new Error("Crypto API not available");
+  }
+  return (0, import_viem.toHex)(cryptoObj.getRandomValues(new Uint8Array(32)));
+}
+
+// src/exact/v1/client/scheme.ts
+var ExactEvmSchemeV1 = class {
+  /**
+   * Creates a new ExactEvmClientV1 instance.
+   *
+   * @param signer - The EVM signer for client operations
+   */
+  constructor(signer) {
+    this.signer = signer;
+    this.scheme = "exact";
+  }
+  /**
+   * Creates a payment payload for the Exact scheme (V1).
+   *
+   * @param t402Version - The t402 protocol version
+   * @param paymentRequirements - The payment requirements
+   * @returns Promise resolving to a payment payload
+   */
+  async createPaymentPayload(t402Version, paymentRequirements) {
+    const selectedV1 = paymentRequirements;
+    const nonce = createNonce();
+    const now = Math.floor(Date.now() / 1e3);
+    const authorization = {
+      from: this.signer.address,
+      to: (0, import_viem2.getAddress)(selectedV1.payTo),
+      value: selectedV1.maxAmountRequired,
+      validAfter: (now - 600).toString(),
+      // 10 minutes before
+      validBefore: (now + selectedV1.maxTimeoutSeconds).toString(),
+      nonce
+    };
+    const signature = await this.signAuthorization(authorization, selectedV1);
+    const payload = {
+      authorization,
+      signature
+    };
+    return {
+      t402Version,
+      scheme: selectedV1.scheme,
+      network: selectedV1.network,
+      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
+   */
+  async signAuthorization(authorization, requirements) {
+    const chainId = getEvmChainId(requirements.network);
+    if (!requirements.extra?.name || !requirements.extra?.version) {
+      throw new Error(
+        `EIP-712 domain parameters (name, version) are required in payment requirements for asset ${requirements.asset}`
+      );
+    }
+    const { name, version } = requirements.extra;
+    const domain = {
+      name,
+      version,
+      chainId,
+      verifyingContract: (0, import_viem2.getAddress)(requirements.asset)
+    };
+    const message = {
+      from: (0, import_viem2.getAddress)(authorization.from),
+      to: (0, import_viem2.getAddress)(authorization.to),
+      value: BigInt(authorization.value),
+      validAfter: BigInt(authorization.validAfter),
+      validBefore: BigInt(authorization.validBefore),
+      nonce: authorization.nonce
+    };
+    return await this.signer.signTypedData({
+      domain,
+      types: authorizationTypes,
+      primaryType: "TransferWithAuthorization",
+      message
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactEvmSchemeV1
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/exact/v1/client/index.ts","../../../../../src/exact/v1/client/scheme.ts","../../../../../src/constants.ts","../../../../../src/utils.ts"],"sourcesContent":["export { ExactEvmSchemeV1 } from \"./scheme\";\n","import {\n  Network,\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkClient,\n} from \"@t402/core/types\";\nimport { PaymentRequirementsV1 } from \"@t402/core/types/v1\";\nimport { getAddress } from \"viem\";\nimport { authorizationTypes } from \"../../../constants\";\nimport { ClientEvmSigner } from \"../../../signer\";\nimport { ExactEvmPayloadV1 } from \"../../../types\";\nimport { createNonce, getEvmChainId } from \"../../../utils\";\n\n/**\n * EVM client implementation for the Exact payment scheme (V1).\n */\nexport class ExactEvmSchemeV1 implements SchemeNetworkClient {\n  readonly scheme = \"exact\";\n\n  /**\n   * Creates a new ExactEvmClientV1 instance.\n   *\n   * @param signer - The EVM signer for client operations\n   */\n  constructor(private readonly signer: ClientEvmSigner) {}\n\n  /**\n   * Creates a payment payload for the Exact scheme (V1).\n   *\n   * @param t402Version - The t402 protocol version\n   * @param paymentRequirements - The payment requirements\n   * @returns Promise resolving to a payment payload\n   */\n  async createPaymentPayload(\n    t402Version: number,\n    paymentRequirements: PaymentRequirements,\n  ): Promise<\n    Pick<PaymentPayload, \"t402Version\" | \"payload\"> & { scheme: string; network: Network }\n  > {\n    const selectedV1 = paymentRequirements as unknown as PaymentRequirementsV1;\n    const nonce = createNonce();\n    const now = Math.floor(Date.now() / 1000);\n\n    const authorization: ExactEvmPayloadV1[\"authorization\"] = {\n      from: this.signer.address,\n      to: getAddress(selectedV1.payTo),\n      value: selectedV1.maxAmountRequired,\n      validAfter: (now - 600).toString(), // 10 minutes before\n      validBefore: (now + selectedV1.maxTimeoutSeconds).toString(),\n      nonce,\n    };\n\n    // Sign the authorization\n    const signature = await this.signAuthorization(authorization, selectedV1);\n\n    const payload: ExactEvmPayloadV1 = {\n      authorization,\n      signature,\n    };\n\n    return {\n      t402Version,\n      scheme: selectedV1.scheme,\n      network: selectedV1.network,\n      payload,\n    };\n  }\n\n  /**\n   * Sign the EIP-3009 authorization using EIP-712\n   *\n   * @param authorization - The authorization to sign\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to the signature\n   */\n  private async signAuthorization(\n    authorization: ExactEvmPayloadV1[\"authorization\"],\n    requirements: PaymentRequirementsV1,\n  ): Promise<`0x${string}`> {\n    const chainId = getEvmChainId(requirements.network);\n\n    if (!requirements.extra?.name || !requirements.extra?.version) {\n      throw new Error(\n        `EIP-712 domain parameters (name, version) are required in payment requirements for asset ${requirements.asset}`,\n      );\n    }\n\n    const { name, version } = requirements.extra;\n\n    const domain = {\n      name,\n      version,\n      chainId,\n      verifyingContract: getAddress(requirements.asset),\n    };\n\n    const message = {\n      from: getAddress(authorization.from),\n      to: getAddress(authorization.to),\n      value: BigInt(authorization.value),\n      validAfter: BigInt(authorization.validAfter),\n      validBefore: BigInt(authorization.validBefore),\n      nonce: authorization.nonce,\n    };\n\n    return await this.signer.signTypedData({\n      domain,\n      types: authorizationTypes,\n      primaryType: \"TransferWithAuthorization\",\n      message,\n    });\n  }\n}\n","// EIP-3009 TransferWithAuthorization types for EIP-712 signing\nexport const authorizationTypes = {\n  TransferWithAuthorization: [\n    { name: \"from\", type: \"address\" },\n    { name: \"to\", type: \"address\" },\n    { name: \"value\", type: \"uint256\" },\n    { name: \"validAfter\", type: \"uint256\" },\n    { name: \"validBefore\", type: \"uint256\" },\n    { name: \"nonce\", type: \"bytes32\" },\n  ],\n} as const;\n\n// Legacy transfer authorization types for EIP-712 signing\n// Used for tokens without EIP-3009 support (approve + transferFrom pattern)\nexport const legacyAuthorizationTypes = {\n  LegacyTransferAuthorization: [\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: \"spender\", type: \"address\" },\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// Standard ERC20 ABI for legacy token operations (approve + transferFrom pattern)\nexport const erc20LegacyABI = [\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: \"owner\", type: \"address\" },\n      { name: \"spender\", type: \"address\" },\n    ],\n    name: \"allowance\",\n    outputs: [{ name: \"\", type: \"uint256\" }],\n    stateMutability: \"view\",\n    type: \"function\",\n  },\n  {\n    inputs: [\n      { name: \"spender\", type: \"address\" },\n      { name: \"amount\", type: \"uint256\" },\n    ],\n    name: \"approve\",\n    outputs: [{ name: \"\", type: \"bool\" }],\n    stateMutability: \"nonpayable\",\n    type: \"function\",\n  },\n  {\n    inputs: [\n      { name: \"from\", type: \"address\" },\n      { name: \"to\", type: \"address\" },\n      { name: \"amount\", type: \"uint256\" },\n    ],\n    name: \"transferFrom\",\n    outputs: [{ name: \"\", type: \"bool\" }],\n    stateMutability: \"nonpayable\",\n    type: \"function\",\n  },\n] as const;\n","import { toHex } from \"viem\";\nimport { Network } from \"@t402/core/types\";\n\n/**\n * Extract chain ID from network string (e.g., \"base-sepolia\" -> 84532)\n * Used by v1 implementations\n *\n * @param network - The network identifier\n * @returns The numeric chain ID\n */\nexport function getEvmChainId(network: Network): number {\n  const networkMap: Record<string, number> = {\n    base: 8453,\n    \"base-sepolia\": 84532,\n    ethereum: 1,\n    sepolia: 11155111,\n    polygon: 137,\n    \"polygon-amoy\": 80002,\n  };\n  return networkMap[network] || 1;\n}\n\n/**\n * Create a random 32-byte nonce for authorization\n *\n * @returns A hex-encoded 32-byte nonce\n */\nexport function createNonce(): `0x${string}` {\n  // Use dynamic import to avoid require() in ESM context\n  const cryptoObj =\n    typeof globalThis.crypto !== \"undefined\"\n      ? globalThis.crypto\n      : (globalThis as { crypto?: Crypto }).crypto;\n\n  if (!cryptoObj) {\n    throw new Error(\"Crypto API not available\");\n  }\n\n  return toHex(cryptoObj.getRandomValues(new Uint8Array(32)));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACOA,IAAAA,eAA2B;;;ACNpB,IAAM,qBAAqB;AAAA,EAChC,2BAA2B;AAAA,IACzB,EAAE,MAAM,QAAQ,MAAM,UAAU;AAAA,IAChC,EAAE,MAAM,MAAM,MAAM,UAAU;AAAA,IAC9B,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,IACjC,EAAE,MAAM,cAAc,MAAM,UAAU;AAAA,IACtC,EAAE,MAAM,eAAe,MAAM,UAAU;AAAA,IACvC,EAAE,MAAM,SAAS,MAAM,UAAU;AAAA,EACnC;AACF;;;ACVA,kBAAsB;AAUf,SAAS,cAAc,SAA0B;AACtD,QAAM,aAAqC;AAAA,IACzC,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,UAAU;AAAA,IACV,SAAS;AAAA,IACT,SAAS;AAAA,IACT,gBAAgB;AAAA,EAClB;AACA,SAAO,WAAW,OAAO,KAAK;AAChC;AAOO,SAAS,cAA6B;AAE3C,QAAM,YACJ,OAAO,WAAW,WAAW,cACzB,WAAW,SACV,WAAmC;AAE1C,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,0BAA0B;AAAA,EAC5C;AAEA,aAAO,mBAAM,UAAU,gBAAgB,IAAI,WAAW,EAAE,CAAC,CAAC;AAC5D;;;AFvBO,IAAM,mBAAN,MAAsD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQ3D,YAA6B,QAAyB;AAAzB;AAP7B,SAAS,SAAS;AAAA,EAOqC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASvD,MAAM,qBACJ,aACA,qBAGA;AACA,UAAM,aAAa;AACnB,UAAM,QAAQ,YAAY;AAC1B,UAAM,MAAM,KAAK,MAAM,KAAK,IAAI,IAAI,GAAI;AAExC,UAAM,gBAAoD;AAAA,MACxD,MAAM,KAAK,OAAO;AAAA,MAClB,QAAI,yBAAW,WAAW,KAAK;AAAA,MAC/B,OAAO,WAAW;AAAA,MAClB,aAAa,MAAM,KAAK,SAAS;AAAA;AAAA,MACjC,cAAc,MAAM,WAAW,mBAAmB,SAAS;AAAA,MAC3D;AAAA,IACF;AAGA,UAAM,YAAY,MAAM,KAAK,kBAAkB,eAAe,UAAU;AAExE,UAAM,UAA6B;AAAA,MACjC;AAAA,MACA;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA,QAAQ,WAAW;AAAA,MACnB,SAAS,WAAW;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAc,kBACZ,eACA,cACwB;AACxB,UAAM,UAAU,cAAc,aAAa,OAAO;AAElD,QAAI,CAAC,aAAa,OAAO,QAAQ,CAAC,aAAa,OAAO,SAAS;AAC7D,YAAM,IAAI;AAAA,QACR,4FAA4F,aAAa,KAAK;AAAA,MAChH;AAAA,IACF;AAEA,UAAM,EAAE,MAAM,QAAQ,IAAI,aAAa;AAEvC,UAAM,SAAS;AAAA,MACb;AAAA,MACA;AAAA,MACA;AAAA,MACA,uBAAmB,yBAAW,aAAa,KAAK;AAAA,IAClD;AAEA,UAAM,UAAU;AAAA,MACd,UAAM,yBAAW,cAAc,IAAI;AAAA,MACnC,QAAI,yBAAW,cAAc,EAAE;AAAA,MAC/B,OAAO,OAAO,cAAc,KAAK;AAAA,MACjC,YAAY,OAAO,cAAc,UAAU;AAAA,MAC3C,aAAa,OAAO,cAAc,WAAW;AAAA,MAC7C,OAAO,cAAc;AAAA,IACvB;AAEA,WAAO,MAAM,KAAK,OAAO,cAAc;AAAA,MACrC;AAAA,MACA,OAAO;AAAA,MACP,aAAa;AAAA,MACb;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":["import_viem"]}

package/dist/cjs/exact/v1/facilitator/index.d.ts

@@ -0,0 +1,62 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from '@t402/core/types';
+import { F as FacilitatorEvmSigner } from '../../../signer-BkcAzwYi.js';
+
+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 };