@aptos-labs/ts-sdk 6.3.0 → 7.0.0

package/dist/utils/helpers.js

@@ -0,0 +1,330 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+import { AccountAddress } from "../core/accountAddress.js";
+import { createObjectAddress } from "../core/account/utils/address.js";
+import { TEXT_ENCODER } from "./const.js";
+/**
+ * Checks if the current runtime environment is Bun.
+ * This is useful for detecting Bun-specific compatibility issues.
+ *
+ * @returns true if running in Bun, false otherwise.
+ * @group Implementation
+ * @category Utils
+ */
+export function isBun() {
+    try {
+        // Bun exposes a global `Bun` object.
+        return typeof globalThis !== "undefined" && "Bun" in globalThis;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read an environment variable in a runtime-agnostic way. Returns `undefined` when
+ * `process.env` is not available (browsers, some bundlers) or the variable is unset.
+ *
+ * @group Implementation
+ * @category Utils
+ */
+export function getEnvVar(name) {
+    return typeof process !== "undefined" ? process.env?.[name] : undefined;
+}
+/**
+ * Logs a warning message to the console only in development environments.
+ * This function helps reduce information leakage in production while maintaining
+ * helpful warnings during development.
+ *
+ * @param message - The warning message to log.
+ * @group Implementation
+ * @category Utils
+ */
+export function warnIfDevelopment(message) {
+    // Check common environment variables to determine if we're in development
+    // This works in Node.js, bundlers like webpack/vite, and most build systems
+    const isDevelopment = typeof process !== "undefined" &&
+        process.env &&
+        (process.env.NODE_ENV === "development" ||
+            process.env.NODE_ENV === "test" ||
+            process.env.APTOS_SDK_WARNINGS === "true");
+    if (isDevelopment) {
+        console.warn(message);
+    }
+}
+/**
+ * Sleep for the specified amount of time in milliseconds.
+ * This function can be used to introduce delays in asynchronous operations.
+ *
+ * @param timeMs - The time in milliseconds to sleep.
+ * @group Implementation
+ * @category Utils
+ */
+export async function sleep(timeMs) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, timeMs);
+    });
+}
+/**
+ * Get the error message from an unknown error.
+ *
+ * @param error The error to get the message from
+ * @returns The error message
+ * @group Implementation
+ * @category Utils
+ */
+export function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * @group Implementation
+ * @category Utils
+ */
+export const nowInSeconds = () => Math.floor(Date.now() / 1000);
+/**
+ * Floors the given timestamp to the nearest whole hour.
+ * This function is useful for normalizing timestamps to hourly intervals.
+ *
+ * @param timestampInSeconds - The timestamp in seconds to be floored.
+ * @group Implementation
+ * @category Utils
+ */
+export function floorToWholeHour(timestampInSeconds) {
+    const date = new Date(timestampInSeconds * 1000);
+    // Reset minutes and seconds to zero
+    date.setMinutes(0);
+    date.setSeconds(0);
+    date.setMilliseconds(0);
+    return Math.floor(date.getTime() / 1000);
+}
+/**
+ * Decodes a base64 URL-encoded string into its original form.
+ * This function is useful for converting base64 URL-encoded data back to a readable format.
+ *
+ * @param base64Url - The base64 URL-encoded string to decode.
+ * @returns The decoded string.
+ * @group Implementation
+ * @category Utils
+ */
+export function base64UrlDecode(base64Url) {
+    // Decode the bytes, then interpret as UTF-8. `atob` alone returns a Latin-1 binary
+    // string which corrupts any non-ASCII characters in JWT headers/payloads.
+    return new TextDecoder("utf-8").decode(base64UrlToBytes(base64Url));
+}
+/**
+ * Encode a string or byte array as a base64url string (RFC 4648 §5) with no padding.
+ *
+ * @param input - The data to encode. Strings are interpreted as UTF-8.
+ * @returns The base64url-encoded string.
+ * @group Implementation
+ * @category Utils
+ */
+export function base64UrlEncode(input) {
+    const bytes = typeof input === "string" ? TEXT_ENCODER.encode(input) : input;
+    // btoa requires a Latin-1 string. Build it in chunks of 8 KiB so we avoid
+    // `String.fromCharCode(...hugeArray)` call-stack overflows while still
+    // keeping conversion linear-time (concatenating per-byte is O(n^2) in many
+    // engines).
+    const CHUNK = 0x8000;
+    let binary = "";
+    if (bytes.length <= CHUNK) {
+        binary = String.fromCharCode.apply(null, bytes);
+    }
+    else {
+        const parts = [];
+        for (let i = 0; i < bytes.length; i += CHUNK) {
+            const chunk = bytes.subarray(i, i + CHUNK);
+            parts.push(String.fromCharCode.apply(null, chunk));
+        }
+        binary = parts.join("");
+    }
+    return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+export function base64UrlToBytes(base64Url) {
+    // Convert base64url to standard base64, then decode with universal atob.
+    // Standard base64 encodes 3 bytes as 4 chars, so the decoded input length
+    // must be a multiple of 4 — pad with `=` based on `length % 4`.
+    const base64 = base64Url.replace(/-/g, "+").replace(/_/g, "/");
+    const padded = base64 + "===".substring(0, (4 - (base64.length % 4)) % 4);
+    const binary = atob(padded);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+/**
+ * Amount is represented in the smallest unit format on chain, this function converts
+ * a human-readable amount format to the smallest unit format
+ * @example
+ * human-readable amount format: 500
+ * on chain amount format when decimal is 8: 50000000000
+ *
+ * @param value The value in human-readable format
+ * @param decimal The token decimal
+ * @returns The value in the smallest units
+ * @group Implementation
+ * @category Utils
+ */
+export const convertAmountFromHumanReadableToOnChain = (value, decimal) => value * 10 ** decimal;
+/**
+ * Amount is represented in the smallest unit format on chain, this function converts
+ * the smallest unit format to a human-readable amount format
+ * @example
+ * human-readable amount format: 500
+ * on chain amount format when decimal is 8: 50000000000
+ *
+ * @param value The value in human-readable format
+ * @param decimal The token decimal
+ * @returns The value in the smallest units
+ * @group Implementation
+ * @category Utils
+ */
+export const convertAmountFromOnChainToHumanReadable = (value, decimal) => value / 10 ** decimal;
+/**
+ * Convert a hex string to an ascii string with the `0x` prefix.
+ *
+ * `0x6170746f735f636f696e` --> `aptos_coin`
+ *
+ * @param hex The hex string to convert (e.g. `0x6170746f735f636f696e`)
+ * @returns The ascii string
+ * @group Implementation
+ * @category Utils
+ */
+const hexToAscii = (hex) => {
+    let str = "";
+    for (let n = 2; n < hex.length; n += 2) {
+        str += String.fromCharCode(parseInt(hex.substring(n, n + 2), 16));
+    }
+    return str;
+};
+/**
+ * Convert an encoded struct to a MoveStructId.
+ *
+ * @example
+ * const structObj = {
+ *   account_address: "0x1",
+ *   module_name: "0x6170746f735f636f696e",
+ *   struct_name: "0x4170746f73436f696e",
+ * };
+ * // structId is "0x1::aptos_coin::AptosCoin"
+ * const structId = parseEncodedStruct(structObj);
+ *
+ * @param structObj The struct with account_address, module_name, and struct_name properties
+ * @returns The MoveStructId
+ * @group Implementation
+ * @category Utils
+ */
+export const parseEncodedStruct = (structObj) => {
+    const { account_address, module_name, struct_name } = structObj;
+    const moduleName = hexToAscii(module_name);
+    const structName = hexToAscii(struct_name);
+    return `${account_address}::${moduleName}::${structName}`;
+};
+/**
+ * Determines whether the given object is an encoded struct type with the following properties:
+ * - account_address: string
+ * - module_name: string
+ * - struct_name: string
+ *
+ * @param structObj The object to check
+ * @returns Whether the object is an encoded struct type
+ * @group Implementation
+ * @category Utils
+ */
+export const isEncodedStruct = (structObj) => typeof structObj === "object" &&
+    !Array.isArray(structObj) &&
+    structObj !== null &&
+    "account_address" in structObj &&
+    "module_name" in structObj &&
+    "struct_name" in structObj &&
+    typeof structObj.account_address === "string" &&
+    typeof structObj.module_name === "string" &&
+    typeof structObj.struct_name === "string";
+/**
+ * Splits a function identifier into its constituent parts: module address, module name, and function name.
+ * This function helps in validating and extracting details from a function identifier string.
+ *
+ * @param functionArg - The function identifier string in the format "moduleAddress::moduleName::functionName".
+ * @returns An object containing the module address, module name, and function name.
+ * @throws Error if the function identifier does not contain exactly three parts.
+ * @group Implementation
+ * @category Transactions
+ */
+export function getFunctionParts(functionArg) {
+    const funcNameParts = functionArg.split("::");
+    if (funcNameParts.length !== 3) {
+        throw new Error(`Invalid function ${functionArg}`);
+    }
+    const moduleAddress = funcNameParts[0];
+    const moduleName = funcNameParts[1];
+    const functionName = funcNameParts[2];
+    return { moduleAddress, moduleName, functionName };
+}
+/**
+ * Validates the provided function information.
+ *
+ * @param functionInfo - The function information to validate.
+ * @returns Whether the function information is valid.
+ * @group Implementation
+ * @category Utils
+ */
+export function isValidFunctionInfo(functionInfo) {
+    const parts = functionInfo.split("::");
+    return parts.length === 3 && AccountAddress.isValid({ input: parts[0] }).valid;
+}
+/**
+ * Truncates the provided wallet address at the middle with an ellipsis.
+ *
+ * @param address - The wallet address to truncate.
+ * @param start - The number of characters to show at the beginning of the address.
+ * @param end - The number of characters to show at the end of the address.
+ * @returns The truncated address.
+ * @group Implementation
+ * @category Utils
+ */
+export function truncateAddress(address, start = 6, end = 5) {
+    return `${address.slice(0, start)}...${address.slice(-end)}`;
+}
+/**
+ * Constants for metadata address calculation
+ */
+const APTOS_COIN_TYPE_STR = "0x1::aptos_coin::AptosCoin";
+/**
+ * Helper function to standardize Move type string by converting all addresses to short form,
+ * including addresses within nested type parameters
+ */
+function standardizeMoveTypeString(input) {
+    // Regular expression to match addresses in the type string, including those within type parameters
+    // This regex matches "0x" followed by hex digits, handling both standalone addresses and those within <>
+    const addressRegex = /0x[0-9a-fA-F]+/g;
+    return input.replace(addressRegex, (match) => 
+    // Use AccountAddress to handle the address
+    AccountAddress.from(match, { maxMissingChars: 63 }).toStringShort());
+}
+/**
+ * Calculates the paired FA metadata address for a given coin type.
+ * This function is tolerant of various address formats in the coin type string,
+ * including complex nested types.
+ *
+ * @example
+ * // All these formats are valid and will produce the same result:
+ * pairedFaMetadataAddress("0x1::aptos_coin::AptosCoin")  // simple form
+ * pairedFaMetadataAddress("0x0000000000000000000000000000000000000000000000000000000000000001::aptos_coin::AptosCoin")  // long form
+ * pairedFaMetadataAddress("0x00001::aptos_coin::AptosCoin")  // with leading zeros
+ * pairedFaMetadataAddress("0x1::coin::Coin<0x1412::a::struct<0x0001::aptos_coin::AptosCoin>>")  // nested type parameters
+ *
+ * @param coinType - The coin type string in any of these formats:
+ *   - Short form address: "0x1::aptos_coin::AptosCoin"
+ *   - Long form address: "0x0000000000000000000000000000000000000000000000000000000000000001::aptos_coin::AptosCoin"
+ *   - With leading zeros: "0x00001::aptos_coin::AptosCoin"
+ *   - With nested types: "0x1::coin::Coin<0x1412::a::struct<0x0001::aptos_coin::AptosCoin>>"
+ * @returns The calculated metadata address as an AccountAddress instance
+ */
+export function pairedFaMetadataAddress(coinType) {
+    // Standardize the coin type string to handle any address format
+    const standardizedMoveTypeName = standardizeMoveTypeString(coinType);
+    return standardizedMoveTypeName === APTOS_COIN_TYPE_STR
+        ? AccountAddress.A
+        : createObjectAddress(AccountAddress.A, standardizedMoveTypeName);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./apiEndpoints.js";
+export * from "./const.js";
+export * from "./normalizeBundle.js";
+export * from "./helpers.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,5 @@
+export * from "./apiEndpoints.js";
+export * from "./const.js";
+export * from "./normalizeBundle.js";
+export * from "./helpers.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/dist/utils/memoize.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A memoize higher-order function to cache the response of an async function.
+ * This function helps to improve performance by avoiding repeated calls to the same async function with the same arguments
+ * within a specified time-to-live (TTL).
+ *
+ * Features:
+ * - LRU eviction when cache exceeds MAX_CACHE_SIZE entries
+ * - Periodic cleanup of expired entries to prevent memory leaks
+ *
+ * @param func The async function to cache the result of.
+ * @param key The cache key used to store the result.
+ * @param ttlMs The time-to-live in milliseconds for cached data.
+ * @returns The cached or latest result.
+ * @group Implementation
+ * @category Utils
+ */
+export declare function memoizeAsync<T>(func: (...args: any[]) => Promise<T>, key: string, ttlMs?: number): (...args: any[]) => Promise<T>;
+/**
+ * Caches the result of a function call to improve performance on subsequent calls with the same arguments.
+ *
+ * Features:
+ * - LRU eviction when cache exceeds MAX_CACHE_SIZE entries
+ * - Periodic cleanup of expired entries to prevent memory leaks
+ *
+ * @param key - The key to cache on, all accesses by this key will return the cached value.
+ * @param func - The function whose result will be cached.
+ * @param ttlMs - The time-to-live in milliseconds for cached data.
+ * @returns A memoized version of the provided function that returns the cached result if available and within TTL.
+ * @group Implementation
+ * @category Utils
+ */
+export declare function memoize<T>(func: (...args: any[]) => T, key: string, ttlMs?: number): (...args: any[]) => T;
+/**
+ * Clears all entries from the memoization cache.
+ * Useful for testing or when you need to force fresh data.
+ * @group Implementation
+ * @category Utils
+ */
+export declare function clearMemoizeCache(): void;
+/**
+ * Returns the current size of the memoization cache.
+ * Useful for monitoring and debugging.
+ * @group Implementation
+ * @category Utils
+ */
+export declare function getMemoizeCacheSize(): number;
+//# sourceMappingURL=memoize.d.ts.map

package/dist/utils/memoize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoize.d.ts","sourceRoot":"","sources":["../../src/utils/memoize.ts"],"names":[],"mappings":"AAuHA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC5B,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,EACpC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAiChC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAiC1G;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/utils/memoize.js

@@ -0,0 +1,195 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Maximum number of entries to keep in the cache to prevent unbounded memory growth.
+ * When this limit is exceeded, the oldest entries are evicted.
+ */
+const MAX_CACHE_SIZE = 1000;
+/**
+ * Interval in milliseconds for periodic cleanup of expired cache entries.
+ */
+const CLEANUP_INTERVAL_MS = 60000; // 1 minute
+/**
+ * Minimum required key length to help ensure uniqueness.
+ * Keys should include a namespace prefix (e.g., "module-abi-", "ledger-info-").
+ */
+const MIN_KEY_LENGTH = 10;
+/**
+ * Set of known cache key prefixes to help detect potential collisions.
+ * Each caller should use a unique prefix.
+ */
+const knownKeyPrefixes = new Set();
+/**
+ * Validates a cache key for basic security requirements.
+ * @param key - The cache key to validate
+ * @throws Error if the key is invalid
+ */
+function validateCacheKey(key) {
+    if (!key || typeof key !== "string") {
+        throw new Error("Cache key must be a non-empty string");
+    }
+    if (key.length < MIN_KEY_LENGTH) {
+        throw new Error(`Cache key "${key}" is too short. Keys should be at least ${MIN_KEY_LENGTH} characters and include a namespace prefix.`);
+    }
+    // Extract prefix (everything before the last hyphen or the first 10 chars)
+    const prefixMatch = key.match(/^([a-z]+-[a-z]+-)/i);
+    if (prefixMatch) {
+        knownKeyPrefixes.add(prefixMatch[1]);
+    }
+}
+/**
+ * The global cache Map shared across all functions with LRU eviction support.
+ * SECURITY: All cache keys should include a unique namespace prefix to prevent
+ * collisions between different caching use cases (e.g., "module-abi-", "ledger-info-").
+ * @group Implementation
+ * @category Utils
+ */
+const cache = new Map();
+/**
+ * Track whether cleanup interval is set up.
+ */
+let cleanupIntervalId = null;
+/**
+ * Sets up periodic cleanup of expired cache entries if not already running.
+ * This prevents memory leaks from accumulating expired entries.
+ */
+function ensureCleanupInterval() {
+    if (cleanupIntervalId === null) {
+        cleanupIntervalId = setInterval(() => {
+            const now = Date.now();
+            const keysToDelete = [];
+            cache.forEach((entry, key) => {
+                // Remove entries that have expired
+                if (entry.ttlMs !== undefined && now - entry.timestamp > entry.ttlMs) {
+                    keysToDelete.push(key);
+                }
+            });
+            keysToDelete.forEach((key) => cache.delete(key));
+            // If cache is empty, stop the cleanup interval to avoid unnecessary overhead
+            if (cache.size === 0 && cleanupIntervalId !== null) {
+                clearInterval(cleanupIntervalId);
+                cleanupIntervalId = null;
+            }
+        }, CLEANUP_INTERVAL_MS);
+        // Ensure the interval doesn't prevent Node.js from exiting
+        if (typeof cleanupIntervalId === "object" && "unref" in cleanupIntervalId) {
+            cleanupIntervalId.unref();
+        }
+    }
+}
+/**
+ * Evicts the least recently used entries when cache exceeds maximum size.
+ */
+function evictIfNeeded() {
+    if (cache.size >= MAX_CACHE_SIZE) {
+        // Find and remove the least recently accessed entries (remove ~10% of cache)
+        const entriesToRemove = Math.ceil(MAX_CACHE_SIZE * 0.1);
+        const entries = Array.from(cache.entries()).sort((a, b) => a[1].lastAccess - b[1].lastAccess);
+        for (let i = 0; i < entriesToRemove && i < entries.length; i += 1) {
+            cache.delete(entries[i][0]);
+        }
+    }
+}
+/**
+ * A memoize higher-order function to cache the response of an async function.
+ * This function helps to improve performance by avoiding repeated calls to the same async function with the same arguments
+ * within a specified time-to-live (TTL).
+ *
+ * Features:
+ * - LRU eviction when cache exceeds MAX_CACHE_SIZE entries
+ * - Periodic cleanup of expired entries to prevent memory leaks
+ *
+ * @param func The async function to cache the result of.
+ * @param key The cache key used to store the result.
+ * @param ttlMs The time-to-live in milliseconds for cached data.
+ * @returns The cached or latest result.
+ * @group Implementation
+ * @category Utils
+ */
+export function memoizeAsync(func, key, ttlMs) {
+    // Validate key format on first call to catch misuse early
+    validateCacheKey(key);
+    return async (...args) => {
+        const now = Date.now();
+        // Check if the cached result exists and is within TTL
+        if (cache.has(key)) {
+            const entry = cache.get(key);
+            if (ttlMs === undefined || now - entry.timestamp <= ttlMs) {
+                // Update last access time for LRU
+                entry.lastAccess = now;
+                return entry.value;
+            }
+            // Entry expired, remove it
+            cache.delete(key);
+        }
+        // If not cached or TTL expired, compute the result
+        const result = await func(...args);
+        // Evict old entries if needed before adding new one
+        evictIfNeeded();
+        // Cache the result with a timestamp
+        cache.set(key, { value: result, timestamp: now, lastAccess: now, ttlMs });
+        // Ensure cleanup is running
+        ensureCleanupInterval();
+        return result;
+    };
+}
+/**
+ * Caches the result of a function call to improve performance on subsequent calls with the same arguments.
+ *
+ * Features:
+ * - LRU eviction when cache exceeds MAX_CACHE_SIZE entries
+ * - Periodic cleanup of expired entries to prevent memory leaks
+ *
+ * @param key - The key to cache on, all accesses by this key will return the cached value.
+ * @param func - The function whose result will be cached.
+ * @param ttlMs - The time-to-live in milliseconds for cached data.
+ * @returns A memoized version of the provided function that returns the cached result if available and within TTL.
+ * @group Implementation
+ * @category Utils
+ */
+export function memoize(func, key, ttlMs) {
+    // Validate key format on first call to catch misuse early
+    validateCacheKey(key);
+    return (...args) => {
+        const now = Date.now();
+        // Check if the cached result exists and is within TTL
+        if (cache.has(key)) {
+            const entry = cache.get(key);
+            if (ttlMs === undefined || now - entry.timestamp <= ttlMs) {
+                // Update last access time for LRU
+                entry.lastAccess = now;
+                return entry.value;
+            }
+            // Entry expired, remove it
+            cache.delete(key);
+        }
+        // If not cached or TTL expired, compute the result
+        const result = func(...args);
+        // Evict old entries if needed before adding new one
+        evictIfNeeded();
+        // Cache the result with a timestamp
+        cache.set(key, { value: result, timestamp: now, lastAccess: now, ttlMs });
+        // Ensure cleanup is running
+        ensureCleanupInterval();
+        return result;
+    };
+}
+/**
+ * Clears all entries from the memoization cache.
+ * Useful for testing or when you need to force fresh data.
+ * @group Implementation
+ * @category Utils
+ */
+export function clearMemoizeCache() {
+    cache.clear();
+}
+/**
+ * Returns the current size of the memoization cache.
+ * Useful for monitoring and debugging.
+ * @group Implementation
+ * @category Utils
+ */
+export function getMemoizeCacheSize() {
+    return cache.size;
+}
+//# sourceMappingURL=memoize.js.map

package/dist/utils/memoize.js.map

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

package/dist/utils/normalizeBundle.d.ts

@@ -0,0 +1,27 @@
+import { Deserializer, Serializable } from "../bcs/index.js";
+/**
+ * @group Implementation
+ * @category Utils
+ */
+export type DeserializableClass<T extends Serializable> = {
+    /**
+     * Deserializes a serialized object using the provided deserializer.
+     * This function allows you to reconstruct an object from its serialized form.
+     *
+     * @param deserializer - An instance of the Deserializer used to read the serialized data.
+     * @group Implementation
+     * @category Utils
+     */
+    deserialize(deserializer: Deserializer): T;
+};
+/**
+ * Normalizes an instance of a class by deserializing it from its byte representation.
+ * This function allows the `instanceof` operator to work correctly when the input objects originate from a different bundle.
+ *
+ * @param cls - The class of the object to normalize.
+ * @param value - The instance to normalize.
+ * @group Implementation
+ * @category Utils
+ */
+export declare function normalizeBundle<T extends Serializable>(cls: DeserializableClass<T>, value: T): T;
+//# sourceMappingURL=normalizeBundle.d.ts.map

package/dist/utils/normalizeBundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeBundle.d.ts","sourceRoot":"","sources":["../../src/utils/normalizeBundle.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7D;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,YAAY,IAAI;IACxD;;;;;;;OAOG;IACH,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,YAAY,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAI5F"}

package/dist/utils/normalizeBundle.js

@@ -0,0 +1,18 @@
+// Copyright © Aptos Foundation
+// SPDX-License-Identifier: Apache-2.0
+import { Deserializer } from "../bcs/index.js";
+/**
+ * Normalizes an instance of a class by deserializing it from its byte representation.
+ * This function allows the `instanceof` operator to work correctly when the input objects originate from a different bundle.
+ *
+ * @param cls - The class of the object to normalize.
+ * @param value - The instance to normalize.
+ * @group Implementation
+ * @category Utils
+ */
+export function normalizeBundle(cls, value) {
+    const serializedBytes = value.bcsToBytes();
+    const deserializer = new Deserializer(serializedBytes);
+    return cls.deserialize(deserializer);
+}
+//# sourceMappingURL=normalizeBundle.js.map