@circle-fin/usdckit 0.11.1

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

@@ -0,0 +1,18 @@
+import type { BaseUnits, NativeUnits } from '../types.js';
+/**
+ * Parses `value` into base units.
+ *
+ * @param value - The value to be parsed, either in base units or formatted units.
+ * @param decimals - The number of decimal places to consider for formatted units.
+ * @returns The value in base units.
+ *
+ * @example
+ * ```typescript
+ * parseUnits('1.0', 18)
+ * // => 1000000000000000000n
+ * parseUnits(10n, 18)
+ * // => 10n
+ * ```
+ */
+export declare function parseUnits(value: BaseUnits | NativeUnits, decimals?: number): BaseUnits;
+//# sourceMappingURL=parseUnits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseUnits.d.ts","sourceRoot":"","sources":["../../../src/utils/parseUnits.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,EAAE,QAAQ,GAAE,MAAU,GAAG,SAAS,CAE1F"}

package/dist/cjs/utils/parseUnits.js

@@ -0,0 +1,33 @@
+"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.parseUnits = parseUnits;
+const viem_1 = require("viem");
+/**
+ * Parses `value` into base units.
+ *
+ * @param value - The value to be parsed, either in base units or formatted units.
+ * @param decimals - The number of decimal places to consider for formatted units.
+ * @returns The value in base units.
+ *
+ * @example
+ * ```typescript
+ * parseUnits('1.0', 18)
+ * // => 1000000000000000000n
+ * parseUnits(10n, 18)
+ * // => 10n
+ * ```
+ */
+function parseUnits(value, decimals = 0) {
+    return typeof value === 'string' ? (0, viem_1.parseUnits)(value, decimals) : value;
+}
+//# sourceMappingURL=parseUnits.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseUnits.js","sourceRoot":"","sources":["../../../src/utils/parseUnits.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAqBnF,gCAEC;AArBD,+BAAgD;AAIhD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,UAAU,CAAC,KAA8B,EAAE,WAAmB,CAAC;IAC7E,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,iBAAW,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;AACzE,CAAC"}

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

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

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

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

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

