@circle-fin/usdckit 0.21.0 → 0.22.0

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

@@ -0,0 +1,33 @@
+// Copyright (c) 2025, Circle Internet Group, Inc.
+// All rights reserved.
+//
+// Circle Internet Group, Inc. CONFIDENTIAL
+//
+// This file includes unpublished proprietary source code of Circle Internet
+// Group, Inc. The copyright notice above does not
+// evidence any actual or intended publication of such source code. Disclosure
+// of this source code or any related proprietary information is strictly
+// prohibited without the express written permission of Circle Internet Group, Inc.
+import { address } from '@solana/kit';
+import { describe, expect, it, vi, beforeEach } from 'vitest';
+import { getBalance } from './getBalance.js';
+describe('getBalance', () => {
+    const mockClient = {
+        request: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should forward all parameters to client.request', async () => {
+        const pubkey = address('SysvarC1ock11111111111111111111111111111111');
+        const config = { commitment: 'confirmed' };
+        const mockResponse = { value: 1000000 };
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await getBalance(mockClient, pubkey, config);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_getBalance',
+            params: [pubkey, config],
+        });
+        expect(result).toBe(mockResponse);
+    });
+});

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

@@ -0,0 +1,60 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Gets a block
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlock}
+ * @returns Promise resolving to block information
+ */
+export declare function getBlock(client: ExtendedViemClient, ...params: Parameters<Provider['sol_getBlock']>): Promise<(Readonly<{
+    blockHeight: bigint;
+    blockTime: import("@solana/rpc-types").UnixTimestamp;
+    blockhash: import("@solana/rpc-types").Blockhash;
+    parentSlot: import("@solana/rpc-types").Slot;
+    previousBlockhash: import("@solana/rpc-types").Blockhash;
+}> & Readonly<{
+    rewards: readonly import("@solana/rpc-types").Reward[];
+}> & Readonly<{
+    transactions: readonly Readonly<{
+        meta: ((Readonly<{
+            computeUnitsConsumed?: bigint;
+            logMessages: readonly string[] | null;
+            returnData?: {
+                data: import("@solana/rpc-types").Base64EncodedDataResponse;
+                programId: import("@solana/addresses").Address;
+            };
+            rewards: readonly import("@solana/rpc-types").Reward[] | null;
+        }> & Readonly<{
+            err: import("@solana/rpc-types").TransactionError | null;
+            fee: import("@solana/rpc-types").Lamports;
+            postBalances: readonly import("@solana/rpc-types").Lamports[];
+            postTokenBalances?: readonly import("@solana/rpc-types").TokenBalance[];
+            preBalances: readonly import("@solana/rpc-types").Lamports[];
+            preTokenBalances?: readonly import("@solana/rpc-types").TokenBalance[];
+            status: import("@solana/rpc-types").TransactionStatus;
+        }>) & import("@solana/rpc-types").TransactionForFullMetaInnerInstructionsUnparsed) | null;
+        transaction: Readonly<{
+            message: Readonly<{
+                accountKeys: readonly import("@solana/addresses").Address[];
+                instructions: readonly (Readonly<{
+                    data: import("@solana/rpc-types").Base58EncodedBytes;
+                }> & Partial<Readonly<{
+                    stackHeight: number;
+                }>> & Readonly<{
+                    accounts: readonly number[];
+                    programIdIndex: number;
+                }>)[];
+            }> & Readonly<{
+                header: {
+                    numReadonlySignedAccounts: number;
+                    numReadonlyUnsignedAccounts: number;
+                    numRequiredSignatures: number;
+                };
+                recentBlockhash: import("@solana/rpc-types").Blockhash;
+            }>;
+        }> & Readonly<{
+            signatures: readonly import("@solana/rpc-types").Base58EncodedBytes[];
+        }>;
+    }>[];
+}>) | null>;

package/dist/esm/providers/solana/actions/getBlock.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 a block
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlock}
+ * @returns Promise resolving to block information
+ */
+export async function getBlock(client, ...params) {
+    return await client.request({ method: 'sol_getBlock', params });
+}

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

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

package/dist/esm/providers/solana/actions/getBlock.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 { describe, expect, it, vi, beforeEach } from 'vitest';
+import { getBlock } from './getBlock.js';
+describe('getBlock', () => {
+    const mockClient = {
+        request: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should forward all parameters to client.request', async () => {
+        const slot = 12345n;
+        const config = { encoding: 'json', maxSupportedTransactionVersion: 0 };
+        const mockResponse = { blockhash: 'abc123', blockHeight: 12345 };
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await getBlock(mockClient, slot, config);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_getBlock',
+            params: [slot, config],
+        });
+        expect(result).toBe(mockResponse);
+    });
+});

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

