@circle-fin/usdckit 0.21.1 → 0.23.0

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

@@ -0,0 +1,32 @@
+"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 vitest_1 = require("vitest");
+const minimumLedgerSlot_js_1 = require("./minimumLedgerSlot.js");
+(0, vitest_1.describe)('minimumLedgerSlot', () => {
+    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 mockResponse = {};
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await (0, minimumLedgerSlot_js_1.minimumLedgerSlot)(mockClient);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_minimumLedgerSlot',
+            params: [],
+        });
+        (0, vitest_1.expect)(result).toBe(mockResponse);
+    });
+});

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

@@ -0,0 +1,30 @@
+"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.sendTransaction = sendTransaction;
+const toBase64EncodedWireTransaction_js_1 = require("../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
+ */
+async function sendTransaction(client, tx, config) {
+    const _tx = (0, toBase64EncodedWireTransaction_js_1.toBase64EncodedWireTransaction)(tx);
+    const _config = { ...config, encoding: 'base64' };
+    return await client.request({
+        method: 'sol_sendTransaction',
+        params: [_tx, _config],
+    });
+}

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

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

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

@@ -0,0 +1,82 @@
+"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 vitest_1 = require("vitest");
+const sendTransaction_js_1 = require("./sendTransaction.js");
+(0, vitest_1.describe)('sendTransaction', () => {
+    const mockClient = {
+        request: vitest_1.vi.fn(),
+    };
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.resetAllMocks();
+    });
+    (0, vitest_1.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';
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await (0, sendTransaction_js_1.sendTransaction)(mockClient, txBase64, config);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_sendTransaction',
+            params: [txBase64, { ...config, encoding: 'base64' }],
+        });
+        (0, vitest_1.expect)(result).toBe(mockResponse);
+    });
+    (0, vitest_1.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';
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        await (0, sendTransaction_js_1.sendTransaction)(mockClient, txBuffer);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_sendTransaction',
+            params: [expectedBase64, { encoding: 'base64' }],
+        });
+    });
+    (0, vitest_1.it)('should handle string input directly', async () => {
+        const txString = 'test-transaction-string';
+        const mockResponse = '4rGAF3VxoNTMWRcEq5QwJ5mFN6aHNdJ4jKPJ6J5Ac4JJP7iEcRRXQ7';
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        await (0, sendTransaction_js_1.sendTransaction)(mockClient, txString);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_sendTransaction',
+            params: [txString, { encoding: 'base64' }],
+        });
+    });
+    (0, vitest_1.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 };
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue('signature');
+        // Cast to bypass the type constraint since we're testing the override behavior
+        await (0, sendTransaction_js_1.sendTransaction)(mockClient, txBase64, config);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_sendTransaction',
+            params: [txBase64, { ...config, encoding: 'base64' }],
+        });
+    });
+    (0, vitest_1.it)('should work without config parameter', async () => {
+        const txBase64 = 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDArczbMIA1sNQiUQLoupO4LkRSz2nUOUt9sQ3PQ86KLuwmPCLOHSyXQhgbFxBjuDCfN6xAwGzw8tq7DjJHMLtLmIL1lOH8RBJb+HrcBl6aLNBKm6JY9LPK1pQ8RYNG6i8';
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue('signature');
+        await (0, sendTransaction_js_1.sendTransaction)(mockClient, txBase64);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_sendTransaction',
+            params: [txBase64, { encoding: 'base64' }],
+        });
+    });
+    (0, vitest_1.it)('should handle request errors', async () => {
+        const txBase64 = 'invalid-transaction';
+        const error = new Error('RPC Error');
+        vitest_1.vi.mocked(mockClient.request).mockRejectedValue(error);
+        await (0, vitest_1.expect)((0, sendTransaction_js_1.sendTransaction)(mockClient, txBase64)).rejects.toThrow('RPC Error');
+    });
+});

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

