npm - @x402x/client - Versions diffs - 2.1.0 → 2.2.0 - Mend

@x402x/client 2.1.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -47,7 +47,7 @@ Client → Facilitator → Smart Contract (Hook)
 import { parseDefaultAssetAmount } from "@x402x/extensions";
 const atomicAmount = parseDefaultAssetAmount("1", network); // '1000000'
-const client = new X402Client({ wallet, network, facilitatorUrl });
+const client = new x402xClient({ wallet, network, facilitatorUrl });
 const result = await client.execute({
   hook: TransferHook.address,
   amount: atomicAmount, // Must be atomic units
@@ -74,7 +74,7 @@ yarn add @x402x/client @x402x/extensions
 ### Basic Usage (React + wagmi)
 ```typescript
-import { X402Client } from '@x402x/client';
+import { x402xClient } from '@x402x/client';
 import { TransferHook, parseDefaultAssetAmount } from '@x402x/extensions';
 import { useWalletClient } from 'wagmi';
 import { publicActions } from 'viem';
@@ -87,7 +87,7 @@ function PayButton() {
     const extendedWallet = wallet.extend(publicActions);
     // Uses default facilitator at https://facilitator.x402x.dev/
-    const client = new X402Client({
+    const client = new x402xClient({
       wallet: extendedWallet,
       network: 'base-sepolia'
     });
@@ -109,7 +109,7 @@ function PayButton() {
 }
 ```
-> **Note**: The wallet client must be extended with `publicActions` from viem to support transaction confirmation via `waitForTransactionReceipt`. If you're using the React hooks (`useX402Client`), this is done automatically.
+> **Note**: The wallet client must be extended with `publicActions` from viem to support transaction confirmation via `waitForTransactionReceipt`. If you're using the React hooks (`useX402xClient`), this is done automatically.
 ---
@@ -142,10 +142,10 @@ const displayAmount = formatDefaultAssetAmount("1000000", "base-sepolia"); // '1
 ### Example
 ```typescript
-import { X402Client } from "@x402x/client";
+import { x402xClient } from "@x402x/client";
 import { parseDefaultAssetAmount } from "@x402x/extensions";
-const client = new X402Client({ wallet, network: "base-sepolia" });
+const client = new x402xClient({ wallet, network: "base-sepolia" });
 // ✅ Correct: Convert first, then pass atomic units
 const atomicAmount = parseDefaultAssetAmount("5", "base-sepolia");
@@ -161,13 +161,13 @@ await client.execute({ amount: "5", payTo: "0x..." }); // Will fail validation
 ### High-Level API (Recommended)
-#### X402Client
+#### x402xClient
 The main client class that handles the entire settlement flow.
 ```typescript
-class X402Client {
-  constructor(config: X402ClientConfig);
+class x402xClient {
+  constructor(config: x402xClientConfig);
   execute(params: ExecuteParams): Promise<ExecuteResult>;
   calculateFee(hook: Address, hookData?: Hex): Promise<FeeCalculationResult>;
   waitForTransaction(txHash: Hex): Promise<TransactionReceipt>;
@@ -177,16 +177,16 @@ class X402Client {
 **Example:**
 ```typescript
-import { X402Client } from "@x402x/client";
+import { x402xClient } from "@x402x/client";
 // Uses default facilitator at https://facilitator.x402x.dev/
-const client = new X402Client({
+const client = new x402xClient({
   wallet: walletClient,
   network: "base-sepolia",
 });
 // Or specify custom facilitator
-const client = new X402Client({
+const client = new x402xClient({
   wallet: walletClient,
   network: "base-sepolia",
   facilitatorUrl: "https://custom-facilitator.example.com",
@@ -210,19 +210,19 @@ const result = await client.execute({
 #### React Hooks
-##### useX402Client
+##### useX402xClient
-Automatically creates an X402Client using wagmi's wallet connection.
+Automatically creates an x402xClient using wagmi's wallet connection.
 ```typescript
-import { useX402Client } from '@x402x/client';
+import { useX402xClient } from '@x402x/client';
 function MyComponent() {
   // Uses default facilitator at https://facilitator.x402x.dev/
-  const client = useX402Client();
+  const client = useX402xClient();
   // Or specify custom facilitator
-  const client = useX402Client({
+  const client = useX402xClient({
     facilitatorUrl: 'https://custom-facilitator.example.com'
   });
@@ -301,7 +301,7 @@ Understanding the x402 protocol terminology used in this SDK:
 **Execute** (high-level API) - Complete end-to-end payment flow including preparation, signing, settlement, and confirmation.
-- In @x402x/client: `X402Client.execute()` method
+- In @x402x/client: `x402xClient.execute()` method
 - Flow: `prepare → sign → settle → wait for confirmation`
 - Use case: One-line payment execution for most developers
@@ -376,11 +376,11 @@ const result = await settle("https://facilitator.x402x.dev", signed);
 ### Example 1: Simple Payment
 ```typescript
-import { X402Client } from "@x402x/client";
+import { x402xClient } from "@x402x/client";
 import { TransferHook, parseDefaultAssetAmount } from "@x402x/extensions";
 // Uses default facilitator at https://facilitator.x402x.dev/
-const client = new X402Client({
+const client = new x402xClient({
   wallet: walletClient,
   network: "base-sepolia",
 });
@@ -403,10 +403,10 @@ console.log("Transaction:", result.txHash);
 TransferHook supports distributing funds to multiple recipients by percentage:
 ```typescript
-import { X402Client } from "@x402x/client";
+import { x402xClient } from "@x402x/client";
 import { TransferHook, parseDefaultAssetAmount, type Split } from "@x402x/extensions";
-const client = new X402Client({
+const client = new x402xClient({
   wallet: walletClient,
   network: "base-sepolia",
 });
@@ -526,7 +526,7 @@ console.log("Transaction:", result.transaction);
 ```typescript
 import { ref } from "vue";
-import { X402Client } from "@x402x/client";
+import { x402xClient } from "@x402x/client";
 import { TransferHook, parseDefaultAssetAmount } from "@x402x/extensions";
 export function usePayment() {
@@ -538,7 +538,7 @@ export function usePayment() {
     error.value = null;
     try {
-      const client = new X402Client({
+      const client = new x402xClient({
         wallet: walletClient,
         network,
         facilitatorUrl: import.meta.env.VITE_FACILITATOR_URL,
@@ -575,7 +575,7 @@ The SDK provides typed error classes for better error handling:
 ```typescript
 import {
-  X402ClientError,
+  x402xClientError,
   NetworkError,
   SigningError,
   FacilitatorError,
@@ -608,7 +608,7 @@ Full TypeScript support with comprehensive type definitions:
 ```typescript
 import type {
-  X402ClientConfig,
+  x402xClientConfig,
   ExecuteParams,
   ExecuteResult,
   SettlementData,

package/dist/index.cjs CHANGED Viewed

@@ -392,9 +392,9 @@ async function settle(facilitatorUrl, signed, timeout = 3e4) {
 }
 // src/client.ts
-var X402Client = class {
+var x402xClient = class {
   /**
-   * Create a new X402Client instance
+   * Create a new x402xClient instance
    *
    * @param config - Client configuration
    * @throws NetworkError if network is unsupported
@@ -607,7 +607,7 @@ var CHAIN_ID_TO_NETWORK = {
   97: "bsc-testnet",
   56: "bsc"
 };
-function useX402Client(config) {
+function useX402xClient(config) {
   let walletClient;
   let isConnected;
   let chainId;
@@ -638,7 +638,7 @@ function useX402Client(config) {
     }
     try {
       const extendedWallet = walletClient.extend(viem.publicActions);
-      return new X402Client({
+      return new x402xClient({
         wallet: extendedWallet,
         network,
         facilitatorUrl: config?.facilitatorUrl,
@@ -647,7 +647,7 @@ function useX402Client(config) {
         confirmationTimeout: config?.confirmationTimeout
       });
     } catch (error) {
-      console.error("[x402x] Failed to create X402Client:", error);
+      console.error("[x402x] Failed to create x402xClient:", error);
       return null;
     }
   }, [
@@ -662,7 +662,7 @@ function useX402Client(config) {
   ]);
 }
 function useExecute(config) {
-  const client = useX402Client(config);
+  const client = useX402xClient(config);
   const [status, setStatus] = react.useState("idle");
   const [error, setError] = react.useState(null);
   const [result, setResult] = react.useState(null);
@@ -723,7 +723,7 @@ exports.NetworkError = NetworkError;
 exports.SigningError = SigningError;
 exports.TransactionError = TransactionError;
 exports.ValidationError = ValidationError;
-exports.X402Client = X402Client;
+exports.X402Client = x402xClient;
 exports.X402ClientError = X402ClientError;
 exports.calculateTimeWindow = calculateTimeWindow;
 exports.formatFacilitatorUrl = formatFacilitatorUrl;
@@ -733,6 +733,8 @@ exports.prepareSettlement = prepareSettlement;
 exports.settle = settle;
 exports.signAuthorization = signAuthorization;
 exports.useExecute = useExecute;
-exports.useX402Client = useX402Client;
+exports.useX402Client = useX402xClient;
+exports.useX402xClient = useX402xClient;
+exports.x402xClient = x402xClient;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/errors.ts","../src/core/utils.ts","../src/core/prepare.ts","../src/core/sign.ts","../src/core/settle.ts","../src/client.ts","../src/hooks/useX402Client.ts","../src/hooks/useExecute.ts"],"names":["getAddress","isAddress","calculateFacilitatorFee","getNetworkConfig","calculateCommitment","signTypedData","toCanonicalNetworkKey","coreSettle","TransferHook","useWalletClient","useAccount","useChainId","WagmiProviderNotFoundError","useMemo","publicActions","useState","useCallback","error"],"mappings":"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","file":"index.cjs","sourcesContent":["/*\n Error classes for x402x client SDK\n /\n\n/\n Base error class for all x402x client errors\n /\nexport class X402ClientError extends Error {\n constructor(\n message: string,\n public readonly code?: string,\n ) {\n super(message);\n this.name = \"X402ClientError\";\n Object.setPrototypeOf(this, X402ClientError.prototype);\n }\n}\n\n/\n Network-related errors (unsupported network, configuration issues)\n /\nexport class NetworkError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"NetworkError\";\n Object.setPrototypeOf(this, NetworkError.prototype);\n }\n}\n\n/\n Wallet signing errors\n /\nexport class SigningError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"SigningError\";\n Object.setPrototypeOf(this, SigningError.prototype);\n }\n}\n\n/\n Facilitator communication errors\n /\nexport class FacilitatorError extends X402ClientError {\n constructor(\n message: string,\n code?: string,\n public readonly statusCode?: number,\n public readonly response?: unknown,\n ) {\n super(message, code);\n this.name = \"FacilitatorError\";\n Object.setPrototypeOf(this, FacilitatorError.prototype);\n }\n}\n\n/\n Transaction execution errors\n /\nexport class TransactionError extends X402ClientError {\n constructor(\n message: string,\n code?: string,\n public readonly txHash?: string,\n ) {\n super(message, code);\n this.name = \"TransactionError\";\n Object.setPrototypeOf(this, TransactionError.prototype);\n }\n}\n\n/\n Parameter validation errors\n /\nexport class ValidationError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"ValidationError\";\n Object.setPrototypeOf(this, ValidationError.prototype);\n }\n}\n","/\n Utility functions for x402x client\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { getAddress, isAddress } from \"viem\";\nimport { ValidationError } from \"../errors.js\";\n\n/\n Generate a random 32-byte salt for settlement idempotency\n \n @returns Random 32-byte hex string\n \n @example\n * ```typescript\n * const salt = generateSalt();\n * console.log(salt); // \"0x1234...\"\n * ```\n /\nexport function generateSalt(): Hex {\n const cryptoObj = (globalThis as any).crypto as Crypto \| undefined;\n\n if (!cryptoObj \|\| !cryptoObj.getRandomValues) {\n throw new Error(\"crypto.getRandomValues is not available\");\n }\n\n const randomBytes = cryptoObj.getRandomValues(new Uint8Array(32));\n return `0x${Array.from(randomBytes)\n .map((b) => b.toString(16).padStart(2, \"0\"))\n .join(\"\")}` as Hex;\n}\n\n/\n Normalize Ethereum address to EIP-55 checksum format\n \n Automatically converts any valid Ethereum address (lowercase, uppercase, or mixed)\n * to the proper checksummed format. This provides a better developer experience\n * by accepting addresses in any case format.\n \n @param address - Address to normalize (can be any case)\n * @param name - Parameter name for error messages (optional)\n * @returns Checksummed address in EIP-55 format\n * @throws ValidationError if address is invalid\n \n @example\n * ```typescript\n * normalizeAddress('0xabc123...') // Returns '0xAbC123...' (checksummed)\n * normalizeAddress('0xABC123...') // Returns '0xAbC123...' (checksummed)\n * normalizeAddress('0xAbC123...') // Returns '0xAbC123...' (already checksummed)\n * ```\n /\nexport function normalizeAddress(address: string, name: string = \"address\"): Address {\n if (!address \|\| typeof address !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n\n // Convert to EIP-55 checksum format\n // getAddress() will throw if the address is invalid\n try {\n return getAddress(address);\n } catch (error) {\n throw new ValidationError(\n `${name} is not a valid Ethereum address: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n );\n }\n}\n\n/\n Validate Ethereum address format (legacy, prefer normalizeAddress)\n \n @deprecated Use normalizeAddress() instead for better developer experience\n * @param address - Address to validate\n * @param name - Parameter name for error messages\n * @throws ValidationError if address is invalid\n /\nexport function validateAddress(address: string, name: string): void {\n if (!address \|\| typeof address !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n if (!isAddress(address)) {\n throw new ValidationError(`${name} must be a valid Ethereum address`);\n }\n}\n\n/\n Validate hex string format\n \n @param hex - Hex string to validate\n * @param name - Parameter name for error messages\n * @param expectedLength - Optional expected length (in bytes, not characters)\n * @throws ValidationError if hex is invalid\n /\nexport function validateHex(hex: string, name: string, expectedLength?: number): void {\n if (!hex \|\| typeof hex !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n if (!hex.startsWith(\"0x\")) {\n throw new ValidationError(`${name} must start with 0x`);\n }\n if (!/^0x[0-9a-fA-F]$/.test(hex)) {\n throw new ValidationError(`${name} must be a valid hex string`);\n }\n if (expectedLength !== undefined) {\n const actualLength = (hex.length - 2) / 2;\n if (actualLength !== expectedLength) {\n throw new ValidationError(\n `${name} must be ${expectedLength} bytes, got ${actualLength} bytes`,\n );\n }\n }\n}\n\n/*\n Validate amount format - must be atomic units (positive integer string)\n \n This function validates that the amount is a valid atomic unit string.\n * For converting USD amounts to atomic units, use parseDefaultAssetAmount from @x402x/core.\n \n @param amount - Amount in atomic units (must be a positive integer string)\n * @param name - Parameter name for error messages\n * @throws ValidationError if amount is invalid\n \n @example\n * ```typescript\n * validateAmount('1000000', 'amount'); // Valid: atomic units\n * validateAmount('0.1', 'amount'); // Invalid: not atomic units\n * validateAmount('-1', 'amount'); // Invalid: negative\n * ```\n /\nexport function validateAmount(amount: string \| number, name: string): void {\n if (amount === null \|\| amount === undefined \|\| amount === \"\") {\n throw new ValidationError(`${name} is required`);\n }\n\n // Convert to string if number\n const amountStr = typeof amount === \"number\" ? amount.toString() : amount;\n\n // Must be a non-empty string\n if (typeof amountStr !== \"string\" \|\| amountStr.trim() === \"\") {\n throw new ValidationError(`${name} must be a non-empty string`);\n }\n\n // Must be a valid positive integer (atomic units)\n // Allow leading zeros but must be numeric\n if (!/^\\d+$/.test(amountStr)) {\n throw new ValidationError(\n `${name} must be a positive integer string (atomic units). ` +\n `Use parseDefaultAssetAmount() from @x402x/core to convert USD amounts.`,\n );\n }\n\n // Validate it can be converted to BigInt (no overflow)\n try {\n const atomicAmount = BigInt(amountStr);\n if (atomicAmount < 0n) {\n throw new ValidationError(`${name} cannot be negative`);\n }\n if (atomicAmount === 0n) {\n throw new ValidationError(`${name} cannot be zero`);\n }\n } catch (error) {\n if (error instanceof ValidationError) {\n throw error;\n }\n throw new ValidationError(\n `${name} is not a valid amount: ${error instanceof Error ? error.message : \"Invalid format\"}`,\n );\n }\n}\n\n/\n Format facilitator URL (ensure it doesn't end with slash)\n \n @param url - Facilitator URL\n * @returns Formatted URL\n /\nexport function formatFacilitatorUrl(url: string): string {\n return url.endsWith(\"/\") ? url.slice(0, -1) : url;\n}\n\n/\n Calculate default time window for authorization\n \n @param maxTimeoutSeconds - Maximum timeout in seconds\n * @returns Object with validAfter and validBefore timestamps\n /\nexport function calculateTimeWindow(maxTimeoutSeconds: number = 300): {\n validAfter: string;\n validBefore: string;\n} {\n const now = Math.floor(Date.now() / 1000);\n return {\n validAfter: (now - 600).toString(), // 10 minutes before\n validBefore: (now + maxTimeoutSeconds).toString(),\n };\n}\n","/\n Prepare settlement data for signing\n \n This module handles the preparation of settlement parameters before signing,\n * including generating salt, calculating commitment hash, and fetching facilitator fees.\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { getNetworkConfig, calculateFacilitatorFee, type FeeCalculationResult } from \"@x402x/extensions\";\nimport { calculateCommitment } from \"@x402x/extensions\";\nimport type { PrepareParams, SettlementData } from \"../types.js\";\nimport { NetworkError, ValidationError, FacilitatorError } from \"../errors.js\";\nimport {\n generateSalt,\n validateAddress,\n validateHex,\n validateAmount,\n calculateTimeWindow,\n} from \"./utils.js\";\n\n/\n Default facilitator URL\n /\nexport const DEFAULT_FACILITATOR_URL = \"https://facilitator.x402x.dev\";\n\n/\n Query facilitator fee from facilitator service (internal helper)\n \n Uses the /calculate-fee endpoint which provides accurate gas cost estimates\n * with safety margins.\n \n @internal\n * @param facilitatorUrl - Facilitator URL\n * @param network - Network name\n * @param hook - Hook contract address\n * @param hookData - Optional encoded hook parameters (default: '0x')\n * @returns Fee calculation result\n \n @throws FacilitatorError if request fails\n /\nasync function queryFacilitatorFee(\n facilitatorUrl: string,\n network: string,\n hook: Address,\n hookData: Hex = \"0x\",\n): Promise<FeeCalculationResult> {\n try {\n return await calculateFacilitatorFee(facilitatorUrl, network, hook, hookData);\n } catch (error) {\n if (error instanceof Error) {\n throw new FacilitatorError(\n `Failed to query facilitator fee: ${error.message}`,\n \"FEE_QUERY_FAILED\",\n );\n }\n throw new FacilitatorError(\"Failed to query facilitator fee: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n\n/\n Prepare settlement data for signing\n \n This function:\n * 1. Validates all parameters\n * 2. Loads network configuration\n * 3. Generates salt (if not provided)\n * 4. Queries facilitator fee (if not provided)\n * 5. Calculates time window (if not provided)\n * 6. Calculates commitment hash\n * 7. Returns prepared settlement data\n \n @param params - Preparation parameters\n * @returns Prepared settlement data ready for signing\n \n @throws NetworkError if network is unsupported\n * @throws ValidationError if parameters are invalid\n \n @example\n * ```typescript\n * import { prepareSettlement } from '@x402x/client';\n * import { TransferHook, parseDefaultAssetAmount } from '@x402x/core';\n \n // Convert USD amount to atomic units first\n * const atomicAmount = parseDefaultAssetAmount('1', 'base-sepolia'); // '1000000'\n \n const settlement = await prepareSettlement({\n * wallet: walletClient,\n * network: 'base-sepolia',\n * hook: TransferHook.getAddress('base-sepolia'),\n * hookData: TransferHook.encode(),\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...',\n * facilitatorUrl: 'https://facilitator.x402x.dev'\n * });\n * ```\n /\nexport async function prepareSettlement(params: PrepareParams): Promise<SettlementData> {\n // 1. Validate parameters\n validateAddress(params.hook, \"hook\");\n validateHex(params.hookData, \"hookData\");\n validateAddress(params.payTo, \"payTo\");\n\n // 2. Validate amount (must be atomic units, no automatic conversion)\n validateAmount(params.amount, \"amount\");\n const atomicAmount = params.amount;\n\n if (params.customSalt) {\n validateHex(params.customSalt, \"customSalt\", 32);\n }\n\n // 2. Get wallet account address\n const from = params.wallet.account?.address;\n if (!from) {\n throw new ValidationError(\"Wallet client must have an account\");\n }\n\n // 3. Load network configuration\n const networkConfig = params.networkConfig \|\| getNetworkConfig(params.network);\n if (!networkConfig) {\n throw new NetworkError(\n `Network '${params.network}' is not supported. Please provide custom networkConfig.`,\n );\n }\n\n // 4. Determine asset address (use provided asset or default asset)\n const asset = params.asset \|\| (networkConfig.defaultAsset.address as Address);\n validateAddress(asset, \"asset\");\n\n // 5. Generate salt (if not provided)\n const salt = params.customSalt \|\| generateSalt();\n\n // 6. Query facilitator fee (if not provided)\n // Use the provided facilitatorUrl or fall back to default\n let facilitatorFee = params.facilitatorFee \|\| \"0\";\n if (!params.facilitatorFee) {\n const facilitatorUrl = params.facilitatorUrl \|\| DEFAULT_FACILITATOR_URL;\n try {\n const feeEstimate = await queryFacilitatorFee(\n facilitatorUrl,\n params.network,\n params.hook,\n params.hookData, // Pass hookData for accurate fee calculation\n );\n\n if (!feeEstimate.hookAllowed) {\n throw new ValidationError(\n `Hook ${params.hook} is not allowed on network ${params.network}.`,\n );\n }\n\n facilitatorFee = feeEstimate.facilitatorFee;\n } catch (error) {\n // If fee query fails, log warning and use 0\n console.warn(\n `[x402x] Failed to query facilitator fee, using 0. This may cause settlement to fail. Error: ${\n error instanceof Error ? error.message : \"Unknown\"\n }`,\n );\n facilitatorFee = \"0\";\n }\n }\n\n // 7. Calculate time window (if not provided)\n const timeWindow =\n params.validAfter && params.validBefore\n ? { validAfter: params.validAfter, validBefore: params.validBefore }\n : calculateTimeWindow(300); // 5 minutes default\n\n // 8. Calculate commitment hash\n // IMPORTANT: value must be total amount (business amount + facilitator fee)\n // because the contract's calculateCommitment expects the same value that\n // will be authorized in the EIP-3009 signature\n const totalAmount = (BigInt(atomicAmount) + BigInt(facilitatorFee)).toString();\n const commitment = calculateCommitment({\n chainId: networkConfig.chainId,\n hub: networkConfig.settlementRouter as Address,\n asset: asset,\n from,\n value: totalAmount,\n validAfter: timeWindow.validAfter,\n validBefore: timeWindow.validBefore,\n salt,\n payTo: params.payTo,\n facilitatorFee,\n hook: params.hook,\n hookData: params.hookData,\n });\n\n // 9. Return prepared settlement data\n // Use original network name for API compatibility; conversion to canonical format happens during settlement\n return {\n network: params.network,\n networkConfig,\n asset: asset,\n from,\n amount: atomicAmount,\n validAfter: timeWindow.validAfter,\n validBefore: timeWindow.validBefore,\n salt,\n payTo: params.payTo,\n facilitatorFee,\n hook: params.hook,\n hookData: params.hookData,\n commitment: commitment as Hex,\n };\n}\n","/\n Sign EIP-3009 authorization for settlement\n \n This module handles the signing of EIP-712 typed data for EIP-3009\n * transferWithAuthorization, using the commitment hash as the nonce.\n /\n\nimport type { Address, WalletClient } from \"viem\";\nimport { getAddress } from \"viem\";\nimport { signTypedData } from \"viem/actions\";\nimport type { SettlementData, SignedAuthorization } from \"../types.js\";\nimport { SigningError } from \"../errors.js\";\n\n/\n EIP-3009 authorization types for EIP-712 signature\n /\nconst AUTHORIZATION_TYPES = {\n TransferWithAuthorization: [\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/\n Sign EIP-3009 authorization\n \n This function signs an EIP-712 typed data message for EIP-3009's\n * transferWithAuthorization function. The commitment hash is used\n * as the nonce to cryptographically bind all settlement parameters.\n \n @param wallet - Wallet client from wagmi/viem\n * @param settlement - Prepared settlement data\n * @returns Signed authorization ready to submit\n \n @throws SigningError if signing fails or wallet doesn't support signing\n \n @example\n * ```typescript\n * import { signAuthorization } from '@x402x/client';\n \n const signed = await signAuthorization(walletClient, settlement);\n * console.log('Signature:', signed.signature);\n * ```\n /\nexport async function signAuthorization(\n wallet: WalletClient,\n settlement: SettlementData,\n): Promise<SignedAuthorization> {\n try {\n // Ensure wallet has an account\n if (!wallet.account) {\n throw new SigningError(\"Wallet client must have an account\");\n }\n\n // Build EIP-712 domain\n // Use the asset's EIP-712 domain info from network config\n // Note: For custom assets, the domain info should match the asset contract\n const domain = {\n name: settlement.networkConfig.defaultAsset.eip712.name,\n version: settlement.networkConfig.defaultAsset.eip712.version,\n chainId: settlement.networkConfig.chainId,\n verifyingContract: getAddress(settlement.asset),\n };\n\n // Build EIP-712 message\n // The \"to\" address is the SettlementRouter (not the final recipient)\n // The \"value\" MUST be total amount (business amount + facilitator fee)\n // because the Router needs to deduct the fee before passing to Hook\n const totalAmount = BigInt(settlement.amount) + BigInt(settlement.facilitatorFee);\n const message = {\n from: getAddress(settlement.from),\n to: getAddress(settlement.networkConfig.settlementRouter),\n value: totalAmount,\n validAfter: BigInt(settlement.validAfter),\n validBefore: BigInt(settlement.validBefore),\n nonce: settlement.commitment, // Use commitment as nonce\n };\n\n console.log(\"[x402x/client] EIP-712 Message for signing:\", {\n from: message.from,\n to: message.to,\n value: message.value.toString(),\n validAfter: message.validAfter.toString(),\n validBefore: message.validBefore.toString(),\n nonce: message.nonce,\n });\n\n // Sign typed data\n const signature = await signTypedData(wallet, {\n account: wallet.account,\n domain,\n types: AUTHORIZATION_TYPES,\n primaryType: \"TransferWithAuthorization\",\n message,\n });\n\n // Build authorization object\n const authorization = {\n from: settlement.from,\n to: settlement.networkConfig.settlementRouter as Address,\n value: totalAmount.toString(), // Use total amount (business + fee)\n validAfter: settlement.validAfter,\n validBefore: settlement.validBefore,\n nonce: settlement.commitment,\n };\n\n return {\n settlement,\n signature,\n authorization,\n };\n } catch (error) {\n if (error instanceof SigningError) {\n throw error;\n }\n\n // Handle common signing errors\n if (error instanceof Error) {\n if (error.message.includes(\"User rejected\")) {\n throw new SigningError(\"User rejected the signing request\", \"USER_REJECTED\");\n }\n if (error.message.includes(\"account\")) {\n throw new SigningError(\"Wallet account not available\", \"NO_ACCOUNT\");\n }\n throw new SigningError(`Failed to sign authorization: ${error.message}`, \"SIGNING_FAILED\");\n }\n\n throw new SigningError(\"Failed to sign authorization: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n","/\n Settle payment with facilitator\n \n This module handles the settlement of signed payment payloads with the\n * facilitator's /settle endpoint, following the x402 protocol.\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { settle as coreSettle, toCanonicalNetworkKey } from \"@x402x/extensions\";\nimport type {\n SignedAuthorization,\n SettleResult,\n PaymentPayload,\n PaymentRequirements,\n} from \"../types.js\";\nimport { FacilitatorError } from \"../errors.js\";\n\n/\n EVM Exact Scheme Authorization structure\n * Standard x402 v2 authorization format for EIP-3009\n /\ninterface ExactEvmAuthorization {\n from: Address;\n to: Address;\n value: string;\n validAfter: string;\n validBefore: string;\n nonce: Hex;\n}\n\n/\n EVM Exact Scheme Payload structure\n * Standard x402 v2 payload format\n /\ninterface ExactEvmPayload {\n signature: Hex;\n authorization: ExactEvmAuthorization;\n}\n\n/\n Settle signed authorization with facilitator\n \n This function acts as a convenience wrapper that:\n * 1. Constructs the PaymentPayload according to x402 protocol\n * 2. Constructs the PaymentRequirements with settlement extra\n * 3. Calls core's settle() method to POST to facilitator's /settle endpoint\n * 4. Parses and returns the settlement result\n \n @param facilitatorUrl - Facilitator URL\n * @param signed - Signed authorization from signAuthorization\n * @param timeout - Optional timeout in milliseconds (default: 30000)\n * @returns Settlement result with transaction hash\n \n @throws FacilitatorError if request fails or facilitator returns error\n \n @example\n * ```typescript\n * import { settle } from '@x402x/client';\n \n const result = await settle(\n * 'https://facilitator.x402x.dev',\n * signed\n * );\n * console.log('TX Hash:', result.transaction);\n * ```\n /\nexport async function settle(\n facilitatorUrl: string,\n signed: SignedAuthorization,\n timeout: number = 30000,\n): Promise<SettleResult> {\n try {\n // Convert network to CAIP-2 format for v2 protocol\n const canonicalNetwork = toCanonicalNetworkKey(signed.settlement.network);\n\n // Calculate total amount (business amount + facilitator fee)\n // This MUST match what was used in commitment calculation\n const totalAmount = (\n BigInt(signed.settlement.amount) + BigInt(signed.settlement.facilitatorFee)\n ).toString();\n\n // Construct standard x402 v2 PaymentPayload\n // Using standard EVM exact scheme payload structure\n const exactEvmPayload: ExactEvmPayload = {\n signature: signed.signature,\n authorization: {\n from: signed.authorization.from,\n to: signed.authorization.to,\n value: signed.authorization.value,\n validAfter: signed.authorization.validAfter,\n validBefore: signed.authorization.validBefore,\n nonce: signed.authorization.nonce,\n },\n };\n\n const paymentPayload: PaymentPayload = {\n x402Version: 2, // Use v2 protocol\n resource: {\n url: \"https://x402x.dev/serverless\",\n description: \"x402x Serverless Settlement\",\n mimeType: \"application/json\",\n },\n accepted: {\n scheme: \"exact\",\n network: canonicalNetwork as any, // Type cast required: core_v2 Network type accepts both CAIP-2 and legacy formats\n asset: signed.settlement.asset as Address,\n amount: totalAmount, // Use totalAmount to match commitment calculation\n payTo: signed.settlement.networkConfig.settlementRouter as Address,\n maxTimeoutSeconds: 300,\n extra: {},\n },\n // Standard EVM exact scheme payload\n payload: exactEvmPayload as any, // Type cast required: ExactEvmPayload structure matches v2 protocol\n };\n\n // Construct PaymentRequirements (for serverless mode verification)\n // IMPORTANT: Use totalAmount (amount + fee) to match commitment calculation\n const paymentRequirements: PaymentRequirements = {\n scheme: \"exact\",\n network: canonicalNetwork as any, // Type cast required: core_v2 Network type accepts CAIP-2 format\n amount: totalAmount, // Total amount including facilitator fee\n asset: signed.settlement.asset as Address,\n payTo: signed.settlement.networkConfig.settlementRouter as Address,\n maxTimeoutSeconds: 300, // 5 minutes\n extra: {\n name: signed.settlement.networkConfig.defaultAsset.eip712.name,\n version: signed.settlement.networkConfig.defaultAsset.eip712.version,\n settlementRouter: signed.settlement.networkConfig.settlementRouter as Address,\n salt: signed.settlement.salt,\n payTo: signed.settlement.payTo,\n facilitatorFee: signed.settlement.facilitatorFee,\n hook: signed.settlement.hook,\n hookData: signed.settlement.hookData,\n },\n };\n\n // Call core's settle method with standard x402 v2 payload structure\n const result = await coreSettle(facilitatorUrl, paymentPayload, paymentRequirements, timeout);\n\n return {\n success: result.success,\n transaction: result.transaction as Hex,\n network: result.network \|\| signed.settlement.network,\n payer: (result.payer \|\| signed.settlement.from) as Address,\n errorReason: result.errorReason,\n };\n } catch (error) {\n if (error instanceof FacilitatorError) {\n throw error;\n }\n\n // Handle errors from core settle\n if (error instanceof Error) {\n throw new FacilitatorError(`Failed to settle payment: ${error.message}`, \"SETTLEMENT_ERROR\");\n }\n\n throw new FacilitatorError(\"Failed to settle payment: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n","/\n X402Client - High-level client for x402x Serverless Mode\n \n This is the main client class that provides a simple API for executing\n * on-chain contracts via facilitator without needing a resource server.\n /\n\nimport type { Address, Hex, TransactionReceipt } from \"viem\";\nimport { calculateFacilitatorFee, type FeeCalculationResult, TransferHook } from \"@x402x/extensions\";\nimport type { X402ClientConfig, ExecuteParams, ExecuteResult } from \"./types.js\";\nimport { prepareSettlement, DEFAULT_FACILITATOR_URL } from \"./core/prepare.js\";\nimport { signAuthorization } from \"./core/sign.js\";\nimport { settle } from \"./core/settle.js\";\nimport { ValidationError, FacilitatorError } from \"./errors.js\";\nimport { normalizeAddress, validateHex, validateAmount } from \"./core/utils.js\";\n\n/\n Re-export default facilitator URL for convenience\n /\nexport { DEFAULT_FACILITATOR_URL };\n\n/\n Internal configuration with required fields\n /\ninterface InternalConfig extends X402ClientConfig {\n facilitatorUrl: string;\n timeout: number;\n confirmationTimeout: number;\n}\n\n/\n X402Client - High-level client for x402x Serverless Mode\n \n This client simplifies the entire settlement flow into a single execute() call,\n * automatically handling:\n * - Parameter preparation\n * - Commitment calculation\n * - EIP-712 signing\n * - Facilitator submission\n * - Transaction confirmation\n \n @example\n * ```typescript\n * import { X402Client } from '@x402x/client';\n * import { TransferHook } from '@x402x/core';\n * import { useWalletClient } from 'wagmi';\n \n const { data: wallet } = useWalletClient();\n \n // Use default facilitator\n * const client = new X402Client({\n * wallet,\n * network: 'base-sepolia'\n * });\n \n // Or specify custom facilitator\n * const client = new X402Client({\n * wallet,\n * network: 'base-sepolia',\n * facilitatorUrl: 'https://custom-facilitator.example.com'\n * });\n \n // Simple transfer (hook and hookData are optional)\n * const result = await client.execute({\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * ```\n /\nexport class X402Client {\n private config: InternalConfig;\n\n /\n Create a new X402Client instance\n \n @param config - Client configuration\n * @throws NetworkError if network is unsupported\n * @throws ValidationError if configuration is invalid\n /\n constructor(config: X402ClientConfig) {\n // Validate configuration\n if (!config.wallet) {\n throw new ValidationError(\"wallet is required\");\n }\n if (!config.network) {\n throw new ValidationError(\"network is required\");\n }\n\n this.config = {\n ...config,\n facilitatorUrl: config.facilitatorUrl \|\| DEFAULT_FACILITATOR_URL,\n timeout: config.timeout \|\| 30000,\n confirmationTimeout: config.confirmationTimeout \|\| 60000,\n };\n }\n\n /\n Execute a settlement transaction\n \n This is the main method that orchestrates the entire settlement flow:\n * 1. Validates parameters\n * 2. Prepares settlement data (queries fee if needed)\n * 3. Signs EIP-3009 authorization\n * 4. Submits to facilitator\n * 5. Optionally waits for transaction confirmation\n \n @param params - Execution parameters\n * @param waitForConfirmation - Whether to wait for transaction confirmation (default: true)\n * @returns Execution result with transaction hash and optional receipt\n \n @throws ValidationError if parameters are invalid\n * @throws NetworkError if network is unsupported\n * @throws SigningError if user rejects signing\n * @throws FacilitatorError if facilitator request fails\n * @throws TransactionError if transaction fails\n \n @example Simple transfer (uses TransferHook by default)\n * ```typescript\n * import { parseDefaultAssetAmount } from '@x402x/core';\n \n // Convert USD amount to atomic units\n * const atomicAmount = parseDefaultAssetAmount('1', 'base-sepolia'); // '1000000'\n \n const result = await client.execute({\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...'\n * });\n * console.log('Transaction:', result.txHash);\n * ```\n \n @example Custom hook\n * ```typescript\n * import { parseDefaultAssetAmount } from '@x402x/core';\n \n const atomicAmount = parseDefaultAssetAmount('5', 'base-sepolia'); // '5000000'\n \n const result = await client.execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...'\n * });\n * ```\n /\n async execute(\n params: ExecuteParams,\n waitForConfirmation: boolean = false,\n ): Promise<ExecuteResult> {\n // 1. Validate and normalize parameters\n const hook: Address = params.hook\n ? normalizeAddress(params.hook, \"hook\")\n : (TransferHook.getAddress(this.config.network) as Address);\n const payTo = normalizeAddress(params.payTo, \"payTo\");\n const hookData = params.hookData \|\| \"0x\";\n\n if (params.hookData) {\n validateHex(params.hookData, \"hookData\");\n }\n validateAmount(params.amount, \"amount\");\n\n // 2. Prepare settlement with normalized addresses\n const settlement = await prepareSettlement({\n wallet: this.config.wallet,\n network: this.config.network,\n hook,\n hookData,\n asset: params.asset,\n amount: params.amount,\n payTo,\n facilitatorFee: params.facilitatorFee,\n customSalt: params.customSalt,\n validAfter: params.validAfter,\n validBefore: params.validBefore,\n networkConfig: this.config.networkConfig,\n facilitatorUrl: this.config.facilitatorUrl,\n });\n\n // 3. Sign authorization\n const signed = await signAuthorization(this.config.wallet, settlement);\n\n // 4. Settle with facilitator\n const settleResult = await settle(this.config.facilitatorUrl, signed, this.config.timeout);\n\n // 5. Optionally wait for confirmation\n let receipt: TransactionReceipt \| undefined;\n if (waitForConfirmation) {\n receipt = await this.waitForTransaction(settleResult.transaction);\n }\n\n return {\n txHash: settleResult.transaction,\n network: settleResult.network,\n payer: settleResult.payer,\n receipt,\n settlement,\n };\n }\n\n /\n Calculate facilitator fee for a hook with optional hook data\n \n Queries the facilitator for the recommended fee based on current gas prices\n * and hook gas usage. The returned fee includes a safety margin to ensure\n * settlement will succeed.\n \n @param hook - Hook contract address\n * @param hookData - Optional encoded hook parameters (default: '0x')\n * @returns Fee calculation result from facilitator\n \n @throws FacilitatorError if query fails\n \n @example\n * ```typescript\n * const fee = await client.calculateFee('0x...', '0x');\n * console.log('Facilitator fee:', fee.facilitatorFee);\n * console.log('Fee in USD:', fee.facilitatorFeeUSD);\n * console.log('Valid for:', fee.validitySeconds, 'seconds');\n * ```\n /\n async calculateFee(hook: Address, hookData: Hex = \"0x\"): Promise<FeeCalculationResult> {\n const normalizedHook = normalizeAddress(hook, \"hook\");\n validateHex(hookData, \"hookData\");\n\n try {\n return await calculateFacilitatorFee(\n this.config.facilitatorUrl,\n this.config.network,\n normalizedHook,\n hookData,\n );\n } catch (error) {\n if (error instanceof Error) {\n throw new FacilitatorError(\n `Failed to calculate facilitator fee: ${error.message}`,\n \"FEE_QUERY_FAILED\",\n );\n }\n throw new FacilitatorError(\n \"Failed to calculate facilitator fee: Unknown error\",\n \"UNKNOWN_ERROR\",\n );\n }\n }\n\n /\n Wait for transaction confirmation\n \n @param txHash - Transaction hash to wait for\n * @returns Transaction receipt\n \n @throws TransactionError if transaction fails or times out\n \n @example\n * ```typescript\n * const receipt = await client.waitForTransaction('0x...');\n * console.log('Status:', receipt.status);\n * ```\n /\n async waitForTransaction(txHash: Hex): Promise<TransactionReceipt> {\n // Check if wallet has waitForTransactionReceipt method\n const publicClient = this.config.wallet as any;\n if (typeof publicClient.waitForTransactionReceipt !== \"function\") {\n throw new Error(\n \"Wallet client does not support waitForTransactionReceipt. \" +\n \"Please use a viem PublicClient or WalletClient with public actions.\",\n );\n }\n\n try {\n const receipt = await publicClient.waitForTransactionReceipt({\n hash: txHash,\n timeout: this.config.confirmationTimeout,\n });\n\n if (receipt.status !== \"success\") {\n throw new Error(`Transaction failed with status: ${receipt.status}`);\n }\n\n return receipt;\n } catch (error) {\n if (error instanceof Error) {\n throw new Error(`Failed to confirm transaction: ${error.message}`);\n }\n throw new Error(\"Failed to confirm transaction: Unknown error\");\n }\n }\n\n /\n Get the network name\n /\n get network(): string {\n return this.config.network;\n }\n\n /\n Get the facilitator URL\n /\n get facilitatorUrl(): string {\n return this.config.facilitatorUrl;\n }\n\n /\n Get the wallet client\n /\n get wallet() {\n return this.config.wallet;\n }\n}\n","/\n React hook for creating X402Client instance\n \n This hook automatically creates an X402Client instance using wagmi's\n * wallet client and chain information.\n /\n\nimport { useMemo } from \"react\";\nimport { useWalletClient, useAccount, useChainId, WagmiProviderNotFoundError } from \"wagmi\";\nimport { publicActions } from \"viem\";\nimport { X402Client } from \"../client.js\";\nimport type { X402ClientConfig } from \"../types.js\";\n\n/\n Partial configuration for useX402Client hook\n * (wallet, network, chainId are auto-detected from wagmi)\n /\nexport type UseX402ClientConfig = Partial<Omit<X402ClientConfig, \"wallet\" \| \"network\">> & {\n /* Optional: Facilitator URL (default: https://facilitator.x402x.dev/) /\n facilitatorUrl?: string;\n /* Optional: Override network name (auto-detected from chain if not provided) /\n network?: string;\n};\n\n/\n Map chainId to network name\n /\nconst CHAIN_ID_TO_NETWORK: Record<number, string> = {\n 84532: \"base-sepolia\",\n 8453: \"base\",\n 196: \"x-layer\",\n 1952: \"x-layer-testnet\",\n 97: \"bsc-testnet\",\n 56: \"bsc\",\n};\n\n/\n React hook for X402Client\n \n Automatically creates an X402Client instance using the connected wallet\n * from wagmi. Returns null if wallet is not connected.\n \n @param config - Client configuration (facilitatorUrl is optional, defaults to https://facilitator.x402x.dev/)\n * @returns X402Client instance or null if wallet not connected\n \n @example\n * ```typescript\n * import { useX402Client } from '@x402x/client';\n \n function MyComponent() {\n * // Use default facilitator\n * const client = useX402Client();\n \n // Or specify custom facilitator\n * const client = useX402Client({\n * facilitatorUrl: 'https://custom-facilitator.example.com'\n * });\n \n if (!client) {\n * return <div>Please connect your wallet</div>;\n * }\n \n const handlePay = async () => {\n * const result = await client.execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * };\n \n return <button onClick={handlePay}>Pay</button>;\n * }\n * ```\n /\nexport function useX402Client(config?: UseX402ClientConfig): X402Client \| null {\n // First, try to get wagmi hooks outside of useMemo to catch provider errors early\n let walletClient: any;\n let isConnected: boolean;\n let chainId: number;\n\n try {\n const walletClientResult = useWalletClient();\n const accountResult = useAccount();\n const chainIdResult = useChainId();\n\n walletClient = walletClientResult.data;\n isConnected = accountResult.isConnected;\n chainId = chainIdResult;\n } catch (error) {\n // If wagmi provider context is missing (e.g., during early render), return null quietly\n if (\n error instanceof WagmiProviderNotFoundError \|\|\n (error as any)?.name === \"WagmiProviderNotFoundError\" \|\|\n (error instanceof Error &&\n error.message.includes(\"useConfig\") &&\n error.message.includes(\"WagmiProvider\"))\n ) {\n return null;\n }\n\n console.warn(\"[x402x] Unable to access wagmi provider:\", error);\n return null;\n }\n\n return useMemo(() => {\n if (!isConnected \|\| !walletClient) {\n return null;\n }\n\n // Determine network name\n const network = config?.network \|\| CHAIN_ID_TO_NETWORK[chainId];\n if (!network) {\n console.warn(\n `[x402x] Unknown chainId ${chainId}. Please provide network name explicitly in config.`,\n );\n return null;\n }\n\n try {\n // Extend wallet client with public actions (required for waitForTransactionReceipt)\n const extendedWallet = walletClient.extend(publicActions);\n\n return new X402Client({\n wallet: extendedWallet,\n network,\n facilitatorUrl: config?.facilitatorUrl,\n networkConfig: config?.networkConfig,\n timeout: config?.timeout,\n confirmationTimeout: config?.confirmationTimeout,\n });\n } catch (error) {\n console.error(\"[x402x] Failed to create X402Client:\", error);\n return null;\n }\n }, [\n isConnected,\n walletClient,\n chainId,\n config?.network,\n config?.facilitatorUrl,\n config?.networkConfig,\n config?.timeout,\n config?.confirmationTimeout,\n ]);\n}\n","/\n React hook for executing settlements\n \n This hook provides a simple interface for executing settlements with\n * automatic state management (status, error, result).\n /\n\nimport { useState, useCallback } from \"react\";\nimport { useX402Client, type UseX402ClientConfig } from \"./useX402Client.js\";\nimport type { ExecuteParams, ExecuteResult, ExecuteStatus } from \"../types.js\";\n\n/\n Return type for useExecute hook\n /\nexport interface UseExecuteReturn {\n /* Execute a settlement /\n execute: (params: ExecuteParams, waitForConfirmation?: boolean) => Promise<ExecuteResult>;\n /* Current execution status /\n status: ExecuteStatus;\n /* Error if execution failed /\n error: Error \| null;\n /* Result if execution succeeded /\n result: ExecuteResult \| null;\n /* Reset state /\n reset: () => void;\n /* Whether currently executing /\n isExecuting: boolean;\n /* Whether execution succeeded /\n isSuccess: boolean;\n /* Whether execution failed /\n isError: boolean;\n}\n\n/\n React hook for executing settlements\n \n Provides a simple interface for executing settlements with automatic\n * state management. Automatically uses the connected wallet from wagmi.\n \n @param config - Optional client configuration (if not using global client)\n * @returns Execute function and state\n \n @example\n * ```typescript\n * import { useExecute } from '@x402x/client';\n * import { TransferHook } from '@x402x/core';\n \n function PayButton() {\n * const { execute, status, error, result } = useExecute({\n * facilitatorUrl: 'https://facilitator.x402x.dev'\n * });\n \n const handlePay = async () => {\n * try {\n * // Simple transfer (hook and hookData are optional)\n * const result = await execute({\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * console.log('Success:', result.txHash);\n * } catch (err) {\n * console.error('Failed:', err);\n * }\n * };\n \n return (\n * <div>\n * <button onClick={handlePay} disabled={status !== 'idle'}>\n * {status === 'idle' ? 'Pay' : 'Processing...'}\n * </button>\n * {status === 'success' && <div>✅ Success! TX: {result.txHash}</div>}\n * {status === 'error' && <div>❌ Error: {error.message}</div>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useExecute(config?: UseX402ClientConfig): UseExecuteReturn {\n const client = useX402Client(config);\n const [status, setStatus] = useState<ExecuteStatus>(\"idle\");\n const [error, setError] = useState<Error \| null>(null);\n const [result, setResult] = useState<ExecuteResult \| null>(null);\n\n const execute = useCallback(\n async (params: ExecuteParams, waitForConfirmation: boolean = true): Promise<ExecuteResult> => {\n if (!client) {\n throw new Error(\"X402Client not available. Please connect your wallet.\");\n }\n\n setStatus(\"preparing\");\n setError(null);\n setResult(null);\n\n try {\n const executeResult = await client.execute(params, waitForConfirmation);\n setStatus(\"success\");\n setResult(executeResult);\n return executeResult;\n } catch (err) {\n const error = err instanceof Error ? err : new Error(\"Unknown error\");\n setStatus(\"error\");\n setError(error);\n throw error;\n }\n },\n [client],\n );\n\n const reset = useCallback(() => {\n setStatus(\"idle\");\n setError(null);\n setResult(null);\n }, []);\n\n return {\n execute,\n status,\n error,\n result,\n reset,\n isExecuting: [\"preparing\", \"signing\", \"submitting\", \"confirming\"].includes(status),\n isSuccess: status === \"success\",\n isError: status === \"error\",\n };\n}\n\n/\n Alternative hook that doesn't require config (uses default client from context)\n \n @example\n * ```typescript\n * import { useExecute } from '@x402x/client';\n \n function PayButton({ facilitatorUrl }: { facilitatorUrl: string }) {\n * const { execute, status, error } = useExecute({ facilitatorUrl });\n \n const handlePay = async () => {\n * await execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: '1000000',\n * recipient: '0x...'\n * });\n * };\n \n return (\n * <button onClick={handlePay} disabled={status !== 'idle'}>\n * Pay\n * </button>\n * );\n * }\n * ```\n */\nexport function useExecuteWithClient(\n client: ReturnType<typeof useX402Client>,\n): Omit<UseExecuteReturn, \"reset\"> {\n const [status, setStatus] = useState<ExecuteStatus>(\"idle\");\n const [error, setError] = useState<Error \| null>(null);\n const [result, setResult] = useState<ExecuteResult \| null>(null);\n\n const execute = useCallback(\n async (params: ExecuteParams, waitForConfirmation: boolean = true): Promise<ExecuteResult> => {\n if (!client) {\n throw new Error(\"X402Client not available. Please connect your wallet.\");\n }\n\n setStatus(\"preparing\");\n setError(null);\n setResult(null);\n\n try {\n const executeResult = await client.execute(params, waitForConfirmation);\n setStatus(\"success\");\n setResult(executeResult);\n return executeResult;\n } catch (err) {\n const error = err instanceof Error ? err : new Error(\"Unknown error\");\n setStatus(\"error\");\n setError(error);\n throw error;\n }\n },\n [client],\n );\n\n return {\n execute,\n status,\n error,\n result,\n isExecuting: [\"preparing\", \"signing\", \"submitting\", \"confirming\"].includes(status),\n isSuccess: status === \"success\",\n isError: status === \"error\",\n };\n}\n"]}
1	+ {"version":3,"sources":["../src/errors.ts","../src/core/utils.ts","../src/core/prepare.ts","../src/core/sign.ts","../src/core/settle.ts","../src/client.ts","../src/hooks/useX402xClient.ts","../src/hooks/useExecute.ts"],"names":["getAddress","isAddress","calculateFacilitatorFee","getNetworkConfig","calculateCommitment","signTypedData","toCanonicalNetworkKey","coreSettle","TransferHook","useWalletClient","useAccount","useChainId","WagmiProviderNotFoundError","useMemo","publicActions","useState","useCallback","error"],"mappings":"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","file":"index.cjs","sourcesContent":["/*\n Error classes for x402x client SDK\n /\n\n/\n Base error class for all x402x client errors\n /\nexport class X402ClientError extends Error {\n constructor(\n message: string,\n public readonly code?: string,\n ) {\n super(message);\n this.name = \"X402ClientError\";\n Object.setPrototypeOf(this, X402ClientError.prototype);\n }\n}\n\n/\n Network-related errors (unsupported network, configuration issues)\n /\nexport class NetworkError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"NetworkError\";\n Object.setPrototypeOf(this, NetworkError.prototype);\n }\n}\n\n/\n Wallet signing errors\n /\nexport class SigningError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"SigningError\";\n Object.setPrototypeOf(this, SigningError.prototype);\n }\n}\n\n/\n Facilitator communication errors\n /\nexport class FacilitatorError extends X402ClientError {\n constructor(\n message: string,\n code?: string,\n public readonly statusCode?: number,\n public readonly response?: unknown,\n ) {\n super(message, code);\n this.name = \"FacilitatorError\";\n Object.setPrototypeOf(this, FacilitatorError.prototype);\n }\n}\n\n/\n Transaction execution errors\n /\nexport class TransactionError extends X402ClientError {\n constructor(\n message: string,\n code?: string,\n public readonly txHash?: string,\n ) {\n super(message, code);\n this.name = \"TransactionError\";\n Object.setPrototypeOf(this, TransactionError.prototype);\n }\n}\n\n/\n Parameter validation errors\n /\nexport class ValidationError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"ValidationError\";\n Object.setPrototypeOf(this, ValidationError.prototype);\n }\n}\n","/\n Utility functions for x402x client\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { getAddress, isAddress } from \"viem\";\nimport { ValidationError } from \"../errors.js\";\n\n/\n Generate a random 32-byte salt for settlement idempotency\n \n @returns Random 32-byte hex string\n \n @example\n * ```typescript\n * const salt = generateSalt();\n * console.log(salt); // \"0x1234...\"\n * ```\n /\nexport function generateSalt(): Hex {\n const cryptoObj = (globalThis as any).crypto as Crypto \| undefined;\n\n if (!cryptoObj \|\| !cryptoObj.getRandomValues) {\n throw new Error(\"crypto.getRandomValues is not available\");\n }\n\n const randomBytes = cryptoObj.getRandomValues(new Uint8Array(32));\n return `0x${Array.from(randomBytes)\n .map((b) => b.toString(16).padStart(2, \"0\"))\n .join(\"\")}` as Hex;\n}\n\n/\n Normalize Ethereum address to EIP-55 checksum format\n \n Automatically converts any valid Ethereum address (lowercase, uppercase, or mixed)\n * to the proper checksummed format. This provides a better developer experience\n * by accepting addresses in any case format.\n \n @param address - Address to normalize (can be any case)\n * @param name - Parameter name for error messages (optional)\n * @returns Checksummed address in EIP-55 format\n * @throws ValidationError if address is invalid\n \n @example\n * ```typescript\n * normalizeAddress('0xabc123...') // Returns '0xAbC123...' (checksummed)\n * normalizeAddress('0xABC123...') // Returns '0xAbC123...' (checksummed)\n * normalizeAddress('0xAbC123...') // Returns '0xAbC123...' (already checksummed)\n * ```\n /\nexport function normalizeAddress(address: string, name: string = \"address\"): Address {\n if (!address \|\| typeof address !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n\n // Convert to EIP-55 checksum format\n // getAddress() will throw if the address is invalid\n try {\n return getAddress(address);\n } catch (error) {\n throw new ValidationError(\n `${name} is not a valid Ethereum address: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n );\n }\n}\n\n/\n Validate Ethereum address format (legacy, prefer normalizeAddress)\n \n @deprecated Use normalizeAddress() instead for better developer experience\n * @param address - Address to validate\n * @param name - Parameter name for error messages\n * @throws ValidationError if address is invalid\n /\nexport function validateAddress(address: string, name: string): void {\n if (!address \|\| typeof address !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n if (!isAddress(address)) {\n throw new ValidationError(`${name} must be a valid Ethereum address`);\n }\n}\n\n/\n Validate hex string format\n \n @param hex - Hex string to validate\n * @param name - Parameter name for error messages\n * @param expectedLength - Optional expected length (in bytes, not characters)\n * @throws ValidationError if hex is invalid\n /\nexport function validateHex(hex: string, name: string, expectedLength?: number): void {\n if (!hex \|\| typeof hex !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n if (!hex.startsWith(\"0x\")) {\n throw new ValidationError(`${name} must start with 0x`);\n }\n if (!/^0x[0-9a-fA-F]$/.test(hex)) {\n throw new ValidationError(`${name} must be a valid hex string`);\n }\n if (expectedLength !== undefined) {\n const actualLength = (hex.length - 2) / 2;\n if (actualLength !== expectedLength) {\n throw new ValidationError(\n `${name} must be ${expectedLength} bytes, got ${actualLength} bytes`,\n );\n }\n }\n}\n\n/*\n Validate amount format - must be atomic units (positive integer string)\n \n This function validates that the amount is a valid atomic unit string.\n * For converting USD amounts to atomic units, use parseDefaultAssetAmount from @x402x/core.\n \n @param amount - Amount in atomic units (must be a positive integer string)\n * @param name - Parameter name for error messages\n * @throws ValidationError if amount is invalid\n \n @example\n * ```typescript\n * validateAmount('1000000', 'amount'); // Valid: atomic units\n * validateAmount('0.1', 'amount'); // Invalid: not atomic units\n * validateAmount('-1', 'amount'); // Invalid: negative\n * ```\n /\nexport function validateAmount(amount: string \| number, name: string): void {\n if (amount === null \|\| amount === undefined \|\| amount === \"\") {\n throw new ValidationError(`${name} is required`);\n }\n\n // Convert to string if number\n const amountStr = typeof amount === \"number\" ? amount.toString() : amount;\n\n // Must be a non-empty string\n if (typeof amountStr !== \"string\" \|\| amountStr.trim() === \"\") {\n throw new ValidationError(`${name} must be a non-empty string`);\n }\n\n // Must be a valid positive integer (atomic units)\n // Allow leading zeros but must be numeric\n if (!/^\\d+$/.test(amountStr)) {\n throw new ValidationError(\n `${name} must be a positive integer string (atomic units). ` +\n `Use parseDefaultAssetAmount() from @x402x/core to convert USD amounts.`,\n );\n }\n\n // Validate it can be converted to BigInt (no overflow)\n try {\n const atomicAmount = BigInt(amountStr);\n if (atomicAmount < 0n) {\n throw new ValidationError(`${name} cannot be negative`);\n }\n if (atomicAmount === 0n) {\n throw new ValidationError(`${name} cannot be zero`);\n }\n } catch (error) {\n if (error instanceof ValidationError) {\n throw error;\n }\n throw new ValidationError(\n `${name} is not a valid amount: ${error instanceof Error ? error.message : \"Invalid format\"}`,\n );\n }\n}\n\n/\n Format facilitator URL (ensure it doesn't end with slash)\n \n @param url - Facilitator URL\n * @returns Formatted URL\n /\nexport function formatFacilitatorUrl(url: string): string {\n return url.endsWith(\"/\") ? url.slice(0, -1) : url;\n}\n\n/\n Calculate default time window for authorization\n \n @param maxTimeoutSeconds - Maximum timeout in seconds\n * @returns Object with validAfter and validBefore timestamps\n /\nexport function calculateTimeWindow(maxTimeoutSeconds: number = 300): {\n validAfter: string;\n validBefore: string;\n} {\n const now = Math.floor(Date.now() / 1000);\n return {\n validAfter: (now - 600).toString(), // 10 minutes before\n validBefore: (now + maxTimeoutSeconds).toString(),\n };\n}\n","/\n Prepare settlement data for signing\n \n This module handles the preparation of settlement parameters before signing,\n * including generating salt, calculating commitment hash, and fetching facilitator fees.\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { getNetworkConfig, calculateFacilitatorFee, type FeeCalculationResult } from \"@x402x/extensions\";\nimport { calculateCommitment } from \"@x402x/extensions\";\nimport type { PrepareParams, SettlementData } from \"../types.js\";\nimport { NetworkError, ValidationError, FacilitatorError } from \"../errors.js\";\nimport {\n generateSalt,\n validateAddress,\n validateHex,\n validateAmount,\n calculateTimeWindow,\n} from \"./utils.js\";\n\n/\n Default facilitator URL\n /\nexport const DEFAULT_FACILITATOR_URL = \"https://facilitator.x402x.dev\";\n\n/\n Query facilitator fee from facilitator service (internal helper)\n \n Uses the /calculate-fee endpoint which provides accurate gas cost estimates\n * with safety margins.\n \n @internal\n * @param facilitatorUrl - Facilitator URL\n * @param network - Network name\n * @param hook - Hook contract address\n * @param hookData - Optional encoded hook parameters (default: '0x')\n * @returns Fee calculation result\n \n @throws FacilitatorError if request fails\n /\nasync function queryFacilitatorFee(\n facilitatorUrl: string,\n network: string,\n hook: Address,\n hookData: Hex = \"0x\",\n): Promise<FeeCalculationResult> {\n try {\n return await calculateFacilitatorFee(facilitatorUrl, network, hook, hookData);\n } catch (error) {\n if (error instanceof Error) {\n throw new FacilitatorError(\n `Failed to query facilitator fee: ${error.message}`,\n \"FEE_QUERY_FAILED\",\n );\n }\n throw new FacilitatorError(\"Failed to query facilitator fee: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n\n/\n Prepare settlement data for signing\n \n This function:\n * 1. Validates all parameters\n * 2. Loads network configuration\n * 3. Generates salt (if not provided)\n * 4. Queries facilitator fee (if not provided)\n * 5. Calculates time window (if not provided)\n * 6. Calculates commitment hash\n * 7. Returns prepared settlement data\n \n @param params - Preparation parameters\n * @returns Prepared settlement data ready for signing\n \n @throws NetworkError if network is unsupported\n * @throws ValidationError if parameters are invalid\n \n @example\n * ```typescript\n * import { prepareSettlement } from '@x402x/client';\n * import { TransferHook, parseDefaultAssetAmount } from '@x402x/core';\n \n // Convert USD amount to atomic units first\n * const atomicAmount = parseDefaultAssetAmount('1', 'base-sepolia'); // '1000000'\n \n const settlement = await prepareSettlement({\n * wallet: walletClient,\n * network: 'base-sepolia',\n * hook: TransferHook.getAddress('base-sepolia'),\n * hookData: TransferHook.encode(),\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...',\n * facilitatorUrl: 'https://facilitator.x402x.dev'\n * });\n * ```\n /\nexport async function prepareSettlement(params: PrepareParams): Promise<SettlementData> {\n // 1. Validate parameters\n validateAddress(params.hook, \"hook\");\n validateHex(params.hookData, \"hookData\");\n validateAddress(params.payTo, \"payTo\");\n\n // 2. Validate amount (must be atomic units, no automatic conversion)\n validateAmount(params.amount, \"amount\");\n const atomicAmount = params.amount;\n\n if (params.customSalt) {\n validateHex(params.customSalt, \"customSalt\", 32);\n }\n\n // 2. Get wallet account address\n const from = params.wallet.account?.address;\n if (!from) {\n throw new ValidationError(\"Wallet client must have an account\");\n }\n\n // 3. Load network configuration\n const networkConfig = params.networkConfig \|\| getNetworkConfig(params.network);\n if (!networkConfig) {\n throw new NetworkError(\n `Network '${params.network}' is not supported. Please provide custom networkConfig.`,\n );\n }\n\n // 4. Determine asset address (use provided asset or default asset)\n const asset = params.asset \|\| (networkConfig.defaultAsset.address as Address);\n validateAddress(asset, \"asset\");\n\n // 5. Generate salt (if not provided)\n const salt = params.customSalt \|\| generateSalt();\n\n // 6. Query facilitator fee (if not provided)\n // Use the provided facilitatorUrl or fall back to default\n let facilitatorFee = params.facilitatorFee \|\| \"0\";\n if (!params.facilitatorFee) {\n const facilitatorUrl = params.facilitatorUrl \|\| DEFAULT_FACILITATOR_URL;\n try {\n const feeEstimate = await queryFacilitatorFee(\n facilitatorUrl,\n params.network,\n params.hook,\n params.hookData, // Pass hookData for accurate fee calculation\n );\n\n if (!feeEstimate.hookAllowed) {\n throw new ValidationError(\n `Hook ${params.hook} is not allowed on network ${params.network}.`,\n );\n }\n\n facilitatorFee = feeEstimate.facilitatorFee;\n } catch (error) {\n // If fee query fails, log warning and use 0\n console.warn(\n `[x402x] Failed to query facilitator fee, using 0. This may cause settlement to fail. Error: ${\n error instanceof Error ? error.message : \"Unknown\"\n }`,\n );\n facilitatorFee = \"0\";\n }\n }\n\n // 7. Calculate time window (if not provided)\n const timeWindow =\n params.validAfter && params.validBefore\n ? { validAfter: params.validAfter, validBefore: params.validBefore }\n : calculateTimeWindow(300); // 5 minutes default\n\n // 8. Calculate commitment hash\n // IMPORTANT: value must be total amount (business amount + facilitator fee)\n // because the contract's calculateCommitment expects the same value that\n // will be authorized in the EIP-3009 signature\n const totalAmount = (BigInt(atomicAmount) + BigInt(facilitatorFee)).toString();\n const commitment = calculateCommitment({\n chainId: networkConfig.chainId,\n hub: networkConfig.settlementRouter as Address,\n asset: asset,\n from,\n value: totalAmount,\n validAfter: timeWindow.validAfter,\n validBefore: timeWindow.validBefore,\n salt,\n payTo: params.payTo,\n facilitatorFee,\n hook: params.hook,\n hookData: params.hookData,\n });\n\n // 9. Return prepared settlement data\n // Use original network name for API compatibility; conversion to canonical format happens during settlement\n return {\n network: params.network,\n networkConfig,\n asset: asset,\n from,\n amount: atomicAmount,\n validAfter: timeWindow.validAfter,\n validBefore: timeWindow.validBefore,\n salt,\n payTo: params.payTo,\n facilitatorFee,\n hook: params.hook,\n hookData: params.hookData,\n commitment: commitment as Hex,\n };\n}\n","/\n Sign EIP-3009 authorization for settlement\n \n This module handles the signing of EIP-712 typed data for EIP-3009\n * transferWithAuthorization, using the commitment hash as the nonce.\n /\n\nimport type { Address, WalletClient } from \"viem\";\nimport { getAddress } from \"viem\";\nimport { signTypedData } from \"viem/actions\";\nimport type { SettlementData, SignedAuthorization } from \"../types.js\";\nimport { SigningError } from \"../errors.js\";\n\n/\n EIP-3009 authorization types for EIP-712 signature\n /\nconst AUTHORIZATION_TYPES = {\n TransferWithAuthorization: [\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/\n Sign EIP-3009 authorization\n \n This function signs an EIP-712 typed data message for EIP-3009's\n * transferWithAuthorization function. The commitment hash is used\n * as the nonce to cryptographically bind all settlement parameters.\n \n @param wallet - Wallet client from wagmi/viem\n * @param settlement - Prepared settlement data\n * @returns Signed authorization ready to submit\n \n @throws SigningError if signing fails or wallet doesn't support signing\n \n @example\n * ```typescript\n * import { signAuthorization } from '@x402x/client';\n \n const signed = await signAuthorization(walletClient, settlement);\n * console.log('Signature:', signed.signature);\n * ```\n /\nexport async function signAuthorization(\n wallet: WalletClient,\n settlement: SettlementData,\n): Promise<SignedAuthorization> {\n try {\n // Ensure wallet has an account\n if (!wallet.account) {\n throw new SigningError(\"Wallet client must have an account\");\n }\n\n // Build EIP-712 domain\n // Use the asset's EIP-712 domain info from network config\n // Note: For custom assets, the domain info should match the asset contract\n const domain = {\n name: settlement.networkConfig.defaultAsset.eip712.name,\n version: settlement.networkConfig.defaultAsset.eip712.version,\n chainId: settlement.networkConfig.chainId,\n verifyingContract: getAddress(settlement.asset),\n };\n\n // Build EIP-712 message\n // The \"to\" address is the SettlementRouter (not the final recipient)\n // The \"value\" MUST be total amount (business amount + facilitator fee)\n // because the Router needs to deduct the fee before passing to Hook\n const totalAmount = BigInt(settlement.amount) + BigInt(settlement.facilitatorFee);\n const message = {\n from: getAddress(settlement.from),\n to: getAddress(settlement.networkConfig.settlementRouter),\n value: totalAmount,\n validAfter: BigInt(settlement.validAfter),\n validBefore: BigInt(settlement.validBefore),\n nonce: settlement.commitment, // Use commitment as nonce\n };\n\n console.log(\"[x402x/client] EIP-712 Message for signing:\", {\n from: message.from,\n to: message.to,\n value: message.value.toString(),\n validAfter: message.validAfter.toString(),\n validBefore: message.validBefore.toString(),\n nonce: message.nonce,\n });\n\n // Sign typed data\n const signature = await signTypedData(wallet, {\n account: wallet.account,\n domain,\n types: AUTHORIZATION_TYPES,\n primaryType: \"TransferWithAuthorization\",\n message,\n });\n\n // Build authorization object\n const authorization = {\n from: settlement.from,\n to: settlement.networkConfig.settlementRouter as Address,\n value: totalAmount.toString(), // Use total amount (business + fee)\n validAfter: settlement.validAfter,\n validBefore: settlement.validBefore,\n nonce: settlement.commitment,\n };\n\n return {\n settlement,\n signature,\n authorization,\n };\n } catch (error) {\n if (error instanceof SigningError) {\n throw error;\n }\n\n // Handle common signing errors\n if (error instanceof Error) {\n if (error.message.includes(\"User rejected\")) {\n throw new SigningError(\"User rejected the signing request\", \"USER_REJECTED\");\n }\n if (error.message.includes(\"account\")) {\n throw new SigningError(\"Wallet account not available\", \"NO_ACCOUNT\");\n }\n throw new SigningError(`Failed to sign authorization: ${error.message}`, \"SIGNING_FAILED\");\n }\n\n throw new SigningError(\"Failed to sign authorization: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n","/\n Settle payment with facilitator\n \n This module handles the settlement of signed payment payloads with the\n * facilitator's /settle endpoint, following the x402 protocol.\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { settle as coreSettle, toCanonicalNetworkKey } from \"@x402x/extensions\";\nimport type {\n SignedAuthorization,\n SettleResult,\n PaymentPayload,\n PaymentRequirements,\n} from \"../types.js\";\nimport { FacilitatorError } from \"../errors.js\";\n\n/\n EVM Exact Scheme Authorization structure\n * Standard x402 v2 authorization format for EIP-3009\n /\ninterface ExactEvmAuthorization {\n from: Address;\n to: Address;\n value: string;\n validAfter: string;\n validBefore: string;\n nonce: Hex;\n}\n\n/\n EVM Exact Scheme Payload structure\n * Standard x402 v2 payload format\n /\ninterface ExactEvmPayload {\n signature: Hex;\n authorization: ExactEvmAuthorization;\n}\n\n/\n Settle signed authorization with facilitator\n \n This function acts as a convenience wrapper that:\n * 1. Constructs the PaymentPayload according to x402 protocol\n * 2. Constructs the PaymentRequirements with settlement extra\n * 3. Calls core's settle() method to POST to facilitator's /settle endpoint\n * 4. Parses and returns the settlement result\n \n @param facilitatorUrl - Facilitator URL\n * @param signed - Signed authorization from signAuthorization\n * @param timeout - Optional timeout in milliseconds (default: 30000)\n * @returns Settlement result with transaction hash\n \n @throws FacilitatorError if request fails or facilitator returns error\n \n @example\n * ```typescript\n * import { settle } from '@x402x/client';\n \n const result = await settle(\n * 'https://facilitator.x402x.dev',\n * signed\n * );\n * console.log('TX Hash:', result.transaction);\n * ```\n /\nexport async function settle(\n facilitatorUrl: string,\n signed: SignedAuthorization,\n timeout: number = 30000,\n): Promise<SettleResult> {\n try {\n // Convert network to CAIP-2 format for v2 protocol\n const canonicalNetwork = toCanonicalNetworkKey(signed.settlement.network);\n\n // Calculate total amount (business amount + facilitator fee)\n // This MUST match what was used in commitment calculation\n const totalAmount = (\n BigInt(signed.settlement.amount) + BigInt(signed.settlement.facilitatorFee)\n ).toString();\n\n // Construct standard x402 v2 PaymentPayload\n // Using standard EVM exact scheme payload structure\n const exactEvmPayload: ExactEvmPayload = {\n signature: signed.signature,\n authorization: {\n from: signed.authorization.from,\n to: signed.authorization.to,\n value: signed.authorization.value,\n validAfter: signed.authorization.validAfter,\n validBefore: signed.authorization.validBefore,\n nonce: signed.authorization.nonce,\n },\n };\n\n const paymentPayload: PaymentPayload = {\n x402Version: 2, // Use v2 protocol\n resource: {\n url: \"https://x402x.dev/serverless\",\n description: \"x402x Serverless Settlement\",\n mimeType: \"application/json\",\n },\n accepted: {\n scheme: \"exact\",\n network: canonicalNetwork as any, // Type cast required: core_v2 Network type accepts both CAIP-2 and legacy formats\n asset: signed.settlement.asset as Address,\n amount: totalAmount, // Use totalAmount to match commitment calculation\n payTo: signed.settlement.networkConfig.settlementRouter as Address,\n maxTimeoutSeconds: 300,\n extra: {},\n },\n // Standard EVM exact scheme payload\n payload: exactEvmPayload as any, // Type cast required: ExactEvmPayload structure matches v2 protocol\n };\n\n // Construct PaymentRequirements (for serverless mode verification)\n // IMPORTANT: Use totalAmount (amount + fee) to match commitment calculation\n const paymentRequirements: PaymentRequirements = {\n scheme: \"exact\",\n network: canonicalNetwork as any, // Type cast required: core_v2 Network type accepts CAIP-2 format\n amount: totalAmount, // Total amount including facilitator fee\n asset: signed.settlement.asset as Address,\n payTo: signed.settlement.networkConfig.settlementRouter as Address,\n maxTimeoutSeconds: 300, // 5 minutes\n extra: {\n name: signed.settlement.networkConfig.defaultAsset.eip712.name,\n version: signed.settlement.networkConfig.defaultAsset.eip712.version,\n settlementRouter: signed.settlement.networkConfig.settlementRouter as Address,\n salt: signed.settlement.salt,\n payTo: signed.settlement.payTo,\n facilitatorFee: signed.settlement.facilitatorFee,\n hook: signed.settlement.hook,\n hookData: signed.settlement.hookData,\n },\n };\n\n // Call core's settle method with standard x402 v2 payload structure\n const result = await coreSettle(facilitatorUrl, paymentPayload, paymentRequirements, timeout);\n\n return {\n success: result.success,\n transaction: result.transaction as Hex,\n network: result.network \|\| signed.settlement.network,\n payer: (result.payer \|\| signed.settlement.from) as Address,\n errorReason: result.errorReason,\n };\n } catch (error) {\n if (error instanceof FacilitatorError) {\n throw error;\n }\n\n // Handle errors from core settle\n if (error instanceof Error) {\n throw new FacilitatorError(`Failed to settle payment: ${error.message}`, \"SETTLEMENT_ERROR\");\n }\n\n throw new FacilitatorError(\"Failed to settle payment: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n","/\n x402xClient - High-level client for x402x Serverless Mode\n \n This is the main client class that provides a simple API for executing\n * on-chain contracts via facilitator without needing a resource server.\n /\n\nimport type { Address, Hex, TransactionReceipt } from \"viem\";\nimport { calculateFacilitatorFee, type FeeCalculationResult, TransferHook } from \"@x402x/extensions\";\nimport type { x402xClientConfig, ExecuteParams, ExecuteResult } from \"./types.js\";\nimport { prepareSettlement, DEFAULT_FACILITATOR_URL } from \"./core/prepare.js\";\nimport { signAuthorization } from \"./core/sign.js\";\nimport { settle } from \"./core/settle.js\";\nimport { ValidationError, FacilitatorError } from \"./errors.js\";\nimport { normalizeAddress, validateHex, validateAmount } from \"./core/utils.js\";\n\n/\n Re-export default facilitator URL for convenience\n /\nexport { DEFAULT_FACILITATOR_URL };\n\n/\n Internal configuration with required fields\n /\ninterface InternalConfig extends x402xClientConfig {\n facilitatorUrl: string;\n timeout: number;\n confirmationTimeout: number;\n}\n\n/\n x402xClient - High-level client for x402x Serverless Mode\n \n This client simplifies the entire settlement flow into a single execute() call,\n * automatically handling:\n * - Parameter preparation\n * - Commitment calculation\n * - EIP-712 signing\n * - Facilitator submission\n * - Transaction confirmation\n \n @example\n * ```typescript\n * import { x402xClient } from '@x402x/client';\n * import { TransferHook } from '@x402x/extensions';\n * import { useWalletClient } from 'wagmi';\n \n const { data: wallet } = useWalletClient();\n \n // Use default facilitator\n * const client = new x402xClient({\n * wallet,\n * network: 'base-sepolia'\n * });\n \n // Or specify custom facilitator\n * const client = new X402Client({\n * wallet,\n * network: 'base-sepolia',\n * facilitatorUrl: 'https://custom-facilitator.example.com'\n * });\n \n // Simple transfer (hook and hookData are optional)\n * const result = await client.execute({\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * ```\n /\nexport class x402xClient {\n private config: InternalConfig;\n\n /\n Create a new x402xClient instance\n \n @param config - Client configuration\n * @throws NetworkError if network is unsupported\n * @throws ValidationError if configuration is invalid\n /\n constructor(config: x402xClientConfig) {\n // Validate configuration\n if (!config.wallet) {\n throw new ValidationError(\"wallet is required\");\n }\n if (!config.network) {\n throw new ValidationError(\"network is required\");\n }\n\n this.config = {\n ...config,\n facilitatorUrl: config.facilitatorUrl \|\| DEFAULT_FACILITATOR_URL,\n timeout: config.timeout \|\| 30000,\n confirmationTimeout: config.confirmationTimeout \|\| 60000,\n };\n }\n\n /\n Execute a settlement transaction\n \n This is the main method that orchestrates the entire settlement flow:\n * 1. Validates parameters\n * 2. Prepares settlement data (queries fee if needed)\n * 3. Signs EIP-3009 authorization\n * 4. Submits to facilitator\n * 5. Optionally waits for transaction confirmation\n \n @param params - Execution parameters\n * @param waitForConfirmation - Whether to wait for transaction confirmation (default: true)\n * @returns Execution result with transaction hash and optional receipt\n \n @throws ValidationError if parameters are invalid\n * @throws NetworkError if network is unsupported\n * @throws SigningError if user rejects signing\n * @throws FacilitatorError if facilitator request fails\n * @throws TransactionError if transaction fails\n \n @example Simple transfer (uses TransferHook by default)\n * ```typescript\n * import { parseDefaultAssetAmount } from '@x402x/core';\n \n // Convert USD amount to atomic units\n * const atomicAmount = parseDefaultAssetAmount('1', 'base-sepolia'); // '1000000'\n \n const result = await client.execute({\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...'\n * });\n * console.log('Transaction:', result.txHash);\n * ```\n \n @example Custom hook\n * ```typescript\n * import { parseDefaultAssetAmount } from '@x402x/core';\n \n const atomicAmount = parseDefaultAssetAmount('5', 'base-sepolia'); // '5000000'\n \n const result = await client.execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...'\n * });\n * ```\n /\n async execute(\n params: ExecuteParams,\n waitForConfirmation: boolean = false,\n ): Promise<ExecuteResult> {\n // 1. Validate and normalize parameters\n const hook: Address = params.hook\n ? normalizeAddress(params.hook, \"hook\")\n : (TransferHook.getAddress(this.config.network) as Address);\n const payTo = normalizeAddress(params.payTo, \"payTo\");\n const hookData = params.hookData \|\| \"0x\";\n\n if (params.hookData) {\n validateHex(params.hookData, \"hookData\");\n }\n validateAmount(params.amount, \"amount\");\n\n // 2. Prepare settlement with normalized addresses\n const settlement = await prepareSettlement({\n wallet: this.config.wallet,\n network: this.config.network,\n hook,\n hookData,\n asset: params.asset,\n amount: params.amount,\n payTo,\n facilitatorFee: params.facilitatorFee,\n customSalt: params.customSalt,\n validAfter: params.validAfter,\n validBefore: params.validBefore,\n networkConfig: this.config.networkConfig,\n facilitatorUrl: this.config.facilitatorUrl,\n });\n\n // 3. Sign authorization\n const signed = await signAuthorization(this.config.wallet, settlement);\n\n // 4. Settle with facilitator\n const settleResult = await settle(this.config.facilitatorUrl, signed, this.config.timeout);\n\n // 5. Optionally wait for confirmation\n let receipt: TransactionReceipt \| undefined;\n if (waitForConfirmation) {\n receipt = await this.waitForTransaction(settleResult.transaction);\n }\n\n return {\n txHash: settleResult.transaction,\n network: settleResult.network,\n payer: settleResult.payer,\n receipt,\n settlement,\n };\n }\n\n /\n Calculate facilitator fee for a hook with optional hook data\n \n Queries the facilitator for the recommended fee based on current gas prices\n * and hook gas usage. The returned fee includes a safety margin to ensure\n * settlement will succeed.\n \n @param hook - Hook contract address\n * @param hookData - Optional encoded hook parameters (default: '0x')\n * @returns Fee calculation result from facilitator\n \n @throws FacilitatorError if query fails\n \n @example\n * ```typescript\n * const fee = await client.calculateFee('0x...', '0x');\n * console.log('Facilitator fee:', fee.facilitatorFee);\n * console.log('Fee in USD:', fee.facilitatorFeeUSD);\n * console.log('Valid for:', fee.validitySeconds, 'seconds');\n * ```\n /\n async calculateFee(hook: Address, hookData: Hex = \"0x\"): Promise<FeeCalculationResult> {\n const normalizedHook = normalizeAddress(hook, \"hook\");\n validateHex(hookData, \"hookData\");\n\n try {\n return await calculateFacilitatorFee(\n this.config.facilitatorUrl,\n this.config.network,\n normalizedHook,\n hookData,\n );\n } catch (error) {\n if (error instanceof Error) {\n throw new FacilitatorError(\n `Failed to calculate facilitator fee: ${error.message}`,\n \"FEE_QUERY_FAILED\",\n );\n }\n throw new FacilitatorError(\n \"Failed to calculate facilitator fee: Unknown error\",\n \"UNKNOWN_ERROR\",\n );\n }\n }\n\n /\n Wait for transaction confirmation\n \n @param txHash - Transaction hash to wait for\n * @returns Transaction receipt\n \n @throws TransactionError if transaction fails or times out\n \n @example\n * ```typescript\n * const receipt = await client.waitForTransaction('0x...');\n * console.log('Status:', receipt.status);\n * ```\n /\n async waitForTransaction(txHash: Hex): Promise<TransactionReceipt> {\n // Check if wallet has waitForTransactionReceipt method\n const publicClient = this.config.wallet as any;\n if (typeof publicClient.waitForTransactionReceipt !== \"function\") {\n throw new Error(\n \"Wallet client does not support waitForTransactionReceipt. \" +\n \"Please use a viem PublicClient or WalletClient with public actions.\",\n );\n }\n\n try {\n const receipt = await publicClient.waitForTransactionReceipt({\n hash: txHash,\n timeout: this.config.confirmationTimeout,\n });\n\n if (receipt.status !== \"success\") {\n throw new Error(`Transaction failed with status: ${receipt.status}`);\n }\n\n return receipt;\n } catch (error) {\n if (error instanceof Error) {\n throw new Error(`Failed to confirm transaction: ${error.message}`);\n }\n throw new Error(\"Failed to confirm transaction: Unknown error\");\n }\n }\n\n /\n Get the network name\n /\n get network(): string {\n return this.config.network;\n }\n\n /\n Get the facilitator URL\n /\n get facilitatorUrl(): string {\n return this.config.facilitatorUrl;\n }\n\n /\n Get the wallet client\n /\n get wallet() {\n return this.config.wallet;\n }\n}\n","/\n React hook for creating x402xClient instance\n \n This hook automatically creates an x402xClient instance using wagmi's\n * wallet client and chain information.\n /\n\nimport { useMemo } from \"react\";\nimport { useWalletClient, useAccount, useChainId, WagmiProviderNotFoundError } from \"wagmi\";\nimport { publicActions } from \"viem\";\nimport { x402xClient } from \"../client.js\";\nimport type { x402xClientConfig } from \"../types.js\";\n\n/\n Partial configuration for useX402Client hook\n * (wallet, network, chainId are auto-detected from wagmi)\n /\nexport type UseX402xClientConfig = Partial<Omit<x402xClientConfig, \"wallet\" \| \"network\">> & {\n /* Optional: Facilitator URL (default: https://facilitator.x402x.dev/) /\n facilitatorUrl?: string;\n /* Optional: Override network name (auto-detected from chain if not provided) /\n network?: string;\n};\n\n/\n Map chainId to network name\n /\nconst CHAIN_ID_TO_NETWORK: Record<number, string> = {\n 84532: \"base-sepolia\",\n 8453: \"base\",\n 196: \"x-layer\",\n 1952: \"x-layer-testnet\",\n 97: \"bsc-testnet\",\n 56: \"bsc\",\n};\n\n/\n React hook for x402xClient\n \n Automatically creates an x402xClient instance using the connected wallet\n * from wagmi. Returns null if wallet is not connected.\n \n @param config - Client configuration (facilitatorUrl is optional, defaults to https://facilitator.x402x.dev/)\n * @returns x402xClient instance or null if wallet not connected\n \n @example\n * ```typescript\n * import { useX402xClient } from '@x402x/client';\n \n function MyComponent() {\n * // Use default facilitator\n * const client = useX402xClient();\n \n // Or specify custom facilitator\n * const client = useX402xClient({\n * facilitatorUrl: 'https://custom-facilitator.example.com'\n * });\n \n if (!client) {\n * return <div>Please connect your wallet</div>;\n * }\n \n const handlePay = async () => {\n * const result = await client.execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * };\n \n return <button onClick={handlePay}>Pay</button>;\n * }\n * ```\n /\nexport function useX402xClient(config?: UseX402xClientConfig): x402xClient \| null {\n // First, try to get wagmi hooks outside of useMemo to catch provider errors early\n let walletClient: any;\n let isConnected: boolean;\n let chainId: number;\n\n try {\n const walletClientResult = useWalletClient();\n const accountResult = useAccount();\n const chainIdResult = useChainId();\n\n walletClient = walletClientResult.data;\n isConnected = accountResult.isConnected;\n chainId = chainIdResult;\n } catch (error) {\n // If wagmi provider context is missing (e.g., during early render), return null quietly\n if (\n error instanceof WagmiProviderNotFoundError \|\|\n (error as any)?.name === \"WagmiProviderNotFoundError\" \|\|\n (error instanceof Error &&\n error.message.includes(\"useConfig\") &&\n error.message.includes(\"WagmiProvider\"))\n ) {\n return null;\n }\n\n console.warn(\"[x402x] Unable to access wagmi provider:\", error);\n return null;\n }\n\n return useMemo(() => {\n if (!isConnected \|\| !walletClient) {\n return null;\n }\n\n // Determine network name\n const network = config?.network \|\| CHAIN_ID_TO_NETWORK[chainId];\n if (!network) {\n console.warn(\n `[x402x] Unknown chainId ${chainId}. Please provide network name explicitly in config.`,\n );\n return null;\n }\n\n try {\n // Extend wallet client with public actions (required for waitForTransactionReceipt)\n const extendedWallet = walletClient.extend(publicActions);\n\n return new x402xClient({\n wallet: extendedWallet,\n network,\n facilitatorUrl: config?.facilitatorUrl,\n networkConfig: config?.networkConfig,\n timeout: config?.timeout,\n confirmationTimeout: config?.confirmationTimeout,\n });\n } catch (error) {\n console.error(\"[x402x] Failed to create x402xClient:\", error);\n return null;\n }\n }, [\n isConnected,\n walletClient,\n chainId,\n config?.network,\n config?.facilitatorUrl,\n config?.networkConfig,\n config?.timeout,\n config?.confirmationTimeout,\n ]);\n}\n","/\n React hook for executing settlements\n \n This hook provides a simple interface for executing settlements with\n * automatic state management (status, error, result).\n /\n\nimport { useState, useCallback } from \"react\";\nimport { useX402xClient, type UseX402xClientConfig } from \"./useX402xClient.js\";\nimport type { ExecuteParams, ExecuteResult, ExecuteStatus } from \"../types.js\";\n\n/\n Return type for useExecute hook\n /\nexport interface UseExecuteReturn {\n /* Execute a settlement /\n execute: (params: ExecuteParams, waitForConfirmation?: boolean) => Promise<ExecuteResult>;\n /* Current execution status /\n status: ExecuteStatus;\n /* Error if execution failed /\n error: Error \| null;\n /* Result if execution succeeded /\n result: ExecuteResult \| null;\n /* Reset state /\n reset: () => void;\n /* Whether currently executing /\n isExecuting: boolean;\n /* Whether execution succeeded /\n isSuccess: boolean;\n /* Whether execution failed /\n isError: boolean;\n}\n\n/\n React hook for executing settlements\n \n Provides a simple interface for executing settlements with automatic\n * state management. Automatically uses the connected wallet from wagmi.\n \n @param config - Optional client configuration (if not using global client)\n * @returns Execute function and state\n \n @example\n * ```typescript\n * import { useExecute } from '@x402x/client';\n * import { TransferHook } from '@x402x/core';\n \n function PayButton() {\n * const { execute, status, error, result } = useExecute({\n * facilitatorUrl: 'https://facilitator.x402x.dev'\n * });\n \n const handlePay = async () => {\n * try {\n * // Simple transfer (hook and hookData are optional)\n * const result = await execute({\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * console.log('Success:', result.txHash);\n * } catch (err) {\n * console.error('Failed:', err);\n * }\n * };\n \n return (\n * <div>\n * <button onClick={handlePay} disabled={status !== 'idle'}>\n * {status === 'idle' ? 'Pay' : 'Processing...'}\n * </button>\n * {status === 'success' && <div>✅ Success! TX: {result.txHash}</div>}\n * {status === 'error' && <div>❌ Error: {error.message}</div>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useExecute(config?: UseX402xClientConfig): UseExecuteReturn {\n const client = useX402xClient(config);\n const [status, setStatus] = useState<ExecuteStatus>(\"idle\");\n const [error, setError] = useState<Error \| null>(null);\n const [result, setResult] = useState<ExecuteResult \| null>(null);\n\n const execute = useCallback(\n async (params: ExecuteParams, waitForConfirmation: boolean = true): Promise<ExecuteResult> => {\n if (!client) {\n throw new Error(\"X402Client not available. Please connect your wallet.\");\n }\n\n setStatus(\"preparing\");\n setError(null);\n setResult(null);\n\n try {\n const executeResult = await client.execute(params, waitForConfirmation);\n setStatus(\"success\");\n setResult(executeResult);\n return executeResult;\n } catch (err) {\n const error = err instanceof Error ? err : new Error(\"Unknown error\");\n setStatus(\"error\");\n setError(error);\n throw error;\n }\n },\n [client],\n );\n\n const reset = useCallback(() => {\n setStatus(\"idle\");\n setError(null);\n setResult(null);\n }, []);\n\n return {\n execute,\n status,\n error,\n result,\n reset,\n isExecuting: [\"preparing\", \"signing\", \"submitting\", \"confirming\"].includes(status),\n isSuccess: status === \"success\",\n isError: status === \"error\",\n };\n}\n\n/\n Alternative hook that doesn't require config (uses default client from context)\n \n @example\n * ```typescript\n * import { useExecute } from '@x402x/client';\n \n function PayButton({ facilitatorUrl }: { facilitatorUrl: string }) {\n * const { execute, status, error } = useExecute({ facilitatorUrl });\n \n const handlePay = async () => {\n * await execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: '1000000',\n * recipient: '0x...'\n * });\n * };\n \n return (\n * <button onClick={handlePay} disabled={status !== 'idle'}>\n * Pay\n * </button>\n * );\n * }\n * ```\n */\nexport function useExecuteWithClient(\n client: ReturnType<typeof useX402xClient>,\n): Omit<UseExecuteReturn, \"reset\"> {\n const [status, setStatus] = useState<ExecuteStatus>(\"idle\");\n const [error, setError] = useState<Error \| null>(null);\n const [result, setResult] = useState<ExecuteResult \| null>(null);\n\n const execute = useCallback(\n async (params: ExecuteParams, waitForConfirmation: boolean = true): Promise<ExecuteResult> => {\n if (!client) {\n throw new Error(\"X402Client not available. Please connect your wallet.\");\n }\n\n setStatus(\"preparing\");\n setError(null);\n setResult(null);\n\n try {\n const executeResult = await client.execute(params, waitForConfirmation);\n setStatus(\"success\");\n setResult(executeResult);\n return executeResult;\n } catch (err) {\n const error = err instanceof Error ? err : new Error(\"Unknown error\");\n setStatus(\"error\");\n setError(error);\n throw error;\n }\n },\n [client],\n );\n\n return {\n execute,\n status,\n error,\n result,\n isExecuting: [\"preparing\", \"signing\", \"submitting\", \"confirming\"].includes(status),\n isSuccess: status === \"success\",\n isError: status === \"error\",\n };\n}\n"]}

package/dist/index.d.cts CHANGED Viewed

@@ -17,7 +17,7 @@ type ExecuteStatus = "idle" | "preparing" | "signing" | "submitting" | "confirmi
 /**
  * X402Client configuration
  */
-interface X402ClientConfig {
+interface x402xClientConfig {
     /** Wallet client from wagmi/viem */
     wallet: WalletClient;
     /** Network name (e.g., 'base-sepolia', 'x-layer-testnet') */
@@ -249,7 +249,7 @@ declare const DEFAULT_FACILITATOR_URL = "https://facilitator.x402x.dev";
 declare function prepareSettlement(params: PrepareParams): Promise<SettlementData>;
 /**
- * X402Client - High-level client for x402x Serverless Mode
+ * x402xClient - High-level client for x402x Serverless Mode
  *
  * This client simplifies the entire settlement flow into a single execute() call,
  * automatically handling:
@@ -261,14 +261,14 @@ declare function prepareSettlement(params: PrepareParams): Promise<SettlementDat
  *
  * @example
  * ```typescript
- * import { X402Client } from '@x402x/client';
- * import { TransferHook } from '@x402x/core';
+ * import { x402xClient } from '@x402x/client';
+ * import { TransferHook } from '@x402x/extensions';
  * import { useWalletClient } from 'wagmi';
  *
  * const { data: wallet } = useWalletClient();
  *
  * // Use default facilitator
- * const client = new X402Client({
+ * const client = new x402xClient({
  *   wallet,
  *   network: 'base-sepolia'
  * });
@@ -287,16 +287,16 @@ declare function prepareSettlement(params: PrepareParams): Promise<SettlementDat
  * });
  * ```
  */
-declare class X402Client {
+declare class x402xClient {
     private config;
     /**
-     * Create a new X402Client instance
+     * Create a new x402xClient instance
      *
      * @param config - Client configuration
      * @throws NetworkError if network is unsupported
      * @throws ValidationError if configuration is invalid
      */
-    constructor(config: X402ClientConfig);
+    constructor(config: x402xClientConfig);
     /**
      * Execute a settlement transaction
      *
@@ -4948,9 +4948,9 @@ declare function calculateTimeWindow(maxTimeoutSeconds?: number): {
 };
 /**
- * React hook for creating X402Client instance
+ * React hook for creating x402xClient instance
  *
- * This hook automatically creates an X402Client instance using wagmi's
+ * This hook automatically creates an x402xClient instance using wagmi's
  * wallet client and chain information.
  */
@@ -4958,31 +4958,31 @@ declare function calculateTimeWindow(maxTimeoutSeconds?: number): {
  * Partial configuration for useX402Client hook
  * (wallet, network, chainId are auto-detected from wagmi)
  */
-type UseX402ClientConfig = Partial<Omit<X402ClientConfig, "wallet" | "network">> & {
+type UseX402xClientConfig = Partial<Omit<x402xClientConfig, "wallet" | "network">> & {
     /** Optional: Facilitator URL (default: https://facilitator.x402x.dev/) */
     facilitatorUrl?: string;
     /** Optional: Override network name (auto-detected from chain if not provided) */
     network?: string;
 };
 /**
- * React hook for X402Client
+ * React hook for x402xClient
  *
- * Automatically creates an X402Client instance using the connected wallet
+ * Automatically creates an x402xClient instance using the connected wallet
  * from wagmi. Returns null if wallet is not connected.
  *
  * @param config - Client configuration (facilitatorUrl is optional, defaults to https://facilitator.x402x.dev/)
- * @returns X402Client instance or null if wallet not connected
+ * @returns x402xClient instance or null if wallet not connected
  *
  * @example
  * ```typescript
- * import { useX402Client } from '@x402x/client';
+ * import { useX402xClient } from '@x402x/client';
  *
  * function MyComponent() {
  *   // Use default facilitator
- *   const client = useX402Client();
+ *   const client = useX402xClient();
  *
  *   // Or specify custom facilitator
- *   const client = useX402Client({
+ *   const client = useX402xClient({
  *     facilitatorUrl: 'https://custom-facilitator.example.com'
  *   });
  *
@@ -5003,7 +5003,7 @@ type UseX402ClientConfig = Partial<Omit<X402ClientConfig, "wallet" | "network">>
  * }
  * ```
  */
-declare function useX402Client(config?: UseX402ClientConfig): X402Client | null;
+declare function useX402xClient(config?: UseX402xClientConfig): x402xClient | null;
 /**
  * React hook for executing settlements
@@ -5077,7 +5077,7 @@ interface UseExecuteReturn {
  * }
  * ```
  */
-declare function useExecute(config?: UseX402ClientConfig): UseExecuteReturn;
+declare function useExecute(config?: UseX402xClientConfig): UseExecuteReturn;
 /**
  * Error classes for x402x client SDK
@@ -5123,4 +5123,4 @@ declare class ValidationError extends X402ClientError {
     constructor(message: string, code?: string);
 }
-export { DEFAULT_FACILITATOR_URL, type ExecuteParams, type ExecuteResult, type ExecuteStatus, FacilitatorError, NetworkError, type PrepareParams, type SettleResult, type SettlementData, type SignedAuthorization, SigningError, TransactionError, ValidationError, X402Client, type X402ClientConfig, X402ClientError, calculateTimeWindow, formatFacilitatorUrl, generateSalt, normalizeAddress, prepareSettlement, settle, signAuthorization, useExecute, useX402Client };
+export { DEFAULT_FACILITATOR_URL, type ExecuteParams, type ExecuteResult, type ExecuteStatus, FacilitatorError, NetworkError, type PrepareParams, type SettleResult, type SettlementData, type SignedAuthorization, SigningError, TransactionError, ValidationError, x402xClient as X402Client, type x402xClientConfig as X402ClientConfig, X402ClientError, calculateTimeWindow, formatFacilitatorUrl, generateSalt, normalizeAddress, prepareSettlement, settle, signAuthorization, useExecute, useX402xClient as useX402Client, useX402xClient, x402xClient };

package/dist/index.d.ts CHANGED Viewed

@@ -17,7 +17,7 @@ type ExecuteStatus = "idle" | "preparing" | "signing" | "submitting" | "confirmi
 /**
  * X402Client configuration
  */
-interface X402ClientConfig {
+interface x402xClientConfig {
     /** Wallet client from wagmi/viem */
     wallet: WalletClient;
     /** Network name (e.g., 'base-sepolia', 'x-layer-testnet') */
@@ -249,7 +249,7 @@ declare const DEFAULT_FACILITATOR_URL = "https://facilitator.x402x.dev";
 declare function prepareSettlement(params: PrepareParams): Promise<SettlementData>;
 /**
- * X402Client - High-level client for x402x Serverless Mode
+ * x402xClient - High-level client for x402x Serverless Mode
  *
  * This client simplifies the entire settlement flow into a single execute() call,
  * automatically handling:
@@ -261,14 +261,14 @@ declare function prepareSettlement(params: PrepareParams): Promise<SettlementDat
  *
  * @example
  * ```typescript
- * import { X402Client } from '@x402x/client';
- * import { TransferHook } from '@x402x/core';
+ * import { x402xClient } from '@x402x/client';
+ * import { TransferHook } from '@x402x/extensions';
  * import { useWalletClient } from 'wagmi';
  *
  * const { data: wallet } = useWalletClient();
  *
  * // Use default facilitator
- * const client = new X402Client({
+ * const client = new x402xClient({
  *   wallet,
  *   network: 'base-sepolia'
  * });
@@ -287,16 +287,16 @@ declare function prepareSettlement(params: PrepareParams): Promise<SettlementDat
  * });
  * ```
  */
-declare class X402Client {
+declare class x402xClient {
     private config;
     /**
-     * Create a new X402Client instance
+     * Create a new x402xClient instance
      *
      * @param config - Client configuration
      * @throws NetworkError if network is unsupported
      * @throws ValidationError if configuration is invalid
      */
-    constructor(config: X402ClientConfig);
+    constructor(config: x402xClientConfig);
     /**
      * Execute a settlement transaction
      *
@@ -4948,9 +4948,9 @@ declare function calculateTimeWindow(maxTimeoutSeconds?: number): {
 };
 /**
- * React hook for creating X402Client instance
+ * React hook for creating x402xClient instance
  *
- * This hook automatically creates an X402Client instance using wagmi's
+ * This hook automatically creates an x402xClient instance using wagmi's
  * wallet client and chain information.
  */
@@ -4958,31 +4958,31 @@ declare function calculateTimeWindow(maxTimeoutSeconds?: number): {
  * Partial configuration for useX402Client hook
  * (wallet, network, chainId are auto-detected from wagmi)
  */
-type UseX402ClientConfig = Partial<Omit<X402ClientConfig, "wallet" | "network">> & {
+type UseX402xClientConfig = Partial<Omit<x402xClientConfig, "wallet" | "network">> & {
     /** Optional: Facilitator URL (default: https://facilitator.x402x.dev/) */
     facilitatorUrl?: string;
     /** Optional: Override network name (auto-detected from chain if not provided) */
     network?: string;
 };
 /**
- * React hook for X402Client
+ * React hook for x402xClient
  *
- * Automatically creates an X402Client instance using the connected wallet
+ * Automatically creates an x402xClient instance using the connected wallet
  * from wagmi. Returns null if wallet is not connected.
  *
  * @param config - Client configuration (facilitatorUrl is optional, defaults to https://facilitator.x402x.dev/)
- * @returns X402Client instance or null if wallet not connected
+ * @returns x402xClient instance or null if wallet not connected
  *
  * @example
  * ```typescript
- * import { useX402Client } from '@x402x/client';
+ * import { useX402xClient } from '@x402x/client';
  *
  * function MyComponent() {
  *   // Use default facilitator
- *   const client = useX402Client();
+ *   const client = useX402xClient();
  *
  *   // Or specify custom facilitator
- *   const client = useX402Client({
+ *   const client = useX402xClient({
  *     facilitatorUrl: 'https://custom-facilitator.example.com'
  *   });
  *
@@ -5003,7 +5003,7 @@ type UseX402ClientConfig = Partial<Omit<X402ClientConfig, "wallet" | "network">>
  * }
  * ```
  */
-declare function useX402Client(config?: UseX402ClientConfig): X402Client | null;
+declare function useX402xClient(config?: UseX402xClientConfig): x402xClient | null;
 /**
  * React hook for executing settlements
@@ -5077,7 +5077,7 @@ interface UseExecuteReturn {
  * }
  * ```
  */
-declare function useExecute(config?: UseX402ClientConfig): UseExecuteReturn;
+declare function useExecute(config?: UseX402xClientConfig): UseExecuteReturn;
 /**
  * Error classes for x402x client SDK
@@ -5123,4 +5123,4 @@ declare class ValidationError extends X402ClientError {
     constructor(message: string, code?: string);
 }
-export { DEFAULT_FACILITATOR_URL, type ExecuteParams, type ExecuteResult, type ExecuteStatus, FacilitatorError, NetworkError, type PrepareParams, type SettleResult, type SettlementData, type SignedAuthorization, SigningError, TransactionError, ValidationError, X402Client, type X402ClientConfig, X402ClientError, calculateTimeWindow, formatFacilitatorUrl, generateSalt, normalizeAddress, prepareSettlement, settle, signAuthorization, useExecute, useX402Client };
+export { DEFAULT_FACILITATOR_URL, type ExecuteParams, type ExecuteResult, type ExecuteStatus, FacilitatorError, NetworkError, type PrepareParams, type SettleResult, type SettlementData, type SignedAuthorization, SigningError, TransactionError, ValidationError, x402xClient as X402Client, type x402xClientConfig as X402ClientConfig, X402ClientError, calculateTimeWindow, formatFacilitatorUrl, generateSalt, normalizeAddress, prepareSettlement, settle, signAuthorization, useExecute, useX402xClient as useX402Client, useX402xClient, x402xClient };

package/dist/index.js CHANGED Viewed

@@ -391,9 +391,9 @@ async function settle(facilitatorUrl, signed, timeout = 3e4) {
 }
 // src/client.ts
-var X402Client = class {
+var x402xClient = class {
   /**
-   * Create a new X402Client instance
+   * Create a new x402xClient instance
    *
    * @param config - Client configuration
    * @throws NetworkError if network is unsupported
@@ -606,7 +606,7 @@ var CHAIN_ID_TO_NETWORK = {
   97: "bsc-testnet",
   56: "bsc"
 };
-function useX402Client(config) {
+function useX402xClient(config) {
   let walletClient;
   let isConnected;
   let chainId;
@@ -637,7 +637,7 @@ function useX402Client(config) {
     }
     try {
       const extendedWallet = walletClient.extend(publicActions);
-      return new X402Client({
+      return new x402xClient({
         wallet: extendedWallet,
         network,
         facilitatorUrl: config?.facilitatorUrl,
@@ -646,7 +646,7 @@ function useX402Client(config) {
         confirmationTimeout: config?.confirmationTimeout
       });
     } catch (error) {
-      console.error("[x402x] Failed to create X402Client:", error);
+      console.error("[x402x] Failed to create x402xClient:", error);
       return null;
     }
   }, [
@@ -661,7 +661,7 @@ function useX402Client(config) {
   ]);
 }
 function useExecute(config) {
-  const client = useX402Client(config);
+  const client = useX402xClient(config);
   const [status, setStatus] = useState("idle");
   const [error, setError] = useState(null);
   const [result, setResult] = useState(null);
@@ -704,6 +704,6 @@ function useExecute(config) {
   };
 }
-export { DEFAULT_FACILITATOR_URL, FacilitatorError, NetworkError, SigningError, TransactionError, ValidationError, X402Client, X402ClientError, calculateTimeWindow, formatFacilitatorUrl, generateSalt, normalizeAddress, prepareSettlement, settle, signAuthorization, useExecute, useX402Client };
+export { DEFAULT_FACILITATOR_URL, FacilitatorError, NetworkError, SigningError, TransactionError, ValidationError, x402xClient as X402Client, X402ClientError, calculateTimeWindow, formatFacilitatorUrl, generateSalt, normalizeAddress, prepareSettlement, settle, signAuthorization, useExecute, useX402xClient as useX402Client, useX402xClient, x402xClient };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/errors.ts","../src/core/utils.ts","../src/core/prepare.ts","../src/core/sign.ts","../src/core/settle.ts","../src/client.ts","../src/hooks/useX402Client.ts","../src/hooks/useExecute.ts"],"names":["getAddress","coreSettle","calculateFacilitatorFee","error"],"mappings":"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","file":"index.js","sourcesContent":["/*\n Error classes for x402x client SDK\n /\n\n/\n Base error class for all x402x client errors\n /\nexport class X402ClientError extends Error {\n constructor(\n message: string,\n public readonly code?: string,\n ) {\n super(message);\n this.name = \"X402ClientError\";\n Object.setPrototypeOf(this, X402ClientError.prototype);\n }\n}\n\n/\n Network-related errors (unsupported network, configuration issues)\n /\nexport class NetworkError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"NetworkError\";\n Object.setPrototypeOf(this, NetworkError.prototype);\n }\n}\n\n/\n Wallet signing errors\n /\nexport class SigningError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"SigningError\";\n Object.setPrototypeOf(this, SigningError.prototype);\n }\n}\n\n/\n Facilitator communication errors\n /\nexport class FacilitatorError extends X402ClientError {\n constructor(\n message: string,\n code?: string,\n public readonly statusCode?: number,\n public readonly response?: unknown,\n ) {\n super(message, code);\n this.name = \"FacilitatorError\";\n Object.setPrototypeOf(this, FacilitatorError.prototype);\n }\n}\n\n/\n Transaction execution errors\n /\nexport class TransactionError extends X402ClientError {\n constructor(\n message: string,\n code?: string,\n public readonly txHash?: string,\n ) {\n super(message, code);\n this.name = \"TransactionError\";\n Object.setPrototypeOf(this, TransactionError.prototype);\n }\n}\n\n/\n Parameter validation errors\n /\nexport class ValidationError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"ValidationError\";\n Object.setPrototypeOf(this, ValidationError.prototype);\n }\n}\n","/\n Utility functions for x402x client\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { getAddress, isAddress } from \"viem\";\nimport { ValidationError } from \"../errors.js\";\n\n/\n Generate a random 32-byte salt for settlement idempotency\n \n @returns Random 32-byte hex string\n \n @example\n * ```typescript\n * const salt = generateSalt();\n * console.log(salt); // \"0x1234...\"\n * ```\n /\nexport function generateSalt(): Hex {\n const cryptoObj = (globalThis as any).crypto as Crypto \| undefined;\n\n if (!cryptoObj \|\| !cryptoObj.getRandomValues) {\n throw new Error(\"crypto.getRandomValues is not available\");\n }\n\n const randomBytes = cryptoObj.getRandomValues(new Uint8Array(32));\n return `0x${Array.from(randomBytes)\n .map((b) => b.toString(16).padStart(2, \"0\"))\n .join(\"\")}` as Hex;\n}\n\n/\n Normalize Ethereum address to EIP-55 checksum format\n \n Automatically converts any valid Ethereum address (lowercase, uppercase, or mixed)\n * to the proper checksummed format. This provides a better developer experience\n * by accepting addresses in any case format.\n \n @param address - Address to normalize (can be any case)\n * @param name - Parameter name for error messages (optional)\n * @returns Checksummed address in EIP-55 format\n * @throws ValidationError if address is invalid\n \n @example\n * ```typescript\n * normalizeAddress('0xabc123...') // Returns '0xAbC123...' (checksummed)\n * normalizeAddress('0xABC123...') // Returns '0xAbC123...' (checksummed)\n * normalizeAddress('0xAbC123...') // Returns '0xAbC123...' (already checksummed)\n * ```\n /\nexport function normalizeAddress(address: string, name: string = \"address\"): Address {\n if (!address \|\| typeof address !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n\n // Convert to EIP-55 checksum format\n // getAddress() will throw if the address is invalid\n try {\n return getAddress(address);\n } catch (error) {\n throw new ValidationError(\n `${name} is not a valid Ethereum address: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n );\n }\n}\n\n/\n Validate Ethereum address format (legacy, prefer normalizeAddress)\n \n @deprecated Use normalizeAddress() instead for better developer experience\n * @param address - Address to validate\n * @param name - Parameter name for error messages\n * @throws ValidationError if address is invalid\n /\nexport function validateAddress(address: string, name: string): void {\n if (!address \|\| typeof address !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n if (!isAddress(address)) {\n throw new ValidationError(`${name} must be a valid Ethereum address`);\n }\n}\n\n/\n Validate hex string format\n \n @param hex - Hex string to validate\n * @param name - Parameter name for error messages\n * @param expectedLength - Optional expected length (in bytes, not characters)\n * @throws ValidationError if hex is invalid\n /\nexport function validateHex(hex: string, name: string, expectedLength?: number): void {\n if (!hex \|\| typeof hex !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n if (!hex.startsWith(\"0x\")) {\n throw new ValidationError(`${name} must start with 0x`);\n }\n if (!/^0x[0-9a-fA-F]$/.test(hex)) {\n throw new ValidationError(`${name} must be a valid hex string`);\n }\n if (expectedLength !== undefined) {\n const actualLength = (hex.length - 2) / 2;\n if (actualLength !== expectedLength) {\n throw new ValidationError(\n `${name} must be ${expectedLength} bytes, got ${actualLength} bytes`,\n );\n }\n }\n}\n\n/*\n Validate amount format - must be atomic units (positive integer string)\n \n This function validates that the amount is a valid atomic unit string.\n * For converting USD amounts to atomic units, use parseDefaultAssetAmount from @x402x/core.\n \n @param amount - Amount in atomic units (must be a positive integer string)\n * @param name - Parameter name for error messages\n * @throws ValidationError if amount is invalid\n \n @example\n * ```typescript\n * validateAmount('1000000', 'amount'); // Valid: atomic units\n * validateAmount('0.1', 'amount'); // Invalid: not atomic units\n * validateAmount('-1', 'amount'); // Invalid: negative\n * ```\n /\nexport function validateAmount(amount: string \| number, name: string): void {\n if (amount === null \|\| amount === undefined \|\| amount === \"\") {\n throw new ValidationError(`${name} is required`);\n }\n\n // Convert to string if number\n const amountStr = typeof amount === \"number\" ? amount.toString() : amount;\n\n // Must be a non-empty string\n if (typeof amountStr !== \"string\" \|\| amountStr.trim() === \"\") {\n throw new ValidationError(`${name} must be a non-empty string`);\n }\n\n // Must be a valid positive integer (atomic units)\n // Allow leading zeros but must be numeric\n if (!/^\\d+$/.test(amountStr)) {\n throw new ValidationError(\n `${name} must be a positive integer string (atomic units). ` +\n `Use parseDefaultAssetAmount() from @x402x/core to convert USD amounts.`,\n );\n }\n\n // Validate it can be converted to BigInt (no overflow)\n try {\n const atomicAmount = BigInt(amountStr);\n if (atomicAmount < 0n) {\n throw new ValidationError(`${name} cannot be negative`);\n }\n if (atomicAmount === 0n) {\n throw new ValidationError(`${name} cannot be zero`);\n }\n } catch (error) {\n if (error instanceof ValidationError) {\n throw error;\n }\n throw new ValidationError(\n `${name} is not a valid amount: ${error instanceof Error ? error.message : \"Invalid format\"}`,\n );\n }\n}\n\n/\n Format facilitator URL (ensure it doesn't end with slash)\n \n @param url - Facilitator URL\n * @returns Formatted URL\n /\nexport function formatFacilitatorUrl(url: string): string {\n return url.endsWith(\"/\") ? url.slice(0, -1) : url;\n}\n\n/\n Calculate default time window for authorization\n \n @param maxTimeoutSeconds - Maximum timeout in seconds\n * @returns Object with validAfter and validBefore timestamps\n /\nexport function calculateTimeWindow(maxTimeoutSeconds: number = 300): {\n validAfter: string;\n validBefore: string;\n} {\n const now = Math.floor(Date.now() / 1000);\n return {\n validAfter: (now - 600).toString(), // 10 minutes before\n validBefore: (now + maxTimeoutSeconds).toString(),\n };\n}\n","/\n Prepare settlement data for signing\n \n This module handles the preparation of settlement parameters before signing,\n * including generating salt, calculating commitment hash, and fetching facilitator fees.\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { getNetworkConfig, calculateFacilitatorFee, type FeeCalculationResult } from \"@x402x/extensions\";\nimport { calculateCommitment } from \"@x402x/extensions\";\nimport type { PrepareParams, SettlementData } from \"../types.js\";\nimport { NetworkError, ValidationError, FacilitatorError } from \"../errors.js\";\nimport {\n generateSalt,\n validateAddress,\n validateHex,\n validateAmount,\n calculateTimeWindow,\n} from \"./utils.js\";\n\n/\n Default facilitator URL\n /\nexport const DEFAULT_FACILITATOR_URL = \"https://facilitator.x402x.dev\";\n\n/\n Query facilitator fee from facilitator service (internal helper)\n \n Uses the /calculate-fee endpoint which provides accurate gas cost estimates\n * with safety margins.\n \n @internal\n * @param facilitatorUrl - Facilitator URL\n * @param network - Network name\n * @param hook - Hook contract address\n * @param hookData - Optional encoded hook parameters (default: '0x')\n * @returns Fee calculation result\n \n @throws FacilitatorError if request fails\n /\nasync function queryFacilitatorFee(\n facilitatorUrl: string,\n network: string,\n hook: Address,\n hookData: Hex = \"0x\",\n): Promise<FeeCalculationResult> {\n try {\n return await calculateFacilitatorFee(facilitatorUrl, network, hook, hookData);\n } catch (error) {\n if (error instanceof Error) {\n throw new FacilitatorError(\n `Failed to query facilitator fee: ${error.message}`,\n \"FEE_QUERY_FAILED\",\n );\n }\n throw new FacilitatorError(\"Failed to query facilitator fee: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n\n/\n Prepare settlement data for signing\n \n This function:\n * 1. Validates all parameters\n * 2. Loads network configuration\n * 3. Generates salt (if not provided)\n * 4. Queries facilitator fee (if not provided)\n * 5. Calculates time window (if not provided)\n * 6. Calculates commitment hash\n * 7. Returns prepared settlement data\n \n @param params - Preparation parameters\n * @returns Prepared settlement data ready for signing\n \n @throws NetworkError if network is unsupported\n * @throws ValidationError if parameters are invalid\n \n @example\n * ```typescript\n * import { prepareSettlement } from '@x402x/client';\n * import { TransferHook, parseDefaultAssetAmount } from '@x402x/core';\n \n // Convert USD amount to atomic units first\n * const atomicAmount = parseDefaultAssetAmount('1', 'base-sepolia'); // '1000000'\n \n const settlement = await prepareSettlement({\n * wallet: walletClient,\n * network: 'base-sepolia',\n * hook: TransferHook.getAddress('base-sepolia'),\n * hookData: TransferHook.encode(),\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...',\n * facilitatorUrl: 'https://facilitator.x402x.dev'\n * });\n * ```\n /\nexport async function prepareSettlement(params: PrepareParams): Promise<SettlementData> {\n // 1. Validate parameters\n validateAddress(params.hook, \"hook\");\n validateHex(params.hookData, \"hookData\");\n validateAddress(params.payTo, \"payTo\");\n\n // 2. Validate amount (must be atomic units, no automatic conversion)\n validateAmount(params.amount, \"amount\");\n const atomicAmount = params.amount;\n\n if (params.customSalt) {\n validateHex(params.customSalt, \"customSalt\", 32);\n }\n\n // 2. Get wallet account address\n const from = params.wallet.account?.address;\n if (!from) {\n throw new ValidationError(\"Wallet client must have an account\");\n }\n\n // 3. Load network configuration\n const networkConfig = params.networkConfig \|\| getNetworkConfig(params.network);\n if (!networkConfig) {\n throw new NetworkError(\n `Network '${params.network}' is not supported. Please provide custom networkConfig.`,\n );\n }\n\n // 4. Determine asset address (use provided asset or default asset)\n const asset = params.asset \|\| (networkConfig.defaultAsset.address as Address);\n validateAddress(asset, \"asset\");\n\n // 5. Generate salt (if not provided)\n const salt = params.customSalt \|\| generateSalt();\n\n // 6. Query facilitator fee (if not provided)\n // Use the provided facilitatorUrl or fall back to default\n let facilitatorFee = params.facilitatorFee \|\| \"0\";\n if (!params.facilitatorFee) {\n const facilitatorUrl = params.facilitatorUrl \|\| DEFAULT_FACILITATOR_URL;\n try {\n const feeEstimate = await queryFacilitatorFee(\n facilitatorUrl,\n params.network,\n params.hook,\n params.hookData, // Pass hookData for accurate fee calculation\n );\n\n if (!feeEstimate.hookAllowed) {\n throw new ValidationError(\n `Hook ${params.hook} is not allowed on network ${params.network}.`,\n );\n }\n\n facilitatorFee = feeEstimate.facilitatorFee;\n } catch (error) {\n // If fee query fails, log warning and use 0\n console.warn(\n `[x402x] Failed to query facilitator fee, using 0. This may cause settlement to fail. Error: ${\n error instanceof Error ? error.message : \"Unknown\"\n }`,\n );\n facilitatorFee = \"0\";\n }\n }\n\n // 7. Calculate time window (if not provided)\n const timeWindow =\n params.validAfter && params.validBefore\n ? { validAfter: params.validAfter, validBefore: params.validBefore }\n : calculateTimeWindow(300); // 5 minutes default\n\n // 8. Calculate commitment hash\n // IMPORTANT: value must be total amount (business amount + facilitator fee)\n // because the contract's calculateCommitment expects the same value that\n // will be authorized in the EIP-3009 signature\n const totalAmount = (BigInt(atomicAmount) + BigInt(facilitatorFee)).toString();\n const commitment = calculateCommitment({\n chainId: networkConfig.chainId,\n hub: networkConfig.settlementRouter as Address,\n asset: asset,\n from,\n value: totalAmount,\n validAfter: timeWindow.validAfter,\n validBefore: timeWindow.validBefore,\n salt,\n payTo: params.payTo,\n facilitatorFee,\n hook: params.hook,\n hookData: params.hookData,\n });\n\n // 9. Return prepared settlement data\n // Use original network name for API compatibility; conversion to canonical format happens during settlement\n return {\n network: params.network,\n networkConfig,\n asset: asset,\n from,\n amount: atomicAmount,\n validAfter: timeWindow.validAfter,\n validBefore: timeWindow.validBefore,\n salt,\n payTo: params.payTo,\n facilitatorFee,\n hook: params.hook,\n hookData: params.hookData,\n commitment: commitment as Hex,\n };\n}\n","/\n Sign EIP-3009 authorization for settlement\n \n This module handles the signing of EIP-712 typed data for EIP-3009\n * transferWithAuthorization, using the commitment hash as the nonce.\n /\n\nimport type { Address, WalletClient } from \"viem\";\nimport { getAddress } from \"viem\";\nimport { signTypedData } from \"viem/actions\";\nimport type { SettlementData, SignedAuthorization } from \"../types.js\";\nimport { SigningError } from \"../errors.js\";\n\n/\n EIP-3009 authorization types for EIP-712 signature\n /\nconst AUTHORIZATION_TYPES = {\n TransferWithAuthorization: [\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/\n Sign EIP-3009 authorization\n \n This function signs an EIP-712 typed data message for EIP-3009's\n * transferWithAuthorization function. The commitment hash is used\n * as the nonce to cryptographically bind all settlement parameters.\n \n @param wallet - Wallet client from wagmi/viem\n * @param settlement - Prepared settlement data\n * @returns Signed authorization ready to submit\n \n @throws SigningError if signing fails or wallet doesn't support signing\n \n @example\n * ```typescript\n * import { signAuthorization } from '@x402x/client';\n \n const signed = await signAuthorization(walletClient, settlement);\n * console.log('Signature:', signed.signature);\n * ```\n /\nexport async function signAuthorization(\n wallet: WalletClient,\n settlement: SettlementData,\n): Promise<SignedAuthorization> {\n try {\n // Ensure wallet has an account\n if (!wallet.account) {\n throw new SigningError(\"Wallet client must have an account\");\n }\n\n // Build EIP-712 domain\n // Use the asset's EIP-712 domain info from network config\n // Note: For custom assets, the domain info should match the asset contract\n const domain = {\n name: settlement.networkConfig.defaultAsset.eip712.name,\n version: settlement.networkConfig.defaultAsset.eip712.version,\n chainId: settlement.networkConfig.chainId,\n verifyingContract: getAddress(settlement.asset),\n };\n\n // Build EIP-712 message\n // The \"to\" address is the SettlementRouter (not the final recipient)\n // The \"value\" MUST be total amount (business amount + facilitator fee)\n // because the Router needs to deduct the fee before passing to Hook\n const totalAmount = BigInt(settlement.amount) + BigInt(settlement.facilitatorFee);\n const message = {\n from: getAddress(settlement.from),\n to: getAddress(settlement.networkConfig.settlementRouter),\n value: totalAmount,\n validAfter: BigInt(settlement.validAfter),\n validBefore: BigInt(settlement.validBefore),\n nonce: settlement.commitment, // Use commitment as nonce\n };\n\n console.log(\"[x402x/client] EIP-712 Message for signing:\", {\n from: message.from,\n to: message.to,\n value: message.value.toString(),\n validAfter: message.validAfter.toString(),\n validBefore: message.validBefore.toString(),\n nonce: message.nonce,\n });\n\n // Sign typed data\n const signature = await signTypedData(wallet, {\n account: wallet.account,\n domain,\n types: AUTHORIZATION_TYPES,\n primaryType: \"TransferWithAuthorization\",\n message,\n });\n\n // Build authorization object\n const authorization = {\n from: settlement.from,\n to: settlement.networkConfig.settlementRouter as Address,\n value: totalAmount.toString(), // Use total amount (business + fee)\n validAfter: settlement.validAfter,\n validBefore: settlement.validBefore,\n nonce: settlement.commitment,\n };\n\n return {\n settlement,\n signature,\n authorization,\n };\n } catch (error) {\n if (error instanceof SigningError) {\n throw error;\n }\n\n // Handle common signing errors\n if (error instanceof Error) {\n if (error.message.includes(\"User rejected\")) {\n throw new SigningError(\"User rejected the signing request\", \"USER_REJECTED\");\n }\n if (error.message.includes(\"account\")) {\n throw new SigningError(\"Wallet account not available\", \"NO_ACCOUNT\");\n }\n throw new SigningError(`Failed to sign authorization: ${error.message}`, \"SIGNING_FAILED\");\n }\n\n throw new SigningError(\"Failed to sign authorization: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n","/\n Settle payment with facilitator\n \n This module handles the settlement of signed payment payloads with the\n * facilitator's /settle endpoint, following the x402 protocol.\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { settle as coreSettle, toCanonicalNetworkKey } from \"@x402x/extensions\";\nimport type {\n SignedAuthorization,\n SettleResult,\n PaymentPayload,\n PaymentRequirements,\n} from \"../types.js\";\nimport { FacilitatorError } from \"../errors.js\";\n\n/\n EVM Exact Scheme Authorization structure\n * Standard x402 v2 authorization format for EIP-3009\n /\ninterface ExactEvmAuthorization {\n from: Address;\n to: Address;\n value: string;\n validAfter: string;\n validBefore: string;\n nonce: Hex;\n}\n\n/\n EVM Exact Scheme Payload structure\n * Standard x402 v2 payload format\n /\ninterface ExactEvmPayload {\n signature: Hex;\n authorization: ExactEvmAuthorization;\n}\n\n/\n Settle signed authorization with facilitator\n \n This function acts as a convenience wrapper that:\n * 1. Constructs the PaymentPayload according to x402 protocol\n * 2. Constructs the PaymentRequirements with settlement extra\n * 3. Calls core's settle() method to POST to facilitator's /settle endpoint\n * 4. Parses and returns the settlement result\n \n @param facilitatorUrl - Facilitator URL\n * @param signed - Signed authorization from signAuthorization\n * @param timeout - Optional timeout in milliseconds (default: 30000)\n * @returns Settlement result with transaction hash\n \n @throws FacilitatorError if request fails or facilitator returns error\n \n @example\n * ```typescript\n * import { settle } from '@x402x/client';\n \n const result = await settle(\n * 'https://facilitator.x402x.dev',\n * signed\n * );\n * console.log('TX Hash:', result.transaction);\n * ```\n /\nexport async function settle(\n facilitatorUrl: string,\n signed: SignedAuthorization,\n timeout: number = 30000,\n): Promise<SettleResult> {\n try {\n // Convert network to CAIP-2 format for v2 protocol\n const canonicalNetwork = toCanonicalNetworkKey(signed.settlement.network);\n\n // Calculate total amount (business amount + facilitator fee)\n // This MUST match what was used in commitment calculation\n const totalAmount = (\n BigInt(signed.settlement.amount) + BigInt(signed.settlement.facilitatorFee)\n ).toString();\n\n // Construct standard x402 v2 PaymentPayload\n // Using standard EVM exact scheme payload structure\n const exactEvmPayload: ExactEvmPayload = {\n signature: signed.signature,\n authorization: {\n from: signed.authorization.from,\n to: signed.authorization.to,\n value: signed.authorization.value,\n validAfter: signed.authorization.validAfter,\n validBefore: signed.authorization.validBefore,\n nonce: signed.authorization.nonce,\n },\n };\n\n const paymentPayload: PaymentPayload = {\n x402Version: 2, // Use v2 protocol\n resource: {\n url: \"https://x402x.dev/serverless\",\n description: \"x402x Serverless Settlement\",\n mimeType: \"application/json\",\n },\n accepted: {\n scheme: \"exact\",\n network: canonicalNetwork as any, // Type cast required: core_v2 Network type accepts both CAIP-2 and legacy formats\n asset: signed.settlement.asset as Address,\n amount: totalAmount, // Use totalAmount to match commitment calculation\n payTo: signed.settlement.networkConfig.settlementRouter as Address,\n maxTimeoutSeconds: 300,\n extra: {},\n },\n // Standard EVM exact scheme payload\n payload: exactEvmPayload as any, // Type cast required: ExactEvmPayload structure matches v2 protocol\n };\n\n // Construct PaymentRequirements (for serverless mode verification)\n // IMPORTANT: Use totalAmount (amount + fee) to match commitment calculation\n const paymentRequirements: PaymentRequirements = {\n scheme: \"exact\",\n network: canonicalNetwork as any, // Type cast required: core_v2 Network type accepts CAIP-2 format\n amount: totalAmount, // Total amount including facilitator fee\n asset: signed.settlement.asset as Address,\n payTo: signed.settlement.networkConfig.settlementRouter as Address,\n maxTimeoutSeconds: 300, // 5 minutes\n extra: {\n name: signed.settlement.networkConfig.defaultAsset.eip712.name,\n version: signed.settlement.networkConfig.defaultAsset.eip712.version,\n settlementRouter: signed.settlement.networkConfig.settlementRouter as Address,\n salt: signed.settlement.salt,\n payTo: signed.settlement.payTo,\n facilitatorFee: signed.settlement.facilitatorFee,\n hook: signed.settlement.hook,\n hookData: signed.settlement.hookData,\n },\n };\n\n // Call core's settle method with standard x402 v2 payload structure\n const result = await coreSettle(facilitatorUrl, paymentPayload, paymentRequirements, timeout);\n\n return {\n success: result.success,\n transaction: result.transaction as Hex,\n network: result.network \|\| signed.settlement.network,\n payer: (result.payer \|\| signed.settlement.from) as Address,\n errorReason: result.errorReason,\n };\n } catch (error) {\n if (error instanceof FacilitatorError) {\n throw error;\n }\n\n // Handle errors from core settle\n if (error instanceof Error) {\n throw new FacilitatorError(`Failed to settle payment: ${error.message}`, \"SETTLEMENT_ERROR\");\n }\n\n throw new FacilitatorError(\"Failed to settle payment: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n","/\n X402Client - High-level client for x402x Serverless Mode\n \n This is the main client class that provides a simple API for executing\n * on-chain contracts via facilitator without needing a resource server.\n /\n\nimport type { Address, Hex, TransactionReceipt } from \"viem\";\nimport { calculateFacilitatorFee, type FeeCalculationResult, TransferHook } from \"@x402x/extensions\";\nimport type { X402ClientConfig, ExecuteParams, ExecuteResult } from \"./types.js\";\nimport { prepareSettlement, DEFAULT_FACILITATOR_URL } from \"./core/prepare.js\";\nimport { signAuthorization } from \"./core/sign.js\";\nimport { settle } from \"./core/settle.js\";\nimport { ValidationError, FacilitatorError } from \"./errors.js\";\nimport { normalizeAddress, validateHex, validateAmount } from \"./core/utils.js\";\n\n/\n Re-export default facilitator URL for convenience\n /\nexport { DEFAULT_FACILITATOR_URL };\n\n/\n Internal configuration with required fields\n /\ninterface InternalConfig extends X402ClientConfig {\n facilitatorUrl: string;\n timeout: number;\n confirmationTimeout: number;\n}\n\n/\n X402Client - High-level client for x402x Serverless Mode\n \n This client simplifies the entire settlement flow into a single execute() call,\n * automatically handling:\n * - Parameter preparation\n * - Commitment calculation\n * - EIP-712 signing\n * - Facilitator submission\n * - Transaction confirmation\n \n @example\n * ```typescript\n * import { X402Client } from '@x402x/client';\n * import { TransferHook } from '@x402x/core';\n * import { useWalletClient } from 'wagmi';\n \n const { data: wallet } = useWalletClient();\n \n // Use default facilitator\n * const client = new X402Client({\n * wallet,\n * network: 'base-sepolia'\n * });\n \n // Or specify custom facilitator\n * const client = new X402Client({\n * wallet,\n * network: 'base-sepolia',\n * facilitatorUrl: 'https://custom-facilitator.example.com'\n * });\n \n // Simple transfer (hook and hookData are optional)\n * const result = await client.execute({\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * ```\n /\nexport class X402Client {\n private config: InternalConfig;\n\n /\n Create a new X402Client instance\n \n @param config - Client configuration\n * @throws NetworkError if network is unsupported\n * @throws ValidationError if configuration is invalid\n /\n constructor(config: X402ClientConfig) {\n // Validate configuration\n if (!config.wallet) {\n throw new ValidationError(\"wallet is required\");\n }\n if (!config.network) {\n throw new ValidationError(\"network is required\");\n }\n\n this.config = {\n ...config,\n facilitatorUrl: config.facilitatorUrl \|\| DEFAULT_FACILITATOR_URL,\n timeout: config.timeout \|\| 30000,\n confirmationTimeout: config.confirmationTimeout \|\| 60000,\n };\n }\n\n /\n Execute a settlement transaction\n \n This is the main method that orchestrates the entire settlement flow:\n * 1. Validates parameters\n * 2. Prepares settlement data (queries fee if needed)\n * 3. Signs EIP-3009 authorization\n * 4. Submits to facilitator\n * 5. Optionally waits for transaction confirmation\n \n @param params - Execution parameters\n * @param waitForConfirmation - Whether to wait for transaction confirmation (default: true)\n * @returns Execution result with transaction hash and optional receipt\n \n @throws ValidationError if parameters are invalid\n * @throws NetworkError if network is unsupported\n * @throws SigningError if user rejects signing\n * @throws FacilitatorError if facilitator request fails\n * @throws TransactionError if transaction fails\n \n @example Simple transfer (uses TransferHook by default)\n * ```typescript\n * import { parseDefaultAssetAmount } from '@x402x/core';\n \n // Convert USD amount to atomic units\n * const atomicAmount = parseDefaultAssetAmount('1', 'base-sepolia'); // '1000000'\n \n const result = await client.execute({\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...'\n * });\n * console.log('Transaction:', result.txHash);\n * ```\n \n @example Custom hook\n * ```typescript\n * import { parseDefaultAssetAmount } from '@x402x/core';\n \n const atomicAmount = parseDefaultAssetAmount('5', 'base-sepolia'); // '5000000'\n \n const result = await client.execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...'\n * });\n * ```\n /\n async execute(\n params: ExecuteParams,\n waitForConfirmation: boolean = false,\n ): Promise<ExecuteResult> {\n // 1. Validate and normalize parameters\n const hook: Address = params.hook\n ? normalizeAddress(params.hook, \"hook\")\n : (TransferHook.getAddress(this.config.network) as Address);\n const payTo = normalizeAddress(params.payTo, \"payTo\");\n const hookData = params.hookData \|\| \"0x\";\n\n if (params.hookData) {\n validateHex(params.hookData, \"hookData\");\n }\n validateAmount(params.amount, \"amount\");\n\n // 2. Prepare settlement with normalized addresses\n const settlement = await prepareSettlement({\n wallet: this.config.wallet,\n network: this.config.network,\n hook,\n hookData,\n asset: params.asset,\n amount: params.amount,\n payTo,\n facilitatorFee: params.facilitatorFee,\n customSalt: params.customSalt,\n validAfter: params.validAfter,\n validBefore: params.validBefore,\n networkConfig: this.config.networkConfig,\n facilitatorUrl: this.config.facilitatorUrl,\n });\n\n // 3. Sign authorization\n const signed = await signAuthorization(this.config.wallet, settlement);\n\n // 4. Settle with facilitator\n const settleResult = await settle(this.config.facilitatorUrl, signed, this.config.timeout);\n\n // 5. Optionally wait for confirmation\n let receipt: TransactionReceipt \| undefined;\n if (waitForConfirmation) {\n receipt = await this.waitForTransaction(settleResult.transaction);\n }\n\n return {\n txHash: settleResult.transaction,\n network: settleResult.network,\n payer: settleResult.payer,\n receipt,\n settlement,\n };\n }\n\n /\n Calculate facilitator fee for a hook with optional hook data\n \n Queries the facilitator for the recommended fee based on current gas prices\n * and hook gas usage. The returned fee includes a safety margin to ensure\n * settlement will succeed.\n \n @param hook - Hook contract address\n * @param hookData - Optional encoded hook parameters (default: '0x')\n * @returns Fee calculation result from facilitator\n \n @throws FacilitatorError if query fails\n \n @example\n * ```typescript\n * const fee = await client.calculateFee('0x...', '0x');\n * console.log('Facilitator fee:', fee.facilitatorFee);\n * console.log('Fee in USD:', fee.facilitatorFeeUSD);\n * console.log('Valid for:', fee.validitySeconds, 'seconds');\n * ```\n /\n async calculateFee(hook: Address, hookData: Hex = \"0x\"): Promise<FeeCalculationResult> {\n const normalizedHook = normalizeAddress(hook, \"hook\");\n validateHex(hookData, \"hookData\");\n\n try {\n return await calculateFacilitatorFee(\n this.config.facilitatorUrl,\n this.config.network,\n normalizedHook,\n hookData,\n );\n } catch (error) {\n if (error instanceof Error) {\n throw new FacilitatorError(\n `Failed to calculate facilitator fee: ${error.message}`,\n \"FEE_QUERY_FAILED\",\n );\n }\n throw new FacilitatorError(\n \"Failed to calculate facilitator fee: Unknown error\",\n \"UNKNOWN_ERROR\",\n );\n }\n }\n\n /\n Wait for transaction confirmation\n \n @param txHash - Transaction hash to wait for\n * @returns Transaction receipt\n \n @throws TransactionError if transaction fails or times out\n \n @example\n * ```typescript\n * const receipt = await client.waitForTransaction('0x...');\n * console.log('Status:', receipt.status);\n * ```\n /\n async waitForTransaction(txHash: Hex): Promise<TransactionReceipt> {\n // Check if wallet has waitForTransactionReceipt method\n const publicClient = this.config.wallet as any;\n if (typeof publicClient.waitForTransactionReceipt !== \"function\") {\n throw new Error(\n \"Wallet client does not support waitForTransactionReceipt. \" +\n \"Please use a viem PublicClient or WalletClient with public actions.\",\n );\n }\n\n try {\n const receipt = await publicClient.waitForTransactionReceipt({\n hash: txHash,\n timeout: this.config.confirmationTimeout,\n });\n\n if (receipt.status !== \"success\") {\n throw new Error(`Transaction failed with status: ${receipt.status}`);\n }\n\n return receipt;\n } catch (error) {\n if (error instanceof Error) {\n throw new Error(`Failed to confirm transaction: ${error.message}`);\n }\n throw new Error(\"Failed to confirm transaction: Unknown error\");\n }\n }\n\n /\n Get the network name\n /\n get network(): string {\n return this.config.network;\n }\n\n /\n Get the facilitator URL\n /\n get facilitatorUrl(): string {\n return this.config.facilitatorUrl;\n }\n\n /\n Get the wallet client\n /\n get wallet() {\n return this.config.wallet;\n }\n}\n","/\n React hook for creating X402Client instance\n \n This hook automatically creates an X402Client instance using wagmi's\n * wallet client and chain information.\n /\n\nimport { useMemo } from \"react\";\nimport { useWalletClient, useAccount, useChainId, WagmiProviderNotFoundError } from \"wagmi\";\nimport { publicActions } from \"viem\";\nimport { X402Client } from \"../client.js\";\nimport type { X402ClientConfig } from \"../types.js\";\n\n/\n Partial configuration for useX402Client hook\n * (wallet, network, chainId are auto-detected from wagmi)\n /\nexport type UseX402ClientConfig = Partial<Omit<X402ClientConfig, \"wallet\" \| \"network\">> & {\n /* Optional: Facilitator URL (default: https://facilitator.x402x.dev/) /\n facilitatorUrl?: string;\n /* Optional: Override network name (auto-detected from chain if not provided) /\n network?: string;\n};\n\n/\n Map chainId to network name\n /\nconst CHAIN_ID_TO_NETWORK: Record<number, string> = {\n 84532: \"base-sepolia\",\n 8453: \"base\",\n 196: \"x-layer\",\n 1952: \"x-layer-testnet\",\n 97: \"bsc-testnet\",\n 56: \"bsc\",\n};\n\n/\n React hook for X402Client\n \n Automatically creates an X402Client instance using the connected wallet\n * from wagmi. Returns null if wallet is not connected.\n \n @param config - Client configuration (facilitatorUrl is optional, defaults to https://facilitator.x402x.dev/)\n * @returns X402Client instance or null if wallet not connected\n \n @example\n * ```typescript\n * import { useX402Client } from '@x402x/client';\n \n function MyComponent() {\n * // Use default facilitator\n * const client = useX402Client();\n \n // Or specify custom facilitator\n * const client = useX402Client({\n * facilitatorUrl: 'https://custom-facilitator.example.com'\n * });\n \n if (!client) {\n * return <div>Please connect your wallet</div>;\n * }\n \n const handlePay = async () => {\n * const result = await client.execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * };\n \n return <button onClick={handlePay}>Pay</button>;\n * }\n * ```\n /\nexport function useX402Client(config?: UseX402ClientConfig): X402Client \| null {\n // First, try to get wagmi hooks outside of useMemo to catch provider errors early\n let walletClient: any;\n let isConnected: boolean;\n let chainId: number;\n\n try {\n const walletClientResult = useWalletClient();\n const accountResult = useAccount();\n const chainIdResult = useChainId();\n\n walletClient = walletClientResult.data;\n isConnected = accountResult.isConnected;\n chainId = chainIdResult;\n } catch (error) {\n // If wagmi provider context is missing (e.g., during early render), return null quietly\n if (\n error instanceof WagmiProviderNotFoundError \|\|\n (error as any)?.name === \"WagmiProviderNotFoundError\" \|\|\n (error instanceof Error &&\n error.message.includes(\"useConfig\") &&\n error.message.includes(\"WagmiProvider\"))\n ) {\n return null;\n }\n\n console.warn(\"[x402x] Unable to access wagmi provider:\", error);\n return null;\n }\n\n return useMemo(() => {\n if (!isConnected \|\| !walletClient) {\n return null;\n }\n\n // Determine network name\n const network = config?.network \|\| CHAIN_ID_TO_NETWORK[chainId];\n if (!network) {\n console.warn(\n `[x402x] Unknown chainId ${chainId}. Please provide network name explicitly in config.`,\n );\n return null;\n }\n\n try {\n // Extend wallet client with public actions (required for waitForTransactionReceipt)\n const extendedWallet = walletClient.extend(publicActions);\n\n return new X402Client({\n wallet: extendedWallet,\n network,\n facilitatorUrl: config?.facilitatorUrl,\n networkConfig: config?.networkConfig,\n timeout: config?.timeout,\n confirmationTimeout: config?.confirmationTimeout,\n });\n } catch (error) {\n console.error(\"[x402x] Failed to create X402Client:\", error);\n return null;\n }\n }, [\n isConnected,\n walletClient,\n chainId,\n config?.network,\n config?.facilitatorUrl,\n config?.networkConfig,\n config?.timeout,\n config?.confirmationTimeout,\n ]);\n}\n","/\n React hook for executing settlements\n \n This hook provides a simple interface for executing settlements with\n * automatic state management (status, error, result).\n /\n\nimport { useState, useCallback } from \"react\";\nimport { useX402Client, type UseX402ClientConfig } from \"./useX402Client.js\";\nimport type { ExecuteParams, ExecuteResult, ExecuteStatus } from \"../types.js\";\n\n/\n Return type for useExecute hook\n /\nexport interface UseExecuteReturn {\n /* Execute a settlement /\n execute: (params: ExecuteParams, waitForConfirmation?: boolean) => Promise<ExecuteResult>;\n /* Current execution status /\n status: ExecuteStatus;\n /* Error if execution failed /\n error: Error \| null;\n /* Result if execution succeeded /\n result: ExecuteResult \| null;\n /* Reset state /\n reset: () => void;\n /* Whether currently executing /\n isExecuting: boolean;\n /* Whether execution succeeded /\n isSuccess: boolean;\n /* Whether execution failed /\n isError: boolean;\n}\n\n/\n React hook for executing settlements\n \n Provides a simple interface for executing settlements with automatic\n * state management. Automatically uses the connected wallet from wagmi.\n \n @param config - Optional client configuration (if not using global client)\n * @returns Execute function and state\n \n @example\n * ```typescript\n * import { useExecute } from '@x402x/client';\n * import { TransferHook } from '@x402x/core';\n \n function PayButton() {\n * const { execute, status, error, result } = useExecute({\n * facilitatorUrl: 'https://facilitator.x402x.dev'\n * });\n \n const handlePay = async () => {\n * try {\n * // Simple transfer (hook and hookData are optional)\n * const result = await execute({\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * console.log('Success:', result.txHash);\n * } catch (err) {\n * console.error('Failed:', err);\n * }\n * };\n \n return (\n * <div>\n * <button onClick={handlePay} disabled={status !== 'idle'}>\n * {status === 'idle' ? 'Pay' : 'Processing...'}\n * </button>\n * {status === 'success' && <div>✅ Success! TX: {result.txHash}</div>}\n * {status === 'error' && <div>❌ Error: {error.message}</div>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useExecute(config?: UseX402ClientConfig): UseExecuteReturn {\n const client = useX402Client(config);\n const [status, setStatus] = useState<ExecuteStatus>(\"idle\");\n const [error, setError] = useState<Error \| null>(null);\n const [result, setResult] = useState<ExecuteResult \| null>(null);\n\n const execute = useCallback(\n async (params: ExecuteParams, waitForConfirmation: boolean = true): Promise<ExecuteResult> => {\n if (!client) {\n throw new Error(\"X402Client not available. Please connect your wallet.\");\n }\n\n setStatus(\"preparing\");\n setError(null);\n setResult(null);\n\n try {\n const executeResult = await client.execute(params, waitForConfirmation);\n setStatus(\"success\");\n setResult(executeResult);\n return executeResult;\n } catch (err) {\n const error = err instanceof Error ? err : new Error(\"Unknown error\");\n setStatus(\"error\");\n setError(error);\n throw error;\n }\n },\n [client],\n );\n\n const reset = useCallback(() => {\n setStatus(\"idle\");\n setError(null);\n setResult(null);\n }, []);\n\n return {\n execute,\n status,\n error,\n result,\n reset,\n isExecuting: [\"preparing\", \"signing\", \"submitting\", \"confirming\"].includes(status),\n isSuccess: status === \"success\",\n isError: status === \"error\",\n };\n}\n\n/\n Alternative hook that doesn't require config (uses default client from context)\n \n @example\n * ```typescript\n * import { useExecute } from '@x402x/client';\n \n function PayButton({ facilitatorUrl }: { facilitatorUrl: string }) {\n * const { execute, status, error } = useExecute({ facilitatorUrl });\n \n const handlePay = async () => {\n * await execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: '1000000',\n * recipient: '0x...'\n * });\n * };\n \n return (\n * <button onClick={handlePay} disabled={status !== 'idle'}>\n * Pay\n * </button>\n * );\n * }\n * ```\n */\nexport function useExecuteWithClient(\n client: ReturnType<typeof useX402Client>,\n): Omit<UseExecuteReturn, \"reset\"> {\n const [status, setStatus] = useState<ExecuteStatus>(\"idle\");\n const [error, setError] = useState<Error \| null>(null);\n const [result, setResult] = useState<ExecuteResult \| null>(null);\n\n const execute = useCallback(\n async (params: ExecuteParams, waitForConfirmation: boolean = true): Promise<ExecuteResult> => {\n if (!client) {\n throw new Error(\"X402Client not available. Please connect your wallet.\");\n }\n\n setStatus(\"preparing\");\n setError(null);\n setResult(null);\n\n try {\n const executeResult = await client.execute(params, waitForConfirmation);\n setStatus(\"success\");\n setResult(executeResult);\n return executeResult;\n } catch (err) {\n const error = err instanceof Error ? err : new Error(\"Unknown error\");\n setStatus(\"error\");\n setError(error);\n throw error;\n }\n },\n [client],\n );\n\n return {\n execute,\n status,\n error,\n result,\n isExecuting: [\"preparing\", \"signing\", \"submitting\", \"confirming\"].includes(status),\n isSuccess: status === \"success\",\n isError: status === \"error\",\n };\n}\n"]}
1	+ {"version":3,"sources":["../src/errors.ts","../src/core/utils.ts","../src/core/prepare.ts","../src/core/sign.ts","../src/core/settle.ts","../src/client.ts","../src/hooks/useX402xClient.ts","../src/hooks/useExecute.ts"],"names":["getAddress","coreSettle","calculateFacilitatorFee","error"],"mappings":"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","file":"index.js","sourcesContent":["/*\n Error classes for x402x client SDK\n /\n\n/\n Base error class for all x402x client errors\n /\nexport class X402ClientError extends Error {\n constructor(\n message: string,\n public readonly code?: string,\n ) {\n super(message);\n this.name = \"X402ClientError\";\n Object.setPrototypeOf(this, X402ClientError.prototype);\n }\n}\n\n/\n Network-related errors (unsupported network, configuration issues)\n /\nexport class NetworkError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"NetworkError\";\n Object.setPrototypeOf(this, NetworkError.prototype);\n }\n}\n\n/\n Wallet signing errors\n /\nexport class SigningError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"SigningError\";\n Object.setPrototypeOf(this, SigningError.prototype);\n }\n}\n\n/\n Facilitator communication errors\n /\nexport class FacilitatorError extends X402ClientError {\n constructor(\n message: string,\n code?: string,\n public readonly statusCode?: number,\n public readonly response?: unknown,\n ) {\n super(message, code);\n this.name = \"FacilitatorError\";\n Object.setPrototypeOf(this, FacilitatorError.prototype);\n }\n}\n\n/\n Transaction execution errors\n /\nexport class TransactionError extends X402ClientError {\n constructor(\n message: string,\n code?: string,\n public readonly txHash?: string,\n ) {\n super(message, code);\n this.name = \"TransactionError\";\n Object.setPrototypeOf(this, TransactionError.prototype);\n }\n}\n\n/\n Parameter validation errors\n /\nexport class ValidationError extends X402ClientError {\n constructor(message: string, code?: string) {\n super(message, code);\n this.name = \"ValidationError\";\n Object.setPrototypeOf(this, ValidationError.prototype);\n }\n}\n","/\n Utility functions for x402x client\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { getAddress, isAddress } from \"viem\";\nimport { ValidationError } from \"../errors.js\";\n\n/\n Generate a random 32-byte salt for settlement idempotency\n \n @returns Random 32-byte hex string\n \n @example\n * ```typescript\n * const salt = generateSalt();\n * console.log(salt); // \"0x1234...\"\n * ```\n /\nexport function generateSalt(): Hex {\n const cryptoObj = (globalThis as any).crypto as Crypto \| undefined;\n\n if (!cryptoObj \|\| !cryptoObj.getRandomValues) {\n throw new Error(\"crypto.getRandomValues is not available\");\n }\n\n const randomBytes = cryptoObj.getRandomValues(new Uint8Array(32));\n return `0x${Array.from(randomBytes)\n .map((b) => b.toString(16).padStart(2, \"0\"))\n .join(\"\")}` as Hex;\n}\n\n/\n Normalize Ethereum address to EIP-55 checksum format\n \n Automatically converts any valid Ethereum address (lowercase, uppercase, or mixed)\n * to the proper checksummed format. This provides a better developer experience\n * by accepting addresses in any case format.\n \n @param address - Address to normalize (can be any case)\n * @param name - Parameter name for error messages (optional)\n * @returns Checksummed address in EIP-55 format\n * @throws ValidationError if address is invalid\n \n @example\n * ```typescript\n * normalizeAddress('0xabc123...') // Returns '0xAbC123...' (checksummed)\n * normalizeAddress('0xABC123...') // Returns '0xAbC123...' (checksummed)\n * normalizeAddress('0xAbC123...') // Returns '0xAbC123...' (already checksummed)\n * ```\n /\nexport function normalizeAddress(address: string, name: string = \"address\"): Address {\n if (!address \|\| typeof address !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n\n // Convert to EIP-55 checksum format\n // getAddress() will throw if the address is invalid\n try {\n return getAddress(address);\n } catch (error) {\n throw new ValidationError(\n `${name} is not a valid Ethereum address: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n );\n }\n}\n\n/\n Validate Ethereum address format (legacy, prefer normalizeAddress)\n \n @deprecated Use normalizeAddress() instead for better developer experience\n * @param address - Address to validate\n * @param name - Parameter name for error messages\n * @throws ValidationError if address is invalid\n /\nexport function validateAddress(address: string, name: string): void {\n if (!address \|\| typeof address !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n if (!isAddress(address)) {\n throw new ValidationError(`${name} must be a valid Ethereum address`);\n }\n}\n\n/\n Validate hex string format\n \n @param hex - Hex string to validate\n * @param name - Parameter name for error messages\n * @param expectedLength - Optional expected length (in bytes, not characters)\n * @throws ValidationError if hex is invalid\n /\nexport function validateHex(hex: string, name: string, expectedLength?: number): void {\n if (!hex \|\| typeof hex !== \"string\") {\n throw new ValidationError(`${name} is required`);\n }\n if (!hex.startsWith(\"0x\")) {\n throw new ValidationError(`${name} must start with 0x`);\n }\n if (!/^0x[0-9a-fA-F]$/.test(hex)) {\n throw new ValidationError(`${name} must be a valid hex string`);\n }\n if (expectedLength !== undefined) {\n const actualLength = (hex.length - 2) / 2;\n if (actualLength !== expectedLength) {\n throw new ValidationError(\n `${name} must be ${expectedLength} bytes, got ${actualLength} bytes`,\n );\n }\n }\n}\n\n/*\n Validate amount format - must be atomic units (positive integer string)\n \n This function validates that the amount is a valid atomic unit string.\n * For converting USD amounts to atomic units, use parseDefaultAssetAmount from @x402x/core.\n \n @param amount - Amount in atomic units (must be a positive integer string)\n * @param name - Parameter name for error messages\n * @throws ValidationError if amount is invalid\n \n @example\n * ```typescript\n * validateAmount('1000000', 'amount'); // Valid: atomic units\n * validateAmount('0.1', 'amount'); // Invalid: not atomic units\n * validateAmount('-1', 'amount'); // Invalid: negative\n * ```\n /\nexport function validateAmount(amount: string \| number, name: string): void {\n if (amount === null \|\| amount === undefined \|\| amount === \"\") {\n throw new ValidationError(`${name} is required`);\n }\n\n // Convert to string if number\n const amountStr = typeof amount === \"number\" ? amount.toString() : amount;\n\n // Must be a non-empty string\n if (typeof amountStr !== \"string\" \|\| amountStr.trim() === \"\") {\n throw new ValidationError(`${name} must be a non-empty string`);\n }\n\n // Must be a valid positive integer (atomic units)\n // Allow leading zeros but must be numeric\n if (!/^\\d+$/.test(amountStr)) {\n throw new ValidationError(\n `${name} must be a positive integer string (atomic units). ` +\n `Use parseDefaultAssetAmount() from @x402x/core to convert USD amounts.`,\n );\n }\n\n // Validate it can be converted to BigInt (no overflow)\n try {\n const atomicAmount = BigInt(amountStr);\n if (atomicAmount < 0n) {\n throw new ValidationError(`${name} cannot be negative`);\n }\n if (atomicAmount === 0n) {\n throw new ValidationError(`${name} cannot be zero`);\n }\n } catch (error) {\n if (error instanceof ValidationError) {\n throw error;\n }\n throw new ValidationError(\n `${name} is not a valid amount: ${error instanceof Error ? error.message : \"Invalid format\"}`,\n );\n }\n}\n\n/\n Format facilitator URL (ensure it doesn't end with slash)\n \n @param url - Facilitator URL\n * @returns Formatted URL\n /\nexport function formatFacilitatorUrl(url: string): string {\n return url.endsWith(\"/\") ? url.slice(0, -1) : url;\n}\n\n/\n Calculate default time window for authorization\n \n @param maxTimeoutSeconds - Maximum timeout in seconds\n * @returns Object with validAfter and validBefore timestamps\n /\nexport function calculateTimeWindow(maxTimeoutSeconds: number = 300): {\n validAfter: string;\n validBefore: string;\n} {\n const now = Math.floor(Date.now() / 1000);\n return {\n validAfter: (now - 600).toString(), // 10 minutes before\n validBefore: (now + maxTimeoutSeconds).toString(),\n };\n}\n","/\n Prepare settlement data for signing\n \n This module handles the preparation of settlement parameters before signing,\n * including generating salt, calculating commitment hash, and fetching facilitator fees.\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { getNetworkConfig, calculateFacilitatorFee, type FeeCalculationResult } from \"@x402x/extensions\";\nimport { calculateCommitment } from \"@x402x/extensions\";\nimport type { PrepareParams, SettlementData } from \"../types.js\";\nimport { NetworkError, ValidationError, FacilitatorError } from \"../errors.js\";\nimport {\n generateSalt,\n validateAddress,\n validateHex,\n validateAmount,\n calculateTimeWindow,\n} from \"./utils.js\";\n\n/\n Default facilitator URL\n /\nexport const DEFAULT_FACILITATOR_URL = \"https://facilitator.x402x.dev\";\n\n/\n Query facilitator fee from facilitator service (internal helper)\n \n Uses the /calculate-fee endpoint which provides accurate gas cost estimates\n * with safety margins.\n \n @internal\n * @param facilitatorUrl - Facilitator URL\n * @param network - Network name\n * @param hook - Hook contract address\n * @param hookData - Optional encoded hook parameters (default: '0x')\n * @returns Fee calculation result\n \n @throws FacilitatorError if request fails\n /\nasync function queryFacilitatorFee(\n facilitatorUrl: string,\n network: string,\n hook: Address,\n hookData: Hex = \"0x\",\n): Promise<FeeCalculationResult> {\n try {\n return await calculateFacilitatorFee(facilitatorUrl, network, hook, hookData);\n } catch (error) {\n if (error instanceof Error) {\n throw new FacilitatorError(\n `Failed to query facilitator fee: ${error.message}`,\n \"FEE_QUERY_FAILED\",\n );\n }\n throw new FacilitatorError(\"Failed to query facilitator fee: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n\n/\n Prepare settlement data for signing\n \n This function:\n * 1. Validates all parameters\n * 2. Loads network configuration\n * 3. Generates salt (if not provided)\n * 4. Queries facilitator fee (if not provided)\n * 5. Calculates time window (if not provided)\n * 6. Calculates commitment hash\n * 7. Returns prepared settlement data\n \n @param params - Preparation parameters\n * @returns Prepared settlement data ready for signing\n \n @throws NetworkError if network is unsupported\n * @throws ValidationError if parameters are invalid\n \n @example\n * ```typescript\n * import { prepareSettlement } from '@x402x/client';\n * import { TransferHook, parseDefaultAssetAmount } from '@x402x/core';\n \n // Convert USD amount to atomic units first\n * const atomicAmount = parseDefaultAssetAmount('1', 'base-sepolia'); // '1000000'\n \n const settlement = await prepareSettlement({\n * wallet: walletClient,\n * network: 'base-sepolia',\n * hook: TransferHook.getAddress('base-sepolia'),\n * hookData: TransferHook.encode(),\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...',\n * facilitatorUrl: 'https://facilitator.x402x.dev'\n * });\n * ```\n /\nexport async function prepareSettlement(params: PrepareParams): Promise<SettlementData> {\n // 1. Validate parameters\n validateAddress(params.hook, \"hook\");\n validateHex(params.hookData, \"hookData\");\n validateAddress(params.payTo, \"payTo\");\n\n // 2. Validate amount (must be atomic units, no automatic conversion)\n validateAmount(params.amount, \"amount\");\n const atomicAmount = params.amount;\n\n if (params.customSalt) {\n validateHex(params.customSalt, \"customSalt\", 32);\n }\n\n // 2. Get wallet account address\n const from = params.wallet.account?.address;\n if (!from) {\n throw new ValidationError(\"Wallet client must have an account\");\n }\n\n // 3. Load network configuration\n const networkConfig = params.networkConfig \|\| getNetworkConfig(params.network);\n if (!networkConfig) {\n throw new NetworkError(\n `Network '${params.network}' is not supported. Please provide custom networkConfig.`,\n );\n }\n\n // 4. Determine asset address (use provided asset or default asset)\n const asset = params.asset \|\| (networkConfig.defaultAsset.address as Address);\n validateAddress(asset, \"asset\");\n\n // 5. Generate salt (if not provided)\n const salt = params.customSalt \|\| generateSalt();\n\n // 6. Query facilitator fee (if not provided)\n // Use the provided facilitatorUrl or fall back to default\n let facilitatorFee = params.facilitatorFee \|\| \"0\";\n if (!params.facilitatorFee) {\n const facilitatorUrl = params.facilitatorUrl \|\| DEFAULT_FACILITATOR_URL;\n try {\n const feeEstimate = await queryFacilitatorFee(\n facilitatorUrl,\n params.network,\n params.hook,\n params.hookData, // Pass hookData for accurate fee calculation\n );\n\n if (!feeEstimate.hookAllowed) {\n throw new ValidationError(\n `Hook ${params.hook} is not allowed on network ${params.network}.`,\n );\n }\n\n facilitatorFee = feeEstimate.facilitatorFee;\n } catch (error) {\n // If fee query fails, log warning and use 0\n console.warn(\n `[x402x] Failed to query facilitator fee, using 0. This may cause settlement to fail. Error: ${\n error instanceof Error ? error.message : \"Unknown\"\n }`,\n );\n facilitatorFee = \"0\";\n }\n }\n\n // 7. Calculate time window (if not provided)\n const timeWindow =\n params.validAfter && params.validBefore\n ? { validAfter: params.validAfter, validBefore: params.validBefore }\n : calculateTimeWindow(300); // 5 minutes default\n\n // 8. Calculate commitment hash\n // IMPORTANT: value must be total amount (business amount + facilitator fee)\n // because the contract's calculateCommitment expects the same value that\n // will be authorized in the EIP-3009 signature\n const totalAmount = (BigInt(atomicAmount) + BigInt(facilitatorFee)).toString();\n const commitment = calculateCommitment({\n chainId: networkConfig.chainId,\n hub: networkConfig.settlementRouter as Address,\n asset: asset,\n from,\n value: totalAmount,\n validAfter: timeWindow.validAfter,\n validBefore: timeWindow.validBefore,\n salt,\n payTo: params.payTo,\n facilitatorFee,\n hook: params.hook,\n hookData: params.hookData,\n });\n\n // 9. Return prepared settlement data\n // Use original network name for API compatibility; conversion to canonical format happens during settlement\n return {\n network: params.network,\n networkConfig,\n asset: asset,\n from,\n amount: atomicAmount,\n validAfter: timeWindow.validAfter,\n validBefore: timeWindow.validBefore,\n salt,\n payTo: params.payTo,\n facilitatorFee,\n hook: params.hook,\n hookData: params.hookData,\n commitment: commitment as Hex,\n };\n}\n","/\n Sign EIP-3009 authorization for settlement\n \n This module handles the signing of EIP-712 typed data for EIP-3009\n * transferWithAuthorization, using the commitment hash as the nonce.\n /\n\nimport type { Address, WalletClient } from \"viem\";\nimport { getAddress } from \"viem\";\nimport { signTypedData } from \"viem/actions\";\nimport type { SettlementData, SignedAuthorization } from \"../types.js\";\nimport { SigningError } from \"../errors.js\";\n\n/\n EIP-3009 authorization types for EIP-712 signature\n /\nconst AUTHORIZATION_TYPES = {\n TransferWithAuthorization: [\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/\n Sign EIP-3009 authorization\n \n This function signs an EIP-712 typed data message for EIP-3009's\n * transferWithAuthorization function. The commitment hash is used\n * as the nonce to cryptographically bind all settlement parameters.\n \n @param wallet - Wallet client from wagmi/viem\n * @param settlement - Prepared settlement data\n * @returns Signed authorization ready to submit\n \n @throws SigningError if signing fails or wallet doesn't support signing\n \n @example\n * ```typescript\n * import { signAuthorization } from '@x402x/client';\n \n const signed = await signAuthorization(walletClient, settlement);\n * console.log('Signature:', signed.signature);\n * ```\n /\nexport async function signAuthorization(\n wallet: WalletClient,\n settlement: SettlementData,\n): Promise<SignedAuthorization> {\n try {\n // Ensure wallet has an account\n if (!wallet.account) {\n throw new SigningError(\"Wallet client must have an account\");\n }\n\n // Build EIP-712 domain\n // Use the asset's EIP-712 domain info from network config\n // Note: For custom assets, the domain info should match the asset contract\n const domain = {\n name: settlement.networkConfig.defaultAsset.eip712.name,\n version: settlement.networkConfig.defaultAsset.eip712.version,\n chainId: settlement.networkConfig.chainId,\n verifyingContract: getAddress(settlement.asset),\n };\n\n // Build EIP-712 message\n // The \"to\" address is the SettlementRouter (not the final recipient)\n // The \"value\" MUST be total amount (business amount + facilitator fee)\n // because the Router needs to deduct the fee before passing to Hook\n const totalAmount = BigInt(settlement.amount) + BigInt(settlement.facilitatorFee);\n const message = {\n from: getAddress(settlement.from),\n to: getAddress(settlement.networkConfig.settlementRouter),\n value: totalAmount,\n validAfter: BigInt(settlement.validAfter),\n validBefore: BigInt(settlement.validBefore),\n nonce: settlement.commitment, // Use commitment as nonce\n };\n\n console.log(\"[x402x/client] EIP-712 Message for signing:\", {\n from: message.from,\n to: message.to,\n value: message.value.toString(),\n validAfter: message.validAfter.toString(),\n validBefore: message.validBefore.toString(),\n nonce: message.nonce,\n });\n\n // Sign typed data\n const signature = await signTypedData(wallet, {\n account: wallet.account,\n domain,\n types: AUTHORIZATION_TYPES,\n primaryType: \"TransferWithAuthorization\",\n message,\n });\n\n // Build authorization object\n const authorization = {\n from: settlement.from,\n to: settlement.networkConfig.settlementRouter as Address,\n value: totalAmount.toString(), // Use total amount (business + fee)\n validAfter: settlement.validAfter,\n validBefore: settlement.validBefore,\n nonce: settlement.commitment,\n };\n\n return {\n settlement,\n signature,\n authorization,\n };\n } catch (error) {\n if (error instanceof SigningError) {\n throw error;\n }\n\n // Handle common signing errors\n if (error instanceof Error) {\n if (error.message.includes(\"User rejected\")) {\n throw new SigningError(\"User rejected the signing request\", \"USER_REJECTED\");\n }\n if (error.message.includes(\"account\")) {\n throw new SigningError(\"Wallet account not available\", \"NO_ACCOUNT\");\n }\n throw new SigningError(`Failed to sign authorization: ${error.message}`, \"SIGNING_FAILED\");\n }\n\n throw new SigningError(\"Failed to sign authorization: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n","/\n Settle payment with facilitator\n \n This module handles the settlement of signed payment payloads with the\n * facilitator's /settle endpoint, following the x402 protocol.\n /\n\nimport type { Address, Hex } from \"viem\";\nimport { settle as coreSettle, toCanonicalNetworkKey } from \"@x402x/extensions\";\nimport type {\n SignedAuthorization,\n SettleResult,\n PaymentPayload,\n PaymentRequirements,\n} from \"../types.js\";\nimport { FacilitatorError } from \"../errors.js\";\n\n/\n EVM Exact Scheme Authorization structure\n * Standard x402 v2 authorization format for EIP-3009\n /\ninterface ExactEvmAuthorization {\n from: Address;\n to: Address;\n value: string;\n validAfter: string;\n validBefore: string;\n nonce: Hex;\n}\n\n/\n EVM Exact Scheme Payload structure\n * Standard x402 v2 payload format\n /\ninterface ExactEvmPayload {\n signature: Hex;\n authorization: ExactEvmAuthorization;\n}\n\n/\n Settle signed authorization with facilitator\n \n This function acts as a convenience wrapper that:\n * 1. Constructs the PaymentPayload according to x402 protocol\n * 2. Constructs the PaymentRequirements with settlement extra\n * 3. Calls core's settle() method to POST to facilitator's /settle endpoint\n * 4. Parses and returns the settlement result\n \n @param facilitatorUrl - Facilitator URL\n * @param signed - Signed authorization from signAuthorization\n * @param timeout - Optional timeout in milliseconds (default: 30000)\n * @returns Settlement result with transaction hash\n \n @throws FacilitatorError if request fails or facilitator returns error\n \n @example\n * ```typescript\n * import { settle } from '@x402x/client';\n \n const result = await settle(\n * 'https://facilitator.x402x.dev',\n * signed\n * );\n * console.log('TX Hash:', result.transaction);\n * ```\n /\nexport async function settle(\n facilitatorUrl: string,\n signed: SignedAuthorization,\n timeout: number = 30000,\n): Promise<SettleResult> {\n try {\n // Convert network to CAIP-2 format for v2 protocol\n const canonicalNetwork = toCanonicalNetworkKey(signed.settlement.network);\n\n // Calculate total amount (business amount + facilitator fee)\n // This MUST match what was used in commitment calculation\n const totalAmount = (\n BigInt(signed.settlement.amount) + BigInt(signed.settlement.facilitatorFee)\n ).toString();\n\n // Construct standard x402 v2 PaymentPayload\n // Using standard EVM exact scheme payload structure\n const exactEvmPayload: ExactEvmPayload = {\n signature: signed.signature,\n authorization: {\n from: signed.authorization.from,\n to: signed.authorization.to,\n value: signed.authorization.value,\n validAfter: signed.authorization.validAfter,\n validBefore: signed.authorization.validBefore,\n nonce: signed.authorization.nonce,\n },\n };\n\n const paymentPayload: PaymentPayload = {\n x402Version: 2, // Use v2 protocol\n resource: {\n url: \"https://x402x.dev/serverless\",\n description: \"x402x Serverless Settlement\",\n mimeType: \"application/json\",\n },\n accepted: {\n scheme: \"exact\",\n network: canonicalNetwork as any, // Type cast required: core_v2 Network type accepts both CAIP-2 and legacy formats\n asset: signed.settlement.asset as Address,\n amount: totalAmount, // Use totalAmount to match commitment calculation\n payTo: signed.settlement.networkConfig.settlementRouter as Address,\n maxTimeoutSeconds: 300,\n extra: {},\n },\n // Standard EVM exact scheme payload\n payload: exactEvmPayload as any, // Type cast required: ExactEvmPayload structure matches v2 protocol\n };\n\n // Construct PaymentRequirements (for serverless mode verification)\n // IMPORTANT: Use totalAmount (amount + fee) to match commitment calculation\n const paymentRequirements: PaymentRequirements = {\n scheme: \"exact\",\n network: canonicalNetwork as any, // Type cast required: core_v2 Network type accepts CAIP-2 format\n amount: totalAmount, // Total amount including facilitator fee\n asset: signed.settlement.asset as Address,\n payTo: signed.settlement.networkConfig.settlementRouter as Address,\n maxTimeoutSeconds: 300, // 5 minutes\n extra: {\n name: signed.settlement.networkConfig.defaultAsset.eip712.name,\n version: signed.settlement.networkConfig.defaultAsset.eip712.version,\n settlementRouter: signed.settlement.networkConfig.settlementRouter as Address,\n salt: signed.settlement.salt,\n payTo: signed.settlement.payTo,\n facilitatorFee: signed.settlement.facilitatorFee,\n hook: signed.settlement.hook,\n hookData: signed.settlement.hookData,\n },\n };\n\n // Call core's settle method with standard x402 v2 payload structure\n const result = await coreSettle(facilitatorUrl, paymentPayload, paymentRequirements, timeout);\n\n return {\n success: result.success,\n transaction: result.transaction as Hex,\n network: result.network \|\| signed.settlement.network,\n payer: (result.payer \|\| signed.settlement.from) as Address,\n errorReason: result.errorReason,\n };\n } catch (error) {\n if (error instanceof FacilitatorError) {\n throw error;\n }\n\n // Handle errors from core settle\n if (error instanceof Error) {\n throw new FacilitatorError(`Failed to settle payment: ${error.message}`, \"SETTLEMENT_ERROR\");\n }\n\n throw new FacilitatorError(\"Failed to settle payment: Unknown error\", \"UNKNOWN_ERROR\");\n }\n}\n","/\n x402xClient - High-level client for x402x Serverless Mode\n \n This is the main client class that provides a simple API for executing\n * on-chain contracts via facilitator without needing a resource server.\n /\n\nimport type { Address, Hex, TransactionReceipt } from \"viem\";\nimport { calculateFacilitatorFee, type FeeCalculationResult, TransferHook } from \"@x402x/extensions\";\nimport type { x402xClientConfig, ExecuteParams, ExecuteResult } from \"./types.js\";\nimport { prepareSettlement, DEFAULT_FACILITATOR_URL } from \"./core/prepare.js\";\nimport { signAuthorization } from \"./core/sign.js\";\nimport { settle } from \"./core/settle.js\";\nimport { ValidationError, FacilitatorError } from \"./errors.js\";\nimport { normalizeAddress, validateHex, validateAmount } from \"./core/utils.js\";\n\n/\n Re-export default facilitator URL for convenience\n /\nexport { DEFAULT_FACILITATOR_URL };\n\n/\n Internal configuration with required fields\n /\ninterface InternalConfig extends x402xClientConfig {\n facilitatorUrl: string;\n timeout: number;\n confirmationTimeout: number;\n}\n\n/\n x402xClient - High-level client for x402x Serverless Mode\n \n This client simplifies the entire settlement flow into a single execute() call,\n * automatically handling:\n * - Parameter preparation\n * - Commitment calculation\n * - EIP-712 signing\n * - Facilitator submission\n * - Transaction confirmation\n \n @example\n * ```typescript\n * import { x402xClient } from '@x402x/client';\n * import { TransferHook } from '@x402x/extensions';\n * import { useWalletClient } from 'wagmi';\n \n const { data: wallet } = useWalletClient();\n \n // Use default facilitator\n * const client = new x402xClient({\n * wallet,\n * network: 'base-sepolia'\n * });\n \n // Or specify custom facilitator\n * const client = new X402Client({\n * wallet,\n * network: 'base-sepolia',\n * facilitatorUrl: 'https://custom-facilitator.example.com'\n * });\n \n // Simple transfer (hook and hookData are optional)\n * const result = await client.execute({\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * ```\n /\nexport class x402xClient {\n private config: InternalConfig;\n\n /\n Create a new x402xClient instance\n \n @param config - Client configuration\n * @throws NetworkError if network is unsupported\n * @throws ValidationError if configuration is invalid\n /\n constructor(config: x402xClientConfig) {\n // Validate configuration\n if (!config.wallet) {\n throw new ValidationError(\"wallet is required\");\n }\n if (!config.network) {\n throw new ValidationError(\"network is required\");\n }\n\n this.config = {\n ...config,\n facilitatorUrl: config.facilitatorUrl \|\| DEFAULT_FACILITATOR_URL,\n timeout: config.timeout \|\| 30000,\n confirmationTimeout: config.confirmationTimeout \|\| 60000,\n };\n }\n\n /\n Execute a settlement transaction\n \n This is the main method that orchestrates the entire settlement flow:\n * 1. Validates parameters\n * 2. Prepares settlement data (queries fee if needed)\n * 3. Signs EIP-3009 authorization\n * 4. Submits to facilitator\n * 5. Optionally waits for transaction confirmation\n \n @param params - Execution parameters\n * @param waitForConfirmation - Whether to wait for transaction confirmation (default: true)\n * @returns Execution result with transaction hash and optional receipt\n \n @throws ValidationError if parameters are invalid\n * @throws NetworkError if network is unsupported\n * @throws SigningError if user rejects signing\n * @throws FacilitatorError if facilitator request fails\n * @throws TransactionError if transaction fails\n \n @example Simple transfer (uses TransferHook by default)\n * ```typescript\n * import { parseDefaultAssetAmount } from '@x402x/core';\n \n // Convert USD amount to atomic units\n * const atomicAmount = parseDefaultAssetAmount('1', 'base-sepolia'); // '1000000'\n \n const result = await client.execute({\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...'\n * });\n * console.log('Transaction:', result.txHash);\n * ```\n \n @example Custom hook\n * ```typescript\n * import { parseDefaultAssetAmount } from '@x402x/core';\n \n const atomicAmount = parseDefaultAssetAmount('5', 'base-sepolia'); // '5000000'\n \n const result = await client.execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: atomicAmount, // Must be atomic units\n * payTo: '0x...'\n * });\n * ```\n /\n async execute(\n params: ExecuteParams,\n waitForConfirmation: boolean = false,\n ): Promise<ExecuteResult> {\n // 1. Validate and normalize parameters\n const hook: Address = params.hook\n ? normalizeAddress(params.hook, \"hook\")\n : (TransferHook.getAddress(this.config.network) as Address);\n const payTo = normalizeAddress(params.payTo, \"payTo\");\n const hookData = params.hookData \|\| \"0x\";\n\n if (params.hookData) {\n validateHex(params.hookData, \"hookData\");\n }\n validateAmount(params.amount, \"amount\");\n\n // 2. Prepare settlement with normalized addresses\n const settlement = await prepareSettlement({\n wallet: this.config.wallet,\n network: this.config.network,\n hook,\n hookData,\n asset: params.asset,\n amount: params.amount,\n payTo,\n facilitatorFee: params.facilitatorFee,\n customSalt: params.customSalt,\n validAfter: params.validAfter,\n validBefore: params.validBefore,\n networkConfig: this.config.networkConfig,\n facilitatorUrl: this.config.facilitatorUrl,\n });\n\n // 3. Sign authorization\n const signed = await signAuthorization(this.config.wallet, settlement);\n\n // 4. Settle with facilitator\n const settleResult = await settle(this.config.facilitatorUrl, signed, this.config.timeout);\n\n // 5. Optionally wait for confirmation\n let receipt: TransactionReceipt \| undefined;\n if (waitForConfirmation) {\n receipt = await this.waitForTransaction(settleResult.transaction);\n }\n\n return {\n txHash: settleResult.transaction,\n network: settleResult.network,\n payer: settleResult.payer,\n receipt,\n settlement,\n };\n }\n\n /\n Calculate facilitator fee for a hook with optional hook data\n \n Queries the facilitator for the recommended fee based on current gas prices\n * and hook gas usage. The returned fee includes a safety margin to ensure\n * settlement will succeed.\n \n @param hook - Hook contract address\n * @param hookData - Optional encoded hook parameters (default: '0x')\n * @returns Fee calculation result from facilitator\n \n @throws FacilitatorError if query fails\n \n @example\n * ```typescript\n * const fee = await client.calculateFee('0x...', '0x');\n * console.log('Facilitator fee:', fee.facilitatorFee);\n * console.log('Fee in USD:', fee.facilitatorFeeUSD);\n * console.log('Valid for:', fee.validitySeconds, 'seconds');\n * ```\n /\n async calculateFee(hook: Address, hookData: Hex = \"0x\"): Promise<FeeCalculationResult> {\n const normalizedHook = normalizeAddress(hook, \"hook\");\n validateHex(hookData, \"hookData\");\n\n try {\n return await calculateFacilitatorFee(\n this.config.facilitatorUrl,\n this.config.network,\n normalizedHook,\n hookData,\n );\n } catch (error) {\n if (error instanceof Error) {\n throw new FacilitatorError(\n `Failed to calculate facilitator fee: ${error.message}`,\n \"FEE_QUERY_FAILED\",\n );\n }\n throw new FacilitatorError(\n \"Failed to calculate facilitator fee: Unknown error\",\n \"UNKNOWN_ERROR\",\n );\n }\n }\n\n /\n Wait for transaction confirmation\n \n @param txHash - Transaction hash to wait for\n * @returns Transaction receipt\n \n @throws TransactionError if transaction fails or times out\n \n @example\n * ```typescript\n * const receipt = await client.waitForTransaction('0x...');\n * console.log('Status:', receipt.status);\n * ```\n /\n async waitForTransaction(txHash: Hex): Promise<TransactionReceipt> {\n // Check if wallet has waitForTransactionReceipt method\n const publicClient = this.config.wallet as any;\n if (typeof publicClient.waitForTransactionReceipt !== \"function\") {\n throw new Error(\n \"Wallet client does not support waitForTransactionReceipt. \" +\n \"Please use a viem PublicClient or WalletClient with public actions.\",\n );\n }\n\n try {\n const receipt = await publicClient.waitForTransactionReceipt({\n hash: txHash,\n timeout: this.config.confirmationTimeout,\n });\n\n if (receipt.status !== \"success\") {\n throw new Error(`Transaction failed with status: ${receipt.status}`);\n }\n\n return receipt;\n } catch (error) {\n if (error instanceof Error) {\n throw new Error(`Failed to confirm transaction: ${error.message}`);\n }\n throw new Error(\"Failed to confirm transaction: Unknown error\");\n }\n }\n\n /\n Get the network name\n /\n get network(): string {\n return this.config.network;\n }\n\n /\n Get the facilitator URL\n /\n get facilitatorUrl(): string {\n return this.config.facilitatorUrl;\n }\n\n /\n Get the wallet client\n /\n get wallet() {\n return this.config.wallet;\n }\n}\n","/\n React hook for creating x402xClient instance\n \n This hook automatically creates an x402xClient instance using wagmi's\n * wallet client and chain information.\n /\n\nimport { useMemo } from \"react\";\nimport { useWalletClient, useAccount, useChainId, WagmiProviderNotFoundError } from \"wagmi\";\nimport { publicActions } from \"viem\";\nimport { x402xClient } from \"../client.js\";\nimport type { x402xClientConfig } from \"../types.js\";\n\n/\n Partial configuration for useX402Client hook\n * (wallet, network, chainId are auto-detected from wagmi)\n /\nexport type UseX402xClientConfig = Partial<Omit<x402xClientConfig, \"wallet\" \| \"network\">> & {\n /* Optional: Facilitator URL (default: https://facilitator.x402x.dev/) /\n facilitatorUrl?: string;\n /* Optional: Override network name (auto-detected from chain if not provided) /\n network?: string;\n};\n\n/\n Map chainId to network name\n /\nconst CHAIN_ID_TO_NETWORK: Record<number, string> = {\n 84532: \"base-sepolia\",\n 8453: \"base\",\n 196: \"x-layer\",\n 1952: \"x-layer-testnet\",\n 97: \"bsc-testnet\",\n 56: \"bsc\",\n};\n\n/\n React hook for x402xClient\n \n Automatically creates an x402xClient instance using the connected wallet\n * from wagmi. Returns null if wallet is not connected.\n \n @param config - Client configuration (facilitatorUrl is optional, defaults to https://facilitator.x402x.dev/)\n * @returns x402xClient instance or null if wallet not connected\n \n @example\n * ```typescript\n * import { useX402xClient } from '@x402x/client';\n \n function MyComponent() {\n * // Use default facilitator\n * const client = useX402xClient();\n \n // Or specify custom facilitator\n * const client = useX402xClient({\n * facilitatorUrl: 'https://custom-facilitator.example.com'\n * });\n \n if (!client) {\n * return <div>Please connect your wallet</div>;\n * }\n \n const handlePay = async () => {\n * const result = await client.execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * };\n \n return <button onClick={handlePay}>Pay</button>;\n * }\n * ```\n /\nexport function useX402xClient(config?: UseX402xClientConfig): x402xClient \| null {\n // First, try to get wagmi hooks outside of useMemo to catch provider errors early\n let walletClient: any;\n let isConnected: boolean;\n let chainId: number;\n\n try {\n const walletClientResult = useWalletClient();\n const accountResult = useAccount();\n const chainIdResult = useChainId();\n\n walletClient = walletClientResult.data;\n isConnected = accountResult.isConnected;\n chainId = chainIdResult;\n } catch (error) {\n // If wagmi provider context is missing (e.g., during early render), return null quietly\n if (\n error instanceof WagmiProviderNotFoundError \|\|\n (error as any)?.name === \"WagmiProviderNotFoundError\" \|\|\n (error instanceof Error &&\n error.message.includes(\"useConfig\") &&\n error.message.includes(\"WagmiProvider\"))\n ) {\n return null;\n }\n\n console.warn(\"[x402x] Unable to access wagmi provider:\", error);\n return null;\n }\n\n return useMemo(() => {\n if (!isConnected \|\| !walletClient) {\n return null;\n }\n\n // Determine network name\n const network = config?.network \|\| CHAIN_ID_TO_NETWORK[chainId];\n if (!network) {\n console.warn(\n `[x402x] Unknown chainId ${chainId}. Please provide network name explicitly in config.`,\n );\n return null;\n }\n\n try {\n // Extend wallet client with public actions (required for waitForTransactionReceipt)\n const extendedWallet = walletClient.extend(publicActions);\n\n return new x402xClient({\n wallet: extendedWallet,\n network,\n facilitatorUrl: config?.facilitatorUrl,\n networkConfig: config?.networkConfig,\n timeout: config?.timeout,\n confirmationTimeout: config?.confirmationTimeout,\n });\n } catch (error) {\n console.error(\"[x402x] Failed to create x402xClient:\", error);\n return null;\n }\n }, [\n isConnected,\n walletClient,\n chainId,\n config?.network,\n config?.facilitatorUrl,\n config?.networkConfig,\n config?.timeout,\n config?.confirmationTimeout,\n ]);\n}\n","/\n React hook for executing settlements\n \n This hook provides a simple interface for executing settlements with\n * automatic state management (status, error, result).\n /\n\nimport { useState, useCallback } from \"react\";\nimport { useX402xClient, type UseX402xClientConfig } from \"./useX402xClient.js\";\nimport type { ExecuteParams, ExecuteResult, ExecuteStatus } from \"../types.js\";\n\n/\n Return type for useExecute hook\n /\nexport interface UseExecuteReturn {\n /* Execute a settlement /\n execute: (params: ExecuteParams, waitForConfirmation?: boolean) => Promise<ExecuteResult>;\n /* Current execution status /\n status: ExecuteStatus;\n /* Error if execution failed /\n error: Error \| null;\n /* Result if execution succeeded /\n result: ExecuteResult \| null;\n /* Reset state /\n reset: () => void;\n /* Whether currently executing /\n isExecuting: boolean;\n /* Whether execution succeeded /\n isSuccess: boolean;\n /* Whether execution failed /\n isError: boolean;\n}\n\n/\n React hook for executing settlements\n \n Provides a simple interface for executing settlements with automatic\n * state management. Automatically uses the connected wallet from wagmi.\n \n @param config - Optional client configuration (if not using global client)\n * @returns Execute function and state\n \n @example\n * ```typescript\n * import { useExecute } from '@x402x/client';\n * import { TransferHook } from '@x402x/core';\n \n function PayButton() {\n * const { execute, status, error, result } = useExecute({\n * facilitatorUrl: 'https://facilitator.x402x.dev'\n * });\n \n const handlePay = async () => {\n * try {\n * // Simple transfer (hook and hookData are optional)\n * const result = await execute({\n * amount: '1000000',\n * payTo: '0x...'\n * });\n * console.log('Success:', result.txHash);\n * } catch (err) {\n * console.error('Failed:', err);\n * }\n * };\n \n return (\n * <div>\n * <button onClick={handlePay} disabled={status !== 'idle'}>\n * {status === 'idle' ? 'Pay' : 'Processing...'}\n * </button>\n * {status === 'success' && <div>✅ Success! TX: {result.txHash}</div>}\n * {status === 'error' && <div>❌ Error: {error.message}</div>}\n * </div>\n * );\n * }\n * ```\n /\nexport function useExecute(config?: UseX402xClientConfig): UseExecuteReturn {\n const client = useX402xClient(config);\n const [status, setStatus] = useState<ExecuteStatus>(\"idle\");\n const [error, setError] = useState<Error \| null>(null);\n const [result, setResult] = useState<ExecuteResult \| null>(null);\n\n const execute = useCallback(\n async (params: ExecuteParams, waitForConfirmation: boolean = true): Promise<ExecuteResult> => {\n if (!client) {\n throw new Error(\"X402Client not available. Please connect your wallet.\");\n }\n\n setStatus(\"preparing\");\n setError(null);\n setResult(null);\n\n try {\n const executeResult = await client.execute(params, waitForConfirmation);\n setStatus(\"success\");\n setResult(executeResult);\n return executeResult;\n } catch (err) {\n const error = err instanceof Error ? err : new Error(\"Unknown error\");\n setStatus(\"error\");\n setError(error);\n throw error;\n }\n },\n [client],\n );\n\n const reset = useCallback(() => {\n setStatus(\"idle\");\n setError(null);\n setResult(null);\n }, []);\n\n return {\n execute,\n status,\n error,\n result,\n reset,\n isExecuting: [\"preparing\", \"signing\", \"submitting\", \"confirming\"].includes(status),\n isSuccess: status === \"success\",\n isError: status === \"error\",\n };\n}\n\n/\n Alternative hook that doesn't require config (uses default client from context)\n \n @example\n * ```typescript\n * import { useExecute } from '@x402x/client';\n \n function PayButton({ facilitatorUrl }: { facilitatorUrl: string }) {\n * const { execute, status, error } = useExecute({ facilitatorUrl });\n \n const handlePay = async () => {\n * await execute({\n * hook: '0x...',\n * hookData: '0x...',\n * amount: '1000000',\n * recipient: '0x...'\n * });\n * };\n \n return (\n * <button onClick={handlePay} disabled={status !== 'idle'}>\n * Pay\n * </button>\n * );\n * }\n * ```\n */\nexport function useExecuteWithClient(\n client: ReturnType<typeof useX402xClient>,\n): Omit<UseExecuteReturn, \"reset\"> {\n const [status, setStatus] = useState<ExecuteStatus>(\"idle\");\n const [error, setError] = useState<Error \| null>(null);\n const [result, setResult] = useState<ExecuteResult \| null>(null);\n\n const execute = useCallback(\n async (params: ExecuteParams, waitForConfirmation: boolean = true): Promise<ExecuteResult> => {\n if (!client) {\n throw new Error(\"X402Client not available. Please connect your wallet.\");\n }\n\n setStatus(\"preparing\");\n setError(null);\n setResult(null);\n\n try {\n const executeResult = await client.execute(params, waitForConfirmation);\n setStatus(\"success\");\n setResult(executeResult);\n return executeResult;\n } catch (err) {\n const error = err instanceof Error ? err : new Error(\"Unknown error\");\n setStatus(\"error\");\n setError(error);\n throw error;\n }\n },\n [client],\n );\n\n return {\n execute,\n status,\n error,\n result,\n isExecuting: [\"preparing\", \"signing\", \"submitting\", \"confirming\"].includes(status),\n isSuccess: status === \"success\",\n isError: status === \"error\",\n };\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@x402x/client",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Client SDK for x402x Serverless Mode - execute on-chain contracts directly via facilitator",
   "type": "module",
   "main": "./dist/index.cjs",