@circle-fin/usdckit 0.21.0 → 0.22.0

package/dist/cjs/providers/solana/transports/index.js

@@ -0,0 +1,205 @@
+"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.Provider = exports.http = void 0;
+var http_js_1 = require("./http.js");
+Object.defineProperty(exports, "http", { enumerable: true, get: function () { return http_js_1.http; } });
+const kit_1 = require("@solana/kit");
+const raise_js_1 = require("../../../utils/raise.js");
+const index_js_1 = require("../../index.js");
+/**
+ * Solana Provider that implements EIP-1193 interface for Solana RPC methods
+ *
+ * {@link https://solana.com/docs/rpc/http | Solana JSON-RPC HTTP API Reference}
+ */
+class Provider extends index_js_1.Provider {
+    _clusters;
+    constructor({ clusters = {
+        devnet: (0, kit_1.createSolanaRpc)('https://api.devnet.solana.com'),
+        'mainnet-beta': (0, kit_1.createSolanaRpc)('https://api.mainnet-beta.solana.com'),
+    }, }) {
+        super();
+        const clustersEntries = Object.entries(clusters);
+        if (clustersEntries.length === 0) {
+            throw new Error('At least one cluster must be provided');
+        }
+        this._clusters = new Map(clustersEntries);
+        this.sol_switchCluster(clustersEntries[0][0]);
+    }
+    sol_getClusterName() {
+        const currentCluster = this.cluster;
+        for (const [id, cluster] of this._clusters.entries()) {
+            if (id !== undefined && cluster === currentCluster)
+                return id;
+        }
+        throw new Error('Cluster not found');
+    }
+    sol_switchCluster(clusterName) {
+        const cluster = this._clusters.get(clusterName) ?? (0, raise_js_1.raise)(new Error(`Cluster '${clusterName}' not found`));
+        this._clusters.set(undefined, cluster);
+        return cluster;
+    }
+    get cluster() {
+        return this._clusters.get(undefined);
+    }
+    async sol_getAccountInfo(...params) {
+        return await this.cluster.getAccountInfo(...params).send();
+    }
+    async sol_getBalance(...params) {
+        return await this.cluster.getBalance(...params).send();
+    }
+    async sol_getBlock(...params) {
+        return await this.cluster.getBlock(...params).send();
+    }
+    async sol_getBlockCommitment(...params) {
+        return await this.cluster.getBlockCommitment(...params).send();
+    }
+    async sol_getBlockHeight(...params) {
+        return await this.cluster.getBlockHeight(...params).send();
+    }
+    async sol_getBlockProduction(...params) {
+        return await this.cluster.getBlockProduction(...params).send();
+    }
+    async sol_getBlocks(...params) {
+        return await this.cluster.getBlocks(...params).send();
+    }
+    async sol_getBlocksWithLimit(...params) {
+        return await this.cluster.getBlocksWithLimit(...params).send();
+    }
+    async sol_getBlockTime(...params) {
+        return await this.cluster.getBlockTime(...params).send();
+    }
+    async sol_getClusterNodes(...params) {
+        return await this.cluster.getClusterNodes(...params).send();
+    }
+    async sol_getEpochInfo(...params) {
+        return await this.cluster.getEpochInfo(...params).send();
+    }
+    async sol_getEpochSchedule(...params) {
+        return await this.cluster.getEpochSchedule(...params).send();
+    }
+    async sol_getFeeForMessage(...params) {
+        return await this.cluster.getFeeForMessage(...params).send();
+    }
+    async sol_getFirstAvailableBlock(...params) {
+        return await this.cluster.getFirstAvailableBlock(...params).send();
+    }
+    async sol_getGenesisHash(...params) {
+        return await this.cluster.getGenesisHash(...params).send();
+    }
+    async sol_getHealth(...params) {
+        return await this.cluster.getHealth(...params).send();
+    }
+    async sol_getHighestSnapshotSlot(...params) {
+        return await this.cluster.getHighestSnapshotSlot(...params).send();
+    }
+    async sol_getIdentity(...params) {
+        return await this.cluster.getIdentity(...params).send();
+    }
+    async sol_getInflationGovernor(...params) {
+        return await this.cluster.getInflationGovernor(...params).send();
+    }
+    async sol_getInflationRate(...params) {
+        return await this.cluster.getInflationRate(...params).send();
+    }
+    async sol_getInflationReward(...params) {
+        return await this.cluster.getInflationReward(...params).send();
+    }
+    async sol_getLargestAccounts(...params) {
+        return await this.cluster.getLargestAccounts(...params).send();
+    }
+    async sol_getLatestBlockhash(...params) {
+        return await this.cluster.getLatestBlockhash(...params).send();
+    }
+    async sol_getLeaderSchedule(...params) {
+        return await this.cluster.getLeaderSchedule(...params).send();
+    }
+    async sol_getMaxRetransmitSlot(...params) {
+        return await this.cluster.getMaxRetransmitSlot(...params).send();
+    }
+    async sol_getMaxShredInsertSlot(...params) {
+        return await this.cluster.getMaxShredInsertSlot(...params).send();
+    }
+    async sol_getMinimumBalanceForRentExemption(...params) {
+        return await this.cluster.getMinimumBalanceForRentExemption(...params).send();
+    }
+    async sol_getMultipleAccounts(...params) {
+        return await this.cluster.getMultipleAccounts(...params).send();
+    }
+    async sol_getProgramAccounts(...params) {
+        return await this.cluster.getProgramAccounts(...params).send();
+    }
+    async sol_getRecentPerformanceSamples(...params) {
+        return await this.cluster.getRecentPerformanceSamples(...params).send();
+    }
+    async sol_getRecentPrioritizationFees(...params) {
+        return await this.cluster.getRecentPrioritizationFees(...params).send();
+    }
+    async sol_getSignaturesForAddress(...params) {
+        return await this.cluster.getSignaturesForAddress(...params).send();
+    }
+    async sol_getSignatureStatuses(...params) {
+        return await this.cluster.getSignatureStatuses(...params).send();
+    }
+    async sol_getSlot(...params) {
+        return await this.cluster.getSlot(...params).send();
+    }
+    async sol_getSlotLeader(...params) {
+        return await this.cluster.getSlotLeader(...params).send();
+    }
+    async sol_getSlotLeaders(...params) {
+        return await this.cluster.getSlotLeaders(...params).send();
+    }
+    async sol_getSupply(...params) {
+        return await this.cluster.getSupply(...params).send();
+    }
+    async sol_getTokenAccountBalance(...params) {
+        return await this.cluster.getTokenAccountBalance(...params).send();
+    }
+    async sol_getTokenAccountsByDelegate(...params) {
+        return await this.cluster.getTokenAccountsByDelegate(...params).send();
+    }
+    async sol_getTokenAccountsByOwner(...params) {
+        return await this.cluster.getTokenAccountsByOwner(...params).send();
+    }
+    async sol_getTokenLargestAccounts(...params) {
+        return await this.cluster.getTokenLargestAccounts(...params).send();
+    }
+    async sol_getTokenSupply(...params) {
+        return await this.cluster.getTokenSupply(...params).send();
+    }
+    async sol_getTransaction(...params) {
+        return await this.cluster.getTransaction(...params).send();
+    }
+    async sol_getTransactionCount(...params) {
+        return await this.cluster.getTransactionCount(...params).send();
+    }
+    async sol_getVersion(...params) {
+        return await this.cluster.getVersion(...params).send();
+    }
+    async sol_getVoteAccounts(...params) {
+        return await this.cluster.getVoteAccounts(...params).send();
+    }
+    async sol_isBlockhashValid(...params) {
+        return await this.cluster.isBlockhashValid(...params).send();
+    }
+    async sol_minimumLedgerSlot(...params) {
+        return await this.cluster.minimumLedgerSlot(...params).send();
+    }
+    async sol_sendTransaction(...params) {
+        return await this.cluster.sendTransaction(...params).send();
+    }
+    async sol_simulateTransaction(...params) {
+        return await this.cluster.simulateTransaction(...params).send();
+    }
+}
+exports.Provider = Provider;

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

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

