@t402/evm 2.0.0

package/dist/esm/exact/facilitator/index.d.mts

@@ -0,0 +1,118 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, VerifyResponse, SettleResponse, Network } from '@t402/core/types';
+import { F as FacilitatorEvmSigner } from '../../signer-BkcAzwYi.mjs';
+import { t402Facilitator } from '@t402/core/facilitator';
+
+interface ExactEvmSchemeConfig {
+    /**
+     * If enabled, the facilitator will deploy ERC-4337 smart wallets
+     * via EIP-6492 when encountering undeployed contract signatures.
+     *
+     * @default false
+     */
+    deployERC4337WithEIP6492?: boolean;
+}
+/**
+ * EVM facilitator implementation for the Exact payment scheme.
+ */
+declare class ExactEvmScheme implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "exact";
+    readonly caipFamily = "eip155:*";
+    private readonly config;
+    /**
+     * Creates a new ExactEvmFacilitator instance.
+     *
+     * @param signer - The EVM signer for facilitator operations
+     * @param config - Optional configuration for the facilitator
+     */
+    constructor(signer: FacilitatorEvmSigner, config?: ExactEvmSchemeConfig);
+    /**
+     * Get mechanism-specific extra data for the supported kinds endpoint.
+     * For EVM, no extra data is needed.
+     *
+     * @param _ - The network identifier (unused for EVM)
+     * @returns undefined (EVM has no extra data)
+     */
+    getExtra(_: string): Record<string, unknown> | undefined;
+    /**
+     * Get signer addresses used by this facilitator.
+     * Returns all addresses this facilitator can use for signing/settling transactions.
+     *
+     * @param _ - The network identifier (unused for EVM, addresses are network-agnostic)
+     * @returns Array of facilitator wallet addresses
+     */
+    getSigners(_: string): string[];
+    /**
+     * Verifies a payment payload.
+     *
+     * @param payload - The payment payload to verify
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to verification response
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements): Promise<VerifyResponse>;
+    /**
+     * Settles a payment by executing the transfer.
+     *
+     * @param payload - The payment payload to settle
+     * @param requirements - The payment requirements
+     * @returns Promise resolving to settlement response
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements): Promise<SettleResponse>;
+}
+
+/**
+ * Configuration options for registering EVM schemes to an t402Facilitator
+ */
+interface EvmFacilitatorConfig {
+    /**
+     * The EVM signer for facilitator operations (verify and settle)
+     */
+    signer: FacilitatorEvmSigner;
+    /**
+     * Networks to register (single network or array of networks)
+     * Examples: "eip155:84532", ["eip155:84532", "eip155:1"]
+     */
+    networks: Network | Network[];
+    /**
+     * If enabled, the facilitator will deploy ERC-4337 smart wallets
+     * via EIP-6492 when encountering undeployed contract signatures.
+     *
+     * @default false
+     */
+    deployERC4337WithEIP6492?: boolean;
+}
+/**
+ * Registers EVM exact payment schemes to an t402Facilitator instance.
+ *
+ * This function registers:
+ * - V2: Specified networks with ExactEvmScheme
+ * - V1: All supported EVM networks with ExactEvmSchemeV1
+ *
+ * @param facilitator - The t402Facilitator instance to register schemes to
+ * @param config - Configuration for EVM facilitator registration
+ * @returns The facilitator instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactEvmScheme } from "@t402/evm/exact/facilitator/register";
+ * import { t402Facilitator } from "@t402/core/facilitator";
+ * import { createPublicClient, createWalletClient } from "viem";
+ *
+ * const facilitator = new t402Facilitator();
+ *
+ * // Single network
+ * registerExactEvmScheme(facilitator, {
+ *   signer: combinedClient,
+ *   networks: "eip155:84532"  // Base Sepolia
+ * });
+ *
+ * // Multiple networks (will auto-derive eip155:* pattern)
+ * registerExactEvmScheme(facilitator, {
+ *   signer: combinedClient,
+ *   networks: ["eip155:84532", "eip155:1"]  // Base Sepolia and Mainnet
+ * });
+ * ```
+ */
+declare function registerExactEvmScheme(facilitator: t402Facilitator, config: EvmFacilitatorConfig): t402Facilitator;
+
+export { type EvmFacilitatorConfig, ExactEvmScheme, type ExactEvmSchemeConfig, registerExactEvmScheme };

