@payai/x402-evm 2.4.0 → 2.4.2

package/dist/esm/index.d.mts

@@ -1,8 +1,13 @@
-export { E as ExactEvmScheme } from './scheme-DCR7hsa3.mjs';
-export { C as ClientEvmSigner, F as FacilitatorEvmSigner, t as toClientEvmSigner, a as toFacilitatorEvmSigner } from './signer-D912R4mq.mjs';
-export { a as PERMIT2_ADDRESS, P as Permit2AllowanceParams, d as authorizationTypes, c as createPermit2ApprovalTx, f as eip3009ABI, e as erc20AllowanceAbi, g as getPermit2AllowanceReadParams, p as permit2WitnessTypes, u as uptoPermit2WitnessTypes, h as x402ExactPermit2ProxyABI, x as x402ExactPermit2ProxyAddress, i as x402UptoPermit2ProxyABI, b as x402UptoPermit2ProxyAddress } from './permit2-CyZxwngN.mjs';
+export { E as ExactEvmScheme } from './scheme-gtqAIYPJ.mjs';
+export { C as ClientEvmSigner, F as FacilitatorEvmSigner, t as toClientEvmSigner, a as toFacilitatorEvmSigner } from './signer-tYS6Y46X.mjs';
+export { a as PERMIT2_ADDRESS, P as Permit2AllowanceParams, d as authorizationTypes, c as createPermit2ApprovalTx, f as eip3009ABI, e as erc20AllowanceAbi, g as getPermit2AllowanceReadParams, p as permit2WitnessTypes, u as uptoPermit2WitnessTypes, h as x402ExactPermit2ProxyABI, x as x402ExactPermit2ProxyAddress, i as x402UptoPermit2ProxyABI, b as x402UptoPermit2ProxyAddress } from './permit2-DhJRUcgY.mjs';
 export { UptoEvmScheme } from './upto/client/index.mjs';
-import '@payai/x402/types';
+export { B as BatchSettlementEvmScheme } from './scheme-DtbSS4Fk.mjs';
+export { A as AuthorizerSigner, f as BatchSettlementClaimPayload, B as BatchSettlementDepositPayload, g as BatchSettlementEnrichedRefundPayload, e as BatchSettlementErc3009Authorization, k as BatchSettlementFacilitatorSettlePayload, i as BatchSettlementPayload, l as BatchSettlementPaymentRequirementsExtra, m as BatchSettlementPaymentResponseExtra, c as BatchSettlementRefundPayload, j as BatchSettlementSettlePayload, h as BatchSettlementVoucherClaim, d as BatchSettlementVoucherFields, b as BatchSettlementVoucherPayload, C as ChannelConfig, a as ChannelState, q as isBatchSettlementClaimPayload, n as isBatchSettlementDepositPayload, s as isBatchSettlementEnrichedRefundPayload, p as isBatchSettlementRefundPayload, r as isBatchSettlementSettlePayload, o as isBatchSettlementVoucherPayload } from './types-CF8P2-NM.mjs';
+import { Network } from '@payai/x402/types';
+import './rpc-DULZzRne.mjs';
+import 'viem';
+import './storage-6W5MO46W.mjs';
 
 /**
  * Asset transfer methods for the exact EVM scheme.
@@ -99,14 +104,115 @@ type UptoPermit2Payload = {
         from: `0x${string}`;
     };
 };
+
 /**
  * Type guard to check if a payload is an upto Permit2 payload.
  * Validates structural presence of all required fields: signature, permit2Authorization
  * (with from, permitted, spender, nonce, deadline), and a witness containing facilitator.
  *
- * @param payload - The payload to check
- * @returns True if the payload is an upto Permit2 payload, false otherwise
+ * @param payload - The payload to check.
+ * @returns True if the payload is an upto Permit2 payload, false otherwise.
  */
 declare function isUptoPermit2Payload(payload: Record<string, unknown>): payload is UptoPermit2Payload;
 