package/dist/cjs/providers/solana/transports/index.test.js

@@ -0,0 +1,307 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const kit_1 = require("@solana/kit");
+const vitest_1 = require("vitest");
+const mod = __importStar(require("./index.js"));
+const index_js_1 = require("./index.js");
+// Mock @solana/kit
+vitest_1.vi.mock('@solana/kit', async (importOriginal) => ({
+    ...(await importOriginal()),
+    createSolanaRpc: vitest_1.vi.fn(() => ({})),
+}));
+(0, vitest_1.describe)('solana transports index', () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.resetAllMocks();
+    });
+    (0, vitest_1.it)('should export http function', () => {
+        (0, vitest_1.expect)(mod.http).toBeDefined();
+        (0, vitest_1.expect)(mod.http).toEqual(vitest_1.expect.any(Function));
+    });
+    (0, vitest_1.it)('should export Provider class', () => {
+        (0, vitest_1.expect)(mod.Provider).toBeDefined();
+        (0, vitest_1.expect)(mod.Provider).toEqual(vitest_1.expect.any(Function));
+    });
+    (0, vitest_1.describe)('Provider class', () => {
+        (0, vitest_1.it)('should be instantiable', () => {
+            const provider = new index_js_1.Provider({});
+            (0, vitest_1.expect)(provider).toBeDefined();
+            (0, vitest_1.expect)(provider).toBeInstanceOf(index_js_1.Provider);
+        });
+        (0, vitest_1.it)('should initialize with default clusters', () => {
+            new index_js_1.Provider({});
+            (0, vitest_1.expect)(kit_1.createSolanaRpc).toHaveBeenCalledWith('https://api.devnet.solana.com');
+            (0, vitest_1.expect)(kit_1.createSolanaRpc).toHaveBeenCalledWith('https://api.mainnet-beta.solana.com');
+            (0, vitest_1.expect)(kit_1.createSolanaRpc).toHaveBeenCalledTimes(2);
+        });
+        (0, vitest_1.it)('should initialize with custom clusters', () => {
+            const clusters = {
+                devnet: (0, kit_1.createSolanaRpc)('https://api.devnet.solana.com'),
+                'mainnet-beta': (0, kit_1.createSolanaRpc)('https://api.mainnet-beta.solana.com'),
+            };
+            new index_js_1.Provider({ clusters });
+            (0, vitest_1.expect)(kit_1.createSolanaRpc).toHaveBeenCalledWith('https://api.mainnet-beta.solana.com');
+            (0, vitest_1.expect)(kit_1.createSolanaRpc).toHaveBeenCalledWith('https://api.devnet.solana.com');
+            (0, vitest_1.expect)(kit_1.createSolanaRpc).toHaveBeenCalledTimes(2);
+        });
+        (0, vitest_1.it)('should initialize with single cluster', () => {
+            const clusters = {
+                'mainnet-beta': (0, kit_1.createSolanaRpc)('https://api.mainnet-beta.solana.com'),
+            };
+            new index_js_1.Provider({ clusters });
+            (0, vitest_1.expect)(kit_1.createSolanaRpc).toHaveBeenCalledWith('https://api.mainnet-beta.solana.com');
+            (0, vitest_1.expect)(kit_1.createSolanaRpc).toHaveBeenCalledTimes(1);
+        });
+        (0, vitest_1.describe)('Cluster switching', () => {
+            (0, vitest_1.it)('should switch to devnet cluster', async () => {
+                const devnetRpc = (0, kit_1.createSolanaRpc)('https://api.devnet.solana.com');
+                const mainnetRpc = (0, kit_1.createSolanaRpc)('https://api.mainnet-beta.solana.com');
+                const provider = new index_js_1.Provider({
+                    clusters: {
+                        devnet: devnetRpc,
+                        'mainnet-beta': mainnetRpc,
+                    },
+                });
+                const result = await provider.request({ method: 'sol_switchCluster', params: ['devnet'] });
+                (0, vitest_1.expect)(result).toBe(devnetRpc);
+            });
+            (0, vitest_1.it)('should switch to mainnet-beta cluster', async () => {
+                const devnetRpc = (0, kit_1.createSolanaRpc)('https://api.devnet.solana.com');
+                const mainnetRpc = (0, kit_1.createSolanaRpc)('https://api.mainnet-beta.solana.com');
+                const provider = new index_js_1.Provider({
+                    clusters: {
+                        devnet: devnetRpc,
+                        'mainnet-beta': mainnetRpc,
+                    },
+                });
+                const result = await provider.request({ method: 'sol_switchCluster', params: ['mainnet-beta'] });
+                (0, vitest_1.expect)(result).toBe(mainnetRpc);
+            });
+            vitest_1.it.each([
+                [
+                    {
+                        devnet: (0, kit_1.createSolanaRpc)('https://api.devnet.solana.com'),
+                    },
+                    'mainnet-beta',
+                ],
+                [
+                    {
+                        'mainnet-beta': (0, kit_1.createSolanaRpc)('https://api.mainnet-beta.solana.com'),
+                    },
+                    'devnet',
+                ],
+            ])('should throw error when switching to non-existent cluster (%s)', async (clusters, targetCluster) => {
+                const provider = new index_js_1.Provider({ clusters });
+                await (0, vitest_1.expect)(provider.request({ method: 'sol_switchCluster', params: [targetCluster] })).rejects.toThrow(`Cluster '${targetCluster}' not found`);
+            });
+            (0, vitest_1.it)('should return current cluster name', async () => {
+                const devnetRpc = (0, kit_1.createSolanaRpc)('https://api.devnet.solana.com');
+                const mainnetRpc = (0, kit_1.createSolanaRpc)('https://api.mainnet-beta.solana.com');
+                const provider = new index_js_1.Provider({
+                    clusters: {
+                        devnet: devnetRpc,
+                        'mainnet-beta': mainnetRpc,
+                    },
+                });
+                // Initially should be the first cluster (devnet)
+                (0, vitest_1.expect)(await provider.request({ method: 'sol_getClusterName', params: [] })).toBe('devnet');
+                // Switch to mainnet and verify
+                await provider.request({ method: 'sol_switchCluster', params: ['mainnet-beta'] });
+                (0, vitest_1.expect)(await provider.request({ method: 'sol_getClusterName', params: [] })).toBe('mainnet-beta');
+            });
+        });
+        vitest_1.it.each([
+            [
+                'sol_getAccountInfo',
+                'getAccountInfo',
+                [(0, kit_1.address)('SysvarC1ock11111111111111111111111111111111')],
+                { owner: 'test', lamports: 1000 },
+            ],
+            ['sol_getBalance', 'getBalance', [(0, kit_1.address)('SysvarC1ock11111111111111111111111111111111')], { value: 1000000000 }],
+            [
+                'sol_sendTransaction',
+                'sendTransaction',
+                ['encoded-transaction'],
+                'transaction-signature',
+            ],
+            ['sol_getVersion', 'getVersion', [], { 'solana-core': '1.16.0' }],
+            [
+                'sol_simulateTransaction',
+                'simulateTransaction',
+                ['encoded-transaction', {}],
+                { err: null, logs: [], unitsConsumed: 5000 },
+            ],
+            ['sol_getBlockHeight', 'getBlockHeight', [], 54321],
+            ['sol_getBlockProduction', 'getBlockProduction', [], { byIdentity: {} }],
+            ['sol_getClusterNodes', 'getClusterNodes', [], []],
+            ['sol_getEpochInfo', 'getEpochInfo', [], { epoch: 123 }],
+            ['sol_getEpochSchedule', 'getEpochSchedule', [], { slotsPerEpoch: 432000 }],
+            ['sol_getFirstAvailableBlock', 'getFirstAvailableBlock', [], 1],
+            ['sol_getGenesisHash', 'getGenesisHash', [], 'genesis-hash'],
+            ['sol_getHealth', 'getHealth', [], 'ok'],
+            ['sol_getHighestSnapshotSlot', 'getHighestSnapshotSlot', [], { full: 12345 }],
+            ['sol_getIdentity', 'getIdentity', [], { identity: 'node-identity' }],
+            ['sol_getInflationGovernor', 'getInflationGovernor', [], { initial: 0.15 }],
+            ['sol_getInflationRate', 'getInflationRate', [], { total: 0.08 }],
+            ['sol_getLargestAccounts', 'getLargestAccounts', [], { value: [] }],
+            ['sol_getLatestBlockhash', 'getLatestBlockhash', [], { value: { blockhash: 'latest-hash' } }],
+            ['sol_getLeaderSchedule', 'getLeaderSchedule', [], {}],
+            ['sol_getMaxRetransmitSlot', 'getMaxRetransmitSlot', [], 12345],
+            ['sol_getMaxShredInsertSlot', 'getMaxShredInsertSlot', [], 12346],
+            ['sol_getRecentPerformanceSamples', 'getRecentPerformanceSamples', [], []],
+            ['sol_getRecentPrioritizationFees', 'getRecentPrioritizationFees', [], []],
+            ['sol_getSlot', 'getSlot', [], 12345],
+            ['sol_getSlotLeader', 'getSlotLeader', [], 'slot-leader'],
+            ['sol_getSupply', 'getSupply', [], { value: { total: 1000000000 } }],
+            ['sol_getTransactionCount', 'getTransactionCount', [], 54321],
+            ['sol_getVoteAccounts', 'getVoteAccounts', [], { current: [], delinquent: [] }],
+            ['sol_minimumLedgerSlot', 'minimumLedgerSlot', [], 1],
+            ['sol_getBlock', 'getBlock', [12345n], { slot: 12345 }],
+            ['sol_getBlockCommitment', 'getBlockCommitment', [12345n], { commitment: [10, 15, 20] }],
+            ['sol_getBlockTime', 'getBlockTime', [12345n], 1234567890],
+            ['sol_getMinimumBalanceForRentExemption', 'getMinimumBalanceForRentExemption', [128n], { value: 890880 }],
+            ['sol_getBlocks', 'getBlocks', [1n, 100n], [1, 2, 3]],
+            ['sol_getBlocksWithLimit', 'getBlocksWithLimit', [1n, 10], [1, 2, 3]],
+            ['sol_getSlotLeaders', 'getSlotLeaders', [1n, 10], []],
+            [
+                'sol_getTokenAccountBalance',
+                'getTokenAccountBalance',
+                [(0, kit_1.address)('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v')],
+                { value: { amount: '1000' } },
+            ],
+            ['sol_getProgramAccounts', 'getProgramAccounts', [(0, kit_1.address)('SysvarC1ock11111111111111111111111111111111')], []],
+            [
+                'sol_getSignaturesForAddress',
+                'getSignaturesForAddress',
+                [(0, kit_1.address)('EvN4kgKmCmYzdbd5kL8Q8YgkUW5RoqMTpBczrfLExtx7')],
+                [],
+            ],
+            [
+                'sol_getTokenLargestAccounts',
+                'getTokenLargestAccounts',
+                [(0, kit_1.address)('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v')],
+                { value: [] },
+            ],
+            [
+                'sol_getTokenSupply',
+                'getTokenSupply',
+                [(0, kit_1.address)('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v')],
+                { value: { amount: '1000000' } },
+            ],
+            [
+                'sol_getInflationReward',
+                'getInflationReward',
+                [[(0, kit_1.address)('EvN4kgKmCmYzdbd5kL8Q8YgkUW5RoqMTpBczrfLExtx7')]],
+                [{ amount: 1000 }],
+            ],
+            [
+                'sol_getMultipleAccounts',
+                'getMultipleAccounts',
+                [[(0, kit_1.address)('EvN4kgKmCmYzdbd5kL8Q8YgkUW5RoqMTpBczrfLExtx7')]],
+                { value: [] },
+            ],
+            [
+                'sol_getSignatureStatuses',
+                'getSignatureStatuses',
+                [[(0, kit_1.signature)('5uP3hpCqaGKrzJzGgQ9oAhcLmqjrHWLZBZRzNGJCFhJnHJjhDDkVMvFvLPWmKYPL5Yjds1VLwFbCPfz7hKvdLLXu')]],
+                { value: [] },
+            ],
+            [
+                'sol_getFeeForMessage',
+                'getFeeForMessage',
+                ['encoded-message'],
+                { value: 5000 },
+            ],
+            [
+                'sol_getTokenAccountsByDelegate',
+                'getTokenAccountsByDelegate',
+                [
+                    (0, kit_1.address)('EvN4kgKmCmYzdbd5kL8Q8YgkUW5RoqMTpBczrfLExtx7'),
+                    { mint: (0, kit_1.address)('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v') },
+                ],
+                { value: [] },
+            ],
+            [
+                'sol_getTokenAccountsByOwner',
+                'getTokenAccountsByOwner',
+                [
+                    (0, kit_1.address)('EvN4kgKmCmYzdbd5kL8Q8YgkUW5RoqMTpBczrfLExtx7'),
+                    { mint: (0, kit_1.address)('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v') },
+                ],
+                { value: [] },
+            ],
+            [
+                'sol_getTransaction',
+                'getTransaction',
+                [(0, kit_1.signature)('5uP3hpCqaGKrzJzGgQ9oAhcLmqjrHWLZBZRzNGJCFhJnHJjhDDkVMvFvLPWmKYPL5Yjds1VLwFbCPfz7hKvdLLXu')],
+                { slot: 12345 },
+            ],
+            [
+                'sol_isBlockhashValid',
+                'isBlockhashValid',
+                [(0, kit_1.blockhash)('5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpKuc147dw2N9d')],
+                { value: true },
+            ],
+        ])('should implement %s', async (method, solRpcMethodName, params, expected) => {
+            const solRpcMethod = vitest_1.vi.fn(() => ({ send: vitest_1.vi.fn(() => expected) }));
+            vitest_1.vi.mocked(kit_1.createSolanaRpc).mockReturnValue({ [solRpcMethodName]: solRpcMethod });
+            const testProvider = new index_js_1.Provider({});
+            const result = await testProvider.request({ method, params: [...params] });
+            (0, vitest_1.expect)(solRpcMethod).toHaveBeenCalledWith(...params);
+            (0, vitest_1.expect)(result).toEqual(expected);
+        });
+        (0, vitest_1.it)('should throw error when clusters object is empty', () => {
+            (0, vitest_1.expect)(() => new index_js_1.Provider({ clusters: {} })).toThrow();
+        });
+        vitest_1.it.each([
+            ['devnet', 'https://custom-devnet.solana.com'],
+            ['mainnet-beta', 'https://custom-mainnet.solana.com'],
+        ])('should handle clusters with only %s', async (expectedClusterId, url) => {
+            const clusters = { [expectedClusterId]: (0, kit_1.createSolanaRpc)(url) };
+            const provider = new index_js_1.Provider({ clusters });
+            (0, vitest_1.expect)(await provider.request({ method: 'sol_getClusterName', params: [] })).toBe(expectedClusterId);
+        });
+    });
+});

