@introspectivelabs/x402-evm 0.0.1

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

@@ -0,0 +1,224 @@
+import { SchemeNetworkFacilitator, Network, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse } from '@x402/core/types';
+export { E as Erc4337Payload, U as UserOperation07Json } from '../../types-Dk5U6Xnw.js';
+
+/**
+ * Configuration for the ERC-4337 facilitator
+ */
+interface ExactEvmSchemeNetworkERC4337Config {
+    /**
+     * Default bundler URL to use if not provided in payload or requirements
+     */
+    defaultBundlerUrl?: string;
+    /**
+     * Timeout for receipt polling in milliseconds
+     *
+     * @default 30000
+     */
+    receiptPollTimeout?: number;
+    /**
+     * Interval for receipt polling in milliseconds
+     *
+     * @default 1000
+     */
+    receiptPollInterval?: number;
+}
+/**
+ * Enhanced ExactEvmScheme facilitator that supports UserOperation (ERC-4337) payments.
+ *
+ * This facilitator implements the `SchemeNetworkFacilitator` interface and handles
+ * verification and settlement of user operations through a bundler.
+ *
+ * @example
+ * ```typescript
+ * import { ExactEvmSchemeNetworkERC4337 } from '@introspectivelabs/x402-evm/exact/facilitator';
+ * import { x402Facilitator } from '@x402/core/facilitator';
+ *
+ * const facilitator = new x402Facilitator()
+ *   .register('eip155:84532', new ExactEvmSchemeNetworkERC4337());
+ * ```
+ */
+declare class ExactEvmSchemeNetworkERC4337 implements SchemeNetworkFacilitator {
+    readonly scheme = "exact";
+    readonly caipFamily = "eip155:*";
+    private readonly config;
+    /**
+     * Creates a new ExactEvmSchemeNetworkERC4337 instance
+     *
+     * @param config - Optional configuration for the facilitator
+     */
+    constructor(config?: ExactEvmSchemeNetworkERC4337Config);
+    /**
+     * Get mechanism-specific extra data for the supported kinds endpoint.
+     * Returns user operation capability if available.
+     *
+     * @param _ - The network identifier (unused, but required by interface)
+     * @returns User operation capability or undefined
+     */
+    getExtra(_: Network): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses used by this facilitator.
+     * For user operations, no facilitator signer is needed as the user signs the operation.
+     *
+     * @param _ - The network identifier (unused, but required by interface)
+     * @returns Empty array (no facilitator signer needed)
+     */
+    getSigners(_: string): string[];
+    /**
+     * Verifies a payment payload containing a user operation.
+     *
+     * This method:
+     * - Extracts the user operation from the payload
+     * - Gets the bundler URL from payload, requirements, or config
+     * - Estimates gas using the bundler to validate the user operation
+     *
+     * @param payload - The payment payload containing the user operation
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to verification response
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settles a payment by sending the user operation to the bundler.
+     *
+     * This method:
+     * - Re-verifies the payment (following original pattern)
+     * - Sends the user operation to the bundler
+     * - Polls for the receipt
+     * - Returns the transaction hash
+     *
+     * @param payload - The payment payload containing the user operation
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to settlement response
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+
+/**
+ * Gas estimation response from bundler
+ */
+interface GasEstimate {
+    [key: string]: unknown;
+    callGasLimit?: string;
+    verificationGasLimit?: string;
+    preVerificationGas?: string;
+    maxFeePerGas?: string;
+    maxPriorityFeePerGas?: string;
+    paymasterVerificationGasLimit?: string;
+    paymasterPostOpGasLimit?: string;
+}
+/**
+ * User operation receipt from bundler
+ */
+interface UserOperationReceipt {
+    [key: string]: unknown;
+    userOpHash: string;
+    entryPoint: string;
+    sender: string;
+    nonce: string;
+    paymaster?: string;
+    actualGasCost: string;
+    actualGasUsed: string;
+    success: boolean;
+    reason?: string;
+    logs: unknown[];
+    receipt?: {
+        [key: string]: unknown;
+        transactionHash: string;
+    };
+    transactionHash?: string;
+}
+/**
+ * Configuration for bundler client
+ */
+interface BundlerClientConfig {
+    /**
+     * Timeout for RPC calls in milliseconds
+     *
+     * @default 10000
+     */
+    timeout?: number;
+    /**
+     * Number of retries for failed requests
+     *
+     * @default 0
+     */
+    retries?: number;
+}
+/**
+ * Custom error class for bundler-related errors
+ */
+declare class BundlerError extends Error {
+    readonly code?: number;
+    readonly data?: unknown;
+    readonly method?: string;
+    readonly bundlerUrl?: string;
+    /**
+     * Creates a new BundlerError instance
+     *
+     * @param message - Error message
+     * @param options - Optional error details
+     * @param options.code - Error code from bundler
+     * @param options.data - Additional error data
+     * @param options.method - RPC method that failed
+     * @param options.bundlerUrl - Bundler URL that was called
+     * @param options.cause - Original error that caused this error
+     */
+    constructor(message: string, options?: {
+        code?: number;
+        data?: unknown;
+        method?: string;
+        bundlerUrl?: string;
+        cause?: Error;
+    });
+}
+
+/**
+ * Bundler RPC client for ERC-4337 user operations
+ */
+declare class BundlerClient {
+    private readonly rpcUrl;
+    private readonly config;
+    /**
+     * Creates a new BundlerClient instance
+     *
+     * @param rpcUrl - The bundler RPC URL
+     * @param config - Optional configuration for the client
+     */
+    constructor(rpcUrl: string, config?: BundlerClientConfig);
+    /**
+     * Estimates gas for a user operation
+     *
+     * @param userOp - The user operation to estimate gas for
+     * @param entryPoint - The entry point address
+     * @returns Gas estimates
+     * @throws BundlerError if the estimation fails
+     */
+    estimateUserOperationGas(userOp: Record<string, unknown>, entryPoint: string): Promise<GasEstimate>;
+    /**
+     * Sends a user operation to the bundler
+     *
+     * @param userOp - The user operation to send
+     * @param entryPoint - The entry point address
+     * @returns The user operation hash
+     * @throws BundlerError if sending fails
+     */
+    sendUserOperation(userOp: Record<string, unknown>, entryPoint: string): Promise<string>;
+    /**
+     * Gets the receipt for a user operation
+     *
+     * @param userOpHash - The user operation hash
+     * @returns The receipt or null if not found
+     * @throws BundlerError if the request fails
+     */
+    getUserOperationReceipt(userOpHash: string): Promise<UserOperationReceipt | null>;
+    /**
+     * Makes a JSON-RPC call to the bundler
+     *
+     * @param method - The RPC method name
+     * @param params - The method parameters
+     * @returns The result from the RPC call
+     * @throws BundlerError if the call fails
+     */
+    private call;
+}
+
+export { BundlerClient, type BundlerClientConfig, BundlerError, ExactEvmSchemeNetworkERC4337, type ExactEvmSchemeNetworkERC4337Config, type GasEstimate, type UserOperationReceipt };

package/dist/cjs/exact/facilitator/index.js

@@ -0,0 +1,355 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/exact/facilitator/index.ts
+var facilitator_exports = {};
+__export(facilitator_exports, {
+  BundlerClient: () => BundlerClient,
+  ExactEvmSchemeNetworkERC4337: () => ExactEvmSchemeNetworkERC4337
+});
+module.exports = __toCommonJS(facilitator_exports);
+
+// src/exact/facilitator/bundler/types.ts
+var BundlerError = class extends Error {
+  /**
+   * Creates a new BundlerError instance
+   *
+   * @param message - Error message
+   * @param options - Optional error details
+   * @param options.code - Error code from bundler
+   * @param options.data - Additional error data
+   * @param options.method - RPC method that failed
+   * @param options.bundlerUrl - Bundler URL that was called
+   * @param options.cause - Original error that caused this error
+   */
+  constructor(message, options) {
+    super(message);
+    this.name = "BundlerError";
+    this.code = options?.code;
+    this.data = options?.data;
+    this.method = options?.method;
+    this.bundlerUrl = options?.bundlerUrl;
+    if (options?.cause) {
+      this.cause = options.cause;
+    }
+  }
+};
+
+// src/exact/facilitator/bundler/client.ts
+var BundlerClient = class {
+  /**
+   * Creates a new BundlerClient instance
+   *
+   * @param rpcUrl - The bundler RPC URL
+   * @param config - Optional configuration for the client
+   */
+  constructor(rpcUrl, config) {
+    this.rpcUrl = rpcUrl;
+    this.config = {
+      timeout: config?.timeout ?? 1e4,
+      retries: config?.retries ?? 0
+    };
+  }
+  /**
+   * Estimates gas for a user operation
+   *
+   * @param userOp - The user operation to estimate gas for
+   * @param entryPoint - The entry point address
+   * @returns Gas estimates
+   * @throws BundlerError if the estimation fails
+   */
+  async estimateUserOperationGas(userOp, entryPoint) {
+    return this.call("eth_estimateUserOperationGas", [userOp, entryPoint]);
+  }
+  /**
+   * Sends a user operation to the bundler
+   *
+   * @param userOp - The user operation to send
+   * @param entryPoint - The entry point address
+   * @returns The user operation hash
+   * @throws BundlerError if sending fails
+   */
+  async sendUserOperation(userOp, entryPoint) {
+    return this.call("eth_sendUserOperation", [userOp, entryPoint]);
+  }
+  /**
+   * Gets the receipt for a user operation
+   *
+   * @param userOpHash - The user operation hash
+   * @returns The receipt or null if not found
+   * @throws BundlerError if the request fails
+   */
+  async getUserOperationReceipt(userOpHash) {
+    return this.call("eth_getUserOperationReceipt", [userOpHash]);
+  }
+  /**
+   * Makes a JSON-RPC call to the bundler
+   *
+   * @param method - The RPC method name
+   * @param params - The method parameters
+   * @returns The result from the RPC call
+   * @throws BundlerError if the call fails
+   */
+  async call(method, params) {
+    const requestPayload = {
+      jsonrpc: "2.0",
+      id: 1,
+      method,
+      params
+    };
+    let lastError;
+    const maxAttempts = this.config.retries + 1;
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        const res = await fetch(this.rpcUrl, {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify(requestPayload),
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!res.ok) {
+          throw new BundlerError(`Bundler HTTP error: ${res.status} ${res.statusText}`, {
+            method,
+            bundlerUrl: this.rpcUrl
+          });
+        }
+        const json = await res.json();
+        if (json.error) {
+          throw new BundlerError(json.error.message ?? "Bundler RPC error", {
+            code: json.error.code,
+            data: json.error.data,
+            method,
+            bundlerUrl: this.rpcUrl
+          });
+        }
+        if (json.result === void 0) {
+          throw new BundlerError("Bundler RPC returned no result", {
+            method,
+            bundlerUrl: this.rpcUrl
+          });
+        }
+        return json.result;
+      } catch (error) {
+        lastError = error instanceof Error ? error : new Error(String(error));
+        if (error instanceof Error && error.name === "AbortError") {
+          throw new BundlerError(`Bundler request timeout after ${this.config.timeout}ms`, {
+            method,
+            bundlerUrl: this.rpcUrl,
+            cause: error
+          });
+        }
+        if (attempt === maxAttempts - 1) {
+          if (error instanceof BundlerError) {
+            throw error;
+          }
+          throw new BundlerError(`Bundler request failed: ${lastError.message}`, {
+            method,
+            bundlerUrl: this.rpcUrl,
+            cause: lastError
+          });
+        }
+        await new Promise((resolve) => setTimeout(resolve, Math.pow(2, attempt) * 100));
+      }
+    }
+    throw new BundlerError("Bundler request failed after retries", {
+      method,
+      bundlerUrl: this.rpcUrl,
+      cause: lastError
+    });
+  }
+};
+
+// src/exact/facilitator/scheme.ts
+var ExactEvmSchemeNetworkERC4337 = class {
+  /**
+   * Creates a new ExactEvmSchemeNetworkERC4337 instance
+   *
+   * @param config - Optional configuration for the facilitator
+   */
+  constructor(config) {
+    this.scheme = "exact";
+    this.caipFamily = "eip155:*";
+    this.config = {
+      defaultBundlerUrl: config?.defaultBundlerUrl ?? "",
+      receiptPollTimeout: config?.receiptPollTimeout ?? 3e4,
+      receiptPollInterval: config?.receiptPollInterval ?? 1e3
+    };
+  }
+  /**
+   * Get mechanism-specific extra data for the supported kinds endpoint.
+   * Returns user operation capability if available.
+   *
+   * @param _ - The network identifier (unused, but required by interface)
+   * @returns User operation capability or undefined
+   */
+  getExtra(_) {
+    return void 0;
+  }
+  /**
+   * Get signer addresses used by this facilitator.
+   * For user operations, no facilitator signer is needed as the user signs the operation.
+   *
+   * @param _ - The network identifier (unused, but required by interface)
+   * @returns Empty array (no facilitator signer needed)
+   */
+  getSigners(_) {
+    return [];
+  }
+  /**
+   * Verifies a payment payload containing a user operation.
+   *
+   * This method:
+   * - Extracts the user operation from the payload
+   * - Gets the bundler URL from payload, requirements, or config
+   * - Estimates gas using the bundler to validate the user operation
+   *
+   * @param payload - The payment payload containing the user operation
+   * @param requirements - The payment requirements
+   * @returns Promise resolving to verification response
+   */
+  async verify(payload, requirements) {
+    const erc4337Payload = payload.payload;
+    if (!erc4337Payload.userOperation) {
+      return {
+        isValid: false,
+        invalidReason: "missing_user_operation",
+        payer: void 0
+      };
+    }
+    const userOp = erc4337Payload.userOperation;
+    const payer = userOp.sender;
+    const bundlerUrl = erc4337Payload.bundlerRpcUrl ?? requirements.extra?.userOperation?.bundlerUrl ?? this.config.defaultBundlerUrl;
+    if (!bundlerUrl) {
+      return {
+        isValid: false,
+        invalidReason: "missing_bundler_url",
+        payer
+      };
+    }
+    const entryPoint = erc4337Payload.entryPoint;
+    if (!entryPoint) {
+      return {
+        isValid: false,
+        invalidReason: "missing_entry_point",
+        payer
+      };
+    }
+    try {
+      const bundler = new BundlerClient(bundlerUrl);
+      await bundler.estimateUserOperationGas(userOp, entryPoint);
+      return {
+        isValid: true,
+        invalidReason: void 0,
+        payer
+      };
+    } catch {
+      return {
+        isValid: false,
+        invalidReason: "simulation_failed",
+        payer
+      };
+    }
+  }
+  /**
+   * Settles a payment by sending the user operation to the bundler.
+   *
+   * This method:
+   * - Re-verifies the payment (following original pattern)
+   * - Sends the user operation to the bundler
+   * - Polls for the receipt
+   * - Returns the transaction hash
+   *
+   * @param payload - The payment payload containing the user operation
+   * @param requirements - The payment requirements
+   * @returns Promise resolving to settlement response
+   */
+  async settle(payload, requirements) {
+    const erc4337Payload = payload.payload;
+    const verifyResult = await this.verify(payload, requirements);
+    if (!verifyResult.isValid) {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: verifyResult.invalidReason ?? "invalid",
+        payer: verifyResult.payer
+      };
+    }
+    const userOp = erc4337Payload.userOperation;
+    const payer = userOp.sender;
+    const bundlerUrl = erc4337Payload.bundlerRpcUrl ?? requirements.extra?.userOperation?.bundlerUrl ?? this.config.defaultBundlerUrl;
+    if (!bundlerUrl) {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: "missing_bundler_url",
+        payer
+      };
+    }
+    const entryPoint = erc4337Payload.entryPoint;
+    if (!entryPoint) {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: "missing_entry_point",
+        payer
+      };
+    }
+    try {
+      const bundler = new BundlerClient(bundlerUrl);
+      const userOpHash = await bundler.sendUserOperation(userOp, entryPoint);
+      const deadline = Date.now() + this.config.receiptPollTimeout;
+      let receipt = null;
+      while (Date.now() < deadline) {
+        receipt = await bundler.getUserOperationReceipt(userOpHash);
+        if (receipt) {
+          break;
+        }
+        await new Promise((resolve) => setTimeout(resolve, this.config.receiptPollInterval));
+      }
+      const txHash = receipt?.receipt?.transactionHash ?? receipt?.transactionHash ?? userOpHash;
+      return {
+        success: true,
+        network: payload.accepted.network,
+        transaction: txHash,
+        payer,
+        errorReason: void 0
+      };
+    } catch {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: "settlement_failed",
+        payer
+      };
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BundlerClient,
+  ExactEvmSchemeNetworkERC4337
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact/facilitator/index.ts","../../../../src/exact/facilitator/bundler/types.ts","../../../../src/exact/facilitator/bundler/client.ts","../../../../src/exact/facilitator/scheme.ts"],"sourcesContent":["export { ExactEvmSchemeNetworkERC4337 } from \"./scheme\";\nexport type { ExactEvmSchemeNetworkERC4337Config } from \"./scheme\";\nexport { BundlerClient } from \"./bundler/client\";\nexport type {\n  BundlerClientConfig,\n  BundlerError,\n  GasEstimate,\n  UserOperationReceipt,\n} from \"./bundler/types\";\nexport type { Erc4337Payload, UserOperation07Json } from \"./types\";\n","/**\n * Gas estimation response from bundler\n */\nexport interface GasEstimate {\n  [key: string]: unknown;\n  callGasLimit?: string;\n  verificationGasLimit?: string;\n  preVerificationGas?: string;\n  maxFeePerGas?: string;\n  maxPriorityFeePerGas?: string;\n  paymasterVerificationGasLimit?: string;\n  paymasterPostOpGasLimit?: string;\n}\n\n/**\n * User operation receipt from bundler\n */\nexport interface UserOperationReceipt {\n  [key: string]: unknown;\n  userOpHash: string;\n  entryPoint: string;\n  sender: string;\n  nonce: string;\n  paymaster?: string;\n  actualGasCost: string;\n  actualGasUsed: string;\n  success: boolean;\n  reason?: string;\n  logs: unknown[];\n  receipt?: {\n    [key: string]: unknown;\n    transactionHash: string;\n  };\n  transactionHash?: string;\n}\n\n/**\n * Configuration for bundler client\n */\nexport interface BundlerClientConfig {\n  /**\n   * Timeout for RPC calls in milliseconds\n   *\n   * @default 10000\n   */\n  timeout?: number;\n  /**\n   * Number of retries for failed requests\n   *\n   * @default 0\n   */\n  retries?: number;\n}\n\n/**\n * JSON-RPC error response\n */\nexport interface JsonRpcError {\n  message?: string;\n  code?: number;\n  data?: unknown;\n}\n\n/**\n * JSON-RPC response wrapper\n */\nexport interface JsonRpcResponse<T> {\n  result?: T;\n  error?: JsonRpcError;\n}\n\n/**\n * Custom error class for bundler-related errors\n */\nexport class BundlerError extends Error {\n  readonly code?: number;\n  readonly data?: unknown;\n  readonly method?: string;\n  readonly bundlerUrl?: string;\n\n  /**\n   * Creates a new BundlerError instance\n   *\n   * @param message - Error message\n   * @param options - Optional error details\n   * @param options.code - Error code from bundler\n   * @param options.data - Additional error data\n   * @param options.method - RPC method that failed\n   * @param options.bundlerUrl - Bundler URL that was called\n   * @param options.cause - Original error that caused this error\n   */\n  constructor(\n    message: string,\n    options?: {\n      code?: number;\n      data?: unknown;\n      method?: string;\n      bundlerUrl?: string;\n      cause?: Error;\n    },\n  ) {\n    super(message);\n    this.name = \"BundlerError\";\n    this.code = options?.code;\n    this.data = options?.data;\n    this.method = options?.method;\n    this.bundlerUrl = options?.bundlerUrl;\n    if (options?.cause) {\n      // @ts-expect-error - cause is a standard Error property but not in all TypeScript versions\n      this.cause = options.cause;\n    }\n  }\n}\n","import type {\n  BundlerClientConfig,\n  GasEstimate,\n  JsonRpcResponse,\n  UserOperationReceipt,\n} from \"./types\";\nimport { BundlerError } from \"./types\";\n\n/**\n * Bundler RPC client for ERC-4337 user operations\n */\nexport class BundlerClient {\n  private readonly rpcUrl: string;\n  private readonly config: Required<BundlerClientConfig>;\n\n  /**\n   * Creates a new BundlerClient instance\n   *\n   * @param rpcUrl - The bundler RPC URL\n   * @param config - Optional configuration for the client\n   */\n  constructor(rpcUrl: string, config?: BundlerClientConfig) {\n    this.rpcUrl = rpcUrl;\n    this.config = {\n      timeout: config?.timeout ?? 10_000,\n      retries: config?.retries ?? 0,\n    };\n  }\n\n  /**\n   * Estimates gas for a user operation\n   *\n   * @param userOp - The user operation to estimate gas for\n   * @param entryPoint - The entry point address\n   * @returns Gas estimates\n   * @throws BundlerError if the estimation fails\n   */\n  async estimateUserOperationGas(\n    userOp: Record<string, unknown>,\n    entryPoint: string,\n  ): Promise<GasEstimate> {\n    return this.call<GasEstimate>(\"eth_estimateUserOperationGas\", [userOp, entryPoint]);\n  }\n\n  /**\n   * Sends a user operation to the bundler\n   *\n   * @param userOp - The user operation to send\n   * @param entryPoint - The entry point address\n   * @returns The user operation hash\n   * @throws BundlerError if sending fails\n   */\n  async sendUserOperation(userOp: Record<string, unknown>, entryPoint: string): Promise<string> {\n    return this.call<string>(\"eth_sendUserOperation\", [userOp, entryPoint]);\n  }\n\n  /**\n   * Gets the receipt for a user operation\n   *\n   * @param userOpHash - The user operation hash\n   * @returns The receipt or null if not found\n   * @throws BundlerError if the request fails\n   */\n  async getUserOperationReceipt(userOpHash: string): Promise<UserOperationReceipt | null> {\n    return this.call<UserOperationReceipt | null>(\"eth_getUserOperationReceipt\", [userOpHash]);\n  }\n\n  /**\n   * Makes a JSON-RPC call to the bundler\n   *\n   * @param method - The RPC method name\n   * @param params - The method parameters\n   * @returns The result from the RPC call\n   * @throws BundlerError if the call fails\n   */\n  private async call<T>(method: string, params: unknown[]): Promise<T> {\n    const requestPayload = {\n      jsonrpc: \"2.0\" as const,\n      id: 1,\n      method,\n      params,\n    };\n\n    let lastError: Error | undefined;\n    const maxAttempts = this.config.retries + 1;\n\n    for (let attempt = 0; attempt < maxAttempts; attempt++) {\n      try {\n        const controller = new AbortController();\n        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\n\n        const res = await fetch(this.rpcUrl, {\n          method: \"POST\",\n          headers: { \"content-type\": \"application/json\" },\n          body: JSON.stringify(requestPayload),\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (!res.ok) {\n          throw new BundlerError(`Bundler HTTP error: ${res.status} ${res.statusText}`, {\n            method,\n            bundlerUrl: this.rpcUrl,\n          });\n        }\n\n        const json = (await res.json()) as JsonRpcResponse<T>;\n\n        if (json.error) {\n          throw new BundlerError(json.error.message ?? \"Bundler RPC error\", {\n            code: json.error.code,\n            data: json.error.data,\n            method,\n            bundlerUrl: this.rpcUrl,\n          });\n        }\n\n        if (json.result === undefined) {\n          throw new BundlerError(\"Bundler RPC returned no result\", {\n            method,\n            bundlerUrl: this.rpcUrl,\n          });\n        }\n\n        return json.result;\n      } catch (error) {\n        lastError = error instanceof Error ? error : new Error(String(error));\n\n        // If it's an abort error (timeout), don't retry\n        if (error instanceof Error && error.name === \"AbortError\") {\n          throw new BundlerError(`Bundler request timeout after ${this.config.timeout}ms`, {\n            method,\n            bundlerUrl: this.rpcUrl,\n            cause: error,\n          });\n        }\n\n        // If this is the last attempt, throw the error\n        if (attempt === maxAttempts - 1) {\n          if (error instanceof BundlerError) {\n            throw error;\n          }\n          throw new BundlerError(`Bundler request failed: ${lastError.message}`, {\n            method,\n            bundlerUrl: this.rpcUrl,\n            cause: lastError,\n          });\n        }\n\n        // Wait before retrying (exponential backoff)\n        await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 100));\n      }\n    }\n\n    // This should never be reached, but TypeScript needs it\n    throw new BundlerError(\"Bundler request failed after retries\", {\n      method,\n      bundlerUrl: this.rpcUrl,\n      cause: lastError,\n    });\n  }\n}\n","import type {\n  Network,\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@x402/core/types\";\nimport { BundlerClient } from \"./bundler/client\";\nimport type { Erc4337Payload } from \"./types\";\n\n/**\n * Configuration for the ERC-4337 facilitator\n */\nexport interface ExactEvmSchemeNetworkERC4337Config {\n  /**\n   * Default bundler URL to use if not provided in payload or requirements\n   */\n\n  defaultBundlerUrl?: string;\n\n  /**\n   * Timeout for receipt polling in milliseconds\n   *\n   * @default 30000\n   */\n\n  receiptPollTimeout?: number;\n\n  /**\n   * Interval for receipt polling in milliseconds\n   *\n   * @default 1000\n   */\n\n  receiptPollInterval?: number;\n}\n\n/**\n * Enhanced ExactEvmScheme facilitator that supports UserOperation (ERC-4337) payments.\n *\n * This facilitator implements the `SchemeNetworkFacilitator` interface and handles\n * verification and settlement of user operations through a bundler.\n *\n * @example\n * ```typescript\n * import { ExactEvmSchemeNetworkERC4337 } from '@introspectivelabs/x402-evm/exact/facilitator';\n * import { x402Facilitator } from '@x402/core/facilitator';\n *\n * const facilitator = new x402Facilitator()\n *   .register('eip155:84532', new ExactEvmSchemeNetworkERC4337());\n * ```\n */\nexport class ExactEvmSchemeNetworkERC4337 implements SchemeNetworkFacilitator {\n  readonly scheme = \"exact\";\n  readonly caipFamily = \"eip155:*\";\n  private readonly config: Required<ExactEvmSchemeNetworkERC4337Config>;\n\n  /**\n   * Creates a new ExactEvmSchemeNetworkERC4337 instance\n   *\n   * @param config - Optional configuration for the facilitator\n   */\n  constructor(config?: ExactEvmSchemeNetworkERC4337Config) {\n    this.config = {\n      defaultBundlerUrl: config?.defaultBundlerUrl ?? \"\",\n      receiptPollTimeout: config?.receiptPollTimeout ?? 30_000,\n      receiptPollInterval: config?.receiptPollInterval ?? 1_000,\n    };\n  }\n\n  /**\n   * Get mechanism-specific extra data for the supported kinds endpoint.\n   * Returns user operation capability if available.\n   *\n   * @param _ - The network identifier (unused, but required by interface)\n   * @returns User operation capability or undefined\n   */\n  getExtra(_: Network): Record<string, unknown> | undefined {\n    // Return undefined - user operation capability should be set by the server\n    // This follows the pattern of the original ExactEvmScheme\n    return undefined;\n  }\n\n  /**\n   * Get signer addresses used by this facilitator.\n   * For user operations, no facilitator signer is needed as the user signs the operation.\n   *\n   * @param _ - The network identifier (unused, but required by interface)\n   * @returns Empty array (no facilitator signer needed)\n   */\n  getSigners(_: string): string[] {\n    return [];\n  }\n\n  /**\n   * Verifies a payment payload containing a user operation.\n   *\n   * This method:\n   * - Extracts the user operation from the payload\n   * - Gets the bundler URL from payload, requirements, or config\n   * - Estimates gas using the bundler to validate the user operation\n   *\n   * @param payload - The payment payload containing the user operation\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to verification response\n   */\n  async verify(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<VerifyResponse> {\n    const erc4337Payload = payload.payload as Erc4337Payload;\n\n    // Extract user operation\n    if (!erc4337Payload.userOperation) {\n      return {\n        isValid: false,\n        invalidReason: \"missing_user_operation\",\n        payer: undefined,\n      };\n    }\n\n    const userOp = erc4337Payload.userOperation;\n    const payer = userOp.sender;\n\n    // Get bundler URL from payload, requirements, or config\n    const bundlerUrl =\n      erc4337Payload.bundlerRpcUrl ??\n      (requirements.extra?.userOperation as { bundlerUrl?: string } | undefined)?.bundlerUrl ??\n      this.config.defaultBundlerUrl;\n\n    if (!bundlerUrl) {\n      return {\n        isValid: false,\n        invalidReason: \"missing_bundler_url\",\n        payer,\n      };\n    }\n\n    // Get entry point\n    const entryPoint = erc4337Payload.entryPoint;\n    if (!entryPoint) {\n      return {\n        isValid: false,\n        invalidReason: \"missing_entry_point\",\n        payer,\n      };\n    }\n\n    // Verify by estimating gas through bundler\n    try {\n      const bundler = new BundlerClient(bundlerUrl);\n      await bundler.estimateUserOperationGas(userOp, entryPoint);\n\n      return {\n        isValid: true,\n        invalidReason: undefined,\n        payer,\n      };\n    } catch {\n      return {\n        isValid: false,\n        invalidReason: \"simulation_failed\",\n        payer,\n      };\n    }\n  }\n\n  /**\n   * Settles a payment by sending the user operation to the bundler.\n   *\n   * This method:\n   * - Re-verifies the payment (following original pattern)\n   * - Sends the user operation to the bundler\n   * - Polls for the receipt\n   * - Returns the transaction hash\n   *\n   * @param payload - The payment payload containing the user operation\n   * @param requirements - The payment requirements\n   * @returns Promise resolving to settlement response\n   */\n  async settle(\n    payload: PaymentPayload,\n    requirements: PaymentRequirements,\n  ): Promise<SettleResponse> {\n    const erc4337Payload = payload.payload as Erc4337Payload;\n\n    // Re-verify before settling (following original pattern)\n    const verifyResult = await this.verify(payload, requirements);\n    if (!verifyResult.isValid) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: \"\",\n        errorReason: verifyResult.invalidReason ?? \"invalid\",\n        payer: verifyResult.payer,\n      };\n    }\n\n    const userOp = erc4337Payload.userOperation;\n    const payer = userOp.sender;\n\n    // Get bundler URL\n    const bundlerUrl =\n      erc4337Payload.bundlerRpcUrl ??\n      (requirements.extra?.userOperation as { bundlerUrl?: string } | undefined)?.bundlerUrl ??\n      this.config.defaultBundlerUrl;\n\n    if (!bundlerUrl) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: \"\",\n        errorReason: \"missing_bundler_url\",\n        payer,\n      };\n    }\n\n    const entryPoint = erc4337Payload.entryPoint;\n    if (!entryPoint) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: \"\",\n        errorReason: \"missing_entry_point\",\n        payer,\n      };\n    }\n\n    try {\n      const bundler = new BundlerClient(bundlerUrl);\n\n      // Send user operation\n      const userOpHash = await bundler.sendUserOperation(userOp, entryPoint);\n\n      // Poll for receipt\n      const deadline = Date.now() + this.config.receiptPollTimeout;\n      let receipt = null;\n\n      while (Date.now() < deadline) {\n        receipt = await bundler.getUserOperationReceipt(userOpHash);\n        if (receipt) {\n          break;\n        }\n        await new Promise(resolve => setTimeout(resolve, this.config.receiptPollInterval));\n      }\n\n      // Extract transaction hash from receipt\n      const txHash = receipt?.receipt?.transactionHash ?? receipt?.transactionHash ?? userOpHash;\n\n      return {\n        success: true,\n        network: payload.accepted.network,\n        transaction: txHash,\n        payer,\n        errorReason: undefined,\n      };\n    } catch {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: \"\",\n        errorReason: \"settlement_failed\",\n        payer,\n      };\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC0EO,IAAM,eAAN,cAA2B,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBtC,YACE,SACA,SAOA;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO,SAAS;AACrB,SAAK,OAAO,SAAS;AACrB,SAAK,SAAS,SAAS;AACvB,SAAK,aAAa,SAAS;AAC3B,QAAI,SAAS,OAAO;AAElB,WAAK,QAAQ,QAAQ;AAAA,IACvB;AAAA,EACF;AACF;;;ACrGO,IAAM,gBAAN,MAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUzB,YAAY,QAAgB,QAA8B;AACxD,SAAK,SAAS;AACd,SAAK,SAAS;AAAA,MACZ,SAAS,QAAQ,WAAW;AAAA,MAC5B,SAAS,QAAQ,WAAW;AAAA,IAC9B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,yBACJ,QACA,YACsB;AACtB,WAAO,KAAK,KAAkB,gCAAgC,CAAC,QAAQ,UAAU,CAAC;AAAA,EACpF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,kBAAkB,QAAiC,YAAqC;AAC5F,WAAO,KAAK,KAAa,yBAAyB,CAAC,QAAQ,UAAU,CAAC;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,wBAAwB,YAA0D;AACtF,WAAO,KAAK,KAAkC,+BAA+B,CAAC,UAAU,CAAC;AAAA,EAC3F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAc,KAAQ,QAAgB,QAA+B;AACnE,UAAM,iBAAiB;AAAA,MACrB,SAAS;AAAA,MACT,IAAI;AAAA,MACJ;AAAA,MACA;AAAA,IACF;AAEA,QAAI;AACJ,UAAM,cAAc,KAAK,OAAO,UAAU;AAE1C,aAAS,UAAU,GAAG,UAAU,aAAa,WAAW;AACtD,UAAI;AACF,cAAM,aAAa,IAAI,gBAAgB;AACvC,cAAM,YAAY,WAAW,MAAM,WAAW,MAAM,GAAG,KAAK,OAAO,OAAO;AAE1E,cAAM,MAAM,MAAM,MAAM,KAAK,QAAQ;AAAA,UACnC,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,UAC9C,MAAM,KAAK,UAAU,cAAc;AAAA,UACnC,QAAQ,WAAW;AAAA,QACrB,CAAC;AAED,qBAAa,SAAS;AAEtB,YAAI,CAAC,IAAI,IAAI;AACX,gBAAM,IAAI,aAAa,uBAAuB,IAAI,MAAM,IAAI,IAAI,UAAU,IAAI;AAAA,YAC5E;AAAA,YACA,YAAY,KAAK;AAAA,UACnB,CAAC;AAAA,QACH;AAEA,cAAM,OAAQ,MAAM,IAAI,KAAK;AAE7B,YAAI,KAAK,OAAO;AACd,gBAAM,IAAI,aAAa,KAAK,MAAM,WAAW,qBAAqB;AAAA,YAChE,MAAM,KAAK,MAAM;AAAA,YACjB,MAAM,KAAK,MAAM;AAAA,YACjB;AAAA,YACA,YAAY,KAAK;AAAA,UACnB,CAAC;AAAA,QACH;AAEA,YAAI,KAAK,WAAW,QAAW;AAC7B,gBAAM,IAAI,aAAa,kCAAkC;AAAA,YACvD;AAAA,YACA,YAAY,KAAK;AAAA,UACnB,CAAC;AAAA,QACH;AAEA,eAAO,KAAK;AAAA,MACd,SAAS,OAAO;AACd,oBAAY,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAGpE,YAAI,iBAAiB,SAAS,MAAM,SAAS,cAAc;AACzD,gBAAM,IAAI,aAAa,iCAAiC,KAAK,OAAO,OAAO,MAAM;AAAA,YAC/E;AAAA,YACA,YAAY,KAAK;AAAA,YACjB,OAAO;AAAA,UACT,CAAC;AAAA,QACH;AAGA,YAAI,YAAY,cAAc,GAAG;AAC/B,cAAI,iBAAiB,cAAc;AACjC,kBAAM;AAAA,UACR;AACA,gBAAM,IAAI,aAAa,2BAA2B,UAAU,OAAO,IAAI;AAAA,YACrE;AAAA,YACA,YAAY,KAAK;AAAA,YACjB,OAAO;AAAA,UACT,CAAC;AAAA,QACH;AAGA,cAAM,IAAI,QAAQ,aAAW,WAAW,SAAS,KAAK,IAAI,GAAG,OAAO,IAAI,GAAG,CAAC;AAAA,MAC9E;AAAA,IACF;AAGA,UAAM,IAAI,aAAa,wCAAwC;AAAA,MAC7D;AAAA,MACA,YAAY,KAAK;AAAA,MACjB,OAAO;AAAA,IACT,CAAC;AAAA,EACH;AACF;;;AC7GO,IAAM,+BAAN,MAAuE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAU5E,YAAY,QAA6C;AATzD,SAAS,SAAS;AAClB,SAAS,aAAa;AASpB,SAAK,SAAS;AAAA,MACZ,mBAAmB,QAAQ,qBAAqB;AAAA,MAChD,oBAAoB,QAAQ,sBAAsB;AAAA,MAClD,qBAAqB,QAAQ,uBAAuB;AAAA,IACtD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,SAAS,GAAiD;AAGxD,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,GAAqB;AAC9B,WAAO,CAAC;AAAA,EACV;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,iBAAiB,QAAQ;AAG/B,QAAI,CAAC,eAAe,eAAe;AACjC,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf,OAAO;AAAA,MACT;AAAA,IACF;AAEA,UAAM,SAAS,eAAe;AAC9B,UAAM,QAAQ,OAAO;AAGrB,UAAM,aACJ,eAAe,iBACd,aAAa,OAAO,eAAuD,cAC5E,KAAK,OAAO;AAEd,QAAI,CAAC,YAAY;AACf,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAGA,UAAM,aAAa,eAAe;AAClC,QAAI,CAAC,YAAY;AACf,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAGA,QAAI;AACF,YAAM,UAAU,IAAI,cAAc,UAAU;AAC5C,YAAM,QAAQ,yBAAyB,QAAQ,UAAU;AAEzD,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF,QAAQ;AACN,aAAO;AAAA,QACL,SAAS;AAAA,QACT,eAAe;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,OACJ,SACA,cACyB;AACzB,UAAM,iBAAiB,QAAQ;AAG/B,UAAM,eAAe,MAAM,KAAK,OAAO,SAAS,YAAY;AAC5D,QAAI,CAAC,aAAa,SAAS;AACzB,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb,aAAa,aAAa,iBAAiB;AAAA,QAC3C,OAAO,aAAa;AAAA,MACtB;AAAA,IACF;AAEA,UAAM,SAAS,eAAe;AAC9B,UAAM,QAAQ,OAAO;AAGrB,UAAM,aACJ,eAAe,iBACd,aAAa,OAAO,eAAuD,cAC5E,KAAK,OAAO;AAEd,QAAI,CAAC,YAAY;AACf,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb,aAAa;AAAA,QACb;AAAA,MACF;AAAA,IACF;AAEA,UAAM,aAAa,eAAe;AAClC,QAAI,CAAC,YAAY;AACf,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb,aAAa;AAAA,QACb;AAAA,MACF;AAAA,IACF;AAEA,QAAI;AACF,YAAM,UAAU,IAAI,cAAc,UAAU;AAG5C,YAAM,aAAa,MAAM,QAAQ,kBAAkB,QAAQ,UAAU;AAGrE,YAAM,WAAW,KAAK,IAAI,IAAI,KAAK,OAAO;AAC1C,UAAI,UAAU;AAEd,aAAO,KAAK,IAAI,IAAI,UAAU;AAC5B,kBAAU,MAAM,QAAQ,wBAAwB,UAAU;AAC1D,YAAI,SAAS;AACX;AAAA,QACF;AACA,cAAM,IAAI,QAAQ,aAAW,WAAW,SAAS,KAAK,OAAO,mBAAmB,CAAC;AAAA,MACnF;AAGA,YAAM,SAAS,SAAS,SAAS,mBAAmB,SAAS,mBAAmB;AAEhF,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb;AAAA,QACA,aAAa;AAAA,MACf;AAAA,IACF,QAAQ;AACN,aAAO;AAAA,QACL,SAAS;AAAA,QACT,SAAS,QAAQ,SAAS;AAAA,QAC1B,aAAa;AAAA,QACb,aAAa;AAAA,QACb;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/cjs/exact/server/index.d.ts

