zerc20-client-sdk 0.1.13 → 0.1.14

package/dist/operations/receive/__tests__/helpers.test.js

@@ -0,0 +1,80 @@
+import { describe, expect, test } from "vitest";
+import { isViemVerifierContract, readTotalTeleported } from "../helpers.js";
+describe("isViemVerifierContract", () => {
+    test("returns true for viem-style contract with read.totalTeleported", () => {
+        const viemContract = {
+            read: {
+                totalTeleported: async () => 100n,
+            },
+        };
+        expect(isViemVerifierContract(viemContract)).toBe(true);
+    });
+    test("returns false for legacy contract without read property", () => {
+        const legacyContract = {
+            totalTeleported: async () => 100n,
+        };
+        expect(isViemVerifierContract(legacyContract)).toBe(false);
+    });
+    test("returns false for object with read but no totalTeleported", () => {
+        const invalidContract = {
+            read: {
+                otherMethod: async () => 100n,
+            },
+        };
+        expect(isViemVerifierContract(invalidContract)).toBe(false);
+    });
+    test("returns false for empty object", () => {
+        expect(isViemVerifierContract({})).toBe(false);
+    });
+    test("returns false for null read property", () => {
+        const contract = { read: null };
+        expect(isViemVerifierContract(contract)).toBe(false);
+    });
+});
+describe("readTotalTeleported", () => {
+    test("reads from viem-style contract", async () => {
+        const viemContract = {
+            read: {
+                totalTeleported: async (args) => {
+                    expect(args).toEqual(["0x1234"]);
+                    return 500n;
+                },
+            },
+        };
+        const result = await readTotalTeleported(viemContract, "0x1234");
+        expect(result).toBe(500n);
+    });
+    test("reads from legacy contract", async () => {
+        const legacyContract = {
+            totalTeleported: async (recipientFr) => {
+                expect(recipientFr).toBe("0xabcd");
+                return 1000n;
+            },
+        };
+        const result = await readTotalTeleported(legacyContract, "0xabcd");
+        expect(result).toBe(1000n);
+    });
+    test("converts number return value to bigint", async () => {
+        const contract = {
+            read: {
+                totalTeleported: async () => 999,
+            },
+        };
+        const result = await readTotalTeleported(contract, "0x1234");
+        expect(result).toBe(999n);
+    });
+    test("converts string return value to bigint", async () => {
+        const contract = {
+            totalTeleported: async () => "12345",
+        };
+        const result = await readTotalTeleported(contract, "0x1234");
+        expect(result).toBe(12345n);
+    });
+    test("throws for contract without totalTeleported", async () => {
+        const invalidContract = {
+            otherMethod: async () => 100n,
+        };
+        await expect(readTotalTeleported(invalidContract, "0x1234")).rejects.toThrow("verifier contract must expose totalTeleported");
+    });
+});
+//# sourceMappingURL=helpers.test.js.map

package/dist/operations/receive/__tests__/helpers.test.js.map

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

package/dist/operations/receive/__tests__/redeemContext.test.d.ts

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

package/dist/operations/receive/__tests__/redeemContext.test.d.ts.map

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

package/dist/operations/receive/__tests__/redeemContext.test.js