@@ -0,0 +1,51 @@
+"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 parseUnits_js_1 = require("./parseUnits.js");
+vitest_1.describe.concurrent('parseUnits()', () => {
+    vitest_1.test.each([
+        ['1000', 18, 1000000000000000000000n],
+        ['0.15', 18, 150000000000000000n],
+        ['0.000000000000000001', 18, 1n],
+        ['0', 18, 0n],
+        ['-0.000000000000000001', 18, -1n],
+        ['-0.15', 18, -150000000000000000n],
+        ['-1000', 18, -1000000000000000000000n],
+        ['1000', undefined, 1000n],
+        ['0', undefined, 0n],
+        ['-1000', undefined, -1000n],
+    ])('should parse string value to bigint with given decimals %o %o', (value, decimals, expected) => {
+        (0, vitest_1.expect)((0, parseUnits_js_1.parseUnits)(value, decimals)).toBe(expected);
+    });
+    vitest_1.test.each([
+        [1000000000000000000000n, 18, 1000000000000000000000n],
+        [150000000000000000n, 18, 150000000000000000n],
+        [1n, 18, 1n],
+        [0n, 18, 0n],
+        [-1n, 18, -1n],
+        [-150000000000000000n, 18, -150000000000000000n],
+        [-1000000000000000000000n, 18, -1000000000000000000000n],
+        [1n, undefined, 1n],
+        [0n, undefined, 0n],
+        [-1n, undefined, -1n],
+    ])('should return bigint value as is %o %o', (value, decimals, expected) => {
+        (0, vitest_1.expect)((0, parseUnits_js_1.parseUnits)(value, decimals)).toBe(expected);
+    });
+    vitest_1.test.each([
+        ['abc', 18],
+        ['1.2.3', 18],
+    ])('should throw an error for invalid bigint value %o', (value, decimals) => {
+        (0, vitest_1.expect)(() => (0, parseUnits_js_1.parseUnits)(value, decimals)).toThrowError(`Number \`${value}\` is not a valid decimal number.`);
+    });
+});
+//# sourceMappingURL=parseUnits.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseUnits.test.js","sourceRoot":"","sources":["../../../src/utils/parseUnits.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,mDAA4C;AAE5C,iBAAQ,CAAC,UAAU,CAAC,cAAc,EAAE,GAAG,EAAE;IACvC,aAAI,CAAC,IAAI,CAAC;QACR,CAAC,MAAM,EAAE,EAAE,EAAE,uBAAuB,CAAC;QACrC,CAAC,MAAM,EAAE,EAAE,EAAE,mBAAmB,CAAC;QACjC,CAAC,sBAAsB,EAAE,EAAE,EAAE,EAAE,CAAC;QAChC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC;QACb,CAAC,uBAAuB,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QAClC,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC;QACnC,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC,uBAAuB,CAAC;QACvC,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC;QAC1B,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC;QACpB,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC;KACpB,CAAC,CAAC,+DAA+D,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;QACzG,IAAA,eAAM,EAAC,IAAA,0BAAU,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,aAAI,CAAC,IAAI,CAAC;QACR,CAAC,uBAAuB,EAAE,EAAE,EAAE,uBAAuB,CAAC;QACtD,CAAC,mBAAmB,EAAE,EAAE,EAAE,mBAAmB,CAAC;QAC9C,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;QACZ,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACd,CAAC,CAAC,mBAAmB,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC;QAChD,CAAC,CAAC,uBAAuB,EAAE,EAAE,EAAE,CAAC,uBAAuB,CAAC;QACxD,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC;QACnB,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC;QACnB,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;KACb,CAAC,CAAC,wCAAwC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;QAClF,IAAA,eAAM,EAAC,IAAA,0BAAU,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,aAAI,CAAC,IAAI,CAAC;QACR,CAAC,KAAoB,EAAE,EAAE,CAAC;QAC1B,CAAC,OAAsB,EAAE,EAAE,CAAC;KACpB,CAAC,CAAC,mDAAmD,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QACnF,IAAA,eAAM,EAAC,GAAG,EAAE,CAAC,IAAA,0BAAU,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,YAAY,KAAK,mCAAmC,CAAC,CAAA;IAC9G,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,48 @@
+import { type Abi } from 'viem';
+import type { Address } from '../types.js';
+export type toERC681Params = {
+    /** Parameters for the ERC-681 URI */
+    /** ABI of the target contract */
+    abi?: Abi | unknown[];
+    /** Ethereum address of the target contract or account */
+    address: Address;
+    /** Function name to call on the target contract */
+    functionName?: string;
+    /** Arguments to pass to the contract function */
+    args?: (string | number | bigint)[];
+    /** Value to send with the transaction */
+    value?: bigint;
+    /** Gas limit for the transaction */
+    gas?: bigint;
+    /** Gas price for the transaction */
+    gasPrice?: bigint;
+    /** Chain ID for the transaction */
+    chainId?: number;
+};
+/**
+ * Creates an ERC-681 compliant URI for Ethereum payment or function call requests.
+ *
+ * @see {@link https://eips.ethereum.org/EIPS/eip-681 | EIP-681: URL Format for Transaction Requests}
+ * @returns An ERC-681 compliant URI
+ *
+ * @example
+ * Payment request
+ * ```typescript
+ * toERC681({ address: '0x0000000000000000000000000000000000000000', value: 1000000n })
+ * // => "ethereum:0x0000000000000000000000000000000000000000?value=1000000"
+ * ```
+ *
+ * @example
+ * Function call with chain ID
+ * ```typescript
+ * toERC681({
+ *   address: '0x0000000000000000000000000000000000000000',
+ *   functionName: 'transfer',
+ *   args: ['0x0000000000000000000000000000000000000000', '1000'],
+ *   chainId: 1
+ * })
+ * // => "ethereum:0x0000000000000000000000000000000000000000@1/transfer?address=0x0000000000000000000000000000000000000000&uint256=1000"
+ * ```
+ */
+export declare function toERC681({ abi, address, functionName, args, value, gas, gasPrice, chainId, }: toERC681Params): string;
+//# sourceMappingURL=toERC681.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toERC681.d.ts","sourceRoot":"","sources":["../../../src/utils/toERC681.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,GAAG,EAAgC,MAAM,MAAM,CAAA;AAE7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAE1C,MAAM,MAAM,cAAc,GAAG;IAC3B,qCAAqC;IACrC,iCAAiC;IACjC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,EAAE,CAAA;IACrB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAA;IAChB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;IACnC,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,GAAQ,EACR,OAAO,EACP,YAAY,EACZ,IAAS,EACT,KAAK,EACL,GAAG,EACH,QAAQ,EACR,OAAO,GACR,EAAE,cAAc,GAAG,MAAM,CAoCzB"}