package/dist/cjs/providers/solana/utils/codecs.d.ts

@@ -0,0 +1,4 @@
+export declare const bytesToBase58: (bytes: import("@solana/kit").ReadonlyUint8Array | Uint8Array, offset?: import("@solana/kit").Offset) => string;
+export declare const bytesToBase64: (bytes: import("@solana/kit").ReadonlyUint8Array | Uint8Array, offset?: import("@solana/kit").Offset) => string;
+export declare const base58ToBytes: (value: string) => import("@solana/kit").ReadonlyUint8Array;
+export declare const base64ToBytes: (value: string) => import("@solana/kit").ReadonlyUint8Array;

package/dist/cjs/providers/solana/utils/codecs.js

@@ -0,0 +1,20 @@
+"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.base64ToBytes = exports.base58ToBytes = exports.bytesToBase64 = exports.bytesToBase58 = void 0;
+const kit_1 = require("@solana/kit");
+const base58 = (0, kit_1.getBase58Codec)();
+const base64 = (0, kit_1.getBase64Codec)();
+exports.bytesToBase58 = base58.decode;
+exports.bytesToBase64 = base64.decode;
+exports.base58ToBytes = base58.encode;
+exports.base64ToBytes = base64.encode;

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

@@ -0,0 +1,2 @@
+export * from './codecs.js';
+export { toBase64EncodedWireTransaction } from './toBase64EncodedWireTransaction.js';