@@ -0,0 +1,30 @@
+"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.simulateTransaction = simulateTransaction;
+const toBase64EncodedWireTransaction_js_1 = require("../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
+ */
+async function simulateTransaction(client, tx, config) {
+    const _tx = (0, toBase64EncodedWireTransaction_js_1.toBase64EncodedWireTransaction)(tx);
+    const _config = { ...config, encoding: 'base64' };
+    return await client.request({
+        method: 'sol_simulateTransaction',
+        params: [_tx, _config],
+    });
+}

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

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

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

@@ -0,0 +1,82 @@
+"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 vitest_1 = require("vitest");
+const simulateTransaction_js_1 = require("./simulateTransaction.js");
+(0, vitest_1.describe)('simulateTransaction', () => {
+    const mockClient = {
+        request: vitest_1.vi.fn(),
+    };
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.resetAllMocks();
+    });
+    (0, vitest_1.it)('should call client.request with base64 encoded transaction', async () => {
+        const txBase64 = 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDArczbMIA1sNQiUQLoupO4LkRSz2nUOUt9sQ3PQ86KLuwmPCLOHSyXQhgbFxBjuDCfN6xAwGzw8tq7DjJHMLtLmIL1lOH8RBJb+HrcBl6aLNBKm6JY9LPK1pQ8RYNG6i8';
+        const config = { commitment: 'confirmed', replaceRecentBlockhash: true, encoding: 'base64' };
+        const mockResponse = { value: { err: null, logs: [], accounts: null } };
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await (0, simulateTransaction_js_1.simulateTransaction)(mockClient, txBase64, config);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_simulateTransaction',
+            params: [txBase64, { ...config, encoding: 'base64' }],
+        });
+        (0, vitest_1.expect)(result).toBe(mockResponse);
+    });
+    (0, vitest_1.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 = { value: { err: null, logs: [], accounts: null } };
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        await (0, simulateTransaction_js_1.simulateTransaction)(mockClient, txBuffer);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_simulateTransaction',
+            params: [expectedBase64, { encoding: 'base64' }],
+        });
+    });
+    (0, vitest_1.it)('should handle string input directly', async () => {
+        const txString = 'test-transaction-string';
+        const mockResponse = { value: { err: null, logs: [], accounts: null } };
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        await (0, simulateTransaction_js_1.simulateTransaction)(mockClient, txString);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_simulateTransaction',
+            params: [txString, { encoding: 'base64' }],
+        });
+    });
+    (0, vitest_1.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', commitment: 'confirmed', sigVerify: false };
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue({ value: { err: null } });
+        // Cast to bypass the type constraint since we're testing the override behavior
+        await (0, simulateTransaction_js_1.simulateTransaction)(mockClient, txBase64, config);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_simulateTransaction',
+            params: [txBase64, { ...config, encoding: 'base64' }],
+        });
+    });
+    (0, vitest_1.it)('should work without config parameter', async () => {
+        const txBase64 = 'AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAEDArczbMIA1sNQiUQLoupO4LkRSz2nUOUt9sQ3PQ86KLuwmPCLOHSyXQhgbFxBjuDCfN6xAwGzw8tq7DjJHMLtLmIL1lOH8RBJb+HrcBl6aLNBKm6JY9LPK1pQ8RYNG6i8';
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue({ value: { err: null } });
+        await (0, simulateTransaction_js_1.simulateTransaction)(mockClient, txBase64);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_simulateTransaction',
+            params: [txBase64, { encoding: 'base64' }],
+        });
+    });
+    (0, vitest_1.it)('should handle request errors', async () => {
+        const txBase64 = 'invalid-transaction';
+        const error = new Error('RPC Error');
+        vitest_1.vi.mocked(mockClient.request).mockRejectedValue(error);
+        await (0, vitest_1.expect)((0, simulateTransaction_js_1.simulateTransaction)(mockClient, txBase64)).rejects.toThrow('RPC Error');
+    });
+});

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