package/dist/cjs/utils/toERC681.js

@@ -0,0 +1,64 @@
+"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.toERC681 = toERC681;
+const node_url_1 = require("node:url");
+const viem_1 = require("viem");
+/**
+ * Creates an ERC-681 compliant URI for Ethereum payment or function call requests.
+ *
+ * @see {@link https://eips.ethereum.org/EIPS/eip-681 | EIP-681: URL Format for Transaction Requests}
+ * @returns An ERC-681 compliant URI
+ *
+ * @example
+ * Payment request
+ * ```typescript
+ * toERC681({ address: '0x0000000000000000000000000000000000000000', value: 1000000n })
+ * // => "ethereum:0x0000000000000000000000000000000000000000?value=1000000"
+ * ```
+ *
+ * @example
+ * Function call with chain ID
+ * ```typescript
+ * toERC681({
+ *   address: '0x0000000000000000000000000000000000000000',
+ *   functionName: 'transfer',
+ *   args: ['0x0000000000000000000000000000000000000000', '1000'],
+ *   chainId: 1
+ * })
+ * // => "ethereum:0x0000000000000000000000000000000000000000@1/transfer?address=0x0000000000000000000000000000000000000000&uint256=1000"
+ * ```
+ */
+function toERC681({ abi = [], address, functionName, args = [], value, gas, gasPrice, chainId, }) {
+    const opts = {
+        protocol: 'ethereum',
+        hostname: address,
+        pathname: undefined,
+        search: undefined,
+    };
+    const query = new URLSearchParams(Object.entries({ value, gas, gasPrice })
+        .filter(([, value]) => value !== undefined)
+        .map(([key, value]) => [key, String(value)]));
+    if (chainId != null) {
+        opts.hostname = `${opts.hostname}@${chainId}`;
+    }
+    if (functionName) {
+        const { inputs } = (0, viem_1.getAbiItem)({ abi, name: functionName });
+        opts.pathname = `/${functionName}`;
+        args.forEach((value, index) => {
+            query.append(inputs[index].type, String(value));
+        });
+    }
+    opts.search = query.toString();
+    return (0, node_url_1.format)(opts);
+}
+//# sourceMappingURL=toERC681.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toERC681.js","sourceRoot":"","sources":["../../../src/utils/toERC681.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AAqDnF,4BA6CC;AAhGD,uCAAiC;AAEjC,+BAA6D;AAwB7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,QAAQ,CAAC,EACvB,GAAG,GAAG,EAAE,EACR,OAAO,EACP,YAAY,EACZ,IAAI,GAAG,EAAE,EACT,KAAK,EACL,GAAG,EACH,QAAQ,EACR,OAAO,GACQ;IACf,MAAM,IAAI,GAKN;QACF,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,OAAO;QACjB,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,SAAS;KAClB,CAAA;IAED,MAAM,KAAK,GAAG,IAAI,eAAe,CAC/B,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;SACrC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAC/C,CAAA;IAED,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAA;IAC/C,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,iBAAU,EAAC,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,CAAgB,CAAA;QAEzE,IAAI,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAA;QAElC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC5B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACjD,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAA;IAE9B,OAAO,IAAA,iBAAM,EAAC,IAAI,CAAC,CAAA;AACrB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,100 @@
+"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 toERC681_js_1 = require("./toERC681.js");
+(0, vitest_1.describe)('toERC681', () => {
+    (0, vitest_1.describe)('native token transfer request', () => {
+        (0, vitest_1.test)('with address and value', () => {
+            (0, vitest_1.expect)((0, toERC681_js_1.toERC681)({
+                address: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+                value: 10000000n,
+            })).toBe('ethereum:0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238?value=10000000');
+        });
+        (0, vitest_1.test)('with address, value, chain', () => {
+            (0, vitest_1.expect)((0, toERC681_js_1.toERC681)({
+                address: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+                value: 10000000n,
+                chainId: 137,
+            })).toBe('ethereum:0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238@137?value=10000000');
+        });
+        (0, vitest_1.test)('with address, value, chainId, gas, gasPrice', () => {
+            (0, vitest_1.expect)((0, toERC681_js_1.toERC681)({
+                address: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
+                value: 10000000n,
+                chainId: 137,
+                gas: 111n,
+                gasPrice: 333n,
+            })).toBe('ethereum:0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238@137?value=10000000&gas=111&gasPrice=333');
+        });
+    });
+    (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',
+                },
+            ],
+        };
+        (0, vitest_1.test)('transfer(address, amount)', () => {
+            (0, vitest_1.expect)((0, toERC681_js_1.toERC681)({
+                abi: USDC.abi,
+                address: USDC.address,
+                functionName: 'transfer',
+                args: ['0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238', 10000000n],
+            })).toBe(`ethereum:${USDC.address}/transfer?address=0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238&uint256=10000000`);
+        });
+        (0, vitest_1.test)('transfer(address, amount) with chain', () => {
+            (0, vitest_1.expect)((0, toERC681_js_1.toERC681)({
+                abi: USDC.abi,
+                address: USDC.address,
+                chainId: 137,
+                functionName: 'transfer',
+                args: ['0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238', 10000000n],
+            })).toBe(`ethereum:${USDC.address}@137/transfer?address=0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238&uint256=10000000`);
+        });
+        (0, vitest_1.test)('unknown functionName should error', () => {
+            (0, vitest_1.expect)(() => {
+                (0, toERC681_js_1.toERC681)({
+                    abi: USDC.abi,
+                    address: USDC.address,
+                    chainId: 137,
+                    functionName: 'abc',
+                    args: ['0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238', 10000000n],
+                });
+            }).toThrowError();
+        });
+    });
+});
+//# sourceMappingURL=toERC681.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toERC681.test.js","sourceRoot":"","sources":["../../../src/utils/toERC681.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,+CAAwC;AAIxC,IAAA,iBAAQ,EAAC,UAAU,EAAE,GAAG,EAAE;IACxB,IAAA,iBAAQ,EAAC,+BAA+B,EAAE,GAAG,EAAE;QAC7C,IAAA,aAAI,EAAC,wBAAwB,EAAE,GAAG,EAAE;YAClC,IAAA,eAAM,EACJ,IAAA,sBAAQ,EAAC;gBACP,OAAO,EAAE,4CAAuD;gBAChE,KAAK,EAAE,SAAS;aACjB,CAAC,CACH,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAA;QAC9E,CAAC,CAAC,CAAA;QAEF,IAAA,aAAI,EAAC,4BAA4B,EAAE,GAAG,EAAE;YACtC,IAAA,eAAM,EACJ,IAAA,sBAAQ,EAAC;gBACP,OAAO,EAAE,4CAAuD;gBAChE,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,GAAG;aACb,CAAC,CACH,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAA;QAClF,CAAC,CAAC,CAAA;QAEF,IAAA,aAAI,EAAC,6CAA6C,EAAE,GAAG,EAAE;YACvD,IAAA,eAAM,EACJ,IAAA,sBAAQ,EAAC;gBACP,OAAO,EAAE,4CAAuD;gBAChE,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,GAAG;gBACZ,GAAG,EAAE,IAAI;gBACT,QAAQ,EAAE,IAAI;aACf,CAAC,CACH,CAAC,IAAI,CAAC,6FAA6F,CAAC,CAAA;QACvG,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAA,iBAAQ,EAAC,8BAA8B,EAAE,GAAG,EAAE;QAC5C,MAAM,IAAI,GAAG;YACX,OAAO,EAAE,4CAAuD;YAChE,GAAG,EAAE;gBACH;oBACE,MAAM,EAAE;wBACN;4BACE,YAAY,EAAE,SAAS;4BACvB,IAAI,EAAE,IAAI;4BACV,IAAI,EAAE,SAAS;yBAChB;wBACD;4BACE,YAAY,EAAE,SAAS;4BACvB,IAAI,EAAE,OAAO;4BACb,IAAI,EAAE,SAAS;yBAChB;qBACF;oBACD,IAAI,EAAE,UAAU;oBAChB,OAAO,EAAE;wBACP;4BACE,YAAY,EAAE,MAAM;4BACpB,IAAI,EAAE,EAAE;4BACR,IAAI,EAAE,MAAM;yBACb;qBACF;oBACD,eAAe,EAAE,YAAY;oBAC7B,IAAI,EAAE,UAAU;iBACjB;aACF;SACF,CAAA;QAED,IAAA,aAAI,EAAC,2BAA2B,EAAE,GAAG,EAAE;YACrC,IAAA,eAAM,EACJ,IAAA,sBAAQ,EAAC;gBACP,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,YAAY,EAAE,UAAU;gBACxB,IAAI,EAAE,CAAC,4CAA4C,EAAE,SAAS,CAAC;aAChE,CAAC,CACH,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,+EAA+E,CAAC,CAAA;QACjH,CAAC,CAAC,CAAA;QAEF,IAAA,aAAI,EAAC,sCAAsC,EAAE,GAAG,EAAE;YAChD,IAAA,eAAM,EACJ,IAAA,sBAAQ,EAAC;gBACP,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,GAAG;gBACZ,YAAY,EAAE,UAAU;gBACxB,IAAI,EAAE,CAAC,4CAA4C,EAAE,SAAS,CAAC;aAChE,CAAC,CACH,CAAC,IAAI,CACJ,YAAY,IAAI,CAAC,OAAO,mFAAmF,CAC5G,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,IAAA,aAAI,EAAC,mCAAmC,EAAE,GAAG,EAAE;YAC7C,IAAA,eAAM,EAAC,GAAG,EAAE;gBACV,IAAA,sBAAQ,EAAC;oBACP,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,OAAO,EAAE,GAAG;oBACZ,YAAY,EAAE,KAAK;oBACnB,IAAI,EAAE,CAAC,4CAA4C,EAAE,SAAS,CAAC;iBAChE,CAAC,CAAA;YACJ,CAAC,CAAC,CAAC,YAAY,EAAE,CAAA;QACnB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * Wraps a value in an asynchronous function.
+ *
+ * @typeParam T - The type of value being wrapped
+ * @param value - The value to be wrapped
+ * @returns A function that returns a promise resolving to the value
+ */
+export declare function wrapAsync<T>(value: T): () => Promise<T>;
+//# sourceMappingURL=wrapAsync.d.ts.map

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

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

