@shieldedtech/moth-wallet 0.2.0

package/dist/sync/preseed.js

@@ -0,0 +1,365 @@
+// Pre-seed optimization for newly generated wallets.
+// Syncs an empty reference wallet to chain tip once per network, then
+// copies its state snapshot to new wallets with swapped keys.
+// This avoids the full genesis scan for shielded + unshielded sub-wallets.
+// Dust wallet always syncs from genesis (see comment below).
+// Architecture follows mn-tui. See NOTICE for attribution.
+// Key derivation now flows through deriveWalletKeys (Option A); the reference
+// state persists through the async SyncStateStore (browser-safe), so v8's
+// node:fs pre-seed bridge is not used here.
+import { generateMnemonic24, mnemonicToSeed } from '../wallet/mnemonic.js';
+import { createKeystore, PublicKey } from '@midnightntwrk/wallet-sdk/unshielded';
+import { setNetworkId } from '@midnight-ntwrk/midnight-js/network-id';
+import { startWalletSync, resolveSyncStore } from './wallet-sync.js';
+import { emptyRefHeightKey, emptyRefMnemonicKey, emptyRefStateKey, EMPTY_REF_WALLET } from './sync-store.js';
+import { IndexerClient } from '../network/indexer-client.js';
+import { deriveWalletKeys } from './operations.js';
+// In-memory cache: network → synced reference states
+const refCache = new Map();
+const refInFlight = new Map();
+/**
+ * How long a deliberate reference build may take before giving up. Dust
+ * dominates: it streams the whole chain (~1.4M events on preprod at a few
+ * hundred per second), so this has to be generous. A build that times out
+ * leaves its partial state in the store, and the next attempt resumes from it.
+ */
+const REF_BUILD_TIMEOUT_MS = 2 * 60 * 60_000;
+function loadRefState(store, networkId, part) {
+    return store.get(emptyRefStateKey(networkId, part));
+}
+/**
+ * The applied index a serialized sub-wallet snapshot resumes from.
+ *
+ * `offset` is what the SDK writes from `progress.appliedIndex` and reads back as
+ * `appliedIndex` on restore (see makeDefaultV1SerializationCapability in the
+ * dust wallet's Serialization.ts). An offset of 0 is the "nothing applied yet"
+ * sentinel: the sync then opens its subscription with no cursor and streams from
+ * genesis. So a reference whose offset is 0 seeds nothing, however complete the
+ * rest of the snapshot looks.
+ */
+function snapshotOffset(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed.offset === undefined ? 0n : BigInt(parsed.offset);
+    }
+    catch {
+        return 0n;
+    }
+}
+/**
+ * Read the cached reference states, but only accept them if they actually
+ * reached chain tip. Guards against the failure mode this cache had for months:
+ * the reference was serialized moments after starting, so every part sat at
+ * offset 0 and new wallets full-scanned anyway while being told they were
+ * pre-seeded "at chain tip".
+ */
+async function loadUsableRefStates(store, networkId) {
+    const [shielded, unshielded, dust] = await Promise.all([
+        loadRefState(store, networkId, 'shielded'),
+        loadRefState(store, networkId, 'unshielded'),
+        loadRefState(store, networkId, 'dust'),
+    ]);
+    if (!shielded || !unshielded || !dust)
+        return null;
+    // Dust is the expensive one and the one whose cursor we are really after;
+    // shielded is checked too so a half-built reference is not treated as warm.
+    if (snapshotOffset(dust) <= 0n || snapshotOffset(shielded) <= 0n)
+        return null;
+    // No recorded height means no way to prove the reference is not newer than a
+    // given wallet's birthday, so it cannot be used safely at all.
+    const rawHeight = await store.get(emptyRefHeightKey(networkId));
+    const height = rawHeight ? Number(rawHeight) : 0;
+    if (!Number.isFinite(height) || height <= 0)
+        return null;
+    return { shielded, unshielded, dust, height };
+}
+/** Wait until the wallet reports fully synced, or give up. */
+function waitForTip(synced, timeoutMs) {
+    return new Promise((resolve) => {
+        let settled = false;
+        let unsubscribe;
+        const finish = (reached) => {
+            if (settled)
+                return;
+            settled = true;
+            unsubscribe?.();
+            resolve(reached);
+        };
+        const timer = setTimeout(() => finish(false), timeoutMs);
+        // subscribe() replays the current balances synchronously, so an
+        // already-synced wallet settles here without waiting for a fresh emission.
+        const stop = synced.subscribe((b) => {
+            if (b.synced) {
+                clearTimeout(timer);
+                finish(true);
+            }
+        });
+        unsubscribe = stop;
+        if (settled)
+            stop();
+    });
+}
+/**
+ * Ensure an empty reference wallet is synced to chain tip for this network.
+ * The first call per network syncs from genesis (or restores from cache).
+ * Subsequent calls return the cached result immediately.
+ */
+// NOTE: v8 had a loadFreshRefFromDisk() that reused a recently-warmed on-disk
+// reference across daemon processes by stat-ing ~/.moth .dat mtimes. Under the
+// async SyncStateStore model that cross-process reuse is subsumed by the store
+// itself: buildEmptyRefCache reuses the reference mnemonic from the store and
+// startWalletSync restores the cached ref state from it, so a second process
+// resumes from cache rather than genesis without any node:fs freshness probe.
+export async function ensureEmptyRefCache(network, onProgress, store, 
+/**
+ * Build the reference if none is warm yet. OFF by default, and deliberately
+ * so: building means syncing an empty wallet to chain tip, which dust makes a
+ * tens-of-minutes job. On the wallet-startup path that would block the user's
+ * own wallet from starting, which is far worse than letting it sync from
+ * genesis in the background. Callers that mean to pay the cost use
+ * warmEmptyRefCache().
+ */
+opts) {
+    const cached = refCache.get(network.id);
+    if (cached)
+        return cached;
+    const inFlight = refInFlight.get(network.id);
+    if (inFlight)
+        return inFlight;
+    // A reference already synced to tip by an earlier run (or another process)
+    // is usable immediately, with no sync of any kind.
+    const resolved = await resolveSyncStore(store);
+    const warm = await loadUsableRefStates(resolved, network.id);
+    if (warm) {
+        refCache.set(network.id, warm);
+        return warm;
+    }
+    if (!opts?.build) {
+        onProgress?.('Pre-seed: no reference at chain tip for this network — syncing from genesis');
+        return null;
+    }
+    const promise = buildEmptyRefCache(network, onProgress, store, opts?.onWarmProgress);
+    refInFlight.set(network.id, promise);
+    try {
+        const result = await promise;
+        if (result)
+            refCache.set(network.id, result);
+        return result;
+    }
+    finally {
+        refInFlight.delete(network.id);
+    }
+}
+/**
+ * Build (or resume building) the empty reference wallet for a network, syncing
+ * it all the way to chain tip so it can actually pre-seed new wallets.
+ *
+ * This is the slow one: the first build walks the whole chain, which dust makes
+ * a tens-of-minutes job on preprod. It is worth paying once per network per
+ * machine, because afterwards every new wallet — and every dust rebuild — starts
+ * at tip instead of genesis. Intended for a background task or an explicit
+ * command, never the wallet-startup path.
+ */
+/**
+ * Sync an EXISTING reference forward to chain tip, instead of rebuilding it.
+ *
+ * ensureEmptyRefCache short-circuits on a warm reference, so before this the only
+ * way to update one was to delete it and walk the chain again — 53.6 min on
+ * preprod. That was never a limitation of the mechanism, only of the entry
+ * points: buildEmptyRefCache already resumes from whatever reference state the
+ * store holds (it syncs under EMPTY_REF_WALLET, and startWalletSync restores that
+ * wallet's cache like any other), so catching up costs the drift and nothing more.
+ *
+ * A stale reference is safe to use — it only means more catch-up for the wallets
+ * it seeds, at roughly half a second per hour of age — so this is an optimisation,
+ * not a repair. Run it before cutting a release, or on a schedule.
+ */
+export async function refreshEmptyRefCache(network, onProgress, store, onWarmProgress) {
+    // Drop the in-process memo so the refreshed state is what later callers see.
+    refCache.delete(network.id);
+    // Share an in-flight build rather than starting a second chain walk beside it.
+    const inFlight = refInFlight.get(network.id);
+    if (inFlight)
+        return inFlight;
+    const promise = buildEmptyRefCache(network, onProgress, store, onWarmProgress);
+    refInFlight.set(network.id, promise);
+    try {
+        const result = await promise;
+        if (result)
+            refCache.set(network.id, result);
+        return result;
+    }
+    finally {
+        refInFlight.delete(network.id);
+    }
+}
+export function warmEmptyRefCache(network, onProgress, store, onWarmProgress) {
+    return ensureEmptyRefCache(network, onProgress, store, { build: true, onWarmProgress });
+}
+/**
+ * Whether this network has a reference at chain tip, without building anything.
+ * Lets a UI distinguish "not started" from "in progress" from "done" — a build
+ * runs for an hour, so reporting it as perpetually in progress is misleading.
+ */
+export async function preseedReferenceStatus(network, store) {
+    const resolved = await resolveSyncStore(store);
+    const states = await loadUsableRefStates(resolved, network.id);
+    return { ready: states !== null, height: states?.height ?? null };
+}
+async function buildEmptyRefCache(network, onProgress, store, onWarmProgress) {
+    const resolved = await resolveSyncStore(store);
+    // Generate or reuse a reference mnemonic
+    // Reference wallet mnemonic — this wallet is never funded and exists only
+    // as an empty-at-tip cache for pre-seeding new wallets.
+    // SECURITY: Stored with owner-only permissions (0600). Do NOT fund this wallet.
+    const mnemonicKey = emptyRefMnemonicKey(network.id);
+    let mnemonic = (await resolved.get(mnemonicKey))?.trim();
+    if (mnemonic) {
+        onProgress?.('Pre-seed: reusing reference wallet');
+    }
+    else {
+        mnemonic = generateMnemonic24();
+        await resolved.put(mnemonicKey, mnemonic);
+        onProgress?.('Pre-seed: generated new reference wallet (first sync may be slow)');
+    }
+    // Derive seed + typed key bundle
+    const seed = await mnemonicToSeed(mnemonic);
+    const seedHex = Array.from(seed).map((b) => b.toString(16).padStart(2, '0')).join('');
+    const referenceKeys = deriveWalletKeys(seedHex);
+    // Seed is no longer needed past derivation — zero the local buffer.
+    seed.fill(0);
+    onProgress?.('Pre-seed: syncing reference wallet to chain tip...');
+    try {
+        // Sync the reference wallet under EMPTY_REF_WALLET into the shared async
+        // store; startWalletSync persists each sub-wallet's state there, so
+        // loadRefState reads it straight back — no separate fs promotion needed.
+        const synced = await startWalletSync(referenceKeys, network, onProgress, EMPTY_REF_WALLET, undefined, undefined, {
+            syncStore: resolved,
+        });
+        // Wait for the reference to actually reach tip before serializing it.
+        // startWalletSync resolves on the first balance emission (or a 5s timeout),
+        // so stopping straight away — as this did — serialized an empty wallet:
+        // every part at offset 0, which the SDK reads as "stream from genesis". The
+        // pre-seed then reported success while seeding nothing, and dust paid a full
+        // chain walk on every new wallet.
+        const unsubscribeProgress = onWarmProgress
+            ? synced.subscribe((b) => onWarmProgress({
+                applied: b.subProgress.dust.applied,
+                total: b.subProgress.dust.total,
+                synced: b.synced,
+            }))
+            : undefined;
+        const reachedTip = await waitForTip(synced, REF_BUILD_TIMEOUT_MS);
+        unsubscribeProgress?.();
+        await synced.stop();
+        if (!reachedTip) {
+            // stop() persisted the partial state, so the next build resumes from it
+            // rather than restarting. Refuse to hand it out in the meantime.
+            onProgress?.('Pre-seed: reference did not reach chain tip in time — partial progress saved for the next attempt');
+            return null;
+        }
+        // Record the height this reference represents, so callers can refuse to
+        // seed wallets older than it. Read AFTER the sync finished: the tip may have
+        // advanced past what the reference actually applied, which overstates the
+        // height and therefore only ever makes the birthday check stricter.
+        try {
+            const tip = await new IndexerClient(network.indexerUrl).getBlock();
+            if (tip?.height)
+                await resolved.put(emptyRefHeightKey(network.id), String(tip.height));
+        }
+        catch {
+            // Without a height the reference is unusable — better than guessing.
+            onProgress?.('Pre-seed: could not record the reference height; reference will not be used');
+        }
+        // Re-read through the same usability check the warm path uses: reaching tip
+        // is necessary but the serialized cursors are what actually get copied, so
+        // verify them rather than trusting the sync's own verdict.
+        const states = await loadUsableRefStates(resolved, network.id);
+        if (!states) {
+            onProgress?.('Pre-seed: reference sync completed but its state carries no chain cursor');
+            return null;
+        }
+        onProgress?.('Pre-seed: reference wallet ready at chain tip');
+        return states;
+    }
+    catch (err) {
+        onProgress?.(`Pre-seed: reference sync failed — ${err}`);
+        return null;
+    }
+}
+/**
+ * Pre-seed a newly generated wallet's sync state from the empty reference.
+ *
+ * - Shielded: reference's Zswap tree + offset, new wallet's public keys, empty coins
+ * - Unshielded: new wallet's public key, reference's indexer cursor, empty UTXOs
+ * - Dust: reference state as-is with the new wallet's dust public key swapped in.
+ *   Dust ledger events are global (the indexer streams `dustLedgerEvents` keyed
+ *   by a global id), and a wallet holding no NIGHT has no designations of its
+ *   own to preserve, so the reference's generation tree and cursor transfer
+ *   directly. This is the expensive one to get right: without it dust walks the
+ *   whole chain, which is minutes-to-an-hour where shielded takes seconds.
+ */
+export function preSeedNewWallet(walletKeys, networkId, emptyRef) {
+    try {
+        setNetworkId(networkId);
+        // Keys arrive pre-derived (Option A) — no seed to re-derive from.
+        const shieldedSecretKeys = walletKeys.shieldedSecretKeys;
+        const ks = createKeystore(walletKeys.nightExternalKey, networkId);
+        const pk = PublicKey.fromKeyStore(ks);
+        // Parse reference states
+        const refSh = JSON.parse(emptyRef.shielded);
+        const refUn = JSON.parse(emptyRef.unshielded);
+        // Shielded: swap public keys, keep reference's tree + offset
+        const shieldedSnap = {
+            publicKeys: {
+                coinPublicKey: shieldedSecretKeys.coinPublicKey,
+                encryptionPublicKey: shieldedSecretKeys.encryptionPublicKey,
+            },
+            state: refSh.state,
+            protocolVersion: refSh.protocolVersion,
+            networkId,
+            coinHashes: {},
+        };
+        if (refSh.offset !== undefined)
+            shieldedSnap.offset = refSh.offset;
+        // Unshielded: swap public key, keep reference's indexer cursor
+        const unshieldedSnap = {
+            publicKey: { publicKey: pk.publicKey, addressHex: pk.addressHex, address: pk.address },
+            state: { availableUtxos: [], pendingUtxos: [] },
+            protocolVersion: refUn.protocolVersion,
+            networkId,
+        };
+        if (refUn.appliedId !== undefined)
+            unshieldedSnap.appliedId = refUn.appliedId;
+        // Dust: For a new wallet with no NIGHT UTXOs, the reference dust state is
+        // usable as-is — there are no wallet-specific designations to swap.
+        // The dust wallet just needs the global generation tree at chain tip to
+        // resume syncing from there instead of genesis.
+        let dustSnap;
+        try {
+            const refDust = JSON.parse(emptyRef.dust);
+            // Swap in the new wallet's dust key, keep everything else. The public
+            // key is a bigint; snapshots store it as a decimal string (JSON.stringify
+            // throws on a raw bigint) — hence the .toString().
+            dustSnap = JSON.stringify({
+                publicKey: { publicKey: walletKeys.dustSecretKey.publicKey.toString() },
+                state: refDust.state,
+                protocolVersion: refDust.protocolVersion,
+                networkId,
+                offset: refDust.offset,
+            });
+        }
+        catch {
+            // Dust preseed failure is non-fatal — wallet will sync dust from genesis
+        }
+        return {
+            shielded: JSON.stringify(shieldedSnap),
+            unshielded: JSON.stringify(unshieldedSnap),
+            dust: dustSnap,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=preseed.js.map

package/dist/sync/preseed.js.map

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

package/dist/sync/progress.d.ts

@@ -0,0 +1,45 @@
+export interface SubProgressSnapshot {
+    /** Events/indices applied so far. */
+    applied: number;
+    /** Events/indices the chain currently has for this sub-wallet. */
+    total: number;
+}
+/** Which sub-wallet the reported percentage belongs to. */
+export type SubWallet = 'shielded' | 'unshielded' | 'dust';
+export interface OverallProgressInput {
+    shielded: SubProgressSnapshot;
+    unshielded: SubProgressSnapshot;
+    dust: SubProgressSnapshot;
+    shieldedSynced: boolean;
+    unshieldedSynced: boolean;
+    dustSynced: boolean;
+    /** The facade's own verdict: every sub-wallet strictly complete. */
+    synced: boolean;
+    /** Time since this sync started, for the ETA. 0 disables the estimate. */
+    elapsedMs: number;
+}
+/**
+ * Progress is the SLOWEST sub-wallet, never the shielded one alone.
+ *
+ * This used to read shielded indices only, on the stated assumption that shielded
+ * was the slowest. It is not — dust is, by two orders of magnitude: a full dust
+ * walk is ~1.4M events at a few hundred per second, where shielded covers the same
+ * range in under a minute. Observed consequence on preprod: a wallet reporting
+ * "100% (0s remaining)" with dust at 178,029/1,395,558 and roughly 69 minutes of
+ * work left — worse than reporting nothing, because it stops the user waiting.
+ */
+export declare function overallSyncProgress(input: OverallProgressInput): {
+    percentage: number;
+    etaSeconds: number | null;
+    /**
+     * The sub-wallet the percentage came from — the slowest one, and null once
+     * everything is synced.
+     *
+     * Returned because reporting the minimum without saying whose it is produces
+     * a genuinely confusing log: a timeline reading "syncing 27%" beside a UI
+     * showing shielded and unshielded at 100% looks like a contradiction rather
+     * than like dust being the constraint.
+     */
+    slowest: SubWallet | null;
+};
+//# sourceMappingURL=progress.d.ts.map

package/dist/sync/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/sync/progress.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2DAA2D;AAC3D,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;;;;;OAQG;IACH,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;CAC3B,CAoCA"}

package/dist/sync/progress.js

@@ -0,0 +1,51 @@
+// Overall sync progress, derived from the three sub-wallets' indices.
+//
+// WASM-free on purpose: wallet-sync.ts imports the ledger and the wallet SDK, so
+// keeping this arithmetic in its own module lets it be unit-tested without
+// loading WASM — the same split as types/tokens.ts and the extension's
+// dust-heal.ts.
+/**
+ * Progress is the SLOWEST sub-wallet, never the shielded one alone.
+ *
+ * This used to read shielded indices only, on the stated assumption that shielded
+ * was the slowest. It is not — dust is, by two orders of magnitude: a full dust
+ * walk is ~1.4M events at a few hundred per second, where shielded covers the same
+ * range in under a minute. Observed consequence on preprod: a wallet reporting
+ * "100% (0s remaining)" with dust at 178,029/1,395,558 and roughly 69 minutes of
+ * work left — worse than reporting nothing, because it stops the user waiting.
+ */
+export function overallSyncProgress(input) {
+    if (input.synced)
+        return { percentage: 1, etaSeconds: 0, slowest: null };
+    // A sub-wallet with nothing relevant to apply (total 0) is complete, not
+    // stalled — count it as 1 so it cannot drag the minimum to zero. A fresh
+    // wallet's unshielded progress is legitimately 0/0.
+    const fraction = (sub, done) => {
+        if (done)
+            return 1;
+        return sub.total > 0 ? Math.min(1, sub.applied / sub.total) : 1;
+    };
+    const fractions = [
+        { sub: 'shielded', value: fraction(input.shielded, input.shieldedSynced) },
+        { sub: 'unshielded', value: fraction(input.unshielded, input.unshieldedSynced) },
+        { sub: 'dust', value: fraction(input.dust, input.dustSynced) },
+    ];
+    // Ties resolve to the earlier entry, so a fresh wallet where everything sits
+    // at 0 reports 'shielded' rather than an arbitrary one.
+    const binding = fractions.reduce((a, b) => (b.value < a.value ? b : a));
+    const slowest = binding.sub;
+    let percentage = binding.value;
+    // Never round up to 100% while not synced: rendering a near-complete fraction
+    // as "100% (0s remaining)" is the specific lie this function exists to remove.
+    if (percentage >= 0.995)
+        percentage = 0.99;
+    // ETA against the same fraction, so it reflects whichever sub-wallet is behind
+    // rather than one that finished a minute in.
+    let etaSeconds = null;
+    if (input.elapsedMs > 0 && percentage > 0.01) {
+        const totalEstMs = input.elapsedMs / percentage;
+        etaSeconds = Math.max(0, Math.round((totalEstMs - input.elapsedMs) / 1000));
+    }
+    return { percentage, etaSeconds, slowest };
+}
+//# sourceMappingURL=progress.js.map

package/dist/sync/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/sync/progress.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,iFAAiF;AACjF,2EAA2E;AAC3E,uEAAuE;AACvE,gBAAgB;AAyBhB;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA2B;IAc7D,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAEzE,yEAAyE;IACzE,yEAAyE;IACzE,oDAAoD;IACpD,MAAM,QAAQ,GAAG,CAAC,GAAwB,EAAE,IAAa,EAAU,EAAE;QACnE,IAAI,IAAI;YAAE,OAAO,CAAC,CAAC;QACnB,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC;IAEF,MAAM,SAAS,GAA6C;QAC1D,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC,EAAE;QAC1E,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,gBAAgB,CAAC,EAAE;QAChF,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE;KAC/D,CAAC;IACF,6EAA6E;IAC7E,wDAAwD;IACxD,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAE5B,IAAI,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC;IAE/B,8EAA8E;IAC9E,+EAA+E;IAC/E,IAAI,UAAU,IAAI,KAAK;QAAE,UAAU,GAAG,IAAI,CAAC;IAE3C,+EAA+E;IAC/E,6CAA6C;IAC7C,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,KAAK,CAAC,SAAS,GAAG,CAAC,IAAI,UAAU,GAAG,IAAI,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC;QAChD,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC"}

package/dist/sync/sdk-dedup.d.ts

@@ -0,0 +1,53 @@
+type Updateish<T = unknown> = {
+    readonly id: number | bigint | string;
+    readonly maxId: number | bigint | string;
+    readonly protocolVersion?: number | bigint;
+} & T;
+type WrappedUpdate<U> = {
+    readonly updates: ReadonlyArray<U>;
+    readonly [key: string]: unknown;
+};
+type ApplyUpdateFn<S, U> = (state: S, wrappedUpdate: WrappedUpdate<U>) => readonly [S, {
+    changes: unknown[];
+    protocolVersion: number;
+}];
+interface Capability<S, U> {
+    applyUpdate: ApplyUpdateFn<S, U>;
+}
+/**
+ * Walk the updates array and split into "already applied" vs "still to
+ * apply" against the wallet's current appliedIndex. The boundary event
+ * — the one whose id equals appliedIndex — counts as already applied.
+ */
+declare function partitionByAppliedIndex<U extends Updateish>(updates: ReadonlyArray<U>, appliedIndex: bigint): {
+    fresh: ReadonlyArray<U>;
+    droppedCount: number;
+};
+declare function makeDedupingApplyUpdate<S extends {
+    progress: {
+        appliedIndex: bigint;
+        [k: string]: unknown;
+    };
+    protocolVersion: number | bigint;
+}, U extends Updateish>(base: Capability<S, U>, updateProgress: (state: S, patch: {
+    highestRelevantWalletIndex: bigint;
+    isConnected: boolean;
+}) => S): ApplyUpdateFn<S, U>;
+/**
+ * Build a V1Builder for the shielded wallet whose syncCapability filters
+ * already-applied events before handing them to the SDK's
+ * makeEventsSyncCapability. Pass to CustomShieldedWallet(cfg, builder).
+ */
+export declare function dedupingShieldedBuilder(): unknown;
+/**
+ * Build a V1Builder for the dust wallet whose syncCapability filters
+ * already-applied events before handing them to the SDK's
+ * makeDefaultSyncCapability. Pass to CustomDustWallet(cfg, builder).
+ */
+export declare function dedupingDustBuilder(): unknown;
+export declare const __TEST_ONLY__: {
+    partitionByAppliedIndex: typeof partitionByAppliedIndex;
+    makeDedupingApplyUpdate: typeof makeDedupingApplyUpdate;
+};
+export {};
+//# sourceMappingURL=sdk-dedup.d.ts.map

package/dist/sync/sdk-dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-dedup.d.ts","sourceRoot":"","sources":["../../src/sync/sdk-dedup.ts"],"names":[],"mappings":"AAuCA,KAAK,SAAS,CAAC,CAAC,GAAG,OAAO,IAAI;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5C,GAAG,CAAC,CAAC;AAEN,KAAK,aAAa,CAAC,CAAC,IAAI;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACnC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,aAAa,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,EAAE;IAAC,OAAO,EAAE,OAAO,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAC,CAAC,CAAC;AAEtI,UAAU,UAAU,CAAC,CAAC,EAAE,CAAC;IACvB,WAAW,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,iBAAS,uBAAuB,CAAC,CAAC,SAAS,SAAS,EAClD,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EACzB,YAAY,EAAE,MAAM,GACnB;IAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAC,CAMjD;AAED,iBAAS,uBAAuB,CAAC,CAAC,SAAS;IAAC,QAAQ,EAAE;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAC,CAAC;IAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAA;CAAC,EAAE,CAAC,SAAS,SAAS,EACxJ,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EACtB,cAAc,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE;IAAC,0BAA0B,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAC,KAAK,CAAC,GACjG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CA6BrB;AAQD;;;;GAIG;AAUH,wBAAgB,uBAAuB,IAAI,OAAO,CAkBjD;AAED;;;;GAIG;AAEH,wBAAgB,mBAAmB,IAAI,OAAO,CAoB7C;AAID,eAAO,MAAM,aAAa;;;CAGzB,CAAC"}