@circle-fin/usdckit 0.13.0 → 0.15.0

package/dist/cjs/types.d.ts

@@ -22,8 +22,9 @@ export type ExtendedEIP1474Methods = [
     ...EIP1474Methods
 ];
 export type ExtendedViemClient<transport extends Transport = Transport, chain extends Chain = Chain> = Client<transport, chain, Account, ExtendedEIP1474Methods>;
-export type CircleClient = Client & {
+export type CircleClient = Omit<Client, 'chain'> & {
     logger: Logger;
+    chain: NonNullable<Client['chain']>;
 } & PublicActions & WalletActions & DeveloperControlledWalletActions & SmartContractPlatformActions & FaucetActions & CrossChainTransferProtocolActions & CoreActions;
 /**
  * The primary denomination of a blockchain’s currency
@@ -46,4 +47,29 @@ export interface Stringifyable {
     toString(): string;
     toJSON(): string;
 }
+export type ControlFlowOptions = {
+    /**
+     * Caller provided Abort signal to cancel long running tasks
+     *
+     * @example
+     * Using [AbortController](https://nodejs.org/api/globals.html#class-abortcontroller)
+     * ```typescript
+     * const controller = new AbortController();
+     * setTimeout(() => controller.abort(), 5000);
+     *
+     * action({
+     *    signal: controller.signal,
+     * })
+     * ```
+     *
+     * @example
+     * Using [AbortSignal](https://nodejs.org/api/globals.html#class-abortsignal)
+     * ```typescript
+     * action({
+     *   signal: AbortSignal.timeout(5000),
+     * })
+     * ```
+     * */
+    signal?: AbortSignal;
+};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +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,4BAA4B,EAAE,MAAM,sDAAsD,CAAA;AACnH,OAAO,KAAK,EAAE,cAAc,IAAI,4BAA4B,EAAE,MAAM,iDAAiD,CAAA;AACrH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,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,4BAA4B;IAC/B,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,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,GACpE,aAAa,GACb,gCAAgC,GAChC,4BAA4B,GAC5B,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"}
+{"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,4BAA4B,EAAE,MAAM,sDAAsD,CAAA;AACnH,OAAO,KAAK,EAAE,cAAc,IAAI,4BAA4B,EAAE,MAAM,iDAAiD,CAAA;AACrH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,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,4BAA4B;IAC/B,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,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;CACpC,GAAG,aAAa,GACf,aAAa,GACb,gCAAgC,GAChC,4BAA4B,GAC5B,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;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;;;;;;;;;;;;;;;;SAqBK;IACL,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA"}

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

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

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

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

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

@@ -0,0 +1,18 @@
+import type { Address } from '../types.js';
+import type { Chain, ChainContract } from 'viem';
+/**
+ * Retrieves the contract associated with a given address from the specified chain.
+ *
+ * @param chain - The chain from which to retrieve the contract.
+ * @param address - The address of the contract to retrieve.
+ * @returns The contract associated with the given address.
+ * @throws {@link ChainDoesNotSupportContract} If the chain does not support the contract.
+ *
+ * @example
+ * ```typescript
+ * getChainContractByAddress(ETH_SEPOLIA, '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238')
+ * // => { address: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238' }
+ * ```
+ */
+export declare function getChainContractByAddress(chain: Chain, address: Address): ChainContract;
+//# sourceMappingURL=getChainContractByAddress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getChainContractByAddress.d.ts","sourceRoot":"","sources":["../../../src/utils/getChainContractByAddress.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAYvF"}

package/dist/cjs/utils/getChainContractByAddress.js