-export { type AssetTransferMethod, type ExactEIP3009Payload, type ExactEvmPayloadV1, type ExactEvmPayloadV2, type ExactPermit2Payload, type Permit2Authorization, type Permit2Witness, type UptoPermit2Authorization, type UptoPermit2Payload, type UptoPermit2Witness, isEIP3009Payload, isPermit2Payload, isUptoPermit2Payload };
+/** Scheme identifier for the batch-settlement payment scheme. */
+declare const BATCH_SETTLEMENT_SCHEME: "batch-settlement";
+/** Deployed address of the x402BatchSettlement contract. */
+declare const BATCH_SETTLEMENT_ADDRESS: "0x4020074e9dF2ce1deE5A9C1b5c3f541D02a10003";
+/** Deployed address of the ERC3009DepositCollector contract. */
+declare const ERC3009_DEPOSIT_COLLECTOR_ADDRESS: "0x4020806089470a89826cB9fB1f4059150b550004";
+/** EIP-712 domain fields shared across all batch-settlement typed-data signatures. */
+declare const BATCH_SETTLEMENT_DOMAIN: {
+    readonly name: "x402 Batch Settlement";
+    readonly version: "1";
+};
+/** EIP-712 type definition for a cumulative voucher: `Voucher(bytes32 channelId, uint128 maxClaimableAmount)`. */
+declare const voucherTypes: {
+    readonly Voucher: readonly [{
+        readonly name: "channelId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "maxClaimableAmount";
+        readonly type: "uint128";
+    }];
+};
+/** EIP-712 type definition for cooperative refund: `Refund(bytes32 channelId, uint256 nonce, uint128 amount)`. */
+declare const refundTypes: {
+    readonly Refund: readonly [{
+        readonly name: "channelId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint128";
+    }];
+};
+/** EIP-712 type definitions for a receiver-authorizer claim batch (nested ClaimEntry). */
+declare const claimBatchTypes: {
+    readonly ClaimBatch: readonly [{
+        readonly name: "claims";
+        readonly type: "ClaimEntry[]";
+    }];
+    readonly ClaimEntry: readonly [{
+        readonly name: "channelId";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "maxClaimableAmount";
+        readonly type: "uint128";
+    }, {
+        readonly name: "totalClaimed";
+        readonly type: "uint128";
+    }];
+};
+
+/**
+ * Base stablecoin asset configuration shared across all EVM payment schemes.
+ * Contains the core fields needed to identify and convert tokens.
+ */
+type DefaultAssetInfo = {
+    /** Token contract address */
+    address: string;
+    /** EIP-712 domain name (must match the token's domain separator) */
+    name: string;
+    /** EIP-712 domain version (must match the token's domain separator) */
+    version: string;
+    /** Token decimal places (typically 6 for USDC) */
+    decimals: number;
+};
+/**
+ * Extended asset configuration for the exact scheme.
+ * Includes transfer method hints that control client-side behaviour.
+ */
+type ExactDefaultAssetInfo = DefaultAssetInfo & {
+    /**
+     * Transfer method override: `"permit2"` for tokens that don't support EIP-3009.
+     * Omit for EIP-3009 tokens (default behaviour).
+     */
+    assetTransferMethod?: string;
+    /**
+     * Set to `true` for permit2 tokens that implement EIP-2612 `permit()`.
+     * Controls whether name/version are included in `extra` so the client can
+     * sign a gasless EIP-2612 permit for Permit2 approval.
+     */
+    supportsEip2612?: boolean;
+};
+/**
+ * Default stablecoins indexed by CAIP-2 network identifier.
+ *
+ * Each network has the right to determine its own default stablecoin that can
+ * be expressed as a USD string by calling servers. See DEFAULT_ASSET.md in
+ * exact/server/ for how to add new chains.
+ */
+declare const DEFAULT_STABLECOINS: Record<string, ExactDefaultAssetInfo>;
+/**
+ * Look up the default stablecoin for a network.
+ *
+ * @param network - CAIP-2 network identifier (e.g. "eip155:8453")
+ * @returns The default asset info
+ * @throws If no default asset is configured for the network
+ */
+declare function getDefaultAsset(network: Network): ExactDefaultAssetInfo;
+
+export { type AssetTransferMethod, BATCH_SETTLEMENT_ADDRESS, BATCH_SETTLEMENT_DOMAIN, BATCH_SETTLEMENT_SCHEME, DEFAULT_STABLECOINS, type DefaultAssetInfo, ERC3009_DEPOSIT_COLLECTOR_ADDRESS, type ExactDefaultAssetInfo, type ExactEIP3009Payload, type ExactEvmPayloadV1, type ExactEvmPayloadV2, type ExactPermit2Payload, type Permit2Authorization, type Permit2Witness, type UptoPermit2Authorization, type UptoPermit2Payload, type UptoPermit2Witness, claimBatchTypes, getDefaultAsset, isEIP3009Payload, isPermit2Payload, isUptoPermit2Payload, refundTypes, voucherTypes };

