@breeztech/breez-sdk-spark 0.27.0-dev2 → 0.27.0

package/bundler/breez_sdk_spark_wasm_bg.wasm.d.ts

@@ -22,16 +22,20 @@ export const bitcoinchainservicehandle_tipHeight: (a: number) => any;
 export const breezsdk_addContact: (a: number, b: any) => any;
 export const breezsdk_addEventListener: (a: number, b: any) => any;
 export const breezsdk_authorizeLightningAddressTransfer: (a: number, b: any) => any;
+export const breezsdk_bridgeFromCashApp: (a: number, b: any) => any;
+export const breezsdk_bridgeToCashApp: (a: number, b: any) => any;
 export const breezsdk_buildUnsignedBatchPackage: (a: number, b: any) => any;
 export const breezsdk_buildUnsignedLnurlPayPackage: (a: number, b: any) => any;
+export const breezsdk_buildUnsignedPullPackage: (a: number, b: any) => any;
 export const breezsdk_buildUnsignedTransferPackage: (a: number, b: any) => any;
 export const breezsdk_buyBitcoin: (a: number, b: any) => any;
 export const breezsdk_checkLightningAddressAvailable: (a: number, b: any) => any;
 export const breezsdk_checkMessage: (a: number, b: any) => any;
-export const breezsdk_checkUnilateralExit: (a: number, b: any) => any;
+export const breezsdk_checkRecoverFunds: (a: number, b: any) => any;
 export const breezsdk_claimDeposit: (a: number, b: any) => any;
 export const breezsdk_claimHtlcPayment: (a: number, b: any) => any;
 export const breezsdk_claimLightningAddressTransfer: (a: number, b: any) => any;
+export const breezsdk_createTokenAllowance: (a: number, b: any) => any;
 export const breezsdk_deleteContact: (a: number, b: number, c: number) => any;
 export const breezsdk_deleteLightningAddress: (a: number) => any;
 export const breezsdk_disconnect: (a: number) => any;
@@ -50,6 +54,7 @@ export const breezsdk_listContacts: (a: number, b: any) => any;
 export const breezsdk_listFiatCurrencies: (a: number) => any;
 export const breezsdk_listFiatRates: (a: number) => any;
 export const breezsdk_listPayments: (a: number, b: any) => any;
+export const breezsdk_listTokenAllowances: (a: number, b: any) => any;
 export const breezsdk_listUnclaimedDeposits: (a: number, b: any) => any;
 export const breezsdk_listWebhooks: (a: number) => any;
 export const breezsdk_lnurlAuth: (a: number, b: any) => any;
@@ -59,23 +64,27 @@ export const breezsdk_optimizeLeaves: (a: number, b: any) => any;
 export const breezsdk_parse: (a: number, b: number, c: number) => any;
 export const breezsdk_prepareLnurlPay: (a: number, b: any) => any;
 export const breezsdk_preparePaymentLink: (a: number, b: any) => any;
+export const breezsdk_preparePullPayment: (a: number, b: any) => any;
+export const breezsdk_prepareRecoverFunds: (a: number, b: any) => any;
 export const breezsdk_prepareSendBatch: (a: number, b: any) => any;
 export const breezsdk_prepareSendPayment: (a: number, b: any) => any;
-export const breezsdk_prepareUnilateralExit: (a: number, b: any) => any;
 export const breezsdk_publishSignedLnurlPayPackage: (a: number, b: any) => any;
+export const breezsdk_publishSignedPullPackage: (a: number, b: any) => any;
 export const breezsdk_publishSignedTransferPackage: (a: number, b: any) => any;
+export const breezsdk_pullPayment: (a: number, b: any) => any;
 export const breezsdk_receivePayment: (a: number, b: any) => any;
 export const breezsdk_recommendedFees: (a: number) => any;
+export const breezsdk_recoverFunds: (a: number, b: any, c: number) => any;
 export const breezsdk_refundDeposit: (a: number, b: any) => any;
 export const breezsdk_refundPendingConversions: (a: number) => any;
 export const breezsdk_registerLightningAddress: (a: number, b: any) => any;
 export const breezsdk_registerWebhook: (a: number, b: any) => any;
 export const breezsdk_removeEventListener: (a: number, b: number, c: number) => any;