@@ -0,0 +1,40 @@
+"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.getChainContractByAddress = getChainContractByAddress;
+const viem_1 = require("viem");
+/**
+ * Retrieves the contract associated with a given address from the specified chain.
+ *
+ * @param chain - The chain from which to retrieve the contract.
+ * @param address - The address of the contract to retrieve.
+ * @returns The contract associated with the given address.
+ * @throws {@link ChainDoesNotSupportContract} If the chain does not support the contract.
+ *
+ * @example
+ * ```typescript
+ * getChainContractByAddress(ETH_SEPOLIA, '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238')
+ * // => { address: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238' }
+ * ```
+ */
+function getChainContractByAddress(chain, address) {
+    const chainContracts = chain?.contracts;
+    const chainContract = Object.values(chainContracts).find((contract) => contract.address === address);
+    if (!chainContract) {
+        throw new viem_1.ChainDoesNotSupportContract({
+            chain,
+            contract: { name: address },
+        });
+    }
+    return chainContract;
+}
+//# sourceMappingURL=getChainContractByAddress.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getChainContractByAddress.js","sourceRoot":"","sources":["../../../src/utils/getChainContractByAddress.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAqBnF,8DAYC;AA/BD,+BAAkD;AAKlD;;;;;;;;;;;;;GAaG;AACH,SAAgB,yBAAyB,CAAC,KAAY,EAAE,OAAgB;IACtE,MAAM,cAAc,GAAG,KAAK,EAAE,SAA0C,CAAA;IACxE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,KAAK,OAAO,CAAC,CAAA;IAEpG,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,kCAA2B,CAAC;YACpC,KAAK;YACL,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SAC5B,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,aAAa,CAAA;AACtB,CAAC"}

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

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

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

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

package/dist/cjs/utils/getChainContractByAddress.test.js

@@ -0,0 +1,31 @@
+"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 viem_1 = require("viem");
+const vitest_1 = require("vitest");
+const index_js_1 = require("../chains/index.js");
+const getChainContractByAddress_js_1 = require("./getChainContractByAddress.js");
+vitest_1.describe.concurrent('getChainContractByAddress', () => {
+    vitest_1.test.each([
+        [[index_js_1.ETH_SEPOLIA, '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238'], index_js_1.ETH_SEPOLIA.contracts.USDC],
+        [[index_js_1.MATIC_AMOY, '0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582'], index_js_1.MATIC_AMOY.contracts.USDC],
+    ])('should get the corresponding ChainContract', ([chain, address], expectedResult) => {
+        (0, vitest_1.expect)((0, getChainContractByAddress_js_1.getChainContractByAddress)(chain, address)).toBe(expectedResult);
+    });
+    vitest_1.test.each([
+        [[index_js_1.ETH_SEPOLIA, '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7237']],
+        [[index_js_1.MATIC_AMOY, '0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7581']],
+    ])('should throw an error for not found', ([chain, address]) => {
+        (0, vitest_1.expect)(() => (0, getChainContractByAddress_js_1.getChainContractByAddress)(chain, address)).toThrowError(viem_1.ChainDoesNotSupportContract);
+    });
+});
+//# sourceMappingURL=getChainContractByAddress.test.js.map

package/dist/cjs/utils/getChainContractByAddress.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getChainContractByAddress.test.js","sourceRoot":"","sources":["../../../src/utils/getChainContractByAddress.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,+BAAkD;AAClD,mCAA+C;AAE/C,iDAA4D;AAE5D,iFAA0E;AAE1E,iBAAQ,CAAC,UAAU,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACpD,aAAI,CAAC,IAAI,CAAC;QACR,CAAC,CAAC,sBAAW,EAAE,4CAA4C,CAAC,EAAE,sBAAW,CAAC,SAAS,CAAC,IAAI,CAAC;QACzF,CAAC,CAAC,qBAAU,EAAE,4CAA4C,CAAC,EAAE,qBAAU,CAAC,SAAS,CAAC,IAAI,CAAC;KAC/E,CAAC,CAAC,4CAA4C,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,EAAE;QAC7F,IAAA,eAAM,EAAC,IAAA,wDAAyB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;IAEF,aAAI,CAAC,IAAI,CAAC;QACR,CAAC,CAAC,sBAAW,EAAE,4CAA4C,CAAC,CAAC;QAC7D,CAAC,CAAC,qBAAU,EAAE,4CAA4C,CAAC,CAAC;KACpD,CAAC,CAAC,qCAAqC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE;QACtE,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,wDAAyB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,kCAA2B,CAAC,CAAA;IACnG,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -1,6 +1,10 @@
-export { generateIdempotencyKey } from './generateIdempotencyKey.js';
-export { formatUnits } from './formatUnits.js';
-export { parseUnits } from './parseUnits.js';
-export * from './toERC681.js';
+export * from './formatUnits.js';
+export * from './generateIdempotencyKey.js';
+export * from './getChainContractByAddress.js';
+export * from './max.js';
 export * from './parseAccount.js';
