@circle-fin/usdckit 0.17.1 → 0.19.0

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

@@ -0,0 +1,73 @@
+// Copyright (c) 2025, Circle Internet Group, Inc.
+// All rights reserved.
+//
+// Circle Internet Group, Inc. CONFIDENTIAL
+//
+// This file includes unpublished proprietary source code of Circle Internet
+// Group, Inc. The copyright notice above does not
+// evidence any actual or intended publication of such source code. Disclosure
+// of this source code or any related proprietary information is strictly
+// prohibited without the express written permission of Circle Internet Group, Inc.
+import { createPublicClient } from 'viem';
+import { describe, test, expect, vi, afterEach, it } from 'vitest';
+import { ETH_SEPOLIA, MATIC_AMOY } from '../chains/index.js';
+import { getContract } from './getContract.js';
+vi.mock('viem', async (importOriginal) => ({
+    ...(await importOriginal()),
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    createPublicClient: vi.fn(({ chain }) => ({ chain })),
+}));
+describe('getContract', () => {
+    const client = {
+        chain: ETH_SEPOLIA,
+    };
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    test.each([
+        [
+            'explicit ABI',
+            { address: ETH_SEPOLIA.contracts.USDC.address, abi: [], client: {} },
+            { address: ETH_SEPOLIA.contracts.USDC.address, abi: [] },
+        ],
+        [
+            'implicit ABI from client chain',
+            {
+                address: ETH_SEPOLIA.contracts.USDC.address,
+                client,
+            },
+            { address: ETH_SEPOLIA.contracts.USDC.address, abi: ETH_SEPOLIA.contracts.USDC.abi },
+        ],
+    ])('should return a contract using %s', (_, params, expectedResult) => {
+        expect(getContract(params)).toMatchObject(expectedResult);
+    });
+    it('should return a contract using a default public client', () => {
+        expect(getContract({
+            address: ETH_SEPOLIA.contracts.USDC.address,
+            abi: [],
+            chain: ETH_SEPOLIA,
+        })).toMatchObject({
+            address: ETH_SEPOLIA.contracts.USDC.address,
+            abi: [],
+        });
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        expect(createPublicClient).toHaveBeenCalledWith({ chain: ETH_SEPOLIA, transport: expect.anything() });
+    });
+    test.each([
+        [
+            { address: ETH_SEPOLIA.contracts.USDC.address, abi: undefined, client: {} },
+            `No ABI provided for contract at ${ETH_SEPOLIA.contracts.USDC.address}`,
+        ],
+        [
+            {
+                address: MATIC_AMOY.contracts.USDC.address,
+                abi: undefined,
+                client,
+            },
+            `No ABI provided for contract at ${MATIC_AMOY.contracts.USDC.address}`,
+        ],
+    ])('should throw ABI not found error', (params, expectedError) => {
+        expect(() => getContract(params)).toThrowError(expectedError);
+    });
+});
+//# sourceMappingURL=getContract.test.js.map

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

@@ -11,6 +11,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/esm/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,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.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,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/esm/utils/index.test.js

