@circle-fin/usdckit 0.21.1 → 0.22.0

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

@@ -0,0 +1,201 @@
+"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 index_js_1 = require("../../chains/index.js");
+const extractChain_js_1 = require("../../extractChain.js");
+const solanaIndex = __importStar(require("./index.js"));
+const index_js_2 = require("./index.js");
+// Mock the extractChain dependency
+vitest_1.vi.mock('../../extractChain.js', () => ({
+    extractChain: vitest_1.vi.fn(),
+}));
+const mockedExtractChain = vitest_1.vi.mocked(extractChain_js_1.extractChain);
+(0, vitest_1.describe)('providers/solana/index', () => {
+    (0, vitest_1.describe)('constants', () => {
+        (0, vitest_1.it)('should export NAME as "solana"', () => {
+            (0, vitest_1.expect)(index_js_2.NAME).toBe('solana');
+            (0, vitest_1.expect)(index_js_2.NAME).toEqual(vitest_1.expect.any(String));
+        });
+        (0, vitest_1.it)('should export SUPPORTED_CHAINS with correct chains', () => {
+            (0, vitest_1.expect)(index_js_2.SUPPORTED_CHAINS).toEqual([index_js_1.SOL, index_js_1.SOL_DEVNET]);
+            (0, vitest_1.expect)(index_js_2.SUPPORTED_CHAINS).toHaveLength(2);
+            (0, vitest_1.expect)(index_js_2.SUPPORTED_CHAINS).toContain(index_js_1.SOL);
+            (0, vitest_1.expect)(index_js_2.SUPPORTED_CHAINS).toContain(index_js_1.SOL_DEVNET);
+        });
+        (0, vitest_1.it)('should have SUPPORTED_CHAINS as readonly array', () => {
+            (0, vitest_1.expect)(Array.isArray(index_js_2.SUPPORTED_CHAINS)).toBe(true);
+            // Test that it's a const assertion (readonly in TypeScript)
+            // Note: TypeScript readonly is compile-time only, runtime behavior is still mutable
+            (0, vitest_1.expect)(index_js_2.SUPPORTED_CHAINS).toBeInstanceOf(Array);
+            (0, vitest_1.expect)(Object.isFrozen(index_js_2.SUPPORTED_CHAINS)).toBe(false); // It's not frozen at runtime
+            // But we can verify it has the expected type structure
+            (0, vitest_1.expect)(index_js_2.SUPPORTED_CHAINS).toEqual(vitest_1.expect.arrayContaining([index_js_1.SOL, index_js_1.SOL_DEVNET]));
+        });
+    });
+    (0, vitest_1.describe)('Chain type', () => {
+        (0, vitest_1.it)('should have Chain type that matches SUPPORTED_CHAINS elements', () => {
+            // Type test - if this compiles, the type is correct
+            const testChain1 = index_js_1.SOL;
+            const testChain2 = index_js_1.SOL_DEVNET;
+            (0, vitest_1.expect)(testChain1).toBe(index_js_1.SOL);
+            (0, vitest_1.expect)(testChain2).toBe(index_js_1.SOL_DEVNET);
+        });
+    });
+    (0, vitest_1.describe)('extractChain function', () => {
+        (0, vitest_1.beforeEach)(() => {
+            vitest_1.vi.clearAllMocks();
+        });
+        (0, vitest_1.it)('should call _extractChain with correct parameters', () => {
+            const mockResult = index_js_1.SOL;
+            mockedExtractChain.mockReturnValue(mockResult);
+            const result = (0, index_js_2.extractChain)({ id: index_js_1.SOL.id });
+            (0, vitest_1.expect)(mockedExtractChain).toHaveBeenCalledWith({
+                id: index_js_1.SOL.id,
+                chains: index_js_2.SUPPORTED_CHAINS,
+            });
+            (0, vitest_1.expect)(result).toBe(mockResult);
+        });
+        (0, vitest_1.it)('should work with SOL chain id', () => {
+            const mockResult = index_js_1.SOL;
+            mockedExtractChain.mockReturnValue(mockResult);
+            const result = (0, index_js_2.extractChain)({ id: index_js_1.SOL.id });
+            (0, vitest_1.expect)(mockedExtractChain).toHaveBeenCalledWith({
+                id: index_js_1.SOL.id,
+                chains: index_js_2.SUPPORTED_CHAINS,
+            });
+            (0, vitest_1.expect)(result).toBe(mockResult);
+        });
+        (0, vitest_1.it)('should work with SOL_DEVNET chain id', () => {
+            const mockResult = index_js_1.SOL_DEVNET;
+            mockedExtractChain.mockReturnValue(mockResult);
+            const result = (0, index_js_2.extractChain)({ id: index_js_1.SOL_DEVNET.id });
+            (0, vitest_1.expect)(mockedExtractChain).toHaveBeenCalledWith({
+                id: index_js_1.SOL_DEVNET.id,
+                chains: index_js_2.SUPPORTED_CHAINS,
+            });
+            (0, vitest_1.expect)(result).toBe(mockResult);
+        });
+        (0, vitest_1.it)('should preserve type information for chain extraction', () => {
+            const mockResult = index_js_1.SOL;
+            mockedExtractChain.mockReturnValue(mockResult);
+            // Type test - ensure the function maintains proper generic typing
+            const result = (0, index_js_2.extractChain)({ id: index_js_1.SOL.id });
+            // This should compile without issues if types are correct
+            (0, vitest_1.expect)(result).toBe(mockResult);
+        });
+    });
+    (0, vitest_1.describe)('re-exports', () => {
+        (0, vitest_1.it)('should re-export actions', () => {
+            // Test that actions are exported (they come from ./actions/index.js)
+            // We can't test all individual actions easily, but we can test that exports exist
+            (0, vitest_1.expect)(typeof solanaIndex).toBe('object');
+            // Check for some known action exports that should be available
+            (0, vitest_1.expect)('getAccountInfo' in solanaIndex).toBe(true);
+            (0, vitest_1.expect)('getBalance' in solanaIndex).toBe(true);
+            (0, vitest_1.expect)('getBlock' in solanaIndex).toBe(true);
+            (0, vitest_1.expect)('sendTransaction' in solanaIndex).toBe(true);
+        });
+        (0, vitest_1.it)('should re-export transports', () => {
+            // Test that transports are exported (they come from ./transports/index.js)
+            (0, vitest_1.expect)('http' in solanaIndex).toBe(true);
+            (0, vitest_1.expect)('Provider' in solanaIndex).toBe(true);
+        });
+        (0, vitest_1.it)('should re-export utils', () => {
+            // Test that utils are exported (they come from ./utils/index.js)
+            (0, vitest_1.expect)('toBase64EncodedWireTransaction' in solanaIndex).toBe(true);
+        });
+        (0, vitest_1.it)('should have all expected top-level exports', () => {
+            const expectedExports = [
+                'NAME',
+                'SUPPORTED_CHAINS',
+                'extractChain',
+                // From actions
+                'getAccountInfo',
+                'getBalance',
+                'getBlock',
+                'sendTransaction',
+                'actions',
+                // From transports
+                'http',
+                'Provider',
+                // From utils
+                'toBase64EncodedWireTransaction',
+            ];
+            expectedExports.forEach((exportName) => {
+                (0, vitest_1.expect)(exportName in solanaIndex).toBe(true);
+            });
+        });
+    });
+    (0, vitest_1.describe)('module structure', () => {
+        (0, vitest_1.it)('should export the correct number of items', () => {
+            const exports = Object.keys(solanaIndex);
+            // Should have our main exports plus all re-exports
+            (0, vitest_1.expect)(exports.length).toBeGreaterThan(50); // Many actions + transports + utils + main exports
+            (0, vitest_1.expect)(exports).toContain('NAME');
+            (0, vitest_1.expect)(exports).toContain('SUPPORTED_CHAINS');
+            (0, vitest_1.expect)(exports).toContain('extractChain');
+        });
+        (0, vitest_1.it)('should not export any undefined values', () => {
+            Object.values(solanaIndex).forEach((exportValue) => {
+                (0, vitest_1.expect)(exportValue).toBeDefined();
+            });
+        });
+    });
+    (0, vitest_1.describe)('integration', () => {
+        (0, vitest_1.it)('should work with the actual chain definitions', () => {
+            // Test with real chain objects to ensure integration works
+            (0, vitest_1.expect)(index_js_1.SOL.id).toBeDefined();
+            (0, vitest_1.expect)(index_js_1.SOL_DEVNET.id).toBeDefined();
+            (0, vitest_1.expect)(index_js_1.SOL.name).toBe('Solana Mainnet');
+            (0, vitest_1.expect)(index_js_1.SOL_DEVNET.name).toBe('Solana Devnet');
+        });
+        (0, vitest_1.it)('should maintain consistency between supported chains and imports', () => {
+            // Ensure SUPPORTED_CHAINS contains the exact same objects as imported
+            (0, vitest_1.expect)(index_js_2.SUPPORTED_CHAINS[0]).toBe(index_js_1.SOL);
+            (0, vitest_1.expect)(index_js_2.SUPPORTED_CHAINS[1]).toBe(index_js_1.SOL_DEVNET);
+        });
+    });
+});

