@circle-fin/usdckit 0.21.1 → 0.23.0

package/dist/esm/providers/solana/actions/index.js

@@ -0,0 +1,173 @@
+// 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 { getAccountInfo } from './getAccountInfo.js';
+import { getBalance } from './getBalance.js';
+import { getBlock } from './getBlock.js';
+import { getBlockCommitment } from './getBlockCommitment.js';
+import { getBlockHeight } from './getBlockHeight.js';
+import { getBlockProduction } from './getBlockProduction.js';
+import { getBlockTime } from './getBlockTime.js';
+import { getBlocks } from './getBlocks.js';
+import { getBlocksWithLimit } from './getBlocksWithLimit.js';
+import { getClusterName } from './getClusterName.js';
+import { getClusterNodes } from './getClusterNodes.js';
+import { getEpochInfo } from './getEpochInfo.js';
+import { getEpochSchedule } from './getEpochSchedule.js';
+import { getFeeForMessage } from './getFeeForMessage.js';
+import { getFirstAvailableBlock } from './getFirstAvailableBlock.js';
+import { getGenesisHash } from './getGenesisHash.js';
+import { getHealth } from './getHealth.js';
+import { getHighestSnapshotSlot } from './getHighestSnapshotSlot.js';
+import { getIdentity } from './getIdentity.js';
+import { getInflationGovernor } from './getInflationGovernor.js';
+import { getInflationRate } from './getInflationRate.js';
+import { getInflationReward } from './getInflationReward.js';
+import { getLargestAccounts } from './getLargestAccounts.js';
+import { getLatestBlockhash } from './getLatestBlockhash.js';
+import { getLeaderSchedule } from './getLeaderSchedule.js';
+import { getMaxRetransmitSlot } from './getMaxRetransmitSlot.js';
+import { getMaxShredInsertSlot } from './getMaxShredInsertSlot.js';
+import { getMinimumBalanceForRentExemption } from './getMinimumBalanceForRentExemption.js';
+import { getMultipleAccounts } from './getMultipleAccounts.js';
+import { getProgramAccounts } from './getProgramAccounts.js';
+import { getRecentPerformanceSamples } from './getRecentPerformanceSamples.js';
+import { getRecentPrioritizationFees } from './getRecentPrioritizationFees.js';
+import { getSignatureStatuses } from './getSignatureStatuses.js';
+import { getSignaturesForAddress } from './getSignaturesForAddress.js';
+import { getSlot } from './getSlot.js';
+import { getSlotLeader } from './getSlotLeader.js';
+import { getSlotLeaders } from './getSlotLeaders.js';
+import { getSupply } from './getSupply.js';
+import { getTokenAccountBalance } from './getTokenAccountBalance.js';
+import { getTokenAccountsByDelegate } from './getTokenAccountsByDelegate.js';
+import { getTokenAccountsByOwner } from './getTokenAccountsByOwner.js';
+import { getTokenLargestAccounts } from './getTokenLargestAccounts.js';
+import { getTokenSupply } from './getTokenSupply.js';
+import { getTransaction } from './getTransaction.js';
+import { getTransactionCount } from './getTransactionCount.js';
+import { getVersion } from './getVersion.js';
+import { getVoteAccounts } from './getVoteAccounts.js';
+import { isBlockhashValid } from './isBlockhashValid.js';
+import { minimumLedgerSlot } from './minimumLedgerSlot.js';
+import { sendTransaction } from './sendTransaction.js';
+import { simulateTransaction } from './simulateTransaction.js';
+import { switchCluster } from './switchCluster.js';
+export * from './getAccountInfo.js';
+export * from './getBalance.js';
+export * from './getBlock.js';
+export * from './getBlockCommitment.js';
+export * from './getBlockHeight.js';
+export * from './getBlockProduction.js';
+export * from './getBlocks.js';
+export * from './getBlocksWithLimit.js';
+export * from './getBlockTime.js';
+export * from './getClusterNodes.js';
+export * from './getEpochInfo.js';
+export * from './getEpochSchedule.js';
+export * from './getFeeForMessage.js';
+export * from './getFirstAvailableBlock.js';
+export * from './getGenesisHash.js';
+export * from './getHealth.js';
+export * from './getHighestSnapshotSlot.js';
+export * from './getIdentity.js';
+export * from './getInflationGovernor.js';
+export * from './getInflationRate.js';
+export * from './getInflationReward.js';
+export * from './getLargestAccounts.js';
+export * from './getLatestBlockhash.js';
+export * from './getLeaderSchedule.js';
+export * from './getClusterName.js';
+export * from './getMaxRetransmitSlot.js';
+export * from './getMaxShredInsertSlot.js';
+export * from './getMinimumBalanceForRentExemption.js';
+export * from './getMultipleAccounts.js';
+export * from './getProgramAccounts.js';
+export * from './getRecentPerformanceSamples.js';
+export * from './getRecentPrioritizationFees.js';
+export * from './getSignatureStatuses.js';
+export * from './getSignaturesForAddress.js';
+export * from './getSlot.js';
+export * from './getSlotLeader.js';
+export * from './getSlotLeaders.js';
+export * from './getSupply.js';
+export * from './getTokenAccountBalance.js';
+export * from './getTokenAccountsByDelegate.js';
+export * from './getTokenAccountsByOwner.js';
+export * from './getTokenLargestAccounts.js';
+export * from './getTokenSupply.js';
+export * from './getTransaction.js';
+export * from './getTransactionCount.js';
+export * from './getVersion.js';
+export * from './getVoteAccounts.js';
+export * from './isBlockhashValid.js';
+export * from './minimumLedgerSlot.js';
+export * from './sendTransaction.js';
+export * from './simulateTransaction.js';
+export * from './switchCluster.js';
+export function actions(client) {
+    const _client = client;
+    return {
+        solana: {
+            getAccountInfo: (...params) => getAccountInfo(_client, ...params),
+            getBalance: (...params) => getBalance(_client, ...params),
+            getBlock: (...params) => getBlock(_client, ...params),
+            getBlockCommitment: (...params) => getBlockCommitment(_client, ...params),
+            getBlockHeight: (...params) => getBlockHeight(_client, ...params),
+            getBlockProduction: (...params) => getBlockProduction(_client, ...params),
+            getBlocks: (...params) => getBlocks(_client, ...params),
+            getBlocksWithLimit: (...params) => getBlocksWithLimit(_client, ...params),
+            getBlockTime: (...params) => getBlockTime(_client, ...params),
+            getClusterNodes: (...params) => getClusterNodes(_client, ...params),
+            getEpochInfo: (...params) => getEpochInfo(_client, ...params),
+            getEpochSchedule: (...params) => getEpochSchedule(_client, ...params),
+            getFeeForMessage: (...params) => getFeeForMessage(_client, ...params),
+            getFirstAvailableBlock: (...params) => getFirstAvailableBlock(_client, ...params),
+            getGenesisHash: (...params) => getGenesisHash(_client, ...params),
+            getHealth: (...params) => getHealth(_client, ...params),
+            getHighestSnapshotSlot: (...params) => getHighestSnapshotSlot(_client, ...params),
+            getIdentity: (...params) => getIdentity(_client, ...params),
+            getInflationGovernor: (...params) => getInflationGovernor(_client, ...params),
+            getInflationRate: (...params) => getInflationRate(_client, ...params),
+            getInflationReward: (...params) => getInflationReward(_client, ...params),
+            getLargestAccounts: (...params) => getLargestAccounts(_client, ...params),
+            getLatestBlockhash: (...params) => getLatestBlockhash(_client, ...params),
+            getLeaderSchedule: (...params) => getLeaderSchedule(_client, ...params),
+            getClusterName: (...params) => getClusterName(_client, ...params),
+            getMaxRetransmitSlot: (...params) => getMaxRetransmitSlot(_client, ...params),
+            getMaxShredInsertSlot: (...params) => getMaxShredInsertSlot(_client, ...params),
+            getMinimumBalanceForRentExemption: (...params) => getMinimumBalanceForRentExemption(_client, ...params),
+            getMultipleAccounts: (...params) => getMultipleAccounts(_client, ...params),
+            getProgramAccounts: (...params) => getProgramAccounts(_client, ...params),
+            getRecentPerformanceSamples: (...params) => getRecentPerformanceSamples(_client, ...params),
+            getRecentPrioritizationFees: (...params) => getRecentPrioritizationFees(_client, ...params),
+            getSignatureStatuses: (...params) => getSignatureStatuses(_client, ...params),
+            getSignaturesForAddress: (...params) => getSignaturesForAddress(_client, ...params),
+            getSlot: (...params) => getSlot(_client, ...params),
+            getSlotLeader: (...params) => getSlotLeader(_client, ...params),
+            getSlotLeaders: (...params) => getSlotLeaders(_client, ...params),
+            getSupply: (...params) => getSupply(_client, ...params),
+            getTokenAccountBalance: (...params) => getTokenAccountBalance(_client, ...params),
+            getTokenAccountsByDelegate: (...params) => getTokenAccountsByDelegate(_client, ...params),
+            getTokenAccountsByOwner: (...params) => getTokenAccountsByOwner(_client, ...params),
+            getTokenLargestAccounts: (...params) => getTokenLargestAccounts(_client, ...params),
+            getTokenSupply: (...params) => getTokenSupply(_client, ...params),
+            getTransaction: (...params) => getTransaction(_client, ...params),
+            getTransactionCount: (...params) => getTransactionCount(_client, ...params),
+            getVersion: (...params) => getVersion(_client, ...params),
+            getVoteAccounts: (...params) => getVoteAccounts(_client, ...params),
+            isBlockhashValid: (...params) => isBlockhashValid(_client, ...params),
+            minimumLedgerSlot: (...params) => minimumLedgerSlot(_client, ...params),
+            sendTransaction: (...params) => sendTransaction(_client, ...params),
+            simulateTransaction: (...params) => simulateTransaction(_client, ...params),
+            switchCluster: (...params) => switchCluster(_client, ...params),
+        },
+    };
+}

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

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

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

