@circle-fin/usdckit 0.13.0 → 0.15.0

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,IAAI,iCAAiC,EAAE,MAAM,4DAA4D,CAAA;AAC9H,OAAO,KAAK,EAAE,cAAc,IAAI,yBAAyB,EAAE,MAAM,uDAAuD,CAAA;AACxH,OAAO,KAAK,EAAE,OAAO,IAAI,gCAAgC,EAAE,MAAM,2DAA2D,CAAA;AAC5H,OAAO,KAAK,EAAE,cAAc,IAAI,gCAAgC,EAAE,MAAM,sDAAsD,CAAA;AAC9H,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,KAAK,EAAE,OAAO,IAAI,4BAA4B,EAAE,MAAM,sDAAsD,CAAA;AACnH,OAAO,KAAK,EAAE,cAAc,IAAI,4BAA4B,EAAE,MAAM,iDAAiD,CAAA;AACrH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,KAAK,EACV,OAAO,IAAI,QAAQ,EACnB,MAAM,EACN,KAAK,EACL,MAAM,EACN,cAAc,EACd,QAAQ,EACR,aAAa,EACb,SAAS,EACT,aAAa,EACd,MAAM,MAAM,CAAA;AAEb,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAEhD,YAAY,EAAE,OAAO,EAAE,qBAAqB,IAAI,QAAQ,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAA;AAExF,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAGlD,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,gCAAgC;IACnC,GAAG,4BAA4B;IAC/B,GAAG,aAAa;IAChB,GAAG,yBAAyB;IAC5B,GAAG,cAAc;CAClB,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,SAAS,SAAS,SAAS,GAAG,SAAS,EAAE,KAAK,SAAS,KAAK,GAAG,KAAK,IAAI,MAAM,CAC3G,SAAS,EACT,KAAK,EACL,OAAO,EACP,sBAAsB,CACvB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,GACpE,aAAa,GACb,gCAAgC,GAChC,4BAA4B,GAC5B,aAAa,GACb,iCAAiC,GACjC,WAAW,CAAA;AAEb;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,MAAM,EAAE,CAAA;AAGrC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,IAAI,MAAM,CAAA;IAClB,MAAM,IAAI,MAAM,CAAA;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,OAAO,IAAI,iCAAiC,EAAE,MAAM,4DAA4D,CAAA;AAC9H,OAAO,KAAK,EAAE,cAAc,IAAI,yBAAyB,EAAE,MAAM,uDAAuD,CAAA;AACxH,OAAO,KAAK,EAAE,OAAO,IAAI,gCAAgC,EAAE,MAAM,2DAA2D,CAAA;AAC5H,OAAO,KAAK,EAAE,cAAc,IAAI,gCAAgC,EAAE,MAAM,sDAAsD,CAAA;AAC9H,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,KAAK,EAAE,cAAc,IAAI,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,KAAK,EAAE,OAAO,IAAI,4BAA4B,EAAE,MAAM,sDAAsD,CAAA;AACnH,OAAO,KAAK,EAAE,cAAc,IAAI,4BAA4B,EAAE,MAAM,iDAAiD,CAAA;AACrH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAClC,OAAO,KAAK,EACV,OAAO,IAAI,QAAQ,EACnB,MAAM,EACN,KAAK,EACL,MAAM,EACN,cAAc,EACd,QAAQ,EACR,aAAa,EACb,SAAS,EACT,aAAa,EACd,MAAM,MAAM,CAAA;AAEb,MAAM,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAEhD,YAAY,EAAE,OAAO,EAAE,qBAAqB,IAAI,QAAQ,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAA;AAExF,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAA;AAGlD,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,gCAAgC;IACnC,GAAG,4BAA4B;IAC/B,GAAG,aAAa;IAChB,GAAG,yBAAyB;IAC5B,GAAG,cAAc;CAClB,CAAA;AAED,MAAM,MAAM,kBAAkB,CAAC,SAAS,SAAS,SAAS,GAAG,SAAS,EAAE,KAAK,SAAS,KAAK,GAAG,KAAK,IAAI,MAAM,CAC3G,SAAS,EACT,KAAK,EACL,OAAO,EACP,sBAAsB,CACvB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;CACpC,GAAG,aAAa,GACf,aAAa,GACb,gCAAgC,GAChC,4BAA4B,GAC5B,aAAa,GACb,iCAAiC,GACjC,WAAW,CAAA;AAEb;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,GAAG,MAAM,EAAE,CAAA;AAGrC;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,IAAI,MAAM,CAAA;IAClB,MAAM,IAAI,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;;;;;;;;;;;;;;;;SAqBK;IACL,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA"}

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

@@ -9,7 +9,7 @@
 // of this source code or any related proprietary information is strictly
 // prohibited without the express written permission of Circle Internet Group, Inc.
 import { expect, describe, it } from 'vitest';
