@circle-fin/usdckit 0.17.1 → 0.19.0

package/package.json

@@ -1,55 +1,59 @@
 {
   "name": "@circle-fin/usdckit",
-  "version": "0.17.1",
+  "version": "0.19.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/circlefin/w3s-node-sdk.git"
   },
+  "homepage": "https://docs-w3s-node-sdk.circle.com/",
   "license": "Apache-2.0",
   "author": "Circle Internet Group, Inc.",
   "workspaces": [
     "packages/*"
   ],
   "dependencies": {
-    "@circle-fin/developer-controlled-wallets": "^8.0.0",
-    "@circle-fin/smart-contract-platform": "^8.0.0",
+    "@circle-fin/developer-controlled-wallets": "^8.3.0",
+    "@circle-fin/smart-contract-platform": "^8.3.0",
+    "@inquirer/prompts": "^7.5.3",
+    "axios": "^1.9.0",
+    "commander": "^14.0.0",
     "core-js": "^3.40.0",
     "pino": "^9.6.0",
     "uuid": "^11.0.3",
     "viem": "^2.23.13"
   },
   "devDependencies": {
-    "@eslint/compat": "^1.2.8",
-    "@eslint/js": "^9.24.0",
-    "@eslint/json": "^0.11.0",
+    "@eslint/compat": "^1.3.0",
+    "@eslint/js": "^9.29.0",
+    "@eslint/json": "^0.13.0",
     "@eslint/markdown": "^6.2.1",
-    "@types/node": "^22.14.0",
-    "@typescript-eslint/parser": "^8.29.1",
-    "@vitest/coverage-v8": "^3.1.1",
-    "eslint": "^9.24.0",
+    "@types/node": "^24.0.3",
+    "@typescript-eslint/parser": "^8.34.1",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.29.0",
     "eslint-config-prettier": "^10.1.2",
     "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-jsdoc": "^50.6.1",
-    "eslint-plugin-prettier": "^5.2.6",
+    "eslint-plugin-jsdoc": "^51.0.3",
+    "eslint-plugin-prettier": "^5.5.0",
     "eslint-plugin-promise": "^7.2.1",
     "eslint-plugin-tsdoc": "^0.4.0",
     "eslint-plugin-vitest": "^0.5.4",
     "globals": "^16.0.0",
-    "lefthook": "^1.11.8",
-    "pino-pretty": "^13.0.0",
+    "lefthook": "^1.11.14",
     "prettier": "3.5.3",
-    "tsx": "^4.19.2",
+    "tsx": "^4.20.3",
     "typedoc": "^0.28.2",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.29.1",
-    "vitest": "^3.0.5"
+    "typescript-eslint": "^8.34.1",
+    "vitest": "^3.2.4"
   },
   "engines": {
     "npm": ">=7.0.0",
-    "node": ">=20.0.0"
+    "node": ">=20.19"
   },
   "module": "./dist/esm/index.js",
   "main": "./dist/cjs/index.js",
