@circle-fin/usdckit 0.21.0 → 0.22.0

package/dist/cjs/providers/circle-wallets/utils/index.d.ts

@@ -0,0 +1 @@
+export * from './toSolanaSigner.js';

package/dist/cjs/providers/circle-wallets/utils/index.js

@@ -0,0 +1,27 @@
+"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.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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("./toSolanaSigner.js"), exports);

package/dist/cjs/providers/circle-wallets/utils/toSolanaSigner.d.ts

@@ -0,0 +1,4 @@
+import type { SOL, SOL_DEVNET } from '../../../chains/index.js';
+import type { ExtendedViemClient } from '../../../client.js';
+import type { TransactionPartialSigner, Address as SolanaAddress } from '@solana/kit';
+export declare function toSolanaSigner<TAddress extends SolanaAddress = SolanaAddress>(client: ExtendedViemClient, address: TAddress, chain: typeof SOL | typeof SOL_DEVNET): TransactionPartialSigner<TAddress>;

package/dist/cjs/providers/circle-wallets/utils/toSolanaSigner.js

@@ -0,0 +1,33 @@
+"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.toSolanaSigner = toSolanaSigner;
+const kit_1 = require("@solana/kit");
+const codecs_js_1 = require("../../solana/utils/codecs.js");
+const signTransaction_js_1 = require("../actions/signTransaction.js");
+function toSolanaSigner(client, address, chain) {
+    return Object.freeze({
+        address,
+        async signTransactions(transactions) {
+            return Object.freeze(await Promise.all(transactions.map(async (transaction) => {
+                const { signature } = await (0, signTransaction_js_1.signTransaction)(client, {
+                    address,
+                    blockchain: chain.blockchainId,
+                    rawTransaction: (0, kit_1.getBase64EncodedWireTransaction)(transaction),
+                });
+                return {
+                    [address]: (0, codecs_js_1.base58ToBytes)(signature),
+                };
+            })));
+        },
+    });
+}

package/dist/cjs/providers/circle-wallets/utils/toSolanaSigner.test.js

