@circle-fin/usdckit 0.18.0 → 0.19.1

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

@@ -1 +1 @@
-{"version":3,"file":"getContract.d.ts","sourceRoot":"","sources":["../../../src/utils/getContract.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAE7D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,OAAO,CAAA;CACjB,GAAG,CACA;IACE,GAAG,EAAE,GAAG,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;CACf,GACD;IACE,GAAG,CAAC,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,KAAK,CAAA;KAAE,CAAA;CAClC,CACJ,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBnD"}
+{"version":3,"file":"getContract.d.ts","sourceRoot":"","sources":["../../../src/utils/getContract.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAiB,MAAM,aAAa,CAAA;AAChE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAEvC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,GAAG,CAAA;CACV,GAAG,CACA;IACE,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,CAAC,EAAE,KAAK,CAAA;CACf,GACD;IACE,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CACJ,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BnD"}

package/dist/cjs/utils/getContract.js

@@ -20,9 +20,14 @@ const viem_1 = require("viem");
  * @returns The contract instance.
  */
 function getContract(params) {
-    const { address, client } = params;
-    const chain = client.chain;
+    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);

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

@@ -1 +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;;AA2BnF,kCAoBC;AA7CD,+BAAkD;AAkBlD;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,MAAwB;IAClD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAA;IAC1B,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAAA;IAEpB,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"}
+{"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.js

@@ -10,9 +10,15 @@
 // 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,
@@ -37,6 +43,18 @@ const getContract_js_1 = require("./getContract.js");
     ])('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: {} },

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

@@ -1 +1 @@
-{"version":3,"file":"getContract.test.js","sourceRoot":"","sources":["../../../src/utils/getContract.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,mCAA8D;AAE9D,iDAA4D;AAE5D,qDAA8C;AAI9C,IAAA,iBAAQ,EAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,sBAAW;KACQ,CAAA;IAE5B,IAAA,kBAAS,EAAC,GAAG,EAAE;QACb,WAAE,CAAC,eAAe,EAAE,CAAA;IACtB,CAAC,CAAC,CAAA;IAEF,aAAI,CAAC,IAAI,CAAC;QACR;YACE,cAAc;YACd,EAAE,OAAO,EAAE,sBAAW,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAkB,EAAE;YACpF,EAAE,OAAO,EAAE,sBAAW,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE;SACzD;QACD;YACE,gCAAgC;YAChC;gBACE,OAAO,EAAE,sBAAW,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO;gBAC3C,MAAM;aACP;YACD,EAAE,OAAO,EAAE,sBAAW,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,sBAAW,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE;SACrF;KACO,CAAC,CAAC,mCAAmC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE;QAC7E,IAAA,eAAM,EAAC,IAAA,4BAAW,EAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,cAAc,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,aAAI,CAAC,IAAI,CAAC;QACR;YACE,EAAE,OAAO,EAAE,sBAAW,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,EAAkB,EAAE;YAC3F,mCAAmC,sBAAW,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE;SACxE;QACD;YACE;gBACE,OAAO,EAAE,qBAAU,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO;gBAC1C,GAAG,EAAE,SAAS;gBACd,MAAM;aACP;YACD,mCAAmC,qBAAU,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE;SACvE;KACO,CAAC,CAAC,kCAAkC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE;QACxE,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,4BAAW,EAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"getContract.test.js","sourceRoot":"","sources":["../../../src/utils/getContract.test.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,8 @@
+/**
+ * Groups array elements by a key function, similar to Object.groupBy
+ * @param items - Array of items to group
+ * @param keyFn - Function that extracts the grouping key from each item
+ * @returns Object with keys as group identifiers and values as arrays of grouped items
+ */
+export declare function groupBy<T>(items: T[], keyFn: (item: T) => string | number | symbol): Record<string | number | symbol, T[]>;
+//# sourceMappingURL=groupBy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"groupBy.d.ts","sourceRoot":"","sources":["../../../src/utils/groupBy.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,yCAYlF"}

package/dist/cjs/utils/groupBy.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 });
+exports.groupBy = groupBy;
+/**
+ * Groups array elements by a key function, similar to Object.groupBy
+ * @param items - Array of items to group
+ * @param keyFn - Function that extracts the grouping key from each item
+ * @returns Object with keys as group identifiers and values as arrays of grouped items
+ */
+function groupBy(items, keyFn) {
+    const result = {};
+    for (const item of items) {
+        const key = keyFn(item);
+        if (!(key in result)) {
+            result[key] = [];
+        }
+        result[key].push(item);
+    }
+    return result;
+}
+//# sourceMappingURL=groupBy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"groupBy.js","sourceRoot":"","sources":["../../../src/utils/groupBy.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAQnF,0BAYC;AAlBD;;;;;GAKG;AACH,SAAgB,OAAO,CAAI,KAAU,EAAE,KAA4C;IACjF,MAAM,MAAM,GAA0C,EAAE,CAAA;IAExD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;QACvB,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;QAClB,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

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

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

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

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

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

@@ -0,0 +1,127 @@
+"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 groupBy_js_1 = require("./groupBy.js");
+vitest_1.describe.concurrent('groupBy', () => {
+    (0, vitest_1.it)('should group numbers by even/odd', () => {
+        const numbers = [1, 2, 3, 4, 5, 6];
+        const result = (0, groupBy_js_1.groupBy)(numbers, (x) => x % 2);
+        (0, vitest_1.expect)(result).toEqual({
+            0: [2, 4, 6],
+            1: [1, 3, 5],
+        });
+    });
+    (0, vitest_1.it)('should group strings by length', () => {
+        const words = ['a', 'ab', 'abc', 'abcd', 'ab', 'a'];
+        const result = (0, groupBy_js_1.groupBy)(words, (word) => word.length);
+        (0, vitest_1.expect)(result).toEqual({
+            1: ['a', 'a'],
+            2: ['ab', 'ab'],
+            3: ['abc'],
+            4: ['abcd'],
+        });
+    });
+    (0, vitest_1.it)('should group objects by property', () => {
+        const people = [
+            { name: 'Alice', age: 25 },
+            { name: 'Bob', age: 30 },
+            { name: 'Charlie', age: 25 },
+            { name: 'David', age: 30 },
+        ];
+        const result = (0, groupBy_js_1.groupBy)(people, (person) => person.age);
+        (0, vitest_1.expect)(result).toEqual({
+            25: [
+                { name: 'Alice', age: 25 },
+                { name: 'Charlie', age: 25 },
+            ],
+            30: [
+                { name: 'Bob', age: 30 },
+                { name: 'David', age: 30 },
+            ],
+        });
+    });
+    (0, vitest_1.it)('should handle nested object properties', () => {
+        const balances = [
+            { token: { tokenAddress: '0x123' }, amount: 100 },
+            { token: { tokenAddress: '0x456' }, amount: 200 },
+            { token: { tokenAddress: '0x123' }, amount: 300 },
+            { token: { tokenAddress: null }, amount: 400 },
+        ];
+        const result = (0, groupBy_js_1.groupBy)(balances, ({ token: { tokenAddress } }) => tokenAddress ?? '');
+        (0, vitest_1.expect)(result).toEqual({
+            '0x123': [
+                { token: { tokenAddress: '0x123' }, amount: 100 },
+                { token: { tokenAddress: '0x123' }, amount: 300 },
+            ],
+            '0x456': [{ token: { tokenAddress: '0x456' }, amount: 200 }],
+            '': [{ token: { tokenAddress: null }, amount: 400 }],
+        });
+    });
+    (0, vitest_1.it)('should handle empty array', () => {
+        const result = (0, groupBy_js_1.groupBy)([], (x) => x);
+        (0, vitest_1.expect)(result).toEqual({});
+    });
+    (0, vitest_1.it)('should handle array with single item', () => {
+        const result = (0, groupBy_js_1.groupBy)(['single'], (x) => x.length);
+        (0, vitest_1.expect)(result).toEqual({
+            6: ['single'],
+        });
+    });
+    (0, vitest_1.it)('should group by string keys', () => {
+        const items = [
+            { category: 'fruit', name: 'apple' },
+            { category: 'vegetable', name: 'carrot' },
+            { category: 'fruit', name: 'banana' },
+            { category: 'vegetable', name: 'lettuce' },
+        ];
+        const result = (0, groupBy_js_1.groupBy)(items, (item) => item.category);
+        (0, vitest_1.expect)(result).toEqual({
+            fruit: [
+                { category: 'fruit', name: 'apple' },
+                { category: 'fruit', name: 'banana' },
+            ],
+            vegetable: [
+                { category: 'vegetable', name: 'carrot' },
+                { category: 'vegetable', name: 'lettuce' },
+            ],
+        });
+    });
+    (0, vitest_1.it)('should handle symbol keys', () => {
+        const sym1 = Symbol('group1');
+        const sym2 = Symbol('group2');
+        const items = [1, 2, 3, 4];
+        const result = (0, groupBy_js_1.groupBy)(items, (x) => (x % 2 === 0 ? sym1 : sym2));
+        (0, vitest_1.expect)(result[sym1]).toEqual([2, 4]);
+        (0, vitest_1.expect)(result[sym2]).toEqual([1, 3]);
+    });
+    (0, vitest_1.it)('should preserve order within groups', () => {
+        const items = [
+            { id: 1, group: 'A' },
+            { id: 2, group: 'B' },
+            { id: 3, group: 'A' },
+            { id: 4, group: 'B' },
+            { id: 5, group: 'A' },
+        ];
+        const result = (0, groupBy_js_1.groupBy)(items, (item) => item.group);
+        (0, vitest_1.expect)(result.A).toEqual([
+            { id: 1, group: 'A' },
+            { id: 3, group: 'A' },
+            { id: 5, group: 'A' },
+        ]);
+        (0, vitest_1.expect)(result.B).toEqual([
+            { id: 2, group: 'B' },
+            { id: 4, group: 'B' },
+        ]);
+    });
+});
+//# sourceMappingURL=groupBy.test.js.map

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

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

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

@@ -3,7 +3,7 @@ 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, options?: {
     chain: undefined;

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

@@ -12,11 +12,8 @@ import type { Address, Chain } from '../types.js';
  * 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,KAAK,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;;;;;;;;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;;AAiBnF,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, Chain, NativeUnits, BaseUnits, ExtendedViemClient } from '../types.js';
-import type { ChainContract } from 'viem';
+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>;

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

@@ -1 +1 @@
-{"version":3,"file":"generateTransferLink.d.ts","sourceRoot":"","sources":["../../../src/actions/generateTransferLink.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAY,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAEzC,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,CA0BjB"}
+{"version":3,"file":"generateTransferLink.d.ts","sourceRoot":"","sources":["../../../src/actions/generateTransferLink.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACtG,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAE/B,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;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,GAAG,IAAI,CAAA;IACxD,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,CAqBjB"}