@unlink-xyz/core 0.1.3 → 0.1.4

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

@@ -1,50 +1,95 @@
+import type { HistoryAmount, HistoryKind } from "../../history/types.js";
+import type { SerializedWitness } from "../../transactions/types/domain.js";
 export type JobStatus = "pending" | "submitted" | "broadcasting" | "succeeded" | "failed" | "dead";
-export type PendingJobKind = "deposit" | "transact";
-export type PendingJobBase = {
+export type JobKind = "deposit" | "transfer" | "withdraw" | "adapter";
+export type JobRecordBase = {
     relayId: string;
-    kind: PendingJobKind;
+    kind: JobKind;
     chainId: number;
+    /** Master public key (hex string) for correlating jobs with history/account views. */
+    mpk?: string;
     status: JobStatus;
-    broadcasterRelayId?: string | null;
     txHash?: string | null;
     createdAt: number;
     lastCheckedAt?: number;
     timeoutMs: number;
     error?: string | null;
+    /**
+     * Optional history preview so UIs can show pending/failed history rows before notes are indexed.
+     * Amount deltas follow HistoryAmount semantics (positive receive, negative send).
+     */
+    historyPreview?: {
+        kind: HistoryKind;
+        amounts: HistoryAmount[];
+    };
+};
+/**
+ * Predicted commitment info for deposits.
+ */
+export type PredictedCommitment = {
+    hex: string;
+    token: string;
+    amount: string;
+    index?: number;
+    root?: string;
 };
-export type PendingDepositJob = PendingJobBase & {
+/**
+ * Record for tracking deposits
+ */
+export type DepositRecord = JobRecordBase & {
     kind: "deposit";
-    predictedCommitment: {
-        hex: string;
-        index?: number;
-        root?: string;
-    };
+    /** Predicted commitments for each note */
+    predictedCommitments: PredictedCommitment[];
 };
-export type PendingTransactContext = {
+export type TransactContext = {
     index: number;
     nullifier: string;
-    witness: {
-        root: string;
-        leaf: string;
-        pathElements: string[][];
-        pathIndices: number[];
-        leafIndex: number;
-    };
+    witness: SerializedWitness;
     root: string;
 };
-export type PendingTransactOutput = {
+export type TransactOutput = {
     hex: string;
     index: number;
     root?: string;
 };
-export type PendingTransactJob = PendingJobBase & {
-    kind: "transact";
+/**
+ * Individual transaction info within a transact job.
+ */
+export type TransactJobTransaction = {
+    token: string;
+    nullifiers: string[];
+    predictedCommitments: Array<{
+        hex: string;
+        index?: number;
+    }>;
+    /** For withdrawals: amount and recipient */
+    withdrawal?: {
+        amount: string;
+        recipient: string;
+    };
+};
+/** Fields shared by transfer and withdraw records */
+type PoolTransactionFields = {
     poolAddress: string;
     calldata: string;
-    contexts: PendingTransactContext[];
-    predictedOutputs: PendingTransactOutput[];
-    expectedRoot?: string;
+    /** Individual transactions in the batch */
+    transactions: TransactJobTransaction[];
+};
+export type TransferRecord = JobRecordBase & PoolTransactionFields & {
+    kind: "transfer";
+};
+export type WithdrawRecord = JobRecordBase & PoolTransactionFields & {
+    kind: "withdraw";
+};
+export type AdapterRecord = JobRecordBase & PoolTransactionFields & {
+    kind: "adapter";
+    adapterAddress: string;
+    adapterCalldata: string;
 };
-export type PendingJobRecord = PendingDepositJob | PendingTransactJob;
+/** Union of all pool transaction records */
+export type PoolTransactionRecord = TransferRecord | WithdrawRecord | AdapterRecord;
+/** Union of all job records */
+export type JobRecord = DepositRecord | TransferRecord | WithdrawRecord | AdapterRecord;
 export declare const DEFAULT_JOB_TIMEOUT_MS: number;
+export {};
 //# sourceMappingURL=jobs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../state/store/jobs.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,WAAW,GACX,cAAc,GACd,WAAW,GACX,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,CAAC;AAEpD,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG;IAC/C,IAAI,EAAE,SAAS,CAAC;IAChB,mBAAmB,EAAE;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,EAAE,EAAE,CAAC;QACzB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG;IAChD,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAEtE,eAAO,MAAM,sBAAsB,QAAgB,CAAC"}
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../state/store/jobs.ts"],"names":[],"mappings":"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"}

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

@@ -9,6 +9,10 @@ export declare function createLeafStore(storage: Storage): {
      * Load a leaf commitment by tree index.
      */
     getLeaf(chainId: number, index: number): Promise<LeafRecord | null>;
+    /**
+     * Load all cached leaves for a chain in index order.
+     */
+    listLeaves(chainId: number): Promise<LeafRecord[]>;
     /**
      * Remove all cached leaves for a chain.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"leaf-store.d.ts","sourceRoot":"","sources":["../../../state/store/leaf-store.ts"],"names":[],"mappings":"AACA,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;IAM9B;;OAEG;qBACoB,MAAM,SAAS,MAAM;IAM5C;;OAEG;yBACwB,MAAM;EASpC"}
+{"version":3,"file":"leaf-store.d.ts","sourceRoot":"","sources":["../../../state/store/leaf-store.ts"],"names":[],"mappings":"AACA,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;IAM9B;;OAEG;qBACoB,MAAM,SAAS,MAAM;IAI5C;;OAEG;wBACuB,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAQxD;;OAEG;yBACwB,MAAM;EAQpC"}

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

@@ -4,7 +4,9 @@ export declare const emptyBytes: () => Uint8Array<ArrayBuffer>;
 export declare function createNoteStore(storage: Storage): {
     /**
      * Upsert a note record and maintain the unspent-note index for fast balance queries.
-     * If the note already exists and is marked as spent, preserve the spentAt field.
+     * If the note already exists and is marked as spent, preserve spentAt unless the caller
+     * provides an explicit spentAt value (eg. upgrading from a local observation time to an
+     * on-chain timestamp from the indexer).
      */
     putNote(note: NoteInsert): Promise<void>;
     /**
@@ -21,18 +23,16 @@ export declare function createNoteStore(storage: Storage): {
         includeSpent?: boolean;
     }): Promise<NoteRecord[]>;
     /**
-     * Mark a cached note as spent by setting its timestamp and re-indexing metadata.
+     * Mark a cached note as spent by setting its timestamp and transaction hash.
      */
-    markNoteSpent(chainId: number, index: number, spentAt?: number): Promise<NoteRecord>;
+    markNoteSpent(chainId: number, index: number, spentAt?: number, spentTxHash?: string): Promise<NoteRecord>;
     /**
      * Drop the spent marker from a cached note, returning it to the unspent index.
      */
     markNoteUnspent(chainId: number, index: number): Promise<NoteRecord>;
     /**
-     * Aggregate unspent note balances per token for a given master public key.
+     * Remove all cached notes and their unspent indices for a chain.
      */
-    getZkBalances(mpk: string, options?: {
-        chainId?: number;
-    }): Promise<Record<string, bigint>>;
+    clearNotes(chainId: number): Promise<void>;
 };
 //# sourceMappingURL=note-store.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"note-store.d.ts","sourceRoot":"","sources":["../../../state/store/note-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAavD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAElE,eAAO,MAAM,UAAU,+BAA0B,CAAC;AAElD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO;IAyC5C;;;OAGG;kBACiB,UAAU;IAW9B;;OAEG;qBACoB,MAAM,SAAS,MAAM;IAM5C;;OAEG;wBAEQ;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB;IAyBH;;OAEG;2BAC0B,MAAM,SAAS,MAAM;IAgBlD;;OAEG;6BAC4B,MAAM,SAAS,MAAM;IAgBpD;;OAEG;uBACsB,MAAM,YAAW;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;EAiBjE"}
+{"version":3,"file":"note-store.d.ts","sourceRoot":"","sources":["../../../state/store/note-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAW,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAevD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAElE,eAAO,MAAM,UAAU,+BAA0B,CAAC;AAElD,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO;IA2D5C;;;;;OAKG;kBACiB,UAAU;IAW9B;;OAEG;qBACoB,MAAM,SAAS,MAAM;IAI5C;;OAEG;wBAEQ;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB;IAkBH;;OAEG;2BAEQ,MAAM,SACR,MAAM,kCAEC,MAAM;IAiBtB;;OAEG;6BAC4B,MAAM,SAAS,MAAM;IAcpD;;OAEG;wBACuB,MAAM;EAmBnC"}

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

@@ -13,5 +13,14 @@ export declare function createNullifierStore(storage: Storage): {
      * Count all nullifiers stored locally for a given chain.
      */
     countNullifiers(chainId: number): Promise<number>;
+    /**
+     * Remove all cached nullifiers for a chain.
+     */
+    clearNullifiers(chainId: number): Promise<void>;
+    /**
+     * Remove cached nullifiers whose noteIndex >= fromIndex.
+     * Used by partial resync to keep the count-based optimization accurate.
+     */
+    clearNullifiersFromIndex(chainId: number, fromIndex: number): Promise<void>;
 };
 //# sourceMappingURL=nullifier-store.d.ts.map

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;IAIvD;;OAEG;6BAC4B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOrD;;;OAGG;sCAEQ,MAAM,aACJ,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;EAmBnB"}

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,20 @@ 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;
+    /**
+     * Optional adapter event fields persisted for "adapter_deposit" leaves.
+     * Keeping these in local state avoids per-leaf indexer fetches during rescans.
+     */
+    adapterNpk?: string;
+    adapterToken?: string;
+    adapterAmount?: string;
+    adapterRandom?: 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;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,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/store.d.ts

@@ -1,34 +1,86 @@
+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>;
+    listLeaves(chainId: number): Promise<LeafRecord[]>;
+    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>;
+    listCiphertexts(chainId: number): Promise<{
+        index: number;
+        payload: Uint8Array;
+    }[]>;
+    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>;
+    syncCommitmentBatch(items: Array<{
+        leaf: LeafRecord;
+        ciphertext: {
+            chainId: number;
+            index: number;
+            payload: Uint8Array;
+        };
+        root: RootRecord;
+        note?: NoteRecord;
+    }>): Promise<void>;
+    getRescanCursor(chainId: number, mpk: string): Promise<number | null>;
+    setRescanCursor(chainId: number, mpk: string, value: number): Promise<void>;
+    clearRescanCursors(chainId: number): 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/storage/indexeddb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexeddb.d.ts","sourceRoot":"","sources":["../../storage/indexeddb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAuC,OAAO,EAAE,MAAM,aAAa,CAAC;AAiBhF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAsCF,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAyJ3E"}
+{"version":3,"file":"indexeddb.d.ts","sourceRoot":"","sources":["../../storage/indexeddb.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EAAuC,OAAO,EAAE,MAAM,aAAa,CAAC;AAiBhF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAmEF,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAyK3E"}

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,CA2E7C"}

package/dist/transactions/adapter.d.ts

@@ -0,0 +1,31 @@
+import type { AdapterExecutionCall, AdapterExecutionReshield } from "./transact.js";
+export type { AdapterExecutionCall, AdapterExecutionReshield, } from "./transact.js";
+export declare const ADAPTER_EXECUTE_ABI: readonly ["function execute(bytes _transactData, (address to, bytes data, uint256 value)[] _calls, (uint256 npk, uint256 random, address token, uint256 minAmount)[] _reshields, address[] _inputTokens, uint256 _nonce, uint256 _deadline)"];
+export type BuildCallParams = {
+    to: string;
+    abi: string;
+    functionName: string;
+    args: unknown[];
+    value?: bigint;
+};
+export type EncodeAdapterExecuteParams = {
+    transactCalldata: string;
+    calls: AdapterExecutionCall[];
+    reshields: AdapterExecutionReshield[];
+    inputTokens: string[];
+    nonce: bigint;
+    deadline: bigint;
+};
+/**
+ * Build a single adapter call from ABI metadata.
+ */
+export declare function buildCall(params: BuildCallParams): AdapterExecutionCall;
+/**
+ * Build a standard ERC-20 approve call for adapter execution.
+ */
+export declare function buildApproveCall(token: string, spender: string, amount: bigint): AdapterExecutionCall;
+/**
+ * Encode `UnlinkAdapter.execute(...)` calldata.
+ */
+export declare function encodeAdapterExecute(params: EncodeAdapterExecuteParams): string;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../transactions/adapter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAEvB,eAAO,MAAM,mBAAmB,+OAEtB,CAAC;AAQX,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,SAAS,EAAE,wBAAwB,EAAE,CAAC;IACtC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAgDF;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,oBAAoB,CAoCvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,oBAAoB,CAetB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,0BAA0B,GACjC,MAAM,CAuBR"}

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 ephemeralKey, 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":"AA2BA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EAEjB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,WAAW,wKAEd,CAAC;AAmEX;;;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"}

package/dist/transactions/index.d.ts

@@ -1,7 +1,12 @@
-export { createDepositClient } from "./deposit.js";
-export { createTransactService } from "./transact.js";
+export { deposit, syncDeposit, DEPOSIT_ABI } from "./deposit.js";
+export { transact, syncTransact, computeBoundParamsHash, computeAdapterDataHash, } from "./transact.js";
+export type { AdapterExecutionCall, AdapterExecutionReshield, } from "./transact.js";
+export { ADAPTER_EXECUTE_ABI, buildApproveCall, buildCall, encodeAdapterExecute, type BuildCallParams, type EncodeAdapterExecuteParams, } from "./adapter.js";
+export { planTransaction } from "./transaction-planner.js";
+export { planWithdrawals, type WithdrawalPlan, type WithdrawalInput, } from "./withdrawal-planner.js";
+export { planTransfers, type TransferInput } from "./transfer-planner.js";
+export { selectNotesForAmount } from "./note-selection.js";
 export { createJobReconciler } from "./reconcile.js";
 export { createNoteSyncService } from "./note-sync.js";
-export type { NoteSyncStateStore } from "./note-sync.js";
-export type { DepositRelayResult, DepositNoteInput, DepositRequest, DepositSyncResult, DepositStateStore, Proof, OutputNoteInput, SpendNoteReference, TransactRelayResult, TransactRequest, TransactSyncResult, TransactStateStore, WithdrawalNoteInput, } from "./types.js";
+export type { BaseStateStore, TransactStateStore, NoteSyncStateStore, PollingOptions, ServiceOptions, NoteSyncOptions, Proof, Ciphertext, NoteInput, WithdrawalNoteInput, SpendNoteReference, SerializedWitness, DepositParams, DepositRelayResult, DepositSyncResult, DepositCommitmentInfo, TransactParams, TransactItem, TransactRelayResult, TransactItemResult, TransactSyncResult, Recipient, PlannedOutput, TransactionPlan, SelectableNote, SelectionOptions, SelectionResult, } from "./types/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../transactions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,EACL,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../transactions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,SAAS,EACT,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,0BAA0B,GAChC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,eAAe,EACf,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,YAAY,EAEV,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAGlB,cAAc,EACd,cAAc,EACd,eAAe,EAGf,KAAK,EACL,UAAU,EACV,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EAGjB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EAGrB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAGlB,SAAS,EACT,aAAa,EACb,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/transactions/note-selection.d.ts

@@ -0,0 +1,17 @@
+import type { SelectableNote, SelectionOptions, SelectionResult } from "./types/index.js";
+/**
+ * Select notes for a transaction with consolidation-first strategy.
+ *
+ * Priorities:
+ * 1. Consolidation - prefer spending more small notes
+ * 2. Minimize change - find combinations with less overshoot
+ * 3. Respect maxInputs constraint
+ *
+ * @param notes - Available unspent notes (caller filters by token)
+ * @param totalNeeded - Total amount needed for all recipients
+ * @param options - Selection options
+ * @returns Selection result with notes and amounts
+ * @throws ValidationError if insufficient balance or constraints can't be met
+ */
+export declare function selectNotesForAmount<T>(notes: SelectableNote<T>[], totalNeeded: bigint, options?: SelectionOptions): SelectionResult<T>;
+//# sourceMappingURL=note-selection.d.ts.map

package/dist/transactions/note-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-selection.d.ts","sourceRoot":"","sources":["../../transactions/note-selection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAyB1B;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,EAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAAC,CAAC,CAAC,CAuEpB"}

package/dist/transactions/note-sync.d.ts

@@ -1,46 +1,18 @@
-import type { ZkAccount } from "../account/zkAccount.js";
-import type { FetchLike } from "../clients/http.js";
-import { createIndexerClient } from "../clients/indexer.js";
-import { type LeafRecord, type LocalMerkleTrees, type NoteRecord, type RootRecord } from "../state/index.js";
-export type NoteSyncStateStore = {
-    putLeaf(record: LeafRecord): Promise<void>;
-    getLeaf(chainId: number, index: number): Promise<LeafRecord | null>;
-    clearLeaves(chainId: number): Promise<void>;
-    putRoot(record: RootRecord): Promise<void>;
-    putNote(record: NoteRecord): Promise<void>;
-    getNote(chainId: number, index: number): Promise<NoteRecord | null>;
-    markNoteSpent(chainId: number, index: number, spentAt?: number): Promise<NoteRecord>;
-    putCiphertext(chainId: number, index: number, payload: Uint8Array): Promise<void>;
-    countNullifiers(chainId: number): Promise<number>;
-    putNullifier(record: {
-        chainId: number;
-        nullifier: string;
-        noteIndex?: number;
-    }): Promise<void>;
-};
-export type NoteSyncOptions = {
-    merkleTrees?: LocalMerkleTrees;
-    indexerClient?: ReturnType<typeof createIndexerClient>;
-    fetch?: FetchLike;
-    limit?: number;
-};
+import type { AccountView } from "../account/account.js";
+import type { NoteSyncOptions, NoteSyncStateStore } from "./types/index.js";
+export type { NoteSyncOptions, NoteSyncStateStore };
 type ChainSyncStatus = {
     inFlight: boolean;
     lastSuccess: number | null;
     lastError?: string;
 };
 export declare function createNoteSyncService(stateStore: NoteSyncStateStore, options?: NoteSyncOptions): {
-    sync: (chainId: number, account: ZkAccount, opts?: {
-        start?: number;
-        forceFullScan?: boolean;
-    }) => Promise<NoteRecord[]>;
-    syncChain: (chainId: number, account: ZkAccount, opts?: {
+    syncChain: (chainId: number, account: AccountView, opts?: {
         forceFullResync?: boolean;
     }) => Promise<void>;
-    syncChains: (chainIds: number[], account: ZkAccount, opts?: {
+    syncChains: (chainIds: number[], account: AccountView, opts?: {
         forceFullResync?: boolean;
     }) => Promise<void>;
     getStatus: () => Map<number, ChainSyncStatus>;
 };
-export {};
 //# sourceMappingURL=note-sync.d.ts.map

package/dist/transactions/note-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"note-sync.d.ts","sourceRoot":"","sources":["../../transactions/note-sync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAK5D,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAQ3B,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACpE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACpE,aAAa,CACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,aAAa,CACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,YAAY,CAAC,MAAM,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,aAAa,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAqBF,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,kBAAkB,EAC9B,OAAO,GAAE,eAAoB;oBAsTlB,MAAM,WACN,SAAS,SACX;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,KACjD,OAAO,CAAC,UAAU,EAAE,CAAC;yBAnEb,MAAM,WACN,SAAS,SACZ;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,KAClC,OAAO,CAAC,IAAI,CAAC;2BA+CJ,MAAM,EAAE,WACT,SAAS,SACX;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,KACnC,OAAO,CAAC,IAAI,CAAC;;EAqEjB"}
+{"version":3,"file":"note-sync.d.ts","sourceRoot":"","sources":["../../transactions/note-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAmBzD,OAAO,KAAK,EAEV,eAAe,EACf,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAI1B,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAC;AAEpD,KAAK,eAAe,GAAG;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAuCF,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,kBAAkB,EAC9B,OAAO,GAAE,eAAoB;yBAuqBlB,MAAM,WACN,WAAW,SACd;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,KAClC,OAAO,CAAC,IAAI,CAAC;2BAoGJ,MAAM,EAAE,WACT,WAAW,SACb;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,KACnC,OAAO,CAAC,IAAI,CAAC;;EAejB"}