@x402r/evm 0.0.2 → 0.0.3

package/dist/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/escrow/index.ts","../../src/escrow/shared/nonce.ts","../../src/escrow/shared/constants.ts","../../src/escrow/shared/utils.ts","../../src/escrow/client/scheme.ts"],"sourcesContent":["export { EscrowEvmScheme } from \"./client/scheme\";\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","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 * 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","/**\n * Escrow Scheme - Client\n * Creates payment payloads for escrow payments.\n *\n * Implements x402's SchemeNetworkClient interface so it can be registered\n * on an x402Client via client.register('eip155:84532', new EscrowEvmScheme(signer)).\n */\n\nimport type {\n  PaymentPayloadContext,\n  PaymentPayloadResult,\n  PaymentRequirements,\n  SchemeNetworkClient,\n} from \"@x402/core/types\";\nimport type { ClientEvmSigner } from \"@x402/evm\";\nimport {\n  computeEscrowNonce,\n  signERC3009,\n  generateSalt,\n} from \"../shared/nonce\";\nimport { MAX_UINT48 } from \"../shared/constants\";\nimport type { EscrowExtra } from \"../shared/types\";\nimport { parseChainId } from \"../shared/utils\";\n\n/**\n * Escrow Client Scheme - implements x402's SchemeNetworkClient\n */\nexport class EscrowEvmScheme implements SchemeNetworkClient {\n  readonly scheme = \"escrow\";\n\n  constructor(private readonly signer: ClientEvmSigner) {}\n\n  async createPaymentPayload(\n    x402Version: number,\n    requirements: PaymentRequirements,\n    _context?: PaymentPayloadContext,\n  ): Promise<PaymentPayloadResult> {\n    if (x402Version !== 2) {\n      throw new Error(\n        `Unsupported x402Version: ${x402Version}. Only version 2 is supported.`,\n      );\n    }\n\n    const extra = requirements.extra as unknown as EscrowExtra;\n\n    // Validate required EIP-712 domain parameters (M3, M10)\n    if (!extra.name) {\n      throw new Error(\n        `EIP-712 domain parameter 'name' is required in payment requirements for asset ${requirements.asset}`,\n      );\n    }\n    if (!extra.version) {\n      throw new Error(\n        `EIP-712 domain parameter 'version' is required in payment requirements for asset ${requirements.asset}`,\n      );\n    }\n\n    const {\n      escrowAddress,\n      operatorAddress,\n      tokenCollector,\n      minFeeBps = 0,\n      maxFeeBps = 0,\n      feeReceiver,\n      preApprovalExpirySeconds,\n      refundExpirySeconds,\n      authorizationExpirySeconds,\n    } = extra;\n\n    const chainId = parseChainId(requirements.network);\n    const maxAmount = requirements.amount;\n\n    const paymentInfo = {\n      operator: operatorAddress,\n      receiver: requirements.payTo as `0x${string}`,\n      token: requirements.asset as `0x${string}`,\n      maxAmount,\n      preApprovalExpiry: preApprovalExpirySeconds ?? MAX_UINT48,\n      authorizationExpiry: authorizationExpirySeconds ?? MAX_UINT48,\n      refundExpiry: refundExpirySeconds ?? MAX_UINT48,\n      minFeeBps,\n      maxFeeBps,\n      feeReceiver: feeReceiver ?? operatorAddress,\n      salt: generateSalt(),\n    };\n\n    const nonce = computeEscrowNonce(chainId, escrowAddress, paymentInfo);\n\n    // ERC-3009 authorization - validBefore MUST match what contract passes to receiveWithAuthorization\n    // The contract uses paymentInfo.preApprovalExpiry as validBefore\n    const authorization = {\n      from: this.signer.address,\n      to: tokenCollector,\n      value: maxAmount,\n      validAfter: \"0\",\n      validBefore: String(paymentInfo.preApprovalExpiry),\n      nonce,\n    };\n\n    const signature = await signERC3009(\n      this.signer,\n      authorization,\n      extra,\n      requirements.asset as `0x${string}`,\n      chainId,\n    );\n\n    return {\n      x402Version,\n      payload: { authorization, signature, paymentInfo },\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cjs/index.d.cts