@@ -0,0 +1,13 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Gets commitment for particular block
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlockCommitment}
+ * @returns Promise resolving to block commitment information
+ */
+export declare function getBlockCommitment(client: ExtendedViemClient, ...params: Parameters<Provider['sol_getBlockCommitment']>): Promise<Readonly<{
+    commitment: import("@solana/rpc-types").Lamports[] | null;
+    totalStake: import("@solana/rpc-types").Lamports;
+}>>;

package/dist/esm/providers/solana/actions/getBlockCommitment.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 commitment for particular block
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlockCommitment}
+ * @returns Promise resolving to block commitment information
+ */
+export async function getBlockCommitment(client, ...params) {
+    return await client.request({ method: 'sol_getBlockCommitment', params });
+}

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

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

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

@@ -0,0 +1,34 @@
+// 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 { getBlockCommitment } from './getBlockCommitment.js';
+describe('getBlockCommitment', () => {
+    const mockClient = {
+        request: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should forward all parameters to client.request', async () => {
+        const block = 12345n;
+        const mockResponse = {
+            commitment: [10, 5, 2, 1, 1],
+            totalStake: 42,
+        };
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await getBlockCommitment(mockClient, block);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_getBlockCommitment',
+            params: [block],
+        });
+        expect(result).toBe(mockResponse);
+    });
+});

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

@@ -0,0 +1,10 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Gets the current block height of the node
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlockHeight}
+ * @returns Promise resolving to block height information
+ */
+export declare function getBlockHeight(client: ExtendedViemClient, ...params: Parameters<Provider['sol_getBlockHeight']>): Promise<bigint>;

package/dist/esm/providers/solana/actions/getBlockHeight.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 current block height of the node
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlockHeight}
+ * @returns Promise resolving to block height information
+ */
+export async function getBlockHeight(client, ...params) {
+    return await client.request({ method: 'sol_getBlockHeight', params });
+}

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

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

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

@@ -0,0 +1,31 @@
+// 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 { getBlockHeight } from './getBlockHeight.js';
+describe('getBlockHeight', () => {
+    const mockClient = {
+        request: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should forward all parameters to client.request', async () => {
+        const config = { commitment: 'confirmed' };
+        const mockResponse = 6789;
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await getBlockHeight(mockClient, config);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_getBlockHeight',
+            params: [config],
+        });
+        expect(result).toBe(mockResponse);
+    });
+});

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

@@ -0,0 +1,23 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Gets recent block production information
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlockProduction}
+ * @returns Promise resolving to block production information
+ */
+export declare function getBlockProduction(client: ExtendedViemClient, ...params: Parameters<Provider['sol_getBlockProduction']>): Promise<Readonly<{
+    context: Readonly<{
+        slot: import("@solana/rpc-types").Slot;
+    }>;
+    value: Readonly<{
+        byIdentity: {
+            [x: import("@solana/nominal-types").NominalType<"brand", "Address"> & import("@solana/nominal-types").NominalType<"stringEncoding", "base58"> & string]: [numLeaderSlots: bigint, numBlocksProduced: bigint];
+        };
+        range: Readonly<{
+            firstSlot: import("@solana/rpc-types").Slot;
+            lastSlot?: import("@solana/rpc-types").Slot;
+        }>;
+    }>;
+}>>;

package/dist/esm/providers/solana/actions/getBlockProduction.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 recent block production information
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlockProduction}
+ * @returns Promise resolving to block production information
+ */
+export async function getBlockProduction(client, ...params) {
+    return await client.request({ method: 'sol_getBlockProduction', params });
+}

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

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

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

@@ -0,0 +1,38 @@
+// 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 { getBlockProduction } from './getBlockProduction.js';
+describe('getBlockProduction', () => {
+    const mockClient = {
+        request: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should forward all parameters to client.request', async () => {
+        const config = { commitment: 'confirmed' };
+        const mockResponse = {
+            value: {
+                byIdentity: {
+                    EvN4kgKmCmYzdbd5kL8Q8YgkUW5RoqMTpBczrfLExtx7: [100, 95],
+                },
+                range: { firstSlot: 10000, lastSlot: 20000 },
+            },
+        };
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await getBlockProduction(mockClient, config);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_getBlockProduction',
+            params: [config],
+        });
+        expect(result).toBe(mockResponse);
+    });
+});

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