@@ -0,0 +1,10 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Switches the active cluster endpoint for Solana operations
+ *
+ * @param client - Extended Viem client
+ * @param clusterName - Cluster name to switch to
+ * @returns Promise resolving to the new RPC client
+ */
+export declare function switchCluster(client: ExtendedViemClient, clusterName: Parameters<Provider['sol_switchCluster']>[0]): Promise<import("@solana/rpc-spec").Rpc<import("@solana/rpc-api").GetAccountInfoApi & import("@solana/rpc-api").GetBalanceApi & import("@solana/rpc-api").GetBlockApi & import("@solana/rpc-api").GetBlockCommitmentApi & import("@solana/rpc-api").GetBlockHeightApi & import("@solana/rpc-api").GetBlockProductionApi & import("@solana/rpc-api").GetBlocksApi & import("@solana/rpc-api").GetBlocksWithLimitApi & import("@solana/rpc-api").GetBlockTimeApi & import("@solana/rpc-api").GetClusterNodesApi & import("@solana/rpc-api").GetEpochInfoApi & import("@solana/rpc-api").GetEpochScheduleApi & import("@solana/rpc-api").GetFeeForMessageApi & import("@solana/rpc-api").GetFirstAvailableBlockApi & import("@solana/rpc-api").GetGenesisHashApi & import("@solana/rpc-api").GetHealthApi & import("@solana/rpc-api").GetHighestSnapshotSlotApi & import("@solana/rpc-api").GetIdentityApi & import("@solana/rpc-api").GetInflationGovernorApi & import("@solana/rpc-api").GetInflationRateApi & import("@solana/rpc-api").GetInflationRewardApi & import("@solana/rpc-api").GetLargestAccountsApi & import("@solana/rpc-api").GetLatestBlockhashApi & import("@solana/rpc-api").GetLeaderScheduleApi & import("@solana/rpc-api").GetMaxRetransmitSlotApi & import("@solana/rpc-api").GetMaxShredInsertSlotApi & import("@solana/rpc-api").GetMinimumBalanceForRentExemptionApi & import("@solana/rpc-api").GetMultipleAccountsApi & import("@solana/rpc-api").GetProgramAccountsApi & import("@solana/rpc-api").GetRecentPerformanceSamplesApi & import("@solana/rpc-api").GetRecentPrioritizationFeesApi & import("@solana/rpc-api").GetSignaturesForAddressApi & import("@solana/rpc-api").GetSignatureStatusesApi & import("@solana/rpc-api").GetSlotApi & import("@solana/rpc-api").GetSlotLeaderApi & import("@solana/rpc-api").GetSlotLeadersApi & import("@solana/rpc-api").GetStakeMinimumDelegationApi & import("@solana/rpc-api").GetSupplyApi & import("@solana/rpc-api").GetTokenAccountBalanceApi & import("@solana/rpc-api").GetTokenAccountsByDelegateApi & import("@solana/rpc-api").GetTokenAccountsByOwnerApi & import("@solana/rpc-api").GetTokenLargestAccountsApi & import("@solana/rpc-api").GetTokenSupplyApi & import("@solana/rpc-api").GetTransactionApi & import("@solana/rpc-api").GetTransactionCountApi & import("@solana/rpc-api").GetVersionApi & import("@solana/rpc-api").GetVoteAccountsApi & import("@solana/rpc-api").IsBlockhashValidApi & import("@solana/rpc-api").MinimumLedgerSlotApi & import("@solana/rpc-api").SendTransactionApi & import("@solana/rpc-api").SimulateTransactionApi>>;

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

@@ -0,0 +1,26 @@
+"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.switchCluster = switchCluster;
+/**
+ * Switches the active cluster endpoint for Solana operations
+ *
+ * @param client - Extended Viem client
+ * @param clusterName - Cluster name to switch to
+ * @returns Promise resolving to the new RPC client
+ */
+async function switchCluster(client, clusterName) {
+    return await client.request({
+        method: 'sol_switchCluster',
+        params: [clusterName],
+    });
+}

package/dist/cjs/providers/solana/actions/switchCluster.test.d.ts

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

package/dist/cjs/providers/solana/actions/switchCluster.test.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 });
+const vitest_1 = require("vitest");
+const switchCluster_js_1 = require("./switchCluster.js");
+(0, vitest_1.describe)('switchCluster', () => {
+    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 clusterName = 'mainnet-beta';
+        const mockResponse = {};
+        vitest_1.vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await (0, switchCluster_js_1.switchCluster)(mockClient, clusterName);
+        (0, vitest_1.expect)(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_switchCluster',
+            params: [clusterName],
+        });
+        (0, vitest_1.expect)(result).toBe(mockResponse);
+    });
+});

package/dist/cjs/providers/solana/constants.d.ts

@@ -0,0 +1,6 @@
+export { TOKEN_PROGRAM_ADDRESS, ASSOCIATED_TOKEN_PROGRAM_ADDRESS } from '@solana-program/token';
+export { TOKEN_2022_PROGRAM_ADDRESS } from '@solana-program/token-2022';
+/** Address of the special mint for wrapped native SOL in spl-token */
+export declare const NATIVE_MINT_ADDRESS: import("@solana/kit").Address<"So11111111111111111111111111111111111111112">;
+/** Address of the special mint for wrapped native SOL in spl-token-2022 */
+export declare const NATIVE_MINT_2022_ADDRESS: import("@solana/kit").Address<"9pan9bMn5HatX4EJdBwg9VgCa7Uz5HL8N1m5D3NdXejP">;

