zerc20-client-sdk 0.1.13 → 0.1.14

package/dist/registry/__tests__/parsing.test.js

@@ -0,0 +1,188 @@
+import { describe, expect, test } from "vitest";
+import { toHexAddress, parseBigInt, normalizeRpcUrls, expectRecord, getStringField, getOptionalStringField, getValueField, getOptionalBooleanField, getOptionalNumberField, } from "../parsing.js";
+describe("toHexAddress", () => {
+    test("normalizes address", () => {
+        expect(toHexAddress("0x1234")).toBe("0x1234");
+    });
+    test("handles address without 0x prefix", () => {
+        const result = toHexAddress("1234");
+        expect(result).toMatch(/^0x/);
+    });
+});
+describe("parseBigInt", () => {
+    test("parses string number", () => {
+        expect(parseBigInt("123", "test")).toBe(123n);
+    });
+    test("parses number", () => {
+        expect(parseBigInt(123, "test")).toBe(123n);
+    });
+    test("parses bigint", () => {
+        expect(parseBigInt(123n, "test")).toBe(123n);
+    });
+    test("throws for invalid value", () => {
+        expect(() => parseBigInt("invalid", "test")).toThrow("test must be a bigint-compatible value");
+    });
+});
+describe("normalizeRpcUrls", () => {
+    test("normalizes valid urls", () => {
+        const urls = ["https://rpc1.example.com", "  https://rpc2.example.com  "];
+        expect(normalizeRpcUrls(urls, "test")).toEqual([
+            "https://rpc1.example.com",
+            "https://rpc2.example.com",
+        ]);
+    });
+    test("throws for non-array", () => {
+        expect(() => normalizeRpcUrls("not an array", "test")).toThrow("test must configure at least one rpc url");
+    });
+    test("throws for empty array", () => {
+        expect(() => normalizeRpcUrls([], "test")).toThrow("test must configure at least one rpc url");
+    });
+    test("throws for invalid url in array", () => {
+        expect(() => normalizeRpcUrls(["valid", 123], "test")).toThrow("test contains invalid rpc url");
+    });
+    test("throws for empty string url", () => {
+        expect(() => normalizeRpcUrls(["  "], "test")).toThrow("test contains invalid rpc url");
+    });
+});
+describe("expectRecord", () => {
+    test("returns object as record", () => {
+        const obj = { key: "value" };
+        expect(expectRecord(obj, "test")).toBe(obj);
+    });
+    test("throws for null", () => {
+        expect(() => expectRecord(null, "test")).toThrow("test must be an object");
+    });
+    test("throws for undefined", () => {
+        expect(() => expectRecord(undefined, "test")).toThrow("test must be an object");
+    });
+    test("throws for primitive", () => {
+        expect(() => expectRecord("string", "test")).toThrow("test must be an object");
+    });
+});
+describe("getStringField", () => {
+    test("gets string from first matching key", () => {
+        const source = { key1: "value1" };
+        expect(getStringField(source, ["key1", "key2"], "test")).toBe("value1");
+    });
+    test("gets string from second matching key", () => {
+        const source = { key2: "value2" };
+        expect(getStringField(source, ["key1", "key2"], "test")).toBe("value2");
+    });
+    test("trims whitespace", () => {
+        const source = { key: "  value  " };
+        expect(getStringField(source, ["key"], "test")).toBe("value");
+    });
+    test("throws for missing key", () => {
+        const source = { other: "value" };
+        expect(() => getStringField(source, ["key"], "test")).toThrow("test must be a string");
+    });
+    test("throws for empty string", () => {
+        const source = { key: "   " };
+        expect(() => getStringField(source, ["key"], "test")).toThrow("test must be a non-empty string");
+    });
+    test("throws for non-string", () => {
+        const source = { key: 123 };
+        expect(() => getStringField(source, ["key"], "test")).toThrow("test must be a string");
+    });
+});
+describe("getOptionalStringField", () => {
+    test("gets string when present", () => {
+        const source = { key: "value" };
+        expect(getOptionalStringField(source, ["key"], "test")).toBe("value");
+    });
+    test("returns undefined when key missing", () => {
+        const source = { other: "value" };
+        expect(getOptionalStringField(source, ["key"], "test")).toBeUndefined();
+    });
+    test("returns undefined for null value", () => {
+        const source = { key: null };
+        expect(getOptionalStringField(source, ["key"], "test")).toBeUndefined();
+    });
+    test("returns undefined for undefined value", () => {
+        const source = { key: undefined };
+        expect(getOptionalStringField(source, ["key"], "test")).toBeUndefined();
+    });
+    test("trims whitespace", () => {
+        const source = { key: "  value  " };
+        expect(getOptionalStringField(source, ["key"], "test")).toBe("value");
+    });
+    test("throws for non-string when present", () => {
+        const source = { key: 123 };
+        expect(() => getOptionalStringField(source, ["key"], "test")).toThrow("test must be a string when provided");
+    });
+    test("throws for empty string when present", () => {
+        const source = { key: "   " };
+        expect(() => getOptionalStringField(source, ["key"], "test")).toThrow("test must be a non-empty string when provided");
+    });
+});
+describe("getValueField", () => {
+    test("gets value from first matching key", () => {
+        const source = { key1: "value1" };
+        expect(getValueField(source, ["key1", "key2"], "test")).toBe("value1");
+    });
+    test("gets value from second matching key", () => {
+        const source = { key2: "value2" };
+        expect(getValueField(source, ["key1", "key2"], "test")).toBe("value2");
+    });
+    test("throws for missing key", () => {
+        const source = { other: "value" };
+        expect(() => getValueField(source, ["key"], "test")).toThrow("test is required");
+    });
+    test("throws for null value", () => {
+        const source = { key: null };
+        expect(() => getValueField(source, ["key"], "test")).toThrow("test is required");
+    });
+    test("throws for undefined value", () => {
+        const source = { key: undefined };
+        expect(() => getValueField(source, ["key"], "test")).toThrow("test is required");
+    });
+});
+describe("getOptionalBooleanField", () => {
+    test("gets true when present", () => {
+        const source = { key: true };
+        expect(getOptionalBooleanField(source, ["key"], "test")).toBe(true);
+    });
+    test("gets false when present", () => {
+        const source = { key: false };
+        expect(getOptionalBooleanField(source, ["key"], "test")).toBe(false);
+    });
+    test("returns undefined when key missing", () => {
+        const source = { other: true };
+        expect(getOptionalBooleanField(source, ["key"], "test")).toBeUndefined();
+    });
+    test("throws for non-boolean", () => {
+        const source = { key: "true" };
+        expect(() => getOptionalBooleanField(source, ["key"], "test")).toThrow("test must be a boolean");
+    });
+});
+describe("getOptionalNumberField", () => {
+    test("gets number when present", () => {
+        const source = { key: 42 };
+        expect(getOptionalNumberField(source, ["key"], "test")).toBe(42);
+    });
+    test("parses string number", () => {
+        const source = { key: "42" };
+        expect(getOptionalNumberField(source, ["key"], "test")).toBe(42);
+    });
+    test("returns undefined when key missing", () => {
+        const source = { other: 42 };
+        expect(getOptionalNumberField(source, ["key"], "test")).toBeUndefined();
+    });
+    test("returns undefined for null value", () => {
+        const source = { key: null };
+        expect(getOptionalNumberField(source, ["key"], "test")).toBeUndefined();
+    });
+    test("returns undefined for undefined value", () => {
+        const source = { key: undefined };
+        expect(getOptionalNumberField(source, ["key"], "test")).toBeUndefined();
+    });
+    test("throws for NaN", () => {
+        const source = { key: "not a number" };
+        expect(() => getOptionalNumberField(source, ["key"], "test")).toThrow("test must be a number when provided");
+    });
+    test("throws for Infinity", () => {
+        const source = { key: Infinity };
+        expect(() => getOptionalNumberField(source, ["key"], "test")).toThrow("test must be a number when provided");
+    });
+});
+//# sourceMappingURL=parsing.test.js.map