@@ -0,0 +1,10 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Gets the estimated production time of a block
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlockTime}
+ * @returns Promise resolving to block time information
+ */
+export declare function getBlockTime(client: ExtendedViemClient, ...params: Parameters<Provider['sol_getBlockTime']>): Promise<import("@solana/rpc-types").UnixTimestamp>;

package/dist/esm/providers/solana/actions/getBlockTime.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 estimated production time of a block
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlockTime}
+ * @returns Promise resolving to block time information
+ */
+export async function getBlockTime(client, ...params) {
+    return await client.request({ method: 'sol_getBlockTime', params });
+}

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

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

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

@@ -0,0 +1,31 @@
+// 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 { getBlockTime } from './getBlockTime.js';
+describe('getBlockTime', () => {
+    const mockClient = {
+        request: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should forward all parameters to client.request', async () => {
+        const block = 12345n;
+        const mockResponse = 1234567890;
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await getBlockTime(mockClient, block);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_getBlockTime',
+            params: [block],
+        });
+        expect(result).toBe(mockResponse);
+    });
+});

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

@@ -0,0 +1,10 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Gets a list of confirmed blocks between two slots
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlocks}
+ * @returns Promise resolving to blocks information
+ */
+export declare function getBlocks(client: ExtendedViemClient, ...params: Parameters<Provider['sol_getBlocks']>): Promise<bigint[]>;

package/dist/esm/providers/solana/actions/getBlocks.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 a list of confirmed blocks between two slots
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlocks}
+ * @returns Promise resolving to blocks information
+ */
+export async function getBlocks(client, ...params) {
+    return await client.request({ method: 'sol_getBlocks', params });
+}

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

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

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

@@ -0,0 +1,33 @@
+// 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 { getBlocks } from './getBlocks.js';
+describe('getBlocks', () => {
+    const mockClient = {
+        request: vi.fn(),
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+    });
+    it('should forward all parameters to client.request', async () => {
+        const startSlot = 10000n;
+        const endSlot = 20000n;
+        const commitment = { commitment: 'confirmed' };
+        const mockResponse = [10001n, 10002n, 10003n];
+        vi.mocked(mockClient.request).mockResolvedValue(mockResponse);
+        const result = await getBlocks(mockClient, startSlot, endSlot, commitment);
+        expect(mockClient.request).toHaveBeenCalledWith({
+            method: 'sol_getBlocks',
+            params: [startSlot, endSlot, commitment],
+        });
+        expect(result).toBe(mockResponse);
+    });
+});

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

@@ -0,0 +1,10 @@
+import type { ExtendedViemClient } from '../../../client.js';
+import type { Provider } from '../transports/index.js';
+/**
+ * Gets a list of confirmed blocks starting at the given slot
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlocksWithLimit}
+ * @returns Promise resolving to blocks with limit information
+ */
+export declare function getBlocksWithLimit(client: ExtendedViemClient, ...params: Parameters<Provider['sol_getBlocksWithLimit']>): Promise<bigint[]>;

package/dist/esm/providers/solana/actions/getBlocksWithLimit.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 a list of confirmed blocks starting at the given slot
+ *
+ * @param client - Extended Viem client
+ * @param params - Parameters for {@link sol_getBlocksWithLimit}
+ * @returns Promise resolving to blocks with limit information
+ */
+export async function getBlocksWithLimit(client, ...params) {
+    return await client.request({ method: 'sol_getBlocksWithLimit', params });
+}

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

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

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

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

@@ -0,0 +1,8 @@
+import type { ExtendedViemClient } from '../../../client.js';
+/**
+ * Gets the current cluster name
+ *
+ * @param client - Extended Viem client
+ * @returns Promise resolving to the current cluster name ('devnet' | 'mainnet-beta')
+ */
+export declare function getClusterName(client: ExtendedViemClient): Promise<string>;

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

@@ -0,0 +1,22 @@
+// 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 current cluster name
+ *
+ * @param client - Extended Viem client
+ * @returns Promise resolving to the current cluster name ('devnet' | 'mainnet-beta')
+ */
+export async function getClusterName(client) {
+    return await client.request({
+        method: 'sol_getClusterName',
+        params: [],
+    });
+}

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

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