@shieldedtech/moth-wallet 0.2.0

package/dist/sync/operations.js

@@ -0,0 +1,395 @@
+// Wallet operations via WalletFacade — send, designate, dedesignate.
+// Architecture follows mn-tui's wallet.ts pattern. See NOTICE for attribution.
+import * as Rx from 'rxjs';
+import * as ledger from '@midnight-ntwrk/ledger-v8';
+import { MidnightBech32m, ShieldedAddress, UnshieldedAddress, DustAddress, } from '@midnightntwrk/wallet-sdk/address-format';
+import { createKeystore } from '@midnightntwrk/wallet-sdk/unshielded';
+import { HDWallet, Roles } from '@midnightntwrk/wallet-sdk/hd';
+import { setNetworkId } from '@midnight-ntwrk/midnight-js/network-id';
+import { NIGHT_TOKEN_ID } from './wallet-sync.js';
+import { estimateRegistrationAffordability, DustRegistrationNotYetError, } from './dust-registration-estimate.js';
+// Re-exported from the module that throws it, so a consumer importing the
+// registration API by subpath (packages/browser does) gets the error type it has
+// to catch from the same place — without also reaching for the estimate module.
+export { DustRegistrationNotYetError };
+// Multi-output transfer builder (kept from main): groups requests by kind so a
+// single transaction can carry several tokens/recipients — the extension's
+// batch send and the CLI both rely on it.
+function combinedTransfers(networkId, requests) {
+    const grouped = new Map();
+    for (const req of requests) {
+        const parsed = MidnightBech32m.parse(req.to);
+        const receiverAddress = req.type === 'unshielded'
+            ? parsed.decode(UnshieldedAddress, networkId)
+            : parsed.decode(ShieldedAddress, networkId);
+        const outputs = grouped.get(req.type) ?? [];
+        outputs.push({ type: req.tokenId, amount: req.amount, receiverAddress });
+        grouped.set(req.type, outputs);
+    }
+    // The map already pairs each kind with same-kind outputs; the cast collapses
+    // the inferred shape onto the SDK's discriminated CombinedTokenTransfer union.
+    return [...grouped.entries()].map(([type, outputs]) => ({ type, outputs }));
+}
+/**
+ * Derive the typed key bundle from a 64-char BIP-39 hex seed. Option A key
+ * model (v8's D-KM-3): callers derive once at unlock and discard the raw seed
+ * immediately — the bundle holds everything the write paths need, so the seed
+ * is never threaded through the daemon or the extension messaging layers.
+ */
+export function deriveWalletKeys(seedHex) {
+    const hdWallet = HDWallet.fromSeed(Buffer.from(seedHex, 'hex'));
+    if (hdWallet.type !== 'seedOk')
+        throw new Error('Invalid seed');
+    const result = hdWallet.hdWallet
+        .selectAccount(0)
+        .selectRoles([Roles.Zswap, Roles.NightExternal, Roles.Dust])
+        .deriveKeysAt(0);
+    if (result.type !== 'keysDerived')
+        throw new Error('Key derivation failed');
+    hdWallet.hdWallet.clear();
+    return {
+        shieldedSecretKeys: ledger.ZswapSecretKeys.fromSeed(result.keys[Roles.Zswap]),
+        dustSecretKey: ledger.DustSecretKey.fromSeed(result.keys[Roles.Dust]),
+        nightExternalKey: result.keys[Roles.NightExternal],
+    };
+}
+// Legacy private alias — internal callers that predate deriveWalletKeys.
+function deriveKeysFromSeed(seedHex) {
+    return deriveWalletKeys(seedHex);
+}
+/**
+ * Substrate tx-pool rejects a transaction whose hash is already in the pool
+ * with error 1013 "Transaction Already Imported". Because a finalized tx has a
+ * fixed hash, this fires whenever we resubmit identical bytes — which means the
+ * transaction already reached the node, so it should be treated as success.
+ */
+function isAlreadyImported(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return msg.includes('1013') || /already imported/i.test(msg);
+}
+/**
+ * A connection-level failure where the transaction likely never reached the
+ * node — the only case worth resending. A node that evaluated the transaction
+ * and rejected it (bad proof, insufficient funds, low priority, …) returns a
+ * deterministic verdict; resending the identical bytes only makes the user
+ * wait for the same answer, so those rejections must surface immediately.
+ */
+function isTransient(e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    return /disconnect|not connected|connection|websocket|socket hang up|time\s?d?\s?out|timeout|ECONN|ENOTFOUND|network|fetch failed|1006/i.test(msg);
+}
+/**
+ * Submit an already-finalized transaction, classifying failures so the user
+ * only waits through a retry when one could actually help:
+ *
+ * - "Already Imported" (1013): a prior attempt's identical bytes already reached
+ *   the pool — that IS submitted, so report success with the tx's own hash.
+ * - Transient connection failure: resend (the tx may never have arrived).
+ * - Any other error is the node's deterministic rejection: surface it at once,
+ *   without burning retries the user has to wait through.
+ */
+async function submitWithRetry(facade, finalized, attempts = 3, delayMs = 5_000) {
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+        try {
+            // The facade resolves to an intent identifier (`identifiers().at(-1)`),
+            // but everything downstream — indexer status queries, tx-history entries
+            // (WalletEntry.hash), explorers, and the activity feed's pending-row
+            // reconciliation — is keyed by the transaction hash. Return that.
+            await facade.submitTransaction(finalized);
+            return finalized.transactionHash();
+        }
+        catch (e) {
+            if (isAlreadyImported(e))
+                return finalized.transactionHash();
+            if (attempt === attempts || !isTransient(e))
+                throw e;
+            await new Promise((r) => setTimeout(r, delayMs));
+        }
+    }
+    throw new Error('unreachable');
+}
+/**
+ * Build, prove and sign a transfer, stopping short of submission.
+ * The dApp connector's makeTransfer/submitTransaction split needs the
+ * finalized transaction as a standalone artifact; sendTokens composes this
+ * with submission.
+ */
+export async function buildTransferTransaction(facade, keys, networkId, requests, onProgress) {
+    setNetworkId(networkId);
+    const ks = createKeystore(keys.nightExternalKey, networkId);
+    const transfers = combinedTransfers(networkId, requests);
+    const ttl = new Date(Date.now() + 30 * 60_000);
+    onProgress?.('building');
+    const recipe = await facade.transferTransaction(transfers, { shieldedSecretKeys: keys.shieldedSecretKeys, dustSecretKey: keys.dustSecretKey }, { ttl });
+    onProgress?.('proving');
+    const signed = await facade.signRecipe(recipe, (payload) => ks.signData(payload));
+    return facade.finalizeRecipe(signed);
+}
+/**
+ * Estimate the complete DUST fee for a transfer, including the balancing
+ * transaction that pays it. The facade's transfer builder books selected
+ * inputs even when fee payment is disabled, so the temporary base transaction
+ * is always reverted before returning.
+ */
+export async function estimateTransferFee(facade, keys, networkId, requests) {
+    setNetworkId(networkId);
+    const transfers = combinedTransfers(networkId, requests);
+    const ttl = new Date(Date.now() + 30 * 60_000);
+    const recipe = await facade.transferTransaction(transfers, { shieldedSecretKeys: keys.shieldedSecretKeys, dustSecretKey: keys.dustSecretKey }, { ttl, payFees: false });
+    try {
+        return await facade.estimateTransactionFee(recipe.transaction, keys.dustSecretKey, { ttl });
+    }
+    finally {
+        await facade.revertTransaction(recipe.transaction);
+    }
+}
+/**
+ * Submit a previously built transfer with retries.
+ */
+export async function submitFinalizedTransaction(facade, finalized) {
+    return submitWithRetry(facade, finalized);
+}
+/**
+ * Send tokens via the wallet facade using a pre-derived key bundle. Prefer this
+ * over {@link sendTokens} when the caller already holds WalletKeys (the daemon
+ * and the extension, which derive once at unlock and drop the seed — Option A /
+ * D-KM-3, docs/spec/wallet-service/05-key-management.md).
+ */
+export async function sendTokensWithKeys(facade, keys, networkId, requests, onProgress) {
+    const finalized = await buildTransferTransaction(facade, keys, networkId, requests, onProgress);
+    onProgress?.('submitting');
+    return submitFinalizedTransaction(facade, finalized);
+}
+/**
+ * Balance a dApp-supplied transaction (connector `balanceSealedTransaction` /
+ * `balanceUnsealedTransaction`): pay fees and add wallet inputs/outputs to
+ * remove imbalances, then prove + bind into a submit-ready FinalizedTransaction.
+ *
+ * `sealed` selects the input stage:
+ * - sealed   → Transaction<SignatureEnabled, Proof, Binding>    (FinalizedTransaction)
+ * - unsealed → Transaction<SignatureEnabled, Proof, PreBinding> (UnboundTransaction)
+ *
+ * The prove/finalize tail is the same as {@link buildTransferTransaction}.
+ */
+export async function balanceTransaction(facade, keys, networkId, txBytes, sealed, onProgress) {
+    setNetworkId(networkId);
+    const ks = createKeystore(keys.nightExternalKey, networkId);
+    const secretKeys = { shieldedSecretKeys: keys.shieldedSecretKeys, dustSecretKey: keys.dustSecretKey };
+    const ttl = new Date(Date.now() + 30 * 60_000);
+    onProgress?.('building');
+    const recipe = sealed
+        ? await facade.balanceFinalizedTransaction(ledger.Transaction.deserialize('signature', 'proof', 'binding', txBytes), secretKeys, { ttl })
+        : await facade.balanceUnboundTransaction(ledger.Transaction.deserialize('signature', 'proof', 'pre-binding', txBytes), secretKeys, { ttl });
+    onProgress?.('proving');
+    const signed = await facade.signRecipe(recipe, (payload) => ks.signData(payload));
+    return facade.finalizeRecipe(signed);
+}
+/**
+ * Build a swap intent (connector `makeIntent`): the wallet's half of a swap,
+ * providing `inputs` (spent) and `outputs` (sent to recipients). Returns the
+ * raw unproven, unbound transaction from the SDK's `initSwap` — deliberately
+ * NOT proven or bound, so the dApp can combine it with the counterparty's half
+ * before the combined transaction is proven, balanced, and submitted.
+ *
+ * NOTE: the connector's `intentId` option is not honored — the SDK's `initSwap`
+ * exposes no segment-id control, so callers cannot pin the intent's id or opt
+ * out of transaction merging.
+ */
+export async function buildSwapIntent(facade, keys, networkId, inputs, outputs, payFees, onProgress) {
+    setNetworkId(networkId);
+    const swapInputs = {};
+    for (const input of inputs) {
+        const bucket = (swapInputs[input.type] ??= {});
+        bucket[input.tokenId] = (bucket[input.tokenId] ?? 0n) + input.amount;
+    }
+    const grouped = new Map();
+    for (const out of outputs) {
+        const parsed = MidnightBech32m.parse(out.to);
+        const receiverAddress = out.type === 'unshielded'
+            ? parsed.decode(UnshieldedAddress, networkId)
+            : parsed.decode(ShieldedAddress, networkId);
+        const list = grouped.get(out.type) ?? [];
+        list.push({ type: out.tokenId, amount: out.amount, receiverAddress });
+        grouped.set(out.type, list);
+    }
+    const swapOutputs = [...grouped.entries()].map(([type, outs]) => ({ type, outputs: outs }));
+    const ttl = new Date(Date.now() + 30 * 60_000);
+    onProgress?.('building');
+    const recipe = await facade.initSwap(swapInputs, swapOutputs, { shieldedSecretKeys: keys.shieldedSecretKeys, dustSecretKey: keys.dustSecretKey }, { ttl, payFees });
+    return recipe.transaction;
+}
+/**
+ * Send tokens via the wallet facade. Convenience wrapper that derives a
+ * WalletKeys bundle from the seed and delegates to
+ * {@link sendTokensWithKeys}. Holds the seed in memory only for the
+ * duration of derivation — used by paths like the in-process `moth
+ * transfer` CLI command that already work in terms of seedHex.
+ */
+export async function sendTokens(facade, seedHex, networkId, requests, onProgress) {
+    return sendTokensWithKeys(facade, deriveWalletKeys(seedHex), networkId, requests, onProgress);
+}
+/**
+ * List the active wallet's NIGHT UTXOs (registered + unregistered).
+ * Waits for the unshielded sub-wallet to be strict-complete — does NOT gate on
+ * aggregate `isSynced`, which never becomes true for a fresh wallet whose only
+ * activity is unshielded (e.g. a faucet-funded test wallet pre-dust-register).
+ */
+export async function listNightUtxos(facade) {
+    const state = await Rx.firstValueFrom(facade.state().pipe(Rx.filter((s) => s.unshielded?.progress?.isStrictlyComplete?.() === true)));
+    const coins = state.unshielded.availableCoins.filter((c) => c.utxo.type === NIGHT_TOKEN_ID);
+    return coins.map((c) => ({
+        raw: c,
+        value: BigInt(c.utxo.value),
+        registered: c.meta.registeredForDustGeneration,
+    }));
+}
+/**
+ * Register NIGHT UTXOs for DUST generation, using a pre-derived
+ * WalletKeys bundle (D-KM-3 path — preferred over the seedHex variant
+ * for daemon callers).
+ */
+export async function designateForDustWithKeys(facade, keys, networkId, receiver, onProgress, selectedUtxos) {
+    setNetworkId(networkId);
+    const ks = createKeystore(keys.nightExternalKey, networkId);
+    return designateForDustImpl(facade, ks, networkId, receiver, onProgress, selectedUtxos);
+}
+/**
+ * Register NIGHT UTXOs for DUST generation.
+ * If `selectedUtxos` is provided, registers exactly those; otherwise auto-selects
+ * all currently unregistered NIGHT UTXOs.
+ */
+export async function designateForDust(facade, seedHex, networkId, receiver, onProgress, selectedUtxos) {
+    setNetworkId(networkId);
+    const keys = deriveKeysFromSeed(seedHex);
+    const ks = createKeystore(keys.nightExternalKey, networkId);
+    return designateForDustImpl(facade, ks, networkId, receiver, onProgress, selectedUtxos);
+}
+/**
+ * Whether registration can pay its own fee yet, and if not, how long until it
+ * can. Reads state and builds a throwaway transaction for costing; books
+ * nothing and spends nothing.
+ *
+ * Registration is self-funding — it draws on the DUST its NIGHT would have
+ * generated had it been registered all along — but that backdated amount starts
+ * at zero and grows with the NIGHT's age, so a freshly funded wallet cannot
+ * cover the fee yet. Without asking first, the wallet builds, proves, fails on
+ * the SDK's guard, and reports a defect where the honest answer is "not yet, try
+ * in about six minutes". See sync/dust-registration-estimate.ts.
+ */
+export async function estimateDustRegistration(facade, selectedUtxos) {
+    const utxos = selectedUtxos?.length
+        ? selectedUtxos.map((u) => u.raw)
+        : await unregisteredNightUtxos(facade);
+    // Nothing to register: no fee, and no accrual to wait for. The caller
+    // distinguishes this from "not yet" via its own no-night handling.
+    if (utxos.length === 0) {
+        return { fee: 0n, available: 0n, rate: 0n, maxAvailable: 0n, affordable: true, secondsUntilAffordable: 0 };
+    }
+    const { fee, dustGenerationEstimations } = await facade.estimateRegistration(utxos);
+    return estimateRegistrationAffordability(fee, dustGenerationEstimations.map((e) => ({
+        generatedNow: e.dust.generatedNow,
+        rate: e.dust.rate,
+        maxCap: e.dust.maxCap,
+        registeredForDustGeneration: e.utxo.registeredForDustGeneration,
+    })));
+}
+/** Unshielded NIGHT not yet backing DUST — the set a registration would use.
+ *  Gates on unshielded strict-complete only; see designateForDustImpl. */
+async function unregisteredNightUtxos(facade) {
+    const state = await Rx.firstValueFrom(facade.state().pipe(Rx.filter((s) => s.unshielded?.progress?.isStrictlyComplete?.() === true)));
+    return state.unshielded.availableCoins.filter((c) => c.utxo.type === NIGHT_TOKEN_ID && !c.meta.registeredForDustGeneration);
+}
+// Shared body used by both designateForDust(seedHex) and
+// designateForDustWithKeys(walletKeys).
+async function designateForDustImpl(facade, ks, networkId, receiver, onProgress, selectedUtxos) {
+    let utxos;
+    if (selectedUtxos && selectedUtxos.length > 0) {
+        utxos = selectedUtxos.map((u) => u.raw);
+    }
+    else {
+        // Registration only reads unshielded NIGHT UTXOs; gating on aggregate
+        // `isSynced` deadlocks a fresh wallet whose shielded/DUST streams have no
+        // events yet (registration itself creates the first DUST event). Shared with
+        // estimateDustRegistration so the pre-flight cannot cost a different set
+        // from the one the registration actually uses.
+        utxos = await unregisteredNightUtxos(facade);
+    }
+    if (utxos.length === 0)
+        return null;
+    onProgress?.('building');
+    let dustReceiver;
+    if (receiver) {
+        try {
+            dustReceiver = MidnightBech32m.parse(receiver).decode(DustAddress, networkId);
+        }
+        catch (e) {
+            // Never fall back silently: the caller explicitly chose a receiver, and
+            // defaulting would quietly send their DUST somewhere they didn't pick.
+            throw new Error(`Invalid DUST address "${receiver}" for network "${networkId}": ${e instanceof Error ? e.message : e}`);
+        }
+    }
+    let recipe;
+    try {
+        recipe = await facade.registerNightUtxosForDustGeneration(utxos, ks.getPublicKey(), (payload) => ks.signData(payload), dustReceiver);
+    }
+    catch (e) {
+        // Registration self-funds from the DUST its NIGHT would already have
+        // generated, and that amount starts at zero — so on a freshly funded wallet
+        // the SDK refuses before proving. Re-costing tells us whether that is what
+        // happened, and by how much: the affordability figures are the ground truth
+        // here, not the SDK's message text, which we would otherwise have to match
+        // by string and re-match on every SDK release.
+        //
+        // Only on the failure path, so a registration that was always going to
+        // succeed pays nothing for this.
+        const estimate = await estimateDustRegistration(facade, selectedUtxos).catch(() => null);
+        if (estimate && !estimate.affordable)
+            throw new DustRegistrationNotYetError(estimate, e);
+        throw e;
+    }
+    onProgress?.('proving');
+    const finalized = await facade.finalizeRecipe(recipe);
+    onProgress?.('submitting');
+    return submitWithRetry(facade, finalized);
+}
+/**
+ * Deregister NIGHT UTXOs from DUST generation, using a pre-derived
+ * WalletKeys bundle (D-KM-3 path).
+ */
+export async function dedesignateFromDustWithKeys(facade, keys, networkId, onProgress, selectedUtxos) {
+    setNetworkId(networkId);
+    const ks = createKeystore(keys.nightExternalKey, networkId);
+    return dedesignateFromDustImpl(facade, ks, keys, onProgress, selectedUtxos);
+}
+/**
+ * Deregister NIGHT UTXOs from DUST generation.
+ * If `selectedUtxos` is provided, deregisters exactly those; otherwise auto-selects
+ * all currently registered NIGHT UTXOs.
+ */
+export async function dedesignateFromDust(facade, seedHex, networkId, onProgress, selectedUtxos) {
+    setNetworkId(networkId);
+    const keys = deriveKeysFromSeed(seedHex);
+    const ks = createKeystore(keys.nightExternalKey, networkId);
+    return dedesignateFromDustImpl(facade, ks, keys, onProgress, selectedUtxos);
+}
+async function dedesignateFromDustImpl(facade, ks, keys, onProgress, selectedUtxos) {
+    let utxos;
+    if (selectedUtxos && selectedUtxos.length > 0) {
+        utxos = selectedUtxos.map((u) => u.raw);
+    }
+    else {
+        // Gate on unshielded strict-complete only — see designateForDustImpl
+        // above for why `s.isSynced` is the wrong predicate here.
+        const state = await Rx.firstValueFrom(facade.state().pipe(Rx.filter((s) => s.unshielded?.progress?.isStrictlyComplete?.() === true)));
+        utxos = state.unshielded.availableCoins.filter((c) => c.meta.registeredForDustGeneration === true);
+    }
+    if (utxos.length === 0)
+        throw new Error('No registered NIGHT UTXOs to deregister');
+    onProgress?.('building');
+    const recipe = await facade.deregisterFromDustGeneration(utxos, ks.getPublicKey(), (payload) => ks.signData(payload));
+    const balancedRecipe = await facade.balanceUnprovenTransaction(recipe.transaction, { shieldedSecretKeys: keys.shieldedSecretKeys, dustSecretKey: keys.dustSecretKey }, { ttl: new Date(Date.now() + 30 * 60_000) });
+    onProgress?.('submitting');
+    const finalized = await facade.finalizeRecipe(balancedRecipe);
+    return submitWithRetry(facade, finalized);
+}
+//# sourceMappingURL=operations.js.map