package/dist/registry/__tests__/parsing.test.js.map

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

package/dist/registry/helpers.d.ts

@@ -0,0 +1,14 @@
+import { type PublicClient } from "viem";
+import type { TokenEntry } from "./types.js";
+/**
+ * Finds a token entry by chain ID.
+ * @throws Error if no token is found or multiple tokens match.
+ */
+export declare function findTokenByChain(tokens: readonly TokenEntry[], chainId: bigint): TokenEntry;
+/**
+ * Creates a viem PublicClient for the given token entry.
+ * Uses the first RPC URL from the token's rpcUrls array.
+ * @throws Error if the token has no RPC URLs configured.
+ */
+export declare function createProviderForToken(entry: TokenEntry): PublicClient;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/registry/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/registry/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAEnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAS3F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAOtE"}

package/dist/registry/helpers.js

@@ -0,0 +1,29 @@
+import { createPublicClient, http } from "viem";
+/**
+ * Finds a token entry by chain ID.
+ * @throws Error if no token is found or multiple tokens match.
+ */
+export function findTokenByChain(tokens, chainId) {
+    const matches = tokens.filter((token) => token.chainId === chainId);
+    if (matches.length === 0) {
+        throw new Error(`no tokens configured for chain id ${chainId}`);
+    }
+    if (matches.length > 1) {
+        throw new Error(`multiple tokens configured for chain id ${chainId}; disambiguate by label`);
+    }
+    return matches[0];
+}
+/**
+ * Creates a viem PublicClient for the given token entry.
+ * Uses the first RPC URL from the token's rpcUrls array.
+ * @throws Error if the token has no RPC URLs configured.
+ */
+export function createProviderForToken(entry) {
+    if (entry.rpcUrls.length === 0) {
+        throw new Error(`token '${entry.label}' is missing rpc urls`);
+    }
+    return createPublicClient({
+        transport: http(entry.rpcUrls[0]),
+    });
+}
+//# sourceMappingURL=helpers.js.map

