@circle-fin/usdckit 0.17.1 → 0.19.0

package/dist/cjs/utils/getContract.js

@@ -0,0 +1,42 @@
+"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.getContract = getContract;
+const viem_1 = require("viem");
+/**
+ * Retrieves a contract instance using the provided address, ABI, and client.
+ *
+ * @param params - The input parameters for retrieving the contract.
+ * @throws {Error} Throws an error if the ABI is not provided and cannot be found in the chain's contracts.
+ * @returns The contract instance.
+ */
+function getContract(params) {
+    const { address } = params;
+    let { abi } = params;
+    const client = params.client ??
+        (0, viem_1.createPublicClient)({
+            chain: params.chain,
+            transport: (0, viem_1.http)(),
+        });
+    const chain = client.chain;
+    // If ABI is not provided, attempt to default to the chain's contract ABI
+    if (abi === undefined && chain?.contracts !== undefined) {
+        const chainContract = Object.values(chain.contracts).find((contract) => contract !== undefined && contract.address === address);
+        // @ts-expect-error: Ignore ts(2339) for `abi` property
+        abi = chainContract?.abi;
+    }
+    if (abi === undefined) {
+        throw new Error(`No ABI provided for contract at ${address}`);
+    }
+    return (0, viem_1.getContract)({ address, abi, client });
+}
+//# sourceMappingURL=getContract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getContract.js","sourceRoot":"","sources":["../../../src/utils/getContract.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AA4BnF,kCA2BC;AArDD,+BAA4E;AAmB5E;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,MAAwB;IAClD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IAC1B,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAAA;IAEpB,MAAM,MAAM,GACV,MAAM,CAAC,MAAM;QACb,IAAA,yBAAkB,EAAC;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,IAAA,WAAI,GAAE;SAClB,CAAC,CAAA;IACJ,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAE1B,yEAAyE;IACzE,IAAI,GAAG,KAAK,SAAS,IAAI,KAAK,EAAE,SAAS,KAAK,SAAS,EAAE,CAAC;QACxD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CACvD,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,IAAK,QAA0B,CAAC,OAAO,KAAK,OAAO,CAC3D,CAAA;QAE9B,uDAAuD;QACvD,GAAG,GAAG,aAAa,EAAE,GAAsB,CAAA;IAC7C,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,IAAA,kBAAY,EAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;AAC/C,CAAC"}

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

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

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

@@ -0,0 +1,75 @@
+"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 getContract_js_1 = require("./getContract.js");
+vitest_1.vi.mock('viem', async (importOriginal) => ({
+    ...(await importOriginal()),
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    createPublicClient: vitest_1.vi.fn(({ chain }) => ({ chain })),
+}));
+(0, vitest_1.describe)('getContract', () => {
+    const client = {
+        chain: index_js_1.ETH_SEPOLIA,
+    };
+    (0, vitest_1.afterEach)(() => {
+        vitest_1.vi.restoreAllMocks();
+    });
+    vitest_1.test.each([
+        [
+            'explicit ABI',
+            { address: index_js_1.ETH_SEPOLIA.contracts.USDC.address, abi: [], client: {} },
+            { address: index_js_1.ETH_SEPOLIA.contracts.USDC.address, abi: [] },
+        ],
+        [
+            'implicit ABI from client chain',
+            {
+                address: index_js_1.ETH_SEPOLIA.contracts.USDC.address,
+                client,
+            },
+            { address: index_js_1.ETH_SEPOLIA.contracts.USDC.address, abi: index_js_1.ETH_SEPOLIA.contracts.USDC.abi },
+        ],
+    ])('should return a contract using %s', (_, params, expectedResult) => {
+        (0, vitest_1.expect)((0, getContract_js_1.getContract)(params)).toMatchObject(expectedResult);
+    });
+    (0, vitest_1.it)('should return a contract using a default public client', () => {
+        (0, vitest_1.expect)((0, getContract_js_1.getContract)({
+            address: index_js_1.ETH_SEPOLIA.contracts.USDC.address,
+            abi: [],
+            chain: index_js_1.ETH_SEPOLIA,
+        })).toMatchObject({
+            address: index_js_1.ETH_SEPOLIA.contracts.USDC.address,
+            abi: [],
+        });
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        (0, vitest_1.expect)(viem_1.createPublicClient).toHaveBeenCalledWith({ chain: index_js_1.ETH_SEPOLIA, transport: vitest_1.expect.anything() });
+    });
+    vitest_1.test.each([
+        [
+            { address: index_js_1.ETH_SEPOLIA.contracts.USDC.address, abi: undefined, client: {} },
+            `No ABI provided for contract at ${index_js_1.ETH_SEPOLIA.contracts.USDC.address}`,
+        ],
+        [
+            {
+                address: index_js_1.MATIC_AMOY.contracts.USDC.address,
+                abi: undefined,
+                client,
+            },
+            `No ABI provided for contract at ${index_js_1.MATIC_AMOY.contracts.USDC.address}`,
+        ],
+    ])('should throw ABI not found error', (params, expectedError) => {
+        (0, vitest_1.expect)(() => (0, getContract_js_1.getContract)(params)).toThrowError(expectedError);
+    });
+});
+//# sourceMappingURL=getContract.test.js.map

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

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

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