+  "bin": "dist/esm/cli/index.mjs",
   "exports": {
     ".": {
       "import": "./dist/esm/index.js",
@@ -67,17 +71,13 @@
       "import": "./dist/esm/providers/cross-chain-transfer-protocol/index.js",
       "require": "./dist/cjs/providers/cross-chain-transfer-protocol/index.js"
     },
-    "./providers/developer-controlled-wallets": {
-      "import": "./dist/esm/providers/developer-controlled-wallets/index.js",
-      "require": "./dist/cjs/providers/developer-controlled-wallets/index.js"
+    "./providers/circle-wallets": {
+      "import": "./dist/esm/providers/circle-wallets/index.js",
+      "require": "./dist/cjs/providers/circle-wallets/index.js"
     },
-    "./providers/faucet": {
-      "import": "./dist/esm/providers/faucet/index.js",
-      "require": "./dist/cjs/providers/faucet/index.js"
-    },
-    "./providers/smart-contract-platform": {
-      "import": "./dist/esm/providers/smart-contract-platform/index.js",
-      "require": "./dist/cjs/providers/smart-contract-platform/index.js"
+    "./providers/uniswap": {
+      "import": "./dist/esm/providers/uniswap/index.js",
+      "require": "./dist/cjs/providers/uniswap/index.js"
     },
     "./utils": {
       "import": "./dist/esm/utils/index.js",

package/dist/cjs/actions/drainFrom.d.ts

@@ -1,16 +0,0 @@
-import type { TransferReturnType, TransferParams } from './transfer.js';
-import type { ControlFlowOptions, ExtendedViemClient } from '../types.js';
-/**
- * Parameters for draining tokens from accounts, excluding the amount parameter.
- */
-export type DrainFromParams = Omit<TransferParams, 'amount'>;
-export type DrainFromReturnType = TransferReturnType;
-/**
- * Calculates the token balance for each provided account and calls {@link transfer} with the calculated amount.
- *
- * @param client - The client instance to use for the operation.
- * @param params - Parameters for the drain operation, excluding amount which is determined automatically.
- * @returns An array of transfer results.
- */
-export declare function drainFrom(client: ExtendedViemClient, params: DrainFromParams & ControlFlowOptions): Promise<DrainFromReturnType>;
-//# sourceMappingURL=drainFrom.d.ts.map

package/dist/cjs/actions/drainFrom.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"drainFrom.d.ts","sourceRoot":"","sources":["../../../src/actions/drainFrom.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,KAAK,EAAW,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAElF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;AAC5D,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAAA;AAEpD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,eAAe,GAAG,kBAAkB,GAC3C,OAAO,CAAC,mBAAmB,CAAC,CAgB9B"}

package/dist/cjs/actions/drainFrom.js

@@ -1,39 +0,0 @@
-"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.drainFrom = drainFrom;
-const utils_1 = require("viem/utils");
-const getTokenBalances_js_1 = require("../providers/developer-controlled-wallets/actions/getTokenBalances.js");
-const transfer_js_1 = require("./transfer.js");
-/**
- * Calculates the token balance for each provided account and calls {@link transfer} with the calculated amount.
- *
- * @param client - The client instance to use for the operation.
- * @param params - Parameters for the drain operation, excluding amount which is determined automatically.
- * @returns An array of transfer results.
- */
-async function drainFrom(client, params) {
-    const getTokenBalances = (0, utils_1.getAction)(client, getTokenBalances_js_1.getTokenBalances, 'getTokenBalances');
-    const { token = null } = params;
-    /**
-     * Gets the current balance of tokens for an account to be drained.
-     *
-     * @param account - The account to check the balance for
-     * @returns The current balance in base units, or 0n if no balance is found
-     */
-    async function zeroAmount(account) {
-        const balances = (await getTokenBalances({ account, token }));
-        return balances.at(0)?.value ?? 0n;
-    }
-    return await (0, transfer_js_1.transfer)(client, { ...params, amount: zeroAmount });
-}
-//# sourceMappingURL=drainFrom.js.map

package/dist/cjs/actions/drainFrom.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"drainFrom.js","sourceRoot":"","sources":["../../../src/actions/drainFrom.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAwBnF,8BAmBC;AAzCD,sCAAsC;AAEtC,+GAA6H;AAE7H,+CAAwC;AAWxC;;;;;;GAMG;AACI,KAAK,UAAU,SAAS,CAC7B,MAA0B,EAC1B,MAA4C;IAE5C,MAAM,gBAAgB,GAAG,IAAA,iBAAS,EAAC,MAAM,EAAE,sCAAiB,EAAE,kBAAkB,CAAC,CAAA;IACjF,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;IAE/B;;;;;OAKG;IACH,KAAK,UAAU,UAAU,CAAC,OAAgB;QACxC,MAAM,QAAQ,GAAG,CAAC,MAAM,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAwB,CAAA;QACpF,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAA;IACpC,CAAC;IAED,OAAO,MAAM,IAAA,sBAAQ,EAAC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;AAClE,CAAC"}

package/dist/cjs/actions/drainFrom.test.d.ts

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

package/dist/cjs/actions/drainFrom.test.d.ts.map

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

package/dist/cjs/actions/drainFrom.test.js

@@ -1,73 +0,0 @@
-"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 drainFrom_js_1 = require("./drainFrom.js");
-(0, vitest_1.describe)('drainFrom()', () => {
-    (0, vitest_1.afterEach)(() => {
-        vitest_1.vi.restoreAllMocks();
-    });
-    const client = {
-        chain: index_js_1.ETH_SEPOLIA,
-        getContract: vitest_1.vi.fn(({ address }) => ({
-            address,
-            read: {
-                decimals: vitest_1.vi.fn(() => 6),
-            },
-        })),
-        estimateTransferFee: vitest_1.vi.fn(() => ({
-            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' },
-        })),
-        createTransaction: vitest_1.vi.fn(() => ({
-            id: 'transaction-id',
-            state: 'COMPLETE',
-            txHash: 'tx-hash',
-        })),
-        waitForTransactionHash: vitest_1.vi.fn(({ id }) => ({
-            id,
-            state: 'COMPLETE',
-            txHash: 'tx-hash',
-        })),
-        waitForTransactionReceipt: vitest_1.vi.fn(() => { }),
-        getTokenBalances: vitest_1.vi.fn(() => [
-            {
-                token: '0x1c7d4b196cb0c7b01d743fbc6116a902379c7238',
-                decimals: 6,
-                symbol: 'USDC',
-                value: 1237999924n,
-                formatted: '1237.999924',
-            },
-        ]),
-    };
-    (0, vitest_1.it)('should call transfer() with the full amount of account', async () => {
-        const params = {
-            from: { address: '0x123', type: 'json-rpc' },
-            to: { address: '0x321', type: 'json-rpc' },
-            token: index_js_1.ETH_SEPOLIA.contracts.USDC,
-        };
-        const expectedResult = [{ hash: 'tx-hash' }];
-        const result = await (0, drainFrom_js_1.drainFrom)(client, params);
-        (0, vitest_1.expect)(result).toEqual(expectedResult);
-        (0, vitest_1.expect)(client.createTransaction).toHaveBeenCalledWith({
-            sourceAddress: params.from.address,
-            destinationAddress: params.to.address,
-            blockchain: 'ETH-SEPOLIA',
-            amounts: ['1237.999924'],
-            tokenAddress: params.token.address,
-            fee: { type: 'absolute', config: { gasLimit: '3', maxFee: '6', priorityFee: '9' } },
-        });
-    });
-});
-//# sourceMappingURL=drainFrom.test.js.map

package/dist/cjs/actions/drainFrom.test.js.map

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

package/dist/cjs/actions/parseUnitsAsToken.d.ts

@@ -1,37 +0,0 @@
-import type { Address, NativeUnits, BaseUnits, ExtendedViemClient } from '../types.js';
-import type { Chain, ChainContract } from 'viem';
-export type ParseUnitsAsTokenParams = {
-    /** The amount to transfer. */
-    value: NativeUnits | BaseUnits;
-    /** The token address (optional). */
-    token?: Address | ChainContract | null;
-    /** The blockchain chain to use (optional, defaults to client's chain). */
-    chain?: Chain;
-};
-/**
- * Parses a given value into the appropriate token units based on the specified chain and token.
- *
- * @param client - The client instance to use for the operation.
- * @returns The parsed token value in base units.
- *
- * @example
- * ```typescript
- * const link = await parseUnitsAsToken(client, {
- *   value: '1',
- *   chain: ETH_SEPOLIA,
- * });
- * // => 1000000000000000000n
- * ```
- *
- * @example
- * ```typescript
- * const link = await parseUnitsAsToken(client, {
- *   value: '1',
- *   chain: ETH_SEPOLIA,
- *   token: ETH_SEPOLIA.contracts.USDC,
- * });
- * // => 1000000n
- * ```
- */
-export declare function parseUnitsAsToken(client: ExtendedViemClient, params: ParseUnitsAsTokenParams): Promise<BaseUnits>;
-//# sourceMappingURL=parseUnitsAsToken.d.ts.map

package/dist/cjs/actions/parseUnitsAsToken.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseUnitsAsToken.d.ts","sourceRoot":"","sources":["../../../src/actions/parseUnitsAsToken.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACtF,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAEhD,MAAM,MAAM,uBAAuB,GAAG;IACpC,8BAA8B;IAC9B,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;IAC9B,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAAA;IACtC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,SAAS,CAAC,CA+BpB"}

package/dist/cjs/actions/parseUnitsAsToken.js

@@ -1,75 +0,0 @@
-"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.parseUnitsAsToken = parseUnitsAsToken;
-const viem_1 = require("viem");
-const utils_1 = require("viem/utils");
-const getContract_js_1 = require("../providers/smart-contract-platform/actions/getContract.js");
-const getChainContractByAddress_js_1 = require("../utils/getChainContractByAddress.js");
-const parseAddress_js_1 = require("../utils/parseAddress.js");
-const parseUnits_js_1 = require("../utils/parseUnits.js");
-/**
- * Parses a given value into the appropriate token units based on the specified chain and token.
- *
- * @param client - The client instance to use for the operation.
- * @returns The parsed token value in base units.
- *
- * @example
- * ```typescript
- * const link = await parseUnitsAsToken(client, {
- *   value: '1',
- *   chain: ETH_SEPOLIA,
- * });
- * // => 1000000000000000000n
- * ```
- *
- * @example
- * ```typescript
- * const link = await parseUnitsAsToken(client, {
- *   value: '1',
- *   chain: ETH_SEPOLIA,
- *   token: ETH_SEPOLIA.contracts.USDC,
- * });
- * // => 1000000n
- * ```
- */
-async function parseUnitsAsToken(client, params) {
-    const { value, token: _token, chain = client.chain } = params;
-    const token = _token != null ? (0, parseAddress_js_1.parseAddress)(_token) : null;
-    // Skip parsing
-    if (typeof value === 'bigint')
-        return value;
-    // Parse as native token
-    if (token == null)
-        return (0, parseUnits_js_1.parseUnits)(value, chain.nativeCurrency.decimals);
-    let chainContract = undefined;
-    try {
-        // Parse as local chain contract
-        chainContract = (0, getChainContractByAddress_js_1.getChainContractByAddress)(chain, token.address);
-    }
-    catch (error) {
-        if (!(error instanceof viem_1.ChainDoesNotSupportContract))
-            throw error;
-    }
-    // @ts-expect-error: Ignore ts(2331) for `read` property
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
-    const decimalsFn = chainContract?.read?.decimals;
-    if (typeof decimalsFn === 'function')
-        return (0, parseUnits_js_1.parseUnits)(value, decimalsFn());
-    // Parse by fetching token contract
-    const getContract = (0, utils_1.getAction)(client, getContract_js_1.getContract, 'getContract');
-    const contract = await getContract({ chain, ...token });
-    // @ts-expect-error: Ignore ts(2331) for `read` property
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-call, @typescript-eslint/no-unsafe-member-access
-    return (0, parseUnits_js_1.parseUnits)(value, (await contract.read.decimals()));
-}
-//# sourceMappingURL=parseUnitsAsToken.js.map

package/dist/cjs/actions/parseUnitsAsToken.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseUnitsAsToken.js","sourceRoot":"","sources":["../../../src/actions/parseUnitsAsToken.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AA+CnF,8CAkCC;AA/ED,+BAAkD;AAClD,sCAAsC;AAEtC,gGAAyG;AACzG,wFAAiF;AACjF,8DAAuD;AACvD,0DAAmD;AAcnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACI,KAAK,UAAU,iBAAiB,CACrC,MAA0B,EAC1B,MAA+B;IAE/B,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,MAAM,CAAA;IAC7D,MAAM,KAAK,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAA,8BAAY,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAE1D,eAAe;IACf,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE3C,wBAAwB;IACxB,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAA,0BAAU,EAAC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAA;IAE1E,IAAI,aAAa,GAA8B,SAAS,CAAA;IAExD,IAAI,CAAC;QACH,gCAAgC;QAChC,aAAa,GAAG,IAAA,wDAAyB,EAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,kCAA2B,CAAC;YAAE,MAAM,KAAK,CAAA;IAClE,CAAC;IAED,wDAAwD;IACxD,sEAAsE;IACtE,MAAM,UAAU,GAAG,aAAa,EAAE,IAAI,EAAE,QAAsC,CAAA;IAC9E,IAAI,OAAO,UAAU,KAAK,UAAU;QAAE,OAAO,IAAA,0BAAU,EAAC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAA;IAE5E,mCAAmC;IACnC,MAAM,WAAW,GAAG,IAAA,iBAAS,EAAC,MAAM,EAAE,4BAAY,EAAE,aAAa,CAAC,CAAA;IAClE,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;IAEvD,wDAAwD;IACxD,yGAAyG;IACzG,OAAO,IAAA,0BAAU,EAAC,KAAK,EAAE,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAW,CAAC,CAAA;AACtE,CAAC"}

package/dist/cjs/actions/parseUnitsAsToken.test.d.ts.map

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

package/dist/cjs/actions/parseUnitsAsToken.test.js

@@ -1,61 +0,0 @@
-"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 parseUnitsAsToken_js_1 = require("./parseUnitsAsToken.js");
-vitest_1.describe.concurrent('parseUnitsAsToken', () => {
-    const client = {
-        chain: index_js_1.ETH_SEPOLIA,
-        getContract: vitest_1.vi.fn(({ address }) => ({
-            address,
-            read: {
-                decimals: vitest_1.vi.fn(() => 9),
-            },
-        })),
-    };
-    vitest_1.test.each([
-        [
-            'bigint as input',
-            {
-                value: 1n,
-            },
-            1n,
-        ],
-        [
-            'native token',
-            {
-                value: '1',
-            },
-            1000000000000000000n,
-        ],
-        [
-            'local chain contract',
-            {
-                value: '1',
-                token: index_js_1.ETH_SEPOLIA.contracts.USDC,
-            },
-            1000000n,
-        ],
-        [
-            'remote chain contract',
-            {
-                value: '1',
-                token: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7239',
-            },
-            1000000000n,
-        ],
-    ])('should return the parsed value as token base units using %s', async (_, params, expectedResult) => {
-        await (0, vitest_1.expect)((0, parseUnitsAsToken_js_1.parseUnitsAsToken)(client, params)).resolves.toBe(expectedResult);
-    });
-});
-//# sourceMappingURL=parseUnitsAsToken.test.js.map

package/dist/cjs/actions/parseUnitsAsToken.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parseUnitsAsToken.test.js","sourceRoot":"","sources":["../../../src/actions/parseUnitsAsToken.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,mCAAmD;AAEnD,iDAAgD;AAEhD,iEAA0D;AAI1D,iBAAQ,CAAC,UAAU,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAC5C,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,sBAAW;QAClB,WAAW,EAAE,WAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAuB,EAAE,EAAE,CAAC,CAAC;YACxD,OAAO;YACP,IAAI,EAAE;gBACJ,QAAQ,EAAE,WAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;aACzB;SACF,CAAC,CAAC;KAC6B,CAAA;IAElC,aAAI,CAAC,IAAI,CAAC;QACR;YACE,iBAAiB;YACjB;gBACE,KAAK,EAAE,EAAE;aACV;YACD,EAAE;SACH;QACD;YACE,cAAc;YACd;gBACE,KAAK,EAAE,GAAG;aACX;YACD,oBAAoB;SACrB;QACD;YACE,sBAAsB;YACtB;gBACE,KAAK,EAAE,GAAG;gBACV,KAAK,EAAE,sBAAW,CAAC,SAAS,CAAC,IAAI;aAClC;YACD,QAAQ;SACT;QACD;YACE,uBAAuB;YACvB;gBACE,KAAK,EAAE,GAAG;gBACV,KAAK,EAAE,4CAA4C;aACpD;YACD,WAAW;SACZ;KACO,CAAC,CAAC,6DAA6D,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE;QAC7G,MAAM,IAAA,eAAM,EAAC,IAAA,wCAAiB,EAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC/E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/cjs/providers/cross-chain-transfer-protocol/provider.d.ts

@@ -1,35 +0,0 @@
-import { Provider as BaseProvider } from '../index.js';
-export declare const TESTNET_BASE_URL = "https://iris-api-sandbox.circle.com";
-export declare const MAINNET_BASE_URL = "https://iris-api.circle.com";
-export type ListMessagesParams = {
-    /** The source domain ID associated with the messages. */
-    sourceDomainId: number | string;
-    /** Whether sourceDomainId is testnet or not */
-    isTestnet?: boolean;
-    /** The transaction hash to filter messages */
-    transactionHash: string;
-};
-export type Message = {
-    /** The hex-encoded message. Null if the attestation is not yet available.  */
-    message: string;
-    /** The nonce associated with the message */
-    nonce: string;
-    /** The attestation. Null if not yet available. */
-    attestation: string | null;
-    /** The CCTP version of the message. */
-    cctpVersion: number;
-    /** The status of the message. */
-    status: 'pending_confirmations' | 'complete';
-};
-export type ListMessagesReturnType = Message[];
-export type EIP1474Methods = [
-    {
-        Method: 'circle_listMessages';
-        Parameters: [ListMessagesParams];
-        ReturnType: ListMessagesReturnType;
-    }
-];
-export declare class Provider extends BaseProvider {
-    circle_listMessages(params: ListMessagesParams): Promise<ListMessagesReturnType>;
-}
-//# sourceMappingURL=provider.d.ts.map

package/dist/cjs/providers/cross-chain-transfer-protocol/provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/providers/cross-chain-transfer-protocol/provider.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,aAAa,CAAA;AAEtD,eAAO,MAAM,gBAAgB,wCAAwC,CAAA;AACrE,eAAO,MAAM,gBAAgB,gCAAgC,CAAA;AAE7D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,yDAAyD;IACzD,cAAc,EAAE,MAAM,GAAG,MAAM,CAAA;IAC/B,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAA;IACf,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAA;IACnB,iCAAiC;IACjC,MAAM,EAAE,uBAAuB,GAAG,UAAU,CAAA;CAC7C,CAAA;AACD,MAAM,MAAM,sBAAsB,GAAG,OAAO,EAAE,CAAA;AAE9C,MAAM,MAAM,cAAc,GAAG;IAC3B;QACE,MAAM,EAAE,qBAAqB,CAAA;QAC7B,UAAU,EAAE,CAAC,kBAAkB,CAAC,CAAA;QAChC,UAAU,EAAE,sBAAsB,CAAA;KACnC;CACF,CAAA;AAED,qBAAa,QAAS,SAAQ,YAAY;IAC3B,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAoB9F"}

package/dist/cjs/providers/cross-chain-transfer-protocol/provider.js

@@ -1,36 +0,0 @@
-"use strict";
-// Copyright (c) 2025, Circle Internet Group, Inc.
-// All rights reserved.
-//
-// Circle Internet Group, Inc. CONFIDENTIAL
-//
-// This file includes unpublished proprietary source code of Circle Internet
-// Group, Inc. The copyright notice above does not
-// evidence any actual or intended publication of such source code. Disclosure
-// of this source code or any related proprietary information is strictly
-// prohibited without the express written permission of Circle Internet Group, Inc.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Provider = exports.MAINNET_BASE_URL = exports.TESTNET_BASE_URL = void 0;
-const index_js_1 = require("../index.js");
-exports.TESTNET_BASE_URL = 'https://iris-api-sandbox.circle.com';
-exports.MAINNET_BASE_URL = 'https://iris-api.circle.com';
-class Provider extends index_js_1.Provider {
-    async circle_listMessages(params) {
-        const { sourceDomainId, transactionHash, isTestnet = false } = params;
-        const baseUrl = isTestnet ? exports.TESTNET_BASE_URL : exports.MAINNET_BASE_URL;
-        const queryparams = new URLSearchParams({ transactionHash });
-        const path = new URL(`/v2/messages/${sourceDomainId}?${queryparams}`, baseUrl);
-        const response = await fetch(path);
-        if (response.status !== 200) {
-            if (response.status === 404) {
-                return [];
-            }
-            const json = (await response.json());
-            throw new Error(`${response.status}: ${json?.error ?? 'Error'}`, { cause: response });
-        }
-        const { messages } = (await response.json());
-        return messages;
-    }
-}
-exports.Provider = Provider;
-//# sourceMappingURL=provider.js.map

package/dist/cjs/providers/cross-chain-transfer-protocol/provider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/providers/cross-chain-transfer-protocol/provider.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;;AAEnF,0CAAsD;AAEzC,QAAA,gBAAgB,GAAG,qCAAqC,CAAA;AACxD,QAAA,gBAAgB,GAAG,6BAA6B,CAAA;AAiC7D,MAAa,QAAS,SAAQ,mBAAY;IACjC,KAAK,CAAC,mBAAmB,CAAC,MAA0B;QACzD,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,MAAM,CAAA;QACrE,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,wBAAgB,CAAC,CAAC,CAAC,wBAAgB,CAAA;QAE/D,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,EAAE,eAAe,EAAE,CAAC,CAAA;QAC5D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,gBAAgB,cAAc,IAAI,WAAW,EAAE,EAAE,OAAO,CAAC,CAAA;QAC9E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;QAElC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,OAAO,EAAE,CAAA;YACX,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAA;YAEzD,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,KAAK,IAAI,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;QACvF,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyC,CAAA;QACpF,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF;AArBD,4BAqBC"}

package/dist/cjs/providers/cross-chain-transfer-protocol/provider.test.d.ts

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

package/dist/cjs/providers/cross-chain-transfer-protocol/provider.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provider.test.d.ts","sourceRoot":"","sources":["../../../../src/providers/cross-chain-transfer-protocol/provider.test.ts"],"names":[],"mappings":""}