@@ -0,0 +1,230 @@
+import { beforeEach, describe, expect, test, vi } from "vitest";
+import { collectRedeemContext } from "../redeemContext.js";
+// Mock dependencies
+vi.mock("../../../registry/tokens.js", () => ({
+    findTokenByChain: vi.fn(),
+}));
+vi.mock("../../../wasm/index.js", () => ({
+    fetchAggregationTreeState: vi.fn(),
+    fetchTransferEvents: vi.fn(),
+    separateEventsByEligibility: vi.fn(),
+    fetchLocalTeleportMerkleProofs: vi.fn(),
+    generateGlobalTeleportMerkleProofs: vi.fn(),
+}));
+vi.mock("../../teleport.js", () => ({
+    getTreeIndexForChain: vi.fn(),
+}));
+vi.mock("../helpers.js", () => ({
+    readTotalTeleported: vi.fn(),
+}));
+import { findTokenByChain } from "../../../registry/tokens.js";
+import { fetchAggregationTreeState, fetchTransferEvents, separateEventsByEligibility, fetchLocalTeleportMerkleProofs, generateGlobalTeleportMerkleProofs, } from "../../../wasm/index.js";
+import { getTreeIndexForChain } from "../../teleport.js";
+import { readTotalTeleported } from "../helpers.js";
+const mockFindTokenByChain = vi.mocked(findTokenByChain);
+const mockFetchAggregationTreeState = vi.mocked(fetchAggregationTreeState);
+const mockFetchTransferEvents = vi.mocked(fetchTransferEvents);
+const mockSeparateEventsByEligibility = vi.mocked(separateEventsByEligibility);
+const mockFetchLocalTeleportMerkleProofs = vi.mocked(fetchLocalTeleportMerkleProofs);
+const mockGenerateGlobalTeleportMerkleProofs = vi.mocked(generateGlobalTeleportMerkleProofs);
+const mockGetTreeIndexForChain = vi.mocked(getTreeIndexForChain);
+const mockReadTotalTeleported = vi.mocked(readTotalTeleported);
+describe("collectRedeemContext", () => {
+    const mockToken1 = {
+        chainId: 1n,
+        tokenAddress: "0xToken1",
+        rpcUrls: ["https://rpc1.example.com"],
+    };
+    const mockToken2 = {
+        chainId: 2n,
+        tokenAddress: "0xToken2",
+        rpcUrls: ["https://rpc2.example.com"],
+    };
+    const mockHub = {
+        hubAddress: "0xHub",
+        chains: [],
+    };
+    const mockBurn = {
+        burnAddress: "0xBurnAddress",
+        generalRecipient: {
+            chainId: 1n,
+            fr: "0xRecipientFr",
+        },
+    };
+    const mockAggregationState = {
+        root: "0xRoot",
+        trees: [],
+    };
+    const mockVerifierContract = {
+        read: {
+            totalTeleported: vi.fn(),
+        },
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockFindTokenByChain.mockReturnValue(mockToken1);
+        mockFetchAggregationTreeState.mockResolvedValue(mockAggregationState);
+        mockFetchTransferEvents.mockResolvedValue([]);
+        mockSeparateEventsByEligibility.mockResolvedValue([]);
+        mockReadTotalTeleported.mockResolvedValue(0n);
+    });
+    test("collects redeem context with no events", async () => {
+        mockSeparateEventsByEligibility.mockResolvedValue([
+            { chainId: 1n, events: { eligible: [], ineligible: [] } },
+        ]);
+        const params = {
+            burn: mockBurn,
+            tokens: [mockToken1],
+            hub: mockHub,
+            verifierContract: mockVerifierContract,
+            indexerUrl: "https://indexer.example.com",
+        };
+        const result = await collectRedeemContext(params);
+        expect(result.token).toBe(mockToken1);
+        expect(result.aggregationState).toBe(mockAggregationState);
+        expect(result.totalEligibleValue).toBe(0n);
+        expect(result.totalPendingValue).toBe(0n);
+        expect(result.totalIndexedValue).toBe(0n);
+        expect(result.totalTeleported).toBe(0n);
+        expect(result.chains).toHaveLength(1);
+    });
+    test("collects redeem context with eligible events", async () => {
+        const eligibleEvent = {
+            value: 100n,
+            eventIndex: 1n,
+            from: "0xfrom",
+            to: "0xto",
+            ethBlockNumber: 1n,
+        };
+        mockSeparateEventsByEligibility.mockResolvedValue([
+            {
+                chainId: 1n,
+                events: {
+                    eligible: [eligibleEvent],
+                    ineligible: [],
+                },
+            },
+        ]);
+        const mockLocalProof = {
+            event: eligibleEvent,
+        };
+        const mockGlobalProof = {
+            event: eligibleEvent,
+        };
+        mockGetTreeIndexForChain.mockReturnValue(0n);
+        mockFetchLocalTeleportMerkleProofs.mockResolvedValue([mockLocalProof]);
+        mockGenerateGlobalTeleportMerkleProofs.mockResolvedValue([mockGlobalProof]);
+        mockReadTotalTeleported.mockResolvedValue(50n);
+        const params = {
+            burn: mockBurn,
+            tokens: [mockToken1],
+            hub: mockHub,
+            verifierContract: mockVerifierContract,
+            indexerUrl: "https://indexer.example.com",
+        };
+        const result = await collectRedeemContext(params);
+        expect(result.totalEligibleValue).toBe(100n);
+        expect(result.totalPendingValue).toBe(0n);
+        expect(result.totalIndexedValue).toBe(100n);
+        expect(result.totalTeleported).toBe(50n);
+        expect(result.eligibleProofs).toHaveLength(1);
+        expect(result.globalProofs).toHaveLength(1);
+    });
+    test("collects redeem context with ineligible events", async () => {
+        const ineligibleEvent = {
+            value: 200n,
+            eventIndex: 2n,
+            from: "0xfrom",
+            to: "0xto",
+            ethBlockNumber: 1n,
+        };
+        mockSeparateEventsByEligibility.mockResolvedValue([
+            {
+                chainId: 1n,
+                events: {
+                    eligible: [],
+                    ineligible: [ineligibleEvent],
+                },
+            },
+        ]);
+        const params = {
+            burn: mockBurn,
+            tokens: [mockToken1],
+            hub: mockHub,
+            verifierContract: mockVerifierContract,
+            indexerUrl: "https://indexer.example.com",
+        };
+        const result = await collectRedeemContext(params);
+        expect(result.totalEligibleValue).toBe(0n);
+        expect(result.totalPendingValue).toBe(200n);
+        expect(result.totalIndexedValue).toBe(200n);
+    });
+    test("collects redeem context across multiple chains", async () => {
+        const event1 = {
+            value: 100n,
+            eventIndex: 1n,
+            from: "0xfrom",
+            to: "0xto",
+            ethBlockNumber: 1n,
+        };
+        const event2 = {
+            value: 150n,
+            eventIndex: 2n,
+            from: "0xfrom",
+            to: "0xto",
+            ethBlockNumber: 1n,
+        };
+        mockSeparateEventsByEligibility.mockResolvedValue([
+            { chainId: 1n, events: { eligible: [event1], ineligible: [] } },
+            { chainId: 2n, events: { eligible: [event2], ineligible: [] } },
+        ]);
+        mockGetTreeIndexForChain.mockReturnValue(0n);
+        mockFetchLocalTeleportMerkleProofs.mockResolvedValue([]);
+        mockGenerateGlobalTeleportMerkleProofs.mockResolvedValue([]);
+        const params = {
+            burn: mockBurn,
+            tokens: [mockToken1, mockToken2],
+            hub: mockHub,
+            verifierContract: mockVerifierContract,
+            indexerUrl: "https://indexer.example.com",
+        };
+        const result = await collectRedeemContext(params);
+        expect(result.totalEligibleValue).toBe(250n);
+        expect(result.chains).toHaveLength(2);
+        expect(result.chains[0].chainId).toBe(1n);
+        expect(result.chains[0].totalEligibleValue).toBe(100n);
+        expect(result.chains[1].chainId).toBe(2n);
+        expect(result.chains[1].totalEligibleValue).toBe(150n);
+    });
+    test("uses custom indexerFetchLimit", async () => {
+        mockSeparateEventsByEligibility.mockResolvedValue([]);
+        const params = {
+            burn: mockBurn,
+            tokens: [mockToken1],
+            hub: mockHub,
+            verifierContract: mockVerifierContract,
+            indexerUrl: "https://indexer.example.com",
+            indexerFetchLimit: 500,
+        };
+        await collectRedeemContext(params);
+        expect(mockFetchTransferEvents).toHaveBeenCalledWith(expect.objectContaining({
+            indexerFetchLimit: 500,
+        }));
+    });
+    test("passes eventBlockSpan to fetchAggregationTreeState", async () => {
+        mockSeparateEventsByEligibility.mockResolvedValue([]);
+        const params = {
+            burn: mockBurn,
+            tokens: [mockToken1],
+            hub: mockHub,
+            verifierContract: mockVerifierContract,
+            indexerUrl: "https://indexer.example.com",
+            eventBlockSpan: 1000n,
+        };
+        await collectRedeemContext(params);
+        expect(mockFetchAggregationTreeState).toHaveBeenCalledWith(expect.objectContaining({
+            eventBlockSpan: 1000n,
+        }));
+    });
+});
+//# sourceMappingURL=redeemContext.test.js.map

