@x402r/evm 0.0.2 → 0.0.3

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

@@ -0,0 +1,78 @@
+import { SchemeNetworkServer, MoneyParser, Price, Network, AssetAmount, PaymentRequirements } from '@x402/core/types';
+import { x402ResourceServer } from '@x402/core/server';
+
+/**
+ * Escrow Scheme - Server
+ * Handles price parsing and requirement enhancement for resource servers.
+ *
+ * Implements x402's SchemeNetworkServer interface so it can be registered
+ * on an x402ResourceServer via server.register('eip155:84532', new EscrowServerScheme()).
+ */
+
+/**
+ * Server scheme - handles price parsing and requirement enhancement.
+ * Implements x402's SchemeNetworkServer interface.
+ */
+declare class EscrowServerScheme implements SchemeNetworkServer {
+    readonly scheme = "escrow";
+    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 (USDC) is always the final fallback.
+     *
+     * @param parser - Custom function to convert amount to AssetAmount (or null to skip)
+     * @returns The server instance for chaining
+     */
+    registerMoneyParser(parser: MoneyParser): EscrowServerScheme;
+    /**
+     * Parse a price into an x402 AssetAmount.
+     *
+     * Accepts x402's Price type:
+     * - string: "$0.01", "0.01", "10000"
+     * - number: 0.01
+     * - AssetAmount: { asset: "0x...", amount: "10000" }
+     */
+    parsePrice(price: Price, network: Network): Promise<AssetAmount>;
+    /**
+     * Parse Money (string | number) to a decimal number.
+     */
+    private parseMoneyToDecimal;
+    /**
+     * Default money conversion — converts decimal amount to the default stablecoin on the network.
+     */
+    private defaultMoneyConversion;
+    /**
+     * Enhance payment requirements with facilitator's extra fields.
+     *
+     * Merges supportedKind.extra (from facilitator's /supported endpoint) into
+     * the requirements, so escrow addresses flow from facilitator → merchant
+     * requirements automatically.
+     */
+    enhancePaymentRequirements(requirements: PaymentRequirements, supportedKind: {
+        x402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, _facilitatorExtensions: string[]): Promise<PaymentRequirements>;
+}
+
+interface EvmResourceServerConfig {
+    networks?: Network | Network[];
+}
+/**
+ * Register escrow server scheme with x402ResourceServer
+ *
+ * @example
+ * ```typescript
+ * const server = new x402ResourceServer(facilitatorConfig);
+ * registerEscrowEvmScheme(server);
+ * // or with specific networks:
+ * registerEscrowEvmScheme(server, { networks: "eip155:84532" });
+ * ```
+ */
+declare function registerEscrowEvmScheme(server: x402ResourceServer, config?: EvmResourceServerConfig): x402ResourceServer;
+
+export { EscrowServerScheme, type EvmResourceServerConfig, registerEscrowEvmScheme };

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

@@ -0,0 +1,191 @@
+import {
+  __publicField
+} from "../../chunk-NSSMTXJJ.mjs";
+
+// src/escrow/server/scheme.ts
+var ASSET_INFO = {
+  // Base Sepolia
+  "eip155:84532": {
+    address: "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
+    name: "USDC",
+    version: "2",
+    decimals: 6
+  },
+  // Base mainnet
+  "eip155:8453": {
+    address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+    name: "USD Coin",
+    version: "2",
+    decimals: 6
+  },
+  // Ethereum Sepolia
+  "eip155:11155111": {
+    address: "0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238",
+    name: "USDC",
+    version: "2",
+    decimals: 6
+  },
+  // Ethereum mainnet
+  "eip155:1": {
+    address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+    name: "USD Coin",
+    version: "2",
+    decimals: 6
+  },
+  // Polygon
+  "eip155:137": {
+    address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+    name: "USD Coin",
+    version: "2",
+    decimals: 6
+  },
+  // Arbitrum
+  "eip155:42161": {
+    address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+    name: "USD Coin",
+    version: "2",
+    decimals: 6
+  },
+  // Celo
+  "eip155:42220": {
+    address: "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
+    name: "USD Coin",
+    version: "2",
+    decimals: 6
+  },
+  // Monad
+  "eip155:143": {
+    address: "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
+    name: "USDC",
+    version: "2",
+    decimals: 6
+  },
+  // Avalanche
+  "eip155:43114": {
+    address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+    name: "USD Coin",
+    version: "2",
+    decimals: 6
+  }
+};
+function 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;
+}
+var EscrowServerScheme = class {
+  constructor() {
+    __publicField(this, "scheme", "escrow");
+    __publicField(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 (USDC) is always the final fallback.
+   *
+   * @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;
+  }
+  /**
+   * Parse a price into an x402 AssetAmount.
+   *
+   * Accepts x402's Price type:
+   * - string: "$0.01", "0.01", "10000"
+   * - number: 0.01
+   * - AssetAmount: { asset: "0x...", amount: "10000" }
+   */
+  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 numericAmount = this.parseMoneyToDecimal(price);
+    for (const parser of this.moneyParsers) {
+      const result = await parser(numericAmount, network);
+      if (result !== null) {
+        return result;
+      }
+    }
+    return this.defaultMoneyConversion(numericAmount, network);
+  }
+  /**
+   * Parse Money (string | number) to a decimal number.
+   */
+  parseMoneyToDecimal(money) {
+    if (typeof money === "number") {
+      return money;
+    }
+    const cleaned = String(money).replace(/[$,]/g, "").trim();
+    const amount = parseFloat(cleaned);
+    if (isNaN(amount)) {
+      throw new Error(`Cannot parse price: ${money}`);
+    }
+    return amount;
+  }
+  /**
+   * Default money conversion — converts decimal amount to the default stablecoin on the network.
+   */
+  defaultMoneyConversion(amount, network) {
+    const assetInfo = ASSET_INFO[network];
+    if (!assetInfo) {
+      throw new Error(`No USDC address configured for network: ${network}`);
+    }
+    const tokenAmount = convertToTokenAmount(String(amount), assetInfo.decimals);
+    return {
+      asset: assetInfo.address,
+      amount: tokenAmount,
+      extra: {
+        name: assetInfo.name,
+        version: assetInfo.version
+      }
+    };
+  }
+  /**
+   * Enhance payment requirements with facilitator's extra fields.
+   *
+   * Merges supportedKind.extra (from facilitator's /supported endpoint) into
+   * the requirements, so escrow addresses flow from facilitator → merchant
+   * requirements automatically.
+   */
+  async enhancePaymentRequirements(requirements, supportedKind, _facilitatorExtensions) {
+    return {
+      ...requirements,
+      extra: {
+        ...supportedKind.extra,
+        ...requirements.extra
+      }
+    };
+  }
+};
+
+// src/escrow/server/register.ts
+function registerEscrowEvmScheme(server, config = {}) {
+  const scheme = new EscrowServerScheme();
+  const networks = config.networks ? Array.isArray(config.networks) ? config.networks : [config.networks] : ["eip155:*"];
+  for (const network of networks) {
+    server.register(network, scheme);
+  }
+  return server;
+}
+export {
+  EscrowServerScheme,
+  registerEscrowEvmScheme
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/escrow/server/scheme.ts","../../../../src/escrow/server/register.ts"],"sourcesContent":["/**\n * Escrow Scheme - Server\n * Handles price parsing and requirement enhancement for resource servers.\n *\n * Implements x402's SchemeNetworkServer interface so it can be registered\n * on an x402ResourceServer via server.register('eip155:84532', new EscrowServerScheme()).\n */\n\nimport type {\n  AssetAmount,\n  MoneyParser,\n  Network,\n  PaymentRequirements,\n  Price,\n  SchemeNetworkServer,\n} from '@x402/core/types'\n\n/**\n * Asset info including EIP-712 domain parameters per network\n */\nconst ASSET_INFO: Record<\n  string,\n  { address: string; name: string; version: string; decimals: number }\n> = {\n  // Base Sepolia\n  'eip155:84532': {\n    address: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',\n    name: 'USDC',\n    version: '2',\n    decimals: 6,\n  },\n  // Base mainnet\n  'eip155:8453': {\n    address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n    name: 'USD Coin',\n    version: '2',\n    decimals: 6,\n  },\n  // Ethereum Sepolia\n  'eip155:11155111': {\n    address: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',\n    name: 'USDC',\n    version: '2',\n    decimals: 6,\n  },\n  // Ethereum mainnet\n  'eip155:1': {\n    address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',\n    name: 'USD Coin',\n    version: '2',\n    decimals: 6,\n  },\n  // Polygon\n  'eip155:137': {\n    address: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',\n    name: 'USD Coin',\n    version: '2',\n    decimals: 6,\n  },\n  // Arbitrum\n  'eip155:42161': {\n    address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',\n    name: 'USD Coin',\n    version: '2',\n    decimals: 6,\n  },\n  // Celo\n  'eip155:42220': {\n    address: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',\n    name: 'USD Coin',\n    version: '2',\n    decimals: 6,\n  },\n  // Monad\n  'eip155:143': {\n    address: '0x754704Bc059F8C67012fEd69BC8A327a5aafb603',\n    name: 'USDC',\n    version: '2',\n    decimals: 6,\n  },\n  // Avalanche\n  'eip155:43114': {\n    address: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',\n    name: 'USD Coin',\n    version: '2',\n    decimals: 6,\n  },\n}\n\n/**\n * Convert decimal amount to token units using string-based conversion\n * (e.g., 0.10 -> 100000 for 6-decimal tokens)\n * Avoids floating-point precision issues from BigInt(Math.round(...))\n */\nfunction 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/**\n * Server scheme - handles price parsing and requirement enhancement.\n * Implements x402's SchemeNetworkServer interface.\n */\nexport class EscrowServerScheme implements SchemeNetworkServer {\n  readonly scheme = 'escrow'\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 (USDC) 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  registerMoneyParser(parser: MoneyParser): EscrowServerScheme {\n    this.moneyParsers.push(parser)\n    return this\n  }\n\n  /**\n   * Parse a price into an x402 AssetAmount.\n   *\n   * Accepts x402's Price type:\n   * - string: \"$0.01\", \"0.01\", \"10000\"\n   * - number: 0.01\n   * - AssetAmount: { asset: \"0x...\", amount: \"10000\" }\n   */\n  async parsePrice(price: Price, network: Network): Promise<AssetAmount> {\n    // If already an AssetAmount, pass through with validation\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 numericAmount = this.parseMoneyToDecimal(price)\n\n    // Try each custom money parser in order\n    for (const parser of this.moneyParsers) {\n      const result = await parser(numericAmount, network)\n      if (result !== null) {\n        return result\n      }\n    }\n\n    // All custom parsers returned null (or none registered), use default conversion\n    return this.defaultMoneyConversion(numericAmount, network)\n  }\n\n  /**\n   * Parse Money (string | number) to a decimal number.\n   */\n  private parseMoneyToDecimal(money: string | number): number {\n    if (typeof money === 'number') {\n      return money\n    }\n    const cleaned = String(money).replace(/[$,]/g, '').trim()\n    const amount = parseFloat(cleaned)\n    if (isNaN(amount)) {\n      throw new Error(`Cannot parse price: ${money}`)\n    }\n    return amount\n  }\n\n  /**\n   * Default money conversion — converts decimal amount to the default stablecoin on the network.\n   */\n  private defaultMoneyConversion(amount: number, network: Network): AssetAmount {\n    const assetInfo = ASSET_INFO[network]\n    if (!assetInfo) {\n      throw new Error(`No USDC address configured for network: ${network}`)\n    }\n\n    const tokenAmount = convertToTokenAmount(String(amount), assetInfo.decimals)\n\n    return {\n      asset: assetInfo.address,\n      amount: tokenAmount,\n      extra: {\n        name: assetInfo.name,\n        version: assetInfo.version,\n      },\n    }\n  }\n\n  /**\n   * Enhance payment requirements with facilitator's extra fields.\n   *\n   * Merges supportedKind.extra (from facilitator's /supported endpoint) into\n   * the requirements, so escrow addresses flow from facilitator → merchant\n   * requirements automatically.\n   */\n  async enhancePaymentRequirements(\n    requirements: PaymentRequirements,\n    supportedKind: {\n      x402Version: number\n      scheme: string\n      network: Network\n      extra?: Record<string, unknown>\n    },\n    _facilitatorExtensions: string[],\n  ): Promise<PaymentRequirements> {\n    return {\n      ...requirements,\n      extra: {\n        ...supportedKind.extra,\n        ...requirements.extra,\n      },\n    }\n  }\n}\n","import type { Network } from '@x402/core/types'\nimport { x402ResourceServer } from '@x402/core/server'\nimport { EscrowServerScheme } from './scheme'\n\nexport interface EvmResourceServerConfig {\n  networks?: Network | Network[]\n}\n\n/**\n * Register escrow server scheme with x402ResourceServer\n *\n * @example\n * ```typescript\n * const server = new x402ResourceServer(facilitatorConfig);\n * registerEscrowEvmScheme(server);\n * // or with specific networks:\n * registerEscrowEvmScheme(server, { networks: \"eip155:84532\" });\n * ```\n */\nexport function registerEscrowEvmScheme(\n  server: x402ResourceServer,\n  config: EvmResourceServerConfig = {},\n): x402ResourceServer {\n  const scheme = new EscrowServerScheme()\n  const networks = config.networks\n    ? Array.isArray(config.networks)\n      ? config.networks\n      : [config.networks]\n    : ['eip155:*' as Network]\n  for (const network of networks) {\n    server.register(network, scheme)\n  }\n  return server\n}\n"],"mappings":"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","names":[]}

package/dist/esm/index.d.mts

@@ -0,0 +1,54 @@
+export { E as EscrowEvmScheme } from './scheme-CNrmuyp3.mjs';
+import '@x402/core/types';
+import '@x402/evm';
+
+/**
+ * Type guard for EscrowPayload
+ */
+declare function isEscrowPayload(value: unknown): value is EscrowPayload;
+/**
+ * Type guard for EscrowExtra
+ */
+declare function isEscrowExtra(value: unknown): value is EscrowExtra;
+interface EscrowExtra {
+    escrowAddress: `0x${string}`;
+    operatorAddress: `0x${string}`;
+    tokenCollector: `0x${string}`;
+    authorizeAddress?: `0x${string}`;
+    minDeposit?: string;
+    maxDeposit?: string;
+    preApprovalExpirySeconds?: number;
+    authorizationExpirySeconds?: number;
+    refundExpirySeconds?: number;
+    minFeeBps?: number;
+    maxFeeBps?: number;
+    feeReceiver?: `0x${string}`;
+    name: string;
+    version: string;
+}
+interface EscrowPayload {
+    authorization: {
+        from: `0x${string}`;
+        to: `0x${string}`;
+        value: string;
+        validAfter: string;
+        validBefore: string;
+        nonce: `0x${string}`;
+    };
+    signature: `0x${string}`;
+    paymentInfo: {
+        operator: `0x${string}`;
+        receiver: `0x${string}`;
+        token: `0x${string}`;
+        maxAmount: string;
+        preApprovalExpiry: number;
+        authorizationExpiry: number;
+        refundExpiry: number;
+        minFeeBps: number;
+        maxFeeBps: number;
+        feeReceiver: `0x${string}`;
+        salt: `0x${string}`;
+    };
+}
+
+export { type EscrowExtra, type EscrowPayload, isEscrowExtra, isEscrowPayload };

package/dist/esm/index.mjs

@@ -0,0 +1,15 @@
+import {
+  EscrowEvmScheme
+} from "./chunk-DLIBGHEY.mjs";
+import {
+  isEscrowExtra,
+  isEscrowPayload
+} from "./chunk-JBHVAJN3.mjs";
+import "./chunk-IYUU7AJZ.mjs";
+import "./chunk-NSSMTXJJ.mjs";
+export {
+  EscrowEvmScheme,
+  isEscrowExtra,
+  isEscrowPayload
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

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

package/dist/esm/scheme-CNrmuyp3.d.mts

@@ -0,0 +1,22 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayloadContext, PaymentPayloadResult } from '@x402/core/types';
+import { ClientEvmSigner } from '@x402/evm';
+
+/**
+ * Escrow Scheme - Client
+ * Creates payment payloads for escrow payments.
+ *
+ * Implements x402's SchemeNetworkClient interface so it can be registered
+ * on an x402Client via client.register('eip155:84532', new EscrowEvmScheme(signer)).
+ */
+
+/**
+ * Escrow Client Scheme - implements x402's SchemeNetworkClient
+ */
+declare class EscrowEvmScheme implements SchemeNetworkClient {
+    private readonly signer;
+    readonly scheme = "escrow";
+    constructor(signer: ClientEvmSigner);
+    createPaymentPayload(x402Version: number, requirements: PaymentRequirements, _context?: PaymentPayloadContext): Promise<PaymentPayloadResult>;
+}
+
+export { EscrowEvmScheme as E };

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "@x402r/evm",
-  "version": "0.0.2",
-  "type": "module",
+  "version": "0.0.3",
   "description": "Escrow payment scheme for x402 using Base Commerce Payments",
   "license": "MIT",
   "author": "x402r",
@@ -11,21 +10,45 @@
     "directory": "packages/evm"
   },
   "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.mts",
+        "default": "./dist/esm/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
     "./escrow/client": {
-      "types": "./dist/escrow/client/index.d.ts",
-      "import": "./dist/escrow/client/index.js"
+      "import": {
+        "types": "./dist/esm/escrow/client/index.d.mts",
+        "default": "./dist/esm/escrow/client/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/escrow/client/index.d.ts",
+        "default": "./dist/cjs/escrow/client/index.js"
+      }
     },
     "./escrow/server": {
-      "types": "./dist/escrow/server/index.d.ts",
-      "import": "./dist/escrow/server/index.js"
+      "import": {
+        "types": "./dist/esm/escrow/server/index.d.mts",
+        "default": "./dist/esm/escrow/server/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/escrow/server/index.d.ts",
+        "default": "./dist/cjs/escrow/server/index.js"
+      }
     },
     "./escrow/facilitator": {
-      "types": "./dist/escrow/facilitator/index.d.ts",
-      "import": "./dist/escrow/facilitator/index.js"
-    },
-    "./escrow/types": {
-      "types": "./dist/shared/types.d.ts",
-      "import": "./dist/shared/types.js"
+      "import": {
+        "types": "./dist/esm/escrow/facilitator/index.d.mts",
+        "default": "./dist/esm/escrow/facilitator/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/escrow/facilitator/index.d.ts",
+        "default": "./dist/cjs/escrow/facilitator/index.js"
+      }
     }
   },
   "publishConfig": {
@@ -37,21 +60,24 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsup",
     "clean": "rm -rf dist",
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "lint": "eslint src --ext .ts",
-    "format": "prettier --write \"src/**/*.ts\""
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
+    "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\""
   },
   "peerDependencies": {
-    "@x402/core": "^2.0.0",
+    "@x402/core": "^2.4.0",
     "@x402/evm": "^2.0.0",
     "viem": "^2.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "tsup": "^8.4.0",
     "typescript": "^5.7.0",
     "vitest": "^4.0.18"
   }