package/dist/esm/exact/facilitator/index.mjs

@@ -0,0 +1,324 @@
+import {
+  NETWORKS
+} from "../../chunk-QLXM7BIB.mjs";
+import "../../chunk-JBWWBRYY.mjs";
+import {
+  ExactEvmSchemeV1
+} from "../../chunk-ACDQ5QNT.mjs";
+import {
+  authorizationTypes,
+  eip3009ABI
+} from "../../chunk-XYKAO6KJ.mjs";
+
+// src/exact/facilitator/scheme.ts
+import { getAddress, isAddressEqual, parseErc6492Signature, parseSignature } from "viem";
+var ExactEvmScheme = class {
+  /**
+   * Creates a new ExactEvmFacilitator instance.
+   *
+   * @param signer - The EVM signer for facilitator operations
+   * @param config - Optional configuration for the facilitator
+   */
+  constructor(signer, config) {
+    this.signer = signer;
+    this.scheme = "exact";
+    this.caipFamily = "eip155:*";
+    this.config = {
+      deployERC4337WithEIP6492: config?.deployERC4337WithEIP6492 ?? false
+    };
+  }
+  /**
+   * Get mechanism-specific extra data for the supported kinds endpoint.
+   * For EVM, no extra data is needed.
+   *
+   * @param _ - The network identifier (unused for EVM)
+   * @returns undefined (EVM has no extra data)
+   */
+  getExtra(_) {
+    return void 0;
+  }
+  /**
+   * Get signer addresses used by this facilitator.
+   * Returns all addresses this facilitator can use for signing/settling transactions.
+   *
+   * @param _ - The network identifier (unused for EVM, addresses are network-agnostic)
+   * @returns Array of facilitator wallet addresses
+   */
+  getSigners(_) {
+    return [...this.signer.getAddresses()];
+  }
+  /**
+   * Verifies a payment payload.
+   *
+   * @param payload - The payment payload to verify
+   * @param requirements - The payment requirements
+   * @returns Promise resolving to verification response
+   */
+  async verify(payload, requirements) {
+    const exactEvmPayload = payload.payload;
+    if (payload.accepted.scheme !== "exact" || requirements.scheme !== "exact") {
+      return {
+        isValid: false,
+        invalidReason: "unsupported_scheme",
+        payer: exactEvmPayload.authorization.from
+      };
+    }
+    if (!requirements.extra?.name || !requirements.extra?.version) {
+      return {
+        isValid: false,
+        invalidReason: "missing_eip712_domain",
+        payer: exactEvmPayload.authorization.from
+      };
+    }
+    const { name, version } = requirements.extra;
+    const erc20Address = getAddress(requirements.asset);
+    if (payload.accepted.network !== requirements.network) {
+      return {
+        isValid: false,
+        invalidReason: "network_mismatch",
+        payer: exactEvmPayload.authorization.from
+      };
+    }
+    const permitTypedData = {
+      types: authorizationTypes,
+      primaryType: "TransferWithAuthorization",
+      domain: {
+        name,
+        version,
+        chainId: parseInt(requirements.network.split(":")[1]),
+        verifyingContract: erc20Address
+      },
+      message: {
+        from: exactEvmPayload.authorization.from,
+        to: exactEvmPayload.authorization.to,
+        value: BigInt(exactEvmPayload.authorization.value),
+        validAfter: BigInt(exactEvmPayload.authorization.validAfter),
+        validBefore: BigInt(exactEvmPayload.authorization.validBefore),
+        nonce: exactEvmPayload.authorization.nonce
+      }
+    };
+    try {
+      const recoveredAddress = await this.signer.verifyTypedData({
+        address: exactEvmPayload.authorization.from,
+        ...permitTypedData,
+        signature: exactEvmPayload.signature
+      });
+      if (!recoveredAddress) {
+        return {
+          isValid: false,
+          invalidReason: "invalid_exact_evm_payload_signature",
+          payer: exactEvmPayload.authorization.from
+        };
+      }
+    } catch {
+      const signature = exactEvmPayload.signature;
+      const signatureLength = signature.startsWith("0x") ? signature.length - 2 : signature.length;
+      const isSmartWallet = signatureLength > 130;
+      if (isSmartWallet) {
+        const payerAddress = exactEvmPayload.authorization.from;
+        const bytecode = await this.signer.getCode({ address: payerAddress });
+        if (!bytecode || bytecode === "0x") {
+          const erc6492Data = parseErc6492Signature(signature);
+          const hasDeploymentInfo = erc6492Data.address && erc6492Data.data && !isAddressEqual(erc6492Data.address, "0x0000000000000000000000000000000000000000");
+          if (!hasDeploymentInfo) {
+            return {
+              isValid: false,
+              invalidReason: "invalid_exact_evm_payload_undeployed_smart_wallet",
+              payer: payerAddress
+            };
+          }
+        } else {
+          return {
+            isValid: false,
+            invalidReason: "invalid_exact_evm_payload_signature",
+            payer: exactEvmPayload.authorization.from
+          };
+        }
+      } else {
+        return {
+          isValid: false,
+          invalidReason: "invalid_exact_evm_payload_signature",
+          payer: exactEvmPayload.authorization.from
+        };
+      }
+    }
+    if (getAddress(exactEvmPayload.authorization.to) !== getAddress(requirements.payTo)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_exact_evm_payload_recipient_mismatch",
+        payer: exactEvmPayload.authorization.from
+      };
+    }
+    const now = Math.floor(Date.now() / 1e3);
+    if (BigInt(exactEvmPayload.authorization.validBefore) < BigInt(now + 6)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_exact_evm_payload_authorization_valid_before",
+        payer: exactEvmPayload.authorization.from
+      };
+    }
+    if (BigInt(exactEvmPayload.authorization.validAfter) > BigInt(now)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_exact_evm_payload_authorization_valid_after",
+        payer: exactEvmPayload.authorization.from
+      };
+    }
+    try {
+      const balance = await this.signer.readContract({
+        address: erc20Address,
+        abi: eip3009ABI,
+        functionName: "balanceOf",
+        args: [exactEvmPayload.authorization.from]
+      });
+      if (BigInt(balance) < BigInt(requirements.amount)) {
+        return {
+          isValid: false,
+          invalidReason: "insufficient_funds",
+          payer: exactEvmPayload.authorization.from
+        };
+      }
+    } catch {
+    }
+    if (BigInt(exactEvmPayload.authorization.value) < BigInt(requirements.amount)) {
+      return {
+        isValid: false,
+        invalidReason: "invalid_exact_evm_payload_authorization_value",
+        payer: exactEvmPayload.authorization.from
+      };
+    }
+    return {
+      isValid: true,
+      invalidReason: void 0,
+      payer: exactEvmPayload.authorization.from
+    };
+  }
+  /**
+   * Settles a payment by executing the transfer.
+   *
+   * @param payload - The payment payload to settle
+   * @param requirements - The payment requirements
+   * @returns Promise resolving to settlement response
+   */
+  async settle(payload, requirements) {
+    const exactEvmPayload = payload.payload;
+    const valid = await this.verify(payload, requirements);
+    if (!valid.isValid) {
+      return {
+        success: false,
+        network: payload.accepted.network,
+        transaction: "",
+        errorReason: valid.invalidReason ?? "invalid_scheme",
+        payer: exactEvmPayload.authorization.from
+      };
+    }
+    try {
+      const parseResult = parseErc6492Signature(exactEvmPayload.signature);
+      const { signature, address: factoryAddress, data: factoryCalldata } = parseResult;
+      if (this.config.deployERC4337WithEIP6492 && factoryAddress && factoryCalldata && !isAddressEqual(factoryAddress, "0x0000000000000000000000000000000000000000")) {
+        const payerAddress = exactEvmPayload.authorization.from;
+        const bytecode = await this.signer.getCode({ address: payerAddress });
+        if (!bytecode || bytecode === "0x") {
+          try {
+            console.log(`Deploying ERC-4337 smart wallet for ${payerAddress} via EIP-6492`);
+            const deployTx = await this.signer.sendTransaction({
+              to: factoryAddress,
+              data: factoryCalldata
+            });
+            await this.signer.waitForTransactionReceipt({ hash: deployTx });
+            console.log(`Successfully deployed smart wallet for ${payerAddress}`);
+          } catch (deployError) {
+            console.error("Smart wallet deployment failed:", deployError);
+            throw deployError;
+          }
+        } else {
+          console.log(`Smart wallet for ${payerAddress} already deployed, skipping deployment`);
+        }
+      }
+      const signatureLength = signature.startsWith("0x") ? signature.length - 2 : signature.length;
+      const isECDSA = signatureLength === 130;
+      let tx;
+      if (isECDSA) {
+        const parsedSig = parseSignature(signature);
+        tx = await this.signer.writeContract({
+          address: getAddress(requirements.asset),
+          abi: eip3009ABI,
+          functionName: "transferWithAuthorization",
+          args: [
+            getAddress(exactEvmPayload.authorization.from),
+            getAddress(exactEvmPayload.authorization.to),
+            BigInt(exactEvmPayload.authorization.value),
+            BigInt(exactEvmPayload.authorization.validAfter),
+            BigInt(exactEvmPayload.authorization.validBefore),
+            exactEvmPayload.authorization.nonce,
+            parsedSig.v || parsedSig.yParity,
+            parsedSig.r,
+            parsedSig.s
+          ]
+        });
+      } else {
+        tx = await this.signer.writeContract({
+          address: getAddress(requirements.asset),
+          abi: eip3009ABI,
+          functionName: "transferWithAuthorization",
+          args: [
+            getAddress(exactEvmPayload.authorization.from),
+            getAddress(exactEvmPayload.authorization.to),
+            BigInt(exactEvmPayload.authorization.value),
+            BigInt(exactEvmPayload.authorization.validAfter),
+            BigInt(exactEvmPayload.authorization.validBefore),
+            exactEvmPayload.authorization.nonce,
+            signature
+          ]
+        });
+      }
+      const receipt = await this.signer.waitForTransactionReceipt({ hash: tx });
+      if (receipt.status !== "success") {
+        return {
+          success: false,
+          errorReason: "invalid_transaction_state",
+          transaction: tx,
+          network: payload.accepted.network,
+          payer: exactEvmPayload.authorization.from
+        };
+      }
+      return {
+        success: true,
+        transaction: tx,
+        network: payload.accepted.network,
+        payer: exactEvmPayload.authorization.from
+      };
+    } catch (error) {
+      console.error("Failed to settle transaction:", error);
+      return {
+        success: false,
+        errorReason: "transaction_failed",
+        transaction: "",
+        network: payload.accepted.network,
+        payer: exactEvmPayload.authorization.from
+      };
+    }
+  }
+};
+
+// src/exact/facilitator/register.ts
+function registerExactEvmScheme(facilitator, config) {
+  facilitator.register(
+    config.networks,
+    new ExactEvmScheme(config.signer, {
+      deployERC4337WithEIP6492: config.deployERC4337WithEIP6492
+    })
+  );
+  facilitator.registerV1(
+    NETWORKS,
+    new ExactEvmSchemeV1(config.signer, {
+      deployERC4337WithEIP6492: config.deployERC4337WithEIP6492
+    })
+  );
+  return facilitator;
+}
+export {
+  ExactEvmScheme,
+  registerExactEvmScheme
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/exact/facilitator/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/exact/facilitator/scheme.ts","../../../../src/exact/facilitator/register.ts"],"sourcesContent":["import {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkFacilitator,\n  SettleResponse,\n  VerifyResponse,\n} from \"@t402/core/types\";\nimport { getAddress, Hex, isAddressEqual, parseErc6492Signature, parseSignature } from \"viem\";\nimport { authorizationTypes, eip3009ABI } from \"../../constants\";\nimport { FacilitatorEvmSigner } from \"../../signer\";\nimport { ExactEvmPayloadV2 } from \"../../types\";\n\nexport interface ExactEvmSchemeConfig {\n  /**\n   * If enabled, the facilitator will deploy ERC-4337 smart wallets\n   * via EIP-6492 when encountering undeployed contract signatures.\n   *\n   * @default false\n   */\n  deployERC4337WithEIP6492?: boolean;\n}\n\n/**\n * EVM facilitator implementation for the Exact payment scheme.\n */\nexport class ExactEvmScheme implements SchemeNetworkFacilitator {\n  readonly scheme = \"exact\";\n  readonly caipFamily = \"eip155:*\";\n  private readonly config: Required<ExactEvmSchemeConfig>;\n\n  /**\n   * Creates a new ExactEvmFacilitator instance.\n   *\n   * @param signer - The EVM signer for facilitator operations\n   * @param config - Optional configuration for the facilitator\n   */\n  constructor(\n    private readonly signer: FacilitatorEvmSigner,\n    config?: ExactEvmSchemeConfig,\n  ) {\n    this.config = {\n      deployERC4337WithEIP6492: config?.deployERC4337WithEIP6492 ?? false,\n    };\n  }\n\n  /**\n   * Get mechanism-specific extra data for the supported kinds endpoint.\n   * For EVM, no extra data is needed.\n   *\n   * @param _ - The network identifier (unused for EVM)\n   * @returns undefined (EVM has no extra data)\n   */\n  getExtra(_: string): Record<string, unknown> | undefined {\n    return undefined;\n  }\n\n  /**\n   * Get signer addresses used by this facilitator.\n   * Returns all addresses this facilitator can use for signing/settling transactions.\n   *\n   * @param _ - The network identifier (unused for EVM, addresses are network-agnostic)\n   * @returns Array of facilitator wallet addresses\n   */\n  getSigners(_: string): string[] {\n    return [...this.signer.getAddresses()];\n  }\n\n  /**\n   * Verifies a payment payload.\n   *\n   * @param payload - The payment payload to verify\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 exactEvmPayload = payload.payload as ExactEvmPayloadV2;\n\n    // Verify scheme matches\n    if (payload.accepted.scheme !== \"exact\" || requirements.scheme !== \"exact\") {\n      return {\n        isValid: false,\n        invalidReason: \"unsupported_scheme\",\n        payer: exactEvmPayload.authorization.from,\n      };\n    }\n\n    // Get chain configuration\n    if (!requirements.extra?.name || !requirements.extra?.version) {\n      return {\n        isValid: false,\n        invalidReason: \"missing_eip712_domain\",\n        payer: exactEvmPayload.authorization.from,\n      };\n    }\n\n    const { name, version } = requirements.extra;\n    const erc20Address = getAddress(requirements.asset);\n\n    // Verify network matches\n    if (payload.accepted.network !== requirements.network) {\n      return {\n        isValid: false,\n        invalidReason: \"network_mismatch\",\n        payer: exactEvmPayload.authorization.from,\n      };\n    }\n\n    // Build typed data for signature verification\n    const permitTypedData = {\n      types: authorizationTypes,\n      primaryType: \"TransferWithAuthorization\" as const,\n      domain: {\n        name,\n        version,\n        chainId: parseInt(requirements.network.split(\":\")[1]),\n        verifyingContract: erc20Address,\n      },\n      message: {\n        from: exactEvmPayload.authorization.from,\n        to: exactEvmPayload.authorization.to,\n        value: BigInt(exactEvmPayload.authorization.value),\n        validAfter: BigInt(exactEvmPayload.authorization.validAfter),\n        validBefore: BigInt(exactEvmPayload.authorization.validBefore),\n        nonce: exactEvmPayload.authorization.nonce,\n      },\n    };\n\n    // Verify signature\n    try {\n      const recoveredAddress = await this.signer.verifyTypedData({\n        address: exactEvmPayload.authorization.from,\n        ...permitTypedData,\n        signature: exactEvmPayload.signature!,\n      });\n\n      if (!recoveredAddress) {\n        return {\n          isValid: false,\n          invalidReason: \"invalid_exact_evm_payload_signature\",\n          payer: exactEvmPayload.authorization.from,\n        };\n      }\n    } catch {\n      // Signature verification failed - could be an undeployed smart wallet\n      // Check if smart wallet is deployed\n      const signature = exactEvmPayload.signature!;\n      const signatureLength = signature.startsWith(\"0x\") ? signature.length - 2 : signature.length;\n      const isSmartWallet = signatureLength > 130; // 65 bytes = 130 hex chars for EOA\n\n      if (isSmartWallet) {\n        const payerAddress = exactEvmPayload.authorization.from;\n        const bytecode = await this.signer.getCode({ address: payerAddress });\n\n        if (!bytecode || bytecode === \"0x\") {\n          // Wallet is not deployed. Check if it's EIP-6492 with deployment info.\n          // EIP-6492 signatures contain factory address and calldata needed for deployment.\n          // Non-EIP-6492 undeployed wallets cannot succeed (no way to deploy them).\n          const erc6492Data = parseErc6492Signature(signature);\n          const hasDeploymentInfo =\n            erc6492Data.address &&\n            erc6492Data.data &&\n            !isAddressEqual(erc6492Data.address, \"0x0000000000000000000000000000000000000000\");\n\n          if (!hasDeploymentInfo) {\n            // Non-EIP-6492 undeployed smart wallet - will always fail at settlement\n            // since EIP-3009 requires on-chain EIP-1271 validation\n            return {\n              isValid: false,\n              invalidReason: \"invalid_exact_evm_payload_undeployed_smart_wallet\",\n              payer: payerAddress,\n            };\n          }\n          // EIP-6492 signature with deployment info - allow through\n          // Facilitators with sponsored deployment support can handle this in settle()\n        } else {\n          // Wallet is deployed but signature still failed - invalid signature\n          return {\n            isValid: false,\n            invalidReason: \"invalid_exact_evm_payload_signature\",\n            payer: exactEvmPayload.authorization.from,\n          };\n        }\n      } else {\n        // EOA signature failed\n        return {\n          isValid: false,\n          invalidReason: \"invalid_exact_evm_payload_signature\",\n          payer: exactEvmPayload.authorization.from,\n        };\n      }\n    }\n\n    // Verify payment recipient matches\n    if (getAddress(exactEvmPayload.authorization.to) !== getAddress(requirements.payTo)) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_evm_payload_recipient_mismatch\",\n        payer: exactEvmPayload.authorization.from,\n      };\n    }\n\n    // Verify validBefore is in the future (with 6 second buffer for block time)\n    const now = Math.floor(Date.now() / 1000);\n    if (BigInt(exactEvmPayload.authorization.validBefore) < BigInt(now + 6)) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_evm_payload_authorization_valid_before\",\n        payer: exactEvmPayload.authorization.from,\n      };\n    }\n\n    // Verify validAfter is not in the future\n    if (BigInt(exactEvmPayload.authorization.validAfter) > BigInt(now)) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_evm_payload_authorization_valid_after\",\n        payer: exactEvmPayload.authorization.from,\n      };\n    }\n\n    // Check balance\n    try {\n      const balance = (await this.signer.readContract({\n        address: erc20Address,\n        abi: eip3009ABI,\n        functionName: \"balanceOf\",\n        args: [exactEvmPayload.authorization.from],\n      })) as bigint;\n\n      if (BigInt(balance) < BigInt(requirements.amount)) {\n        return {\n          isValid: false,\n          invalidReason: \"insufficient_funds\",\n          payer: exactEvmPayload.authorization.from,\n        };\n      }\n    } catch {\n      // If we can't check balance, continue with other validations\n    }\n\n    // Verify amount is sufficient\n    if (BigInt(exactEvmPayload.authorization.value) < BigInt(requirements.amount)) {\n      return {\n        isValid: false,\n        invalidReason: \"invalid_exact_evm_payload_authorization_value\",\n        payer: exactEvmPayload.authorization.from,\n      };\n    }\n\n    return {\n      isValid: true,\n      invalidReason: undefined,\n      payer: exactEvmPayload.authorization.from,\n    };\n  }\n\n  /**\n   * Settles a payment by executing the transfer.\n   *\n   * @param payload - The payment payload to settle\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 exactEvmPayload = payload.payload as ExactEvmPayloadV2;\n\n    // Re-verify before settling\n    const valid = await this.verify(payload, requirements);\n    if (!valid.isValid) {\n      return {\n        success: false,\n        network: payload.accepted.network,\n        transaction: \"\",\n        errorReason: valid.invalidReason ?? \"invalid_scheme\",\n        payer: exactEvmPayload.authorization.from,\n      };\n    }\n\n    try {\n      // Parse ERC-6492 signature if applicable\n      const parseResult = parseErc6492Signature(exactEvmPayload.signature!);\n      const { signature, address: factoryAddress, data: factoryCalldata } = parseResult;\n\n      // Deploy ERC-4337 smart wallet via EIP-6492 if configured and needed\n      if (\n        this.config.deployERC4337WithEIP6492 &&\n        factoryAddress &&\n        factoryCalldata &&\n        !isAddressEqual(factoryAddress, \"0x0000000000000000000000000000000000000000\")\n      ) {\n        // Check if smart wallet is already deployed\n        const payerAddress = exactEvmPayload.authorization.from;\n        const bytecode = await this.signer.getCode({ address: payerAddress });\n\n        if (!bytecode || bytecode === \"0x\") {\n          // Wallet not deployed - attempt deployment\n          try {\n            console.log(`Deploying ERC-4337 smart wallet for ${payerAddress} via EIP-6492`);\n\n            // Send the factory calldata directly as a transaction\n            // The factoryCalldata already contains the complete encoded function call\n            const deployTx = await this.signer.sendTransaction({\n              to: factoryAddress as Hex,\n              data: factoryCalldata as Hex,\n            });\n\n            // Wait for deployment transaction\n            await this.signer.waitForTransactionReceipt({ hash: deployTx });\n            console.log(`Successfully deployed smart wallet for ${payerAddress}`);\n          } catch (deployError) {\n            console.error(\"Smart wallet deployment failed:\", deployError);\n            // Deployment failed - cannot proceed\n            throw deployError;\n          }\n        } else {\n          console.log(`Smart wallet for ${payerAddress} already deployed, skipping deployment`);\n        }\n      }\n\n      // Determine if this is an ECDSA signature (EOA) or smart wallet signature\n      // ECDSA signatures are exactly 65 bytes (130 hex chars without 0x)\n      const signatureLength = signature.startsWith(\"0x\") ? signature.length - 2 : signature.length;\n      const isECDSA = signatureLength === 130;\n\n      let tx: Hex;\n      if (isECDSA) {\n        // For EOA wallets, parse signature into v, r, s and use that overload\n        const parsedSig = parseSignature(signature);\n\n        tx = await this.signer.writeContract({\n          address: getAddress(requirements.asset),\n          abi: eip3009ABI,\n          functionName: \"transferWithAuthorization\",\n          args: [\n            getAddress(exactEvmPayload.authorization.from),\n            getAddress(exactEvmPayload.authorization.to),\n            BigInt(exactEvmPayload.authorization.value),\n            BigInt(exactEvmPayload.authorization.validAfter),\n            BigInt(exactEvmPayload.authorization.validBefore),\n            exactEvmPayload.authorization.nonce,\n            (parsedSig.v as number | undefined) || parsedSig.yParity,\n            parsedSig.r,\n            parsedSig.s,\n          ],\n        });\n      } else {\n        // For smart wallets, use the bytes signature overload\n        // The signature contains WebAuthn/P256 or other ERC-1271 compatible signature data\n        tx = await this.signer.writeContract({\n          address: getAddress(requirements.asset),\n          abi: eip3009ABI,\n          functionName: \"transferWithAuthorization\",\n          args: [\n            getAddress(exactEvmPayload.authorization.from),\n            getAddress(exactEvmPayload.authorization.to),\n            BigInt(exactEvmPayload.authorization.value),\n            BigInt(exactEvmPayload.authorization.validAfter),\n            BigInt(exactEvmPayload.authorization.validBefore),\n            exactEvmPayload.authorization.nonce,\n            signature,\n          ],\n        });\n      }\n\n      // Wait for transaction confirmation\n      const receipt = await this.signer.waitForTransactionReceipt({ hash: tx });\n\n      if (receipt.status !== \"success\") {\n        return {\n          success: false,\n          errorReason: \"invalid_transaction_state\",\n          transaction: tx,\n          network: payload.accepted.network,\n          payer: exactEvmPayload.authorization.from,\n        };\n      }\n\n      return {\n        success: true,\n        transaction: tx,\n        network: payload.accepted.network,\n        payer: exactEvmPayload.authorization.from,\n      };\n    } catch (error) {\n      console.error(\"Failed to settle transaction:\", error);\n      return {\n        success: false,\n        errorReason: \"transaction_failed\",\n        transaction: \"\",\n        network: payload.accepted.network,\n        payer: exactEvmPayload.authorization.from,\n      };\n    }\n  }\n}\n","import { t402Facilitator } from \"@t402/core/facilitator\";\nimport { Network } from \"@t402/core/types\";\nimport { FacilitatorEvmSigner } from \"../../signer\";\nimport { ExactEvmScheme } from \"./scheme\";\nimport { ExactEvmSchemeV1 } from \"../v1/facilitator/scheme\";\nimport { NETWORKS } from \"../../v1\";\n\n/**\n * Configuration options for registering EVM schemes to an t402Facilitator\n */\nexport interface EvmFacilitatorConfig {\n  /**\n   * The EVM signer for facilitator operations (verify and settle)\n   */\n  signer: FacilitatorEvmSigner;\n\n  /**\n   * Networks to register (single network or array of networks)\n   * Examples: \"eip155:84532\", [\"eip155:84532\", \"eip155:1\"]\n   */\n  networks: Network | Network[];\n\n  /**\n   * If enabled, the facilitator will deploy ERC-4337 smart wallets\n   * via EIP-6492 when encountering undeployed contract signatures.\n   *\n   * @default false\n   */\n  deployERC4337WithEIP6492?: boolean;\n}\n\n/**\n * Registers EVM exact payment schemes to an t402Facilitator instance.\n *\n * This function registers:\n * - V2: Specified networks with ExactEvmScheme\n * - V1: All supported EVM networks with ExactEvmSchemeV1\n *\n * @param facilitator - The t402Facilitator instance to register schemes to\n * @param config - Configuration for EVM facilitator registration\n * @returns The facilitator instance for chaining\n *\n * @example\n * ```typescript\n * import { registerExactEvmScheme } from \"@t402/evm/exact/facilitator/register\";\n * import { t402Facilitator } from \"@t402/core/facilitator\";\n * import { createPublicClient, createWalletClient } from \"viem\";\n *\n * const facilitator = new t402Facilitator();\n *\n * // Single network\n * registerExactEvmScheme(facilitator, {\n *   signer: combinedClient,\n *   networks: \"eip155:84532\"  // Base Sepolia\n * });\n *\n * // Multiple networks (will auto-derive eip155:* pattern)\n * registerExactEvmScheme(facilitator, {\n *   signer: combinedClient,\n *   networks: [\"eip155:84532\", \"eip155:1\"]  // Base Sepolia and Mainnet\n * });\n * ```\n */\nexport function registerExactEvmScheme(\n  facilitator: t402Facilitator,\n  config: EvmFacilitatorConfig,\n): t402Facilitator {\n  // Register V2 scheme with specified networks\n  facilitator.register(\n    config.networks,\n    new ExactEvmScheme(config.signer, {\n      deployERC4337WithEIP6492: config.deployERC4337WithEIP6492,\n    }),\n  );\n\n  // Register all V1 networks\n  facilitator.registerV1(\n    NETWORKS as Network[],\n    new ExactEvmSchemeV1(config.signer, {\n      deployERC4337WithEIP6492: config.deployERC4337WithEIP6492,\n    }),\n  );\n\n  return facilitator;\n}\n"],"mappings":"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","names":[]}

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