package/dist/sync/operations.js.map

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

package/dist/sync/preseed-parts.d.ts

@@ -0,0 +1,18 @@
+import type { WalletPart } from './sync-store.js';
+/** The parts a pre-seed can supply. History is not seeded; it rebuilds itself. */
+export declare const SEEDABLE_PARTS: readonly ["shielded", "unshielded", "dust"];
+export type SeedablePart = (typeof SEEDABLE_PARTS)[number];
+/**
+ * The seedable parts with no cached state, in a fixed order.
+ *
+ * A part that already has a cache is at least as far along as the reference, so
+ * seeding over it would discard progress. Anything absent is a candidate,
+ * whether this is a brand-new wallet (all three) or a rebuild of one
+ * (just the evicted part).
+ */
+export declare function partsToSeed(cached: Partial<Record<SeedablePart, string | null>>): SeedablePart[];
+/** Whether a pre-seed attempt is worth making at all. */
+export declare function shouldAttemptPreSeed(cached: Partial<Record<SeedablePart, string | null>>): boolean;
+/** Narrowing helper for callers holding the wider WalletPart union. */
+export declare function isSeedablePart(part: WalletPart): part is SeedablePart;
+//# sourceMappingURL=preseed-parts.d.ts.map

package/dist/sync/preseed-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preseed-parts.d.ts","sourceRoot":"","sources":["../../src/sync/preseed-parts.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAEhD,kFAAkF;AAClF,eAAO,MAAM,cAAc,6CAA8C,CAAC;AAE1E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,YAAY,EAAE,CAEhG;AAED,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,OAAO,CAElG;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,IAAI,YAAY,CAErE"}