+export * from './parseAddress.js';
+export * from './parseUnits.js';
+export * from './toERC681.js';
+export * from './wrapAsync.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAWA,cAAc,kBAAkB,CAAA;AAChC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,UAAU,CAAA;AACxB,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA"}

package/dist/cjs/utils/index.js

@@ -24,13 +24,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseUnits = exports.formatUnits = exports.generateIdempotencyKey = void 0;
-var generateIdempotencyKey_js_1 = require("./generateIdempotencyKey.js");
-Object.defineProperty(exports, "generateIdempotencyKey", { enumerable: true, get: function () { return generateIdempotencyKey_js_1.generateIdempotencyKey; } });
-var formatUnits_js_1 = require("./formatUnits.js");
-Object.defineProperty(exports, "formatUnits", { enumerable: true, get: function () { return formatUnits_js_1.formatUnits; } });
-var parseUnits_js_1 = require("./parseUnits.js");
-Object.defineProperty(exports, "parseUnits", { enumerable: true, get: function () { return parseUnits_js_1.parseUnits; } });
-__exportStar(require("./toERC681.js"), exports);
+__exportStar(require("./formatUnits.js"), exports);
+__exportStar(require("./generateIdempotencyKey.js"), exports);
+__exportStar(require("./getChainContractByAddress.js"), exports);
+__exportStar(require("./max.js"), exports);
 __exportStar(require("./parseAccount.js"), exports);