package/dist/cjs/utils/wrapAsync.js

@@ -0,0 +1,25 @@
+"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.wrapAsync = wrapAsync;
+/**
+ * Wraps a value in an asynchronous function.
+ *
+ * @typeParam T - The type of value being wrapped
+ * @param value - The value to be wrapped
+ * @returns A function that returns a promise resolving to the value
+ */
+function wrapAsync(value) {
+    // eslint-disable-next-line @typescript-eslint/require-await
+    return async () => value;
+}
+//# sourceMappingURL=wrapAsync.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wrapAsync.js","sourceRoot":"","sources":["../../../src/utils/wrapAsync.ts"],"names":[],"mappings":";AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;;AASnF,8BAGC;AAVD;;;;;;GAMG;AACH,SAAgB,SAAS,CAAI,KAAQ;IACnC,4DAA4D;IAC5D,OAAO,KAAK,IAAI,EAAE,CAAC,KAAK,CAAA;AAC1B,CAAC"}

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

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

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

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

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

@@ -0,0 +1,22 @@
+"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 wrapAsync_js_1 = require("./wrapAsync.js");
+vitest_1.describe.concurrent('wrapAsync()', () => {
+    vitest_1.test.for([undefined, null, 0, 1, '', 'foo', [], {}])('should return an async function that returns the input value', async (value) => {
+        const fn = (0, wrapAsync_js_1.wrapAsync)(value);
+        (0, vitest_1.expect)(fn.constructor.name).toBe('AsyncFunction');
+        await (0, vitest_1.expect)(fn()).resolves.toBe(value);
+    });
+});
+//# sourceMappingURL=wrapAsync.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wrapAsync.test.js","sourceRoot":"","sources":["../../../src/utils/wrapAsync.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,iDAA0C;AAE1C,iBAAQ,CAAC,UAAU,CAAC,aAAa,EAAE,GAAG,EAAE;IACtC,aAAI,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAClD,8DAA8D,EAC9D,KAAK,EAAE,KAAK,EAAE,EAAE;QACd,MAAM,EAAE,GAAG,IAAA,wBAAS,EAAC,KAAK,CAAC,CAAA;QAE3B,IAAA,eAAM,EAAC,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;QACjD,MAAM,IAAA,eAAM,EAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACzC,CAAC,CACF,CAAA;AACH,CAAC,CAAC,CAAA"}

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

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

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

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