@@ -0,0 +1,76 @@
+// 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 { describe, expect, it, vi, beforeEach } from 'vitest';
+import { actions } from './index.js';
+describe('Solana actions', () => {
+    const mockClient = {
+        request: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should export all action functions', () => {
+        const actionFunctions = actions(mockClient);
+        expect(actionFunctions).toHaveProperty('solana');
+        expect(typeof actionFunctions.solana.getAccountInfo).toBe('function');
+        expect(typeof actionFunctions.solana.getBalance).toBe('function');
+        expect(typeof actionFunctions.solana.getBlock).toBe('function');
+        expect(typeof actionFunctions.solana.getBlockCommitment).toBe('function');
+        expect(typeof actionFunctions.solana.getBlockHeight).toBe('function');
+        expect(typeof actionFunctions.solana.getBlockProduction).toBe('function');
+        expect(typeof actionFunctions.solana.getBlocks).toBe('function');
+        expect(typeof actionFunctions.solana.getBlocksWithLimit).toBe('function');
+        expect(typeof actionFunctions.solana.getBlockTime).toBe('function');
+        expect(typeof actionFunctions.solana.getClusterName).toBe('function');
+        expect(typeof actionFunctions.solana.getClusterNodes).toBe('function');
+        expect(typeof actionFunctions.solana.getEpochInfo).toBe('function');
+        expect(typeof actionFunctions.solana.getEpochSchedule).toBe('function');
+        expect(typeof actionFunctions.solana.getFeeForMessage).toBe('function');
+        expect(typeof actionFunctions.solana.getFirstAvailableBlock).toBe('function');
+        expect(typeof actionFunctions.solana.getGenesisHash).toBe('function');
+        expect(typeof actionFunctions.solana.getHealth).toBe('function');
+        expect(typeof actionFunctions.solana.getHighestSnapshotSlot).toBe('function');
+        expect(typeof actionFunctions.solana.getIdentity).toBe('function');
+        expect(typeof actionFunctions.solana.getInflationGovernor).toBe('function');
+        expect(typeof actionFunctions.solana.getInflationRate).toBe('function');
+        expect(typeof actionFunctions.solana.getInflationReward).toBe('function');
+        expect(typeof actionFunctions.solana.getLargestAccounts).toBe('function');
+        expect(typeof actionFunctions.solana.getLatestBlockhash).toBe('function');
+        expect(typeof actionFunctions.solana.getLeaderSchedule).toBe('function');
+        expect(typeof actionFunctions.solana.getMaxRetransmitSlot).toBe('function');
+        expect(typeof actionFunctions.solana.getMaxShredInsertSlot).toBe('function');
+        expect(typeof actionFunctions.solana.getMinimumBalanceForRentExemption).toBe('function');
+        expect(typeof actionFunctions.solana.getMultipleAccounts).toBe('function');
+        expect(typeof actionFunctions.solana.getProgramAccounts).toBe('function');
+        expect(typeof actionFunctions.solana.getRecentPerformanceSamples).toBe('function');
+        expect(typeof actionFunctions.solana.getRecentPrioritizationFees).toBe('function');
+        expect(typeof actionFunctions.solana.getSignatureStatuses).toBe('function');
+        expect(typeof actionFunctions.solana.getSignaturesForAddress).toBe('function');
+        expect(typeof actionFunctions.solana.getSlot).toBe('function');
+        expect(typeof actionFunctions.solana.getSlotLeader).toBe('function');
+        expect(typeof actionFunctions.solana.getSlotLeaders).toBe('function');
+        expect(typeof actionFunctions.solana.getSupply).toBe('function');
+        expect(typeof actionFunctions.solana.getTokenAccountBalance).toBe('function');
+        expect(typeof actionFunctions.solana.getTokenAccountsByDelegate).toBe('function');
+        expect(typeof actionFunctions.solana.getTokenAccountsByOwner).toBe('function');
+        expect(typeof actionFunctions.solana.getTokenLargestAccounts).toBe('function');
+        expect(typeof actionFunctions.solana.getTokenSupply).toBe('function');
+        expect(typeof actionFunctions.solana.getTransaction).toBe('function');
+        expect(typeof actionFunctions.solana.getTransactionCount).toBe('function');
+        expect(typeof actionFunctions.solana.getVersion).toBe('function');
+        expect(typeof actionFunctions.solana.getVoteAccounts).toBe('function');
+        expect(typeof actionFunctions.solana.isBlockhashValid).toBe('function');
+        expect(typeof actionFunctions.solana.minimumLedgerSlot).toBe('function');
+        expect(typeof actionFunctions.solana.sendTransaction).toBe('function');
+        expect(typeof actionFunctions.solana.simulateTransaction).toBe('function');
+        expect(typeof actionFunctions.solana.switchCluster).toBe('function');
+    });
+});

