@circle-fin/usdckit 0.21.0 → 0.22.0

package/dist/cjs/utils/createCustomWalletClient.test.js

@@ -0,0 +1,100 @@
+"use strict";
+// Copyright (c) 2025, Circle Internet Group, Inc.
+// All rights reserved.
+//
+// Circle Internet Group, Inc. CONFIDENTIAL
+//
+// This file includes unpublished proprietary source code of Circle Internet
+// Group, Inc. The copyright notice above does not
+// evidence any actual or intended publication of such source code. Disclosure
+// of this source code or any related proprietary information is strictly
+// prohibited without the express written permission of Circle Internet Group, Inc.
+Object.defineProperty(exports, "__esModule", { value: true });
+const viem_1 = require("viem");
+const vitest_1 = require("vitest");
+const index_js_1 = require("../chains/index.js");
+const createCustomWalletClient_js_1 = require("./createCustomWalletClient.js");
+(0, vitest_1.describe)('createCustomWalletClient', () => {
+    (0, vitest_1.it)('should create successfully with basic configuration', () => {
+        const client = (0, createCustomWalletClient_js_1.createCustomWalletClient)({
+            customTransportFactory: ({ chainId }) => (0, viem_1.http)(`https://rpc-${chainId}.example.com`),
+        });
+        (0, vitest_1.expect)(client).toBeDefined();
+        (0, vitest_1.expect)(client.config).toBeDefined();
+        (0, vitest_1.expect)(client.chain).toBe(index_js_1.ETH_SEPOLIA); // Default chain
+    });
+    (0, vitest_1.it)('should create successfully with specified default chain', () => {
+        const client = (0, createCustomWalletClient_js_1.createCustomWalletClient)({
+            defaultChain: index_js_1.MATIC_AMOY,
+            customTransportFactory: ({ chainId }) => (0, viem_1.http)(`https://rpc-${chainId}.example.com`),
+        });
+        (0, vitest_1.expect)(client).toBeDefined();
+        (0, vitest_1.expect)(client.config).toBeDefined();
+        (0, vitest_1.expect)(client.chain).toBe(index_js_1.MATIC_AMOY);
+    });
+    (0, vitest_1.it)('should create successfully with custom chains', () => {
+        const customChains = [index_js_1.ETH_SEPOLIA, index_js_1.MATIC_AMOY];
+        const client = (0, createCustomWalletClient_js_1.createCustomWalletClient)({
+            chains: customChains,
+            customTransportFactory: ({ chainId }) => (0, viem_1.http)(`https://rpc-${chainId}.example.com`),
+        });
+        (0, vitest_1.expect)(client).toBeDefined();
+        (0, vitest_1.expect)(client.config).toBeDefined();
+        (0, vitest_1.expect)(client.chain).toBe(index_js_1.ETH_SEPOLIA); // Default chain
+    });
+    (0, vitest_1.it)('should handle Fireblocks configuration using closures', () => {
+        // Configuration is now handled in the closure
+        const config = {
+            apiKey: 'fireblocks-api-key',
+            privateKey: 'fireblocks-private-key',
+            vaultAccountIds: 'fireblocks-vault-ids',
+        };
+        const client = (0, createCustomWalletClient_js_1.createCustomWalletClient)({
+            customTransportFactory: ({ chainId }) => (0, viem_1.http)(`https://fireblocks-${chainId}.example.com?apiKey=${config.apiKey}`),
+        });
+        (0, vitest_1.expect)(client).toBeDefined();
+        (0, vitest_1.expect)(client.config).toBeDefined();
+        (0, vitest_1.expect)(client.chain).toBe(index_js_1.ETH_SEPOLIA);
+    });
+    (0, vitest_1.it)('should have required client properties and methods', () => {
+        const client = (0, createCustomWalletClient_js_1.createCustomWalletClient)({
+            customTransportFactory: ({ chainId }) => (0, viem_1.http)(`https://rpc-${chainId}.example.com`),
+        });
+        // Check that the client has the expected properties
+        (0, vitest_1.expect)(client.chain).toBeDefined();
+        (0, vitest_1.expect)(client.config).toBeDefined();
+        // Check that common viem methods exist
+        (0, vitest_1.expect)(typeof client.getBlock).toBe('function');
+        (0, vitest_1.expect)(typeof client.getBalance).toBe('function');
+        (0, vitest_1.expect)(typeof client.sendTransaction).toBe('function');
+    });
+    (0, vitest_1.it)('should automatically include defaultChain in chains when not present', () => {
+        const client = (0, createCustomWalletClient_js_1.createCustomWalletClient)({
+            defaultChain: index_js_1.ETH_SEPOLIA,
+            chains: [index_js_1.MATIC_AMOY], // ETH_SEPOLIA not included - should be added automatically
+            customTransportFactory: ({ chainId }) => (0, viem_1.http)(`https://rpc-${chainId}.example.com`),
+        });
+        (0, vitest_1.expect)(client).toBeDefined();
+        (0, vitest_1.expect)(client.config).toBeDefined();
+        (0, vitest_1.expect)(client.chain).toBe(index_js_1.ETH_SEPOLIA); // Should be the default chain
+        const configChains = client.config.chains;
+        (0, vitest_1.expect)(configChains).toContainEqual(index_js_1.ETH_SEPOLIA);
+        (0, vitest_1.expect)(configChains).toContainEqual(index_js_1.MATIC_AMOY);
+        (0, vitest_1.expect)(configChains).toHaveLength(2);
+    });
+    (0, vitest_1.it)('should not duplicate defaultChain when it is already in chains', () => {
+        const client = (0, createCustomWalletClient_js_1.createCustomWalletClient)({
+            defaultChain: index_js_1.ETH_SEPOLIA,
+            chains: [index_js_1.ETH_SEPOLIA, index_js_1.MATIC_AMOY], // ETH_SEPOLIA already included
+            customTransportFactory: ({ chainId }) => (0, viem_1.http)(`https://rpc-${chainId}.example.com`),
+        });
+        (0, vitest_1.expect)(client).toBeDefined();
+        (0, vitest_1.expect)(client.config).toBeDefined();
+        (0, vitest_1.expect)(client.chain).toBe(index_js_1.ETH_SEPOLIA);
+        // Verify that ETH_SEPOLIA is not duplicated
+        const configChains = client.config.chains;
+        (0, vitest_1.expect)(configChains).toContainEqual(index_js_1.ETH_SEPOLIA);
+        (0, vitest_1.expect)(configChains).toContainEqual(index_js_1.MATIC_AMOY);
+        (0, vitest_1.expect)(configChains).toHaveLength(2); // Should still be only 2 chains, not 3
+    });
+});