@@ -1,6 +1,7 @@
 export * from './formatUnits.js';
 export * from './generateIdempotencyKey.js';
 export * from './getChainContractByAddress.js';
+export * from './getContract.js';
 export * from './max.js';
 export * from './parseAccount.js';
 export * from './parseAddress.js';

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,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,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,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,kBAAkB,CAAA;AAChC,cAAc,UAAU,CAAA;AACxB,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA"}

package/dist/cjs/utils/index.js

@@ -27,6 +27,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./formatUnits.js"), exports);
 __exportStar(require("./generateIdempotencyKey.js"), exports);
 __exportStar(require("./getChainContractByAddress.js"), exports);
+__exportStar(require("./getContract.js"), exports);
 __exportStar(require("./max.js"), exports);
 __exportStar(require("./parseAccount.js"), exports);
 __exportStar(require("./parseAddress.js"), exports);

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,mDAAgC;AAChC,8DAA2C;AAC3C,iEAA8C;AAC9C,2CAAwB;AACxB,oDAAiC;AACjC,oDAAiC;AACjC,kDAA+B;AAC/B,6CAA0B;AAC1B,gDAA6B;AAC7B,iDAA8B"}
+{"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,mDAAgC;AAChC,2CAAwB;AACxB,oDAAiC;AACjC,oDAAiC;AACjC,kDAA+B;AAC/B,6CAA0B;AAC1B,gDAA6B;AAC7B,iDAA8B"}

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