package/dist/esm/index.mjs

@@ -1,20 +1,48 @@
+import {
+  BatchSettlementEvmScheme
+} from "./chunk-NKYVYGRA.mjs";
+import "./chunk-W6ON4LG2.mjs";
+import {
+  BATCH_SETTLEMENT_ADDRESS,
+  BATCH_SETTLEMENT_DOMAIN,
+  BATCH_SETTLEMENT_SCHEME,
+  ERC3009_DEPOSIT_COLLECTOR_ADDRESS,
+  claimBatchTypes,
+  refundTypes,
+  voucherTypes
+} from "./chunk-HYABYUBD.mjs";
 import {
   ExactEvmScheme
-} from "./chunk-D6RXZXOS.mjs";
+} from "./chunk-R7I3RZFF.mjs";
+import {
+  DEFAULT_STABLECOINS,
+  getDefaultAsset
+} from "./chunk-BTYNCDNS.mjs";
 import {
   isEIP3009Payload,
   isPermit2Payload,
   isUptoPermit2Payload
-} from "./chunk-JII456TS.mjs";
-import "./chunk-RYT6M3PA.mjs";
+} from "./chunk-JK7SLLF7.mjs";
+import {
+  isBatchSettlementClaimPayload,
+  isBatchSettlementDepositPayload,
+  isBatchSettlementEnrichedRefundPayload,
+  isBatchSettlementRefundPayload,
+  isBatchSettlementSettlePayload,
+  isBatchSettlementVoucherPayload
+} from "./chunk-U4HCGTLU.mjs";
+import "./chunk-CSQS7ZON.mjs";
 import {
   UptoEvmScheme
-} from "./chunk-GJ57SZGI.mjs";
+} from "./chunk-6WQOGWBE.mjs";
 import {
   createPermit2ApprovalTx,
   getPermit2AllowanceReadParams
-} from "./chunk-WKBC5YMI.mjs";
-import "./chunk-CRT6YNY5.mjs";
+} from "./chunk-53USC5VE.mjs";
+import "./chunk-YMQCTKDU.mjs";
+import "./chunk-RWLVVO3B.mjs";
+import "./chunk-GD4MKCN7.mjs";
+import "./chunk-TGFAVNUD.mjs";
 import {
   PERMIT2_ADDRESS,
   authorizationTypes,
@@ -26,7 +54,9 @@ import {
   x402ExactPermit2ProxyAddress,
   x402UptoPermit2ProxyABI,
   x402UptoPermit2ProxyAddress
-} from "./chunk-C4ZQMS77.mjs";
+} from "./chunk-MACPBXCT.mjs";
+import "./chunk-VS3RYAYE.mjs";
+import "./chunk-TW7Z65AO.mjs";
 
 // src/signer.ts
 function toClientEvmSigner(signer, publicClient) {
@@ -59,21 +89,37 @@ function toFacilitatorEvmSigner(client) {
   };
 }
 export {
+  BATCH_SETTLEMENT_ADDRESS,
+  BATCH_SETTLEMENT_DOMAIN,
+  BATCH_SETTLEMENT_SCHEME,
+  BatchSettlementEvmScheme,
+  DEFAULT_STABLECOINS,
+  ERC3009_DEPOSIT_COLLECTOR_ADDRESS,
   ExactEvmScheme,
   PERMIT2_ADDRESS,
   UptoEvmScheme,
   authorizationTypes,
+  claimBatchTypes,
   createPermit2ApprovalTx,
   eip3009ABI,
   erc20AllowanceAbi,
+  getDefaultAsset,
   getPermit2AllowanceReadParams,
+  isBatchSettlementClaimPayload,
+  isBatchSettlementDepositPayload,
+  isBatchSettlementEnrichedRefundPayload,
+  isBatchSettlementRefundPayload,
+  isBatchSettlementSettlePayload,
+  isBatchSettlementVoucherPayload,
   isEIP3009Payload,
   isPermit2Payload,
   isUptoPermit2Payload,
   permit2WitnessTypes,
+  refundTypes,
   toClientEvmSigner,
   toFacilitatorEvmSigner,
   uptoPermit2WitnessTypes,
+  voucherTypes,
   x402ExactPermit2ProxyABI,
   x402ExactPermit2ProxyAddress,
   x402UptoPermit2ProxyABI,

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/signer.ts"],"sourcesContent":["/**\n * ClientEvmSigner - Used by x402 clients to sign payment authorizations.\n *\n * Typically a viem WalletClient extended with publicActions:\n * ```typescript\n * const client = createWalletClient({\n *   account: privateKeyToAccount('0x...'),\n *   chain: baseSepolia,\n *   transport: http(),\n * }).extend(publicActions);\n * ```\n *\n * Or composed via `toClientEvmSigner(account, publicClient)`.\n */\nexport type ClientEvmSigner = {\n  readonly address: `0x${string}`;\n  signTypedData(message: {\n    domain: Record<string, unknown>;\n    types: Record<string, unknown>;\n    primaryType: string;\n    message: Record<string, unknown>;\n  }): Promise<`0x${string}`>;\n  /**\n   * Optional on-chain reads.\n   * Required only for extension enrichment (EIP-2612 / ERC-20 approval).\n   */\n  readContract?(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args?: readonly unknown[];\n  }): Promise<unknown>;\n  /**\n   * Optional: Signs a raw EIP-1559 transaction without broadcasting.\n   * Required for ERC-20 approval gas sponsoring when the token lacks EIP-2612.\n   */\n  signTransaction?(args: {\n    to: `0x${string}`;\n    data: `0x${string}`;\n    nonce: number;\n    gas: bigint;\n    maxFeePerGas: bigint;\n    maxPriorityFeePerGas: bigint;\n    chainId: number;\n  }): Promise<`0x${string}`>;\n  /**\n   * Optional: Gets the current transaction count (nonce) for an address.\n   * Required for ERC-20 approval gas sponsoring.\n   */\n  getTransactionCount?(args: { address: `0x${string}` }): Promise<number>;\n  /**\n   * Optional: Estimates current gas fees per gas.\n   * Required for ERC-20 approval gas sponsoring.\n   */\n  estimateFeesPerGas?(): Promise<{ maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }>;\n};\n\n/**\n * FacilitatorEvmSigner - Used by x402 facilitators to verify and settle payments\n * This is typically a viem PublicClient + WalletClient combination that can\n * read contract state, verify signatures, write transactions, and wait for receipts\n *\n * Supports multiple addresses for load balancing, key rotation, and high availability\n */\nexport type FacilitatorEvmSigner = {\n  /**\n   * Get all addresses this facilitator can use for signing\n   * Enables dynamic address selection for load balancing and key rotation\n   */\n  getAddresses(): readonly `0x${string}`[];\n\n  readContract(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args?: readonly unknown[];\n  }): Promise<unknown>;\n  verifyTypedData(args: {\n    address: `0x${string}`;\n    domain: Record<string, unknown>;\n    types: Record<string, unknown>;\n    primaryType: string;\n    message: Record<string, unknown>;\n    signature: `0x${string}`;\n  }): Promise<boolean>;\n  writeContract(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args: readonly unknown[];\n    /** Optional gas limit. When provided, skips eth_estimateGas simulation. */\n    gas?: bigint;\n  }): Promise<`0x${string}`>;\n  sendTransaction(args: { to: `0x${string}`; data: `0x${string}` }): Promise<`0x${string}`>;\n  waitForTransactionReceipt(args: { hash: `0x${string}` }): Promise<{ status: string }>;\n  getCode(args: { address: `0x${string}` }): Promise<`0x${string}` | undefined>;\n};\n\n/**\n * Composes a ClientEvmSigner from a local account and a public client.\n *\n * Use this when your signer (e.g., `privateKeyToAccount`) doesn't have\n * `readContract`. The `publicClient` provides the on-chain read capability.\n *\n * Alternatively, use a WalletClient extended with publicActions directly:\n * ```typescript\n * const signer = createWalletClient({\n *   account: privateKeyToAccount('0x...'),\n *   chain: baseSepolia,\n *   transport: http(),\n * }).extend(publicActions);\n * ```\n *\n * @param signer - A signer with `address` and `signTypedData` (and optionally `readContract`)\n * @param publicClient - A client with optional read/nonce/fee helpers\n * @param publicClient.readContract - The readContract method from the public client\n * @param publicClient.getTransactionCount - Optional getTransactionCount for ERC-20 approval\n * @param publicClient.estimateFeesPerGas - Optional estimateFeesPerGas for ERC-20 approval\n * @returns A ClientEvmSigner with any available optional capabilities\n *\n * @example\n * ```typescript\n * const account = privateKeyToAccount(\"0x...\");\n * const publicClient = createPublicClient({ chain: baseSepolia, transport: http() });\n * const signer = toClientEvmSigner(account, publicClient);\n * ```\n */\nexport function toClientEvmSigner(\n  signer: Omit<ClientEvmSigner, \"readContract\"> & {\n    readContract?: ClientEvmSigner[\"readContract\"];\n  },\n  publicClient?: {\n    readContract(args: {\n      address: `0x${string}`;\n      abi: readonly unknown[];\n      functionName: string;\n      args?: readonly unknown[];\n    }): Promise<unknown>;\n    getTransactionCount?(args: { address: `0x${string}` }): Promise<number>;\n    estimateFeesPerGas?(): Promise<{ maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }>;\n  },\n): ClientEvmSigner {\n  const readContract = signer.readContract ?? publicClient?.readContract.bind(publicClient);\n\n  const result: ClientEvmSigner = {\n    address: signer.address,\n    signTypedData: msg => signer.signTypedData(msg),\n  };\n\n  if (readContract) {\n    result.readContract = readContract;\n  }\n\n  // Forward optional capabilities from signer or publicClient\n  const signTransaction = signer.signTransaction;\n  if (signTransaction) {\n    result.signTransaction = args => signTransaction(args);\n  }\n\n  const getTransactionCount =\n    signer.getTransactionCount ?? publicClient?.getTransactionCount?.bind(publicClient);\n  if (getTransactionCount) {\n    result.getTransactionCount = args => getTransactionCount(args);\n  }\n\n  const estimateFeesPerGas =\n    signer.estimateFeesPerGas ?? publicClient?.estimateFeesPerGas?.bind(publicClient);\n  if (estimateFeesPerGas) {\n    result.estimateFeesPerGas = () => estimateFeesPerGas();\n  }\n\n  return result;\n}\n\n/**\n * Converts a viem client with single address to a FacilitatorEvmSigner\n * Wraps the single address in a getAddresses() function for compatibility\n *\n * @param client - The client to convert (must have 'address' property)\n * @returns FacilitatorEvmSigner with getAddresses() support\n */\nexport function toFacilitatorEvmSigner(\n  client: Omit<FacilitatorEvmSigner, \"getAddresses\"> & { address: `0x${string}` },\n): FacilitatorEvmSigner {\n  return {\n    ...client,\n    getAddresses: () => [client.address],\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+HO,SAAS,kBACd,QAGA,cAUiB;AACjB,QAAM,eAAe,OAAO,gBAAgB,cAAc,aAAa,KAAK,YAAY;AAExF,QAAM,SAA0B;AAAA,IAC9B,SAAS,OAAO;AAAA,IAChB,eAAe,SAAO,OAAO,cAAc,GAAG;AAAA,EAChD;AAEA,MAAI,cAAc;AAChB,WAAO,eAAe;AAAA,EACxB;AAGA,QAAM,kBAAkB,OAAO;AAC/B,MAAI,iBAAiB;AACnB,WAAO,kBAAkB,UAAQ,gBAAgB,IAAI;AAAA,EACvD;AAEA,QAAM,sBACJ,OAAO,uBAAuB,cAAc,qBAAqB,KAAK,YAAY;AACpF,MAAI,qBAAqB;AACvB,WAAO,sBAAsB,UAAQ,oBAAoB,IAAI;AAAA,EAC/D;AAEA,QAAM,qBACJ,OAAO,sBAAsB,cAAc,oBAAoB,KAAK,YAAY;AAClF,MAAI,oBAAoB;AACtB,WAAO,qBAAqB,MAAM,mBAAmB;AAAA,EACvD;AAEA,SAAO;AACT;AASO,SAAS,uBACd,QACsB;AACtB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,cAAc,MAAM,CAAC,OAAO,OAAO;AAAA,EACrC;AACF;","names":[]}
+{"version":3,"sources":["../../src/signer.ts"],"sourcesContent":["import type { Log } from \"viem\";\n\n/**\n * ClientEvmSigner - Used by x402 clients to sign payment authorizations.\n *\n * Typically a viem WalletClient extended with publicActions:\n * ```typescript\n * const client = createWalletClient({\n *   account: privateKeyToAccount('0x...'),\n *   chain: baseSepolia,\n *   transport: http(),\n * }).extend(publicActions);\n * ```\n *\n * Or composed via `toClientEvmSigner(account, publicClient)`.\n */\nexport type ClientEvmSigner = {\n  readonly address: `0x${string}`;\n  signTypedData(message: {\n    domain: Record<string, unknown>;\n    types: Record<string, unknown>;\n    primaryType: string;\n    message: Record<string, unknown>;\n  }): Promise<`0x${string}`>;\n  /**\n   * Optional on-chain reads.\n   * Required only for extension enrichment (EIP-2612 / ERC-20 approval).\n   */\n  readContract?(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args?: readonly unknown[];\n  }): Promise<unknown>;\n  /**\n   * Optional: Signs a raw EIP-1559 transaction without broadcasting.\n   * Required for ERC-20 approval gas sponsoring when the token lacks EIP-2612.\n   */\n  signTransaction?(args: {\n    to: `0x${string}`;\n    data: `0x${string}`;\n    nonce: number;\n    gas: bigint;\n    maxFeePerGas: bigint;\n    maxPriorityFeePerGas: bigint;\n    chainId: number;\n  }): Promise<`0x${string}`>;\n  /**\n   * Optional: Gets the current transaction count (nonce) for an address.\n   * Required for ERC-20 approval gas sponsoring.\n   */\n  getTransactionCount?(args: { address: `0x${string}` }): Promise<number>;\n  /**\n   * Optional: Estimates current gas fees per gas.\n   * Required for ERC-20 approval gas sponsoring.\n   */\n  estimateFeesPerGas?(): Promise<{ maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }>;\n};\n\n/**\n * FacilitatorEvmSigner - Used by x402 facilitators to verify and settle payments\n * This is typically a viem PublicClient + WalletClient combination that can\n * read contract state, verify signatures, write transactions, and wait for receipts\n *\n * Supports multiple addresses for load balancing, key rotation, and high availability\n */\nexport type FacilitatorEvmSigner = {\n  /**\n   * Get all addresses this facilitator can use for signing\n   * Enables dynamic address selection for load balancing and key rotation\n   */\n  getAddresses(): readonly `0x${string}`[];\n\n  readContract(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args?: readonly unknown[];\n  }): Promise<unknown>;\n  verifyTypedData(args: {\n    address: `0x${string}`;\n    domain: Record<string, unknown>;\n    types: Record<string, unknown>;\n    primaryType: string;\n    message: Record<string, unknown>;\n    signature: `0x${string}`;\n  }): Promise<boolean>;\n  writeContract(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args: readonly unknown[];\n    /** Optional gas limit. When provided, skips eth_estimateGas simulation. */\n    gas?: bigint;\n  }): Promise<`0x${string}`>;\n  sendTransaction(args: { to: `0x${string}`; data: `0x${string}` }): Promise<`0x${string}`>;\n  waitForTransactionReceipt(args: { hash: `0x${string}` }): Promise<{\n    status: string;\n    logs?: readonly Log[];\n  }>;\n  getCode(args: { address: `0x${string}` }): Promise<`0x${string}` | undefined>;\n};\n\n/**\n * Composes a ClientEvmSigner from a local account and a public client.\n *\n * Use this when your signer (e.g., `privateKeyToAccount`) doesn't have\n * `readContract`. The `publicClient` provides the on-chain read capability.\n *\n * Alternatively, use a WalletClient extended with publicActions directly:\n * ```typescript\n * const signer = createWalletClient({\n *   account: privateKeyToAccount('0x...'),\n *   chain: baseSepolia,\n *   transport: http(),\n * }).extend(publicActions);\n * ```\n *\n * @param signer - A signer with `address` and `signTypedData` (and optionally `readContract`)\n * @param publicClient - A client with optional read/nonce/fee helpers\n * @param publicClient.readContract - The readContract method from the public client\n * @param publicClient.getTransactionCount - Optional getTransactionCount for ERC-20 approval\n * @param publicClient.estimateFeesPerGas - Optional estimateFeesPerGas for ERC-20 approval\n * @returns A ClientEvmSigner with any available optional capabilities\n *\n * @example\n * ```typescript\n * const account = privateKeyToAccount(\"0x...\");\n * const publicClient = createPublicClient({ chain: baseSepolia, transport: http() });\n * const signer = toClientEvmSigner(account, publicClient);\n * ```\n */\nexport function toClientEvmSigner(\n  signer: Omit<ClientEvmSigner, \"readContract\"> & {\n    readContract?: ClientEvmSigner[\"readContract\"];\n  },\n  publicClient?: {\n    readContract(args: {\n      address: `0x${string}`;\n      abi: readonly unknown[];\n      functionName: string;\n      args?: readonly unknown[];\n    }): Promise<unknown>;\n    getTransactionCount?(args: { address: `0x${string}` }): Promise<number>;\n    estimateFeesPerGas?(): Promise<{ maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }>;\n  },\n): ClientEvmSigner {\n  const readContract = signer.readContract ?? publicClient?.readContract.bind(publicClient);\n\n  const result: ClientEvmSigner = {\n    address: signer.address,\n    signTypedData: msg => signer.signTypedData(msg),\n  };\n\n  if (readContract) {\n    result.readContract = readContract;\n  }\n\n  // Forward optional capabilities from signer or publicClient\n  const signTransaction = signer.signTransaction;\n  if (signTransaction) {\n    result.signTransaction = args => signTransaction(args);\n  }\n\n  const getTransactionCount =\n    signer.getTransactionCount ?? publicClient?.getTransactionCount?.bind(publicClient);\n  if (getTransactionCount) {\n    result.getTransactionCount = args => getTransactionCount(args);\n  }\n\n  const estimateFeesPerGas =\n    signer.estimateFeesPerGas ?? publicClient?.estimateFeesPerGas?.bind(publicClient);\n  if (estimateFeesPerGas) {\n    result.estimateFeesPerGas = () => estimateFeesPerGas();\n  }\n\n  return result;\n}\n\n/**\n * Converts a viem client with single address to a FacilitatorEvmSigner\n * Wraps the single address in a getAddresses() function for compatibility\n *\n * @param client - The client to convert (must have 'address' property)\n * @returns FacilitatorEvmSigner with getAddresses() support\n */\nexport function toFacilitatorEvmSigner(\n  client: Omit<FacilitatorEvmSigner, \"getAddresses\"> & { address: `0x${string}` },\n): FacilitatorEvmSigner {\n  return {\n    ...client,\n    getAddresses: () => [client.address],\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoIO,SAAS,kBACd,QAGA,cAUiB;AACjB,QAAM,eAAe,OAAO,gBAAgB,cAAc,aAAa,KAAK,YAAY;AAExF,QAAM,SAA0B;AAAA,IAC9B,SAAS,OAAO;AAAA,IAChB,eAAe,SAAO,OAAO,cAAc,GAAG;AAAA,EAChD;AAEA,MAAI,cAAc;AAChB,WAAO,eAAe;AAAA,EACxB;AAGA,QAAM,kBAAkB,OAAO;AAC/B,MAAI,iBAAiB;AACnB,WAAO,kBAAkB,UAAQ,gBAAgB,IAAI;AAAA,EACvD;AAEA,QAAM,sBACJ,OAAO,uBAAuB,cAAc,qBAAqB,KAAK,YAAY;AACpF,MAAI,qBAAqB;AACvB,WAAO,sBAAsB,UAAQ,oBAAoB,IAAI;AAAA,EAC/D;AAEA,QAAM,qBACJ,OAAO,sBAAsB,cAAc,oBAAoB,KAAK,YAAY;AAClF,MAAI,oBAAoB;AACtB,WAAO,qBAAqB,MAAM,mBAAmB;AAAA,EACvD;AAEA,SAAO;AACT;AASO,SAAS,uBACd,QACsB;AACtB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,cAAc,MAAM,CAAC,OAAO,OAAO;AAAA,EACrC;AACF;","names":[]}