package/dist/cjs/providers/solana/utils/index.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.
+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.toBase64EncodedWireTransaction = void 0;
+__exportStar(require("./codecs.js"), exports);
+var toBase64EncodedWireTransaction_js_1 = require("./toBase64EncodedWireTransaction.js");
+Object.defineProperty(exports, "toBase64EncodedWireTransaction", { enumerable: true, get: function () { return toBase64EncodedWireTransaction_js_1.toBase64EncodedWireTransaction; } });

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

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

package/dist/cjs/providers/solana/utils/index.test.js

@@ -0,0 +1,53 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const toBase64EncodedWireTransaction_js_1 = require("./toBase64EncodedWireTransaction.js");
+const utils = __importStar(require("./index.js"));
+(0, vitest_1.describe)('index', () => {
+    vitest_1.it.each([toBase64EncodedWireTransaction_js_1.toBase64EncodedWireTransaction])('should export %s as a function', (fn) => {
+        (0, vitest_1.expect)(utils[fn.name]).toBe(fn);
+    });
+});

package/dist/cjs/providers/solana/utils/toBase64EncodedWireTransaction.d.ts

@@ -0,0 +1,26 @@
+import type { Base64EncodedWireTransaction } from '@solana/kit';
+/**
+ * Converts various transaction formats to a Base64-encoded wire transaction.
+ *
+ * This utility function handles the conversion of different transaction input types
+ * (Buffer, string, or already encoded Base64EncodedWireTransaction) into a consistent
+ * Base64EncodedWireTransaction format that can be used with Solana RPC methods.
+ *
+ * @param tx - The transaction to convert. Can be:
+ *   - Buffer: Raw transaction bytes that will be converted to base64
+ *   - string: Already base64-encoded transaction string
+ *   - Base64EncodedWireTransaction: Already properly typed, returned as-is
+ * @returns Base64-encoded wire transaction ready for RPC submission
+ *
+ * @example
+ * ```typescript
+ * // Convert Buffer to base64
+ * const txBuffer = Buffer.from([1, 2, 3]);
+ * const base64Tx = toBase64EncodedWireTransaction(txBuffer);
+ *
+ * // Pass through already encoded string
+ * const encodedTx = "SGVsbG8gV29ybGQ=";
+ * const result = toBase64EncodedWireTransaction(encodedTx);
+ * ```
+ */
+export declare function toBase64EncodedWireTransaction(tx: string | Buffer | Base64EncodedWireTransaction): Base64EncodedWireTransaction;