package/dist/esm/providers/solana/actions/isBlockhashValid.d.ts

@@ -0,0 +1,15 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Checks if a blockhash is still valid
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_isBlockhashValid}
+ * @returns Promise resolving to blockhash validity status
+ */
+export declare function isBlockhashValid(client: ExtendedViemClient, ...params: Parameters<Provider['sol_isBlockhashValid']>): Promise<Readonly<{
+    context: Readonly<{
+        slot: import("@solana/rpc-types").Slot;
+    }>;
+    value: boolean;
+}>>;

package/dist/esm/providers/solana/actions/isBlockhashValid.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.
+/**
+ * Checks if a blockhash is still valid
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_isBlockhashValid}
+ * @returns Promise resolving to blockhash validity status
+ */
+export async function isBlockhashValid(client, ...params) {
+    return await client.request({ method: 'sol_isBlockhashValid', params });
+}

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

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

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

@@ -0,0 +1,32 @@
+// 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 { blockhash } from '@solana/kit';
+import { describe, expect, it, vi, beforeEach } from 'vitest';
+import { isBlockhashValid } from './isBlockhashValid.js';
+describe('isBlockhashValid', () => {
+    const mockClient = {
+        request: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should forward all parameters to client.request', async () => {
+        const hash = blockhash('5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d');
+        const mockResponse = {};
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await isBlockhashValid(mockClient, hash);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_isBlockhashValid',
+            params: [hash],
+        });
+        expect(result).toBe(mockResponse);
+    });
+});