package/dist/operations/receive/__tests__/redeemContext.test.js.map

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

package/dist/operations/receive/announcementStatus.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Announcement status retrieval for receive operations.
+ */
+import type { AnnouncementStatus, AnnouncementStatusParams } from "./types.js";
+/**
+ * Retrieve a summary status of announcements for a burn recipient.
+ * @remarks
+ * Similar to `collectRedeemContext`, but focused on totals and per-chain event separation.
+ * Aggregation state can be cached via `cacheTtlMs`.
+ */
+export declare function getAnnouncementStatus(params: AnnouncementStatusParams): Promise<AnnouncementStatus>;
+//# sourceMappingURL=announcementStatus.d.ts.map

package/dist/operations/receive/announcementStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcementStatus.d.ts","sourceRoot":"","sources":["../../../src/operations/receive/announcementStatus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,KAAK,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE/E;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAoD7B"}

package/dist/operations/receive/announcementStatus.js

@@ -0,0 +1,56 @@
+/**
+ * Announcement status retrieval for receive operations.
+ */
+import { DEFAULT_INDEXER_FETCH_LIMIT } from "../../constants.js";
+import { findTokenByChain } from "../../registry/tokens.js";
+import { normalizeHex } from "../../utils/hex.js";
+import { fetchTransferEvents, separateEventsByEligibility } from "../../wasm/index.js";
+import { fetchAggregationTreeStateWithCache } from "./cache.js";
+import { readTotalTeleported } from "./helpers.js";
+/**
+ * Retrieve a summary status of announcements for a burn recipient.
+ * @remarks
+ * Similar to `collectRedeemContext`, but focused on totals and per-chain event separation.
+ * Aggregation state can be cached via `cacheTtlMs`.
+ */
+export async function getAnnouncementStatus(params) {
+    const primaryChainId = params.burn.generalRecipient.chainId;
+    const primaryToken = findTokenByChain(params.tokens, primaryChainId);
+    const aggregationState = await fetchAggregationTreeStateWithCache({
+        hub: params.hub,
+        token: primaryToken,
+        eventBlockSpan: params.eventBlockSpan,
+        cacheTtlMs: params.cacheTtlMs,
+    });
+    const chainEvents = await fetchTransferEvents({
+        indexerUrl: params.indexerUrl,
+        tokens: params.tokens,
+        burnAddresses: [params.burn.burnAddress],
+        indexerFetchLimit: params.indexerFetchLimit ?? DEFAULT_INDEXER_FETCH_LIMIT,
+    });
+    const separatedChains = await separateEventsByEligibility({
+        aggregationState,
+        events: chainEvents,
+    });
+    const combinedEvents = { eligible: [], ineligible: [] };
+    for (const entry of separatedChains) {
+        combinedEvents.eligible.push(...entry.events.eligible);
+        combinedEvents.ineligible.push(...entry.events.ineligible);
+    }
+    const totalEligibleValue = combinedEvents.eligible.reduce((acc, event) => acc + event.value, 0n);
+    const totalPendingValue = combinedEvents.ineligible.reduce((acc, event) => acc + event.value, 0n);
+    const totalIndexedValue = totalEligibleValue + totalPendingValue;
+    const recipientFr = normalizeHex(params.burn.generalRecipient.fr);
+    const totalTeleported = await readTotalTeleported(params.verifierContract, recipientFr);
+    return {
+        token: primaryToken,
+        aggregationState,
+        events: combinedEvents,
+        chains: separatedChains,
+        totalEligibleValue,
+        totalPendingValue,
+        totalIndexedValue,
+        totalTeleported,
+    };
+}
+//# sourceMappingURL=announcementStatus.js.map

