@x402r/evm 0.0.2 → 0.0.3

package/dist/cjs/escrow/facilitator/index.cjs

@@ -0,0 +1,359 @@
+"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/facilitator/index.ts
+var facilitator_exports = {};
+__export(facilitator_exports, {
+  EscrowFacilitatorScheme: () => EscrowFacilitatorScheme,
+  registerEscrowEvmScheme: () => registerEscrowEvmScheme
+});
+module.exports = __toCommonJS(facilitator_exports);
+
+// src/escrow/facilitator/scheme.ts
+var import_viem2 = require("viem");
+
+// src/escrow/shared/constants.ts
+var PAYMENT_INFO_COMPONENTS = [
+  { 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" }
+];
+var OPERATOR_ABI = [
+  {
+    name: "authorize",
+    type: "function",
+    stateMutability: "nonpayable",
+    inputs: [
+      {
+        name: "paymentInfo",
+        type: "tuple",
+        components: PAYMENT_INFO_COMPONENTS
+      },
+      { name: "amount", type: "uint256" },
+      { name: "tokenCollector", type: "address" },
+      { name: "collectorData", type: "bytes" }
+    ],
+    outputs: []
+  }
+];
+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" }
+  ]
+};
+var ERC20_BALANCE_OF_ABI = [
+  {
+    name: "balanceOf",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "account", type: "address" }],
+    outputs: [{ name: "balance", type: "uint256" }]
+  }
+];
+
+// src/escrow/shared/nonce.ts
+var import_viem = require("viem");
+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)"
+  )
+);
+async function verifyERC3009Signature(signer, authorization, signature, extra, tokenAddress) {
+  const domain = {
+    name: extra.name,
+    version: extra.version,
+    chainId: extra.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
+  };
+  try {
+    return await signer.verifyTypedData({
+      address: (0, import_viem.getAddress)(authorization.from),
+      domain,
+      types: RECEIVE_AUTHORIZATION_TYPES,
+      primaryType: "ReceiveWithAuthorization",
+      message,
+      signature
+    });
+  } catch {
+    return false;
+  }
+}
+
+// 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;
+}
+
+// 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/facilitator/scheme.ts
+var EscrowFacilitatorScheme = class {
+  constructor(signer) {
+    this.signer = signer;
+    __publicField(this, "scheme", "escrow");
+    __publicField(this, "caipFamily", "eip155:*");
+  }
+  getSigners(_network) {
+    return [...this.signer.getAddresses()];
+  }
+  // C4: name/version now come from server's parsePrice() via AssetAmount.extra.
+  // The facilitator should not hardcode token-specific metadata.
+  getExtra(_network) {
+    return void 0;
+  }
+  async verify(payload, requirements, _context) {
+    if (!isEscrowPayload(payload.payload)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_payload_format"
+      };
+    }
+    const escrowPayload = payload.payload;
+    const payer = escrowPayload.authorization.from;
+    if (requirements.scheme !== "escrow") {
+      return {
+        isValid: false,
+        invalidReason: "unsupported_scheme",
+        payer
+      };
+    }
+    const networkParts = requirements.network.split(":");
+    if (networkParts.length !== 2 || networkParts[0] !== "eip155") {
+      return {
+        isValid: false,
+        invalidReason: "invalid_network",
+        payer
+      };
+    }
+    if (!isEscrowExtra(requirements.extra)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_escrow_extra",
+        payer
+      };
+    }
+    const extra = requirements.extra;
+    const chainId = parseChainId(requirements.network);
+    const now = Math.floor(Date.now() / 1e3);
+    const validBefore = Number(escrowPayload.authorization.validBefore);
+    const validAfter = Number(escrowPayload.authorization.validAfter);
+    if (validBefore <= now + 6) {
+      return {
+        isValid: false,
+        invalidReason: "authorization_expired",
+        payer
+      };
+    }
+    if (validAfter > now) {
+      return {
+        isValid: false,
+        invalidReason: "authorization_not_yet_valid",
+        payer
+      };
+    }
+    const { signature: signatureForVerify } = (0, import_viem2.parseErc6492Signature)(escrowPayload.signature);
+    const isValidSignature = await verifyERC3009Signature(
+      this.signer,
+      escrowPayload.authorization,
+      signatureForVerify,
+      { ...extra, chainId },
+      requirements.asset
+    );
+    if (!isValidSignature) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_escrow_signature",
+        payer
+      };
+    }
+    if (BigInt(escrowPayload.authorization.value) < BigInt(requirements.amount)) {
+      return {
+        isValid: false,
+        invalidReason: "insufficient_amount",
+        payer
+      };
+    }
+    if (escrowPayload.paymentInfo.token.toLowerCase() !== requirements.asset.toLowerCase()) {
+      return {
+        isValid: false,
+        invalidReason: "token_mismatch",
+        payer
+      };
+    }
+    if (escrowPayload.paymentInfo.receiver.toLowerCase() !== requirements.payTo.toLowerCase()) {
+      return {
+        isValid: false,
+        invalidReason: "receiver_mismatch",
+        payer
+      };
+    }
+    try {
+      const balance = await this.signer.readContract({
+        address: requirements.asset,
+        abi: ERC20_BALANCE_OF_ABI,
+        functionName: "balanceOf",
+        args: [payer]
+      });
+      if (BigInt(balance) < BigInt(requirements.amount)) {
+        return {
+          isValid: false,
+          invalidReason: "insufficient_balance",
+          payer
+        };
+      }
+    } catch {
+    }
+    return {
+      isValid: true,
+      payer
+    };
+  }
+  async settle(payload, requirements, _context) {
+    const verification = await this.verify(payload, requirements);
+    if (!verification.isValid) {
+      return {
+        success: false,
+        errorReason: verification.invalidReason ?? "verification_failed",
+        transaction: "",
+        network: requirements.network,
+        payer: verification.payer
+      };
+    }
+    const escrowPayload = payload.payload;
+    const extra = requirements.extra;
+    const { authorizeAddress, operatorAddress, tokenCollector } = extra;
+    const paymentInfo = {
+      operator: escrowPayload.paymentInfo.operator,
+      payer: escrowPayload.authorization.from,
+      receiver: escrowPayload.paymentInfo.receiver,
+      token: escrowPayload.paymentInfo.token,
+      maxAmount: BigInt(escrowPayload.paymentInfo.maxAmount),
+      preApprovalExpiry: escrowPayload.paymentInfo.preApprovalExpiry,
+      authorizationExpiry: escrowPayload.paymentInfo.authorizationExpiry,
+      refundExpiry: escrowPayload.paymentInfo.refundExpiry,
+      minFeeBps: escrowPayload.paymentInfo.minFeeBps,
+      maxFeeBps: escrowPayload.paymentInfo.maxFeeBps,
+      feeReceiver: escrowPayload.paymentInfo.feeReceiver,
+      salt: BigInt(escrowPayload.paymentInfo.salt)
+    };
+    const collectorData = escrowPayload.signature;
+    const target = authorizeAddress ?? operatorAddress;
+    try {
+      const txHash = await this.signer.writeContract({
+        address: target,
+        abi: OPERATOR_ABI,
+        functionName: "authorize",
+        args: [
+          paymentInfo,
+          BigInt(escrowPayload.authorization.value),
+          tokenCollector,
+          collectorData
+        ]
+      });
+      const receiptPromise = this.signer.waitForTransactionReceipt({
+        hash: txHash
+      });
+      const timeoutPromise = new Promise(
+        (_, reject) => setTimeout(
+          () => reject(new Error("Transaction receipt timeout after 60s")),
+          6e4
+        )
+      );
+      const receipt = await Promise.race([receiptPromise, timeoutPromise]);
+      if (receipt.status !== "success") {
+        return {
+          success: false,
+          errorReason: "transaction_reverted",
+          transaction: txHash,
+          network: requirements.network,
+          payer: escrowPayload.authorization.from
+        };
+      }
+      return {
+        success: true,
+        transaction: txHash,
+        network: requirements.network,
+        payer: escrowPayload.authorization.from
+      };
+    } catch (error) {
+      return {
+        success: false,
+        errorReason: error instanceof Error ? error.message : "Settlement failed",
+        transaction: "",
+        network: requirements.network,
+        payer: escrowPayload.authorization.from
+      };
+    }
+  }
+};
+
+// src/escrow/facilitator/register.ts
+function registerEscrowEvmScheme(facilitator, config) {
+  facilitator.register(
+    config.networks,
+    new EscrowFacilitatorScheme(config.signer)
+  );
+  return facilitator;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EscrowFacilitatorScheme,
+  registerEscrowEvmScheme
+});
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/escrow/facilitator/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/escrow/facilitator/index.ts","../../../../src/escrow/facilitator/scheme.ts","../../../../src/escrow/shared/constants.ts","../../../../src/escrow/shared/nonce.ts","../../../../src/escrow/shared/types.ts","../../../../src/escrow/shared/utils.ts","../../../../src/escrow/facilitator/register.ts"],"sourcesContent":["export { EscrowFacilitatorScheme } from \"./scheme\";\nexport { registerEscrowEvmScheme } from \"./register\";\nexport type { EvmFacilitatorConfig } from \"./register\";\n","/**\n * Escrow Scheme - Facilitator\n * Handles verification and settlement of escrow payments.\n *\n * Implements x402's SchemeNetworkFacilitator interface so the escrow scheme\n * is a drop-in for the x402 facilitator, just like ExactEvmScheme.\n */\n\nimport type {\n  FacilitatorContext,\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@x402/core/types\";\nimport type { FacilitatorEvmSigner } from \"@x402/evm\";\nimport { parseErc6492Signature } from \"viem\";\nimport {\n  OPERATOR_ABI,\n  ERC20_BALANCE_OF_ABI,\n} from \"../shared/constants\";\nimport { verifyERC3009Signature } from \"../shared/nonce\";\nimport {\n  isEscrowPayload,\n  isEscrowExtra,\n} from \"../shared/types\";\nimport type { EscrowExtra, EscrowPayload } from \"../shared/types\";\nimport { parseChainId } from \"../shared/utils\";\n\n/**\n * Escrow Facilitator Scheme - implements x402's SchemeNetworkFacilitator\n *\n * The facilitator is operator-agnostic: it does not store operator/escrow/tokenCollector\n * config. Those values are set by the merchant via `refundable()` and arrive in\n * `requirements.extra` at verify/settle time.\n */\nexport class EscrowFacilitatorScheme implements SchemeNetworkFacilitator {\n  readonly scheme = \"escrow\";\n  readonly caipFamily = \"eip155:*\";\n\n  constructor(private signer: FacilitatorEvmSigner) {}\n\n  getSigners(_network: string): string[] {\n    return [...this.signer.getAddresses()];\n  }\n\n  // C4: name/version now come from server's parsePrice() via AssetAmount.extra.\n  // The facilitator should not hardcode token-specific metadata.\n  getExtra(_network: string): Record<string, unknown> | undefined {\n    return undefined;\n  }\n\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n    _context?: FacilitatorContext,\n  ): Promise<VerifyResponse> {\n    // M5: Type guard instead of double cast\n    if (!isEscrowPayload(payload.payload)) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_payload_format\",\n      };\n    }\n    const escrowPayload = payload.payload as EscrowPayload;\n    const payer = escrowPayload.authorization.from;\n\n    // Validate scheme\n    if (requirements.scheme !== \"escrow\") {\n      return {\n        isValid: false,\n        invalidReason: \"unsupported_scheme\",\n        payer,\n      };\n    }\n\n    // Validate network format\n    const networkParts = requirements.network.split(\":\");\n    if (networkParts.length !== 2 || networkParts[0] !== \"eip155\") {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_network\",\n        payer,\n      };\n    }\n\n    // M5: Type guard for extra\n    if (!isEscrowExtra(requirements.extra)) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_escrow_extra\",\n        payer,\n      };\n    }\n    const extra = requirements.extra as EscrowExtra;\n    const chainId = parseChainId(requirements.network);\n\n    // Time window validation\n    const now = Math.floor(Date.now() / 1000);\n    const validBefore = Number(escrowPayload.authorization.validBefore);\n    const validAfter = Number(escrowPayload.authorization.validAfter);\n\n    if (validBefore <= now + 6) {\n      return {\n        isValid: false,\n        invalidReason: \"authorization_expired\",\n        payer,\n      };\n    }\n\n    if (validAfter > now) {\n      return {\n        isValid: false,\n        invalidReason: \"authorization_not_yet_valid\",\n        payer,\n      };\n    }\n\n    // Extract inner signature for verification if EIP-6492 wrapped.\n    // The contract's ERC6492SignatureHandler handles deployment; the facilitator\n    // only needs the inner ECDSA signature for ecrecover verification.\n    const { signature: signatureForVerify } = parseErc6492Signature(escrowPayload.signature);\n\n    // Verify ERC-3009 signature\n    const isValidSignature = await verifyERC3009Signature(\n      this.signer,\n      escrowPayload.authorization,\n      signatureForVerify,\n      { ...extra, chainId },\n      requirements.asset as `0x${string}`,\n    );\n\n    if (!isValidSignature) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_escrow_signature\",\n        payer,\n      };\n    }\n\n    // Verify amount meets requirements\n    if (\n      BigInt(escrowPayload.authorization.value) <\n      BigInt(requirements.amount)\n    ) {\n      return {\n        isValid: false,\n        invalidReason: \"insufficient_amount\",\n        payer,\n      };\n    }\n\n    // Verify token matches\n    if (\n      escrowPayload.paymentInfo.token.toLowerCase() !==\n      requirements.asset.toLowerCase()\n    ) {\n      return {\n        isValid: false,\n        invalidReason: \"token_mismatch\",\n        payer,\n      };\n    }\n\n    // Verify receiver matches\n    if (\n      escrowPayload.paymentInfo.receiver.toLowerCase() !==\n      requirements.payTo.toLowerCase()\n    ) {\n      return {\n        isValid: false,\n        invalidReason: \"receiver_mismatch\",\n        payer,\n      };\n    }\n\n    // H4: Balance check — verify payer has sufficient token balance\n    try {\n      const balance = await this.signer.readContract({\n        address: requirements.asset as `0x${string}`,\n        abi: ERC20_BALANCE_OF_ABI,\n        functionName: \"balanceOf\",\n        args: [payer],\n      });\n\n      if (BigInt(balance as string) < BigInt(requirements.amount)) {\n        return {\n          isValid: false,\n          invalidReason: \"insufficient_balance\",\n          payer,\n        };\n      }\n    } catch {\n      // If balance check fails (e.g., non-standard token), skip it.\n      // The on-chain transaction will fail anyway if balance is insufficient.\n    }\n\n    return {\n      isValid: true,\n      payer,\n    };\n  }\n\n  async settle(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n    _context?: FacilitatorContext,\n  ): Promise<SettleResponse> {\n    // H2: Re-verify before settling to catch expired/invalid payloads\n    const verification = await this.verify(payload, requirements);\n    if (!verification.isValid) {\n      return {\n        success: false,\n        errorReason: verification.invalidReason ?? \"verification_failed\",\n        transaction: \"\",\n        network: requirements.network,\n        payer: verification.payer,\n      };\n    }\n\n    const escrowPayload = payload.payload as unknown as EscrowPayload;\n    const extra = requirements.extra as unknown as EscrowExtra;\n    const { authorizeAddress, operatorAddress, tokenCollector } = extra;\n\n    const paymentInfo = {\n      operator: escrowPayload.paymentInfo.operator,\n      payer: escrowPayload.authorization.from,\n      receiver: escrowPayload.paymentInfo.receiver,\n      token: escrowPayload.paymentInfo.token,\n      maxAmount: BigInt(escrowPayload.paymentInfo.maxAmount),\n      preApprovalExpiry: escrowPayload.paymentInfo.preApprovalExpiry,\n      authorizationExpiry: escrowPayload.paymentInfo.authorizationExpiry,\n      refundExpiry: escrowPayload.paymentInfo.refundExpiry,\n      minFeeBps: escrowPayload.paymentInfo.minFeeBps,\n      maxFeeBps: escrowPayload.paymentInfo.maxFeeBps,\n      feeReceiver: escrowPayload.paymentInfo.feeReceiver,\n      salt: BigInt(escrowPayload.paymentInfo.salt),\n    };\n\n    // Pass raw signature — ERC3009PaymentCollector/ERC6492SignatureHandler\n    // handles EIP-6492 unwrapping and wallet deployment on-chain\n    const collectorData = escrowPayload.signature;\n\n    const target = authorizeAddress ?? operatorAddress;\n\n    try {\n      const txHash = await this.signer.writeContract({\n        address: target,\n        abi: OPERATOR_ABI,\n        functionName: \"authorize\",\n        args: [\n          paymentInfo,\n          BigInt(escrowPayload.authorization.value),\n          tokenCollector,\n          collectorData,\n        ],\n      });\n\n      // Wait for transaction confirmation with 60s timeout to avoid hanging on stuck txs\n      const receiptPromise = this.signer.waitForTransactionReceipt({\n        hash: txHash,\n      });\n      const timeoutPromise = new Promise<never>((_, reject) =>\n        setTimeout(\n          () => reject(new Error(\"Transaction receipt timeout after 60s\")),\n          60_000,\n        ),\n      );\n      const receipt = await Promise.race([receiptPromise, timeoutPromise]);\n\n      if (receipt.status !== \"success\") {\n        return {\n          success: false,\n          errorReason: \"transaction_reverted\",\n          transaction: txHash,\n          network: requirements.network,\n          payer: escrowPayload.authorization.from,\n        };\n      }\n\n      return {\n        success: true,\n        transaction: txHash,\n        network: requirements.network,\n        payer: escrowPayload.authorization.from,\n      };\n    } catch (error) {\n      return {\n        success: false,\n        errorReason:\n          error instanceof Error ? error.message : \"Settlement failed\",\n        transaction: \"\",\n        network: requirements.network,\n        payer: escrowPayload.authorization.from,\n      };\n    }\n  }\n}\n","export const ZERO_ADDRESS =\n  \"0x0000000000000000000000000000000000000000\" as const;\nexport const MAX_UINT48 = 281474976710655;\nexport const MAX_UINT32 = 4294967295;\n\n// PaymentInfo struct for AuthCaptureEscrow (matches commerce-payments contract)\nexport const PAYMENT_INFO_COMPONENTS = [\n  { name: \"operator\", type: \"address\" },\n  { name: \"payer\", type: \"address\" },\n  { name: \"receiver\", type: \"address\" },\n  { name: \"token\", type: \"address\" },\n  { name: \"maxAmount\", type: \"uint120\" },\n  { name: \"preApprovalExpiry\", type: \"uint48\" },\n  { name: \"authorizationExpiry\", type: \"uint48\" },\n  { name: \"refundExpiry\", type: \"uint48\" },\n  { name: \"minFeeBps\", type: \"uint16\" },\n  { name: \"maxFeeBps\", type: \"uint16\" },\n  { name: \"feeReceiver\", type: \"address\" },\n  { name: \"salt\", type: \"uint256\" },\n] as const;\n\nexport const OPERATOR_ABI = [\n  {\n    name: \"authorize\",\n    type: \"function\",\n    stateMutability: \"nonpayable\",\n    inputs: [\n      {\n        name: \"paymentInfo\",\n        type: \"tuple\",\n        components: PAYMENT_INFO_COMPONENTS,\n      },\n      { name: \"amount\", type: \"uint256\" },\n      { name: \"tokenCollector\", type: \"address\" },\n      { name: \"collectorData\", type: \"bytes\" },\n    ],\n    outputs: [],\n  },\n] as const;\n\n// ERC-3009 TransferWithAuthorization type hash\nexport const TRANSFER_WITH_AUTHORIZATION_TYPEHASH =\n  \"0x7c7c6cdb67a18743f49ec6fa9b35f50d52ed05cbed4cc592e13b44501c1a2267\" as const;\n\n// ERC-3009 ReceiveWithAuthorization EIP-712 types\nexport const RECEIVE_AUTHORIZATION_TYPES = {\n  ReceiveWithAuthorization: [\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// ERC-20 balanceOf ABI for balance checks\nexport const ERC20_BALANCE_OF_ABI = [\n  {\n    name: \"balanceOf\",\n    type: \"function\",\n    stateMutability: \"view\",\n    inputs: [{ name: \"account\", type: \"address\" }],\n    outputs: [{ name: \"balance\", type: \"uint256\" }],\n  },\n] as const;\n","/**\n * Nonce computation and ERC-3009 signing utilities\n * Adapted from @agentokratia/x402-escrow (MIT)\n */\n\nimport { encodeAbiParameters, getAddress, keccak256, toHex } from \"viem\";\nimport type { ClientEvmSigner } from \"@x402/evm\";\nimport { ZERO_ADDRESS, PAYMENT_INFO_COMPONENTS, RECEIVE_AUTHORIZATION_TYPES } from \"./constants\";\nimport type { EscrowExtra, EscrowPayload } from \"./types\";\n\n/**\n * PaymentInfo typehash - must match AuthCaptureEscrow.PAYMENT_INFO_TYPEHASH\n */\nconst PAYMENT_INFO_TYPEHASH = keccak256(\n  new TextEncoder().encode(\n    \"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)\",\n  ),\n);\n\n/**\n * Compute escrow nonce for ERC-3009 authorization\n * Must match AuthCaptureEscrow.getHash() with payer=address(0)\n */\nexport function computeEscrowNonce(\n  chainId: number,\n  escrowAddress: `0x${string}`,\n  paymentInfo: EscrowPayload[\"paymentInfo\"],\n): `0x${string}` {\n  // Step 1: Encode paymentInfo with payer=0 (payer-agnostic)\n  const paymentInfoEncoded = encodeAbiParameters(\n    [\n      { name: \"typehash\", type: \"bytes32\" },\n      { name: \"operator\", type: \"address\" },\n      { name: \"payer\", type: \"address\" },\n      { name: \"receiver\", type: \"address\" },\n      { name: \"token\", type: \"address\" },\n      { name: \"maxAmount\", type: \"uint120\" },\n      { name: \"preApprovalExpiry\", type: \"uint48\" },\n      { name: \"authorizationExpiry\", type: \"uint48\" },\n      { name: \"refundExpiry\", type: \"uint48\" },\n      { name: \"minFeeBps\", type: \"uint16\" },\n      { name: \"maxFeeBps\", type: \"uint16\" },\n      { name: \"feeReceiver\", type: \"address\" },\n      { name: \"salt\", type: \"uint256\" },\n    ],\n    [\n      PAYMENT_INFO_TYPEHASH,\n      paymentInfo.operator,\n      ZERO_ADDRESS, // payer-agnostic\n      paymentInfo.receiver,\n      paymentInfo.token,\n      BigInt(paymentInfo.maxAmount),\n      paymentInfo.preApprovalExpiry,\n      paymentInfo.authorizationExpiry,\n      paymentInfo.refundExpiry,\n      paymentInfo.minFeeBps,\n      paymentInfo.maxFeeBps,\n      paymentInfo.feeReceiver,\n      BigInt(paymentInfo.salt),\n    ],\n  );\n  const paymentInfoHash = keccak256(paymentInfoEncoded);\n\n  // Step 2: Encode (chainId, escrow, paymentInfoHash) and hash\n  const outerEncoded = encodeAbiParameters(\n    [\n      { name: \"chainId\", type: \"uint256\" },\n      { name: \"escrow\", type: \"address\" },\n      { name: \"paymentInfoHash\", type: \"bytes32\" },\n    ],\n    [BigInt(chainId), escrowAddress, paymentInfoHash],\n  );\n\n  return keccak256(outerEncoded);\n}\n\n/**\n * Sign ERC-3009 ReceiveWithAuthorization\n * Note: receiveWithAuthorization uses a different primary type than transferWithAuthorization\n */\nexport async function signERC3009(\n  signer: ClientEvmSigner,\n  authorization: EscrowPayload[\"authorization\"],\n  extra: EscrowExtra,\n  tokenAddress: `0x${string}`,\n  chainId: number,\n): Promise<`0x${string}`> {\n  // EIP-712 domain - name must match the token's EIP-712 domain\n  // (e.g., \"USDC\" for Base USDC, not \"USD Coin\")\n  const domain = {\n    name: extra.name,\n    version: extra.version,\n    chainId,\n    verifyingContract: getAddress(tokenAddress),\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 signer.signTypedData({\n    domain,\n    types: RECEIVE_AUTHORIZATION_TYPES,\n    primaryType: \"ReceiveWithAuthorization\",\n    message,\n  });\n}\n\n/**\n * Verify ERC-3009 signature (facilitator-side)\n * @param signer - The signer with verifyTypedData method\n * @param authorization - ERC-3009 authorization data\n * @param signature - The signature to verify\n * @param extra - Extra configuration including chainId\n * @param tokenAddress - The token contract address (verifyingContract for EIP-712)\n */\nexport async function verifyERC3009Signature(\n  signer: {\n    verifyTypedData: (args: {\n      address: `0x${string}`;\n      domain: Record<string, unknown>;\n      types: Record<string, unknown>;\n      primaryType: string;\n      message: Record<string, unknown>;\n      signature: `0x${string}`;\n    }) => Promise<boolean>;\n  },\n  authorization: EscrowPayload[\"authorization\"],\n  signature: `0x${string}`,\n  extra: EscrowExtra & { chainId: number },\n  tokenAddress: `0x${string}`,\n): Promise<boolean> {\n  const domain = {\n    name: extra.name,\n    version: extra.version,\n    chainId: extra.chainId,\n    verifyingContract: getAddress(tokenAddress),\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  try {\n    return await signer.verifyTypedData({\n      address: getAddress(authorization.from),\n      domain,\n      types: RECEIVE_AUTHORIZATION_TYPES,\n      primaryType: \"ReceiveWithAuthorization\",\n      message,\n      signature,\n    });\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Generate random salt for paymentInfo\n */\nexport function generateSalt(): `0x${string}` {\n  const bytes = new Uint8Array(32);\n  crypto.getRandomValues(bytes);\n  return toHex(bytes);\n}\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","/**\n * Parse chainId from CAIP-2 network identifier\n * @param network - CAIP-2 network identifier (e.g., 'eip155:84532')\n * @returns The chain ID as a number\n */\nexport function parseChainId(network: string): number {\n  const parts = network.split(\":\");\n  if (parts.length !== 2 || parts[0] !== \"eip155\") {\n    throw new Error(\n      `Invalid network format: ${network}. Expected 'eip155:<chainId>'`,\n    );\n  }\n  const chainId = parseInt(parts[1], 10);\n  if (isNaN(chainId)) {\n    throw new Error(`Invalid chainId in network: ${network}`);\n  }\n  return chainId;\n}\n","import type { Network } from \"@x402/core/types\";\nimport type { FacilitatorEvmSigner } from \"@x402/evm\";\nimport { x402Facilitator } from \"@x402/core/facilitator\";\nimport { EscrowFacilitatorScheme } from \"./scheme\";\n\nexport interface EvmFacilitatorConfig {\n  signer: FacilitatorEvmSigner;\n  networks: Network | Network[];\n}\n\n/**\n * Register escrow scheme with x402Facilitator\n *\n * The facilitator is operator-agnostic — it supports any operator. Operator,\n * escrow, and tokenCollector addresses are provided per-request by the merchant\n * via `refundable()` and arrive in `requirements.extra`.\n *\n * @example\n * ```typescript\n * const facilitator = new x402Facilitator();\n * registerEscrowEvmScheme(facilitator, {\n *   signer: evmSigner,\n *   networks: \"eip155:84532\",\n * });\n * ```\n */\nexport function registerEscrowEvmScheme(\n  facilitator: x402Facilitator,\n  config: EvmFacilitatorConfig,\n): x402Facilitator {\n  facilitator.register(\n    config.networks,\n    new EscrowFacilitatorScheme(config.signer),\n  );\n  return facilitator;\n}\n"],"mappings":"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","names":["import_viem"]}

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