package/dist/registry/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/registry/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAqB,MAAM,MAAM,CAAC;AAInE;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA6B,EAAE,OAAe;IAC7E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,2CAA2C,OAAO,yBAAyB,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAiB;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,KAAK,uBAAuB,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,kBAAkB,CAAC;QACxB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;KAClC,CAAC,CAAC;AACL,CAAC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Token registry module for zERC20.
+ *
+ * This module provides:
+ * - Type definitions for token and hub entries
+ * - Functions for loading and normalizing tokens from compressed data
+ * - Utilities for finding tokens and creating providers
+ */
+export type { TokenEntry, HubEntry, TokensFile, NormalizedTokens, LoadTokensOptions, } from "./types.js";
+export { normalizeTokensFile, normalizeTokens } from "./normalize.js";
+export { TokensCacheManager, clearTokensCache, resetTokensCache, getDefaultTokensCacheManager, loadTokensFromCompressed, loadTokens, } from "./loader.js";
+export { findTokenByChain, createProviderForToken } from "./helpers.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGtE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,wBAAwB,EACxB,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,15 @@
+/**
+ * Token registry module for zERC20.
+ *
+ * This module provides:
+ * - Type definitions for token and hub entries
+ * - Functions for loading and normalizing tokens from compressed data
+ * - Utilities for finding tokens and creating providers
+ */
+// Normalization
+export { normalizeTokensFile, normalizeTokens } from "./normalize.js";
+// Loading
+export { TokensCacheManager, clearTokensCache, resetTokensCache, getDefaultTokensCacheManager, loadTokensFromCompressed, loadTokens, } from "./loader.js";
+// Helpers
+export { findTokenByChain, createProviderForToken } from "./helpers.js";
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,gBAAgB;AAChB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE,UAAU;AACV,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,4BAA4B,EAC5B,wBAAwB,EACxB,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/registry/loader.d.ts