package/dist/esm/actions/drainFrom.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"drainFrom.js","sourceRoot":"","sources":["../../../src/actions/drainFrom.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;AAEnF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtC,OAAO,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,uEAAuE,CAAA;AAE7H,OAAO,EAAgD,QAAQ,EAAE,MAAM,eAAe,CAAA;AAUtF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAA0B,EAAE,MAAuB;IACjF,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,kBAAkB,CAAC,CAAA;IACjF,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,MAAM,CAAA;IAE/B;;;;;OAKG;IACH,KAAK,UAAU,UAAU,CAAC,OAAgB;QACxC,MAAM,QAAQ,GAAG,CAAC,MAAM,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAwB,CAAA;QACpF,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAA;IACpC,CAAC;IAED,OAAO,MAAM,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;AAClE,CAAC"}

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,33 @@
+import { type Chain, type ChainContract } from 'viem';
+import { type Account, type Address, type NativeUnits, type BaseUnits, type ExtendedViemClient } from '../types.js';
+export type GenerateTransferLinkParams = {
+    /** The recipient address. */
+    to: Address | Account;
+    /** The amount to transfer. */
+    amount: NativeUnits | BaseUnits;
+    /** The token address (optional). */
+    token?: Address | ChainContract | null;
+    /** The blockchain chain to use (optional, defaults to client's chain). */
+    chain?: Chain;
+};
+/**
+ * Generates a ERC-681 transfer link for a specified recipient and amount.
+ *
+ * @param client - The client instance to use for the operation.
+ * @returns A promise that resolves to the generated transfer link.
+ *
+ * @throws Will throw an error if the contract read operation fails.
+ *
+ * @example
+ * ```typescript
+ * const link = await generateTransferLink(client, {
+ *   to: '0xRecipientAddress',
+ *   amount: '100',
+ *   chain: someChain,
+ *   token: '0xTokenAddress'
+ * });
+ * console.log(link);
+ * ```
+ */
+export declare function generateTransferLink(client: ExtendedViemClient, params: GenerateTransferLinkParams): Promise<string>;
+//# sourceMappingURL=generateTransferLink.d.ts.map

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

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