@@ -0,0 +1,53 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, FacilitatorContext, VerifyResponse, SettleResponse, Network } from '@x402/core/types';
+import { FacilitatorEvmSigner } from '@x402/evm';
+import { x402Facilitator } from '@x402/core/facilitator';
+
+/**
+ * Escrow Scheme - Facilitator
+ * Handles verification and settlement of escrow payments.
+ *
+ * Implements x402's SchemeNetworkFacilitator interface so the escrow scheme
+ * is a drop-in for the x402 facilitator, just like ExactEvmScheme.
+ */
+
+/**
+ * Escrow Facilitator Scheme - implements x402's SchemeNetworkFacilitator
+ *
+ * The facilitator is operator-agnostic: it does not store operator/escrow/tokenCollector
+ * config. Those values are set by the merchant via `refundable()` and arrive in
+ * `requirements.extra` at verify/settle time.
+ */
+declare class EscrowFacilitatorScheme implements SchemeNetworkFacilitator {
+    private signer;
+    readonly scheme = "escrow";
+    readonly caipFamily = "eip155:*";
+    constructor(signer: FacilitatorEvmSigner);
+    getSigners(_network: string): string[];
+    getExtra(_network: string): Record<string, unknown> | undefined;
+    verify(payload: PaymentPayload, requirements: PaymentRequirements, _context?: FacilitatorContext): Promise<VerifyResponse>;
+    settle(payload: PaymentPayload, requirements: PaymentRequirements, _context?: FacilitatorContext): Promise<SettleResponse>;
+}
+
+interface EvmFacilitatorConfig {
+    signer: FacilitatorEvmSigner;
+    networks: Network | Network[];
+}
+/**
+ * Register escrow scheme with x402Facilitator
+ *
+ * The facilitator is operator-agnostic — it supports any operator. Operator,
+ * escrow, and tokenCollector addresses are provided per-request by the merchant
+ * via `refundable()` and arrive in `requirements.extra`.
+ *
+ * @example
+ * ```typescript
+ * const facilitator = new x402Facilitator();
+ * registerEscrowEvmScheme(facilitator, {
+ *   signer: evmSigner,
+ *   networks: "eip155:84532",
+ * });
+ * ```
+ */
+declare function registerEscrowEvmScheme(facilitator: x402Facilitator, config: EvmFacilitatorConfig): x402Facilitator;
+
+export { EscrowFacilitatorScheme, type EvmFacilitatorConfig, registerEscrowEvmScheme };