package/dist/cjs/utils/getChainContractByAddress.d.ts

@@ -1,4 +1,5 @@
-import type { Address, Chain, ChainContract } from '../types.js';
+import type { Chain } from '../chains.js';
+import type { Address, ChainContract } from '../types.js';
 /**
  * Retrieves the contract associated with a given address from the specified chain.
  *

package/dist/cjs/utils/getClient.d.ts

@@ -0,0 +1,458 @@
+import type { Config } from '@wagmi/core';
+import type { Chain, Client } from 'viem';
+export declare function getClient(client: Client & {
+    config?: Config;
+}, chain: Chain): {
+    account: import("viem").Account | undefined;
+    batch?: import("viem").ClientConfig["batch"] | undefined;
+    cacheTime: number;
+    ccipRead?: import("viem").ClientConfig["ccipRead"] | undefined;
+    chain: Chain | undefined;
+    experimental_blockTag?: import("viem").BlockTag | undefined;
+    key: string;
+    name: string;
+    pollingInterval: number;
+    request: import("viem").EIP1193RequestFn<[{
+        Method: "web3_clientVersion";
+        Parameters?: undefined;
+        ReturnType: string;
+    }, {
+        Method: "web3_sha3";
+        Parameters: [data: import("viem").Hash];
+        ReturnType: string;
+    }, {
+        Method: "net_listening";
+        Parameters?: undefined;
+        ReturnType: boolean;
+    }, {
+        Method: "net_peerCount";
+        Parameters?: undefined;
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "net_version";
+        Parameters?: undefined;
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_blobBaseFee";
+        Parameters?: undefined;
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_blockNumber";
+        Parameters?: undefined;
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_call";
+        Parameters: readonly [transaction: import("viem").ExactPartial<import("viem").RpcTransactionRequest>] | readonly [transaction: import("viem").ExactPartial<import("viem").RpcTransactionRequest>, block: import("viem").RpcBlockNumber | import("viem").BlockTag | import("viem").RpcBlockIdentifier] | readonly [transaction: import("viem").ExactPartial<import("viem").RpcTransactionRequest>, block: import("viem").RpcBlockNumber | import("viem").BlockTag | import("viem").RpcBlockIdentifier, stateOverrideSet: import("viem").RpcStateOverride] | readonly [transaction: import("viem").ExactPartial<import("viem").RpcTransactionRequest>, block: import("viem").RpcBlockNumber | import("viem").BlockTag | import("viem").RpcBlockIdentifier, stateOverrideSet: import("viem").RpcStateOverride, blockOverrides: import("viem").RpcBlockOverrides];
+        ReturnType: import("viem").Hex;
+    }, {
+        Method: "eth_createAccessList";
+        Parameters: [transaction: import("viem").ExactPartial<import("viem").RpcTransactionRequest>] | [transaction: import("viem").ExactPartial<import("viem").RpcTransactionRequest>, block: import("viem").RpcBlockNumber | import("viem").BlockTag | import("viem").RpcBlockIdentifier];
+        ReturnType: {
+            accessList: import("viem").AccessList;
+            gasUsed: import("viem").Quantity;
+        };
+    }, {
+        Method: "eth_chainId";
+        Parameters?: undefined;
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_coinbase";
+        Parameters?: undefined;
+        ReturnType: import("viem").Address;
+    }, {
+        Method: "eth_estimateGas";
+        Parameters: [transaction: import("viem").RpcTransactionRequest] | [transaction: import("viem").RpcTransactionRequest, block: import("viem").RpcBlockNumber | import("viem").BlockTag] | [transaction: import("viem").RpcTransactionRequest, block: import("viem").RpcBlockNumber | import("viem").BlockTag, stateOverride: import("viem").RpcStateOverride];
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_feeHistory";
+        Parameters: [blockCount: import("viem").Quantity, newestBlock: import("viem").RpcBlockNumber | import("viem").BlockTag, rewardPercentiles: number[] | undefined];
+        ReturnType: import("viem").RpcFeeHistory;
+    }, {
+        Method: "eth_gasPrice";
+        Parameters?: undefined;
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_getBalance";
+        Parameters: [address: import("viem").Address, block: import("viem").RpcBlockNumber | import("viem").BlockTag | import("viem").RpcBlockIdentifier];
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_getBlockByHash";
+        Parameters: [hash: import("viem").Hash, includeTransactionObjects: boolean];
+        ReturnType: import("viem").RpcBlock | null;
+    }, {
+        Method: "eth_getBlockByNumber";
+        Parameters: [block: import("viem").RpcBlockNumber | import("viem").BlockTag, includeTransactionObjects: boolean];
+        ReturnType: import("viem").RpcBlock | null;
+    }, {
+        Method: "eth_getBlockTransactionCountByHash";
+        Parameters: [hash: import("viem").Hash];
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_getBlockTransactionCountByNumber";
+        Parameters: [block: import("viem").RpcBlockNumber | import("viem").BlockTag];
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_getCode";
+        Parameters: [address: import("viem").Address, block: import("viem").RpcBlockNumber | import("viem").BlockTag | import("viem").RpcBlockIdentifier];
+        ReturnType: import("viem").Hex;
+    }, {
+        Method: "eth_getFilterChanges";
+        Parameters: [filterId: import("viem").Quantity];
+        ReturnType: import("viem").RpcLog[] | import("viem").Hex[];
+    }, {
+        Method: "eth_getFilterLogs";
+        Parameters: [filterId: import("viem").Quantity];
+        ReturnType: import("viem").RpcLog[];
+    }, {
+        Method: "eth_getLogs";
+        Parameters: [{
+            address?: import("viem").Address | import("viem").Address[] | undefined;
+            topics?: import("viem").LogTopic[] | undefined;
+        } & ({
+            fromBlock?: import("viem").RpcBlockNumber | import("viem").BlockTag | undefined;
+            toBlock?: import("viem").RpcBlockNumber | import("viem").BlockTag | undefined;
+            blockHash?: undefined;
+        } | {
+            fromBlock?: undefined;
+            toBlock?: undefined;
+            blockHash?: import("viem").Hash | undefined;
+        })];
+        ReturnType: import("viem").RpcLog[];
+    }, {
+        Method: "eth_getProof";
+        Parameters: [address: import("viem").Address, storageKeys: import("viem").Hash[], block: import("viem").RpcBlockNumber | import("viem").BlockTag];
+        ReturnType: import("viem").RpcProof;
+    }, {
+        Method: "eth_getStorageAt";
+        Parameters: [address: import("viem").Address, index: import("viem").Quantity, block: import("viem").RpcBlockNumber | import("viem").BlockTag | import("viem").RpcBlockIdentifier];
+        ReturnType: import("viem").Hex;
+    }, {
+        Method: "eth_getTransactionByBlockHashAndIndex";
+        Parameters: [hash: import("viem").Hash, index: import("viem").Quantity];
+        ReturnType: import("viem").RpcTransaction | null;
+    }, {
+        Method: "eth_getTransactionByBlockNumberAndIndex";
+        Parameters: [block: import("viem").RpcBlockNumber | import("viem").BlockTag, index: import("viem").Quantity];
+        ReturnType: import("viem").RpcTransaction | null;
+    }, {
+        Method: "eth_getTransactionByHash";
+        Parameters: [hash: import("viem").Hash];
+        ReturnType: import("viem").RpcTransaction | null;
+    }, {
+        Method: "eth_getTransactionCount";
+        Parameters: [address: import("viem").Address, block: import("viem").RpcBlockNumber | import("viem").BlockTag | import("viem").RpcBlockIdentifier];
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_getTransactionReceipt";
+        Parameters: [hash: import("viem").Hash];
+        ReturnType: import("viem").RpcTransactionReceipt | null;
+    }, {
+        Method: "eth_getUncleByBlockHashAndIndex";
+        Parameters: [hash: import("viem").Hash, index: import("viem").Quantity];
+        ReturnType: import("viem").RpcUncle | null;
+    }, {
+        Method: "eth_getUncleByBlockNumberAndIndex";
+        Parameters: [block: import("viem").RpcBlockNumber | import("viem").BlockTag, index: import("viem").Quantity];
+        ReturnType: import("viem").RpcUncle | null;
+    }, {
+        Method: "eth_getUncleCountByBlockHash";
+        Parameters: [hash: import("viem").Hash];
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_getUncleCountByBlockNumber";
+        Parameters: [block: import("viem").RpcBlockNumber | import("viem").BlockTag];
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_maxPriorityFeePerGas";
+        Parameters?: undefined;
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_newBlockFilter";
+        Parameters?: undefined;
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_newFilter";
+        Parameters: [filter: {
+            fromBlock?: import("viem").RpcBlockNumber | import("viem").BlockTag | undefined;
+            toBlock?: import("viem").RpcBlockNumber | import("viem").BlockTag | undefined;
+            address?: import("viem").Address | import("viem").Address[] | undefined;
+            topics?: import("viem").LogTopic[] | undefined;
+        }];
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_newPendingTransactionFilter";
+        Parameters?: undefined;
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_protocolVersion";
+        Parameters?: undefined;
+        ReturnType: string;
+    }, {
+        Method: "eth_sendRawTransaction";
+        Parameters: [signedTransaction: import("viem").Hex];
+        ReturnType: import("viem").Hash;
+    }, {
+        Method: "eth_simulateV1";
+        Parameters: [{
+            blockStateCalls: readonly {
+                blockOverrides?: import("viem").RpcBlockOverrides | undefined;
+                calls?: readonly import("viem").ExactPartial<import("viem").RpcTransactionRequest>[] | undefined;
+                stateOverrides?: import("viem").RpcStateOverride | undefined;
+            }[];
+            returnFullTransactions?: boolean | undefined;
+            traceTransfers?: boolean | undefined;
+            validation?: boolean | undefined;
+        }, import("viem").RpcBlockNumber | import("viem").BlockTag];
+        ReturnType: readonly (import("viem").RpcBlock & {
+            calls: readonly {
+                error?: {
+                    data?: import("viem").Hex | undefined;
+                    code: number;
+                    message: string;
+                } | undefined;
+                logs?: readonly import("viem").RpcLog[] | undefined;
+                gasUsed: import("viem").Hex;
+                returnData: import("viem").Hex;
+                status: import("viem").Hex;
+            }[];
+        })[];
+    }, {
+        Method: "eth_uninstallFilter";
+        Parameters: [filterId: import("viem").Quantity];
+        ReturnType: boolean;
+    }, {
+        Method: "eth_accounts";
+        Parameters?: undefined;
+        ReturnType: import("viem").Address[];
+    }, {
+        Method: "eth_chainId";
+        Parameters?: undefined;
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_estimateGas";
+        Parameters: [transaction: import("viem").RpcTransactionRequest] | [transaction: import("viem").RpcTransactionRequest, block: import("viem").RpcBlockNumber | import("viem").BlockTag] | [transaction: import("viem").RpcTransactionRequest, block: import("viem").RpcBlockNumber | import("viem").BlockTag, stateOverride: import("viem").RpcStateOverride];
+        ReturnType: import("viem").Quantity;
+    }, {
+        Method: "eth_requestAccounts";
+        Parameters?: undefined;
+        ReturnType: import("viem").Address[];
+    }, {
+        Method: "eth_sendTransaction";
+        Parameters: [transaction: import("viem").RpcTransactionRequest];
+        ReturnType: import("viem").Hash;
+    }, {
+        Method: "eth_sendRawTransaction";
+        Parameters: [signedTransaction: import("viem").Hex];
+        ReturnType: import("viem").Hash;
+    }, {
+        Method: "eth_sign";
+        Parameters: [address: import("viem").Address, data: import("viem").Hex];
+        ReturnType: import("viem").Hex;
+    }, {
+        Method: "eth_signTransaction";
+        Parameters: [request: import("viem").RpcTransactionRequest];
+        ReturnType: import("viem").Hex;
+    }, {
+        Method: "eth_signTypedData_v4";
+        Parameters: [address: import("viem").Address, message: string];
+        ReturnType: import("viem").Hex;
+    }, {
+        Method: "eth_syncing";
+        Parameters?: undefined;
+        ReturnType: import("viem").NetworkSync | false;
+    }, {
+        Method: "personal_sign";
+        Parameters: [data: import("viem").Hex, address: import("viem").Address];
+        ReturnType: import("viem").Hex;
+    }, {
+        Method: "wallet_addEthereumChain";
+        Parameters: [chain: import("viem").AddEthereumChainParameter];
+        ReturnType: null;
+    }, {
+        Method: "wallet_addSubAccount";
+        Parameters: [{
+            account: import("viem").OneOf<{
+                keys: readonly {
+                    publicKey: import("viem").Hex;
+                    type: "address" | "p256" | "webcrypto-p256" | "webauthn-p256";
+                }[];
+                type: "create";
+            } | {
+                address: import("viem").Address;
+                chainId?: number | undefined;
+                type: "deployed";
+            } | {
+                address: import("viem").Address;
+                chainId?: number | undefined;
+                factory: import("viem").Address;
+                factoryData: import("viem").Hex;
+                type: "undeployed";
+            }>;
+            version: string;
+        }];
+        ReturnType: {
+            address: import("viem").Address;
+            factory?: import("viem").Address | undefined;
+            factoryData?: import("viem").Hex | undefined;
+        };
+    }, {
+        Method: "wallet_connect";
+        Parameters: [{
+            capabilities?: import("viem").Capabilities | undefined;
+            version: string;
+        }];
+        ReturnType: {
+            accounts: readonly {
+                address: import("viem").Address;
+                capabilities?: import("viem").Capabilities | undefined;
+            }[];
+        };
+    }, {
+        Method: "wallet_disconnect";
+        Parameters?: undefined;
+        ReturnType: void;
+    }, {
+        Method: "wallet_getAssets";
+        Parameters?: [import("viem").WalletGetAssetsParameters];
+        ReturnType: import("viem").WalletGetAssetsReturnType;
+    }, {
+        Method: "wallet_getCallsStatus";
+        Parameters?: [string];
+        ReturnType: import("viem").WalletGetCallsStatusReturnType;
+    }, {
+        Method: "wallet_getCapabilities";
+        Parameters?: readonly [] | readonly [import("viem").Address | undefined] | readonly [import("viem").Address | undefined, readonly import("viem").Hex[] | undefined] | undefined;
+        ReturnType: import("viem").Prettify<import("viem").WalletCapabilitiesRecord>;
+    }, {
+        Method: "wallet_getPermissions";
+        Parameters?: undefined;
+        ReturnType: import("viem").WalletPermission[];
+    }, {
+        Method: "wallet_grantPermissions";
+        Parameters?: [import("viem").WalletGrantPermissionsParameters];
+        ReturnType: import("viem").Prettify<import("viem").WalletGrantPermissionsReturnType>;
+    }, {
+        Method: "wallet_requestPermissions";
+        Parameters: [permissions: {
+            eth_accounts: Record<string, any>;
+        }];
+        ReturnType: import("viem").WalletPermission[];
+    }, {
+        Method: "wallet_revokePermissions";
+        Parameters: [permissions: {
+            eth_accounts: Record<string, any>;
+        }];
+        ReturnType: null;
+    }, {
+        Method: "wallet_sendCalls";
+        Parameters?: import("viem").WalletSendCallsParameters;
+        ReturnType: import("viem").WalletSendCallsReturnType;
+    }, {
+        Method: "wallet_sendTransaction";
+        Parameters: [transaction: import("viem").RpcTransactionRequest];
+        ReturnType: import("viem").Hash;
+    }, {
+        Method: "wallet_showCallsStatus";
+        Parameters?: [string];
+        ReturnType: void;
+    }, {
+        Method: "wallet_switchEthereumChain";
+        Parameters: [chain: {
+            chainId: string;
+        }];
+        ReturnType: null;
+    }, {
+        Method: "wallet_watchAsset";
+        Parameters: import("viem").WatchAssetParams;
+        ReturnType: boolean;
+    }, {
+        Method: "eth_chainId";
+        Parameters?: undefined;
+        ReturnType: import("viem").Hex;
+    }, {
+        Method: "eth_estimateUserOperationGas";
+        Parameters: [userOperation: import("viem").RpcUserOperation, entrypoint: import("viem").Address] | [userOperation: import("viem").RpcUserOperation, entrypoint: import("viem").Address, stateOverrideSet: import("viem").RpcStateOverride];
+        ReturnType: import("viem").RpcEstimateUserOperationGasReturnType;
+    }, {
+        Method: "eth_getUserOperationByHash";
+        Parameters: [hash: import("viem").Hash];
+        ReturnType: import("viem").RpcGetUserOperationByHashReturnType | null;
+    }, {
+        Method: "eth_getUserOperationReceipt";
+        Parameters: [hash: import("viem").Hash];
+        ReturnType: import("viem").RpcUserOperationReceipt | null;
+    }, {
+        Method: "eth_sendUserOperation";
+        Parameters: [userOperation: import("viem").RpcUserOperation, entrypoint: import("viem").Address];
+        ReturnType: import("viem").Hash;
+    }, {
+        Method: "eth_supportedEntryPoints";
+        Parameters?: undefined;
+        ReturnType: readonly import("viem").Address[];
+    }, {
+        Method: "pm_getPaymasterStubData";
+        Parameters?: [userOperation: import("viem").OneOf<import("viem").PartialBy<Pick<import("viem").RpcUserOperation<"0.6">, "callData" | "callGasLimit" | "initCode" | "maxFeePerGas" | "maxPriorityFeePerGas" | "nonce" | "sender" | "preVerificationGas" | "verificationGasLimit">, "callGasLimit" | "initCode" | "maxFeePerGas" | "maxPriorityFeePerGas" | "preVerificationGas" | "verificationGasLimit"> | import("viem").PartialBy<Pick<import("viem").RpcUserOperation<"0.7">, "callData" | "callGasLimit" | "factory" | "factoryData" | "maxFeePerGas" | "maxPriorityFeePerGas" | "nonce" | "sender" | "preVerificationGas" | "verificationGasLimit">, "callGasLimit" | "factory" | "factoryData" | "maxFeePerGas" | "maxPriorityFeePerGas" | "preVerificationGas" | "verificationGasLimit">>, entrypoint: import("viem").Address, chainId: import("viem").Hex, context: unknown];
+        ReturnType: import("viem").OneOf<{
+            paymasterAndData: import("viem").Hex;
+        } | {
+            paymaster: import("viem").Address;
+            paymasterData: import("viem").Hex;
+            paymasterVerificationGasLimit: import("viem").Hex;
+            paymasterPostOpGasLimit: import("viem").Hex;
+        }> & {
+            sponsor?: {
+                name: string;
+                icon?: string | undefined;
+            } | undefined;
+            isFinal?: boolean | undefined;
+        };
+    }, {
+        Method: "pm_getPaymasterData";
+        Parameters?: [userOperation: Pick<import("viem").RpcUserOperation<"0.6">, "callData" | "callGasLimit" | "initCode" | "maxFeePerGas" | "maxPriorityFeePerGas" | "nonce" | "sender" | "preVerificationGas" | "verificationGasLimit"> | Pick<import("viem").RpcUserOperation<"0.7">, "callData" | "callGasLimit" | "factory" | "factoryData" | "maxFeePerGas" | "maxPriorityFeePerGas" | "nonce" | "sender" | "preVerificationGas" | "verificationGasLimit">, entrypoint: import("viem").Address, chainId: import("viem").Hex, context: unknown];
+        ReturnType: import("viem").OneOf<{
+            paymasterAndData: import("viem").Hex;
+        } | {
+            paymaster: import("viem").Address;
+            paymasterData: import("viem").Hex;
+            paymasterVerificationGasLimit: import("viem").Hex;
+            paymasterPostOpGasLimit: import("viem").Hex;
+        }>;
+    }]>;
+    transport: import("viem").TransportConfig<string, import("viem").EIP1193RequestFn> & Record<string, any>;
+    type: string;
+    uid: string;
+} & {
+    extend: <const client extends {
+        [x: string]: unknown;
+        account?: undefined;
+        batch?: undefined;
+        cacheTime?: undefined;
+        ccipRead?: undefined;
+        chain?: undefined;
+        experimental_blockTag?: undefined;
+        key?: undefined;
+        name?: undefined;
+        pollingInterval?: undefined;
+        request?: undefined;
+        transport?: undefined;
+        type?: undefined;
+        uid?: undefined;
+    } & import("viem").ExactPartial<Pick<import("viem").PublicActions<import("viem").Transport, Chain | undefined, import("viem").Account | undefined>, "call" | "createContractEventFilter" | "createEventFilter" | "estimateContractGas" | "estimateGas" | "getBlock" | "getBlockNumber" | "getChainId" | "getContractEvents" | "getEnsText" | "getFilterChanges" | "getGasPrice" | "getLogs" | "getTransaction" | "getTransactionCount" | "getTransactionReceipt" | "prepareTransactionRequest" | "readContract" | "sendRawTransaction" | "simulateContract" | "uninstallFilter" | "watchBlockNumber" | "watchContractEvent"> & Pick<import("viem").WalletActions<Chain | undefined, import("viem").Account | undefined>, "sendTransaction" | "writeContract">>>(fn: (client: Client<import("viem").Transport, Chain | undefined, import("viem").Account | undefined, undefined, {
+        [x: string]: unknown;
+        account?: undefined;
+        batch?: undefined;
+        cacheTime?: undefined;
+        ccipRead?: undefined;
+        chain?: undefined;
+        experimental_blockTag?: undefined;
+        key?: undefined;
+        name?: undefined;
+        pollingInterval?: undefined;
+        request?: undefined;
+        transport?: undefined;
+        type?: undefined;
+        uid?: undefined;
+    } | undefined>) => client) => Client<import("viem").Transport, Chain | undefined, import("viem").Account | undefined, undefined, { [K in keyof client]: client[K]; }>;
+} & {
+    config?: Config;
+};

package/dist/cjs/utils/getClient.js

@@ -0,0 +1,25 @@
+"use strict";
+// Copyright (c) 2025, Circle Internet Group, Inc.
+// All rights reserved.
+//
+// Circle Internet Group, Inc. CONFIDENTIAL
+//
+// This file includes unpublished proprietary source code of Circle Internet
+// Group, Inc. The copyright notice above does not
+// evidence any actual or intended publication of such source code. Disclosure
+// of this source code or any related proprietary information is strictly
+// prohibited without the express written permission of Circle Internet Group, Inc.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getClient = getClient;
+const core_1 = require("@wagmi/core");
+function getClient(client, chain) {
+    const { config } = client;
+    if (config === undefined) {
+        return client;
+    }
+    const _client = (0, core_1.getClient)(config, { chainId: chain.id });
+    if (_client === undefined) {
+        throw new Error(`Failed to get client for ${chain.name} ${chain.id}`);
+    }
+    return { ..._client, config };
+}

package/dist/cjs/utils/getClient.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/utils/getClient.test.js

@@ -0,0 +1,46 @@
+"use strict";
+// Copyright (c) 2025, Circle Internet Group, Inc.
+// All rights reserved.
+//
+// Circle Internet Group, Inc. CONFIDENTIAL
+//
+// This file includes unpublished proprietary source code of Circle Internet
+// Group, Inc. The copyright notice above does not
+// evidence any actual or intended publication of such source code. Disclosure
+// of this source code or any related proprietary information is strictly
+// prohibited without the express written permission of Circle Internet Group, Inc.
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@wagmi/core");
+const viem_1 = require("viem");
+const vitest_1 = require("vitest");
+const index_js_1 = require("../chains/index.js");
+const getClient_js_1 = require("./getClient.js");
+(0, vitest_1.describe)('getClient', () => {
+    (0, vitest_1.test)('should return original client when no config is provided', () => {
+        const client = (0, viem_1.createClient)({
+            chain: index_js_1.ETH_SEPOLIA,
+            transport: (0, viem_1.http)(),
+        });
+        const result = (0, getClient_js_1.getClient)(client, index_js_1.MATIC_AMOY);
+        (0, vitest_1.expect)(result).toBe(client);
+    });
+    (0, vitest_1.test)('should get new client from wagmi when config is provided', () => {
+        const config = (0, core_1.createConfig)({
+            chains: [index_js_1.ETH_SEPOLIA, index_js_1.MATIC_AMOY],
+            transports: {
+                [index_js_1.ETH_SEPOLIA.id]: (0, viem_1.http)(),
+                [index_js_1.MATIC_AMOY.id]: (0, viem_1.http)(),
+            },
+        });
+        const client = (0, viem_1.createClient)({
+            chain: index_js_1.ETH_SEPOLIA,
+            transport: (0, viem_1.http)(),
+        });
+        // Add config to client
+        const clientWithConfig = Object.assign(client, { config });
+        const result = (0, getClient_js_1.getClient)(clientWithConfig, index_js_1.MATIC_AMOY);
+        (0, vitest_1.expect)(result).toBeDefined();
+        (0, vitest_1.expect)(result).not.toBe(client);
+        (0, vitest_1.expect)(result.chain).toBe(index_js_1.MATIC_AMOY);
+    });
+});

package/dist/cjs/utils/index.d.ts

@@ -1,3 +1,4 @@
+export * from './createCustomWalletClient.js';
 export * from './formatUnits.js';
 export * from './generateIdempotencyKey.js';
 export * from './getChainContractByAddress.js';

package/dist/cjs/utils/index.js

@@ -24,6 +24,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./createCustomWalletClient.js"), exports);
 __exportStar(require("./formatUnits.js"), exports);
 __exportStar(require("./generateIdempotencyKey.js"), exports);
 __exportStar(require("./getChainContractByAddress.js"), exports);