package/dist/operations/receive/announcementStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"announcementStatus.js","sourceRoot":"","sources":["../../../src/operations/receive/announcementStatus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAEvF,OAAO,EAAE,kCAAkC,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAgC;IAEhC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;IAC5D,MAAM,YAAY,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAErE,MAAM,gBAAgB,GAAG,MAAM,kCAAkC,CAAC;QAChE,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,YAAY;QACnB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,MAAM,mBAAmB,CAAC;QAC5C,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,aAAa,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;QACxC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,2BAA2B;KAC3E,CAAC,CAAC;IAEH,MAAM,eAAe,GAAG,MAAM,2BAA2B,CAAC;QACxD,gBAAgB;QAChB,MAAM,EAAE,WAAW;KACpB,CAAC,CAAC;IAEH,MAAM,cAAc,GAA0B,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC/E,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvD,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,kBAAkB,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM,CACvD,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,EACjC,EAAE,CACH,CAAC;IACF,MAAM,iBAAiB,GAAG,cAAc,CAAC,UAAU,CAAC,MAAM,CACxD,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,EACjC,EAAE,CACH,CAAC;IACF,MAAM,iBAAiB,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;IAEjE,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAClE,MAAM,eAAe,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IAExF,OAAO;QACL,KAAK,EAAE,YAAY;QACnB,gBAAgB;QAChB,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,eAAe;QACvB,kBAAkB;QAClB,iBAAiB;QACjB,iBAAiB;QACjB,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/operations/receive/cache.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Aggregation state caching for receive operations.
+ */
+import type { HubEntry, TokenEntry } from "../../registry/tokens.js";
+import type { AggregationTreeState } from "../../types.js";
+export interface FetchAggregationStateParams {
+    /** Hub configuration used to fetch aggregation tree state. */
+    hub: HubEntry;
+    /** Token entry used to determine chainId and hub address. */
+    token: TokenEntry;
+    /** Optional block span used when fetching aggregation tree state (performance tuning). */
+    eventBlockSpan?: bigint | number;
+    /**
+     * Optional cache TTL (in milliseconds).
+     * @remarks When provided, cached entries are returned if not expired.
+     */
+    cacheTtlMs?: number;
+}
+/**
+ * Manager for caching aggregation tree states with TTL support.
+ */
+export declare class AggregationStateCacheManager {
+    private readonly cache;
+    /**
+     * Fetch aggregation tree state with caching.
+     * @remarks Uses TTL-based invalidation when `cacheTtlMs` is provided.
+     */
+    fetchWithCache(params: FetchAggregationStateParams): Promise<AggregationTreeState>;
+    /**
+     * Clear a specific entry or all entries from the cache.
+     */
+    clear(key?: string): void;
+    /**
+     * Reset the cache to its initial empty state.
+     * @remarks Alias for `clear()`; useful for testing.
+     */
+    reset(): void;
+    /**
+     * Return the number of cached entries.
+     */
+    size(): number;
+    /**
+     * Return true if the cache contains an entry for the given key.
+     */
+    has(key: string): boolean;
+    /**
+     * Return true if the cache contains an entry for the given hub and chain.
+     */
+    hasEntry(hubAddress: string, chainId: bigint): boolean;
+}
+/**
+ * Fetch aggregation tree state using the default cache manager.
+ * @remarks Uses TTL-based invalidation when `cacheTtlMs` is provided.
+ */
+export declare function fetchAggregationTreeStateWithCache(params: FetchAggregationStateParams): Promise<AggregationTreeState>;
+/**
+ * Clear the default aggregation state cache.
+ */
+export declare function clearAggregationStateCache(): void;
+/**
+ * Reset the default aggregation state cache to its initial state.
+ * @remarks Useful for testing.
+ */
+export declare function resetAggregationStateCache(): void;
+/**
+ * Get the default aggregation state cache manager.
+ */
+export declare function getDefaultAggregationStateCacheManager(): AggregationStateCacheManager;
+//# sourceMappingURL=cache.d.ts.map

package/dist/operations/receive/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/operations/receive/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAa3D,MAAM,WAAW,2BAA2B;IAC1C,8DAA8D;IAC9D,GAAG,EAAE,QAAQ,CAAC;IACd,6DAA6D;IAC7D,KAAK,EAAE,UAAU,CAAC;IAClB,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAcD;;GAEG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6C;IAEnE;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoBxF;;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;IAIzB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;CAGvD;AAQD;;;GAGG;AACH,wBAAsB,kCAAkC,CACtD,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAE/B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,sCAAsC,IAAI,4BAA4B,CAErF"}

package/dist/operations/receive/cache.js

@@ -0,0 +1,105 @@
+/**
+ * Aggregation state caching for receive operations.
+ */
+import { fetchAggregationTreeState } from "../../wasm/index.js";
+// ============================================================================
+// Internal Utilities
+// ============================================================================
+function getCacheKey(hubAddress, chainId) {
+    return `${hubAddress.toLowerCase()}-${chainId}`;
+}
+// ============================================================================
+// AggregationStateCacheManager Class
+// ============================================================================
+/**
+ * Manager for caching aggregation tree states with TTL support.
+ */
+export class AggregationStateCacheManager {
+    cache = new Map();
+    /**
+     * Fetch aggregation tree state with caching.
+     * @remarks Uses TTL-based invalidation when `cacheTtlMs` is provided.
+     */
+    async fetchWithCache(params) {
+        const cacheTtl = params.cacheTtlMs;
+        const cacheKey = getCacheKey(params.hub.hubAddress, params.token.chainId);
+        const cached = this.cache.get(cacheKey);
+        const now = Date.now();
+        if (cacheTtl != null && cached && now - cached.timestamp < cacheTtl) {
+            return cached.state;
+        }
+        const state = await fetchAggregationTreeState(params);
+        this.cache.set(cacheKey, {
+            state,
+            timestamp: now,
+            chainId: params.token.chainId,
+        });
+        return state;
+    }
+    /**
+     * Clear a specific entry or all entries from the cache.
+     */
+    clear(key) {
+        if (key) {
+            this.cache.delete(key);
+            return;
+        }
+        this.cache.clear();
+    }
+    /**
+     * Reset the cache to its initial empty state.
+     * @remarks Alias for `clear()`; useful for testing.
+     */
+    reset() {
+        this.cache.clear();
+    }
+    /**
+     * Return the number of cached entries.
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Return true if the cache contains an entry for the given key.
+     */
+    has(key) {
+        return this.cache.has(key);
+    }
+    /**
+     * Return true if the cache contains an entry for the given hub and chain.
+     */
+    hasEntry(hubAddress, chainId) {
+        return this.cache.has(getCacheKey(hubAddress, chainId));
+    }
+}
+// ============================================================================
+// Default Singleton & Backward-Compatible Functions
+// ============================================================================
+const defaultManager = new AggregationStateCacheManager();
+/**
+ * Fetch aggregation tree state using the default cache manager.
+ * @remarks Uses TTL-based invalidation when `cacheTtlMs` is provided.
+ */
+export async function fetchAggregationTreeStateWithCache(params) {
+    return defaultManager.fetchWithCache(params);
+}
+/**
+ * Clear the default aggregation state cache.
+ */
+export function clearAggregationStateCache() {
+    defaultManager.clear();
+}
+/**
+ * Reset the default aggregation state cache to its initial state.
+ * @remarks Useful for testing.
+ */
+export function resetAggregationStateCache() {
+    defaultManager.reset();
+}
+/**
+ * Get the default aggregation state cache manager.
+ */
+export function getDefaultAggregationStateCacheManager() {
+    return defaultManager;
+}
+//# sourceMappingURL=cache.js.map

package/dist/operations/receive/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/operations/receive/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AA0BhE,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,SAAS,WAAW,CAAC,UAAkB,EAAE,OAAe;IACtD,OAAO,GAAG,UAAU,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC;AAClD,CAAC;AAED,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,4BAA4B;IACtB,KAAK,GAAG,IAAI,GAAG,EAAkC,CAAC;IAEnE;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,MAAmC;QACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC;QACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,QAAQ,IAAI,IAAI,IAAI,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,CAAC;YACpE,OAAO,MAAM,CAAC,KAAK,CAAC;QACtB,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;YACvB,KAAK;YACL,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;SAC9B,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAY;QAChB,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,UAAkB,EAAE,OAAe;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,+EAA+E;AAC/E,oDAAoD;AACpD,+EAA+E;AAE/E,MAAM,cAAc,GAAG,IAAI,4BAA4B,EAAE,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,MAAmC;IAEnC,OAAO,cAAc,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,cAAc,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,cAAc,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sCAAsC;IACpD,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/operations/receive/helpers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Helper functions for receive operations.
+ */
+import type { VerifierContractLike, ViemVerifierContract } from "./types.js";
+/**
+ * Type guard for viem verifier contracts.
+ */
+export declare function isViemVerifierContract(contract: VerifierContractLike): contract is ViemVerifierContract;
+/**
+ * Read `totalTeleported` from a verifier contract, supporting multiple contract shapes.
+ * @param contract - Viem-style or legacy verifier contract instance.
+ * @param recipientFr - Recipient field element (as hex string).
+ * @throws If the contract does not expose a compatible `totalTeleported` method.
+ */
+export declare function readTotalTeleported(contract: VerifierContractLike, recipientFr: string): Promise<bigint>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/operations/receive/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/operations/receive/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAEV,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,oBAAoB,GAC7B,QAAQ,IAAI,oBAAoB,CAElC;AAMD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/dist/operations/receive/helpers.js

@@ -0,0 +1,33 @@
+/**
+ * Helper functions for receive operations.
+ */
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard for viem verifier contracts.
+ */
+export function isViemVerifierContract(contract) {
+    return typeof contract.read?.totalTeleported === "function";
+}
+// ============================================================================
+// Contract Helpers
+// ============================================================================
+/**
+ * Read `totalTeleported` from a verifier contract, supporting multiple contract shapes.
+ * @param contract - Viem-style or legacy verifier contract instance.
+ * @param recipientFr - Recipient field element (as hex string).
+ * @throws If the contract does not expose a compatible `totalTeleported` method.
+ */
+export async function readTotalTeleported(contract, recipientFr) {
+    if (isViemVerifierContract(contract)) {
+        const value = await contract.read.totalTeleported([recipientFr]);
+        return BigInt(value);
+    }
+    if (typeof contract.totalTeleported === "function") {
+        const value = await contract.totalTeleported(recipientFr);
+        return BigInt(value);
+    }
+    throw new Error("verifier contract must expose totalTeleported");
+}
+//# sourceMappingURL=helpers.js.map