package/dist/esm/providers/solana/actions/minimumLedgerSlot.d.ts

@@ -0,0 +1,10 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Gets the minimum ledger slot that the node has information about
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_minimumLedgerSlot}
+ * @returns Promise resolving to minimum ledger slot number
+ */
+export declare function minimumLedgerSlot(client: ExtendedViemClient, ...params: Parameters<Provider['sol_minimumLedgerSlot']>): Promise<bigint>;

package/dist/esm/providers/solana/actions/minimumLedgerSlot.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 minimum ledger slot that the node has information about
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_minimumLedgerSlot}
+ * @returns Promise resolving to minimum ledger slot number
+ */
+export async function minimumLedgerSlot(client, ...params) {
+    return await client.request({ method: 'sol_minimumLedgerSlot', params });
+}

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

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

package/dist/esm/providers/solana/actions/minimumLedgerSlot.test.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 { describe, expect, it, vi, beforeEach } from 'vitest';
+import { minimumLedgerSlot } from './minimumLedgerSlot.js';
+describe('minimumLedgerSlot', () => {
+    const mockClient = {
+        request: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should forward all parameters to client.request', async () => {
+        const mockResponse = {};
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await minimumLedgerSlot(mockClient);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_minimumLedgerSlot',
+            params: [],
+        });
+        expect(result).toBe(mockResponse);
+    });
+});

