@circle-fin/usdckit 0.11.1

package/dist/esm/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/esm/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/esm/providers/smart-contracts-platform/provider.js

@@ -0,0 +1,81 @@
+// 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 { initiateSmartContractPlatformClient, } from '@circle-fin/smart-contract-platform';
+import { VERSION } from '../../metadata.js';
+import { generateIdempotencyKey } from '../../utils/generateIdempotencyKey.js';
+import { Provider as BaseProvider } from '../developer-controlled-wallets/provider.js';
+export class Provider extends BaseProvider {
+    scp;
+    constructor({ apiKey, entitySecret, baseUrl }) {
+        super({ apiKey, entitySecret, baseUrl });
+        this.scp = initiateSmartContractPlatformClient({
+            apiKey,
+            entitySecret,
+            baseUrl,
+            userAgent: `Circle-USDCKit/${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 = 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;
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/esm/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/esm/providers/smart-contracts-platform/provider.test.d.ts

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

package/dist/esm/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/esm/providers/smart-contracts-platform/provider.test.js

@@ -0,0 +1,173 @@
+// 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 { initiateDeveloperControlledWalletsClient, } from '@circle-fin/developer-controlled-wallets';
+import { initiateSmartContractPlatformClient } from '@circle-fin/smart-contract-platform';
+import { describe, test, expect, beforeEach, vi, afterEach } from 'vitest';
+import * as generateIdempotencyKeyMod from '../../utils/generateIdempotencyKey.js';
+import { Provider } from './provider.js';
+vi.mock('@circle-fin/smart-contract-platform');
+vi.mock('@circle-fin/developer-controlled-wallets');
+vi.mock('../../utils/generateIdempotencyKey.js');
+describe('Provider', () => {
+    let provider;
+    const mockClient = {
+        estimateContractExecutionFee: vi.fn(),
+        createContractExecutionTransaction: vi.fn(),
+        listWallets: vi.fn(),
+    };
+    const mockScp = {
+        importContract: vi.fn(),
+    };
+    beforeEach(() => {
+        ;
+        initiateDeveloperControlledWalletsClient.mockReturnValue(mockClient);
+        initiateSmartContractPlatformClient.mockReturnValue(mockScp);
+        provider = new Provider({
+            apiKey: 'test-api-key',
+            entitySecret: 'test-entity-secret',
+            baseUrl: 'base-url',
+        });
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    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);
+        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' },
+        });
+        expect(mockClient.estimateContractExecutionFee).toHaveBeenCalledWith(params);
+    });
+    describe('create contract execution transaction', () => {
+        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' }] },
+            });
+            vi.spyOn(provider, 'circle_getTransaction').mockResolvedValue(mockTransaction);
+            const result = await provider.circle_createContractExecutionTransaction(params);
+            expect(result).toEqual(mockTransaction);
+            expect(mockClient.createContractExecutionTransaction).toHaveBeenCalledWith({
+                ...params,
+                walletId: 'test-wallet-id',
+            });
+            // eslint-disable-next-line @typescript-eslint/unbound-method
+            expect(provider.circle_getTransaction).toHaveBeenCalledWith({
+                id: 'transaction-id',
+            });
+        });
+        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] },
+            });
+            vi.spyOn(provider, 'circle_getTransaction').mockResolvedValue(mockTransaction);
+            await expect(provider.circle_createContractExecutionTransaction(params)).rejects.toThrowError('Wallet not found');
+        });
+    });
+    describe('import contract', () => {
+        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);
+            expect(result).toBe('contract-data');
+            expect(mockScp.importContract).toHaveBeenCalledWith({
+                ...params,
+                idempotencyKey: 'test-idempotency-key',
+            });
+        });
+    });
+});
+//# sourceMappingURL=provider.test.js.map

package/dist/esm/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/esm/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/esm/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/esm/providers/smart-contracts-platform/transports/http.js

@@ -0,0 +1,19 @@
+// 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 { custom } from 'viem';
+import { NAME } from '../index.js';
+import { Provider } from '../provider.js';
+export function http({ apiKey, entitySecret, baseUrl, name = NAME, }) {
+    const provider = new Provider({ apiKey, entitySecret, baseUrl });
+    const config = { name, key: name };
+    return custom(provider, config);
+}
+//# sourceMappingURL=http.js.map

package/dist/esm/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;AAEnF,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAE7B,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,MAAM,UAAU,IAAI,CAAC,EACnB,MAAM,EACN,YAAY,EACZ,OAAO,EACP,IAAI,GAAG,IAAI,GAMZ;IACC,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAA;IAChE,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;IAClC,OAAO,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;AACjC,CAAC"}

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

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

package/dist/esm/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/esm/providers/smart-contracts-platform/transports/http.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, test, expect } from 'vitest';
+import { ETH_SEPOLIA } from '../../../chains/index.js';
+import { NAME } from '../index.js';
+import { http } from './http.js';
+describe.concurrent('http', () => {
+    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 = http(params);
+        const transport = transportFn({ chain: ETH_SEPOLIA });
+        expect(transportFn).toEqual(expect.any(Function));
+        expect(transport.config.name).toEqual(params.name ?? NAME);
+        expect(transport.config.key).toEqual(params.name ?? NAME);
+        expect(transport.config.type).toEqual('custom');
+        expect(transport.config.request).toEqual(expect.any(Function));
+    });
+});
+//# sourceMappingURL=http.test.js.map

package/dist/esm/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,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAElC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE;IAC/B,IAAI,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,IAAI,CAAC,MAAM,CAAC,CAAA;QAChC,MAAM,SAAS,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;QAErD,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACjD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,CAAA;QAC1D,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,CAAA;QACzD,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC/C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IAChE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/esm/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/esm/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/esm/types.js

@@ -0,0 +1,12 @@
+// 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.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/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/esm/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/esm/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/esm/utils/formatUnits.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 { formatUnits as _formatUnits, InvalidDecimalNumberError } from 'viem';
+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 function formatUnits(value, decimals = 0) {
+    if (typeof value === 'string' && !isNaN(Number(value))) {
+        return value;
+    }
+    else if (typeof value === 'bigint') {
+        return _formatUnits(value, decimals);
+    }
+    throw new InvalidDecimalNumberError({ value });
+}
+//# sourceMappingURL=formatUnits.js.map

package/dist/esm/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;AAEnF,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,yBAAyB,EAAE,MAAM,MAAM,CAAA;AAI7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,MAAM,CAAA;AAEhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,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,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAgB,CAAA;IACrD,CAAC;IACD,MAAM,IAAI,yBAAyB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAChD,CAAC"}

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

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

package/dist/esm/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":""}

package/dist/esm/utils/formatUnits.test.js

@@ -0,0 +1,43 @@
+// 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 { expect, describe, it } from 'vitest';
+import { formatUnits } from './index.js';
+describe.concurrent('formatUnits', () => {
+    it('should format bigint value to string with given decimals', () => {
+        expect(formatUnits(1000000000000000000000n, 18)).toBe('1000');
+        expect(formatUnits(150000000000000000n, 18)).toBe('0.15');
+        expect(formatUnits(1n, 18)).toBe('0.000000000000000001');
+        expect(formatUnits(0n, 18)).toBe('0');
+        expect(formatUnits(-1n, 18)).toBe('-0.000000000000000001');
+        expect(formatUnits(-150000000000000000n, 18)).toBe('-0.15');
+        expect(formatUnits(-1000000000000000000000n, 18)).toBe('-1000');
+        expect(formatUnits(1n)).toBe('1');
+        expect(formatUnits(0n)).toBe('0');
+        expect(formatUnits(-1n)).toBe('-1');
+    });
+    it('should return string value as is', () => {
+        expect(formatUnits('1000', 18)).toBe('1000');
+        expect(formatUnits('0.15', 18)).toBe('0.15');
+        expect(formatUnits('0.000000000000000001', 18)).toBe('0.000000000000000001');
+        expect(formatUnits('0', 18)).toBe('0');
+        expect(formatUnits('-0.000000000000000001', 18)).toBe('-0.000000000000000001');
+        expect(formatUnits('-0.15', 18)).toBe('-0.15');
+        expect(formatUnits('-1000', 18)).toBe('-1000');
+        expect(formatUnits('0.000000000000000001')).toBe('0.000000000000000001');
+        expect(formatUnits('0')).toBe('0');
+        expect(formatUnits('-0.000000000000000001')).toBe('-0.000000000000000001');
+    });
+    it('should throw an error for invalid bigint value', () => {
+        expect(() => formatUnits('abc', 18)).toThrowError();
+        expect(() => formatUnits('1.2.3', 18)).toThrowError();
+    });
+});
+//# sourceMappingURL=formatUnits.test.js.map

package/dist/esm/utils/formatUnits.test.js.map

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