@unlink-xyz/core 0.1.2 → 0.1.3-canary.0877bfe

package/dist/state/store/nullifier-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nullifier-store.d.ts","sourceRoot":"","sources":["../../../state/store/nullifier-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO;IAEjD;;OAEG;4BAC2B,eAAe;IAS7C;;OAEG;0BACyB,MAAM,SAAS,MAAM;IAKjD;;OAEG;6BAC4B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;EAO1D"}
+{"version":3,"file":"nullifier-store.d.ts","sourceRoot":"","sources":["../../../state/store/nullifier-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO;IAEjD;;OAEG;4BAC2B,eAAe;IAS7C;;OAEG;0BACyB,MAAM,SAAS,MAAM;IAIjD;;OAEG;6BAC4B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMvD;;OAEG;6BAC4B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD;;;OAGG;sCAEQ,MAAM,aACJ,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;EAmBnB"}

package/dist/state/store/nullifier-store.js

@@ -14,17 +14,47 @@ export function createNullifierStore(storage) {
          * Lookup a previously observed nullifier by value.
          */
         async getNullifier(chainId, value) {
-            ensureChainId(chainId);
             return getJson(storage, keys.nullifier(chainId, value));
         },
         /**
          * Count all nullifiers stored locally for a given chain.
          */
         async countNullifiers(chainId) {
-            ensureChainId(chainId);
             const prefix = `nullifiers:${chainId}:`;
             const entries = await storage.iter({ prefix });
             return entries.length;
         },
+        /**
+         * Remove all cached nullifiers for a chain.
+         */
+        async clearNullifiers(chainId) {
+            const prefix = `nullifiers:${chainId}:`;
+            const entries = await storage.iter({ prefix });
+            if (entries.length === 0)
+                return;
+            await storage.batch(entries.map(({ key }) => ({ del: key })));
+        },
+        /**
+         * Remove cached nullifiers whose noteIndex >= fromIndex.
+         * Used by partial resync to keep the count-based optimization accurate.
+         */
+        async clearNullifiersFromIndex(chainId, fromIndex) {
+            const prefix = `nullifiers:${chainId}:`;
+            const entries = await storage.iter({ prefix });
+            const ops = [];
+            for (const { key, value } of entries) {
+                try {
+                    const record = JSON.parse(new TextDecoder().decode(value));
+                    if (record.noteIndex === undefined || record.noteIndex >= fromIndex) {
+                        ops.push({ del: key });
+                    }
+                }
+                catch {
+                    // Malformed entry — skip
+                }
+            }
+            if (ops.length > 0)
+                await storage.batch(ops);
+        },
     };
 }

package/dist/state/store/records.d.ts

@@ -22,10 +22,33 @@ export type NoteRecord = {
     random: string;
     /** Nullifier that will be revealed when the note is spent. */
     nullifier: string;
-    /** Optional timestamp when the note was marked as spent. */
+    /**
+     * Transaction hash that inserted this note commitment on-chain.
+     * Derived from the indexer commitment record.
+     */
+    createdTxHash?: string;
+    /**
+     * Indexer event type associated with the commitment insertion.
+     * Typically "deposit" or "transact" once supported by the indexer.
+     */
+    createdEventType?: string;
+    /** Optional timestamp (ms) when this note was created/observed by the indexer. */
+    createdAt?: number;
+    /**
+     * Optional timestamp (ms) when the note was marked as spent.
+     * Prefer an on-chain/indexer-derived time when available; otherwise it may be a local observation time.
+     */
+    spentAt?: number;
+    /** Transaction hash that spent this note (via its nullifier), when known. */
+    spentTxHash?: string;
+};
+export type NoteInsert = Omit<NoteRecord, "spentAt"> & {
+    /**
+     * Optional timestamp (ms) when the note was marked as spent.
+     * When omitted, existing spentAt (if any) is preserved by the note store.
+     */
     spentAt?: number;
 };
-export type NoteInsert = Omit<NoteRecord, 'spentAt'>;
 /**
  * Details about a nullifier observed on-chain, whether or not we own the note.
  */