package/dist/sync/preseed-parts.js

@@ -0,0 +1,33 @@
+// Which sub-wallet caches a pre-seed should fill in.
+//
+// Split out and WASM-free so the decision is unit-testable without loading the
+// ledger — the same split as sync/progress.ts.
+//
+// This exists because the decision was once made by proxy: the pre-seed gate
+// tested the SHIELDED cache alone, standing in for "this wallet has no state
+// yet". That proxy failed exactly where it mattered. A DUST rebuild evicts the
+// dust cache and nothing else, so shielded was still present, the gate stayed
+// shut, and dust walked all 1.4M events from genesis — 78.6 min on preprod —
+// while a usable reference sat unused.
+/** The parts a pre-seed can supply. History is not seeded; it rebuilds itself. */
+export const SEEDABLE_PARTS = ['shielded', 'unshielded', 'dust'];
+/**
+ * The seedable parts with no cached state, in a fixed order.
+ *
+ * A part that already has a cache is at least as far along as the reference, so
+ * seeding over it would discard progress. Anything absent is a candidate,
+ * whether this is a brand-new wallet (all three) or a rebuild of one
+ * (just the evicted part).
+ */
+export function partsToSeed(cached) {
+    return SEEDABLE_PARTS.filter((part) => !cached[part]);
+}
+/** Whether a pre-seed attempt is worth making at all. */
+export function shouldAttemptPreSeed(cached) {
+    return partsToSeed(cached).length > 0;
+}
+/** Narrowing helper for callers holding the wider WalletPart union. */
+export function isSeedablePart(part) {
+    return SEEDABLE_PARTS.includes(part);
+}
+//# sourceMappingURL=preseed-parts.js.map