-import { formatUnits } from './index.js';
+import { formatUnits } from './formatUnits.js';
 describe.concurrent('formatUnits', () => {
     it('should format bigint value to string with given decimals', () => {
         expect(formatUnits(1000000000000000000000n, 18)).toBe('1000');

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

@@ -1 +1 @@
-{"version":3,"file":"formatUnits.test.js","sourceRoot":"","sources":["../../../src/utils/formatUnits.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,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,QAAQ,CAAC,UAAU,CAAC,aAAa,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,WAAW,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC7D,MAAM,CAAC,WAAW,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACzD,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QACxD,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACrC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;QAC1D,MAAM,CAAC,WAAW,CAAC,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC3D,MAAM,CAAC,WAAW,CAAC,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/D,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjC,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5C,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC5C,MAAM,CAAC,WAAW,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QAC5E,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACtC,MAAM,CAAC,WAAW,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;QAC9E,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC9C,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC9C,MAAM,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QACxE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAClC,MAAM,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAA0B,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAA;QACxE,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAA4B,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,CAAA;IAC5E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"formatUnits.test.js","sourceRoot":"","sources":["../../../src/utils/formatUnits.test.ts"],"names":[],"mappings":"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"}

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

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

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

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

package/dist/esm/utils/getChainContractByAddress.js

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"getChainContractByAddress.test.js","sourceRoot":"","sources":["../../../src/utils/getChainContractByAddress.test.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;AAEnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,MAAM,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAE/C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAE1E,QAAQ,CAAC,UAAU,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACpD,IAAI,CAAC,IAAI,CAAC;QACR,CAAC,CAAC,WAAW,EAAE,4CAA4C,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC;QACzF,CAAC,CAAC,UAAU,EAAE,4CAA4C,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC;KAC/E,CAAC,CAAC,4CAA4C,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,EAAE;QAC7F,MAAM,CAAC,yBAAyB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,IAAI,CAAC;QACR,CAAC,CAAC,WAAW,EAAE,4CAA4C,CAAC,CAAC;QAC7D,CAAC,CAAC,UAAU,EAAE,4CAA4C,CAAC,CAAC;KACpD,CAAC,CAAC,qCAAqC,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE;QACtE,MAAM,CAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAA;IACnG,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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

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

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

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

package/dist/esm/utils/index.js

@@ -8,9 +8,13 @@
 // 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.
-export { generateIdempotencyKey } from './generateIdempotencyKey.js';
-export { formatUnits } from './formatUnits.js';
-export { parseUnits } from './parseUnits.js';
-export * from './toERC681.js';
+export * from './formatUnits.js';
+export * from './generateIdempotencyKey.js';
+export * from './getChainContractByAddress.js';
+export * from './max.js';
 export * from './parseAccount.js';
+export * from './parseAddress.js';
+export * from './parseUnits.js';
+export * from './toERC681.js';
+export * from './wrapAsync.js';
 //# sourceMappingURL=index.js.map

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,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.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,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA"}

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

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

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

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

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

@@ -0,0 +1,43 @@
+// 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 * as mod from './index.js';
+describe.concurrent('utils', () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should return an object with the expected methods', () => {
+        expect(new Set(Object.keys(mod))).toEqual(new Set([
+            'InvalidDecimalNumberError',
+            'formatUnits',
+            'generateIdempotencyKey',
+            'getChainContractByAddress',
+            'max',
+            'parseAccount',
+            'parseAddress',
+            'parseUnits',
+            'parseAddress',
+            'toERC681',
+            'wrapAsync',
+        ]));
+        expect(mod.InvalidDecimalNumberError).toBeDefined();
+        expect(mod.formatUnits).toEqual(expect.any(Function));
+        expect(mod.generateIdempotencyKey).toEqual(expect.any(Function));
+        expect(mod.getChainContractByAddress).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));
+        expect(mod.parseUnits).toEqual(expect.any(Function));
+        expect(mod.toERC681).toEqual(expect.any(Function));
+        expect(mod.wrapAsync).toEqual(expect.any(Function));
+    });
+});
+//# sourceMappingURL=index.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/utils/index.test.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,uBAAuB;AACvB,EAAE;AACF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,kDAAkD;AAClD,8EAA8E;AAC9E,yEAAyE;AACzE,mFAAmF;AAEnF,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,cAAc;YACd,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,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/usdckit",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/circlefin/w3s-node-sdk.git"
@@ -11,37 +11,37 @@
     "packages/*"
   ],
   "dependencies": {
-    "@circle-fin/developer-controlled-wallets": "^7.2.0",
-    "@circle-fin/smart-contract-platform": "^7.2.0",
+    "@circle-fin/developer-controlled-wallets": "~7.2.0",
+    "@circle-fin/smart-contract-platform": "~7.2.0",
     "core-js": "^3.40.0",
     "pino": "^9.6.0",
     "uuid": "^11.0.3",
     "viem": "^2.23.13"
   },
   "devDependencies": {
-    "@eslint/compat": "^1.2.4",
-    "@eslint/js": "^9.17.0",
+    "@eslint/compat": "^1.2.8",
+    "@eslint/js": "^9.24.0",
     "@eslint/json": "^0.11.0",
     "@eslint/markdown": "^6.2.1",
-    "@types/node": "^22.10.2",
-    "@typescript-eslint/parser": "^8.19.1",
-    "@vitest/coverage-v8": "^3.0.5",
-    "eslint": "^9.17.0",
-    "eslint-config-prettier": "^10.0.0",
+    "@types/node": "^22.14.0",
+    "@typescript-eslint/parser": "^8.29.1",
+    "@vitest/coverage-v8": "^3.1.1",
+    "eslint": "^9.24.0",
+    "eslint-config-prettier": "^10.1.2",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-jsdoc": "^50.6.1",
-    "eslint-plugin-prettier": "^5.2.1",
+    "eslint-plugin-prettier": "^5.2.6",
     "eslint-plugin-promise": "^7.2.1",
     "eslint-plugin-tsdoc": "^0.4.0",
     "eslint-plugin-vitest": "^0.5.4",
     "globals": "^16.0.0",
-    "lefthook": "^1.10.10",
+    "lefthook": "^1.11.8",
     "pino-pretty": "^13.0.0",
     "prettier": "3.5.3",
     "tsx": "^4.19.2",
-    "typedoc": "^0.28.0",
-    "typescript": "^5.7.2",
-    "typescript-eslint": "^8.19.1",
+    "typedoc": "^0.28.2",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.29.1",
     "vitest": "^3.0.5"
   },
   "engines": {