+__exportStar(require("./parseAddress.js"), exports);
+__exportStar(require("./parseUnits.js"), exports);
+__exportStar(require("./toERC681.js"), exports);
+__exportStar(require("./wrapAsync.js"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;;;;;;;;;;;;;;;;AAEnF,yEAAoE;AAA3D,mIAAA,sBAAsB,OAAA;AAC/B,mDAA8C;AAArC,6GAAA,WAAW,OAAA;AACpB,iDAA4C;AAAnC,2GAAA,UAAU,OAAA;AACnB,gDAA6B;AAC7B,oDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;;;;;;;;;;;;;;;AAEnF,mDAAgC;AAChC,8DAA2C;AAC3C,iEAA8C;AAC9C,2CAAwB;AACxB,oDAAiC;AACjC,oDAAiC;AACjC,kDAA+B;AAC/B,gDAA6B;AAC7B,iDAA8B"}

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

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

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

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

package/dist/cjs/utils/index.test.js

@@ -0,0 +1,78 @@
+"use strict";
+// Copyright (c) 2025, Circle Internet Group, Inc.
+// All rights reserved.
+//
+// Circle Internet Group, Inc. CONFIDENTIAL
+//
+// This file includes unpublished proprietary source code of Circle Internet
+// Group, Inc. The copyright notice above does not
+// evidence any actual or intended publication of such source code. Disclosure
+// of this source code or any related proprietary information is strictly
+// prohibited without the express written permission of Circle Internet Group, Inc.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const mod = __importStar(require("./index.js"));
+vitest_1.describe.concurrent('utils', () => {
+    (0, vitest_1.afterEach)(() => {
+        vitest_1.vi.restoreAllMocks();
+    });
+    (0, vitest_1.it)('should return an object with the expected methods', () => {
+        (0, vitest_1.expect)(new Set(Object.keys(mod))).toEqual(new Set([
+            'InvalidDecimalNumberError',
+            'formatUnits',
+            'generateIdempotencyKey',
+            'getChainContractByAddress',
+            'max',
+            'parseAccount',
+            'parseAddress',
+            'parseUnits',
+            'parseAddress',
+            'toERC681',
+            'wrapAsync',
+        ]));
+        (0, vitest_1.expect)(mod.InvalidDecimalNumberError).toBeDefined();
+        (0, vitest_1.expect)(mod.formatUnits).toEqual(vitest_1.expect.any(Function));
+        (0, vitest_1.expect)(mod.generateIdempotencyKey).toEqual(vitest_1.expect.any(Function));
+        (0, vitest_1.expect)(mod.getChainContractByAddress).toEqual(vitest_1.expect.any(Function));
+        (0, vitest_1.expect)(mod.max).toEqual(vitest_1.expect.any(Function));
+        (0, vitest_1.expect)(mod.parseAccount).toEqual(vitest_1.expect.any(Function));
+        (0, vitest_1.expect)(mod.parseAddress).toEqual(vitest_1.expect.any(Function));
+        (0, vitest_1.expect)(mod.parseUnits).toEqual(vitest_1.expect.any(Function));
+        (0, vitest_1.expect)(mod.toERC681).toEqual(vitest_1.expect.any(Function));
+        (0, vitest_1.expect)(mod.wrapAsync).toEqual(vitest_1.expect.any(Function));
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/cjs/utils/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/utils/index.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,mCAA4D;AAE5D,gDAAiC;AAEjC,iBAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE;IAChC,IAAA,kBAAS,EAAC,GAAG,EAAE;QACb,WAAE,CAAC,eAAe,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,IAAA,WAAE,EAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,IAAA,eAAM,EAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CACvC,IAAI,GAAG,CAAC;YACN,2BAA2B;YAC3B,aAAa;YACb,wBAAwB;YACxB,2BAA2B;YAC3B,KAAK;YACL,cAAc;YACd,cAAc;YACd,YAAY;YACZ,cAAc;YACd,UAAU;YACV,WAAW;SACZ,CAAC,CACH,CAAA;QACD,IAAA,eAAM,EAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,WAAW,EAAE,CAAA;QACnD,IAAA,eAAM,EAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACrD,IAAA,eAAM,EAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAChE,IAAA,eAAM,EAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACnE,IAAA,eAAM,EAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC7C,IAAA,eAAM,EAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACtD,IAAA,eAAM,EAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACtD,IAAA,eAAM,EAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACpD,IAAA,eAAM,EAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAClD,IAAA,eAAM,EAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -1,5 +1,5 @@
 import type { TransferReturnType, TransferParams } from './transfer.js';
-import type { ExtendedViemClient } from '../types.js';
+import type { ControlFlowOptions, ExtendedViemClient } from '../types.js';
 /**
  * Parameters for draining tokens from accounts, excluding the amount parameter.
  */
@@ -12,5 +12,5 @@ export type DrainFromReturnType = TransferReturnType;
  * @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): Promise<DrainFromReturnType>;
+export declare function drainFrom(client: ExtendedViemClient, params: DrainFromParams & ControlFlowOptions): Promise<DrainFromReturnType>;
 //# sourceMappingURL=drainFrom.d.ts.map

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

@@ -1 +1 @@
-{"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,MAAM,aAAa,CAAA;AAE9D;;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,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgBjH"}
+{"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/esm/actions/drainFrom.js.map

@@ -1 +1 @@
-{"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;AAEnF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtC,OAAO,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,uEAAuE,CAAA;AAE7H,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAWxC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAA0B,EAAE,MAAuB;IACjF,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,EAAE,iBAAiB,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,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;AAClE,CAAC"}
+{"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;AAEnF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtC,OAAO,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,uEAAuE,CAAA;AAE7H,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAWxC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,MAA0B,EAC1B,MAA4C;IAE5C,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,EAAE,iBAAiB,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,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;AAClE,CAAC"}

package/dist/esm/actions/generateTransferLink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateTransferLink.d.ts","sourceRoot":"","sources":["../../../src/actions/generateTransferLink.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAY,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACzG,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAEhD,MAAM,MAAM,0BAA0B,GAAG;IACvC,6BAA6B;IAC7B,EAAE,EAAE,OAAO,GAAG,OAAO,CAAA;IACrB,8BAA8B;IAC9B,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;IAC/B,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAAA;IACtC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,MAAM,CAAC,CAgCjB"}
+{"version":3,"file":"generateTransferLink.d.ts","sourceRoot":"","sources":["../../../src/actions/generateTransferLink.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAY,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACzG,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAEhD,MAAM,MAAM,0BAA0B,GAAG;IACvC,6BAA6B;IAC7B,EAAE,EAAE,OAAO,GAAG,OAAO,CAAA;IACrB,8BAA8B;IAC9B,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;IAC/B,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAAA;IACtC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/esm/actions/generateTransferLink.js

@@ -10,9 +10,10 @@
 // prohibited without the express written permission of Circle Internet Group, Inc.
 import { getAction } from 'viem/utils';
 import { getContract as _getContract } from '../providers/smart-contract-platform/actions/getContract.js';
-import { parseAccount, parseUnits } from '../utils/index.js';
+import { parseAccount } from '../utils/parseAccount.js';
 import { parseAddress } from '../utils/parseAddress.js';
 import { toERC681 } from '../utils/toERC681.js';
+import { parseUnitsAsToken as _parseUnitsAsToken } from './parseUnitsAsToken.js';
 /**
  * Generates a ERC-681 transfer link for a specified recipient and amount.
  *
@@ -33,30 +34,24 @@ import { toERC681 } from '../utils/toERC681.js';
  * ```
  */
 export async function generateTransferLink(client, params) {
-    const { to, amount, chain = client.chain } = params;
-    const token = params.token != null ? parseAddress(params.token) : undefined;
+    const { to, amount: _amount, chain = client.chain } = params;
     const getContract = getAction(client, _getContract, 'getContract');
+    const parseUnitsAsToken = getAction(client, _parseUnitsAsToken, 'parseUnitsAsToken');
+    const token = params.token != null ? parseAddress(params.token) : undefined;
+    const tokenContract = token != null ? await getContract(token) : undefined;
     const toAccount = parseAccount(to);
-    const nativeCurrencyDecimals = chain.nativeCurrency.decimals;
-    let tokenContract;
-    let tokenCurrencyDecimals = nativeCurrencyDecimals;
-    if (token != null) {
-        tokenContract = (await getContract(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
-        tokenCurrencyDecimals = (await tokenContract.read.decimals());
-    }
+    const amount = await parseUnitsAsToken({ value: _amount, token: token?.address, chain });
     return tokenContract !== undefined
         ? toERC681({
             abi: tokenContract.abi,
             address: tokenContract.address,
             functionName: 'transfer',
-            args: [toAccount.address, parseUnits(amount, tokenCurrencyDecimals)],
+            args: [toAccount.address, amount],
             chainId: chain.id,
         })
         : toERC681({
             address: toAccount.address,
-            value: parseUnits(amount, nativeCurrencyDecimals),
+            value: amount,
             chainId: chain.id,
         });
 }

package/dist/esm/actions/generateTransferLink.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateTransferLink.js","sourceRoot":"","sources":["../../../src/actions/generateTransferLink.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,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtC,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,6DAA6D,CAAA;AACzG,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAgB/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA0B,EAC1B,MAAkC;IAElC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,MAAM,CAAA;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAE3E,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,CAAC,CAAA;IAElE,MAAM,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,CAAA;IAElC,MAAM,sBAAsB,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAA;IAC5D,IAAI,aAAmC,CAAA;IACvC,IAAI,qBAAqB,GAAG,sBAAsB,CAAA;IAElD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,aAAa,GAAG,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,CAAa,CAAA;QACtD,wDAAwD;QACxD,yGAAyG;QACzG,qBAAqB,GAAG,CAAC,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAW,CAAA;IACzE,CAAC;IAED,OAAO,aAAa,KAAK,SAAS;QAChC,CAAC,CAAC,QAAQ,CAAC;YACP,GAAG,EAAE,aAAa,CAAC,GAAG;YACtB,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,YAAY,EAAE,UAAU;YACxB,IAAI,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;YACpE,OAAO,EAAE,KAAK,CAAC,EAAE;SAClB,CAAC;QACJ,CAAC,CAAC,QAAQ,CAAC;YACP,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,sBAAsB,CAAC;YACjD,OAAO,EAAE,KAAK,CAAC,EAAE;SAClB,CAAC,CAAA;AACR,CAAC"}
+{"version":3,"file":"generateTransferLink.js","sourceRoot":"","sources":["../../../src/actions/generateTransferLink.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,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtC,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,6DAA6D,CAAA;AACzG,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE/C,OAAO,EAAE,iBAAiB,IAAI,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAgBhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAA0B,EAC1B,MAAkC;IAElC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,MAAM,CAAA;IAE5D,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,CAAC,CAAA;IAClE,MAAM,iBAAiB,GAAG,SAAS,CAAC,MAAM,EAAE,kBAAkB,EAAE,mBAAmB,CAAC,CAAA;IAEpF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAC3E,MAAM,aAAa,GAAyB,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IAEhG,MAAM,SAAS,GAAG,YAAY,CAAC,EAAE,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;IAExF,OAAO,aAAa,KAAK,SAAS;QAChC,CAAC,CAAC,QAAQ,CAAC;YACP,GAAG,EAAE,aAAa,CAAC,GAAG;YACtB,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,YAAY,EAAE,UAAU;YACxB,IAAI,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;YACjC,OAAO,EAAE,KAAK,CAAC,EAAE;SAClB,CAAC;QACJ,CAAC,CAAC,QAAQ,CAAC;YACP,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,KAAK,CAAC,EAAE;SAClB,CAAC,CAAA;AACR,CAAC"}

package/dist/esm/actions/index.d.ts

@@ -1,6 +1,8 @@
 import { drainFrom } from './drainFrom.js';
 import { generateTransferLink } from './generateTransferLink.js';
+import { parseUnitsAsToken } from './parseUnitsAsToken.js';
 import { transfer } from './transfer.js';
+import type { ParseUnitsAsTokenParams } from './parseUnitsAsToken.js';
 import type { Account } from '../types.js';
 import type { DrainFromParams } from './drainFrom.js';
 import type { GenerateTransferLinkParams } from './generateTransferLink.js';
@@ -9,10 +11,12 @@ import type { Chain, Client, Transport } from 'viem';
 export * from './transfer.js';
 export * from './drainFrom.js';
 export * from './generateTransferLink.js';
+export * from './parseUnitsAsToken.js';
 export type Actions<transport extends Transport = Transport, chain extends Chain | undefined = Chain | undefined, account extends Account | undefined = Account | undefined> = {
     transfer: (params: Parameters<typeof transfer>[1]) => ReturnType<typeof transfer>;
     drainFrom: (params: Parameters<typeof drainFrom>[1]) => ReturnType<typeof drainFrom>;
     generateTransferLink: (params: Parameters<typeof generateTransferLink>[1]) => ReturnType<typeof generateTransferLink>;
+    parseUnitsAsToken: (params: Parameters<typeof parseUnitsAsToken>[1]) => ReturnType<typeof parseUnitsAsToken>;
 };
 /**
  * Returns an object containing action functions bound to the provided client.
@@ -36,5 +40,6 @@ export declare function actions(client: Client): {
      */
     transfer: (params: TransferParams) => Promise<import("./transfer.js").TransferReturnType>;
     generateTransferLink: (params: GenerateTransferLinkParams) => Promise<string>;
+    parseUnitsAsToken: (params: ParseUnitsAsTokenParams) => Promise<bigint>;
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/actions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAEpD,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,2BAA2B,CAAA;AAGzC,MAAM,MAAM,OAAO,CAEjB,SAAS,SAAS,SAAS,GAAG,SAAS,EAEvC,KAAK,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EAEnD,OAAO,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,IACvD;IACF,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAA;IACjF,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA;IACpF,oBAAoB,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;CACtH,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM;IAElC;;;;;OAKG;wBACiB,eAAe;IAEnC;;;;;OAKG;uBACgB,cAAc;mCACF,0BAA0B;EAG5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,aAAa,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAEpD,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AAGtC,MAAM,MAAM,OAAO,CAEjB,SAAS,SAAS,SAAS,GAAG,SAAS,EAEvC,KAAK,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EAEnD,OAAO,SAAS,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,IACvD;IACF,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAA;IACjF,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA;IACpF,oBAAoB,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;IACrH,iBAAiB,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;CAC7G,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM;IAElC;;;;;OAKG;wBACiB,eAAe;IAEnC;;;;;OAKG;uBACgB,cAAc;mCACF,0BAA0B;gCAG7B,uBAAuB;EAEtD"}

package/dist/esm/actions/index.js

@@ -10,10 +10,12 @@
 // prohibited without the express written permission of Circle Internet Group, Inc.
 import { drainFrom } from './drainFrom.js';
 import { generateTransferLink } from './generateTransferLink.js';
+import { parseUnitsAsToken } from './parseUnitsAsToken.js';
 import { transfer } from './transfer.js';
 export * from './transfer.js';
 export * from './drainFrom.js';
 export * from './generateTransferLink.js';
+export * from './parseUnitsAsToken.js';
 /**
  * Returns an object containing action functions bound to the provided client.
  *
@@ -37,6 +39,7 @@ export function actions(client) {
          */
         transfer: (params) => transfer(client, params),
         generateTransferLink: (params) => generateTransferLink(client, params),
+        parseUnitsAsToken: (params) => parseUnitsAsToken(client, params),
     };
 }
 //# sourceMappingURL=index.js.map

package/dist/esm/actions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/index.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,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAQxC,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,2BAA2B,CAAA;AAgBzC;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,OAAO;QACL;;;;;WAKG;QACH,SAAS,EAAE,CAAC,MAAuB,EAAE,EAAE,CAAC,SAAS,CAAC,MAA4B,EAAE,MAAM,CAAC;QAEvF;;;;;WAKG;QACH,QAAQ,EAAE,CAAC,MAAsB,EAAE,EAAE,CAAC,QAAQ,CAAC,MAA4B,EAAE,MAAM,CAAC;QACpF,oBAAoB,EAAE,CAAC,MAAkC,EAAE,EAAE,CAC3D,oBAAoB,CAAC,MAA4B,EAAE,MAAM,CAAC;KAC7D,CAAA;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/index.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,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AASxC,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wBAAwB,CAAA;AAiBtC;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,OAAO;QACL;;;;;WAKG;QACH,SAAS,EAAE,CAAC,MAAuB,EAAE,EAAE,CAAC,SAAS,CAAC,MAA4B,EAAE,MAAM,CAAC;QAEvF;;;;;WAKG;QACH,QAAQ,EAAE,CAAC,MAAsB,EAAE,EAAE,CAAC,QAAQ,CAAC,MAA4B,EAAE,MAAM,CAAC;QACpF,oBAAoB,EAAE,CAAC,MAAkC,EAAE,EAAE,CAC3D,oBAAoB,CAAC,MAA4B,EAAE,MAAM,CAAC;QAE5D,iBAAiB,EAAE,CAAC,MAA+B,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAA4B,EAAE,MAAM,CAAC;KAChH,CAAA;AACH,CAAC"}

package/dist/esm/actions/index.test.js

@@ -23,6 +23,8 @@ describe.concurrent('actions', () => {
             // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
             generateTransferLink: expect.any(Function),
             // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+            parseUnitsAsToken: expect.any(Function),
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
             transfer: expect.any(Function),
         });
     });

package/dist/esm/actions/index.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/actions/index.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,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAIpC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,EAAE;IAClC,MAAM,MAAM,GAAG,EAAE,CAAA;IAEjB,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,MAA2B,CAAC,CAAA;QAEnD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,mEAAmE;YACnE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC/B,mEAAmE;YACnE,oBAAoB,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC1C,mEAAmE;YACnE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;SAC/B,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/actions/index.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,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAIpC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,EAAE;IAClC,MAAM,MAAM,GAAG,EAAE,CAAA;IAEjB,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,MAA2B,CAAC,CAAA;QAEnD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,mEAAmE;YACnE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC/B,mEAAmE;YACnE,oBAAoB,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAC1C,mEAAmE;YACnE,iBAAiB,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YACvC,mEAAmE;YACnE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;SAC/B,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,37 @@
+import { type Chain, type ChainContract } from 'viem';
+import type { Address, NativeUnits, BaseUnits, ExtendedViemClient } from '../types.js';
+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