@@ -0,0 +1,57 @@
+import type { NormalizedTokens, LoadTokensOptions } from "./types.js";
+/**
+ * Manager for caching loaded token data.
+ */
+export declare class TokensCacheManager {
+    private readonly cache;
+    /**
+     * Loads tokens from compressed data, using cache if available.
+     * If loading fails, the failed promise is removed from the cache to allow retry.
+     * @remarks
+     * The default `cacheKey` is based on the full compressed string; consider providing a shorter stable key.
+     */
+    load(compressed: string, options?: LoadTokensOptions): Promise<NormalizedTokens>;
+    /**
+     * Clears a specific entry or all entries from the cache.
+     */
+    clear(key?: string): void;
+    /**
+     * Resets the cache to its initial empty state.
+     * Alias for clear() - useful for testing.
+     */
+    reset(): void;
+    /**
+     * Returns the number of cached entries.
+     */
+    size(): number;
+    /**
+     * Returns true if the cache contains an entry for the given key.
+     */
+    has(key: string): boolean;
+}
+/**
+ * Clears the tokens cache.
+ * @param cache Optional custom cache map. Uses global cache if not provided.
+ * @param key Optional key to clear. Clears entire cache if not provided.
+ */
+export declare function clearTokensCache(cache?: Map<string, Promise<NormalizedTokens>>, key?: string): void;
+/**
+ * Resets the default tokens cache to its initial state.
+ * Useful for testing.
+ */
+export declare function resetTokensCache(): void;
+/**
+ * Returns the default tokens cache manager.
+ */
+export declare function getDefaultTokensCacheManager(): TokensCacheManager;
+/**
+ * Loads tokens from a compressed (gzipped + base64) string.
+ * Results are cached based on the cacheKey option.
+ * If loading fails, the failed promise is removed from the cache to allow retry.
+ */
+export declare function loadTokensFromCompressed(compressed: string, options?: LoadTokensOptions): Promise<NormalizedTokens>;
+/**
+ * Alias for loadTokensFromCompressed.
+ */
+export declare function loadTokens(compressed: string, options?: LoadTokensOptions): Promise<NormalizedTokens>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/registry/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/registry/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAc,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAsElF;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgD;IAEtE;;;;;OAKG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmBpF;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAQzB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAG1B;AAQD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAC9C,GAAG,CAAC,EAAE,MAAM,GACX,IAAI,CAWN;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,kBAAkB,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAwB3B;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAE3B"}

package/dist/registry/loader.js

@@ -0,0 +1,188 @@
+import { decode as decodeBase64 } from "base64-arraybuffer";
+import { ungzip } from "pako";
+import { asNormalizedTokens } from "./normalize.js";
+/**
+ * Loader for "compressed tokens" payloads.
+ * @remarks
+ * The expected format for `compressed` is:
+ * - Base64-encoded gzip bytes
+ * - The gzip payload is UTF-8 JSON representing a {@link TokensFile}
+ *
+ * This module also provides a small in-memory cache so repeated loads of the same payload are cheap.
+ */
+// ============================================================================
+// Internal Utilities
+// ============================================================================
+/**
+ * Decodes a base64 string to bytes.
+ * @throws Error if the payload is empty or not valid base64.
+ */
+function base64ToBytes(value) {
+    const normalized = value.replace(/\s+/g, "");
+    if (!normalized) {
+        throw new Error("Compressed tokens payload is empty");
+    }
+    try {
+        const buffer = decodeBase64(normalized);
+        return new Uint8Array(buffer);
+    }
+    catch {
+        throw new Error("Compressed tokens payload is not valid base64");
+    }
+}
+/**
+ * Decodes decompressed bytes to a TokensFile.
+ * @throws Error if the bytes are not valid JSON.
+ */
+function decodeTokensPayload(bytes, decoder) {
+    const textDecoder = decoder ?? new TextDecoder();
+    const text = textDecoder.decode(bytes);
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error("Decompressed tokens blob is not valid JSON");
+    }
+}
+/**
+ * Parses and normalizes compressed tokens data.
+ */
+function parseCompressedTokens(compressed, options = {}) {
+    const gzippedBytes = base64ToBytes(compressed);
+    const decompress = options.decompress ?? ((data) => ungzip(data));
+    const decompressed = decompress(gzippedBytes);
+    const normalizedBytes = decompressed instanceof Uint8Array
+        ? decompressed
+        : new Uint8Array(decompressed);
+    const parsed = decodeTokensPayload(normalizedBytes, options.decoder);
+    return asNormalizedTokens(parsed);
+}
+// ============================================================================
+// TokensCacheManager Class
+// ============================================================================
+/**
+ * Manager for caching loaded token data.
+ */
+export class TokensCacheManager {
+    cache = new Map();
+    /**
+     * Loads tokens from compressed data, using cache if available.
+     * If loading fails, the failed promise is removed from the cache to allow retry.
+     * @remarks
+     * The default `cacheKey` is based on the full compressed string; consider providing a shorter stable key.
+     */
+    load(compressed, options = {}) {
+        const cacheKey = options.cacheKey ?? `compressed:${compressed}`;
+        if (!this.cache.has(cacheKey)) {
+            const promise = Promise.resolve()
+                .then(() => parseCompressedTokens(compressed, {
+                decompress: options.decompress,
+                decoder: options.decoder,
+            }))
+                .catch((error) => {
+                this.cache.delete(cacheKey);
+                throw error;
+            });
+            this.cache.set(cacheKey, promise);
+        }
+        return this.cache.get(cacheKey);
+    }
+    /**
+     * Clears a specific entry or all entries from the cache.
+     */
+    clear(key) {
+        if (key) {
+            this.cache.delete(key);
+            return;
+        }
+        this.cache.clear();
+    }
+    /**
+     * Resets the cache to its initial empty state.
+     * Alias for clear() - useful for testing.
+     */
+    reset() {
+        this.cache.clear();
+    }
+    /**
+     * Returns the number of cached entries.
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Returns true if the cache contains an entry for the given key.
+     */
+    has(key) {
+        return this.cache.has(key);
+    }
+}
+// ============================================================================
+// Default Singleton & Backward-Compatible Functions
+// ============================================================================
+const defaultManager = new TokensCacheManager();
+/**
+ * Clears the tokens cache.
+ * @param cache Optional custom cache map. Uses global cache if not provided.
+ * @param key Optional key to clear. Clears entire cache if not provided.
+ */
+export function clearTokensCache(cache, key) {
+    // If custom cache is provided, use direct Map operations for backward compatibility
+    if (cache) {
+        if (key) {
+            cache.delete(key);
+        }
+        else {
+            cache.clear();
+        }
+        return;
+    }
+    defaultManager.clear(key);
+}
+/**
+ * Resets the default tokens cache to its initial state.
+ * Useful for testing.
+ */
+export function resetTokensCache() {
+    defaultManager.reset();
+}
+/**
+ * Returns the default tokens cache manager.
+ */
+export function getDefaultTokensCacheManager() {
+    return defaultManager;
+}
+/**
+ * Loads tokens from a compressed (gzipped + base64) string.
+ * Results are cached based on the cacheKey option.
+ * If loading fails, the failed promise is removed from the cache to allow retry.
+ */
+export function loadTokensFromCompressed(compressed, options = {}) {
+    // If custom cache is provided, use direct Map operations for backward compatibility
+    if (options.cache) {
+        const cache = options.cache;
+        const cacheKey = options.cacheKey ?? `compressed:${compressed}`;
+        if (!cache.has(cacheKey)) {
+            const promise = Promise.resolve()
+                .then(() => parseCompressedTokens(compressed, {
+                decompress: options.decompress,
+                decoder: options.decoder,
+            }))
+                .catch((error) => {
+                cache.delete(cacheKey);
+                throw error;
+            });
+            cache.set(cacheKey, promise);
+        }
+        return cache.get(cacheKey);
+    }
+    // Use default manager
+    return defaultManager.load(compressed, options);
+}
+/**
+ * Alias for loadTokensFromCompressed.
+ */
+export function loadTokens(compressed, options = {}) {
+    return loadTokensFromCompressed(compressed, options);
+}
+//# sourceMappingURL=loader.js.map