package/dist/{escrow → cjs/escrow}/facilitator/index.d.ts

@@ -1,3 +1,7 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, FacilitatorContext, VerifyResponse, SettleResponse, Network } from '@x402/core/types';
+import { FacilitatorEvmSigner } from '@x402/evm';
+import { x402Facilitator } from '@x402/core/facilitator';
+
 /**
  * Escrow Scheme - Facilitator
  * Handles verification and settlement of escrow payments.
@@ -5,9 +9,7 @@
  * Implements x402's SchemeNetworkFacilitator interface so the escrow scheme
  * is a drop-in for the x402 facilitator, just like ExactEvmScheme.
  */
-import type { Network, PaymentPayload, PaymentRequirements, SchemeNetworkFacilitator, SettleResponse, VerifyResponse } from "@x402/core/types";
-import type { FacilitatorEvmSigner } from "@x402/evm";
-import { x402Facilitator } from "@x402/core/facilitator";
+
 /**
  * Escrow Facilitator Scheme - implements x402's SchemeNetworkFacilitator
  *
@@ -15,15 +17,20 @@ import { x402Facilitator } from "@x402/core/facilitator";
  * config. Those values are set by the merchant via `refundable()` and arrive in
  * `requirements.extra` at verify/settle time.
  */
-export declare class EscrowFacilitatorScheme implements SchemeNetworkFacilitator {
+declare class EscrowFacilitatorScheme implements SchemeNetworkFacilitator {
     private signer;
     readonly scheme = "escrow";
     readonly caipFamily = "eip155:*";
     constructor(signer: FacilitatorEvmSigner);
     getSigners(_network: string): string[];
     getExtra(_network: string): Record<string, unknown> | undefined;
-    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
-    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+    verify(payload: PaymentPayload, requirements: PaymentRequirements, _context?: FacilitatorContext): Promise<VerifyResponse>;
+    settle(payload: PaymentPayload, requirements: PaymentRequirements, _context?: FacilitatorContext): Promise<SettleResponse>;
+}
+
+interface EvmFacilitatorConfig {
+    signer: FacilitatorEvmSigner;
+    networks: Network | Network[];
 }
 /**
  * Register escrow scheme with x402Facilitator
@@ -35,15 +42,12 @@ export declare class EscrowFacilitatorScheme implements SchemeNetworkFacilitator
  * @example
  * ```typescript
  * const facilitator = new x402Facilitator();
- * registerEscrowScheme(facilitator, {
+ * registerEscrowEvmScheme(facilitator, {
  *   signer: evmSigner,
  *   networks: "eip155:84532",
  * });
  * ```
  */
-export declare function registerEscrowScheme(facilitator: x402Facilitator, config: {
-    signer: FacilitatorEvmSigner;
-    networks: Network | Network[];
-}): x402Facilitator;
-export type { EscrowExtra, EscrowPayload } from "../../shared/types.js";
-//# sourceMappingURL=index.d.ts.map
+declare function registerEscrowEvmScheme(facilitator: x402Facilitator, config: EvmFacilitatorConfig): x402Facilitator;
+
+export { EscrowFacilitatorScheme, type EvmFacilitatorConfig, registerEscrowEvmScheme };