zerc20-client-sdk 0.1.15 → 0.2.0

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

@@ -0,0 +1,258 @@
+import { describe, expect, test, vi } from "vitest";
+import { prepareRedeemTransaction, buildBatchRedeemTransaction } from "../redeemTransaction.js";
+import { VerifierArtifact } from "../../../onchain/contracts.js";
+import { padHex } from "viem";
+import { normalizeHex } from "../../../utils/hex.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeEvent(overrides = {}) {
+    return {
+        eventIndex: 0n,
+        from: "0xaaaa",
+        to: "0xbbbb",
+        value: 100n,
+        ethBlockNumber: 1n,
+        ...overrides,
+    };
+}
+function makeGlobalProof(overrides = {}) {
+    return {
+        siblings: ["0x01"],
+        leafIndex: 0n,
+        event: makeEvent(),
+        ...overrides,
+    };
+}
+const MOCK_ADDRESS = "0x1234567890abcdef1234567890abcdef12345678";
+function makeBurn() {
+    return {
+        burnAddress: "0xburn",
+        fullBurnAddress: "0xfullburn",
+        secret: "0xsecret",
+        tweak: "0xtweak",
+        generalRecipient: {
+            chainId: 1n,
+            address: MOCK_ADDRESS,
+            tweak: "0x" + "aa".repeat(32),
+            fr: "0xfr",
+            u256: "0xu256",
+        },
+    };
+}
+function makeRedeemContext(eligibleCount) {
+    const eligible = Array.from({ length: eligibleCount }, (_, i) => makeEvent({ eventIndex: BigInt(i) }));
+    const globalProofs = Array.from({ length: eligibleCount }, (_, i) => makeGlobalProof({ leafIndex: BigInt(i), event: eligible[i] }));
+    return {
+        token: {
+            chainId: 1n,
+            verifierAddress: "0xVerifier",
+        },
+        aggregationState: {
+            latestAggSeq: 42n,
+            aggregationRoot: "0xroot",
+            snapshot: [],
+            transferTreeIndices: [],
+            chainIds: [1n],
+        },
+        events: { eligible, ineligible: [] },
+        globalProofs,
+        eligibleProofs: [],
+        totalEligibleValue: eligible.reduce((sum, e) => sum + e.value, 0n),
+        totalPendingValue: 0n,
+        totalIndexedValue: 0n,
+        totalTeleported: 0n,
+        chains: [],
+    };
+}
+// ---------------------------------------------------------------------------
+// Mock TeleportProofClient
+// ---------------------------------------------------------------------------
+function makeMockTeleportProofClient() {
+    return {
+        createSingleTeleportProof: vi.fn().mockResolvedValue({
+            proofCalldata: "0xsingleproof",
+            publicInputs: ["0x01"],
+            treeDepth: 20,
+        }),
+        createNovaProof: vi.fn().mockResolvedValue({
+            ivcProof: new Uint8Array([0x01]),
+            finalState: ["0x01"],
+            steps: 2,
+        }),
+        requestDeciderProof: vi.fn().mockResolvedValue(new Uint8Array([0xde, 0xad, 0xbe, 0xef])),
+    };
+}
+function makeMockDecider() {
+    return {
+        produceDeciderProof: vi.fn().mockResolvedValue(new Uint8Array([0xff])),
+    };
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe("prepareRedeemTransaction", () => {
+    test("single redeem: calls createSingleTeleportProof and returns singleTeleport", async () => {
+        const client = makeMockTeleportProofClient();
+        const ctx = makeRedeemContext(1);
+        const burn = makeBurn();
+        const result = await prepareRedeemTransaction({
+            redeemContext: ctx,
+            burn,
+            teleportProofClient: client,
+        });
+        expect(result.mode).toBe("single");
+        expect(result.functionName).toBe("singleTeleport");
+        expect(client.createSingleTeleportProof).toHaveBeenCalledOnce();
+        expect(client.createSingleTeleportProof).toHaveBeenCalledWith({
+            aggregationState: ctx.aggregationState,
+            recipientFr: burn.generalRecipient.fr,
+            secretHex: burn.secret,
+            event: ctx.events.eligible[0],
+            proof: ctx.globalProofs[0],
+        });
+        expect(result.args[0]).toBe(true);
+        expect(result.args[1]).toBe(42n);
+        expect(result.args[3]).toBe("0xsingleproof");
+    });
+    test("batch redeem: calls createNovaProof and requestDeciderProof, returns teleport", async () => {
+        const client = makeMockTeleportProofClient();
+        const decider = makeMockDecider();
+        const ctx = makeRedeemContext(3);
+        const burn = makeBurn();
+        const result = await prepareRedeemTransaction({
+            redeemContext: ctx,
+            burn,
+            teleportProofClient: client,
+            decider: decider,
+        });
+        expect(result.mode).toBe("batch");
+        expect(result.functionName).toBe("teleport");
+        expect(client.createNovaProof).toHaveBeenCalledOnce();
+        expect(client.createNovaProof).toHaveBeenCalledWith({
+            aggregationState: ctx.aggregationState,
+            recipientFr: burn.generalRecipient.fr,
+            secretHex: burn.secret,
+            events: ctx.events.eligible,
+            proofs: ctx.globalProofs,
+        });
+        expect(client.requestDeciderProof).toHaveBeenCalledOnce();
+        expect(client.requestDeciderProof).toHaveBeenCalledWith(decider, new Uint8Array([0x01]));
+        // deciderProof bytes [0xde, 0xad, 0xbe, 0xef] → hex
+        expect(result.args[3]).toBe("0xdeadbeef");
+    });
+    test("no eligible events: throws", async () => {
+        const client = makeMockTeleportProofClient();
+        const ctx = makeRedeemContext(0);
+        const burn = makeBurn();
+        await expect(prepareRedeemTransaction({
+            redeemContext: ctx,
+            burn,
+            teleportProofClient: client,
+        })).rejects.toThrow("No eligible events to redeem");
+    });
+    test("batch without decider: throws", async () => {
+        const client = makeMockTeleportProofClient();
+        const ctx = makeRedeemContext(2);
+        const burn = makeBurn();
+        await expect(prepareRedeemTransaction({
+            redeemContext: ctx,
+            burn,
+            teleportProofClient: client,
+            // no decider
+        })).rejects.toThrow("Decider client is required for batch redeem");
+    });
+    test("GeneralRecipient: address is padded to 32 bytes", async () => {
+        const client = makeMockTeleportProofClient();
+        const ctx = makeRedeemContext(1);
+        const burn = makeBurn();
+        const result = await prepareRedeemTransaction({
+            redeemContext: ctx,
+            burn,
+            teleportProofClient: client,
+        });
+        const gr = result.args[2];
+        const expected = padHex(normalizeHex(MOCK_ADDRESS), { size: 32 });
+        expect(gr.recipient).toBe(expected);
+        expect(gr.recipient).toHaveLength(66); // "0x" + 64 hex chars
+        expect(gr.chainId).toBe(burn.generalRecipient.chainId);
+        expect(gr.tweak).toBe(burn.generalRecipient.tweak);
+    });
+    test("buildBatchRedeemTransaction: builds batch tx from pre-computed proof", () => {
+        const ctx = makeRedeemContext(2);
+        const burn = makeBurn();
+        const deciderProof = new Uint8Array([0xde, 0xad]);
+        const result = buildBatchRedeemTransaction({ redeemContext: ctx, burn, deciderProof });
+        expect(result.mode).toBe("batch");
+        expect(result.functionName).toBe("teleport");
+        expect(result.args[0]).toBe(true);
+        expect(result.args[1]).toBe(42n);
+        expect(result.args[3]).toBe("0xdead");
+        expect(result.abi).toBe(VerifierArtifact.abi);
+    });
+    test("batch redeem: does not call requestDeciderProof when createNovaProof fails", async () => {
+        const client = makeMockTeleportProofClient();
+        client.createNovaProof.mockRejectedValue(new Error("nova failed"));
+        const decider = makeMockDecider();
+        const ctx = makeRedeemContext(2);
+        const burn = makeBurn();
+        await expect(prepareRedeemTransaction({
+            redeemContext: ctx,
+            burn,
+            teleportProofClient: client,
+            decider: decider,
+        })).rejects.toThrow("nova failed");
+        expect(client.requestDeciderProof).not.toHaveBeenCalled();
+    });
+    test("batch redeem: propagates requestDeciderProof failure", async () => {
+        const client = makeMockTeleportProofClient();
+        client.requestDeciderProof.mockRejectedValue(new Error("decider failed"));
+        const decider = makeMockDecider();
+        const ctx = makeRedeemContext(2);
+        const burn = makeBurn();
+        await expect(prepareRedeemTransaction({
+            redeemContext: ctx,
+            burn,
+            teleportProofClient: client,
+            decider: decider,
+        })).rejects.toThrow("decider failed");
+        expect(client.createNovaProof).toHaveBeenCalledOnce();
+    });
+    test("globalProofs/eligible length mismatch: throws", async () => {
+        const client = makeMockTeleportProofClient();
+        const ctx = makeRedeemContext(2);
+        const burn = makeBurn();
+        // Remove one proof to create a mismatch
+        ctx.globalProofs = [ctx.globalProofs[0]];
+        await expect(prepareRedeemTransaction({
+            redeemContext: ctx,
+            burn,
+            teleportProofClient: client,
+            decider: makeMockDecider(),
+        })).rejects.toThrow("Proof/event count mismatch: 1 proofs for 2 eligible events");
+    });
+    test("single with empty globalProofs: throws mismatch error", async () => {
+        const client = makeMockTeleportProofClient();
+        const ctx = makeRedeemContext(1);
+        const burn = makeBurn();
+        ctx.globalProofs = [];
+        await expect(prepareRedeemTransaction({
+            redeemContext: ctx,
+            burn,
+            teleportProofClient: client,
+        })).rejects.toThrow("Proof/event count mismatch: 0 proofs for 1 eligible events");
+    });
+    test("verifier address and ABI: uses redeemContext.token.verifierAddress and VerifierArtifact.abi", async () => {
+        const client = makeMockTeleportProofClient();
+        const ctx = makeRedeemContext(1);
+        const burn = makeBurn();
+        const result = await prepareRedeemTransaction({
+            redeemContext: ctx,
+            burn,
+            teleportProofClient: client,
+        });
+        expect(result.address).toBe("0xverifier");
+        expect(result.abi).toBe(VerifierArtifact.abi);
+    });
+});
+//# sourceMappingURL=redeemTransaction.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,58 @@
+import { describe, expect, test, vi } from "vitest";
+import { submitRedeemTransaction } from "../submitRedeem.js";
+function mockTx() {
+    return {
+        mode: "single",
+        address: "0x1234567890abcdef1234567890abcdef12345678",
+        abi: [],
+        functionName: "singleTeleport",
+        args: [true, 1n, { chainId: 1n, recipient: "0x00", tweak: "0x00" }, "0xproof"],
+    };
+}
+describe("submitRedeemTransaction", () => {
+    test("calls writeContract and waitForTransactionReceipt", async () => {
+        const writeProvider = {
+            account: { address: "0xabc" },
+            chain: { id: 1 },
+            writeContract: vi.fn().mockResolvedValue("0xhash"),
+        };
+        const readProvider = {
+            readContract: vi.fn(),
+            waitForTransactionReceipt: vi.fn().mockResolvedValue({ transactionHash: "0xhash" }),
+        };
+        const result = await submitRedeemTransaction({
+            writeProvider,
+            tx: mockTx(),
+            readProvider,
+        });
+        expect(result.transactionHash).toBe("0xhash");
+        expect(writeProvider.writeContract).toHaveBeenCalledTimes(1);
+        expect(readProvider.waitForTransactionReceipt).toHaveBeenCalledWith({ hash: "0xhash" });
+    });
+    test("applies fee overrides", async () => {
+        const writeProvider = {
+            writeContract: vi.fn().mockResolvedValue("0xhash"),
+        };
+        const readProvider = {
+            readContract: vi.fn(),
+            waitForTransactionReceipt: vi.fn().mockResolvedValue({}),
+        };
+        await submitRedeemTransaction({
+            writeProvider,
+            tx: mockTx(),
+            feeOverrides: { type: "legacy", gasPrice: 5000n },
+            readProvider,
+        });
+        expect(writeProvider.writeContract).toHaveBeenCalledWith(expect.objectContaining({
+            gasPrice: 5000n,
+            type: "legacy",
+        }));
+    });
+    test("throws when no provider supports waitForTransactionReceipt", async () => {
+        const writeProvider = {
+            writeContract: vi.fn().mockResolvedValue("0xhash"),
+        };
+        await expect(submitRedeemTransaction({ writeProvider, tx: mockTx() })).rejects.toThrow("waitForTransactionReceipt");
+    });
+});
+//# sourceMappingURL=submitRedeem.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"submitRedeem.test.js","sourceRoot":"","sources":["../../../../src/operations/receive/__tests__/submitRedeem.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAI7D,SAAS,MAAM;IACb,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,4CAA4C;QACrD,GAAG,EAAE,EAAS;QACd,YAAY,EAAE,gBAAgB;QAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC;KAC/E,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAI,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,aAAa,GAAqB;YACtC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAwB,EAAE;YAC9C,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE;YAChB,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;SACnD,CAAC;QACF,MAAM,YAAY,GAAoB;YACpC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;YACrB,yBAAyB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;SACpF,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC;YAC3C,aAAa;YACb,EAAE,EAAE,MAAM,EAAE;YACZ,YAAY;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,CAAC,YAAY,CAAC,yBAAyB,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,aAAa,GAAqB;YACtC,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;SACnD,CAAC;QACF,MAAM,YAAY,GAAoB;YACpC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;YACrB,yBAAyB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;SACzD,CAAC;QAEF,MAAM,uBAAuB,CAAC;YAC5B,aAAa;YACb,EAAE,EAAE,MAAM,EAAE;YACZ,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;YACjD,YAAY;SACb,CAAC,CAAC;QAEH,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,oBAAoB,CACtD,MAAM,CAAC,gBAAgB,CAAC;YACtB,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,QAAQ;SACf,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,aAAa,GAAqB;YACtC,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;SACnD,CAAC;QAEF,MAAM,MAAM,CAAC,uBAAuB,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CACpF,2BAA2B,CAC5B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -6,7 +6,7 @@ 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`.
+ * Aggregation state can be cached by providing both `cacheManager` and `cacheTtlMs`.
  */
 export declare function getAnnouncementStatus(params: AnnouncementStatusParams): Promise<AnnouncementStatus>;
 //# sourceMappingURL=announcementStatus.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"announcementStatus.d.ts","sourceRoot":"","sources":["../../../src/operations/receive/announcementStatus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,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,CAuD7B"}

package/dist/operations/receive/announcementStatus.js

@@ -4,24 +4,26 @@
 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 { fetchAggregationTreeState, fetchTransferEvents, separateEventsByEligibility, } from "../../wasm/index.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`.
+ * Aggregation state can be cached by providing both `cacheManager` and `cacheTtlMs`.
  */
 export async function getAnnouncementStatus(params) {
     const primaryChainId = params.burn.generalRecipient.chainId;
     const primaryToken = findTokenByChain(params.tokens, primaryChainId);
-    const aggregationState = await fetchAggregationTreeStateWithCache({
+    const fetchParams = {
         hub: params.hub,
         token: primaryToken,
         eventBlockSpan: params.eventBlockSpan,
         cacheTtlMs: params.cacheTtlMs,
-    });
+    };
+    const aggregationState = params.cacheManager
+        ? await params.cacheManager.fetchWithCache(fetchParams)
+        : await fetchAggregationTreeState(fetchParams);
     const chainEvents = await fetchTransferEvents({
         indexerUrl: params.indexerUrl,
         tokens: params.tokens,

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

@@ -1 +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"}
+{"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,EACL,yBAAyB,EACzB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,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,WAAW,GAAG;QAClB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,YAAY;QACnB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;IACF,MAAM,gBAAgB,GAAG,MAAM,CAAC,YAAY;QAC1C,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,WAAW,CAAC;QACvD,CAAC,CAAC,MAAM,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAEjD,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

@@ -48,22 +48,4 @@ export declare class AggregationStateCacheManager {
      */
     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

@@ -1 +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"}
+{"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"}

package/dist/operations/receive/cache.js

@@ -72,34 +72,4 @@ export class AggregationStateCacheManager {
         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

@@ -1 +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"}
+{"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"}

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

@@ -1,11 +1,22 @@
 /**
  * Helper functions for receive operations.
  */
-import type { VerifierContractLike, ViemVerifierContract } from "./types.js";
+import type { EvmReadProvider } from "../../types/evm.js";
+import type { ReadableVerifierContract, VerifierContractLike } from "./types.js";
 /**
- * Type guard for viem verifier contracts.
+ * Type guard for readable verifier contracts (those with a `.read` namespace).
  */
-export declare function isViemVerifierContract(contract: VerifierContractLike): contract is ViemVerifierContract;
+export declare function isReadableVerifierContract(contract: VerifierContractLike): contract is ReadableVerifierContract;
+/**
+ * Create a {@link ReadableVerifierContract} backed by an {@link EvmReadProvider}.
+ *
+ * This is the recommended way to build a verifier contract instance when using
+ * the provider abstraction (i.e. without depending on viem's `getContract`).
+ *
+ * @param provider - EVM read provider.
+ * @param address - Verifier contract address.
+ */
+export declare function createVerifierReader(provider: EvmReadProvider, address: string): ReadableVerifierContract;
 /**
  * Read `totalTeleported` from a verifier contract, supporting multiple contract shapes.
  * @param contract - Viem-style or legacy verifier contract instance.

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

@@ -1 +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"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/operations/receive/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAO,MAAM,oBAAoB,CAAC;AAG/D,OAAO,KAAK,EAEV,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,oBAAoB,GAC7B,QAAQ,IAAI,wBAAwB,CAEtC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,MAAM,GACd,wBAAwB,CAe1B;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

@@ -1,16 +1,46 @@
 /**
  * Helper functions for receive operations.
  */
+import { VerifierArtifact } from "../../onchain/contracts.js";
+import { normalizeHex } from "../../utils/hex.js";
 // ============================================================================
 // Type Guards
 // ============================================================================
 /**
- * Type guard for viem verifier contracts.
+ * Type guard for readable verifier contracts (those with a `.read` namespace).
  */
-export function isViemVerifierContract(contract) {
+export function isReadableVerifierContract(contract) {
     return typeof contract.read?.totalTeleported === "function";
 }
 // ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a {@link ReadableVerifierContract} backed by an {@link EvmReadProvider}.
+ *
+ * This is the recommended way to build a verifier contract instance when using
+ * the provider abstraction (i.e. without depending on viem's `getContract`).
+ *
+ * @param provider - EVM read provider.
+ * @param address - Verifier contract address.
+ */
+export function createVerifierReader(provider, address) {
+    const normalizedAddress = normalizeHex(address);
+    return {
+        read: {
+            totalTeleported: async (args) => {
+                const result = await provider.readContract({
+                    address: normalizedAddress,
+                    abi: VerifierArtifact.abi,
+                    functionName: "totalTeleported",
+                    args: [args[0]],
+                });
+                return result;
+            },
+        },
+    };
+}
+// ============================================================================
 // Contract Helpers
 // ============================================================================
 /**
@@ -20,7 +50,7 @@ export function isViemVerifierContract(contract) {
  * @throws If the contract does not expose a compatible `totalTeleported` method.
  */
 export async function readTotalTeleported(contract, recipientFr) {
-    if (isViemVerifierContract(contract)) {
+    if (isReadableVerifierContract(contract)) {
         const value = await contract.read.totalTeleported([recipientFr]);
         return BigInt(value);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/operations/receive/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA8B;IAE9B,OAAO,OAAQ,QAAiC,CAAC,IAAI,EAAE,eAAe,KAAK,UAAU,CAAC;AACxF,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAA8B,EAC9B,WAAmB;IAEnB,IAAI,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,KAAiC,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,OAAQ,QAAmC,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAC/E,MAAM,KAAK,GAAG,MAAO,QAAmC,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QACtF,OAAO,MAAM,CAAC,KAAiC,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/operations/receive/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAA8B;IAE9B,OAAO,OAAQ,QAAqC,CAAC,IAAI,EAAE,eAAe,KAAK,UAAU,CAAC;AAC5F,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAyB,EACzB,OAAe;IAEf,MAAM,iBAAiB,GAAG,YAAY,CAAC,OAAO,CAAQ,CAAC;IACvD,OAAO;QACL,IAAI,EAAE;YACJ,eAAe,EAAE,KAAK,EAAE,IAAuB,EAAE,EAAE;gBACjD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC;oBACzC,OAAO,EAAE,iBAAiB;oBAC1B,GAAG,EAAE,gBAAgB,CAAC,GAAG;oBACzB,YAAY,EAAE,iBAAiB;oBAC/B,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;iBAChB,CAAC,CAAC;gBACH,OAAO,MAAkC,CAAC;YAC5C,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAA8B,EAC9B,WAAmB;IAEnB,IAAI,0BAA0B,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QACjE,OAAO,MAAM,CAAC,KAAiC,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,OAAQ,QAAmC,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;QAC/E,MAAM,KAAK,GAAG,MAAO,QAAmC,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QACtF,OAAO,MAAM,CAAC,KAAiC,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;AACnE,CAAC"}

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

@@ -1,9 +1,13 @@
 /**
  * Receive operations for scanning announcements and collecting redeem context.
  */
-export type { ViemVerifierContract, LegacyVerifierContract, VerifierContractLike, RedeemChainContext, RedeemContext, RedeemContextParams, AnnouncementStatus, AnnouncementStatusParams, } from "./types.js";
+export type { ReadableVerifierContract, LegacyVerifierContract, VerifierContractLike, RedeemChainContext, RedeemContext, RedeemContextParams, AnnouncementStatus, AnnouncementStatusParams, OnChainGeneralRecipient, RedeemTransaction, PrepareRedeemTransactionParams, } from "./types.js";
 export type { FetchAggregationStateParams } from "./cache.js";
-export { AggregationStateCacheManager, fetchAggregationTreeStateWithCache, clearAggregationStateCache, resetAggregationStateCache, getDefaultAggregationStateCacheManager, } from "./cache.js";
+export { AggregationStateCacheManager } from "./cache.js";
+export { createVerifierReader } from "./helpers.js";
 export { collectRedeemContext } from "./redeemContext.js";
+export { prepareRedeemTransaction, buildBatchRedeemTransaction } from "./redeemTransaction.js";
+export type { SubmitRedeemTransactionParams } from "./submitRedeem.js";
+export { submitRedeemTransaction } from "./submitRedeem.js";
 export { getAnnouncementStatus } from "./announcementStatus.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/operations/receive/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EACL,4BAA4B,EAC5B,kCAAkC,EAClC,0BAA0B,EAC1B,0BAA0B,EAC1B,sCAAsC,GACvC,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/operations/receive/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAG/F,YAAY,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/operations/receive/index.js

@@ -1,9 +1,14 @@
 /**
  * Receive operations for scanning announcements and collecting redeem context.
  */
-export { AggregationStateCacheManager, fetchAggregationTreeStateWithCache, clearAggregationStateCache, resetAggregationStateCache, getDefaultAggregationStateCacheManager, } from "./cache.js";
+export { AggregationStateCacheManager } from "./cache.js";
+// Helpers
+export { createVerifierReader } from "./helpers.js";
 // Redeem context
 export { collectRedeemContext } from "./redeemContext.js";
+// Redeem transaction
+export { prepareRedeemTransaction, buildBatchRedeemTransaction } from "./redeemTransaction.js";
+export { submitRedeemTransaction } from "./submitRedeem.js";
 // Announcement status
 export { getAnnouncementStatus } from "./announcementStatus.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/operations/receive/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,OAAO,EACL,4BAA4B,EAC5B,kCAAkC,EAClC,0BAA0B,EAC1B,0BAA0B,EAC1B,sCAAsC,GACvC,MAAM,YAAY,CAAC;AAEpB,iBAAiB;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,sBAAsB;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/operations/receive/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE1D,UAAU;AACV,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,iBAAiB;AACjB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,qBAAqB;AACrB,OAAO,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAI/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,sBAAsB;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}