package/dist/registry/loader.js.map

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

package/dist/registry/normalize.d.ts

@@ -0,0 +1,29 @@
+import type { TokensFile, NormalizedTokens } from "./types.js";
+/**
+ * Normalizes a tokens file by validating and transforming all entries.
+ * Handles both camelCase and snake_case field names.
+ * @throws Error if the file is invalid or missing required fields.
+ *
+ * @remarks
+ * This function is intended for untrusted external input (e.g. JSON loaded from disk/network).
+ * It performs:
+ * - Address normalization (`0x`-prefixed hex) for all address fields
+ * - Bigint parsing for `chainId` and `deployedBlockNumber`
+ * - RPC URL normalization and validation
+ */
+export declare function normalizeTokensFile(file: TokensFile): TokensFile;
+/**
+ * Creates a shallow clone of a tokens file.
+ * @remarks Used to ensure normalization does not mutate caller-owned objects.
+ */
+export declare function cloneTokensFile(file: TokensFile): TokensFile;
+/**
+ * Converts a TokensFile to NormalizedTokens, preserving the raw data.
+ * @remarks The returned `raw` is the original input reference.
+ */
+export declare function asNormalizedTokens(file: TokensFile): NormalizedTokens;
+/**
+ * Normalizes a tokens file and returns it with the raw data preserved.
+ */
+export declare function normalizeTokens(file: TokensFile): NormalizedTokens;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/registry/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/registry/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAc/D;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CA8EhE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAM5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAOrE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,CAElE"}