@arkade-os/sdk 0.4.9 → 0.4.11

package/dist/cjs/wallet/serviceWorker/wallet-message-handler.js

@@ -292,7 +292,7 @@ class WalletMessageHandler {
                 }
                 case "REFRESH_VTXOS": {
                     const manager = await this.readonlyWallet.getContractManager();
-                    await manager.refreshVtxos();
+                    await manager.refreshVtxos(message.payload);
                     return this.tagged({
                         id,
                         type: "REFRESH_VTXOS_SUCCESS",
@@ -537,11 +537,13 @@ class WalletMessageHandler {
         // Initialize contract manager FIRST — this populates the repository
         // with full VTXO history for all contracts (one indexer call per contract)
         await this.ensureContractEventBroadcasting();
-        // Read VTXOs from repository (now populated by contract manager)
-        const vtxos = await this.getVtxosFromRepo();
+        // Refresh cached data (VTXOs, boarding UTXOs, tx history)
+        await this.refreshCachedData();
+        // Recover pending transactions (init-only, not on reload).
+        // Pending txs only exist if a send was interrupted mid-finalization.
         if (this.wallet) {
             try {
-                // recover pending transactions if possible
+                const vtxos = await this.getVtxosFromRepo();
                 const { pending, finalized } = await this.wallet.finalizePendingTxs(vtxos.filter((vtxo) => vtxo.virtualStatus.state !== "swept" &&
                     vtxo.virtualStatus.state !== "settled"));
                 console.info(`Recovered ${finalized.length}/${pending.length} pending transactions: ${finalized.join(", ")}`);
@@ -550,18 +552,10 @@ class WalletMessageHandler {
                 console.error("Error recovering pending transactions:", error);
             }
         }
-        // Fetch boarding utxos and save using unified repository
-        const boardingAddress = await this.readonlyWallet.getBoardingAddress();
-        const coins = await this.readonlyWallet.onchainProvider.getCoins(boardingAddress);
-        await this.walletRepository.saveUtxos(boardingAddress, coins.map((utxo) => (0, utils_1.extendCoin)(this.readonlyWallet, utxo)));
-        // Build transaction history from cached VTXOs (no indexer call)
-        const address = await this.readonlyWallet.getAddress();
-        const txs = await this.buildTransactionHistoryFromCache(vtxos);
-        if (txs)
-            await this.walletRepository.saveTransactions(address, txs);
         // unsubscribe previous subscription if any
         if (this.incomingFundsSubscription)
             this.incomingFundsSubscription();
+        const address = await this.readonlyWallet.getAddress();
         // subscribe for incoming funds and notify all clients when new funds arrive
         this.incomingFundsSubscription =
             await this.readonlyWallet.notifyIncomingFunds(async (funds) => {
@@ -614,15 +608,38 @@ class WalletMessageHandler {
         }
     }
     /**
-     * Force a full VTXO refresh from the indexer, then re-run bootstrap.
-     * Used by RELOAD_WALLET to ensure fresh data.
+     * Refresh VTXOs, boarding UTXOs, and transaction history from cache.
+     * Shared by onWalletInitialized (full bootstrap) and reloadWallet
+     * (post-refresh), avoiding duplicate subscriptions and VtxoManager restarts.
+     */
+    async refreshCachedData() {
+        if (!this.readonlyWallet || !this.walletRepository) {
+            return;
+        }
+        // Read VTXOs from repository (now populated by contract manager)
+        const vtxos = await this.getVtxosFromRepo();
+        // Fetch boarding utxos and save using unified repository
+        const boardingAddress = await this.readonlyWallet.getBoardingAddress();
+        const coins = await this.readonlyWallet.onchainProvider.getCoins(boardingAddress);
+        await this.walletRepository.deleteUtxos(boardingAddress);
+        await this.walletRepository.saveUtxos(boardingAddress, coins.map((utxo) => (0, utils_1.extendCoin)(this.readonlyWallet, utxo)));
+        // Build transaction history from cached VTXOs (no indexer call)
+        const address = await this.readonlyWallet.getAddress();
+        const txs = await this.buildTransactionHistoryFromCache(vtxos);
+        if (txs)
+            await this.walletRepository.saveTransactions(address, txs);
+    }
+    /**
+     * Force a full VTXO refresh from the indexer, then refresh cached data.
+     * Used by RELOAD_WALLET to ensure fresh data without re-subscribing
+     * to incoming funds or restarting the VtxoManager.
      */
     async reloadWallet() {
         if (!this.readonlyWallet)
             return;
         const manager = await this.readonlyWallet.getContractManager();
         await manager.refreshVtxos();
-        await this.onWalletInitialized();
+        await this.refreshCachedData();
     }
     async handleSettle(message) {
         const wallet = this.requireWallet();
@@ -797,24 +814,37 @@ class WalletMessageHandler {
                 vtxoCreatedAt.set(vtxo.txid, ts);
             }
         }
-        // getTxCreatedAt resolves the creation timestamp of a transaction.
-        // buildTransactionHistory calls this for spent-offchain VTXOs with
-        // no change outputs to determine the time of the sending tx.
-        // Returns undefined on miss so buildTransactionHistory uses its
-        // own fallback (vtxo.createdAt + 1) rather than epoch 0.
-        // The vout:0 lookup in the indexer fallback mirrors the pre-existing
-        // convention in ReadonlyWallet.getTransactionHistory().
-        const getTxCreatedAt = async (txid) => {
-            const cached = vtxoCreatedAt.get(txid);
-            if (cached !== undefined)
-                return cached;
-            if (this.indexerProvider) {
-                const res = await this.indexerProvider.getVtxos({
-                    outpoints: [{ txid, vout: 0 }],
-                });
-                return res.vtxos[0]?.createdAt.getTime();
+        // Pre-fetch uncached timestamps in a single batched indexer call.
+        // buildTransactionHistory needs these for spent-offchain VTXOs with
+        // no change outputs (i.e. arkTxId is set but no VTXO has txid === arkTxId).
+        if (this.indexerProvider) {
+            const uncachedTxids = new Set();
+            for (const vtxo of vtxos) {
+                if (vtxo.isSpent &&
+                    vtxo.arkTxId &&
+                    !vtxoCreatedAt.has(vtxo.arkTxId) &&
+                    !vtxos.some((v) => v.txid === vtxo.arkTxId)) {
+                    uncachedTxids.add(vtxo.arkTxId);
+                }
             }
-            return undefined;
+            if (uncachedTxids.size > 0) {
+                const outpoints = [...uncachedTxids].map((txid) => ({
+                    txid,
+                    vout: 0,
+                }));
+                const BATCH_SIZE = 100;
+                for (let i = 0; i < outpoints.length; i += BATCH_SIZE) {
+                    const res = await this.indexerProvider.getVtxos({
+                        outpoints: outpoints.slice(i, i + BATCH_SIZE),
+                    });
+                    for (const v of res.vtxos) {
+                        vtxoCreatedAt.set(v.txid, v.createdAt.getTime());
+                    }
+                }
+            }
+        }
+        const getTxCreatedAt = async (txid) => {
+            return vtxoCreatedAt.get(txid);
         };
         return (0, transactionHistory_1.buildTransactionHistory)(vtxos, boardingTxs, commitmentsToIgnore, getTxCreatedAt);
     }

package/dist/cjs/wallet/serviceWorker/wallet.js

@@ -7,11 +7,12 @@ const repositories_1 = require("../../repositories");
 const wallet_message_handler_1 = require("./wallet-message-handler");
 const utils_2 = require("../utils");
 const errors_1 = require("../../worker/errors");
-// Check by error name instead of instanceof because postMessage uses the
+// Check by error message content instead of instanceof because postMessage uses the
 // structured clone algorithm which strips the prototype chain — the page
 // receives a plain Error, not the original MessageBusNotInitializedError.
 function isMessageBusNotInitializedError(error) {
-    return (error instanceof Error && error.name === "MessageBusNotInitializedError");
+    return (error instanceof Error &&
+        error.message.includes(errors_1.MESSAGE_BUS_NOT_INITIALIZED));
 }
 const DEDUPABLE_REQUEST_TYPES = new Set([
     "GET_ADDRESS",
@@ -684,11 +685,12 @@ class ServiceWorkerReadonlyWallet {
                     navigator.serviceWorker.removeEventListener("message", messageHandler);
                 };
             },
-            async refreshVtxos() {
+            async refreshVtxos(opts) {
                 const message = {
                     type: "REFRESH_VTXOS",
                     id: (0, utils_2.getRandomId)(),
                     tag: messageTag,
+                    payload: opts,
                 };
                 await sendContractMessage(message);
             },

package/dist/cjs/wallet/vtxo-manager.js

@@ -402,8 +402,8 @@ class VtxoManager {
      * }
      * ```
      */
-    async getExpiredBoardingUtxos() {
-        const boardingUtxos = await this.wallet.getBoardingUtxos();
+    async getExpiredBoardingUtxos(prefetchedUtxos) {
+        const boardingUtxos = prefetchedUtxos ?? (await this.wallet.getBoardingUtxos());
         const boardingTimelock = this.getBoardingTimelock();
         // For block-based timelocks, fetch the chain tip height
         let chainTipHeight;
@@ -444,14 +444,14 @@ class VtxoManager {
      * }
      * ```
      */
-    async sweepExpiredBoardingUtxos() {
+    async sweepExpiredBoardingUtxos(prefetchedUtxos) {
         const sweepEnabled = this.settlementConfig !== false &&
             (this.settlementConfig?.boardingUtxoSweep ??
                 exports.DEFAULT_SETTLEMENT_CONFIG.boardingUtxoSweep);
         if (!sweepEnabled) {
             throw new Error("Boarding UTXO sweep is not enabled in settlementConfig");
         }
-        const allExpired = await this.getExpiredBoardingUtxos();
+        const allExpired = await this.getExpiredBoardingUtxos(prefetchedUtxos);
         // Filter out UTXOs already swept (tx broadcast but not yet confirmed)
         const expiredUtxos = allExpired.filter((u) => !this.sweptBoardingUtxos.has(`${u.txid}:${u.vout}`));
         if (expiredUtxos.length === 0) {
@@ -640,16 +640,25 @@ class VtxoManager {
         // Guard: wallet must support boarding UTXO + sweep operations
         if (!isSweepCapable(this.wallet))
             return;
-        // Skip if a previous poll is still running
+        // Skip if disposed or a previous poll is still running
+        if (this.disposed)
+            return;
         if (this.pollInProgress)
             return;
         this.pollInProgress = true;
+        // Create a promise that dispose() can await
+        let resolve;
+        const promise = new Promise((r) => (resolve = r));
+        this.pollDone = { promise, resolve: resolve };
         let hadError = false;
         try {
+            // Fetch boarding UTXOs once for the entire poll cycle so that
+            // settle and sweep don't each hit the network independently.
+            const boardingUtxos = await this.wallet.getBoardingUtxos();
             // Settle new (unexpired) UTXOs first, then sweep expired ones.
             // Sequential to avoid racing for the same UTXOs.
             try {
-                await this.settleBoardingUtxos();
+                await this.settleBoardingUtxos(boardingUtxos);
             }
             catch (e) {
                 hadError = true;
@@ -660,7 +669,7 @@ class VtxoManager {
                     exports.DEFAULT_SETTLEMENT_CONFIG.boardingUtxoSweep);
             if (sweepEnabled) {
                 try {
-                    await this.sweepExpiredBoardingUtxos();
+                    await this.sweepExpiredBoardingUtxos(boardingUtxos);
                 }
                 catch (e) {
                     if (!(e instanceof Error) ||
@@ -671,6 +680,10 @@ class VtxoManager {
                 }
             }
         }
+        catch (e) {
+            hadError = true;
+            console.error("Error fetching boarding UTXOs:", e);
+        }
         finally {
             if (hadError) {
                 this.consecutivePollFailures++;
@@ -679,6 +692,8 @@ class VtxoManager {
                 this.consecutivePollFailures = 0;
             }
             this.pollInProgress = false;
+            this.pollDone.resolve();
+            this.pollDone = undefined;
             this.schedulePoll();
         }
     }
@@ -689,8 +704,7 @@ class VtxoManager {
      * UTXOs are marked as known only after a successful settle, so failed
      * attempts will be retried on the next poll.
      */
-    async settleBoardingUtxos() {
-        const boardingUtxos = await this.wallet.getBoardingUtxos();
+    async settleBoardingUtxos(boardingUtxos) {
         // Exclude expired UTXOs — those should be swept, not settled.
         // If we can't determine expired status, bail out entirely to avoid
         // accidentally settling expired UTXOs (which would conflict with sweep).
@@ -737,6 +751,13 @@ class VtxoManager {
                 clearTimeout(this.pollTimeoutId);
                 this.pollTimeoutId = undefined;
             }
+            // Wait for any in-flight poll to finish (with timeout to avoid hanging)
+            if (this.pollDone) {
+                let timer;
+                const timeout = new Promise((r) => (timer = setTimeout(r, 30000)));
+                await Promise.race([this.pollDone.promise, timeout]);
+                clearTimeout(timer);
+            }
             const subscription = await this.contractEventsSubscriptionReady;
             this.contractEventsSubscription = undefined;
             subscription?.();

package/dist/cjs/wallet/wallet.js

@@ -37,6 +37,7 @@ const repositories_1 = require("../repositories");
 const contractManager_1 = require("../contracts/contractManager");
 const handlers_1 = require("../contracts/handlers");
 const helpers_1 = require("../contracts/handlers/helpers");
+const syncCursors_1 = require("../utils/syncCursors");
 /**
  * Type guard function to check if an identity has a toReadonly method.
  */
@@ -274,61 +275,158 @@ class ReadonlyWallet {
         };
     }
     async getVtxos(filter) {
-        const address = await this.getAddress();
-        const scriptMap = await this.getScriptMap();
+        const { isDelta, fetchedExtended, address } = await this.syncVtxos();
         const f = filter ?? { withRecoverable: true, withUnrolled: false };
-        const allExtended = [];
-        // Batch all scripts into a single indexer call
-        const allScripts = [...scriptMap.keys()];
-        const response = await this.indexerProvider.getVtxos({
-            scripts: allScripts,
-        });
-        for (const vtxo of response.vtxos) {
-            const vtxoScript = vtxo.script
-                ? scriptMap.get(vtxo.script)
-                : undefined;
-            if (!vtxoScript)
-                continue;
+        // For delta syncs, read the full merged set from cache so old
+        // VTXOs that weren't in the delta are still returned.
+        const vtxos = isDelta
+            ? await this.walletRepository.getVtxos(address)
+            : fetchedExtended;
+        return vtxos.filter((vtxo) => {
             if ((0, _1.isSpendable)(vtxo)) {
                 if (!f.withRecoverable &&
                     ((0, _1.isRecoverable)(vtxo) || (0, _1.isExpired)(vtxo))) {
-                    continue;
+                    return false;
                 }
+                return true;
+            }
+            return !!(f.withUnrolled && vtxo.isUnrolled);
+        });
+    }
+    async getTransactionHistory() {
+        // Delta-sync VTXOs into cache, then build history from the cache.
+        const { isDelta, fetchedExtended, address } = await this.syncVtxos();
+        const allVtxos = isDelta
+            ? await this.walletRepository.getVtxos(address)
+            : fetchedExtended;
+        const { boardingTxs, commitmentsToIgnore } = await this.getBoardingTxs();
+        const getTxCreatedAt = (txid) => this.indexerProvider
+            .getVtxos({ outpoints: [{ txid, vout: 0 }] })
+            .then((res) => res.vtxos[0]?.createdAt.getTime());
+        return (0, transactionHistory_1.buildTransactionHistory)(allVtxos, boardingTxs, commitmentsToIgnore, getTxCreatedAt);
+    }
+    /**
+     * Delta-sync wallet VTXOs: fetch only changed VTXOs since the last
+     * cursor, or do a full bootstrap when no cursor exists. Upserts
+     * the result into the cache and advances the sync cursors.
+     */
+    async syncVtxos() {
+        const address = await this.getAddress();
+        // Batch cursor read with script map to avoid extra async hops
+        // before the fetch (background operations may run between hops).
+        const [scriptMap, cursors] = await Promise.all([
+            this.getScriptMap(),
+            (0, syncCursors_1.getAllSyncCursors)(this.walletRepository),
+        ]);
+        const allScripts = [...scriptMap.keys()];
+        // Partition scripts into bootstrap (no cursor) and delta (has cursor).
+        const bootstrapScripts = [];
+        const deltaScripts = [];
+        for (const s of allScripts) {
+            if (cursors[s] === undefined) {
+                bootstrapScripts.push(s);
             }
             else {
-                if (!f.withUnrolled || !vtxo.isUnrolled)
-                    continue;
+                deltaScripts.push(s);
+            }
+        }
+        const requestStartedAt = Date.now();
+        const allVtxos = [];
+        // Full fetch for scripts with no cursor.
+        if (bootstrapScripts.length > 0) {
+            const response = await this.indexerProvider.getVtxos({
+                scripts: bootstrapScripts,
+            });
+            allVtxos.push(...response.vtxos);
+        }
+        // Delta fetch for scripts with an existing cursor.
+        let hasDelta = false;
+        if (deltaScripts.length > 0) {
+            const minCursor = Math.min(...deltaScripts.map((s) => cursors[s]));
+            const window = (0, syncCursors_1.computeSyncWindow)(minCursor);
+            if (window) {
+                hasDelta = true;
+                const response = await this.indexerProvider.getVtxos({
+                    scripts: deltaScripts,
+                    after: window.after,
+                });
+                allVtxos.push(...response.vtxos);
             }
-            allExtended.push({
+        }
+        // Extend every fetched VTXO and upsert into the cache.
+        const fetchedExtended = [];
+        for (const vtxo of allVtxos) {
+            const vtxoScript = vtxo.script
+                ? scriptMap.get(vtxo.script)
+                : undefined;
+            if (!vtxoScript)
+                continue;
+            fetchedExtended.push({
                 ...vtxo,
                 forfeitTapLeafScript: vtxoScript.forfeit(),
                 intentTapLeafScript: vtxoScript.forfeit(),
                 tapTree: vtxoScript.encode(),
             });
         }
-        // Update cache with fresh data
-        await this.walletRepository.saveVtxos(address, allExtended);
-        return allExtended;
+        // Save VTXOs first, then advance cursors only on success.
+        const cutoff = (0, syncCursors_1.cursorCutoff)(requestStartedAt);
+        await this.walletRepository.saveVtxos(address, fetchedExtended);
+        await (0, syncCursors_1.advanceSyncCursors)(this.walletRepository, Object.fromEntries(allScripts.map((s) => [s, cutoff])));
+        // For delta syncs, reconcile pending (preconfirmed/spent) VTXOs
+        // whose state may have changed since the cursor so that
+        // getVtxos()/getTransactionHistory() don't serve stale state.
+        if (hasDelta) {
+            const { vtxos: pendingVtxos } = await this.indexerProvider.getVtxos({
+                scripts: deltaScripts,
+                pendingOnly: true,
+            });
+            const pendingExtended = [];
+            for (const vtxo of pendingVtxos) {
+                const vtxoScript = vtxo.script
+                    ? scriptMap.get(vtxo.script)
+                    : undefined;
+                if (!vtxoScript)
+                    continue;
+                pendingExtended.push({
+                    ...vtxo,
+                    forfeitTapLeafScript: vtxoScript.forfeit(),
+                    intentTapLeafScript: vtxoScript.forfeit(),
+                    tapTree: vtxoScript.encode(),
+                });
+            }
+            if (pendingExtended.length > 0) {
+                await this.walletRepository.saveVtxos(address, pendingExtended);
+            }
+        }
+        return {
+            isDelta: hasDelta || bootstrapScripts.length === 0,
+            fetchedExtended,
+            address,
+        };
     }
-    async getTransactionHistory() {
-        const scripts = await this.getWalletScripts();
-        const response = await this.indexerProvider.getVtxos({ scripts });
-        const { boardingTxs, commitmentsToIgnore } = await this.getBoardingTxs();
-        const getTxCreatedAt = (txid) => this.indexerProvider
-            .getVtxos({ outpoints: [{ txid, vout: 0 }] })
-            .then((res) => res.vtxos[0]?.createdAt.getTime());
-        return (0, transactionHistory_1.buildTransactionHistory)(response.vtxos, boardingTxs, commitmentsToIgnore, getTxCreatedAt);
+    /**
+     * Clear all VTXO sync cursors, forcing a full re-bootstrap on next sync.
+     * Useful for recovery after indexer reprocessing or debugging.
+     */
+    async clearSyncCursors() {
+        await (0, syncCursors_1.clearSyncCursors)(this.walletRepository);
     }
     async getBoardingTxs() {
         const utxos = [];
         const commitmentsToIgnore = new Set();
         const boardingAddress = await this.getBoardingAddress();
         const txs = await this.onchainProvider.getTransactions(boardingAddress);
+        const outspendCache = new Map();
         for (const tx of txs) {
             for (let i = 0; i < tx.vout.length; i++) {
                 const vout = tx.vout[i];
                 if (vout.scriptpubkey_address === boardingAddress) {
-                    const spentStatuses = await this.onchainProvider.getTxOutspends(tx.txid);
+                    let spentStatuses = outspendCache.get(tx.txid);
+                    if (!spentStatuses) {
+                        spentStatuses =
+                            await this.onchainProvider.getTxOutspends(tx.txid);
+                        outspendCache.set(tx.txid, spentStatuses);
+                    }
                     const spentStatus = spentStatuses[i];
                     if (spentStatus?.spent) {
                         commitmentsToIgnore.add(spentStatus.txid);
@@ -1344,10 +1442,15 @@ class Wallet extends ReadonlyWallet {
     }
     /**
      * Finalizes pending transactions by retrieving them from the server and finalizing each one.
+     * Skips the server check entirely when no send was interrupted (no pending tx flag set).
      * @param vtxos - Optional list of VTXOs to use instead of retrieving them from the server
      * @returns Array of transaction IDs that were finalized
      */
     async finalizePendingTxs(vtxos) {
+        const hasPending = await this.hasPendingTxFlag();
+        if (!hasPending) {
+            return { finalized: [], pending: [] };
+        }
         const MAX_INPUTS_PER_INTENT = 20;
         if (!vtxos || vtxos.length === 0) {
             // Batch all scripts into a single indexer call
@@ -1379,33 +1482,63 @@ class Wallet extends ReadonlyWallet {
             }
             vtxos = allExtended;
         }
-        const finalized = [];
-        const pending = [];
+        const batches = [];
         for (let i = 0; i < vtxos.length; i += MAX_INPUTS_PER_INTENT) {
-            const batch = vtxos.slice(i, i + MAX_INPUTS_PER_INTENT);
+            batches.push(vtxos.slice(i, i + MAX_INPUTS_PER_INTENT));
+        }
+        // Track seen arkTxids so parallel batches don't finalize the same tx twice
+        const seen = new Set();
+        const results = await Promise.all(batches.map(async (batch) => {
+            const batchFinalized = [];
+            const batchPending = [];
             const intent = await this.makeGetPendingTxIntentSignature(batch);
             const pendingTxs = await this.arkProvider.getPendingTxs(intent);
-            // finalize each transaction by signing the checkpoints
             for (const pendingTx of pendingTxs) {
-                pending.push(pendingTx.arkTxid);
+                if (seen.has(pendingTx.arkTxid))
+                    continue;
+                seen.add(pendingTx.arkTxid);
+                batchPending.push(pendingTx.arkTxid);
                 try {
-                    // sign the checkpoints
                     const finalCheckpoints = await Promise.all(pendingTx.signedCheckpointTxs.map(async (c) => {
                         const tx = btc_signer_1.Transaction.fromPSBT(base_1.base64.decode(c));
                         const signedCheckpoint = await this.identity.sign(tx);
                         return base_1.base64.encode(signedCheckpoint.toPSBT());
                     }));
                     await this.arkProvider.finalizeTx(pendingTx.arkTxid, finalCheckpoints);
-                    finalized.push(pendingTx.arkTxid);
+                    batchFinalized.push(pendingTx.arkTxid);
                 }
                 catch (error) {
                     console.error(`Failed to finalize transaction ${pendingTx.arkTxid}:`, error);
-                    // continue with other transactions even if one fails
                 }
             }
+            return {
+                finalized: batchFinalized,
+                pending: batchPending,
+            };
+        }));
+        const finalized = [];
+        const pending = [];
+        for (const result of results) {
+            finalized.push(...result.finalized);
+            pending.push(...result.pending);
+        }
+        // Only clear the flag if every discovered pending tx was finalized;
+        // if any failed, keep it so recovery retries on next startup.
+        if (finalized.length === pending.length) {
+            await this.setPendingTxFlag(false);
         }
         return { finalized, pending };
     }
+    async hasPendingTxFlag() {
+        const state = await this.walletRepository.getWalletState();
+        return state?.settings?.hasPendingTx === true;
+    }
+    async setPendingTxFlag(value) {
+        await (0, syncCursors_1.updateWalletState)(this.walletRepository, (state) => ({
+            ...state,
+            settings: { ...state.settings, hasPendingTx: value },
+        }));
+    }
     /**
      * Send BTC and/or assets to one or more recipients.
      *
@@ -1574,6 +1707,9 @@ class Wallet extends ReadonlyWallet {
             };
         }), outputs, this.serverUnrollScript);
         const signedVirtualTx = await this.identity.sign(offchainTx.arkTx);
+        // Mark pending before submitting — if we crash between submit and
+        // finalize, the next init will recover via finalizePendingTxs.
+        await this.setPendingTxFlag(true);
         const { arkTxid, signedCheckpointTxs } = await this.arkProvider.submitTx(base_1.base64.encode(signedVirtualTx.toPSBT()), offchainTx.checkpoints.map((c) => base_1.base64.encode(c.toPSBT())));
         const finalCheckpoints = await Promise.all(signedCheckpointTxs.map(async (c) => {
             const tx = btc_signer_1.Transaction.fromPSBT(base_1.base64.decode(c));
@@ -1581,6 +1717,12 @@ class Wallet extends ReadonlyWallet {
             return base_1.base64.encode(signedCheckpoint.toPSBT());
         }));
         await this.arkProvider.finalizeTx(arkTxid, finalCheckpoints);
+        try {
+            await this.setPendingTxFlag(false);
+        }
+        catch (error) {
+            console.error("Failed to clear pending tx flag:", error);
+        }
         return { arkTxid, signedCheckpointTxs };
     }
     // mark vtxo spent and save change vtxo if any

package/dist/cjs/worker/errors.js

@@ -1,17 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServiceWorkerTimeoutError = exports.MessageBusNotInitializedError = void 0;
+exports.ServiceWorkerTimeoutError = exports.MessageBusNotInitializedError = exports.MESSAGE_BUS_NOT_INITIALIZED = void 0;
+exports.MESSAGE_BUS_NOT_INITIALIZED = "MessageBus not initialized";
 class MessageBusNotInitializedError extends Error {
     constructor() {
-        super("MessageBus not initialized");
-        this.name = "MessageBusNotInitializedError";
+        super(exports.MESSAGE_BUS_NOT_INITIALIZED);
     }
 }
 exports.MessageBusNotInitializedError = MessageBusNotInitializedError;
 class ServiceWorkerTimeoutError extends Error {
     constructor(detail) {
         super(detail);
-        this.name = "ServiceWorkerTimeoutError";
     }
 }
 exports.ServiceWorkerTimeoutError = ServiceWorkerTimeoutError;