@@ -45,6 +68,12 @@ export type LeafRecord = {
     index: number;
     /** Commitment value stored in the tree. */
     commitment: string;
+    /** Transaction hash that created this commitment. */
+    txHash?: string;
+    /** Event type: "deposit" or "transact". */
+    eventType?: string;
+    /** Unix timestamp (seconds) when indexed. */
+    insertedAt?: number;
 };
 /**
  * Historical merkle root snapshot used for proof construction.

package/dist/state/store/records.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../../state/store/records.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAGF,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../../state/store/records.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG;IACrD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/dist/state/store/root-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"root-store.d.ts","sourceRoot":"","sources":["../../../state/store/root-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO;IAE5C;;OAEG;kBACiB,UAAU;IAU9B;;OAEG;qBACoB,MAAM,SAAS,MAAM;EAQ/C"}
+{"version":3,"file":"root-store.d.ts","sourceRoot":"","sources":["../../../state/store/root-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO;IAE5C;;OAEG;kBACiB,UAAU;IAU9B;;OAEG;qBACoB,MAAM,SAAS,MAAM;EAI/C"}

package/dist/state/store/root-store.js

@@ -20,10 +20,6 @@ export function createRootStore(storage) {
          * Retrieve a root snapshot by Merkle root value.
          */
         async getRoot(chainId, value) {
-            ensureChainId(chainId);
-            if (typeof value !== "string" || value.length === 0) {
-                throw new CoreError("root value must be a non-empty string");
-            }
             return getJson(storage, keys.root(chainId, value));
         },
     };

package/dist/state/store/store.d.ts

@@ -1,34 +1,68 @@
+import type { HistoryEntry } from "../../history/types.js";
 import type { Storage } from "../../types.js";
-export declare function createStateStore(storage: Storage): {
-    putPendingJob(job: import("./jobs.js").PendingJobRecord): Promise<void>;
-    getPendingJob(relayId: string): Promise<import("./jobs.js").PendingJobRecord | null>;
-    listPendingJobs(filter?: {
-        kind?: import("./jobs.js").PendingJobKind;
-        statuses?: import("./jobs.js").JobStatus[];
-    }): Promise<import("./jobs.js").PendingJobRecord[]>;
-    deletePendingJob(relayId: string): Promise<void>;
-    putCiphertext(chainId: number, index: number, payload: Uint8Array): Promise<void>;
-    getCiphertext(chainId: number, index: number): Promise<Uint8Array<ArrayBuffer> | null>;
-    putRoot(root: import("./records.js").RootRecord): Promise<void>;
-    getRoot(chainId: number, value: string): Promise<import("./records.js").RootRecord | null>;
-    putLeaf(leaf: import("./records.js").LeafRecord): Promise<void>;
-    getLeaf(chainId: number, index: number): Promise<import("./records.js").LeafRecord | null>;
-    clearLeaves(chainId: number): Promise<void>;
-    putNullifier(nullifier: import("./records.js").NullifierRecord): Promise<void>;
-    getNullifier(chainId: number, value: string): Promise<import("./records.js").NullifierRecord | null>;
-    countNullifiers(chainId: number): Promise<number>;
-    putNote(note: import("./records.js").NoteInsert): Promise<void>;
-    getNote(chainId: number, index: number): Promise<import("./records.js").NoteRecord | null>;
+import type { JobKind, JobRecord, JobStatus } from "./jobs.js";
+import type { LeafRecord, NoteInsert, NoteRecord, NullifierRecord, RootRecord } from "./records.js";
+export interface StateStore {
+    putNote(note: NoteInsert): Promise<void>;
+    getNote(chainId: number, index: number): Promise<NoteRecord | null>;
     listNotes(options?: {
         chainId?: number;
         mpk?: string;
         token?: string;
         includeSpent?: boolean;
-    }): Promise<import("./records.js").NoteRecord[]>;
-    markNoteSpent(chainId: number, index: number, spentAt?: number): Promise<import("./records.js").NoteRecord>;
-    markNoteUnspent(chainId: number, index: number): Promise<import("./records.js").NoteRecord>;
-    getZkBalances(mpk: string, options?: {
-        chainId?: number;
-    }): Promise<Record<string, bigint>>;
-};
+    }): Promise<NoteRecord[]>;
+    markNoteSpent(chainId: number, index: number, spentAt?: number, spentTxHash?: string): Promise<NoteRecord>;
+    markNoteUnspent(chainId: number, index: number): Promise<NoteRecord>;
+    clearNotes(chainId: number): Promise<void>;
+    putNullifier(nullifier: NullifierRecord): Promise<void>;
+    getNullifier(chainId: number, value: string): Promise<NullifierRecord | null>;
+    countNullifiers(chainId: number): Promise<number>;
+    clearNullifiers(chainId: number): Promise<void>;
+    clearNullifiersFromIndex(chainId: number, fromIndex: number): Promise<void>;
+    putLeaf(leaf: LeafRecord): Promise<void>;
+    getLeaf(chainId: number, index: number): Promise<LeafRecord | null>;
+    clearLeaves(chainId: number): Promise<void>;
+    putRoot(root: RootRecord): Promise<void>;
+    getRoot(chainId: number, value: string): Promise<RootRecord | null>;
+    putCiphertext(chainId: number, index: number, payload: Uint8Array): Promise<void>;
+    getCiphertext(chainId: number, index: number): Promise<Uint8Array | null>;
+    clearCiphertexts(chainId: number): Promise<void>;
+    putJob(job: JobRecord): Promise<void>;
+    getJob(relayId: string): Promise<JobRecord | null>;
+    listJobs(filter?: {
+        kind?: JobKind;
+        statuses?: JobStatus[];
+    }): Promise<JobRecord[]>;
+    deleteJob(relayId: string): Promise<void>;
+    putHistoryEntry(entry: HistoryEntry): Promise<void>;
+    hasHistorySnapshot(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<boolean>;
+    listHistoryEntries(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<HistoryEntry[]>;
+    clearHistoryEntries(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<void>;
+    commitHistorySnapshot(options: {
+        chainId: number;
+        mpk: string;
+    }): Promise<void>;
+    syncCommitment(params: {
+        leaf: LeafRecord;
+        ciphertext: {
+            chainId: number;
+            index: number;
+            payload: Uint8Array;
+        };
+        root: RootRecord;
+        note?: NoteRecord;
+    }): Promise<void>;
+    /** Clear notes, leaves, ciphertexts, and unspent indices for indices >= fromIndex. */
+    clearChainDataFromIndex(chainId: number, fromIndex: number): Promise<void>;
+}
+export declare function createStateStore(storage: Storage): StateStore;
 //# sourceMappingURL=store.d.ts.map

package/dist/state/store/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../state/store/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAQ9C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO;;;;YAiBg2F,CAAC;gBAAkC,CAAC;;;;;;;;;;;;;;;;eAA5jC,CAAC;WAAqB,CAAC;aAAuB,CAAC;oBAA8B,CAAC;;;;;eAA+qE,CAAC;;EADtnI"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../state/store/store.ts"],"names":[],"mappings":"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"}