@@ -0,0 +1,36 @@
+export { E as ExactEvmScheme } from '../../scheme-yqGaK9rK.mjs';
+import { t402ResourceServer } from '@t402/core/server';
+import { Network } from '@t402/core/types';
+
+/**
+ * Configuration options for registering EVM schemes to an t402ResourceServer
+ */
+interface EvmResourceServerConfig {
+    /**
+     * Optional specific networks to register
+     * If not provided, registers wildcard support (eip155:*)
+     */
+    networks?: Network[];
+}
+/**
+ * Registers EVM exact payment schemes to an t402ResourceServer instance.
+ *
+ * This function registers:
+ * - V2: eip155:* wildcard scheme with ExactEvmScheme (or specific networks if provided)
+ *
+ * @param server - The t402ResourceServer instance to register schemes to
+ * @param config - Configuration for EVM resource server registration
+ * @returns The server instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactEvmScheme } from "@t402/evm/exact/server/register";
+ * import { t402ResourceServer } from "@t402/core/server";
+ *
+ * const server = new t402ResourceServer(facilitatorClient);
+ * registerExactEvmScheme(server, {});
+ * ```
+ */
+declare function registerExactEvmScheme(server: t402ResourceServer, config?: EvmResourceServerConfig): t402ResourceServer;
+
+export { type EvmResourceServerConfig, registerExactEvmScheme };