+export const breezsdk_revokeTokenAllowance: (a: number, b: any) => any;
 export const breezsdk_sendBatch: (a: number, b: any) => any;
 export const breezsdk_sendPayment: (a: number, b: any) => any;
 export const breezsdk_signMessage: (a: number, b: any) => any;
 export const breezsdk_syncWallet: (a: number, b: any) => any;
-export const breezsdk_unilateralExit: (a: number, b: any, c: any) => any;
 export const breezsdk_unregisterWebhook: (a: number, b: any) => any;
 export const breezsdk_updateContact: (a: number, b: any) => any;
 export const breezsdk_updateUserSettings: (a: number, b: any) => any;
@@ -110,6 +119,7 @@ export const externalsigningsignerhandle_signHashSchnorr: (a: number, b: number,
 export const externalsparksignerhandle_getIdentityPublicKey: (a: number) => any;
 export const externalsparksignerhandle_getPublicKeyForLeaf: (a: number, b: any) => any;
 export const externalsparksignerhandle_getStaticDepositPublicKey: (a: number, b: number) => any;
+export const externalsparksignerhandle_isRemote: (a: number) => number;
 export const externalsparksignerhandle_prepareClaim: (a: number, b: any) => any;
 export const externalsparksignerhandle_prepareLightningReceive: (a: number, b: any) => any;
 export const externalsparksignerhandle_prepareStaticDeposit: (a: number, b: any) => any;
@@ -122,7 +132,9 @@ export const externalsparksignerhandle_signLeafRefundSpend: (a: number, b: any,
 export const externalsparksignerhandle_signMessage: (a: number, b: number, c: number) => any;
 export const externalsparksignerhandle_signSparkInvoice: (a: number, b: any) => any;
 export const externalsparksignerhandle_signStaticDepositRefund: (a: number, b: any) => any;
+export const externalsparksignerhandle_signWatchtowerExitRecovery: (a: number, b: any) => any;
 export const externalsparksignerhandle_startStaticDepositRefund: (a: number, b: any) => any;
+export const externalsparksignerhandle_startWatchtowerExitRecovery: (a: number, b: any) => any;
 export const getSparkStatus: () => any;
 export const initLogging: (a: any, b: number, c: number) => any;
 export const mysqlStorage: (a: any) => number;
@@ -185,21 +197,23 @@ export const intounderlyingsource_cancel: (a: number) => void;
 export const intounderlyingsource_pull: (a: number, b: any) => any;
 export const __wbg_externalbreezsignerhandle_free: (a: number, b: number) => void;
 export const __wbg_defaultsessionstore_free: (a: number, b: number) => void;
-export const __wbg_externalsigningsignerhandle_free: (a: number, b: number) => void;
 export const __wbg_externalsparksignerhandle_free: (a: number, b: number) => void;
+export const __wbg_externalsigningsignerhandle_free: (a: number, b: number) => void;
 export const __wbg_signingonlyexternalsigners_free: (a: number, b: number) => void;
 export const signingonlyexternalsigners_breezSigner: (a: number) => number;
 export const signingonlyexternalsigners_sparkSigner: (a: number) => number;
-export const wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375: (a: number, b: number, c: any) => [number, number];
-export const wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_4: (a: number, b: number, c: any) => [number, number];
-export const wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_5: (a: number, b: number, c: any) => [number, number];
-export const wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_6: (a: number, b: number, c: any) => [number, number];
-export const wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_7: (a: number, b: number, c: any) => [number, number];
-export const wasm_bindgen__convert__closures_____invoke__h41057d61edf43a32: (a: number, b: number, c: any, d: any) => void;
-export const wasm_bindgen__convert__closures_____invoke__h3b28fbbc8b451a25: (a: number, b: number, c: any) => void;
-export const wasm_bindgen__convert__closures_____invoke__h3b28fbbc8b451a25_2: (a: number, b: number, c: any) => void;
-export const wasm_bindgen__convert__closures_____invoke__h3b28fbbc8b451a25_3: (a: number, b: number, c: any) => void;
-export const wasm_bindgen__convert__closures_____invoke__h484cd36e13f37bd7: (a: number, b: number) => void;
+export const wasm_bindgen__convert__closures_____invoke__h6a948436da8c8a31: (a: number, b: number, c: any) => [number, number];
+export const wasm_bindgen__convert__closures_____invoke__h6a948436da8c8a31_6: (a: number, b: number, c: any) => [number, number];
+export const wasm_bindgen__convert__closures_____invoke__h6a948436da8c8a31_7: (a: number, b: number, c: any) => [number, number];
+export const wasm_bindgen__convert__closures_____invoke__h6a948436da8c8a31_8: (a: number, b: number, c: any) => [number, number];
+export const wasm_bindgen__convert__closures_____invoke__h6a948436da8c8a31_9: (a: number, b: number, c: any) => [number, number];
+export const wasm_bindgen__convert__closures_____invoke__h118cfc65b353d9fd: (a: number, b: number, c: any, d: any) => void;
+export const wasm_bindgen__convert__closures_____invoke__h06397208c6d2b4ed: (a: number, b: number, c: any) => void;
+export const wasm_bindgen__convert__closures_____invoke__h06397208c6d2b4ed_2: (a: number, b: number, c: any) => void;
+export const wasm_bindgen__convert__closures_____invoke__h06397208c6d2b4ed_3: (a: number, b: number, c: any) => void;
+export const wasm_bindgen__convert__closures_____invoke__h06397208c6d2b4ed_4: (a: number, b: number, c: any) => void;
+export const wasm_bindgen__convert__closures_____invoke__h06397208c6d2b4ed_5: (a: number, b: number, c: any) => void;
+export const wasm_bindgen__convert__closures_____invoke__h02848814aa3937de: (a: number, b: number) => void;
 export const __wbindgen_malloc: (a: number, b: number) => number;
 export const __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
 export const __wbindgen_free: (a: number, b: number, c: number) => void;

package/bundler/storage/index.js

@@ -3,6 +3,14 @@
  * This provides an ES6 interface to IndexedDB storage for web browsers
  */
 
+// JSON has no BigInt, so u128 amounts are stored as decimal strings, which the
+// SDK reads back as BigInts.
+function toJson(value) {
+  return JSON.stringify(value, (_key, v) =>
+    typeof v === "bigint" ? v.toString() : v
+  );
+}
+
 class MigrationManager {
   constructor(db, StorageError, logger = null) {
     this.db = db;
@@ -151,7 +159,7 @@ class MigrationManager {
           // sync_revision: tracks the last committed revision (from server-acknowledged
           // or server-received records). Does NOT include pending outgoing revisions.
           if (!db.objectStoreNames.contains("sync_revision")) {
-            const syncRevisionStore = db.createObjectStore("sync_revision", {
+            db.createObjectStore("sync_revision", {
               keyPath: "id",
             });
             transaction
@@ -279,7 +287,7 @@ class MigrationManager {
                 // Add default txType to token payments
                 if (details && details.type === "token" && !details.txType) {
                   details.txType = "transfer";
-                  payment.details = JSON.stringify(details);
+                  payment.details = toJson(details);
                   paymentStore.put(payment);
                 }
               });
@@ -300,7 +308,7 @@ class MigrationManager {
                   syncInfo.last_synced_final_token_payment_id = null;
                   settingsStore.put({
                     key: "sync_offset",
-                    value: JSON.stringify(syncInfo),
+                    value: toJson(syncInfo),
                   });
                 } catch (e) {
                   // If parsing fails, just continue
@@ -379,7 +387,7 @@ class MigrationManager {
                     expiryTime: 0,
                     status: htlcStatus,
                   };
-                  payment.details = JSON.stringify(details);
+                  payment.details = toJson(details);
                   paymentStore.put(payment);
                 }
               });
@@ -399,7 +407,7 @@ class MigrationManager {
                   syncInfo.offset = 0;
                   settingsStore.put({
                     key: "sync_offset",
-                    value: JSON.stringify(syncInfo),
+                    value: toJson(syncInfo),
                   });
                 } catch (e) {
                   // If parsing fails, just continue
@@ -535,7 +543,7 @@ class MigrationManager {
                   syncInfo.offset = 0;
                   settingsStore.put({
                     key: "sync_offset",
-                    value: JSON.stringify(syncInfo),
+                    value: toJson(syncInfo),
                   });
                 } catch (e) {
                   // If parsing fails, just continue
@@ -562,7 +570,7 @@ class MigrationManager {
                       : record.conversionInfo;
                     if (!ci.type) {
                       ci.type = "amm";
-                      record.conversionInfo = JSON.stringify(ci);
+                      record.conversionInfo = toJson(ci);
                       cursor.update(record);
                     }
                   } catch (e) {
@@ -624,6 +632,27 @@ class MigrationManager {
           }
         },
       },
+      {
+        // Leaf recoveries. What the chain service reported about leaves with
+        // funds to recover on-chain, and the recoveries the operators co-signed.
+        // Every block height is in chain_transactions, keyed by txid.
+        name: "Create leaf recovery stores",
+        upgrade: (db) => {
+          const keyPaths = {
+            leaf_recoveries: "leafId",
+            chain_transactions: "txid",
+            watchtower_exit_outputs: "leafId",
+            watchtower_exit_recoveries: ["leafId", "txid"],
+            watchtower_exit_spends: "leafId",
+            unilateral_exit_sweeps: "leafId",
+          };
+          for (const [name, keyPath] of Object.entries(keyPaths)) {
+            if (!db.objectStoreNames.contains(name)) {
+              db.createObjectStore(name, { keyPath });
+            }
+          }
+        },
+      },
     ];
   }
 }
@@ -652,7 +681,7 @@ class IndexedDBStorage {
     // so existing databases depend on indices never shifting. Never insert,
     // reorder, or delete a migration — only append. dbVersion MUST equal the
     // number of migrations (enforced by the guard in initialize()).
-    this.dbVersion = 22; // Current schema version (= migration count)
+    this.dbVersion = 23; // Current schema version (= migration count)
   }
 
   /**
@@ -976,7 +1005,7 @@ class IndexedDBStorage {
       cursorRequest.onerror = () => {
         reject(
           new StorageError(
-            `Failed to list payments (request: ${JSON.stringify(request)}: ${cursorRequest.error?.message || "Unknown error"
+            `Failed to list payments (request: ${toJson(request)}: ${cursorRequest.error?.message || "Unknown error"
             }`,
             cursorRequest.error
           )
@@ -1393,14 +1422,14 @@ class IndexedDBStorage {
           paymentId,
           parentPaymentId: metadata.parentPaymentId ?? existing.parentPaymentId ?? null,
           lnurlPayInfo: metadata.lnurlPayInfo
-            ? JSON.stringify(metadata.lnurlPayInfo)
+            ? toJson(metadata.lnurlPayInfo)
             : existing.lnurlPayInfo ?? null,
           lnurlWithdrawInfo: metadata.lnurlWithdrawInfo
-            ? JSON.stringify(metadata.lnurlWithdrawInfo)
+            ? toJson(metadata.lnurlWithdrawInfo)
             : existing.lnurlWithdrawInfo ?? null,
           lnurlDescription: metadata.lnurlDescription ?? existing.lnurlDescription ?? null,
           conversionInfo: metadata.conversionInfo
-            ? JSON.stringify(metadata.conversionInfo)
+            ? toJson(metadata.conversionInfo)
             : existing.conversionInfo ?? null,
           conversionStatus: metadata.conversionStatus ?? existing.conversionStatus ?? null,
         };
@@ -1575,25 +1604,25 @@ class IndexedDBStorage {
           return;
         }
 
-        let updatedDeposit = { ...existingDeposit };
+        const updatedDeposit = { ...existingDeposit };
 
         if (payload.type === "claimError") {
-          updatedDeposit.claimError = JSON.stringify(payload.error);
+          updatedDeposit.claimError = toJson(payload.error);
         } else if (payload.type === "refund") {
           updatedDeposit.refundTx = payload.refundTx;
           updatedDeposit.refundTxId = payload.refundTxid;
-          updatedDeposit.refundState = JSON.stringify(payload.state);
+          updatedDeposit.refundState = toJson(payload.state);
           updatedDeposit.claimError = null;
         } else if (payload.type === "instantClaim") {
-          updatedDeposit.instantClaimStatus = JSON.stringify(payload.status);
+          updatedDeposit.instantClaimStatus = toJson(payload.status);
         } else if (payload.type === "refundBroadcastState") {
           // Only while this is still the stored refund.
           if (existingDeposit.refundTxId === payload.refundTxid) {
-            updatedDeposit.refundState = JSON.stringify(payload.state);
+            updatedDeposit.refundState = toJson(payload.state);
           }
         } else if (payload.type === "maxClaimFee") {
           updatedDeposit.maxClaimFee = payload.maxFee
-            ? JSON.stringify(payload.maxFee)
+            ? toJson(payload.maxFee)
             : null;
         } else {
           reject(new StorageError(`Unknown payload type: ${payload.type}`));
@@ -1750,6 +1779,208 @@ class IndexedDBStorage {
     });
   }
 
+  async listLeafRecoveries() {
+    if (!this.db) {
+      throw new StorageError("Database not initialized");
+    }
+
+    return new Promise((resolve, reject) => {
+      const storeNames = [
+        "leaf_recoveries",
+        "chain_transactions",
+        "watchtower_exit_outputs",
+        "watchtower_exit_recoveries",
+        "watchtower_exit_spends",
+        "unilateral_exit_sweeps",
+      ];
+      const transaction = this.db.transaction(storeNames, "readonly");
+      const entries = {};
+      // getAll returns the entries of a store in key order: the leaf recoveries by
+      // leaf id, and the recoveries of a leaf by txid.
+      for (const name of storeNames) {
+        const request = transaction.objectStore(name).getAll();
+        request.onsuccess = () => {
+          entries[name] = request.result;
+        };
+      }
+
+      transaction.oncomplete = () => {
+        const blockHeights = new Map(
+          entries.chain_transactions.map((entry) => [
+            entry.txid,
+            entry.blockHeight,
+          ])
+        );
+        const chainTransaction = (entry) =>
+          entry && blockHeights.has(entry.txid)
+            ? { txid: entry.txid, blockHeight: blockHeights.get(entry.txid) }
+            : null;
+        const byLeafId = (name) =>
+          new Map(entries[name].map((entry) => [entry.leafId, entry]));
+        const outputs = byLeafId("watchtower_exit_outputs");
+        const spends = byLeafId("watchtower_exit_spends");
+        const sweeps = byLeafId("unilateral_exit_sweeps");
+        const recoveries = new Map();
+        for (const entry of entries.watchtower_exit_recoveries) {
+          if (!recoveries.has(entry.leafId)) {
+            recoveries.set(entry.leafId, []);
+          }
+          recoveries.get(entry.leafId).push({
+            txid: entry.txid,
+            transactionHex: entry.transactionHex,
+            outputAmountSats: entry.outputAmountSats,
+          });
+        }
+
+        resolve(
+          entries.leaf_recoveries.map(({ leafId, chainCheckedAt }) => {
+            const output = outputs.get(leafId);
+            return {
+              leafId,
+              chainCheckedAt,
+              watchtowerExitOutput:
+                output && blockHeights.has(output.txid)
+                  ? {
+                      txid: output.txid,
+                      vout: output.vout,
+                      amountSats: output.amountSats,
+                      scriptPubkey: output.scriptPubkey,
+                      blockHeight: blockHeights.get(output.txid),
+                    }
+                  : null,
+              watchtowerExitRecoveries: recoveries.get(leafId) ?? [],
+              watchtowerExitSpend: chainTransaction(spends.get(leafId)),
+              unilateralExitSweep: chainTransaction(sweeps.get(leafId)),
+            };
+          })
+        );
+      };
+      transaction.onabort = () =>
+        reject(
+          new StorageError(
+            `Failed to list leaf recoveries: ${transaction.error?.message || "Unknown error"}`,
+            transaction.error
+          )
+        );
+    });
+  }
+
+  async updateLeafRecovery(update) {
+    if (!this.db) {
+      throw new StorageError("Database not initialized");
+    }
+
+    return new Promise((resolve, reject) => {
+      const {
+        leafId,
+        chainCheckedAt,
+        watchtowerExitOutput: output,
+        watchtowerExitRecovery: recovery,
+        watchtowerExitSpend: spend,
+        unilateralExitSweep: sweep,
+      } = update;
+      const storeNames = ["leaf_recoveries"];
+      if (output != null) {
+        storeNames.push("watchtower_exit_outputs");
+      }
+      if (output != null || recovery != null) {
+        storeNames.push("watchtower_exit_recoveries");
+      }
+      if (output != null || spend != null) {
+        storeNames.push("watchtower_exit_spends");
+      }
+      if (sweep != null) {
+        storeNames.push("unilateral_exit_sweeps");
+      }
+      if (output != null || spend != null || sweep != null) {
+        storeNames.push("chain_transactions");
+      }
+      const transaction = this.db.transaction(storeNames, "readwrite");
+      const store = (name) => transaction.objectStore(name);
+
+      transaction.oncomplete = () => resolve();
+      transaction.onabort = () =>
+        reject(
+          new StorageError(
+            `Failed to update leaf recovery '${leafId}': ${transaction.error?.message || "Unknown error"}`,
+            transaction.error
+          )
+        );
+
+      const leafRecoveryRequest = store("leaf_recoveries").get(leafId);
+      leafRecoveryRequest.onsuccess = () => {
+        const stored = leafRecoveryRequest.result?.chainCheckedAt ?? null;
+        const later =
+          chainCheckedAt != null && (stored == null || chainCheckedAt > stored)
+            ? chainCheckedAt
+            : stored;
+        store("leaf_recoveries").put({ leafId, chainCheckedAt: later });
+      };
+
+      const setChainTransaction = ({ txid, blockHeight }) =>
+        store("chain_transactions").put({ txid, blockHeight });
+
+      const storeRecoverySpendSweep = () => {
+        if (recovery != null) {
+          const recoveries = store("watchtower_exit_recoveries");
+          const keyRequest = recoveries.getKey([leafId, recovery.txid]);
+          keyRequest.onsuccess = () => {
+            if (keyRequest.result === undefined) {
+              recoveries.put({
+                leafId,
+                txid: recovery.txid,
+                transactionHex: recovery.transactionHex,
+                outputAmountSats: recovery.outputAmountSats,
+              });
+            }
+          };
+        }
+        if (spend != null) {
+          setChainTransaction(spend);
+          store("watchtower_exit_spends").put({ leafId, txid: spend.txid });
+        }
+        if (sweep != null) {
+          setChainTransaction(sweep);
+          store("unilateral_exit_sweeps").put({ leafId, txid: sweep.txid });
+        }
+      };
+
+      if (output == null) {
+        storeRecoverySpendSweep();
+        return;
+      }
+
+      const outputs = store("watchtower_exit_outputs");
+      const outputRequest = outputs.get(leafId);
+      outputRequest.onsuccess = () => {
+        const stored = outputRequest.result;
+        if (
+          stored &&
+          (stored.txid !== output.txid || stored.vout !== output.vout)
+        ) {
+          // IndexedDB orders an array after every string, so the range holds
+          // every recovery of the leaf.
+          store("watchtower_exit_recoveries").delete(
+            IDBKeyRange.bound([leafId], [leafId, []])
+          );
+          store("watchtower_exit_spends").delete(leafId);
+        }
+        setChainTransaction(output);
+        outputs.put({
+          leafId,
+          txid: output.txid,
+          vout: output.vout,
+          amountSats: output.amountSats,
+          scriptPubkey: output.scriptPubkey,
+        });
+        // The browser runs a transaction's requests in the order this method
+        // makes them, so it stores the recovery and the spend of this update
+        // after it has deleted those of the output replaced.
+        storeRecoverySpendSweep();
+      };
+    });
+  }
+
   async setLnurlMetadata(metadata) {
     if (!this.db) {
       throw new StorageError("Database not initialized");
@@ -2489,8 +2720,8 @@ class IndexedDBStorage {
     // Ensure details and method are serialized properly
     return {
       ...payment,
-      details: payment.details ? JSON.stringify(payment.details) : null,
-      method: payment.method ? JSON.stringify(payment.method) : null,
+      details: payment.details ? toJson(payment.details) : null,
+      method: payment.method ? toJson(payment.method) : null,
     };
   }
 

package/bundler/tree-store/index.js

@@ -21,7 +21,7 @@ const RESERVATION_TIMEOUT_MS = 300 * 1000; // 5 minutes
 /** Spent-leaf markers older than this (relative to a refresh) are pruned. */
 const SPENT_MARKER_CLEANUP_THRESHOLD_MS = 5 * 60 * 1000; // 5 minutes
 
-const DB_VERSION = 5;
+const DB_VERSION = 6;
 
 const STORE_LEAVES = "leaves";
 const STORE_ANCESTORS = "ancestors";
@@ -111,6 +111,7 @@ class WebTreeStore {
           leaves.createIndex("chain_complete", "chain_complete", {
             unique: false,
           });
+          leaves.createIndex("status", "status", { unique: false });
         }
 
         // Intermediate exit-chain nodes, kept separate from the leaf pool and
@@ -134,8 +135,10 @@ class WebTreeStore {
         // An existing wallet gets the flag derived from the ancestor rows it
         // already holds, so it does not refetch every chain. The index is
         // created here and populated by the rewrite below, since createIndex
-        // cannot run from an async callback.
-        if (event.oldVersion > 0 && event.oldVersion < DB_VERSION) {
+        // cannot run from an async callback. The flag has had its current
+        // meaning since v5, so a database already at v5 or later keeps the
+        // flags it holds.
+        if (event.oldVersion > 0 && event.oldVersion < 5) {
           const tx = event.target.transaction;
           const leaves = tx.objectStore(STORE_LEAVES);
           if (!leaves.indexNames.contains("chain_complete")) {
@@ -168,6 +171,14 @@ class WebTreeStore {
           };
         }
 
+        // Every leaf row already carries its status, and IndexedDB builds a new
+        // index from the rows a store holds, so this needs no rewrite.
+        if (event.oldVersion > 0 && event.oldVersion < 6) {
+          event.target.transaction
+            .objectStore(STORE_LEAVES)
+            .createIndex("status", "status", { unique: false });
+        }
+
         if (!db.objectStoreNames.contains(STORE_RESERVATIONS)) {
           db.createObjectStore(STORE_RESERVATIONS, { keyPath: "id" });
         }
@@ -483,6 +494,31 @@ class WebTreeStore {
     }
   }
 
+  async getLeavesWithStatus(statuses) {
+    try {
+      const distinct = [...new Set(statuses)];
+      if (distinct.length === 0) return [];
+      return await this._txRun(
+        [STORE_LEAVES],
+        "readonly",
+        distinct.map((status) => ({
+          name: status,
+          store: STORE_LEAVES,
+          index: "status",
+          key: status,
+          all: true,
+        })),
+        (res) => distinct.flatMap((status) => res[status].map((row) => row.data))
+      );
+    } catch (error) {
+      if (error instanceof TreeStoreError) throw error;
+      throw new TreeStoreError(
+        `Failed to get leaves with status: ${error.message}`,
+        error
+      );
+    }
+  }
+
   async getAvailableBalance() {
     try {
       return await this._txRun(
@@ -940,9 +976,6 @@ class WebTreeStore {
             }
           }
 
-
-          const leafNodes = change.concat(reserved);
-
           // Change leaves go back to the available pool.
           for (const p of change) {
             const row = this._leafRow(p, false, leafMap.get(p.id));