n3-sdk 0.2.13 → 0.2.14

package/dist/lib/utils/pureSigner.d.ts

@@ -15,9 +15,7 @@ export declare function verifyPoseidonCompat(Ax: string | bigint, Ay: string | b
     R8y: string;
     S: string;
 }): boolean;
-export declare function permitSwapMsg(DOMAIN: bigint, domainB: bigint, // chainId-dec
-domainA: bigint, // pool-dec
-commit: bigint, oldRoot: bigint, giveAmount: bigint, outRecv: {
+export declare function permitSwapMsg(DOMAIN: bigint, domainB: bigint, domainA: bigint, commit: bigint, oldRoot: bigint, giveAmount: bigint, outRecv: {
     assetId: bigint;
     amount: bigint;
     pubkey: bigint;

package/dist/lib/utils/pureSigner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pureSigner.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/pureSigner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pureSigner.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/pureSigner.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils/pureSigner.js

@@ -1,29 +1,52 @@
 // src/lib/utils/pureSigner.ts
 // Pure-JS BabyJub EdDSA(Poseidon) helpers using circomlibjs builder API.
-import { buildBabyjub, buildEddsa, buildPoseidonReference } from "circomlibjs";
-try {
-    globalThis.ffjsconfig = { wasm: "disable" };
-    if (typeof process !== "undefined" && process?.env) {
-        process.env.FFJS_FORCE_NO_WASM = "1";
-        process.env.FFJSCONFIG = '{"wasm":"disable"}';
-    }
-}
-catch { }
 let _ctxPromise = null;
 let _ctx = null;
+function setFfjsNoWasmConfig() {
+    try {
+        // Must be set BEFORE importing circomlibjs/ffjavascript
+        globalThis.ffjsconfig = { wasm: "disable" };
+        // In the browser, process.env is usually undefined; keep this guarded.
+        if (typeof process !== "undefined" && process?.env) {
+            process.env.FFJS_FORCE_NO_WASM = "1";
+            process.env.FFJSCONFIG = '{"wasm":"disable"}';
+        }
+    }
+    catch {
+        // ignore
+    }
+}
+async function loadCircomlibBuilders() {
+    setFfjsNoWasmConfig();
+    // Dynamic import ensures the config above is applied BEFORE module init runs.
+    const mod = await import("circomlibjs");
+    return {
+        buildBabyjub: mod.buildBabyjub,
+        buildEddsa: mod.buildEddsa,
+        buildPoseidonReference: mod.buildPoseidonReference,
+    };
+}
 async function buildCtx() {
-    const [babyJub, eddsa, poseidonRef] = await Promise.all([
-        buildBabyjub(),
-        buildEddsa(),
-        buildPoseidonReference(),
-    ]);
+    const { buildBabyjub, buildEddsa, buildPoseidonReference } = await loadCircomlibBuilders();
+    // SEQUENTIAL init to avoid peak memory spikes
+    const babyJub = await buildBabyjub();
+    const eddsa = await buildEddsa();
+    const poseidonRef = await buildPoseidonReference();
     return { babyJub, eddsa, poseidonRef, Fr: babyJub.F };
 }
 async function ensureCtx() {
     if (_ctx)
         return _ctx;
-    if (!_ctxPromise)
-        _ctxPromise = buildCtx().then((c) => (_ctx = c));
+    if (!_ctxPromise) {
+        _ctxPromise = buildCtx()
+            .then((c) => (_ctx = c))
+            .catch((e) => {
+            // allow retry after a failure
+            _ctxPromise = null;
+            _ctx = null;
+            throw e;
+        });
+    }
     return _ctxPromise;
 }
 function ctxOrThrow() {
@@ -76,17 +99,9 @@ export function noteCommit(assetId, amount, pubkey, blinding) {
     const h2 = (x, y) => H2(x, y);
     return h2(h2(assetId, amount), h2(pubkey, blinding));
 }
-// PermitCheck / SpendInternal / SpendWithdraw:
-// M = Poseidon(DOMAIN, domainB /*chainId*/, domainA /*poolAddr*/, commit, oldRoot)
 export function msgHash(DOMAIN, chainDec, poolDec, c_in, oldRoot) {
     const { poseidonRef, Fr } = ctxOrThrow();
-    return Fr.toObject(poseidonRef([
-        Fr.e(DOMAIN),
-        Fr.e(chainDec),
-        Fr.e(poolDec),
-        Fr.e(c_in),
-        Fr.e(oldRoot),
-    ]));
+    return Fr.toObject(poseidonRef([Fr.e(DOMAIN), Fr.e(chainDec), Fr.e(poolDec), Fr.e(c_in), Fr.e(oldRoot)]));
 }
 export function poseidonAxAy(Ax, Ay) {
     const { poseidonRef, Fr } = ctxOrThrow();
@@ -125,19 +140,8 @@ export function verifyPoseidonCompat(Ax, Ay, M, sig) {
     const S = toBI(sig.S);
     return eddsa.verifyPoseidon(M, { R8, S }, A);
 }
-// ---------- PermitSwap (taker/maker spend auth) ----------
-// Mirrors PermitSwap.circom exactly:
-// hD  = Poseidon(DOMAIN, domainB, domainA)
-// hC  = Poseidon(commit, oldRoot)
-// hG  = Poseidon(giveAmount, outRecvAssetId)
-// hR1 = Poseidon(outRecvAmount, outRecvPubkey, outRecvBlinding)
-// hR  = Poseidon(hG, hR1)
-// hC1 = Poseidon(outChAssetId, outChAmount, outChPubkey)
-// hC2 = Poseidon(hC1, outChBlinding)
-// M   = Poseidon(hD, hC, hR, hC2)
-export function permitSwapMsg(DOMAIN, domainB, // chainId-dec
-domainA, // pool-dec
-commit, oldRoot, giveAmount, outRecv, outCh) {
+// ---------- PermitSwap ----------
+export function permitSwapMsg(DOMAIN, domainB, domainA, commit, oldRoot, giveAmount, outRecv, outCh) {
     const hD = H3(DOMAIN, domainB, domainA);
     const hC = H2(commit, oldRoot);
     const hG = H2(giveAmount, outRecv.assetId);
@@ -149,9 +153,8 @@ commit, oldRoot, giveAmount, outRecv, outCh) {
 }
 export function signPermitSwapCompat(prvSeed, Ax, Ay, M) {
     const sig = signPoseidonCompat(prvSeed, M, String(Ax), String(Ay));
-    if (!verifyPoseidonCompat(Ax, Ay, M, sig)) {
+    if (!verifyPoseidonCompat(Ax, Ay, M, sig))
         throw new Error("PermitSwap verify failed (local).");
-    }
     return sig;
 }
 export function dbgPermitSwapParts(side, { DOMAIN, chainDec, poolDec, commit, oldRoot, giveAmount, recv, ch, }) {
@@ -174,8 +177,6 @@ export function dbgPermitSwapParts(side, { DOMAIN, chainDec, poolDec, commit, ol
     });
 }
 // ---------- OrderPermit (maker) ----------
-// Mirrors OrderPermitHash.circom exactly.
-// NOTE: bandOff is an input to the circuit but not actually used in the hash there.
 export function orderPermitHash(DOMAIN, domainA, domainB, side, assetIn, assetOut, minNum, minDen, maxNum, maxDen, _bandOff, priceNum, priceDen, maxQty, expiry, orderId) {
     const hDA = H2(domainA, domainB);
     const hD = H2(DOMAIN, hDA);
@@ -194,24 +195,18 @@ export function orderPermitHash(DOMAIN, domainA, domainB, side, assetIn, assetOu
 }
 export function signOrderPermitCompat(prvSeed, Ax, Ay, orderHash) {
     const sig = signPoseidonCompat(prvSeed, orderHash, String(Ax), String(Ay));
-    if (!verifyPoseidonCompat(Ax, Ay, orderHash, sig)) {
+    if (!verifyPoseidonCompat(Ax, Ay, orderHash, sig))
         throw new Error("OrderPermit verify failed (local).");
-    }
     return sig;
 }
 export function deriveBabyJubFromSeed(prvSeed) {
     const { eddsa, Fr } = ctxOrThrow();
     const raw = prvSeed.startsWith("0x") ? hexToBytes(prvSeed) : be32FromDec(prvSeed);
-    if (raw.length !== 32) {
+    if (raw.length !== 32)
         throw new Error(`deriveBabyJubFromSeed: prvSeed must be 32 bytes, got ${raw.length}`);
-    }
     const A = eddsa.prv2pub(raw);
     const Ax = Fr.toObject(A[0]);
     const Ay = Fr.toObject(A[1]);
     const notePubkey = poseidonAxAy(Ax, Ay);
-    return {
-        Ax: Ax.toString(),
-        Ay: Ay.toString(),
-        notePubkey: notePubkey.toString(),
-    };
+    return { Ax: Ax.toString(), Ay: Ay.toString(), notePubkey: notePubkey.toString() };
 }

package/dist/notes/receiver.d.ts

@@ -1,5 +1,4 @@
 import type { NoteStore } from './store.js';
-import type { NoteV1 } from '../types/NoteStoreTypes.js';
 type Chain = {
     getEvents: (fromBlock?: number) => Promise<{
         newRoots: {
@@ -28,9 +27,6 @@ export declare class Receiver {
     private store;
     private chain;
     constructor(store: NoteStore, chain: Chain);
-    stageDepositNote(note: NoteV1): Promise<void>;
-    stageItOutNotes(notes: NoteV1[]): Promise<void>;
-    /** One-shot reconcile. Call from a small loop for “always-on”. */
     reconcile(fromBlock?: number): Promise<void>;
 }
 export {};

package/dist/notes/receiver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"receiver.d.ts","sourceRoot":"","sources":["../../src/notes/receiver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,KAAK,KAAK,GAAG;IACX,SAAS,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QACzC,QAAQ,EAAE;YAAE,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACnD,MAAM,EAAI;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,KAAK,MAAM,EAAE,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;SAAE,EAAE,CAAC;QACjG,MAAM,EAAI;YAAE,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAClD,CAAC,CAAC;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,MAAM,EAAE,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACvG,UAAU,EAAE,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAC1H,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxD,CAAC;AAEF,qBAAa,QAAQ;IACP,OAAO,CAAC,KAAK;IAAa,OAAO,CAAC,KAAK;gBAA/B,KAAK,EAAE,SAAS,EAAU,KAAK,EAAE,KAAK;IAEpD,gBAAgB,CAAC,IAAI,EAAE,MAAM;IAG7B,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE;IAIrC,kEAAkE;IAC5D,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM;CAuDnC"}
+{"version":3,"file":"receiver.d.ts","sourceRoot":"","sources":["../../src/notes/receiver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,KAAK,KAAK,GAAG;IACX,SAAS,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QACzC,QAAQ,EAAE;YAAE,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QACnD,MAAM,EAAI;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,KAAK,MAAM,EAAE,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;SAAE,EAAE,CAAC;QACjG,MAAM,EAAI;YAAE,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAClD,CAAC,CAAC;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,MAAM,EAAE,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACvG,UAAU,EAAE,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAC1H,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxD,CAAC;AAGF,qBAAa,QAAQ;IACP,OAAO,CAAC,KAAK;IAAa,OAAO,CAAC,KAAK;gBAA/B,KAAK,EAAE,SAAS,EAAU,KAAK,EAAE,KAAK;IAEpD,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM;CAsDnC"}

package/dist/notes/receiver.js

@@ -1,3 +1,4 @@
+// src/notes/receiver.ts
 export class Receiver {
     store;
     chain;
@@ -5,20 +6,11 @@ export class Receiver {
         this.store = store;
         this.chain = chain;
     }
-    async stageDepositNote(note) {
-        await this.store.addStagedNotes([{ ...note, status: 'STAGED' }]);
-    }
-    async stageItOutNotes(notes) {
-        await this.store.addStagedNotes(notes.map(n => ({ ...n, status: 'STAGED' })));
-    }
-    /** One-shot reconcile. Call from a small loop for “always-on”. */
     async reconcile(fromBlock) {
         const ev = await this.chain.getEvents(fromBlock);
-        // 1) record spents
         if (ev.spents.length) {
             await this.store.recordSpents(ev.spents.map(s => ({ nf: s.nf, blockNumber: s.block, at: Date.now() })));
         }
-        // 2) inclusion for staged notes → SPENDABLE
         const staged = await this.store.listStagedNotes();
         const includedNow = new Set();
         if (staged.length) {
@@ -31,18 +23,17 @@ export class Receiver {
                     continue;
                 for (let i = 0; i < batch.leaves.length; i++) {
                     const c = batch.leaves[i];
-                    if (!stagedByCommit.has(c))
+                    const st = stagedByCommit.get(c);
+                    if (!st)
                         continue;
                     const index = batch.start + i;
-                    // We now trust the indexer + /proof service for membership.
-                    // No need to recompute paths here.
+                    // ✅ also persist the root/index only if staged note exists (you already do)
                     await this.store.markSpendable(c, index, root);
                     includedNow.add(c);
                     stagedByCommit.delete(c);
                 }
             }
         }
-        // 3) if an intent’s all outputs landed, clear it
         const b = this.store['body'];
         if (b?.outByIntent) {
             for (const [intentId, expected] of Object.entries(b.outByIntent)) {
@@ -51,7 +42,6 @@ export class Receiver {
                 }
             }
         }
-        // 4) advance cursor to the latest block we saw
         const maxBlock = Math.max(0, ...ev.newRoots.map(x => x.block), ...ev.leaves.map(x => x.block), ...ev.spents.map(x => x.block));
         if (maxBlock > 0)
             await this.store.setLastProcessedBlock(maxBlock);

package/dist/notes/store.d.ts

@@ -1,18 +1,28 @@
 import type { NoteV1, VaultBlobV1, SpentRecord } from '../types/NoteStoreTypes.js';
+export type NoteStoreSyncFn = (fromBlock?: number) => Promise<void>;
 export declare class NoteStore {
     private persist;
     private header;
     private body;
     private key;
+    private _syncFn;
     constructor(persist: {
         readBlob: () => Promise<VaultBlobV1 | null>;
         writeBlob: (blob: VaultBlobV1) => Promise<void>;
     });
+    /** App/provider wires this to Receiver.reconcile(). */
+    setSync(fn: NoteStoreSyncFn | null): void;
+    /** Best-effort; no-op if not wired. */
+    sync(fromBlock?: number): Promise<void>;
+    /** Alias for your vocabulary. */
+    reconcile(fromBlock?: number): Promise<void>;
     unlock(passphrase: string): Promise<void>;
     private save;
     private getBody;
     listSpendable(filter?: {
         assetId?: bigint;
+        chainId?: number;
+        pool?: `0x${string}`;
     }): NoteV1[];
     getByCommitment(c: `0x${string}`): NoteV1 | undefined;
     /** Link an input NF to the input note we’re spending, for auto-SPENT later. */

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/notes/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EACN,WAAW,EAGX,WAAW,EACZ,MAAM,4BAA4B,CAAC;AAIpC,qBAAa,SAAS;IAMlB,OAAO,CAAC,OAAO;IALjB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,GAAG,CAA2B;gBAG5B,OAAO,EAAE;QACf,QAAQ,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;QAC5C,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACjD;IAGG,MAAM,CAAC,UAAU,EAAE,MAAM;YA4CjB,IAAI;IAOlB,OAAO,CAAC,OAAO;IAKf,aAAa,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAI3C,eAAe,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE;IAMhC,+EAA+E;IACzE,gBAAgB,CAAC,MAAM,EAAE;QAC7B,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;QAClB,UAAU,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;KAC7B;IAYD,kFAAkF;IAC5E,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,EAAE;IAQtE,oBAAoB,CAAC,QAAQ,EAAE,MAAM;IAQ3C,+DAA+D;IACzD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE;IAyB9B,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK1C,yDAAyD;IACnD,aAAa,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE;IAcjF,YAAY,IAAI,MAAM,EAAE;IAKxB,yEAAyE;IACnE,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE;IAyBlC,WAAW,CAAC,EAAE,EAAE,KAAK,MAAM,EAAE;IAK7B,SAAS,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM;IAe5E,qBAAqB,CAAC,KAAK,EAAE,MAAM;IAKzC,qBAAqB,IAAI,MAAM,GAAG,SAAS;IAKrC,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;IAKvC,eAAe,CAAC,IAAI,EAAE,WAAW;IAOvC,MAAM;IAmBN,mCAAmC;YACrB,OAAO;CAKtB"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/notes/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,MAAM,EACN,WAAW,EAGX,WAAW,EACZ,MAAM,4BAA4B,CAAC;AAIpC,MAAM,MAAM,eAAe,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAGpE,qBAAa,SAAS;IAQlB,OAAO,CAAC,OAAO;IAPjB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,GAAG,CAA2B;IAEtC,OAAO,CAAC,OAAO,CAAgC;gBAGrC,OAAO,EAAE;QACf,QAAQ,EAAE,MAAM,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;QAC5C,SAAS,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACjD;IAGH,uDAAuD;IACvD,OAAO,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAIlC,uCAAuC;IACjC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM;IAI7B,iCAAiC;IAC3B,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM;IAI5B,MAAM,CAAC,UAAU,EAAE,MAAM;YA2CjB,IAAI;IAQlB,OAAO,CAAC,OAAO;IAKf,aAAa,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;KAAE;IAiBnF,eAAe,CAAC,CAAC,EAAE,KAAK,MAAM,EAAE;IAOhC,+EAA+E;IACzE,gBAAgB,CAAC,MAAM,EAAE;QAC7B,EAAE,EAAE,KAAK,MAAM,EAAE,CAAC;QAClB,UAAU,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;KAC7B;IAYD,kFAAkF;IAC5E,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,EAAE;IAQtE,oBAAoB,CAAC,QAAQ,EAAE,MAAM;IAQ3C,+DAA+D;IACzD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE;IAyB9B,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK1C,yDAAyD;IACnD,aAAa,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE;IAcjF,YAAY,IAAI,MAAM,EAAE;IAKxB,yEAAyE;IACnE,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE;IAyBlC,WAAW,CAAC,EAAE,EAAE,KAAK,MAAM,EAAE;IAK7B,SAAS,CAAC,UAAU,EAAE,KAAK,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM;IAe5E,qBAAqB,CAAC,KAAK,EAAE,MAAM;IAKzC,qBAAqB,IAAI,MAAM,GAAG,SAAS;IAKrC,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;IAKvC,eAAe,CAAC,IAAI,EAAE,WAAW;IAOvC,MAAM;IAmBN,mCAAmC;YACrB,OAAO;CAKtB"}

package/dist/notes/store.js

@@ -5,9 +5,22 @@ export class NoteStore {
     header = null;
     body = null;
     key = null;
+    _syncFn = null;
     constructor(persist) {
         this.persist = persist;
     }
+    /** App/provider wires this to Receiver.reconcile(). */
+    setSync(fn) {
+        this._syncFn = fn;
+    }
+    /** Best-effort; no-op if not wired. */
+    async sync(fromBlock) {
+        await this._syncFn?.(fromBlock);
+    }
+    /** Alias for your vocabulary. */
+    async reconcile(fromBlock) {
+        await this.sync(fromBlock);
+    }
     async unlock(passphrase) {
         const blob = await this.persist.readBlob();
         if (!blob) {
@@ -42,7 +55,6 @@ export class NoteStore {
             m, t, p, dkLen: 32,
         });
         const body = decryptBlob(key, blob);
-        // ensure new fields exist
         if (!body.pendingLinks)
             body.pendingLinks = [];
         if (!body.outByIntent)
@@ -65,8 +77,19 @@ export class NoteStore {
         return this.body;
     }
     listSpendable(filter) {
-        const notes = this.getBody().notes.filter((n) => n.status === 'SPENDABLE');
-        return filter?.assetId ? notes.filter((n) => n.assetId === filter.assetId) : notes;
+        const b = this.getBody();
+        let notes = b.notes.filter((n) => n.status === 'SPENDABLE');
+        if (typeof filter?.chainId === 'number') {
+            notes = notes.filter((n) => n.chainId === filter.chainId);
+        }
+        if (filter?.pool) {
+            notes = notes.filter((n) => n.pool === filter.pool);
+        }
+        if (filter?.assetId != null) {
+            const want = BigInt(filter.assetId);
+            notes = notes.filter((n) => BigInt(n.assetId) === want);
+        }
+        return notes;
     }
     getByCommitment(c) {
         return this.getBody().notes.find((n) => n.commitment === c);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n3-sdk",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "description": "N3 SDK: data (GraphQL/WS) + exchange actions + notes/receiver utilities",
   "type": "module",
   "license": "MIT",