package/dist/cjs/providers/solana/constants.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.NATIVE_MINT_2022_ADDRESS = exports.NATIVE_MINT_ADDRESS = exports.TOKEN_2022_PROGRAM_ADDRESS = exports.ASSOCIATED_TOKEN_PROGRAM_ADDRESS = exports.TOKEN_PROGRAM_ADDRESS = void 0;
+const kit_1 = require("@solana/kit");
+var token_1 = require("@solana-program/token");
+Object.defineProperty(exports, "TOKEN_PROGRAM_ADDRESS", { enumerable: true, get: function () { return token_1.TOKEN_PROGRAM_ADDRESS; } });
+Object.defineProperty(exports, "ASSOCIATED_TOKEN_PROGRAM_ADDRESS", { enumerable: true, get: function () { return token_1.ASSOCIATED_TOKEN_PROGRAM_ADDRESS; } });
+var token_2022_1 = require("@solana-program/token-2022");
+Object.defineProperty(exports, "TOKEN_2022_PROGRAM_ADDRESS", { enumerable: true, get: function () { return token_2022_1.TOKEN_2022_PROGRAM_ADDRESS; } });
+/** Address of the special mint for wrapped native SOL in spl-token */
+exports.NATIVE_MINT_ADDRESS = (0, kit_1.address)('So11111111111111111111111111111111111111112');
+/** Address of the special mint for wrapped native SOL in spl-token-2022 */
+exports.NATIVE_MINT_2022_ADDRESS = (0, kit_1.address)('9pan9bMn5HatX4EJdBwg9VgCa7Uz5HL8N1m5D3NdXejP');

package/dist/cjs/providers/solana/index.d.ts

@@ -0,0 +1,101 @@
+export declare const NAME = "solana";
+export declare const SUPPORTED_CHAINS: readonly [{
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Solscan";
+            readonly url: "https://solscan.io/";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts: {
+        readonly USDC: {
+            readonly address: import("abitype").Address;
+            readonly read: {
+                readonly decimals: () => 6;
+            };
+        };
+        readonly EURC: {
+            readonly address: import("abitype").Address;
+            readonly read: {
+                readonly decimals: () => 6;
+            };
+        };
+    };
+    ensTlds?: readonly string[] | undefined;
+    id: number;
+    name: "Solana Mainnet";
+    nativeCurrency: {
+        readonly decimals: 9;
+        readonly name: "Solana";
+        readonly symbol: "SOL";
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://api.mainnet-beta.solana.com"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet?: boolean | undefined | undefined;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+    readonly blockchainId: "SOL";
+    readonly blockchainVm: "SVM";
+}, {
+    blockExplorers: {
+        readonly default: {
+            readonly name: "Solscan";
+            readonly url: "https://solscan.io/?cluster=devnet";
+        };
+    };
+    blockTime?: number | undefined | undefined;
+    contracts: {
+        readonly USDC: {
+            readonly address: import("abitype").Address;
+            readonly abi: undefined;
+            readonly read: {
+                readonly decimals: () => 6;
+            };
+        };
+        readonly EURC: {
+            readonly address: import("abitype").Address;
+            readonly read: {
+                readonly decimals: () => 6;
+            };
+        };
+    };
+    ensTlds?: readonly string[] | undefined;
+    id: number;
+    name: "Solana Devnet";
+    nativeCurrency: {
+        readonly decimals: 9;
+        readonly name: "Solana";
+        readonly symbol: "SOL";
+    };
+    experimental_preconfirmationTime?: number | undefined | undefined;
+    rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://api.devnet.solana.com"];
+        };
+    };
+    sourceId?: number | undefined | undefined;
+    testnet: true;
+    custom?: Record<string, unknown> | undefined;
+    fees?: import("viem").ChainFees<undefined> | undefined;
+    formatters?: undefined;
+    serializers?: import("viem").ChainSerializers<undefined, import("viem").TransactionSerializable> | undefined;
+    readonly blockchainId: "SOL-DEVNET";
+    readonly blockchainVm: "SVM";
+}];
+export type Chain = (typeof SUPPORTED_CHAINS)[number];
+export declare function extractChain<const chains extends Chain[], chain extends chains[number], chainId extends chain['id']>({ id, }: {
+    id: chainId;
+}): Extract<chain, {
+    id: chainId;
+}>;
+export * from './actions/index.js';
+export * from './constants.js';
+export * from './transports/index.js';
+export * from './utils/index.js';

package/dist/cjs/providers/solana/index.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.
+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 });
+exports.SUPPORTED_CHAINS = exports.NAME = void 0;
+exports.extractChain = extractChain;
+const index_js_1 = require("../../chains/index.js");
+const extractChain_js_1 = require("../../extractChain.js");
+exports.NAME = 'solana';
+exports.SUPPORTED_CHAINS = [index_js_1.SOL, index_js_1.SOL_DEVNET];
+function extractChain({ id, }) {
+    return (0, extractChain_js_1.extractChain)({ id, chains: exports.SUPPORTED_CHAINS });
+}
+__exportStar(require("./actions/index.js"), exports);
+__exportStar(require("./constants.js"), exports);
+__exportStar(require("./transports/index.js"), exports);
+__exportStar(require("./utils/index.js"), exports);

package/dist/cjs/providers/solana/index.test.d.ts

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