@circle-fin/usdckit 0.11.1

package/dist/cjs/providers/smart-contracts-platform/provider.d.ts

@@ -0,0 +1,50 @@
+import { type CreateContractExecutionTransactionInput as _CreateContractExecutionTransactionInput, type EstimateContractExecutionFeeInput as _EstimateContractExecutionFeeInput, type Blockchain } from '@circle-fin/developer-controlled-wallets';
+import { type CircleSmartContractPlatformClient, type ImportContractInput as _ImportContractInput, type Contract } from '@circle-fin/smart-contract-platform';
+import { Provider as BaseProvider } from '../developer-controlled-wallets/provider.js';
+import type { Address, Merge } from '../../types.js';
+import type { EstimateTransactionFee, Transaction } from '../developer-controlled-wallets/provider.js';
+export type { EstimateTransactionFee, Transaction };
+export type CreateContractExecutionTransactionInput = Merge<Omit<_CreateContractExecutionTransactionInput, 'walletId'>, {
+    walletId?: string;
+    sourceAddress?: Address;
+    blockchain?: Blockchain;
+    callData?: `0x${string}`;
+}>;
+export type EstimateContractExecutionFeeInput = Merge<_EstimateContractExecutionFeeInput, {
+    abiFunctionSignature?: string;
+    abiParameters?: Array<any>;
+    callData?: `0x${string}`;
+}>;
+export type ImportContractInput = _ImportContractInput & {
+    sourceAddress?: Address;
+    blockchain?: Blockchain;
+};
+export type EIP1474Methods = [
+    {
+        Method: 'circle_estimateContractExecutionFee';
+        Parameters: [EstimateContractExecutionFeeInput];
+        ReturnType: EstimateTransactionFee;
+    },
+    {
+        Method: 'circle_createContractExecutionTransaction';
+        Parameters: [CreateContractExecutionTransactionInput];
+        ReturnType: Transaction;
+    },
+    {
+        Method: 'circle_importContract';
+        Parameters: [ImportContractInput];
+        ReturnType: Contract;
+    }
+];
+export declare class Provider extends BaseProvider {
+    protected readonly scp: CircleSmartContractPlatformClient;
+    constructor({ apiKey, entitySecret, baseUrl }: {
+        apiKey: string;
+        entitySecret: string;
+        baseUrl?: string;
+    });
+    circle_estimateContractExecutionFee(params: EstimateContractExecutionFeeInput): Promise<EstimateTransactionFee>;
+    circle_createContractExecutionTransaction(params: CreateContractExecutionTransactionInput): Promise<Transaction>;
+    circle_importContract(params: ImportContractInput): Promise<Contract>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/cjs/providers/smart-contracts-platform/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/providers/smart-contracts-platform/provider.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,uCAAuC,IAAI,wCAAwC,EACxF,KAAK,iCAAiC,IAAI,kCAAkC,EAC5E,KAAK,UAAU,EAChB,MAAM,0CAA0C,CAAA;AACjD,OAAO,EACL,KAAK,iCAAiC,EAEtC,KAAK,mBAAmB,IAAI,oBAAoB,EAChD,KAAK,QAAQ,EACd,MAAM,qCAAqC,CAAA;AAI5C,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,6CAA6C,CAAA;AAEtF,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAA;AAEtG,YAAY,EAAE,sBAAsB,EAAE,WAAW,EAAE,CAAA;AAEnD,MAAM,MAAM,uCAAuC,GAAG,KAAK,CACzD,IAAI,CAAC,wCAAwC,EAAE,UAAU,CAAC,EAC1D;IACE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;CACzB,CACF,CAAA;AAED,MAAM,MAAM,iCAAiC,GAAG,KAAK,CACnD,kCAAkC,EAClC;IACE,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAE7B,aAAa,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IAC1B,QAAQ,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;CACzB,CACF,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG;IACvD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,UAAU,CAAC,EAAE,UAAU,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B;QACE,MAAM,EAAE,qCAAqC,CAAA;QAC7C,UAAU,EAAE,CAAC,iCAAiC,CAAC,CAAA;QAC/C,UAAU,EAAE,sBAAsB,CAAA;KACnC;IACD;QACE,MAAM,EAAE,2CAA2C,CAAA;QACnD,UAAU,EAAE,CAAC,uCAAuC,CAAC,CAAA;QACrD,UAAU,EAAE,WAAW,CAAA;KACxB;IACD;QACE,MAAM,EAAE,uBAAuB,CAAA;QAC/B,UAAU,EAAE,CAAC,mBAAmB,CAAC,CAAA;QACjC,UAAU,EAAE,QAAQ,CAAA;KACrB;CACF,CAAA;AAED,qBAAa,QAAS,SAAQ,YAAY;IACxC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,iCAAiC,CAAA;gBAE7C,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAU5F,mCAAmC,CAC9C,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,sBAAsB,CAAC;IA2BrB,yCAAyC,CACpD,MAAM,EAAE,uCAAuC,GAC9C,OAAO,CAAC,WAAW,CAAC;IA2BV,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAYnF"}

package/dist/cjs/providers/smart-contracts-platform/provider.js

@@ -0,0 +1,85 @@
+"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 = void 0;
+const smart_contract_platform_1 = require("@circle-fin/smart-contract-platform");
+const metadata_js_1 = require("../../metadata.js");
+const generateIdempotencyKey_js_1 = require("../../utils/generateIdempotencyKey.js");
+const provider_js_1 = require("../developer-controlled-wallets/provider.js");
+class Provider extends provider_js_1.Provider {
+    scp;
+    constructor({ apiKey, entitySecret, baseUrl }) {
+        super({ apiKey, entitySecret, baseUrl });
+        this.scp = (0, smart_contract_platform_1.initiateSmartContractPlatformClient)({
+            apiKey,
+            entitySecret,
+            baseUrl,
+            userAgent: `Circle-USDCKit/${metadata_js_1.VERSION}`,
+        });
+    }
+    async circle_estimateContractExecutionFee(params) {
+        // @ts-expect-error: `callData` field is missing from SDKv1
+        const response = await this.client.estimateContractExecutionFee(params);
+        let data = response?.data;
+        // HACK(CCS-1460, CCS-1366, CCS-1346): Add 5% buffer to fees
+        if (data !== undefined) {
+            const _data = data;
+            data = Object.fromEntries(Object.entries(_data).map(([key, value]) => {
+                return [
+                    key,
+                    {
+                        ...value,
+                        gasLimit: `${Math.ceil(Number(value.gasLimit) * 1.05)}`,
+                        maxFee: `${Math.ceil(Number(value.maxFee) * 1.05)}`,
+                        priorityFee: `${Math.ceil(Number(value.priorityFee) * 1.05)}`,
+                    },
+                ];
+            }));
+        }
+        return data;
+    }
+    async circle_createContractExecutionTransaction(params) {
+        params = { ...params };
+        // HACK: devC REST/SDK does not support `sourceAddress` and `blockchain` args for `createContractExecutionTransaction` mismatching docs
+        if (params?.walletId === undefined && params?.sourceAddress !== undefined && params?.blockchain !== undefined) {
+            const [wallet] = await this.circle_listWallets({
+                address: params.sourceAddress,
+                blockchain: params.blockchain,
+            });
+            if (wallet === undefined)
+                throw new Error('Wallet not found');
+            params.walletId = wallet.id;
+        }
+        else if (params.walletId === undefined) {
+            params.walletId = '';
+        }
+        const response = await this.client.createContractExecutionTransaction(params);
+        if (response.data?.id === undefined)
+            throw new Error('Failed to create contract execution transaction');
+        // NOTE: `createContractExecutionTransaction` does not produce the same structure as `getTransaction`
+        // HACK: Return the same structure as `getTransaction`.
+        return (await this.circle_getTransaction({ id: response.data.id }));
+    }
+    async circle_importContract(params) {
+        params = { ...params };
+        if (params.idempotencyKey === undefined && params.blockchain !== undefined && params.address !== undefined) {
+            // HACK: Avoid extra work for error 175004 by using a deterministic idempotencyKey
+            params.idempotencyKey = (0, generateIdempotencyKey_js_1.generateIdempotencyKey)(`${params.blockchain}/${params.address}`);
+        }
+        const response = await this.scp.importContract(params);
+        if (response.data?.contract === undefined)
+            throw new Error('Failed to import contract');
+        return response.data.contract;
+    }
+}
+exports.Provider = Provider;
+//# sourceMappingURL=provider.js.map

package/dist/cjs/providers/smart-contracts-platform/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/providers/smart-contracts-platform/provider.ts"],"names":[],"mappings":"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"}

package/dist/cjs/providers/smart-contracts-platform/provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.test.d.ts.map

package/dist/cjs/providers/smart-contracts-platform/provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.test.d.ts","sourceRoot":"","sources":["../../../../src/providers/smart-contracts-platform/provider.test.ts"],"names":[],"mappings":""}

package/dist/cjs/providers/smart-contracts-platform/provider.test.js

@@ -0,0 +1,208 @@
+"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 developer_controlled_wallets_1 = require("@circle-fin/developer-controlled-wallets");
+const smart_contract_platform_1 = require("@circle-fin/smart-contract-platform");
+const vitest_1 = require("vitest");
+const generateIdempotencyKeyMod = __importStar(require("../../utils/generateIdempotencyKey.js"));
+const provider_js_1 = require("./provider.js");
+vitest_1.vi.mock('@circle-fin/smart-contract-platform');
+vitest_1.vi.mock('@circle-fin/developer-controlled-wallets');
+vitest_1.vi.mock('../../utils/generateIdempotencyKey.js');
+(0, vitest_1.describe)('Provider', () => {
+    let provider;
+    const mockClient = {
+        estimateContractExecutionFee: vitest_1.vi.fn(),
+        createContractExecutionTransaction: vitest_1.vi.fn(),
+        listWallets: vitest_1.vi.fn(),
+    };
+    const mockScp = {
+        importContract: vitest_1.vi.fn(),
+    };
+    (0, vitest_1.beforeEach)(() => {
+        ;
+        developer_controlled_wallets_1.initiateDeveloperControlledWalletsClient.mockReturnValue(mockClient);
+        smart_contract_platform_1.initiateSmartContractPlatformClient.mockReturnValue(mockScp);
+        provider = new provider_js_1.Provider({
+            apiKey: 'test-api-key',
+            entitySecret: 'test-entity-secret',
+            baseUrl: 'base-url',
+        });
+    });
+    (0, vitest_1.afterEach)(() => {
+        vitest_1.vi.restoreAllMocks();
+    });
+    (0, vitest_1.test)('estimate contract execution fee', async () => {
+        const params = {
+            abiFunctionSignature: 'value',
+            source: {
+                sourceAddress: 'sourceAddress',
+                blockchain: 'ETH-SEPOLIA',
+            },
+            contractAddress: 'contractAddress',
+            abiParameters: [],
+        };
+        mockClient.estimateContractExecutionFee.mockResolvedValue({
+            data: {
+                high: { gasLimit: '3', maxFee: '6', priorityFee: '9', baseFee: '12', networkFee: '15' },
+                medium: { gasLimit: '2', maxFee: '4', priorityFee: '6', baseFee: '8', networkFee: '10' },
+                low: { gasLimit: '1', maxFee: '2', priorityFee: '3', baseFee: '4', networkFee: '5' },
+            },
+        });
+        const result = await provider.circle_estimateContractExecutionFee(params);
+        (0, vitest_1.expect)(result).toMatchObject({
+            high: { gasLimit: '4', maxFee: '7', priorityFee: '10', baseFee: '12', networkFee: '15' },
+            medium: { gasLimit: '3', maxFee: '5', priorityFee: '7', baseFee: '8', networkFee: '10' },
+            low: { gasLimit: '2', maxFee: '3', priorityFee: '4', baseFee: '4', networkFee: '5' },
+        });
+        (0, vitest_1.expect)(mockClient.estimateContractExecutionFee).toHaveBeenCalledWith(params);
+    });
+    (0, vitest_1.describe)('create contract execution transaction', () => {
+        vitest_1.test.each([
+            {
+                name: 'with wallet id',
+                params: {
+                    walletId: 'test-wallet-id',
+                    contractAddress: '0xcontract-address',
+                    fee: {
+                        type: 'level',
+                        config: {
+                            feeLevel: 'LOW',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'without wallet id',
+                params: {
+                    contractAddress: '0xcontract-address',
+                    sourceAddress: '0xtest-address',
+                    blockchain: 'ETH-SEPOLIA',
+                    fee: {
+                        type: 'level',
+                        config: {
+                            feeLevel: 'LOW',
+                        },
+                    },
+                },
+            },
+        ])('ok $name', async ({ params }) => {
+            const mockResponse = { data: { id: 'transaction-id' } };
+            const mockTransaction = {
+                id: 'transaction-id',
+                blockchain: 'ETH-SEPOLIA',
+                createDate: '2024-01-01T00:00:00Z',
+                state: 'COMPLETE',
+                transactionType: 'OUTBOUND',
+                updateDate: '2024-01-01T00:00:00Z',
+            };
+            mockClient.createContractExecutionTransaction.mockResolvedValue(mockResponse);
+            mockClient.listWallets.mockResolvedValue({
+                data: { wallets: [{ id: 'test-wallet-id' }] },
+            });
+            vitest_1.vi.spyOn(provider, 'circle_getTransaction').mockResolvedValue(mockTransaction);
+            const result = await provider.circle_createContractExecutionTransaction(params);
+            (0, vitest_1.expect)(result).toEqual(mockTransaction);
+            (0, vitest_1.expect)(mockClient.createContractExecutionTransaction).toHaveBeenCalledWith({
+                ...params,
+                walletId: 'test-wallet-id',
+            });
+            // eslint-disable-next-line @typescript-eslint/unbound-method
+            (0, vitest_1.expect)(provider.circle_getTransaction).toHaveBeenCalledWith({
+                id: 'transaction-id',
+            });
+        });
+        (0, vitest_1.test)('wallet not found', async () => {
+            const params = {
+                sourceAddress: '0xtest-address',
+                blockchain: 'ETH-SEPOLIA',
+                contractAddress: 'test-contract-address',
+                abiFunctionSignature: 'test-abi-function-signature',
+                abiParameters: [],
+                fee: {
+                    type: 'level',
+                    config: {
+                        /**
+                         * A dynamic fee level setting (LOW, MEDIUM, HIGH) determining the gas price for the transaction,
+                         * based on network conditions. Incompatible with gasLimit, gasPrice, priorityFee, or maxFee.
+                         * Use the Estimate Fee methods for fee level estimates.
+                         */
+                        feeLevel: 'LOW',
+                    },
+                },
+            };
+            const mockResponse = { data: { id: 'transaction-id' } };
+            const mockTransaction = {
+                id: 'transaction-id',
+                blockchain: 'ETH-SEPOLIA',
+                createDate: '2024-01-01T00:00:00Z',
+                state: 'COMPLETE',
+                transactionType: 'OUTBOUND',
+                updateDate: '2024-01-01T00:00:00Z',
+            };
+            mockClient.createContractExecutionTransaction.mockResolvedValue(mockResponse);
+            mockClient.listWallets.mockResolvedValue({
+                data: { wallets: [undefined] },
+            });
+            vitest_1.vi.spyOn(provider, 'circle_getTransaction').mockResolvedValue(mockTransaction);
+            await (0, vitest_1.expect)(provider.circle_createContractExecutionTransaction(params)).rejects.toThrowError('Wallet not found');
+        });
+    });
+    (0, vitest_1.describe)('import contract', () => {
+        (0, vitest_1.test)('ok', async () => {
+            const params = { blockchain: 'ETH-SEPOLIA', address: '0xtest-address', name: 'test-name' };
+            const mockResponse = { data: { contract: 'contract-data' } };
+            mockScp.importContract.mockResolvedValue(mockResponse);
+            generateIdempotencyKeyMod.generateIdempotencyKey.mockReturnValue('test-idempotency-key');
+            const result = await provider.circle_importContract(params);
+            (0, vitest_1.expect)(result).toBe('contract-data');
+            (0, vitest_1.expect)(mockScp.importContract).toHaveBeenCalledWith({
+                ...params,
+                idempotencyKey: 'test-idempotency-key',
+            });
+        });
+    });
+});
+//# sourceMappingURL=provider.test.js.map

package/dist/cjs/providers/smart-contracts-platform/provider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.test.js","sourceRoot":"","sources":["../../../../src/providers/smart-contracts-platform/provider.test.ts"],"names":[],"mappings":"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"}

package/dist/cjs/providers/smart-contracts-platform/transports/http.d.ts

@@ -0,0 +1,7 @@
+export declare function http({ apiKey, entitySecret, baseUrl, name, }: {
+    apiKey: string;
+    entitySecret: string;
+    baseUrl?: string;
+    name?: string;
+}): import("viem").CustomTransport;
+//# sourceMappingURL=http.d.ts.map

package/dist/cjs/providers/smart-contracts-platform/transports/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../../../src/providers/smart-contracts-platform/transports/http.ts"],"names":[],"mappings":"AAgBA,wBAAgB,IAAI,CAAC,EACnB,MAAM,EACN,YAAY,EACZ,OAAO,EACP,IAAW,GACZ,EAAE;IACD,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,kCAIA"}

package/dist/cjs/providers/smart-contracts-platform/transports/http.js

@@ -0,0 +1,22 @@
+"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");
+const provider_js_1 = require("../provider.js");
+function http({ apiKey, entitySecret, baseUrl, name = index_js_1.NAME, }) {
+    const provider = new provider_js_1.Provider({ apiKey, entitySecret, baseUrl });
+    const config = { name, key: name };
+    return (0, viem_1.custom)(provider, config);
+}
+//# sourceMappingURL=http.js.map

package/dist/cjs/providers/smart-contracts-platform/transports/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../../src/providers/smart-contracts-platform/transports/http.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAOnF,oBAcC;AAnBD,+BAA6B;AAE7B,0CAAkC;AAClC,gDAAyC;AAEzC,SAAgB,IAAI,CAAC,EACnB,MAAM,EACN,YAAY,EACZ,OAAO,EACP,IAAI,GAAG,eAAI,GAMZ;IACC,MAAM,QAAQ,GAAG,IAAI,sBAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAA;IAChE,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;IAClC,OAAO,IAAA,aAAM,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;AACjC,CAAC"}

package/dist/cjs/providers/smart-contracts-platform/transports/http.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http.test.d.ts.map

package/dist/cjs/providers/smart-contracts-platform/transports/http.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.test.d.ts","sourceRoot":"","sources":["../../../../../src/providers/smart-contracts-platform/transports/http.test.ts"],"names":[],"mappings":""}

package/dist/cjs/providers/smart-contracts-platform/transports/http.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 index_js_1 = require("../../../chains/index.js");
+const index_js_2 = require("../index.js");
+const http_js_1 = require("./http.js");
+vitest_1.describe.concurrent('http', () => {
+    vitest_1.test.each([
+        [{ apiKey: 'apiKey', entitySecret: 'entitySecret', baseUrl: 'https://example.com', name: 'name' }],
+        [{ apiKey: 'apiKey', entitySecret: 'entitySecret', baseUrl: 'https://example.com', name: undefined }],
+        [{ apiKey: 'apiKey', entitySecret: 'entitySecret', name: 'name' }],
+        [{ apiKey: 'apiKey', entitySecret: 'entitySecret', name: undefined }],
+    ])('should create a transport %o', (params) => {
+        const transportFn = (0, http_js_1.http)(params);
+        const transport = transportFn({ chain: index_js_1.ETH_SEPOLIA });
+        (0, vitest_1.expect)(transportFn).toEqual(vitest_1.expect.any(Function));
+        (0, vitest_1.expect)(transport.config.name).toEqual(params.name ?? index_js_2.NAME);
+        (0, vitest_1.expect)(transport.config.key).toEqual(params.name ?? index_js_2.NAME);
+        (0, vitest_1.expect)(transport.config.type).toEqual('custom');
+        (0, vitest_1.expect)(transport.config.request).toEqual(vitest_1.expect.any(Function));
+    });
+});
+//# sourceMappingURL=http.test.js.map

package/dist/cjs/providers/smart-contracts-platform/transports/http.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.test.js","sourceRoot":"","sources":["../../../../../src/providers/smart-contracts-platform/transports/http.test.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAEnF,mCAA+C;AAE/C,uDAAsD;AACtD,0CAAkC;AAElC,uCAAgC;AAEhC,iBAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE;IAC/B,aAAI,CAAC,IAAI,CAAC;QACR,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAClG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACrG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAClE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;KAC7D,CAAC,CAAC,8BAA8B,EAAE,CAAC,MAAM,EAAE,EAAE;QACrD,MAAM,WAAW,GAAG,IAAA,cAAI,EAAC,MAAM,CAAC,CAAA;QAChC,MAAM,SAAS,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,sBAAW,EAAE,CAAC,CAAA;QAErD,IAAA,eAAM,EAAC,WAAW,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACjD,IAAA,eAAM,EAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,eAAI,CAAC,CAAA;QAC1D,IAAA,eAAM,EAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,eAAI,CAAC,CAAA;QACzD,IAAA,eAAM,EAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC/C,IAAA,eAAM,EAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IAChE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/cjs/types.d.ts

@@ -0,0 +1,46 @@
+import type { Actions as CoreActions } from './actions/index.js';
+import type { Actions as CrossChainTransferProtocolActions } from './providers/cross-chain-transfer-protocol/actions/index.js';
+import type { EIP1474Methods as CrossChainTransferMethods } from './providers/cross-chain-transfer-protocol/provider.js';
+import type { Actions as DeveloperControlledWalletActions } from './providers/developer-controlled-wallets/actions/index.js';
+import type { EIP1474Methods as DeveloperControlledWalletMethods } from './providers/developer-controlled-wallets/provider.js';
+import type { Actions as FaucetActions } from './providers/faucet/index.js';
+import type { EIP1474Methods as FaucetMethods } from './providers/faucet/provider.js';
+import type { Actions as SmartContractsPlatformActions } from './providers/smart-contracts-platform/actions/index.js';
+import type { EIP1474Methods as SmartContractsPlatformMethods } from './providers/smart-contracts-platform/provider.js';
+import type { Account as _Account, Assign, Chain, Client, EIP1474Methods, Prettify, PublicActions, Transport, WalletActions } from 'viem';
+export type Merge<T, U> = Prettify<Assign<T, U>>;
+export type { Address, GetContractReturnType as Contract, FeeValuesEIP1559 } from 'viem';
+export type Account = _Account & {
+    chain?: Chain;
+};
+export type ExtendedEIP1474Methods = [
+    ...DeveloperControlledWalletMethods,
+    ...SmartContractsPlatformMethods,
+    ...FaucetMethods,
+    ...CrossChainTransferMethods,
+    ...EIP1474Methods
+];
+export type ExtendedViemClient<transport extends Transport = Transport, chain extends Chain = Chain> = Client<transport, chain, Account, ExtendedEIP1474Methods>;
+export type CircleClient = Client & PublicActions & WalletActions & DeveloperControlledWalletActions & SmartContractsPlatformActions & FaucetActions & CrossChainTransferProtocolActions & CoreActions;
+/**
+ * The primary denomination of a blockchain’s currency
+ *
+ * @example
+ * const unit: FormattedUnits = "1"; // 1 ETH
+ */
+export type NativeUnits = `${number}`;
+/**
+ * The smallest indivisible unit of a cryptocurrency
+ *
+ * @example
+ * const unit: BaseUnits = 1n; // 0.000000000000000001 ETH
+ */
+export type BaseUnits = bigint;
+/**
+ * Interface for objects that can be converted to string representations.
+ */
+export interface Stringifyable {
+    toString(): string;
+    toJSON(): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,IAAI,iCAAiC,EAAE,MAAM,4DAA4D,CAAA;AAC9H,OAAO,KAAK,EAAE,cAAc,IAAI,yBAAyB,EAAE,MAAM,uDAAuD,CAAA;AACxH,OAAO,KAAK,EAAE,OAAO,IAAI,gCAAgC,EAAE,MAAM,2DAA2D,CAAA;AAC5H,OAAO,KAAK,EAAE,cAAc,IAAI,gCAAgC,EAAE,MAAM,sDAAsD,CAAA;AAC9H,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,KAAK,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,uDAAuD,CAAA;AACrH,OAAO,KAAK,EAAE,cAAc,IAAI,6BAA6B,EAAE,MAAM,kDAAkD,CAAA;AACvH,OAAO,KAAK,EACV,OAAO,IAAI,QAAQ,EACnB,MAAM,EACN,KAAK,EACL,MAAM,EACN,cAAc,EACd,QAAQ,EACR,aAAa,EACb,SAAS,EACT,aAAa,EACd,MAAM,MAAM,CAAA;AAEb,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAEhD,YAAY,EAAE,OAAO,EAAE,qBAAqB,IAAI,QAAQ,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAA;AAExF,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAGlD,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,gCAAgC;IACnC,GAAG,6BAA6B;IAChC,GAAG,aAAa;IAChB,GAAG,yBAAyB;IAC5B,GAAG,cAAc;CAClB,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,SAAS,SAAS,SAAS,GAAG,SAAS,EAAE,KAAK,SAAS,KAAK,GAAG,KAAK,IAAI,MAAM,CAC3G,SAAS,EACT,KAAK,EACL,OAAO,EACP,sBAAsB,CACvB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAC/B,aAAa,GACb,aAAa,GACb,gCAAgC,GAChC,6BAA6B,GAC7B,aAAa,GACb,iCAAiC,GACjC,WAAW,CAAA;AAEb;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,MAAM,EAAE,CAAA;AAGrC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,IAAI,MAAM,CAAA;IAClB,MAAM,IAAI,MAAM,CAAA;CACjB"}

package/dist/cjs/types.js

@@ -0,0 +1,13 @@
+"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 });
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF"}

package/dist/cjs/utils/formatUnits.d.ts

@@ -0,0 +1,20 @@
+import { type BaseUnits, type NativeUnits } from '../types.js';
+export { InvalidDecimalNumberError } from 'viem';
+/**
+ * Formats a value from base units to formatted units.
+ *
+ * @param value - The value to be formatted, either in base units or formatted units.
+ * @param decimals - The number of decimal places to consider for base units.
+ * @returns The value in formatted units.
+ * @throws {@link InvalidDecimalNumberError} If the value is not a valid number.
+ *
+ * @example
+ * ```typescript
+ * formatUnits(1000000000000000000n, 18)
+ * // => '1'
+ * formatUnits('1', 18)
+ * // => '1'
+ * ```
+ */
+export declare function formatUnits(value: BaseUnits | NativeUnits, decimals?: number): NativeUnits;
+//# sourceMappingURL=formatUnits.d.ts.map

package/dist/cjs/utils/formatUnits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatUnits.d.ts","sourceRoot":"","sources":["../../../src/utils/formatUnits.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,MAAM,CAAA;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,EAAE,QAAQ,GAAE,MAAU,GAAG,WAAW,CAO7F"}

package/dist/cjs/utils/formatUnits.js

@@ -0,0 +1,43 @@
+"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.InvalidDecimalNumberError = void 0;
+exports.formatUnits = formatUnits;
+const viem_1 = require("viem");
+var viem_2 = require("viem");
+Object.defineProperty(exports, "InvalidDecimalNumberError", { enumerable: true, get: function () { return viem_2.InvalidDecimalNumberError; } });
+/**
+ * Formats a value from base units to formatted units.
+ *
+ * @param value - The value to be formatted, either in base units or formatted units.
+ * @param decimals - The number of decimal places to consider for base units.
+ * @returns The value in formatted units.
+ * @throws {@link InvalidDecimalNumberError} If the value is not a valid number.
+ *
+ * @example
+ * ```typescript
+ * formatUnits(1000000000000000000n, 18)
+ * // => '1'
+ * formatUnits('1', 18)
+ * // => '1'
+ * ```
+ */
+function formatUnits(value, decimals = 0) {
+    if (typeof value === 'string' && !isNaN(Number(value))) {
+        return value;
+    }
+    else if (typeof value === 'bigint') {
+        return (0, viem_1.formatUnits)(value, decimals);
+    }
+    throw new viem_1.InvalidDecimalNumberError({ value });
+}
+//# sourceMappingURL=formatUnits.js.map

package/dist/cjs/utils/formatUnits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatUnits.js","sourceRoot":"","sources":["../../../src/utils/formatUnits.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;;AAwBnF,kCAOC;AA7BD,+BAA6E;AAI7E,6BAAgD;AAAvC,iHAAA,yBAAyB,OAAA;AAElC;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,WAAW,CAAC,KAA8B,EAAE,WAAmB,CAAC;IAC9E,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,KAAK,CAAA;IACd,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,IAAA,kBAAY,EAAC,KAAK,EAAE,QAAQ,CAAgB,CAAA;IACrD,CAAC;IACD,MAAM,IAAI,gCAAyB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAChD,CAAC"}

package/dist/cjs/utils/formatUnits.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=formatUnits.test.d.ts.map

package/dist/cjs/utils/formatUnits.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatUnits.test.d.ts","sourceRoot":"","sources":["../../../src/utils/formatUnits.test.ts"],"names":[],"mappings":""}