@@ -20,6 +20,7 @@ describe.concurrent('utils', () => {
             'formatUnits',
             'generateIdempotencyKey',
             'getChainContractByAddress',
+            'getContract',
             'max',
             'parseAccount',
             'parseAddress',
@@ -32,6 +33,7 @@ describe.concurrent('utils', () => {
         expect(mod.formatUnits).toEqual(expect.any(Function));
         expect(mod.generateIdempotencyKey).toEqual(expect.any(Function));
         expect(mod.getChainContractByAddress).toEqual(expect.any(Function));
+        expect(mod.getContract).toEqual(expect.any(Function));
         expect(mod.max).toEqual(expect.any(Function));
         expect(mod.parseAccount).toEqual(expect.any(Function));
         expect(mod.parseAddress).toEqual(expect.any(Function));

package/dist/esm/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,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE5D,OAAO,KAAK,GAAG,MAAM,YAAY,CAAA;AAEjC,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,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,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,WAAW,EAAE,CAAA;QACnD,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACrD,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAChE,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACnE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC7C,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACtD,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACtD,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACpD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC/C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAClD,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,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,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE5D,OAAO,KAAK,GAAG,MAAM,YAAY,CAAA;AAEjC,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,CAAC,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,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,WAAW,EAAE,CAAA;QACnD,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACrD,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAChE,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACnE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACrD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC7C,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACtD,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACtD,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QACpD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC/C,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;QAClD,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -9,13 +9,10 @@
 // of this source code or any related proprietary information is strictly
 // prohibited without the express written permission of Circle Internet Group, Inc.
 import { parseAccount as _parseAccount } from '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.
- */
 export function parseAccount(account, { chain } = {}) {
+    if (typeof account === 'object' && account.chain !== undefined) {
+        chain = account.chain;
+    }
     const parsedAccount = _parseAccount(account);
     return {
         chain,

package/dist/esm/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;AAEnF,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,eAAe,CAAA;AAK7D;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAA0B,EAAE,EAAE,KAAK,KAAwB,EAAE;IACxF,MAAM,aAAa,GAAG,aAAa,CAAC,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;AAEnF,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,eAAe,CAAA;AAqB7D,MAAM,UAAU,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,aAAa,CAAC,OAAO,CAAC,CAAA;IAE5C,OAAO;QACL,KAAK;QACL,GAAG,aAAa;KACjB,CAAA;AACH,CAAC"}

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

@@ -9,13 +9,27 @@
 // of this source code or any related proprietary information is strictly
 // prohibited without the express written permission of Circle Internet Group, Inc.
 import { expect, test, describe } from 'vitest';
+import { MATIC_AMOY } from '../chains/index.js';
 import { parseAccount } from './parseAccount.js';
 describe('parseAccount', () => {
     test.each([
-        ['0x123', { address: '0x123', type: 'json-rpc' }],
-        [{ address: '0x123' }, { address: '0x123' }],
-    ])('should return an Account object', (params, expectedResult) => {
-        expect(parseAccount(params)).toEqual(expectedResult);
+        ['Address (defaults)', '0x123', undefined, { address: '0x123', type: 'json-rpc' }],
+        ['Address (with chain)', '0x123', { chain: MATIC_AMOY }, { address: '0x123', type: 'json-rpc', chain: MATIC_AMOY }],
+        ['Account (defaults)', { address: '0x123', type: 'json-rpc' }, undefined, { address: '0x123', type: 'json-rpc' }],
+        [
+            'Account (with chain)',
+            { address: '0x123', type: 'json-rpc' },
+            { chain: MATIC_AMOY },
+            { address: '0x123', type: 'json-rpc', chain: MATIC_AMOY },
+        ],
+        [
+            'Account with chain (defaults)',
+            { address: '0x123', type: 'json-rpc', chain: MATIC_AMOY },
+            undefined,
+            { address: '0x123', type: 'json-rpc', chain: MATIC_AMOY },
+        ],
+    ])('should return an Account using %s', (_, params, options, expectedResult) => {
+        expect(parseAccount(params, options)).toEqual(expectedResult);
     });
 });
 //# sourceMappingURL=parseAccount.test.js.map

package/dist/esm/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,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIhD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,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,MAAM,CAAC,YAAY,CAAC,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,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,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,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,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,UAAU,EAAE;YACrB,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;SAC1D;QACD;YACE,+BAA+B;YAC/B,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;YACzD,SAAS;YACT,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE;SAC1D;KACO,CAAC,CAAC,mCAAmC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE;QACtF,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -22,6 +22,9 @@
  * ```
  */
 export 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/esm/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;AAKnF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,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;AAInF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,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/esm/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/esm/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/esm/utils/parseUnitsAsToken.js

@@ -0,0 +1,52 @@
+// Copyright (c) 2025, Circle Internet Group, Inc.
+// All rights reserved.
+//
+// Circle Internet Group, Inc. CONFIDENTIAL
+//
+// This file includes unpublished proprietary source code of Circle Internet
+// Group, Inc. The copyright notice above does not
+// evidence any actual or intended publication of such source code. Disclosure
+// of this source code or any related proprietary information is strictly
+// prohibited without the express written permission of Circle Internet Group, Inc.
+import { erc20Abi } from 'viem';
+import { getContract } from './getContract.js';
+import { parseAddress } from './parseAddress.js';
+import { parseUnits } from './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
+ * ```
+ */
+export 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 } = parseAddress(_token);
+        const token = getContract({ address, abi: abi ?? erc20Abi, chain });
+        decimals = (await token.read.decimals());
+    }
+    return parseUnits(value, decimals);
+}
+//# sourceMappingURL=parseUnitsAsToken.js.map

package/dist/esm/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;AAEnF,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAc5C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,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,YAAY,CAAC,MAAM,CAAC,CAAA;QAC7C,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAA;QACnE,QAAQ,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAW,CAAA;IACpD,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACpC,CAAC"}

package/dist/esm/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/esm/utils/parseUnitsAsToken.test.js

@@ -0,0 +1,75 @@
+// Copyright (c) 2025, Circle Internet Group, Inc.
+// All rights reserved.
+//
+// Circle Internet Group, Inc. CONFIDENTIAL
+//
+// This file includes unpublished proprietary source code of Circle Internet
+// Group, Inc. The copyright notice above does not
+// evidence any actual or intended publication of such source code. Disclosure
+// of this source code or any related proprietary information is strictly
+// prohibited without the express written permission of Circle Internet Group, Inc.
+import { expect, test, describe, vi } from 'vitest';
+import { ETH_SEPOLIA } from '../chains/index.js';
+// Mock the getContract function
+vi.mock('./getContract.js', () => ({
+    getContract: vi.fn(() => ({
+        abi: [],
+        read: {
+            decimals: vi.fn().mockResolvedValue(6), // USDC commonly has 6 decimals
+        },
+    })),
+}));
+import { parseUnitsAsToken } from './parseUnitsAsToken.js';
+describe.concurrent('parseUnitsAsToken', () => {
+    const client = {
+        chain: ETH_SEPOLIA,
+    };
+    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: 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 expect(parseUnitsAsToken(params)).resolves.toBe(expectedResult);
+    });
+});
+//# sourceMappingURL=parseUnitsAsToken.test.js.map

package/dist/esm/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,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEhD,gCAAgC;AAChC,EAAE,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CAAC,CAAC;IACjC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QACxB,GAAG,EAAE,EAAE;QACP,IAAI,EAAE;YACJ,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,+BAA+B;SACxE;KACF,CAAC,CAAC;CACJ,CAAC,CAAC,CAAA;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAI1D,QAAQ,CAAC,UAAU,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAC5C,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,WAAW;KACc,CAAA;IAElC,IAAI,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,WAAW,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,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -8,6 +8,7 @@
 // evidence any actual or intended publication of such source code. Disclosure
 // of this source code or any related proprietary information is strictly
 // prohibited without the express written permission of Circle Internet Group, Inc.
+import { erc20Abi } from 'viem';
 import { expect, test, describe } from 'vitest';
 import { toERC681 } from './toERC681.js';
 describe('toERC681', () => {
@@ -38,32 +39,7 @@ describe('toERC681', () => {
     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: erc20Abi,
         };
         test('transfer(address, amount)', () => {
             expect(toERC681({

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