@x402r/evm 0.0.2 → 0.0.3

package/dist/cjs/escrow/server/index.d.cts

@@ -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/{escrow → cjs/escrow}/server/index.d.ts

@@ -1,3 +1,6 @@
+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.
@@ -5,13 +8,12 @@
  * Implements x402's SchemeNetworkServer interface so it can be registered
  * on an x402ResourceServer via server.register('eip155:84532', new EscrowServerScheme()).
  */
-import type { AssetAmount, MoneyParser, Network, PaymentRequirements, Price, SchemeNetworkServer } from "@x402/core/types";
-import { x402ResourceServer } from "@x402/core/server";
+
 /**
  * Server scheme - handles price parsing and requirement enhancement.
  * Implements x402's SchemeNetworkServer interface.
  */
-export declare class EscrowServerScheme implements SchemeNetworkServer {
+declare class EscrowServerScheme implements SchemeNetworkServer {
     readonly scheme = "escrow";
     private moneyParsers;
     /**
@@ -56,17 +58,21 @@ export declare class EscrowServerScheme implements SchemeNetworkServer {
         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);
- * registerEscrowServerScheme(server, { networks: "eip155:84532" });
+ * registerEscrowEvmScheme(server);
+ * // or with specific networks:
+ * registerEscrowEvmScheme(server, { networks: "eip155:84532" });
  * ```
  */
-export declare function registerEscrowServerScheme(server: x402ResourceServer, config: {
-    networks: Network | Network[];
-}): x402ResourceServer;
-export type { EscrowExtra, EscrowPayload } from "../../shared/types.js";
-//# sourceMappingURL=index.d.ts.map
+declare function registerEscrowEvmScheme(server: x402ResourceServer, config?: EvmResourceServerConfig): x402ResourceServer;
+
+export { EscrowServerScheme, type EvmResourceServerConfig, registerEscrowEvmScheme };

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

@@ -0,0 +1,217 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+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);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/escrow/server/index.ts
+var server_exports = {};
+__export(server_exports, {
+  EscrowServerScheme: () => EscrowServerScheme,
+  registerEscrowEvmScheme: () => registerEscrowEvmScheme
+});
+module.exports = __toCommonJS(server_exports);
+
+// 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;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EscrowServerScheme,
+  registerEscrowEvmScheme
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/escrow/server/index.ts","../../../../src/escrow/server/scheme.ts","../../../../src/escrow/server/register.ts"],"sourcesContent":["export { EscrowServerScheme } from './scheme'\nexport { registerEscrowEvmScheme } from './register'\nexport type { EvmResourceServerConfig } from './register'\n","/**\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/{shared/types.d.ts → cjs/escrow/types/index.d.ts}

@@ -1,12 +1,12 @@
 /**
  * Type guard for EscrowPayload
  */
-export declare function isEscrowPayload(value: unknown): value is EscrowPayload;
+declare function isEscrowPayload(value: unknown): value is EscrowPayload;
 /**
  * Type guard for EscrowExtra
  */
-export declare function isEscrowExtra(value: unknown): value is EscrowExtra;
-export interface EscrowExtra {
+declare function isEscrowExtra(value: unknown): value is EscrowExtra;
+interface EscrowExtra {
     escrowAddress: `0x${string}`;
     operatorAddress: `0x${string}`;
     tokenCollector: `0x${string}`;
@@ -20,9 +20,9 @@ export interface EscrowExtra {
     maxFeeBps?: number;
     feeReceiver?: `0x${string}`;
     name: string;
-    version?: string;
+    version: string;
 }
-export interface EscrowPayload {
+interface EscrowPayload {
     authorization: {
         from: `0x${string}`;
         to: `0x${string}`;
@@ -46,4 +46,5 @@ export interface EscrowPayload {
         salt: `0x${string}`;
     };
 }
-//# sourceMappingURL=types.d.ts.map
+
+export { type EscrowExtra, type EscrowPayload, isEscrowExtra, isEscrowPayload };

package/dist/cjs/escrow/types/index.js

@@ -0,0 +1,40 @@
+"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/escrow/types/index.ts
+var types_exports = {};
+__export(types_exports, {
+  isEscrowExtra: () => isEscrowExtra,
+  isEscrowPayload: () => isEscrowPayload
+});
+module.exports = __toCommonJS(types_exports);
+
+// src/escrow/shared/types.ts
+function isEscrowPayload(value) {
+  return typeof value === "object" && value !== null && "authorization" in value && "signature" in value && "paymentInfo" in value;
+}
+function isEscrowExtra(value) {
+  return typeof value === "object" && value !== null && "escrowAddress" in value && "operatorAddress" in value && "tokenCollector" in value;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isEscrowExtra,
+  isEscrowPayload
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/escrow/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/escrow/types/index.ts","../../../../src/escrow/shared/types.ts"],"sourcesContent":["export type { EscrowPayload, EscrowExtra } from '../shared/types.js'\nexport { isEscrowPayload, isEscrowExtra } from '../shared/types.js'\n","/**\n * Type guard for EscrowPayload\n */\nexport function isEscrowPayload(value: unknown): value is EscrowPayload {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'authorization' in value &&\n    'signature' in value &&\n    'paymentInfo' in value\n  )\n}\n\n/**\n * Type guard for EscrowExtra\n */\nexport function isEscrowExtra(value: unknown): value is EscrowExtra {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'escrowAddress' in value &&\n    'operatorAddress' in value &&\n    'tokenCollector' in value\n  )\n}\n\n// EscrowExtra - fields in PaymentRequirements.extra\nexport interface EscrowExtra {\n  escrowAddress: `0x${string}`\n  operatorAddress: `0x${string}`\n  tokenCollector: `0x${string}`\n  authorizeAddress?: `0x${string}`\n  minDeposit?: string\n  maxDeposit?: string\n  preApprovalExpirySeconds?: number\n  authorizationExpirySeconds?: number\n  refundExpirySeconds?: number\n  minFeeBps?: number\n  maxFeeBps?: number\n  feeReceiver?: `0x${string}`\n  name: string // EIP-712 domain name (e.g., \"USDC\" for Base USDC)\n  version: string // EIP-712 domain version (e.g., \"2\" for USDC)\n}\n\n// EscrowPayload - the payload field in PaymentPayload\nexport interface EscrowPayload {\n  authorization: {\n    from: `0x${string}`\n    to: `0x${string}`\n    value: string\n    validAfter: string\n    validBefore: string\n    nonce: `0x${string}`\n  }\n  signature: `0x${string}`\n  paymentInfo: {\n    operator: `0x${string}`\n    receiver: `0x${string}`\n    token: `0x${string}`\n    maxAmount: string\n    preApprovalExpiry: number\n    authorizationExpiry: number\n    refundExpiry: number\n    minFeeBps: number\n    maxFeeBps: number\n    feeReceiver: `0x${string}`\n    salt: `0x${string}`\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,SAAS,gBAAgB,OAAwC;AACtE,SACE,OAAO,UAAU,YACjB,UAAU,QACV,mBAAmB,SACnB,eAAe,SACf,iBAAiB;AAErB;AAKO,SAAS,cAAc,OAAsC;AAClE,SACE,OAAO,UAAU,YACjB,UAAU,QACV,mBAAmB,SACnB,qBAAqB,SACrB,oBAAoB;AAExB;","names":[]}

package/dist/cjs/index.cjs

@@ -0,0 +1,215 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+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);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/escrow/index.ts
+var escrow_exports = {};
+__export(escrow_exports, {
+  EscrowEvmScheme: () => EscrowEvmScheme
+});
+module.exports = __toCommonJS(escrow_exports);
+
+// src/escrow/shared/nonce.ts
+var import_viem = require("viem");
+
+// src/escrow/shared/constants.ts
+var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+var MAX_UINT48 = 281474976710655;
+var RECEIVE_AUTHORIZATION_TYPES = {
+  ReceiveWithAuthorization: [
+    { 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/escrow/shared/nonce.ts
+var PAYMENT_INFO_TYPEHASH = (0, import_viem.keccak256)(
+  new TextEncoder().encode(
+    "PaymentInfo(address operator,address payer,address receiver,address token,uint120 maxAmount,uint48 preApprovalExpiry,uint48 authorizationExpiry,uint48 refundExpiry,uint16 minFeeBps,uint16 maxFeeBps,address feeReceiver,uint256 salt)"
+  )
+);
+function computeEscrowNonce(chainId, escrowAddress, paymentInfo) {
+  const paymentInfoEncoded = (0, import_viem.encodeAbiParameters)(
+    [
+      { name: "typehash", type: "bytes32" },
+      { name: "operator", type: "address" },
+      { name: "payer", type: "address" },
+      { name: "receiver", type: "address" },
+      { name: "token", type: "address" },
+      { name: "maxAmount", type: "uint120" },
+      { name: "preApprovalExpiry", type: "uint48" },
+      { name: "authorizationExpiry", type: "uint48" },
+      { name: "refundExpiry", type: "uint48" },
+      { name: "minFeeBps", type: "uint16" },
+      { name: "maxFeeBps", type: "uint16" },
+      { name: "feeReceiver", type: "address" },
+      { name: "salt", type: "uint256" }
+    ],
+    [
+      PAYMENT_INFO_TYPEHASH,
+      paymentInfo.operator,
+      ZERO_ADDRESS,
+      // payer-agnostic
+      paymentInfo.receiver,
+      paymentInfo.token,
+      BigInt(paymentInfo.maxAmount),
+      paymentInfo.preApprovalExpiry,
+      paymentInfo.authorizationExpiry,
+      paymentInfo.refundExpiry,
+      paymentInfo.minFeeBps,
+      paymentInfo.maxFeeBps,
+      paymentInfo.feeReceiver,
+      BigInt(paymentInfo.salt)
+    ]
+  );
+  const paymentInfoHash = (0, import_viem.keccak256)(paymentInfoEncoded);
+  const outerEncoded = (0, import_viem.encodeAbiParameters)(
+    [
+      { name: "chainId", type: "uint256" },
+      { name: "escrow", type: "address" },
+      { name: "paymentInfoHash", type: "bytes32" }
+    ],
+    [BigInt(chainId), escrowAddress, paymentInfoHash]
+  );
+  return (0, import_viem.keccak256)(outerEncoded);
+}
+async function signERC3009(signer, authorization, extra, tokenAddress, chainId) {
+  const domain = {
+    name: extra.name,
+    version: extra.version,
+    chainId,
+    verifyingContract: (0, import_viem.getAddress)(tokenAddress)
+  };
+  const message = {
+    from: (0, import_viem.getAddress)(authorization.from),
+    to: (0, import_viem.getAddress)(authorization.to),
+    value: BigInt(authorization.value),
+    validAfter: BigInt(authorization.validAfter),
+    validBefore: BigInt(authorization.validBefore),
+    nonce: authorization.nonce
+  };
+  return signer.signTypedData({
+    domain,
+    types: RECEIVE_AUTHORIZATION_TYPES,
+    primaryType: "ReceiveWithAuthorization",
+    message
+  });
+}
+function generateSalt() {
+  const bytes = new Uint8Array(32);
+  crypto.getRandomValues(bytes);
+  return (0, import_viem.toHex)(bytes);
+}
+
+// src/escrow/shared/utils.ts
+function parseChainId(network) {
+  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;
+}
+
+// src/escrow/client/scheme.ts
+var EscrowEvmScheme = class {
+  constructor(signer) {
+    this.signer = signer;
+    __publicField(this, "scheme", "escrow");
+  }
+  async createPaymentPayload(x402Version, requirements, _context) {
+    if (x402Version !== 2) {
+      throw new Error(
+        `Unsupported x402Version: ${x402Version}. Only version 2 is supported.`
+      );
+    }
+    const extra = requirements.extra;
+    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,
+      token: requirements.asset,
+      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);
+    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,
+      chainId
+    );
+    return {
+      x402Version,
+      payload: { authorization, signature, paymentInfo }
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EscrowEvmScheme
+});
+//# sourceMappingURL=index.cjs.map