@@ -0,0 +1,129 @@
+"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 kit_1 = require("@solana/kit");
+const vitest_1 = require("vitest");
+const SOL_js_1 = require("../../../chains/SOL.js");
+const SOL_DEVNET_js_1 = require("../../../chains/SOL_DEVNET.js");
+const signTransaction_js_1 = require("../actions/signTransaction.js");
+const toSolanaSigner_js_1 = require("./toSolanaSigner.js");
+// Mock the dependencies
+vitest_1.vi.mock('../actions/signTransaction.js');
+const mockSignTransaction = vitest_1.vi.mocked(signTransaction_js_1.signTransaction);
+(0, vitest_1.describe)('toSolanaSigner', () => {
+    const mockClient = {};
+    const testAddress = (0, kit_1.address)('11111111111111111111111111111112');
+    // Constants for reused mock data
+    const MOCK_SIGNATURE_1 = '5uP3hpCqaGKrzJzGgQ9oAhcLmqjrHWLZBZRzNGJCFhJnHJjhDDkVMvFvLPWmKYPL5Yjds1VLwFbCPfz7hKvdLLXu';
+    const MOCK_SIGNATURE_2 = '3KqKHLwAGRrC1DgXDM8YjYvKoKNi2oBX2RjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjYjY';
+    // Create a minimal transaction object that can be encoded
+    const mockTransaction = {
+        messageBytes: new Uint8Array([
+            0x01,
+            0x00,
+            0x01,
+            0x00,
+            0x01,
+            ...Array.from(new Array(32), (_, i) => i + 1), // fee payer public key
+            ...Array.from(new Array(32), (_, i) => i + 33), // recent blockhash
+            0x00, // num instructions
+        ]),
+        signatures: {
+            [testAddress]: new Uint8Array(64),
+        },
+    };
+    // Helper functions
+    const createMockSignTransactionResponse = (signature, suffix = '') => ({
+        signature,
+        signedTransaction: `mockSignedTransaction${suffix}`,
+        txHash: `mockTxHash${suffix}`,
+    });
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.restoreAllMocks();
+    });
+    vitest_1.test.each([
+        ['SOL mainnet', SOL_js_1.chain, testAddress],
+        ['SOL devnet', SOL_DEVNET_js_1.chain, testAddress],
+        ['custom address', SOL_js_1.chain, (0, kit_1.address)('4uQyYqgPjMz1abH6wKGjZ7mvvcsZmNMoPBtAtV7YB9LV')],
+    ])('should create a signer with correct address for %s', (_, chain, expectedAddress) => {
+        const signer = (0, toSolanaSigner_js_1.toSolanaSigner)(mockClient, expectedAddress, chain);
+        (0, vitest_1.expect)(signer.address).toBe(expectedAddress);
+        (0, vitest_1.expect)(Object.isFrozen(signer)).toBe(true);
+        (0, vitest_1.expect)(typeof signer.signTransactions).toBe('function');
+    });
+    vitest_1.test.each([
+        ['single transaction', [mockTransaction], SOL_js_1.chain, 1],
+        ['multiple transactions', [mockTransaction, mockTransaction], SOL_DEVNET_js_1.chain, 2],
+    ])('should sign %s', async (_, transactions, chain, expectedCallCount) => {
+        // Setup mocks
+        if (expectedCallCount === 1) {
+            mockSignTransaction.mockResolvedValue(createMockSignTransactionResponse(MOCK_SIGNATURE_1));
+        }
+        else {
+            mockSignTransaction
+                .mockResolvedValueOnce(createMockSignTransactionResponse(MOCK_SIGNATURE_1, '_1'))
+                .mockResolvedValueOnce(createMockSignTransactionResponse(MOCK_SIGNATURE_2, '_2'));
+        }
+        const signer = (0, toSolanaSigner_js_1.toSolanaSigner)(mockClient, testAddress, chain);
+        const result = await signer.signTransactions(transactions);
+        (0, vitest_1.expect)(result).toHaveLength(expectedCallCount);
+        (0, vitest_1.expect)(Object.isFrozen(result)).toBe(true);
+        // Check that each result has the testAddress property
+        for (let i = 0; i < expectedCallCount; i++) {
+            (0, vitest_1.expect)(result[i]).toHaveProperty(testAddress);
+        }
+        (0, vitest_1.expect)(mockSignTransaction).toHaveBeenCalledTimes(expectedCallCount);
+        // Check each call
+        for (let i = 1; i <= expectedCallCount; i++) {
+            (0, vitest_1.expect)(mockSignTransaction).toHaveBeenNthCalledWith(i, mockClient, {
+                address: testAddress,
+                blockchain: chain.blockchainId,
+                rawTransaction: vitest_1.expect.any(String),
+            });
+        }
+    });
+    (0, vitest_1.test)('should handle empty transactions array', async () => {
+        const signer = (0, toSolanaSigner_js_1.toSolanaSigner)(mockClient, testAddress, SOL_js_1.chain);
+        const result = await signer.signTransactions([]);
+        (0, vitest_1.expect)(result).toHaveLength(0);
+        (0, vitest_1.expect)(Object.isFrozen(result)).toBe(true);
+        (0, vitest_1.expect)(mockSignTransaction).not.toHaveBeenCalled();
+    });
+    vitest_1.test.each([
+        ['SOL mainnet', SOL_js_1.chain, 'SOL'],
+        ['SOL devnet', SOL_DEVNET_js_1.chain, 'SOL-DEVNET'],
+    ])('should use correct blockchain ID for %s', async (_, chain, expectedBlockchainId) => {
+        mockSignTransaction.mockResolvedValue(createMockSignTransactionResponse(MOCK_SIGNATURE_1));
+        const signer = (0, toSolanaSigner_js_1.toSolanaSigner)(mockClient, testAddress, chain);
+        const result = await signer.signTransactions([mockTransaction]);
+        (0, vitest_1.expect)(result).toHaveLength(1);
+        (0, vitest_1.expect)(mockSignTransaction).toHaveBeenNthCalledWith(1, mockClient, {
+            address: testAddress,
+            blockchain: expectedBlockchainId,
+            rawTransaction: vitest_1.expect.any(String),
+        });
+    });
+    (0, vitest_1.test)('should propagate signTransaction errors', async () => {
+        const mockError = new Error('Signing failed');
+        mockSignTransaction.mockRejectedValue(mockError);
+        const signer = (0, toSolanaSigner_js_1.toSolanaSigner)(mockClient, testAddress, SOL_js_1.chain);
+        await (0, vitest_1.expect)(signer.signTransactions([mockTransaction])).rejects.toThrow('Signing failed');
+    });
+    (0, vitest_1.test)('should handle partial failures in multiple transactions', async () => {
+        const mockError = new Error('Second transaction failed');
+        mockSignTransaction
+            .mockResolvedValueOnce(createMockSignTransactionResponse(MOCK_SIGNATURE_1, '1'))
+            .mockRejectedValueOnce(mockError);
+        const signer = (0, toSolanaSigner_js_1.toSolanaSigner)(mockClient, testAddress, SOL_js_1.chain);
+        await (0, vitest_1.expect)(signer.signTransactions([mockTransaction, mockTransaction])).rejects.toThrow('Second transaction failed');
+    });
+});