package/src/escrow/client/index.ts

@@ -1,161 +1,3 @@
-/**
- * Escrow Scheme - Client
- * Creates payment payloads for escrow payments.
- *
- * Implements x402's SchemeNetworkClient interface so it can be registered
- * on an x402Client via client.register('eip155:84532', new EscrowEvmScheme(signer)).
- */
-
-import type {
-  Network,
-  PaymentPayload,
-  PaymentRequirements,
-  SchemeNetworkClient,
-} from "@x402/core/types";
-import type { ClientEvmSigner } from "@x402/evm";
-import { x402Client } from "@x402/core/client";
-import {
-  computeEscrowNonce,
-  signERC3009,
-  generateSalt,
-} from "../../shared/nonce.js";
-import { MAX_UINT48 } from "../../shared/constants.js";
-import type { EscrowExtra } from "../../shared/types.js";
-
-/**
- * Parse chainId from CAIP-2 network identifier
- */
-function parseChainId(network: string): number {
-  const parts = network.split(":");
-  if (parts.length !== 2 || parts[0] !== "eip155") {
-    throw new Error(
-      `Invalid network format: ${network}. Expected 'eip155:<chainId>'`,
-    );
-  }
-  const chainId = parseInt(parts[1], 10);
-  if (isNaN(chainId)) {
-    throw new Error(`Invalid chainId in network: ${network}`);
-  }
-  return chainId;
-}
-
-/**
- * Escrow Client Scheme - implements x402's SchemeNetworkClient
- */
-export class EscrowEvmScheme implements SchemeNetworkClient {
-  readonly scheme = "escrow";
-
-  constructor(private readonly signer: ClientEvmSigner) {}
-
-  async createPaymentPayload(
-    x402Version: number,
-    requirements: PaymentRequirements,
-  ): Promise<Pick<PaymentPayload, "x402Version" | "payload">> {
-    if (x402Version !== 2) {
-      throw new Error(
-        `Unsupported x402Version: ${x402Version}. Only version 2 is supported.`,
-      );
-    }
-
-    const extra = requirements.extra as unknown as EscrowExtra;
-
-    // Validate required EIP-712 domain parameters (M3, M10)
-    if (!extra.name) {
-      throw new Error(
-        `EIP-712 domain parameter 'name' is required in payment requirements for asset ${requirements.asset}`,
-      );
-    }
-    if (!extra.version) {
-      throw new Error(
-        `EIP-712 domain parameter 'version' is required in payment requirements for asset ${requirements.asset}`,
-      );
-    }
-
-    const {
-      escrowAddress,
-      operatorAddress,
-      tokenCollector,
-      minFeeBps = 0,
-      maxFeeBps = 0,
-      feeReceiver,
-      preApprovalExpirySeconds,
-      refundExpirySeconds,
-      authorizationExpirySeconds,
-    } = extra;
-
-    const chainId = parseChainId(requirements.network);
-    const maxAmount = requirements.amount;
-
-    const paymentInfo = {
-      operator: operatorAddress,
-      receiver: requirements.payTo as `0x${string}`,
-      token: requirements.asset as `0x${string}`,
-      maxAmount,
-      preApprovalExpiry: preApprovalExpirySeconds ?? MAX_UINT48,
-      authorizationExpiry: authorizationExpirySeconds ?? MAX_UINT48,
-      refundExpiry: refundExpirySeconds ?? MAX_UINT48,
-      minFeeBps,
-      maxFeeBps,
-      feeReceiver: feeReceiver ?? operatorAddress,
-      salt: generateSalt(),
-    };
-
-    const nonce = computeEscrowNonce(chainId, escrowAddress, paymentInfo);
-
-    // ERC-3009 authorization - validBefore MUST match what contract passes to receiveWithAuthorization
-    // The contract uses paymentInfo.preApprovalExpiry as validBefore
-    const authorization = {
-      from: this.signer.address,
-      to: tokenCollector,
-      value: maxAmount,
-      validAfter: "0",
-      validBefore: String(paymentInfo.preApprovalExpiry),
-      nonce,
-    };
-
-    const signature = await signERC3009(
-      this.signer,
-      authorization,
-      extra,
-      requirements.asset as `0x${string}`,
-      chainId,
-    );
-
-    return {
-      x402Version,
-      payload: { authorization, signature, paymentInfo },
-    };
-  }
-}
-
-/**
- * Register escrow client scheme with x402Client
- *
- * @example
- * ```typescript
- * const client = new x402Client();
- * registerEscrowScheme(client, { signer, networks: "eip155:84532" });
- * ```
- */
-export function registerEscrowScheme(
-  client: x402Client,
-  config: { signer: ClientEvmSigner; networks: Network | Network[] },
-): x402Client {
-  const scheme = new EscrowEvmScheme(config.signer);
-  const networks = Array.isArray(config.networks)
-    ? config.networks
-    : [config.networks];
-  for (const network of networks) {
-    client.register(network, scheme);
-  }
-  return client;
-}
-
-/**
- * @deprecated Use `new EscrowEvmScheme(signer)` directly
- */
-export const EscrowScheme = {
-  scheme: "escrow" as const,
-};
-
-export type { EscrowExtra, EscrowPayload } from "../../shared/types.js";
+export { EscrowEvmScheme } from './scheme'
+export { registerEscrowEvmScheme } from './register'
+export type { EvmClientConfig } from './register'

package/src/escrow/client/register.ts

@@ -0,0 +1,33 @@
+import type { Network } from '@x402/core/types'
+import type { ClientEvmSigner } from '@x402/evm'
+import { x402Client } from '@x402/core/client'
+import { EscrowEvmScheme } from './scheme'
+
+export interface EvmClientConfig {
+  signer: ClientEvmSigner
+  networks?: Network | Network[]
+}
+
+/**
+ * Register escrow client scheme with x402Client
+ *
+ * @example
+ * ```typescript
+ * const client = new x402Client();
+ * registerEscrowEvmScheme(client, { signer });
+ * // or with specific networks:
+ * registerEscrowEvmScheme(client, { signer, networks: "eip155:84532" });
+ * ```
+ */
+export function registerEscrowEvmScheme(client: x402Client, config: EvmClientConfig): x402Client {
+  const scheme = new EscrowEvmScheme(config.signer)
+  const networks = config.networks
+    ? Array.isArray(config.networks)
+      ? config.networks
+      : [config.networks]
+    : ['eip155:*' as Network]
+  for (const network of networks) {
+    client.register(network, scheme)
+  }
+  return client
+}