@@ -55,6 +55,7 @@ vitest_1.describe.concurrent('utils', () => {
             'formatUnits',
             'generateIdempotencyKey',
             'getChainContractByAddress',
+            'getContract',
             'max',
             'parseAccount',
             'parseAddress',
@@ -67,6 +68,7 @@ vitest_1.describe.concurrent('utils', () => {
         (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.getContract).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));

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

@@ -1 +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,OAAO;YACP,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,KAAK,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC/C,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"}
+{"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,aAAa;YACb,KAAK;YACL,cAAc;YACd,cAAc;YACd,YAAY;YACZ,OAAO;YACP,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,WAAW,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACrD,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,KAAK,CAAC,CAAC,OAAO,CAAC,eAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC/C,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/cjs/utils/parseAccount.d.ts

@@ -1,12 +1,35 @@
-import type { Account, Address } from '../types.js';
-import type { Chain } from 'viem';
+import type { Account, Address, Chain } from '../types.js';
 /**
  * Parses an account address or object and adds serialization utilities.
  *
  * @param account - The account address or object to parse.
- * @returns The parsed account with added toString and toJSON methods.
+ * @returns The parsed Account object
  */
-export declare function parseAccount(account: Address | Account, { chain }?: {
+export declare function parseAccount(account: Address, options?: {
+    chain: undefined;
+}): Account & {
+    chain: undefined;
+};
+export declare function parseAccount(account: Address | Account, options: {
+    chain: Chain;
+}): Account & {
+    chain: Chain;
+};
+export declare function parseAccount(account: Account & {
+    chain: Chain;
+}, options?: {
+    chain?: Chain;
+}): Account & {
+    chain: Chain;
+};
+export declare function parseAccount(account: Account & {
+    chain: undefined;
+}, options?: {
+    chain: undefined;
+}): Account & {
+    chain: undefined;
+};
+export declare function parseAccount(account: Address | Account, options?: {
     chain?: Chain;
 }): Account;
 //# sourceMappingURL=parseAccount.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"parseAccount.d.ts","sourceRoot":"","sources":["../../../src/utils/parseAccount.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAEjC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,EAAE,KAAK,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAO,GAAG,OAAO,CAMnG"}
+{"version":3,"file":"parseAccount.d.ts","sourceRoot":"","sources":["../../../src/utils/parseAccount.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAE1D;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG,OAAO,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAA;AAC9G,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG,OAAO,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAC/G,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,EACnC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAC1B,OAAO,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAC7B,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,EACvC,OAAO,CAAC,EAAE;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GAC7B,OAAO,GAAG;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAA;AACjC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG,OAAO,CAAA"}

package/dist/cjs/utils/parseAccount.js

@@ -12,13 +12,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseAccount = parseAccount;
 const accounts_1 = require("viem/accounts");
-/**
- * Parses an account address or object and adds serialization utilities.
- *
- * @param account - The account address or object to parse.
- * @returns The parsed account with added toString and toJSON methods.
- */
 function parseAccount(account, { chain } = {}) {
+    if (typeof account === 'object' && account.chain !== undefined) {
+        chain = account.chain;
+    }
     const parsedAccount = (0, accounts_1.parseAccount)(account);
     return {
         chain,

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

@@ -1 +1 @@
-{"version":3,"file":"parseAccount.js","sourceRoot":"","sources":["../../../src/utils/parseAccount.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAanF,oCAMC;AAjBD,4CAA6D;AAK7D;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,OAA0B,EAAE,EAAE,KAAK,KAAwB,EAAE;IACxF,MAAM,aAAa,GAAG,IAAA,uBAAa,EAAC,OAAO,CAAC,CAAA;IAC5C,OAAO;QACL,KAAK;QACL,GAAG,aAAa;KACjB,CAAA;AACH,CAAC"}
+{"version":3,"file":"parseAccount.js","sourceRoot":"","sources":["../../../src/utils/parseAccount.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAuBnF,oCAWC;AAhCD,4CAA6D;AAqB7D,SAAgB,YAAY,CAAC,OAA0B,EAAE,EAAE,KAAK,KAAwB,EAAE;IACxF,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/D,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IACvB,CAAC;IAED,MAAM,aAAa,GAAG,IAAA,uBAAa,EAAC,OAAO,CAAC,CAAA;IAE5C,OAAO;QACL,KAAK;QACL,GAAG,aAAa;KACjB,CAAA;AACH,CAAC"}

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

@@ -11,13 +11,27 @@
 // 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 parseAccount_js_1 = require("./parseAccount.js");
 (0, vitest_1.describe)('parseAccount', () => {
     vitest_1.test.each([
-        ['0x123', { address: '0x123', type: 'json-rpc' }],
-        [{ address: '0x123' }, { address: '0x123' }],
-    ])('should return an Account object', (params, expectedResult) => {
-        (0, vitest_1.expect)((0, parseAccount_js_1.parseAccount)(params)).toEqual(expectedResult);
+        ['Address (defaults)', '0x123', undefined, { address: '0x123', type: 'json-rpc' }],
+        ['Address (with chain)', '0x123', { chain: index_js_1.MATIC_AMOY }, { address: '0x123', type: 'json-rpc', chain: index_js_1.MATIC_AMOY }],
+        ['Account (defaults)', { address: '0x123', type: 'json-rpc' }, undefined, { address: '0x123', type: 'json-rpc' }],
+        [
+            'Account (with chain)',
+            { address: '0x123', type: 'json-rpc' },
+            { chain: index_js_1.MATIC_AMOY },
+            { address: '0x123', type: 'json-rpc', chain: index_js_1.MATIC_AMOY },
+        ],
+        [
+            'Account with chain (defaults)',
+            { address: '0x123', type: 'json-rpc', chain: index_js_1.MATIC_AMOY },
+            undefined,
+            { address: '0x123', type: 'json-rpc', chain: index_js_1.MATIC_AMOY },
+        ],
+    ])('should return an Account using %s', (_, params, options, expectedResult) => {
+        (0, vitest_1.expect)((0, parseAccount_js_1.parseAccount)(params, options)).toEqual(expectedResult);
     });
 });
 //# sourceMappingURL=parseAccount.test.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"parseAccount.test.js","sourceRoot":"","sources":["../../../src/utils/parseAccount.test.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAEnF,mCAA+C;AAE/C,uDAAgD;AAIhD,IAAA,iBAAQ,EAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,aAAI,CAAC,IAAI,CAAC;QACR,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QACjD,CAAC,EAAE,OAAO,EAAE,OAAO,EAAwB,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;KAC1D,CAAC,CAAC,iCAAiC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE;QACxE,IAAA,eAAM,EAAC,IAAA,8BAAY,EAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IACtD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"parseAccount.test.js","sourceRoot":"","sources":["../../../src/utils/parseAccount.test.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAEnF,mCAA+C;AAE/C,iDAA+C;AAE/C,uDAAgD;AAEhD,IAAA,iBAAQ,EAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,aAAI,CAAC,IAAI,CAAC;QACR,CAAC,oBAAoB,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAClF,CAAC,sBAAsB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,qBAAU,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,qBAAU,EAAE,CAAC;QACnH,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QACjH;YACE,sBAAsB;YACtB,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE;YACtC,EAAE,KAAK,EAAE,qBAAU,EAAE;YACrB,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,qBAAU,EAAE;SAC1D;QACD;YACE,+BAA+B;YAC/B,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,qBAAU,EAAE;YACzD,SAAS;YACT,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,qBAAU,EAAE;SAC1D;KACO,CAAC,CAAC,mCAAmC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE;QACtF,IAAA,eAAM,EAAC,IAAA,8BAAY,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -1,5 +1,4 @@
-import type { Address } from '../types.js';
-import type { Chain } from 'viem';
+import type { Address, Chain } from '../types.js';
 /**
  * Converts an address string or an object containing an address into a standardized Address object.
  *
@@ -13,11 +12,8 @@ import type { Chain } from 'viem';
  * parseAddress({ address: '0x123...', chain: MATIC_AMOY }) // => { address: '0x123...', chain: MATIC_AMOY }
  * ```
  */
-export declare function parseAddress(value: Address | {
+export declare function parseAddress<T extends {
     address: Address;
     chain?: Chain;
-}): {
-    address: Address;
-    chain?: Chain;
-};
+}>(value: Address | T): T;
 //# sourceMappingURL=parseAddress.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"parseAddress.d.ts","sourceRoot":"","sources":["../../../src/utils/parseAddress.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAEjC;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG;IAClF,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAEA"}
+{"version":3,"file":"parseAddress.d.ts","sourceRoot":"","sources":["../../../src/utils/parseAddress.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAMjG"}

package/dist/cjs/utils/parseAddress.js

@@ -25,6 +25,9 @@ exports.parseAddress = parseAddress;
  * ```
  */
 function parseAddress(value) {
-    return typeof value === 'string' ? { address: value } : value;
+    if (typeof value === 'string') {
+        return { address: value };
+    }
+    return value;
 }
 //# sourceMappingURL=parseAddress.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"parseAddress.js","sourceRoot":"","sources":["../../../src/utils/parseAddress.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAkBnF,oCAKC;AAlBD;;;;;;;;;;;;GAYG;AACH,SAAgB,YAAY,CAAC,KAAoD;IAI/E,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;AAC/D,CAAC"}
+{"version":3,"file":"parseAddress.js","sourceRoot":"","sources":["../../../src/utils/parseAddress.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAiBnF,oCAMC;AAnBD;;;;;;;;;;;;GAYG;AACH,SAAgB,YAAY,CAAgD,KAAkB;IAC5F,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAO,CAAA;IAChC,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

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

@@ -0,0 +1,39 @@
+import type { Address, Chain, NativeUnits, BaseUnits } from '../types.js';
+import type { Abi } from 'viem';
+export type ParseUnitsAsTokenParams = {
+    /** The amount to transfer. */
+    value: NativeUnits | BaseUnits;
+    /** The token address (optional). */
+    token?: Address | {
+        address: Address;
+        abi?: Abi;
+    } | null;
+    /** The blockchain chain to use. */
+    chain: Chain;
+};
+/**
+ * Parses a given value into the appropriate token units based on the specified chain and token.
+ *
+ * @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(params: ParseUnitsAsTokenParams): Promise<bigint>;
+//# sourceMappingURL=parseUnitsAsToken.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseUnitsAsToken.d.ts","sourceRoot":"","sources":["../../../src/utils/parseUnitsAsToken.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAE/B,MAAM,MAAM,uBAAuB,GAAG;IACpC,8BAA8B;IAC9B,KAAK,EAAE,WAAW,GAAG,SAAS,CAAA;IAC9B,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI,CAAA;IACxD,mCAAmC;IACnC,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,uBAAuB,mBAetE"}

package/dist/cjs/utils/parseUnitsAsToken.js

@@ -0,0 +1,55 @@
+"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 getContract_js_1 = require("./getContract.js");
+const parseAddress_js_1 = require("./parseAddress.js");
+const parseUnits_js_1 = require("./parseUnits.js");
+/**
+ * Parses a given value into the appropriate token units based on the specified chain and token.
+ *
+ * @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(params) {
+    const { value, token: _token, chain } = params;
+    // Skip parsing
+    if (typeof value === 'bigint')
+        return value;
+    let decimals = chain.nativeCurrency.decimals;
+    if (_token != null) {
+        const { address, abi } = (0, parseAddress_js_1.parseAddress)(_token);
+        const token = (0, getContract_js_1.getContract)({ address, abi: abi ?? viem_1.erc20Abi, chain });
+        decimals = (await token.read.decimals());
+    }
+    return (0, parseUnits_js_1.parseUnits)(value, decimals);
+}
+//# sourceMappingURL=parseUnitsAsToken.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseUnitsAsToken.js","sourceRoot":"","sources":["../../../src/utils/parseUnitsAsToken.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AA4CnF,8CAeC;AAzDD,+BAA+B;AAE/B,qDAA8C;AAC9C,uDAAgD;AAChD,mDAA4C;AAc5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,KAAK,UAAU,iBAAiB,CAAC,MAA+B;IACrE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAA;IAE9C,eAAe;IACf,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE3C,IAAI,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAA;IAE5C,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;QACnB,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAA,8BAAY,EAAC,MAAM,CAAC,CAAA;QAC7C,MAAM,KAAK,GAAG,IAAA,4BAAW,EAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,eAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;QACnE,QAAQ,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAW,CAAA;IACpD,CAAC;IAED,OAAO,IAAA,0BAAU,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACpC,CAAC"}

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseUnitsAsToken.test.js","sourceRoot":"","sources":["../../../src/utils/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,gCAAgC;AAChC,WAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,WAAW,EAAE,WAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QACxB,GAAG,EAAE,EAAE;QACP,IAAI,EAAE;YACJ,QAAQ,EAAE,WAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,+BAA+B;SACxE;KACF,CAAC,CAAC;CACJ,CAAC,CAAC,CAAA;AAEH,iEAA0D;AAI1D,iBAAQ,CAAC,UAAU,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAC5C,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,sBAAW;KACc,CAAA;IAElC,aAAI,CAAC,IAAI,CAAC;QACR;YACE,iBAAiB;YACjB;gBACE,KAAK,EAAE,EAAE;gBACT,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;YACD,EAAE;SACH;QACD;YACE,cAAc;YACd;gBACE,KAAK,EAAE,GAAG;gBACV,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;YACD,oBAAoB;SACrB;QACD;YACE,sBAAsB;YACtB;gBACE,KAAK,EAAE,GAAG;gBACV,KAAK,EAAE,sBAAW,CAAC,SAAS,CAAC,IAAI;gBACjC,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;YACD,QAAQ;SACT;QACD;YACE,sCAAsC;YACtC;gBACE,KAAK,EAAE,GAAG;gBACV,KAAK,EAAE,4CAA4C;gBACnD,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;YACD,QAAQ;SACT;QACD;YACE,mBAAmB;YACnB;gBACE,KAAK,EAAE,GAAG;gBACV,KAAK,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE;gBAChE,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB;YACD,QAAQ;SACT;KACO,CAAC,CAAC,6DAA6D,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE;QAC7G,MAAM,IAAA,eAAM,EAAC,IAAA,wCAAiB,EAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -10,6 +10,7 @@
 // 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 toERC681_js_1 = require("./toERC681.js");
 (0, vitest_1.describe)('toERC681', () => {
@@ -40,32 +41,7 @@ const toERC681_js_1 = require("./toERC681.js");
     (0, vitest_1.describe)('contract transaction request', () => {
         const USDC = {
             address: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
-            abi: [
-                {
-                    inputs: [
-                        {
-                            internalType: 'address',
-                            name: 'to',
-                            type: 'address',
-                        },
-                        {
-                            internalType: 'uint256',
-                            name: 'value',
-                            type: 'uint256',
-                        },
-                    ],
-                    name: 'transfer',
-                    outputs: [
-                        {
-                            internalType: 'bool',
-                            name: '',
-                            type: 'bool',
-                        },
-                    ],
-                    stateMutability: 'nonpayable',
-                    type: 'function',
-                },
-            ],
+            abi: viem_1.erc20Abi,
         };
         (0, vitest_1.test)('transfer(address, amount)', () => {
             (0, vitest_1.expect)((0, toERC681_js_1.toERC681)({

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

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

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

@@ -1,12 +1,15 @@
-import type { Account, Address, NativeUnits, BaseUnits, ExtendedViemClient } from '../types.js';
-import type { Chain, ChainContract } from 'viem';
+import type { Account, Address, Chain, NativeUnits, BaseUnits, ExtendedViemClient } from '../types.js';
+import type { Abi } from 'viem';
 export type GenerateTransferLinkParams = {
     /** The recipient address. */
     to: Address | Account;
     /** The amount to transfer. */
     amount: NativeUnits | BaseUnits;
     /** The token address (optional). */
-    token?: Address | ChainContract | null;
+    token?: Address | {
+        address: Address;
+        abi?: Abi;
+    } | null;
     /** The blockchain chain to use (optional, defaults to client's chain). */
     chain?: Chain;
 };
@@ -23,10 +26,10 @@ export type GenerateTransferLinkParams = {
  * const link = await generateTransferLink(client, {
  *   to: '0xRecipientAddress',
  *   amount: '100',
- *   chain: someChain,
+ *   chain: ETH_SEPOLIA,
  *   token: '0xTokenAddress'
- * });
- * console.log(link);
+ * })
+ * // => 'ethereum:0xRecipientAddress@11155111?value=100&token=0xTokenAddress'
  * ```
  */
 export declare function generateTransferLink(client: ExtendedViemClient, params: GenerateTransferLinkParams): Promise<string>;