@@ -0,0 +1,47 @@
+import { PaymentRequirements, Network } from '@x402/core/types';
+import { ExactEvmScheme } from '@x402/evm/exact/server';
+
+/**
+ * Enhanced ExactEvmScheme that preserves UserOperation capability in payment requirements.
+ *
+ * This class extends ExactEvmScheme and enhances the `enhancePaymentRequirements` method
+ * to preserve `userOperation` from `paymentRequirements.extra`. This ensures that when routes
+ * are transformed using `transformRoutesForUserOperation`, the userOperation data flows through
+ * the entire payment requirements pipeline.
+ *
+ * @example
+ * ```typescript
+ * import { ExactEvmSchemeERC4337 } from '@introspectivelabs/x402-evm/exact/server';
+ * import { x402ResourceServer } from '@x402/core/server';
+ *
+ * const schemeServer = new ExactEvmSchemeERC4337();
+ * const server = new x402ResourceServer(facilitatorClient);
+ * server.register('eip155:84532', schemeServer);
+ * ```
+ */
+declare class ExactEvmSchemeERC4337 extends ExactEvmScheme {
+    /**
+     * Enhance payment requirements while preserving UserOperation capability.
+     *
+     * This method calls the parent's enhancePaymentRequirements and then ensures
+     * that any userOperation from the original paymentRequirements.extra is preserved
+     * in the returned requirements.
+     *
+     * @param paymentRequirements - The base payment requirements
+     * @param supportedKind - The supported kind from facilitator
+     * @param supportedKind.x402Version - The x402 version supported by the facilitator
+     * @param supportedKind.scheme - The scheme supported by the facilitator
+     * @param supportedKind.network - The network supported by the facilitator
+     * @param supportedKind.extra - The extra supported by the facilitator
+     * @param extensionKeys - Extension keys supported by the facilitator
+     * @returns Enhanced payment requirements with userOperation preserved
+     */
+    enhancePaymentRequirements(paymentRequirements: PaymentRequirements, supportedKind: {
+        x402Version: number;
+        scheme: string;
+        network: Network;
+        extra?: Record<string, unknown>;
+    }, extensionKeys: string[]): Promise<PaymentRequirements>;
+}
+
+export { ExactEvmSchemeERC4337 };