package/dist/state/store/store.js

@@ -1,7 +1,10 @@
+import { keys } from "../../keys.js";
+import { encodeJson } from "../../utils/json-codec.js";
 import { createCiphertextStore } from "./ciphertext-store.js";
+import { createHistoryStore } from "./history-store.js";
 import { createJobStore } from "./job-store.js";
 import { createLeafStore } from "./leaf-store.js";
-import { createNoteStore } from "./note-store.js";
+import { createNoteStore, emptyBytes } from "./note-store.js";
 import { createNullifierStore } from "./nullifier-store.js";
 import { createRootStore } from "./root-store.js";
 export function createStateStore(storage) {
@@ -11,6 +14,91 @@ export function createStateStore(storage) {
     const roots = createRootStore(storage);
     const ciphertexts = createCiphertextStore(storage);
     const jobs = createJobStore(storage);
+    const history = createHistoryStore(storage);
+    /**
+     * Atomically store a commitment's leaf, ciphertext, root, and optionally note.
+     * Uses storage.batch() for all-or-nothing semantics.
+     */
+    async function syncCommitment(params) {
+        const { leaf, ciphertext, root, note } = params;
+        const ops = [
+            // Leaf
+            {
+                put: [
+                    keys.leaf(leaf.chainId, leaf.index),
+                    encodeJson(leaf),
+                ],
+            },
+            // Ciphertext (raw bytes, not JSON)
+            {
+                put: [
+                    keys.ciphertext(ciphertext.chainId, ciphertext.index),
+                    ciphertext.payload,
+                ],
+            },
+            // Root
+            {
+                put: [
+                    keys.root(root.chainId, root.root),
+                    encodeJson(root),
+                ],
+            },
+        ];
+        // Note (if decryption succeeded)
+        if (note) {
+            ops.push({
+                put: [
+                    keys.note(note.chainId, note.index),
+                    encodeJson(note),
+                ],
+            });
+            // Maintain unspent index
+            if (note.spentAt === undefined) {
+                ops.push({
+                    put: [keys.unspent(note.chainId, note.mpk, note.index), emptyBytes()],
+                });
+            }
+        }
+        await storage.batch(ops);
+    }
+    /**
+     * Clear notes, leaves, ciphertexts, and unspent indices for indices >= fromIndex.
+     * Used by partial resync to remove stale tail data while preserving the valid prefix.
+     *
+     * Key formats (see keys.ts): notes:${c}:${i}, leaves:${c}:${i},
+     * ciphertexts:${c}:${i}, idx:notes:unspent:${c}:${mpk}:${i}.
+     * The index is always the last colon-separated segment.
+     */
+    async function clearChainDataFromIndex(chainId, fromIndex) {
+        const prefixes = [
+            `notes:${chainId}:`,
+            `leaves:${chainId}:`,
+            `ciphertexts:${chainId}:`,
+        ];
+        const ops = [];
+        for (const prefix of prefixes) {
+            const entries = await storage.iter({ prefix });
+            for (const { key } of entries) {
+                // Index is always the last colon-segment (see keys.ts key builders)
+                const idx = parseInt(key.slice(key.lastIndexOf(":") + 1), 10);
+                if (!isNaN(idx) && idx >= fromIndex) {
+                    ops.push({ del: key });
+                }
+            }
+        }
+        // Clear unspent index entries (key: idx:notes:unspent:${c}:${mpk}:${index})
+        const unspentPrefix = `idx:notes:unspent:${chainId}:`;
+        const unspentEntries = await storage.iter({ prefix: unspentPrefix });
+        for (const { key } of unspentEntries) {
+            // Index is always the last colon-segment (see keys.ts key builders)
+            const idx = parseInt(key.slice(key.lastIndexOf(":") + 1), 10);
+            if (!isNaN(idx) && idx >= fromIndex) {
+                ops.push({ del: key });
+            }
+        }
+        if (ops.length > 0)
+            await storage.batch(ops);
+    }
     return {
         ...notes,
         ...nullifiers,
@@ -18,5 +106,8 @@ export function createStateStore(storage) {
         ...roots,
         ...ciphertexts,
         ...jobs,
+        ...history,
+        syncCommitment,
+        clearChainDataFromIndex,
     };
 }

package/dist/storage/indexeddb.js

@@ -146,7 +146,7 @@ export function createIndexedDbStorage(opts = {}) {
                 try {
                     tx.abort();
                 }
-                catch (_) {
+                catch {
                     /* noop */
                 }
                 await done.catch(() => { });

package/dist/storage/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../storage/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAuC,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3E,wBAAgB,mBAAmB,IAAI,OAAO,CA+D7C"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../storage/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAuC,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3E,wBAAgB,mBAAmB,IAAI,OAAO,CAmE7C"}

package/dist/storage/memory.js

@@ -38,7 +38,11 @@ export function createMemoryStorage() {
         },
         async delete(k) {
             validateKey(k);
-            data.delete(k);
+            const value = data.get(k);
+            if (value) {
+                // We don't zeroize here by default since we don't know if this is sensitive data.
+                data.delete(k);
+            }
         },
         async batch(ops) {
             const draft = new Map(data);

package/dist/transactions/deposit.d.ts

@@ -1,16 +1,13 @@
-import { FetchLike } from "../clients/http.js";
-import { LocalMerkleTrees } from "../state/index.js";
-import type { DepositRelayResult, DepositRequest, DepositStateStore, DepositSyncResult } from "./types.js";
-export declare const DEPOSIT_ABI: readonly ["function deposit(address _depositor, (uint256 npk, uint256 amount, address token)[] notes, (uint256[3] data)[] ciphertexts)"];
-type DepositClientOptions = {
-    merkleTrees?: LocalMerkleTrees;
-    fetch: FetchLike;
-    pollIntervalMs?: number;
-    pollTimeoutMs?: number;
-};
-export declare function createDepositClient(stateStore: DepositStateStore, options: DepositClientOptions): {
-    request(request: DepositRequest): Promise<DepositRelayResult>;
-    syncPendingDeposit(relayId: string): Promise<DepositSyncResult>;
-};
-export {};
+import type { BaseStateStore, DepositParams, DepositRelayResult, DepositSyncResult, ServiceOptions } from "./types/index.js";
+export declare const DEPOSIT_ABI: readonly ["function deposit(address _depositor, (uint256 npk, uint256 amount, address token)[] notes, (uint256[3] data)[] ciphertexts) payable"];
+/**
+ * Prepare a deposit: compute commitments, build calldata, and persist pending job.
+ * Accepts 1 or more notes in a single transaction.
+ */
+export declare function deposit(store: BaseStateStore, req: DepositParams): Promise<DepositRelayResult>;
+/**
+ * Wait for all commitments in a deposit to be indexed and update local state.
+ * Works for both single and multi-note deposits.
+ */
+export declare function syncDeposit(store: BaseStateStore, relayId: string, opts: ServiceOptions): Promise<DepositSyncResult>;
 //# sourceMappingURL=deposit.d.ts.map

package/dist/transactions/deposit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deposit.d.ts","sourceRoot":"","sources":["../../transactions/deposit.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI/C,OAAO,EAGL,gBAAgB,EAGjB,MAAM,mBAAmB,CAAC;AAU3B,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,WAAW,0IAEd,CAAC;AAGX,KAAK,oBAAoB,GAAG;IAC1B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAuBF,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,oBAAoB;qBA4DJ,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC;gCA6BjC,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;EAwExE"}
+{"version":3,"file":"deposit.d.ts","sourceRoot":"","sources":["../../transactions/deposit.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EAEjB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,WAAW,kJAEd,CAAC;AAyEX;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,kBAAkB,CAAC,CAgD7B;AAkHD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAiD5B"}