package/dist/esm/providers/solana/actions/sendTransaction.d.ts

@@ -0,0 +1,13 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Submits a signed transaction to the cluster for processing
+ *
+ * @param client - Extended Viem client
+ * @param tx - The transaction to send
+ * @param config - Optional configuration for the transaction
+ * @returns Promise resolving to transaction signature
+ */
+export declare function sendTransaction(client: ExtendedViemClient, tx: Parameters<Provider['sol_sendTransaction']>[0] | string | Buffer, config?: Parameters<Provider['sol_sendTransaction']>[1] & {
+    encoding?: 'base64';
+}): Promise<import("@solana/keys").Signature>;

package/dist/esm/providers/solana/actions/sendTransaction.js

@@ -0,0 +1,27 @@
+// 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 { toBase64EncodedWireTransaction } from '../utils/toBase64EncodedWireTransaction.js';
+/**
+ * Submits a signed transaction to the cluster for processing
+ *
+ * @param client - Extended Viem client
+ * @param tx - The transaction to send
+ * @param config - Optional configuration for the transaction
+ * @returns Promise resolving to transaction signature
+ */
+export async function sendTransaction(client, tx, config) {
+    const _tx = toBase64EncodedWireTransaction(tx);
+    const _config = { ...config, encoding: 'base64' };
+    return await client.request({
+        method: 'sol_sendTransaction',
+        params: [_tx, _config],
+    });
+}

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

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

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