@@ -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 };

package/dist/cjs/index.d.ts

@@ -0,0 +1,54 @@
+export { E as EscrowEvmScheme } from './scheme-CNrmuyp3.js';
+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/cjs/index.js

@@ -0,0 +1,223 @@
+"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,
+  isEscrowExtra: () => isEscrowExtra,
+  isEscrowPayload: () => isEscrowPayload
+});
+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 }
+    };
+  }
+};
+
+// 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 = {
+  EscrowEvmScheme,
+  isEscrowExtra,
+  isEscrowPayload
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/escrow/index.ts","../../src/escrow/shared/nonce.ts","../../src/escrow/shared/constants.ts","../../src/escrow/shared/utils.ts","../../src/escrow/client/scheme.ts","../../src/escrow/shared/types.ts"],"sourcesContent":["export { EscrowEvmScheme } from './client/scheme'\nexport type { EscrowPayload, EscrowExtra } from './shared/types'\nexport { isEscrowPayload, isEscrowExtra } from './shared/types'\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, 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","export const ZERO_ADDRESS = '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 * 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(`Invalid network format: ${network}. Expected 'eip155:<chainId>'`)\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","/**\n * Escrow Scheme - Client\n * Creates payment payloads for escrow payments.\n *\n * Implements x402's SchemeNetworkClient interface so it can be registered\n * on an x402Client via client.register('eip155:84532', new EscrowEvmScheme(signer)).\n */\n\nimport type {\n  PaymentPayloadContext,\n  PaymentPayloadResult,\n  PaymentRequirements,\n  SchemeNetworkClient,\n} from '@x402/core/types'\nimport type { ClientEvmSigner } from '@x402/evm'\nimport { computeEscrowNonce, signERC3009, generateSalt } from '../shared/nonce'\nimport { MAX_UINT48 } from '../shared/constants'\nimport type { EscrowExtra } from '../shared/types'\nimport { parseChainId } from '../shared/utils'\n\n/**\n * Escrow Client Scheme - implements x402's SchemeNetworkClient\n */\nexport class EscrowEvmScheme implements SchemeNetworkClient {\n  readonly scheme = 'escrow'\n\n  constructor(private readonly signer: ClientEvmSigner) {}\n\n  async createPaymentPayload(\n    x402Version: number,\n    requirements: PaymentRequirements,\n    _context?: PaymentPayloadContext,\n  ): Promise<PaymentPayloadResult> {\n    if (x402Version !== 2) {\n      throw new Error(`Unsupported x402Version: ${x402Version}. Only version 2 is supported.`)\n    }\n\n    const extra = requirements.extra as unknown as EscrowExtra\n\n    // Validate required EIP-712 domain parameters (M3, M10)\n    if (!extra.name) {\n      throw new Error(\n        `EIP-712 domain parameter 'name' is required in payment requirements for asset ${requirements.asset}`,\n      )\n    }\n    if (!extra.version) {\n      throw new Error(\n        `EIP-712 domain parameter 'version' is required in payment requirements for asset ${requirements.asset}`,\n      )\n    }\n\n    const {\n      escrowAddress,\n      operatorAddress,\n      tokenCollector,\n      minFeeBps = 0,\n      maxFeeBps = 0,\n      feeReceiver,\n      preApprovalExpirySeconds,\n      refundExpirySeconds,\n      authorizationExpirySeconds,\n    } = extra\n\n    const chainId = parseChainId(requirements.network)\n    const maxAmount = requirements.amount\n\n    const paymentInfo = {\n      operator: operatorAddress,\n      receiver: requirements.payTo as `0x${string}`,\n      token: requirements.asset as `0x${string}`,\n      maxAmount,\n      preApprovalExpiry: preApprovalExpirySeconds ?? MAX_UINT48,\n      authorizationExpiry: authorizationExpirySeconds ?? MAX_UINT48,\n      refundExpiry: refundExpirySeconds ?? MAX_UINT48,\n      minFeeBps,\n      maxFeeBps,\n      feeReceiver: feeReceiver ?? operatorAddress,\n      salt: generateSalt(),\n    }\n\n    const nonce = computeEscrowNonce(chainId, escrowAddress, paymentInfo)\n\n    // ERC-3009 authorization - validBefore MUST match what contract passes to receiveWithAuthorization\n    // The contract uses paymentInfo.preApprovalExpiry as validBefore\n    const authorization = {\n      from: this.signer.address,\n      to: tokenCollector,\n      value: maxAmount,\n      validAfter: '0',\n      validBefore: String(paymentInfo.preApprovalExpiry),\n      nonce,\n    }\n\n    const signature = await signERC3009(\n      this.signer,\n      authorization,\n      extra,\n      requirements.asset as `0x${string}`,\n      chainId,\n    )\n\n    return {\n      x402Version,\n      payload: { authorization, signature, paymentInfo },\n    }\n  }\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"],"mappings":"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","names":[]}

package/dist/cjs/scheme-CNrmuyp3.d.ts

@@ -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/dist/esm/chunk-DLIBGHEY.mjs

@@ -0,0 +1,85 @@
+import {
+  MAX_UINT48,
+  computeEscrowNonce,
+  generateSalt,
+  parseChainId,
+  signERC3009
+} from "./chunk-IYUU7AJZ.mjs";
+import {
+  __publicField
+} from "./chunk-NSSMTXJJ.mjs";
+
+// 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 }
+    };
+  }
+};
+
+export {
+  EscrowEvmScheme
+};
+//# sourceMappingURL=chunk-DLIBGHEY.mjs.map