package/dist/cjs/providers/cross-chain-transfer-protocol/actions/approve.d.ts

@@ -1,6 +1,6 @@
-import type { Account, Address, BaseUnits, ControlFlowOptions, ExtendedViemClient, NativeUnits } from '../../../types.js';
+import type { Account, Address, BaseUnits, ControlFlowOptions, NativeUnits } from '../../../types.js';
 import type { Chain } from '../index.js';
-import type { Abi, FeeValuesEIP1559 } from 'viem';
+import type { Abi, FeeValuesEIP1559, Client } from 'viem';
 export type ApproveParams = {
     /** Address of the token */
     token: Address | {
@@ -26,4 +26,4 @@ export type ApproveParams = {
  * @param client - The client instance to use for the operation.
  * @returns Returns the transaction hash of the contract execution
  */
-export declare function approve(client: ExtendedViemClient, params: ApproveParams & ControlFlowOptions): Promise<`0x${string}`>;
+export declare function approve(client: Client, params: ApproveParams & ControlFlowOptions): Promise<`0x${string}`>;

package/dist/cjs/providers/cross-chain-transfer-protocol/actions/approve.js

@@ -15,11 +15,11 @@ const viem_1 = require("viem");
 const actions_1 = require("viem/actions");
 const utils_1 = require("viem/utils");
 const UnsupportedChainError_js_1 = require("../../../errors/UnsupportedChainError.js");
+const getClient_js_1 = require("../../../utils/getClient.js");
 const parseAccount_js_1 = require("../../../utils/parseAccount.js");
 const parseAddress_js_1 = require("../../../utils/parseAddress.js");
 const parseUnitsAsToken_js_1 = require("../../../utils/parseUnitsAsToken.js");
 const raise_js_1 = require("../../../utils/raise.js");
-const writeContract_js_1 = require("../../circle-wallets/actions/writeContract.js");
 const index_js_1 = require("../index.js");
 /**
  * Executes the `approve` function of the Token Messenger contract for CCTP.
@@ -31,12 +31,9 @@ async function approve(client, params) {
     const { token: _token, spender, value: _value, chain: _chain = client.chain, account: _account, gas, fees, } = params;
     const account = (0, parseAccount_js_1.parseAccount)(_account, { chain: _chain });
     const chain = (0, index_js_1.extractChain)(account.chain) ?? (0, raise_js_1.raise)(new UnsupportedChainError_js_1.UnsupportedChainError());
-    // HACK: `simulateContract` does not support `chain` parameter
-    const simulateContract = (0, utils_1.getAction)((0, viem_1.createPublicClient)({
-        chain,
-        transport: (0, viem_1.http)(),
-    }), actions_1.simulateContract, 'simulateContract');
-    const writeContract = (0, utils_1.getAction)(client, writeContract_js_1.writeContract, 'writeContract');
+    const _client = (0, getClient_js_1.getClient)(client, chain);
+    const writeContract = (0, utils_1.getAction)(_client, actions_1.writeContract, 'writeContract');
+    const simulateContract = (0, utils_1.getAction)(_client, actions_1.simulateContract, 'simulateContract');
     const token = (0, parseAddress_js_1.parseAddress)(_token);
     const value = await (0, parseUnitsAsToken_js_1.parseUnitsAsToken)({ value: _value, token, chain });
     const { request } = await simulateContract({
@@ -48,5 +45,5 @@ async function approve(client, params) {
         gas,
         ...fees,
     });
-    return await writeContract({ ...request, chain, signal: params.signal });
+    return await writeContract({ ...request, chain });
 }

package/dist/cjs/providers/cross-chain-transfer-protocol/actions/bridge.d.ts

@@ -1,6 +1,6 @@
-import type { Account, Address, BaseUnits, ChainContract, ControlFlowOptions, ExtendedViemClient, NativeUnits } from '../../../types.js';
+import type { Account, Address, BaseUnits, ChainContract, ControlFlowOptions, NativeUnits } from '../../../types.js';
 import type { Chain } from '../index.js';
-import type { FeeValuesEIP1559 } from 'viem';
+import type { FeeValuesEIP1559, Client } from 'viem';
 /**
  * Parameters for the {@link bridge} function.
  */
@@ -40,7 +40,7 @@ export type BridgeParams = {
  * })
  * ```
  */
-export declare function bridge(client: ExtendedViemClient, params: BridgeParams & ControlFlowOptions & {
+export declare function bridge(client: Client, params: BridgeParams & ControlFlowOptions & {
     /** Includes the approve() step in the transaction. */
     withApprove?: boolean;
 }): Promise<`0x${string}`>;

package/dist/cjs/providers/cross-chain-transfer-protocol/actions/bridge.js

@@ -71,7 +71,6 @@ async function bridge(client, params) {
             account: fromAccount,
             gas,
             fees,
-            signal: params.signal,
         });
         await waitForTransactionReceipt({ hash: approveTxHash });
     }
@@ -85,7 +84,6 @@ async function bridge(client, params) {
         account: fromAccount,
         gas,
         fees,
-        signal: params.signal,
     });
     // Step 3 - Get CCTP Attestation
     const depositForBurnTxAttestationMessage = await waitForAttestationMessage({
@@ -101,7 +99,6 @@ async function bridge(client, params) {
         account: toAccount,
         gas,
         fees,
-        signal: params.signal,
     });
     return receiveMessageTxHash;
 }

package/dist/cjs/providers/cross-chain-transfer-protocol/actions/depositForBurn.d.ts

@@ -1,6 +1,6 @@
-import type { Account, Address, BaseUnits, ControlFlowOptions, ExtendedViemClient, NativeUnits } from '../../../types.js';
+import type { Account, Address, BaseUnits, ControlFlowOptions, NativeUnits } from '../../../types.js';
 import type { Chain } from '../index.js';
-import type { Abi, FeeValuesEIP1559 } from 'viem';
+import type { Abi, FeeValuesEIP1559, Client } from 'viem';
 export type DepositForBurnParams = {
     /** The amount to be deposited. */
     amount: BaseUnits | NativeUnits;
@@ -28,4 +28,4 @@ export type DepositForBurnParams = {
  * @param client - The client instance to use for the operation.
  * @returns Returns the transaction hash of the contract execution
  */
-export declare function depositForBurn(client: ExtendedViemClient, params: DepositForBurnParams & ControlFlowOptions): Promise<`0x${string}`>;
+export declare function depositForBurn(client: Client, params: DepositForBurnParams & ControlFlowOptions): Promise<`0x${string}`>;

package/dist/cjs/providers/cross-chain-transfer-protocol/actions/depositForBurn.js

@@ -11,15 +11,14 @@
 // prohibited without the express written permission of Circle Internet Group, Inc.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.depositForBurn = depositForBurn;
-const viem_1 = require("viem");
 const actions_1 = require("viem/actions");
 const utils_1 = require("viem/utils");
 const UnsupportedChainError_js_1 = require("../../../errors/UnsupportedChainError.js");
+const getClient_js_1 = require("../../../utils/getClient.js");
 const parseAccount_js_1 = require("../../../utils/parseAccount.js");
 const parseAddress_js_1 = require("../../../utils/parseAddress.js");
 const parseUnitsAsToken_js_1 = require("../../../utils/parseUnitsAsToken.js");
 const raise_js_1 = require("../../../utils/raise.js");
-const writeContract_js_1 = require("../../circle-wallets/actions/writeContract.js");
 const index_js_1 = require("../index.js");
 /**
  * Executes the `depositForBurn` function of the Token Messenger contract for CCTP.
@@ -31,12 +30,9 @@ async function depositForBurn(client, params) {
     const { amount: _amount, destinationDomain, mintRecipient, burnToken: _burnToken, chain: _chain = client.chain, account: _account, gas, fees, } = params;
     const account = (0, parseAccount_js_1.parseAccount)(_account, { chain: _chain });
     const chain = (0, index_js_1.extractChain)(account.chain) ?? (0, raise_js_1.raise)(new UnsupportedChainError_js_1.UnsupportedChainError());
-    // HACK: `simulateContract` does not support `chain` parameter
-    const simulateContract = (0, utils_1.getAction)((0, viem_1.createPublicClient)({
-        chain,
-        transport: (0, viem_1.http)(),
-    }), actions_1.simulateContract, 'simulateContract');
-    const writeContract = (0, utils_1.getAction)(client, writeContract_js_1.writeContract, 'writeContract');
+    const _client = (0, getClient_js_1.getClient)(client, chain);
+    const writeContract = (0, utils_1.getAction)(_client, actions_1.writeContract, 'writeContract');
+    const simulateContract = (0, utils_1.getAction)(_client, actions_1.simulateContract, 'simulateContract');
     const tokenMessenger = chain.contracts.TokenMessenger;
     const burnToken = (0, parseAddress_js_1.parseAddress)(_burnToken);
     const amount = await (0, parseUnitsAsToken_js_1.parseUnitsAsToken)({ value: _amount, token: burnToken, chain });
@@ -49,5 +45,5 @@ async function depositForBurn(client, params) {
         gas,
         ...fees,
     });
-    return await writeContract({ ...request, chain, signal: params.signal });
+    return await writeContract({ ...request, chain });
 }

package/dist/cjs/providers/cross-chain-transfer-protocol/actions/index.js

@@ -38,19 +38,18 @@ __exportStar(require("./receiveMessage.js"), exports);
 __exportStar(require("./bridge.js"), exports);
 __exportStar(require("./waitForAttestationMessage.js"), exports);
 function actions(client) {
-    const _client = client;
     return {
         /** See {@link approve} action */
-        approve: (params) => (0, approve_js_1.approve)(_client, params),
+        approve: (params) => (0, approve_js_1.approve)(client, params),
         /** See {@link depositForBurn} action */
-        depositForBurn: (params) => (0, depositForBurn_js_1.depositForBurn)(_client, params),
+        depositForBurn: (params) => (0, depositForBurn_js_1.depositForBurn)(client, params),
         /** See {@link receiveMessage} action */
-        receiveMessage: (params) => (0, receiveMessage_js_1.receiveMessage)(_client, params),
+        receiveMessage: (params) => (0, receiveMessage_js_1.receiveMessage)(client, params),
         /** See {@link waitForAttestationMessage} action */
-        waitForAttestationMessage: (params) => (0, waitForAttestationMessage_js_1.waitForAttestationMessage)(_client, params),
+        waitForAttestationMessage: (params) => (0, waitForAttestationMessage_js_1.waitForAttestationMessage)(client, params),
         /** See {@link listMessages} action */
-        listMessages: (params) => (0, listMessages_js_1.listMessages)(_client, params),
+        listMessages: (params) => (0, listMessages_js_1.listMessages)(client, params),
         /** See {@link bridge} action */
-        bridge: (params) => (0, bridge_js_1.bridge)(_client, params),
+        bridge: (params) => (0, bridge_js_1.bridge)(client, params),
     };
 }

package/dist/cjs/providers/cross-chain-transfer-protocol/actions/listMessages.d.ts

@@ -1,9 +1,9 @@
-import type { ExtendedViemClient } from '../../../types.js';
-import type { ListMessagesParams } from '../transports/index.js';
+import type { ListMessagesParams, EIP1474Methods as rpcSchema } from '../transports/index.js';
+import type { Client, Transport, Chain, Account } from 'viem';
 /**
  * Retrieves messages and attestations for a given transaction, supporting both V1 and V2 messages.
  *
  * @param client - The client instance to use for the operation.
  * @returns Returns the messages for the given transaction
  */
-export declare function listMessages(client: ExtendedViemClient, params: ListMessagesParams): Promise<import("../transports/index.js").ListMessagesReturnType>;
+export declare function listMessages<transport extends Transport, chain extends Chain | undefined, account extends Account | undefined>(client: Client<transport, chain, account, rpcSchema>, params: ListMessagesParams): Promise<import("../transports/index.js").ListMessagesReturnType>;

package/dist/cjs/providers/cross-chain-transfer-protocol/actions/receiveMessage.d.ts

@@ -1,6 +1,6 @@
-import type { Account, Address, ControlFlowOptions, ExtendedViemClient } from '../../../types.js';
+import type { Account, Address, ControlFlowOptions } from '../../../types.js';
 import type { Chain } from '../index.js';
-import type { FeeValuesEIP1559 } from 'viem';
+import type { FeeValuesEIP1559, Client } from 'viem';
 export type ReceiveMessageParams = {
     /** The message to be received. */
     message: string;
@@ -21,4 +21,4 @@ export type ReceiveMessageParams = {
  * @param client - The client instance to use for the operation.
  * @returns Returns the transaction hash of the contract execution
  */
-export declare function receiveMessage(client: ExtendedViemClient, params: ReceiveMessageParams & ControlFlowOptions): Promise<`0x${string}`>;
+export declare function receiveMessage(client: Client, params: ReceiveMessageParams & ControlFlowOptions): Promise<`0x${string}`>;

package/dist/cjs/providers/cross-chain-transfer-protocol/actions/receiveMessage.js

@@ -11,13 +11,12 @@
 // prohibited without the express written permission of Circle Internet Group, Inc.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.receiveMessage = receiveMessage;
-const viem_1 = require("viem");
 const actions_1 = require("viem/actions");
 const utils_1 = require("viem/utils");
 const UnsupportedChainError_js_1 = require("../../../errors/UnsupportedChainError.js");
+const getClient_js_1 = require("../../../utils/getClient.js");
 const parseAccount_js_1 = require("../../../utils/parseAccount.js");
 const raise_js_1 = require("../../../utils/raise.js");
-const writeContract_js_1 = require("../../circle-wallets/actions/writeContract.js");
 const index_js_1 = require("../index.js");
 /**
  * Executes the `receiveMessage` function of the Message Transmitter contract for CCTP.
@@ -29,12 +28,9 @@ async function receiveMessage(client, params) {
     const { message, attestation, chain: _chain = client.chain, account: _account, gas, fees } = params;
     const account = (0, parseAccount_js_1.parseAccount)(_account, { chain: _chain });
     const chain = (0, index_js_1.extractChain)(account.chain) ?? (0, raise_js_1.raise)(new UnsupportedChainError_js_1.UnsupportedChainError());
-    // HACK: `simulateContract` does not support `chain` parameter
-    const simulateContract = (0, utils_1.getAction)((0, viem_1.createPublicClient)({
-        chain,
-        transport: (0, viem_1.http)(),
-    }), actions_1.simulateContract, 'simulateContract');
-    const writeContract = (0, utils_1.getAction)(client, writeContract_js_1.writeContract, 'writeContract');
+    const _client = (0, getClient_js_1.getClient)(client, chain);
+    const writeContract = (0, utils_1.getAction)(_client, actions_1.writeContract, 'writeContract');
+    const simulateContract = (0, utils_1.getAction)(_client, actions_1.simulateContract, 'simulateContract');
     const messageTransmitter = chain.contracts.MessageTransmitter;
     const { request } = await simulateContract({
         address: messageTransmitter.address,
@@ -45,5 +41,5 @@ async function receiveMessage(client, params) {
         gas,
         ...fees,
     });
-    return await writeContract({ ...request, chain, signal: params.signal });
+    return await writeContract({ ...request, chain });
 }

package/dist/cjs/providers/cross-chain-transfer-protocol/actions/waitForAttestationMessage.d.ts

@@ -1,6 +1,7 @@
-import type { ControlFlowOptions, ExtendedViemClient } from '../../../types.js';
+import type { ControlFlowOptions } from '../../../types.js';
 import type { Chain } from '../index.js';
 import type { Message } from '../transports/index.js';
+import type { Client } from 'viem';
 export type WaitForAttestationMessageParams = {
     hash: string;
     chain?: Chain;
@@ -15,4 +16,4 @@ export type AttestedMessage = Omit<Message, 'attestation' | 'status'> & {
  * @param client - The client instance to use for the operation.
  * @returns Returns the attestation of the transaction hash.
  */
-export declare function waitForAttestationMessage(client: ExtendedViemClient, params: WaitForAttestationMessageParams & ControlFlowOptions): Promise<AttestedMessage>;
+export declare function waitForAttestationMessage(client: Client, params: WaitForAttestationMessageParams & ControlFlowOptions): Promise<AttestedMessage>;

package/dist/cjs/providers/cross-chain-transfer-protocol/transports/http.d.ts

@@ -1,5 +1,4 @@
 export declare function http({ name }: {
-    apiKey: string;
     baseUrl?: string;
     name?: string;
 }): import("viem").CustomTransport;

package/dist/cjs/providers/cross-chain-transfer-protocol/transports/index.d.ts

@@ -31,5 +31,5 @@ export type EIP1474Methods = [
     }
 ];
 export declare class Provider extends BaseProvider {
-    circle_listMessages(params: ListMessagesParams): Promise<ListMessagesReturnType>;
+    protected circle_listMessages(params: ListMessagesParams): Promise<ListMessagesReturnType>;
 }

package/dist/cjs/providers/cross-chain-transfer-protocol/transports/index.test.js

@@ -71,7 +71,7 @@ const index_js_1 = require("./index.js");
             ],
         ])('%s', async (_, params, [listMessagesReq, listMessagesResp], expectedResults) => {
             vitest_1.vi.spyOn(global, 'fetch').mockResolvedValue(listMessagesResp);
-            const results = await provider.circle_listMessages(params);
+            const results = await provider.request({ method: 'circle_listMessages', params: [params] });
             (0, vitest_1.expect)(results).toMatchObject(expectedResults);
             (0, vitest_1.expect)(fetch).toHaveBeenCalledWith(listMessagesReq);
         });
@@ -110,7 +110,7 @@ const index_js_1 = require("./index.js");
             ],
         ])('%s', async (_, params, [listMessagesReq, listMessagesResp], expectedResults) => {
             vitest_1.vi.spyOn(global, 'fetch').mockResolvedValue(listMessagesResp);
-            await (0, vitest_1.expect)(provider.circle_listMessages(params)).rejects.toThrowError(expectedResults);
+            await (0, vitest_1.expect)(provider.request({ method: 'circle_listMessages', params: [params] })).rejects.toThrowError(expectedResults);
             (0, vitest_1.expect)(fetch).toHaveBeenCalledWith(listMessagesReq);
         });
     });

package/dist/cjs/providers/solana/actions/getAccountInfo.d.ts

@@ -0,0 +1,23 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Gets account information for a given public key
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getAccountInfo}
+ * @returns Promise resolving to account information
+ */
+export declare function getAccountInfo(client: ExtendedViemClient, ...params: Parameters<Provider['sol_getAccountInfo']>): Promise<Readonly<{
+    context: Readonly<{
+        slot: import("@solana/rpc-types").Slot;
+    }>;
+    value: (Readonly<{
+        executable: boolean;
+        lamports: import("@solana/rpc-types").Lamports;
+        owner: import("@solana/addresses").Address;
+        rentEpoch: bigint;
+        space: bigint;
+    }> & Readonly<{
+        data: import("@solana/rpc-types").Base58EncodedBytes;
+    }>) | null;
+}>>;

package/dist/cjs/providers/{circle-wallets/actions/signTypedData.js → solana/actions/getAccountInfo.js}

@@ -10,12 +10,14 @@
 // 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.signTypedData = signTypedData;
+exports.getAccountInfo = getAccountInfo;
 /**
- * Sign the EIP-712 typed structured data from a specified developer-controlled wallet. This endpoint only supports Ethereum and EVM-compatible blockchains.
+ * Gets account information for a given public key
  *
- * See {@link https://developers.circle.com/api-reference/w3s/developer-controlled-wallets/sign-typed-data}
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getAccountInfo}
+ * @returns Promise resolving to account information
  */
-async function signTypedData(client, params) {
-    return await client.request({ method: 'circle_signTypedData', params: [params] });
+async function getAccountInfo(client, ...params) {
+    return await client.request({ method: 'sol_getAccountInfo', params });
 }

package/dist/cjs/providers/solana/actions/getAccountInfo.test.js

@@ -0,0 +1,39 @@
+"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 kit_1 = require("@solana/kit");
+const vitest_1 = require("vitest");
+const getAccountInfo_js_1 = require("./getAccountInfo.js");
+(0, vitest_1.describe)('getAccountInfo', () => {
+    const mockClient = {
+        request: vitest_1.vi.fn(),
+    };
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.resetAllMocks();
+    });
+    (0, vitest_1.it)('should forward all parameters to client.request', async () => {
+        const pubkey = (0, kit_1.address)('SysvarC1ock11111111111111111111111111111111');
+        const config = {
+            encoding: 'base64',
+            commitment: 'confirmed',
+            dataSlice: { offset: 0, length: 10 },
+        };
+        const mockResponse = { value: { lamports: 1000000 } };
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await (0, getAccountInfo_js_1.getAccountInfo)(mockClient, pubkey, config);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_getAccountInfo',
+            params: [pubkey, config],
+        });
+        (0, vitest_1.expect)(result).toBe(mockResponse);
+    });
+});

package/dist/cjs/providers/solana/actions/getBalance.d.ts

@@ -0,0 +1,15 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Gets the balance of an account
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBalance}
+ * @returns Promise resolving to account balance information
+ */
+export declare function getBalance(client: ExtendedViemClient, ...params: Parameters<Provider['sol_getBalance']>): Promise<Readonly<{
+    context: Readonly<{
+        slot: import("@solana/rpc-types").Slot;
+    }>;
+    value: import("@solana/rpc-types").Lamports;
+}>>;

package/dist/cjs/providers/solana/actions/getBalance.js

@@ -0,0 +1,23 @@
+"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.getBalance = getBalance;
+/**
+ * Gets the balance of an account
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBalance}
+ * @returns Promise resolving to account balance information
+ */
+async function getBalance(client, ...params) {
+    return await client.request({ method: 'sol_getBalance', params });
+}