@@ -0,0 +1,80 @@
+// 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 { describe, expect, it, vi, beforeEach } from 'vitest';
+import { sendTransaction } from './sendTransaction.js';
+describe('sendTransaction', () => {
+    const mockClient = {
+        request: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should call client.request with base64 encoded transaction', async () => {
+        const txBase64 = 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDArczbMIA1sNQiUQLoupO4LkRSz2nUOUt9sQ3PQ86KLuwmPCLOHSyXQhgbFxBjuDCfN6xAwGzw8tq7DjJHMLtLmIL1lOH8RBJb+HrcBl6aLNBKm6JY9LPK1pQ8RYNG6i8';
+        const config = { encoding: 'base64', maxRetries: 3n, skipPreflight: false };
+        const mockResponse = '4rGAF3VxoNTMWRcEq5QwJ5mFN6aHNdJ4jKPJ6J5Ac4JJP7iEcRRXQ7';
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await sendTransaction(mockClient, txBase64, config);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_sendTransaction',
+            params: [txBase64, { ...config, encoding: 'base64' }],
+        });
+        expect(result).toBe(mockResponse);
+    });
+    it('should handle Buffer input and convert to base64', async () => {
+        const txBuffer = Buffer.from('test transaction data', 'utf8');
+        const expectedBase64 = txBuffer.toString('base64');
+        const mockResponse = '4rGAF3VxoNTMWRcEq5QwJ5mFN6aHNdJ4jKPJ6J5Ac4JJP7iEcRRXQ7';
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        await sendTransaction(mockClient, txBuffer);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_sendTransaction',
+            params: [expectedBase64, { encoding: 'base64' }],
+        });
+    });
+    it('should handle string input directly', async () => {
+        const txString = 'test-transaction-string';
+        const mockResponse = '4rGAF3VxoNTMWRcEq5QwJ5mFN6aHNdJ4jKPJ6J5Ac4JJP7iEcRRXQ7';
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        await sendTransaction(mockClient, txString);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_sendTransaction',
+            params: [txString, { encoding: 'base64' }],
+        });
+    });
+    it('should override encoding to base64 even if provided in config', async () => {
+        const txBase64 = 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDArczbMIA1sNQiUQLoupO4LkRSz2nUOUt9sQ3PQ86KLuwmPCLOHSyXQhgbFxBjuDCfN6xAwGzw8tq7DjJHMLtLmIL1lOH8RBJb+HrcBl6aLNBKm6JY9LPK1pQ8RYNG6i8';
+        // Create a config with a different encoding to test that it gets overridden
+        const config = { encoding: 'hex', maxRetries: 3n };
+        vi.mocked(mockClient.request).mockResolvedValue('signature');
+        // Cast to bypass the type constraint since we're testing the override behavior
+        await sendTransaction(mockClient, txBase64, config);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_sendTransaction',
+            params: [txBase64, { ...config, encoding: 'base64' }],
+        });
+    });
+    it('should work without config parameter', async () => {
+        const txBase64 = 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDArczbMIA1sNQiUQLoupO4LkRSz2nUOUt9sQ3PQ86KLuwmPCLOHSyXQhgbFxBjuDCfN6xAwGzw8tq7DjJHMLtLmIL1lOH8RBJb+HrcBl6aLNBKm6JY9LPK1pQ8RYNG6i8';
+        vi.mocked(mockClient.request).mockResolvedValue('signature');
+        await sendTransaction(mockClient, txBase64);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_sendTransaction',
+            params: [txBase64, { encoding: 'base64' }],
+        });
+    });
+    it('should handle request errors', async () => {
+        const txBase64 = 'invalid-transaction';
+        const error = new Error('RPC Error');
+        vi.mocked(mockClient.request).mockRejectedValue(error);
+        await expect(sendTransaction(mockClient, txBase64)).rejects.toThrow('RPC Error');
+    });
+});

package/dist/esm/providers/solana/actions/simulateTransaction.d.ts

@@ -0,0 +1,28 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Simulates a transaction to get a preview of its effects
+ *
+ * @param client - Extended Viem client
+ * @param tx - Transaction to simulate
+ * @param config - Optional configuration for {@link sol_simulateTransaction}
+ * @returns Promise resolving to transaction simulation results
+ */
+export declare function simulateTransaction(client: ExtendedViemClient, tx: Parameters<Provider['sol_simulateTransaction']>[0] | string | Buffer, config?: Parameters<Provider['sol_simulateTransaction']>[1] & {
+    encoding?: 'base64';
+}): Promise<Readonly<{
+    context: Readonly<{
+        slot: import("@solana/rpc-types").Slot;
+    }>;
+    value: Readonly<{
+        readonly accounts: null;
+    }> & Readonly<{
+        err: import("@solana/rpc-types").TransactionError | null;
+        logs: string[] | null;
+        returnData: Readonly<{
+            data: import("@solana/rpc-types").Base64EncodedDataResponse;
+            programId: import("@solana/addresses").Address;
+        }> | null;
+        unitsConsumed?: bigint;
+    }>;
+}>>;

package/dist/esm/providers/solana/actions/simulateTransaction.js

@@ -0,0 +1,27 @@
+// 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 { toBase64EncodedWireTransaction } from '../utils/toBase64EncodedWireTransaction.js';
+/**
+ * Simulates a transaction to get a preview of its effects
+ *
+ * @param client - Extended Viem client
+ * @param tx - Transaction to simulate
+ * @param config - Optional configuration for {@link sol_simulateTransaction}
+ * @returns Promise resolving to transaction simulation results
+ */
+export async function simulateTransaction(client, tx, config) {
+    const _tx = toBase64EncodedWireTransaction(tx);
+    const _config = { ...config, encoding: 'base64' };
+    return await client.request({
+        method: 'sol_simulateTransaction',
+        params: [_tx, _config],
+    });
+}

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

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