@circle-fin/usdckit 0.21.0 → 0.22.0

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

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

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

@@ -0,0 +1,11 @@
+// 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.
+export * from './toSolanaSigner.js';

package/dist/esm/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/esm/providers/circle-wallets/utils/toSolanaSigner.js

@@ -0,0 +1,30 @@
+// 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.
+import { getBase64EncodedWireTransaction } from '@solana/kit';
+import { base58ToBytes } from '../../solana/utils/codecs.js';
+import { signTransaction } from '../actions/signTransaction.js';
+export 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 signTransaction(client, {
+                    address,
+                    blockchain: chain.blockchainId,
+                    rawTransaction: getBase64EncodedWireTransaction(transaction),
+                });
+                return {
+                    [address]: base58ToBytes(signature),
+                };
+            })));
+        },
+    });
+}

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

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

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

@@ -0,0 +1,127 @@
+// 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.
+import { address } from '@solana/kit';
+import { describe, test, expect, vi, beforeEach } from 'vitest';
+import { chain as SOL } from '../../../chains/SOL.js';
+import { chain as SOL_DEVNET } from '../../../chains/SOL_DEVNET.js';
+import { signTransaction } from '../actions/signTransaction.js';
+import { toSolanaSigner } from './toSolanaSigner.js';
+// Mock the dependencies
+vi.mock('../actions/signTransaction.js');
+const mockSignTransaction = vi.mocked(signTransaction);
+describe('toSolanaSigner', () => {
+    const mockClient = {};
+    const testAddress = 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}`,
+    });
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    test.each([
+        ['SOL mainnet', SOL, testAddress],
+        ['SOL devnet', SOL_DEVNET, testAddress],
+        ['custom address', SOL, address('4uQyYqgPjMz1abH6wKGjZ7mvvcsZmNMoPBtAtV7YB9LV')],
+    ])('should create a signer with correct address for %s', (_, chain, expectedAddress) => {
+        const signer = toSolanaSigner(mockClient, expectedAddress, chain);
+        expect(signer.address).toBe(expectedAddress);
+        expect(Object.isFrozen(signer)).toBe(true);
+        expect(typeof signer.signTransactions).toBe('function');
+    });
+    test.each([
+        ['single transaction', [mockTransaction], SOL, 1],
+        ['multiple transactions', [mockTransaction, mockTransaction], SOL_DEVNET, 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 = toSolanaSigner(mockClient, testAddress, chain);
+        const result = await signer.signTransactions(transactions);
+        expect(result).toHaveLength(expectedCallCount);
+        expect(Object.isFrozen(result)).toBe(true);
+        // Check that each result has the testAddress property
+        for (let i = 0; i < expectedCallCount; i++) {
+            expect(result[i]).toHaveProperty(testAddress);
+        }
+        expect(mockSignTransaction).toHaveBeenCalledTimes(expectedCallCount);
+        // Check each call
+        for (let i = 1; i <= expectedCallCount; i++) {
+            expect(mockSignTransaction).toHaveBeenNthCalledWith(i, mockClient, {
+                address: testAddress,
+                blockchain: chain.blockchainId,
+                rawTransaction: expect.any(String),
+            });
+        }
+    });
+    test('should handle empty transactions array', async () => {
+        const signer = toSolanaSigner(mockClient, testAddress, SOL);
+        const result = await signer.signTransactions([]);
+        expect(result).toHaveLength(0);
+        expect(Object.isFrozen(result)).toBe(true);
+        expect(mockSignTransaction).not.toHaveBeenCalled();
+    });
+    test.each([
+        ['SOL mainnet', SOL, 'SOL'],
+        ['SOL devnet', SOL_DEVNET, 'SOL-DEVNET'],
+    ])('should use correct blockchain ID for %s', async (_, chain, expectedBlockchainId) => {
+        mockSignTransaction.mockResolvedValue(createMockSignTransactionResponse(MOCK_SIGNATURE_1));
+        const signer = toSolanaSigner(mockClient, testAddress, chain);
+        const result = await signer.signTransactions([mockTransaction]);
+        expect(result).toHaveLength(1);
+        expect(mockSignTransaction).toHaveBeenNthCalledWith(1, mockClient, {
+            address: testAddress,
+            blockchain: expectedBlockchainId,
+            rawTransaction: expect.any(String),
+        });
+    });
+    test('should propagate signTransaction errors', async () => {
+        const mockError = new Error('Signing failed');
+        mockSignTransaction.mockRejectedValue(mockError);
+        const signer = toSolanaSigner(mockClient, testAddress, SOL);
+        await expect(signer.signTransactions([mockTransaction])).rejects.toThrow('Signing failed');
+    });
+    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 = toSolanaSigner(mockClient, testAddress, SOL);
+        await expect(signer.signTransactions([mockTransaction, mockTransaction])).rejects.toThrow('Second transaction failed');
+    });
+});

package/dist/esm/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/esm/providers/cross-chain-transfer-protocol/actions/approve.js

@@ -8,15 +8,15 @@
 // 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.
-import { createPublicClient, erc20Abi, http } from 'viem';
-import { simulateContract as _simulateContract } from 'viem/actions';
+import { erc20Abi } from 'viem';
+import { simulateContract as _simulateContract, writeContract as _writeContract } from 'viem/actions';
 import { getAction } from 'viem/utils';
 import { UnsupportedChainError } from '../../../errors/UnsupportedChainError.js';
+import { getClient } from '../../../utils/getClient.js';
 import { parseAccount } from '../../../utils/parseAccount.js';
 import { parseAddress } from '../../../utils/parseAddress.js';
 import { parseUnitsAsToken } from '../../../utils/parseUnitsAsToken.js';
 import { raise } from '../../../utils/raise.js';
-import { writeContract as _writeContract } from '../../circle-wallets/actions/writeContract.js';
 import { extractChain } from '../index.js';
 /**
  * Executes the `approve` function of the Token Messenger contract for CCTP.
@@ -28,12 +28,9 @@ export async function approve(client, params) {
     const { token: _token, spender, value: _value, chain: _chain = client.chain, account: _account, gas, fees, } = params;
     const account = parseAccount(_account, { chain: _chain });
     const chain = extractChain(account.chain) ?? raise(new UnsupportedChainError());
-    // HACK: `simulateContract` does not support `chain` parameter
-    const simulateContract = getAction(createPublicClient({
-        chain,
-        transport: http(),
-    }), _simulateContract, 'simulateContract');
-    const writeContract = getAction(client, _writeContract, 'writeContract');
+    const _client = getClient(client, chain);
+    const writeContract = getAction(_client, _writeContract, 'writeContract');
+    const simulateContract = getAction(_client, _simulateContract, 'simulateContract');
     const token = parseAddress(_token);
     const value = await parseUnitsAsToken({ value: _value, token, chain });
     const { request } = await simulateContract({
@@ -45,5 +42,5 @@ export async function approve(client, params) {
         gas,
         ...fees,
     });
-    return await writeContract({ ...request, chain, signal: params.signal });
+    return await writeContract({ ...request, chain });
 }

package/dist/esm/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/esm/providers/cross-chain-transfer-protocol/actions/bridge.js

@@ -68,7 +68,6 @@ export async function bridge(client, params) {
             account: fromAccount,
             gas,
             fees,
-            signal: params.signal,
         });
         await waitForTransactionReceipt({ hash: approveTxHash });
     }
@@ -82,7 +81,6 @@ export async function bridge(client, params) {
         account: fromAccount,
         gas,
         fees,
-        signal: params.signal,
     });
     // Step 3 - Get CCTP Attestation
     const depositForBurnTxAttestationMessage = await waitForAttestationMessage({
@@ -98,7 +96,6 @@ export async function bridge(client, params) {
         account: toAccount,
         gas,
         fees,
-        signal: params.signal,
     });
     return receiveMessageTxHash;
 }

package/dist/esm/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/esm/providers/cross-chain-transfer-protocol/actions/depositForBurn.js

@@ -8,15 +8,14 @@
 // 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.
-import { createPublicClient, http } from 'viem';
-import { simulateContract as _simulateContract } from 'viem/actions';
+import { simulateContract as _simulateContract, writeContract as _writeContract } from 'viem/actions';
 import { getAction, pad } from 'viem/utils';
 import { UnsupportedChainError } from '../../../errors/UnsupportedChainError.js';
+import { getClient } from '../../../utils/getClient.js';
 import { parseAccount } from '../../../utils/parseAccount.js';
 import { parseAddress } from '../../../utils/parseAddress.js';
 import { parseUnitsAsToken } from '../../../utils/parseUnitsAsToken.js';
 import { raise } from '../../../utils/raise.js';
-import { writeContract as _writeContract } from '../../circle-wallets/actions/writeContract.js';
 import { extractChain } from '../index.js';
 /**
  * Executes the `depositForBurn` function of the Token Messenger contract for CCTP.
@@ -28,12 +27,9 @@ export async function depositForBurn(client, params) {
     const { amount: _amount, destinationDomain, mintRecipient, burnToken: _burnToken, chain: _chain = client.chain, account: _account, gas, fees, } = params;
     const account = parseAccount(_account, { chain: _chain });
     const chain = extractChain(account.chain) ?? raise(new UnsupportedChainError());
-    // HACK: `simulateContract` does not support `chain` parameter
-    const simulateContract = getAction(createPublicClient({
-        chain,
-        transport: http(),
-    }), _simulateContract, 'simulateContract');
-    const writeContract = getAction(client, _writeContract, 'writeContract');
+    const _client = getClient(client, chain);
+    const writeContract = getAction(_client, _writeContract, 'writeContract');
+    const simulateContract = getAction(_client, _simulateContract, 'simulateContract');
     const tokenMessenger = chain.contracts.TokenMessenger;
     const burnToken = parseAddress(_burnToken);
     const amount = await parseUnitsAsToken({ value: _amount, token: burnToken, chain });
@@ -46,5 +42,5 @@ export async function depositForBurn(client, params) {
         gas,
         ...fees,
     });
-    return await writeContract({ ...request, chain, signal: params.signal });
+    return await writeContract({ ...request, chain });
 }

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

@@ -21,19 +21,18 @@ export * from './receiveMessage.js';
 export * from './bridge.js';
 export * from './waitForAttestationMessage.js';
 export function actions(client) {
-    const _client = client;
     return {
         /** See {@link approve} action */
-        approve: (params) => approve(_client, params),
+        approve: (params) => approve(client, params),
         /** See {@link depositForBurn} action */
-        depositForBurn: (params) => depositForBurn(_client, params),
+        depositForBurn: (params) => depositForBurn(client, params),
         /** See {@link receiveMessage} action */
-        receiveMessage: (params) => receiveMessage(_client, params),
+        receiveMessage: (params) => receiveMessage(client, params),
         /** See {@link waitForAttestationMessage} action */
-        waitForAttestationMessage: (params) => waitForAttestationMessage(_client, params),
+        waitForAttestationMessage: (params) => waitForAttestationMessage(client, params),
         /** See {@link listMessages} action */
-        listMessages: (params) => listMessages(_client, params),
+        listMessages: (params) => listMessages(client, params),
         /** See {@link bridge} action */
-        bridge: (params) => bridge(_client, params),
+        bridge: (params) => bridge(client, params),
     };
 }

package/dist/esm/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/esm/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/esm/providers/cross-chain-transfer-protocol/actions/receiveMessage.js

@@ -8,13 +8,12 @@
 // 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.
-import { createPublicClient, http } from 'viem';
-import { simulateContract as _simulateContract } from 'viem/actions';
+import { simulateContract as _simulateContract, writeContract as _writeContract } from 'viem/actions';
 import { getAction } from 'viem/utils';
 import { UnsupportedChainError } from '../../../errors/UnsupportedChainError.js';
+import { getClient } from '../../../utils/getClient.js';
 import { parseAccount } from '../../../utils/parseAccount.js';
 import { raise } from '../../../utils/raise.js';
-import { writeContract as _writeContract } from '../../circle-wallets/actions/writeContract.js';
 import { extractChain } from '../index.js';
 /**
  * Executes the `receiveMessage` function of the Message Transmitter contract for CCTP.
@@ -26,12 +25,9 @@ export async function receiveMessage(client, params) {
     const { message, attestation, chain: _chain = client.chain, account: _account, gas, fees } = params;
     const account = parseAccount(_account, { chain: _chain });
     const chain = extractChain(account.chain) ?? raise(new UnsupportedChainError());
-    // HACK: `simulateContract` does not support `chain` parameter
-    const simulateContract = getAction(createPublicClient({
-        chain,
-        transport: http(),
-    }), _simulateContract, 'simulateContract');
-    const writeContract = getAction(client, _writeContract, 'writeContract');
+    const _client = getClient(client, chain);
+    const writeContract = getAction(_client, _writeContract, 'writeContract');
+    const simulateContract = getAction(_client, _simulateContract, 'simulateContract');
     const messageTransmitter = chain.contracts.MessageTransmitter;
     const { request } = await simulateContract({
         address: messageTransmitter.address,
@@ -42,5 +38,5 @@ export async function receiveMessage(client, params) {
         gas,
         ...fees,
     });
-    return await writeContract({ ...request, chain, signal: params.signal });
+    return await writeContract({ ...request, chain });
 }

package/dist/esm/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/esm/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/esm/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/esm/providers/cross-chain-transfer-protocol/transports/index.test.js

@@ -69,7 +69,7 @@ describe('Provider', () => {
             ],
         ])('%s', async (_, params, [listMessagesReq, listMessagesResp], expectedResults) => {
             vi.spyOn(global, 'fetch').mockResolvedValue(listMessagesResp);
-            const results = await provider.circle_listMessages(params);
+            const results = await provider.request({ method: 'circle_listMessages', params: [params] });
             expect(results).toMatchObject(expectedResults);
             expect(fetch).toHaveBeenCalledWith(listMessagesReq);
         });
@@ -108,7 +108,7 @@ describe('Provider', () => {
             ],
         ])('%s', async (_, params, [listMessagesReq, listMessagesResp], expectedResults) => {
             vi.spyOn(global, 'fetch').mockResolvedValue(listMessagesResp);
-            await expect(provider.circle_listMessages(params)).rejects.toThrowError(expectedResults);
+            await expect(provider.request({ method: 'circle_listMessages', params: [params] })).rejects.toThrowError(expectedResults);
             expect(fetch).toHaveBeenCalledWith(listMessagesReq);
         });
     });

package/dist/esm/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/esm/providers/solana/actions/getAccountInfo.js

@@ -0,0 +1,20 @@
+// 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.
+/**
+ * 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 async function getAccountInfo(client, ...params) {
+    return await client.request({ method: 'sol_getAccountInfo', params });
+}

package/dist/esm/providers/solana/actions/getAccountInfo.test.d.ts

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

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

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

package/dist/esm/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/esm/providers/solana/actions/getBalance.js

@@ -0,0 +1,20 @@
+// 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.
+/**
+ * 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 async function getBalance(client, ...params) {
+    return await client.request({ method: 'sol_getBalance', params });
+}

package/dist/esm/providers/solana/actions/getBalance.test.d.ts

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