package/dist/cjs/providers/solana/transports/http.d.ts

@@ -0,0 +1,8 @@
+import type { SolanaRpc } from '../index.js';
+export declare function http({ clusters, name, }: {
+    clusters?: {
+        devnet?: SolanaRpc;
+        'mainnet-beta'?: SolanaRpc;
+    };
+    name?: string;
+}): import("viem").CustomTransport;

package/dist/cjs/providers/solana/transports/http.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.http = http;
+const viem_1 = require("viem");
+const index_js_1 = require("../index.js");
+function http({ clusters, name = index_js_1.NAME, }) {
+    const provider = new index_js_1.Provider({ clusters });
+    const config = { name, key: name };
+    return (0, viem_1.custom)(provider, config);
+}

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

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

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

@@ -0,0 +1,88 @@
+"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 kit_1 = require("@solana/kit");
+const viem_1 = require("viem");
+const vitest_1 = require("vitest");
+const index_js_1 = require("../index.js");
+const http_js_1 = require("./http.js");
+// Mock viem's custom function
+vitest_1.vi.mock('viem', () => ({
+    custom: vitest_1.vi.fn((provider, config) => ({
+        provider,
+        config,
+        type: 'custom',
+    })),
+}));
+// Mock the Provider class
+vitest_1.vi.mock('../index.js', () => ({
+    Provider: vitest_1.vi.fn((config) => ({
+        config,
+        mockProvider: true,
+    })),
+    NAME: 'solana',
+}));
+vitest_1.describe.concurrent('http transport', () => {
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.resetAllMocks();
+    });
+    (0, vitest_1.it)('should be exported', () => {
+        (0, vitest_1.expect)(http_js_1.http).toBeDefined();
+        (0, vitest_1.expect)(http_js_1.http).toEqual(vitest_1.expect.any(Function));
+    });
+    (0, vitest_1.it)('should create Provider with correct parameters', () => {
+        const clusters = { 'mainnet-beta': (0, kit_1.createSolanaRpc)('https://api.mainnet-beta.solana.com') };
+        (0, http_js_1.http)({ clusters });
+        (0, vitest_1.expect)(index_js_1.Provider).toHaveBeenCalledWith({ clusters });
+    });
+    (0, vitest_1.it)('should create Provider with undefined clusters when not provided', () => {
+        (0, http_js_1.http)({});
+        (0, vitest_1.expect)(index_js_1.Provider).toHaveBeenCalledWith({ clusters: undefined });
+    });
+    (0, vitest_1.it)('should call viem custom function with provider and config', () => {
+        const name = 'custom-solana';
+        (0, http_js_1.http)({ name });
+        (0, vitest_1.expect)(viem_1.custom).toHaveBeenCalledWith(vitest_1.expect.any(Object), // The provider instance
+        {
+            name: 'custom-solana',
+            key: 'custom-solana',
+        });
+    });
+    (0, vitest_1.it)('should use default name when not provided', () => {
+        (0, http_js_1.http)({});
+        (0, vitest_1.expect)(viem_1.custom).toHaveBeenCalledWith(vitest_1.expect.any(Object), {
+            name: 'solana',
+            key: 'solana',
+        });
+    });
+    (0, vitest_1.it)('should return the result of viem custom function', () => {
+        const mockResult = vitest_1.vi.fn().mockReturnValue({ provider: {}, config: {}, type: 'custom', request: vitest_1.vi.fn() });
+        vitest_1.vi.mocked(viem_1.custom).mockReturnValue(mockResult);
+        const result = (0, http_js_1.http)({});
+        (0, vitest_1.expect)(result).toBe(mockResult);
+    });
+    (0, vitest_1.it)('should handle both clusters and name parameters', () => {
+        const clusters = { devnet: (0, kit_1.createSolanaRpc)('https://api.testnet.solana.com') };
+        const name = 'testnet-solana';
+        (0, http_js_1.http)({ clusters, name });
+        (0, vitest_1.expect)(index_js_1.Provider).toHaveBeenCalledWith({ clusters });
+        (0, vitest_1.expect)(viem_1.custom).toHaveBeenCalledWith(vitest_1.expect.any(Object), {
+            name: 'testnet-solana',
+            key: 'testnet-solana',
+        });
+    });
+    (0, vitest_1.it)('should handle multiple clusters', () => {
+        const clusters = { 'mainnet-beta': (0, kit_1.createSolanaRpc)('https://api.devnet.solana.com') };
+        (0, http_js_1.http)({ clusters });
+        (0, vitest_1.expect)(index_js_1.Provider).toHaveBeenCalledWith({ clusters });
+    });
+});