package/dist/sync/preseed-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preseed-parts.js","sourceRoot":"","sources":["../../src/sync/preseed-parts.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,+EAA+E;AAC/E,+CAA+C;AAC/C,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E;AAC9E,6EAA6E;AAC7E,uCAAuC;AAIvC,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,CAAU,CAAC;AAI1E;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAoD;IAC9E,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,oBAAoB,CAAC,MAAoD;IACvF,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,cAAc,CAAC,IAAgB;IAC7C,OAAQ,cAAoC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC"}

package/dist/sync/preseed.d.ts

@@ -0,0 +1,95 @@
+import type { NetworkConfig } from '../types/network.js';
+import { type SyncStateStore } from './sync-store.js';
+import { type WalletKeys } from './operations.js';
+export interface EmptyRefStates {
+    shielded: string;
+    unshielded: string;
+    dust: string;
+    /**
+     * Chain height this reference was synced to. Callers MUST refuse to pre-seed a
+     * wallet whose birthday precedes it: the reference carries the chain's state at
+     * this height, so seeding a wallet that was already active earlier would skip
+     * that wallet's own history. Compared against `birthday` (also a height) —
+     * never against a snapshot `offset`, which is an event index.
+     */
+    height: number;
+}
+/** Reference-build progress, for surfacing an hour-long job in the UI. */
+export interface WarmProgress {
+    /** Dust events applied so far — the sub-wallet that dominates the build. */
+    applied: number;
+    /** Dust events the chain currently has. Grows slowly as the chain advances. */
+    total: number;
+    synced: boolean;
+}
+/**
+ * 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.
+ */
+export declare function ensureEmptyRefCache(network: NetworkConfig, onProgress?: (msg: string) => void, store?: SyncStateStore, 
+/**
+ * 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?: {
+    build?: boolean;
+    onWarmProgress?: (p: WarmProgress) => void;
+}): Promise<EmptyRefStates | null>;
+/**
+ * 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 declare function refreshEmptyRefCache(network: NetworkConfig, onProgress?: (msg: string) => void, store?: SyncStateStore, onWarmProgress?: (p: WarmProgress) => void): Promise<EmptyRefStates | null>;
+export declare function warmEmptyRefCache(network: NetworkConfig, onProgress?: (msg: string) => void, store?: SyncStateStore, onWarmProgress?: (p: WarmProgress) => void): Promise<EmptyRefStates | null>;
+/**
+ * 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 declare function preseedReferenceStatus(network: NetworkConfig, store?: SyncStateStore): Promise<{
+    ready: boolean;
+    height: number | 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 declare function preSeedNewWallet(walletKeys: WalletKeys, networkId: string, emptyRef: EmptyRefStates): {
+    shielded: string;
+    unshielded: string;
+    dust?: string;
+} | null;
+//# sourceMappingURL=preseed.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preseed.d.ts","sourceRoot":"","sources":["../../src/sync/preseed.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAA6E,KAAK,cAAc,EAAkB,MAAM,iBAAiB,CAAC;AAEjJ,OAAO,EAAmB,KAAK,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AA+FD;;;;GAIG;AAOH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,aAAa,EACtB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAClC,KAAK,CAAC,EAAE,cAAc;AACtB;;;;;;;GAOG;AACH,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;CAAE,GACrE,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA8BhC;AAED;;;;;;;;;GASG;AACH;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,aAAa,EACtB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAClC,KAAK,CAAC,EAAE,cAAc,EACtB,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GACzC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAiBhC;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAClC,KAAK,CAAC,EAAE,cAAc,EACtB,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GACzC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAEhC;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAIpD;AA+FD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,cAAc,GACvB;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,GAAG,IAAI,CAgE9D"}