package/dist/esm/chunk-DLIBGHEY.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/escrow/client/scheme.ts"],"sourcesContent":["/**\n * Escrow Scheme - Client\n * Creates payment payloads for escrow payments.\n *\n * Implements x402's SchemeNetworkClient interface so it can be registered\n * on an x402Client via client.register('eip155:84532', new EscrowEvmScheme(signer)).\n */\n\nimport type {\n  PaymentPayloadContext,\n  PaymentPayloadResult,\n  PaymentRequirements,\n  SchemeNetworkClient,\n} from '@x402/core/types'\nimport type { ClientEvmSigner } from '@x402/evm'\nimport { computeEscrowNonce, signERC3009, generateSalt } from '../shared/nonce'\nimport { MAX_UINT48 } from '../shared/constants'\nimport type { EscrowExtra } from '../shared/types'\nimport { parseChainId } from '../shared/utils'\n\n/**\n * Escrow Client Scheme - implements x402's SchemeNetworkClient\n */\nexport class EscrowEvmScheme implements SchemeNetworkClient {\n  readonly scheme = 'escrow'\n\n  constructor(private readonly signer: ClientEvmSigner) {}\n\n  async createPaymentPayload(\n    x402Version: number,\n    requirements: PaymentRequirements,\n    _context?: PaymentPayloadContext,\n  ): Promise<PaymentPayloadResult> {\n    if (x402Version !== 2) {\n      throw new Error(`Unsupported x402Version: ${x402Version}. Only version 2 is supported.`)\n    }\n\n    const extra = requirements.extra as unknown as EscrowExtra\n\n    // Validate required EIP-712 domain parameters (M3, M10)\n    if (!extra.name) {\n      throw new Error(\n        `EIP-712 domain parameter 'name' is required in payment requirements for asset ${requirements.asset}`,\n      )\n    }\n    if (!extra.version) {\n      throw new Error(\n        `EIP-712 domain parameter 'version' is required in payment requirements for asset ${requirements.asset}`,\n      )\n    }\n\n    const {\n      escrowAddress,\n      operatorAddress,\n      tokenCollector,\n      minFeeBps = 0,\n      maxFeeBps = 0,\n      feeReceiver,\n      preApprovalExpirySeconds,\n      refundExpirySeconds,\n      authorizationExpirySeconds,\n    } = extra\n\n    const chainId = parseChainId(requirements.network)\n    const maxAmount = requirements.amount\n\n    const paymentInfo = {\n      operator: operatorAddress,\n      receiver: requirements.payTo as `0x${string}`,\n      token: requirements.asset as `0x${string}`,\n      maxAmount,\n      preApprovalExpiry: preApprovalExpirySeconds ?? MAX_UINT48,\n      authorizationExpiry: authorizationExpirySeconds ?? MAX_UINT48,\n      refundExpiry: refundExpirySeconds ?? MAX_UINT48,\n      minFeeBps,\n      maxFeeBps,\n      feeReceiver: feeReceiver ?? operatorAddress,\n      salt: generateSalt(),\n    }\n\n    const nonce = computeEscrowNonce(chainId, escrowAddress, paymentInfo)\n\n    // ERC-3009 authorization - validBefore MUST match what contract passes to receiveWithAuthorization\n    // The contract uses paymentInfo.preApprovalExpiry as validBefore\n    const authorization = {\n      from: this.signer.address,\n      to: tokenCollector,\n      value: maxAmount,\n      validAfter: '0',\n      validBefore: String(paymentInfo.preApprovalExpiry),\n      nonce,\n    }\n\n    const signature = await signERC3009(\n      this.signer,\n      authorization,\n      extra,\n      requirements.asset as `0x${string}`,\n      chainId,\n    )\n\n    return {\n      x402Version,\n      payload: { authorization, signature, paymentInfo },\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAuBO,IAAM,kBAAN,MAAqD;AAAA,EAG1D,YAA6B,QAAyB;AAAzB;AAF7B,wBAAS,UAAS;AAAA,EAEqC;AAAA,EAEvD,MAAM,qBACJ,aACA,cACA,UAC+B;AAC/B,QAAI,gBAAgB,GAAG;AACrB,YAAM,IAAI,MAAM,4BAA4B,WAAW,gCAAgC;AAAA,IACzF;AAEA,UAAM,QAAQ,aAAa;AAG3B,QAAI,CAAC,MAAM,MAAM;AACf,YAAM,IAAI;AAAA,QACR,iFAAiF,aAAa,KAAK;AAAA,MACrG;AAAA,IACF;AACA,QAAI,CAAC,MAAM,SAAS;AAClB,YAAM,IAAI;AAAA,QACR,oFAAoF,aAAa,KAAK;AAAA,MACxG;AAAA,IACF;AAEA,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA,YAAY;AAAA,MACZ,YAAY;AAAA,MACZ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,IAAI;AAEJ,UAAM,UAAU,aAAa,aAAa,OAAO;AACjD,UAAM,YAAY,aAAa;AAE/B,UAAM,cAAc;AAAA,MAClB,UAAU;AAAA,MACV,UAAU,aAAa;AAAA,MACvB,OAAO,aAAa;AAAA,MACpB;AAAA,MACA,mBAAmB,4BAA4B;AAAA,MAC/C,qBAAqB,8BAA8B;AAAA,MACnD,cAAc,uBAAuB;AAAA,MACrC;AAAA,MACA;AAAA,MACA,aAAa,eAAe;AAAA,MAC5B,MAAM,aAAa;AAAA,IACrB;AAEA,UAAM,QAAQ,mBAAmB,SAAS,eAAe,WAAW;AAIpE,UAAM,gBAAgB;AAAA,MACpB,MAAM,KAAK,OAAO;AAAA,MAClB,IAAI;AAAA,MACJ,OAAO;AAAA,MACP,YAAY;AAAA,MACZ,aAAa,OAAO,YAAY,iBAAiB;AAAA,MACjD;AAAA,IACF;AAEA,UAAM,YAAY,MAAM;AAAA,MACtB,KAAK;AAAA,MACL;AAAA,MACA;AAAA,MACA,aAAa;AAAA,MACb;AAAA,IACF;AAEA,WAAO;AAAA,MACL;AAAA,MACA,SAAS,EAAE,eAAe,WAAW,YAAY;AAAA,IACnD;AAAA,EACF;AACF;","names":[]}