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

package/nodejs/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/nodejs/index.js

@@ -35,6 +35,9 @@ try {
     if (error.code !== 'MODULE_NOT_FOUND') {
         console.warn('Breez SDK: Failed to load PostgreSQL storage:', error.message);
     }
+    // The WASM bridge builds every PostgreSQL store from a pool, so a caller that asks
+    // for PostgreSQL storage gets this load error.
+    global.createPostgresPool = () => { throw error; };
 }
 
 // Automatically import and set up the PostgreSQL tree store for Node.js
@@ -80,6 +83,9 @@ try {
     if (error.code !== 'MODULE_NOT_FOUND') {
         console.warn('Breez SDK: Failed to load MySQL storage:', error.message);
     }
+    // The WASM bridge builds every MySQL store from a pool, so a caller that asks
+    // for MySQL storage gets this load error.
+    global.createMysqlPool = () => { throw error; };
 }
 
 // Automatically import and set up the MySQL tree store for Node.js

package/nodejs/mysql-session-store/index.cjs

@@ -16,10 +16,12 @@ try {
   try {
     mysql = require("mysql2/promise");
   } catch (fallbackError) {
-    throw new Error(
+    const loadError = new Error(
       `mysql2 not found. Please install it in your project: npm install mysql2@^3.11.0\n` +
         `Original error: ${error.message}\nFallback error: ${fallbackError.message}`
     );
+    loadError.code = fallbackError.code;
+    throw loadError;
   }
 }
 

package/nodejs/mysql-storage/index.cjs

@@ -30,16 +30,26 @@ try {
   try {
     mysql = require("mysql2/promise");
   } catch (fallbackError) {
-    throw new Error(
+    const loadError = new Error(
       `mysql2 not found. Please install it in your project: npm install mysql2@^3.11.0\n` +
         `Original error: ${error.message}\nFallback error: ${fallbackError.message}`
     );
+    loadError.code = fallbackError.code;
+    throw loadError;
   }
 }
 
 const { StorageError } = require("./errors.cjs");
 const { MysqlMigrationManager } = require("./migrations.cjs");
 
+// 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
+  );
+}
+
 const PAYMENT_UPDATE_LOCK_TIMEOUT_SECS = 10;
 
 /**
@@ -120,6 +130,58 @@ function crossChainSwapFromRow(row) {
   };
 }
 
+/**
+ * A row holds a leaf recovery and one of its watchtower exit recoveries, so
+ * a leaf recovery with several of them spans several rows.
+ */
+function leafRecoveriesFromRows(rows) {
+  const leafRecoveries = [];
+  for (const row of rows) {
+    let leafRecovery = leafRecoveries[leafRecoveries.length - 1];
+    if (leafRecovery?.leafId !== row.leaf_id) {
+      leafRecovery = {
+        leafId: row.leaf_id,
+        chainCheckedAt:
+          row.chain_checked_at != null ? BigInt(row.chain_checked_at) : null,
+        watchtowerExitOutput:
+          row.output_block_height != null
+            ? {
+                txid: row.output_txid,
+                vout: Number(row.output_vout),
+                amountSats: BigInt(row.output_amount_sats),
+                scriptPubkey: row.output_script_pubkey,
+                blockHeight: Number(row.output_block_height),
+              }
+            : null,
+        watchtowerExitRecoveries: [],
+        watchtowerExitSpend:
+          row.spend_block_height != null
+            ? {
+                txid: row.spend_txid,
+                blockHeight: Number(row.spend_block_height),
+              }
+            : null,
+        unilateralExitSweep:
+          row.sweep_block_height != null
+            ? {
+                txid: row.sweep_txid,
+                blockHeight: Number(row.sweep_block_height),
+              }
+            : null,
+      };
+      leafRecoveries.push(leafRecovery);
+    }
+    if (row.recovery_txid != null) {
+      leafRecovery.watchtowerExitRecoveries.push({
+        txid: row.recovery_txid,
+        transactionHex: row.recovery_transaction_hex,
+        outputAmountSats: BigInt(row.recovery_output_amount_sats),
+      });
+    }
+  }
+  return leafRecoveries;
+}
+
 class MysqlStorage {
   /**
    * @param {import('mysql2/promise').Pool} pool - Connection pool (may be shared with other tenants).
@@ -403,7 +465,7 @@ class MysqlStorage {
     } catch (error) {
       if (error instanceof StorageError) throw error;
       throw new StorageError(
-        `Failed to list payments (request: ${JSON.stringify(request)}): ${error.message}`,
+        `Failed to list payments (request: ${toJson(request)}): ${error.message}`,
         error
       );
     }
@@ -528,7 +590,7 @@ class MysqlStorage {
         payment.amount.toString(),
         payment.fees.toString(),
         payment.timestamp,
-        payment.method ? JSON.stringify(payment.method) : null,
+        payment.method ? toJson(payment.method) : null,
         withdrawTxId,
         spark,
       ]
@@ -560,10 +622,10 @@ class MysqlStorage {
           this.identity,
           payment.id,
           payment.details.invoiceDetails
-            ? JSON.stringify(payment.details.invoiceDetails)
+            ? toJson(payment.details.invoiceDetails)
             : null,
           payment.details.htlcDetails
-            ? JSON.stringify(payment.details.htlcDetails)
+            ? toJson(payment.details.htlcDetails)
             : null,
         ]
       );
@@ -609,11 +671,11 @@ class MysqlStorage {
         [
           this.identity,
           payment.id,
-          JSON.stringify(payment.details.metadata),
+          toJson(payment.details.metadata),
           payment.details.txHash,
           payment.details.txType,
           payment.details.invoiceDetails
-            ? JSON.stringify(payment.details.invoiceDetails)
+            ? toJson(payment.details.invoiceDetails)
             : null,
         ]
       );
@@ -746,14 +808,14 @@ class MysqlStorage {
           paymentId,
           metadata.parentPaymentId,
           metadata.lnurlPayInfo
-            ? JSON.stringify(metadata.lnurlPayInfo)
+            ? toJson(metadata.lnurlPayInfo)
             : null,
           metadata.lnurlWithdrawInfo
-            ? JSON.stringify(metadata.lnurlWithdrawInfo)
+            ? toJson(metadata.lnurlWithdrawInfo)
             : null,
           metadata.lnurlDescription,
           metadata.conversionInfo
-            ? JSON.stringify(metadata.conversionInfo)
+            ? toJson(metadata.conversionInfo)
             : null,
           metadata.conversionStatus ?? null,
         ]
@@ -833,7 +895,7 @@ class MysqlStorage {
           `UPDATE brz_unclaimed_deposits
            SET claim_error = ?
            WHERE user_id = ? AND txid = ? AND vout = ?`,
-          [JSON.stringify(payload.error), this.identity, txid, vout]
+          [toJson(payload.error), this.identity, txid, vout]
         );
       } else if (payload.type === "refund") {
         await this.pool.query(
@@ -843,7 +905,7 @@ class MysqlStorage {
           [
             payload.refundTx,
             payload.refundTxid,
-            JSON.stringify(payload.state),
+            toJson(payload.state),
             this.identity,
             txid,
             vout,
@@ -854,7 +916,7 @@ class MysqlStorage {
           `UPDATE brz_unclaimed_deposits
            SET instant_claim_status = ?
            WHERE user_id = ? AND txid = ? AND vout = ?`,
-          [JSON.stringify(payload.status), this.identity, txid, vout]
+          [toJson(payload.status), this.identity, txid, vout]
         );
       } else if (payload.type === "refundBroadcastState") {
         await this.pool.query(
@@ -862,7 +924,7 @@ class MysqlStorage {
            SET refund_state = ?
            WHERE user_id = ? AND txid = ? AND vout = ? AND refund_tx_id = ?`,
           [
-            JSON.stringify(payload.state),
+            toJson(payload.state),
             this.identity,
             txid,
             vout,
@@ -875,7 +937,7 @@ class MysqlStorage {
            SET max_claim_fee = ?
            WHERE user_id = ? AND txid = ? AND vout = ?`,
           [
-            payload.maxFee ? JSON.stringify(payload.maxFee) : null,
+            payload.maxFee ? toJson(payload.maxFee) : null,
             this.identity,
             txid,
             vout,
@@ -946,6 +1008,163 @@ class MysqlStorage {
     }
   }
 
+  async listLeafRecoveries() {
+    try {
+      const [rows] = await this.pool.query(
+        `SELECT l.leaf_id,
+                l.chain_checked_at,
+                o.txid AS output_txid,
+                o.vout AS output_vout,
+                o.amount_sats AS output_amount_sats,
+                o.script_pubkey AS output_script_pubkey,
+                ot.block_height AS output_block_height,
+                s.txid AS spend_txid,
+                st.block_height AS spend_block_height,
+                w.txid AS sweep_txid,
+                wt.block_height AS sweep_block_height,
+                r.txid AS recovery_txid,
+                r.transaction_hex AS recovery_transaction_hex,
+                r.output_amount_sats AS recovery_output_amount_sats
+           FROM brz_leaf_recoveries l
+           LEFT JOIN brz_watchtower_exit_outputs o
+             ON o.user_id = l.user_id AND o.leaf_id = l.leaf_id
+           LEFT JOIN brz_chain_transactions ot
+             ON ot.user_id = o.user_id AND ot.txid = o.txid
+           LEFT JOIN brz_watchtower_exit_spends s
+             ON s.user_id = l.user_id AND s.leaf_id = l.leaf_id
+           LEFT JOIN brz_chain_transactions st
+             ON st.user_id = s.user_id AND st.txid = s.txid
+           LEFT JOIN brz_unilateral_exit_sweeps w
+             ON w.user_id = l.user_id AND w.leaf_id = l.leaf_id
+           LEFT JOIN brz_chain_transactions wt
+             ON wt.user_id = w.user_id AND wt.txid = w.txid
+           LEFT JOIN brz_watchtower_exit_recoveries r
+             ON r.user_id = l.user_id AND r.leaf_id = l.leaf_id
+           WHERE l.user_id = ?
+           ORDER BY l.leaf_id, r.txid`,
+        [this.identity]
+      );
+      return leafRecoveriesFromRows(rows);
+    } catch (error) {
+      throw new StorageError(
+        `Failed to list leaf recoveries: ${error.message}`,
+        error
+      );
+    }
+  }
+
+  async updateLeafRecovery(update) {
+    try {
+      const leafId = update.leafId;
+      await this._withTransaction(async (conn) => {
+        const setChainTransaction = (txid, blockHeight) =>
+          conn.query(
+            `INSERT INTO brz_chain_transactions (user_id, txid, block_height)
+               VALUES (?, ?, ?)
+               ON DUPLICATE KEY UPDATE block_height = VALUES(block_height)`,
+            [this.identity, txid, blockHeight]
+          );
+
+        // MySQL locks the leaf's row, so writers of one leaf do not interleave.
+        await conn.query(
+          `INSERT INTO brz_leaf_recoveries (user_id, leaf_id) VALUES (?, ?)
+             ON DUPLICATE KEY UPDATE leaf_id = leaf_id`,
+          [this.identity, leafId]
+        );
+        if (update.chainCheckedAt != null) {
+          // The parameter is a string, and MySQL would compare it with the
+          // stored time as strings. CAST makes MySQL compare them as numbers.
+          await conn.query(
+            `UPDATE brz_leaf_recoveries
+               SET chain_checked_at =
+                 GREATEST(COALESCE(chain_checked_at, 0), CAST(? AS SIGNED))
+               WHERE user_id = ? AND leaf_id = ?`,
+            [String(update.chainCheckedAt), this.identity, leafId]
+          );
+        }
+        if (update.watchtowerExitOutput != null) {
+          const output = update.watchtowerExitOutput;
+          for (const table of [
+            "brz_watchtower_exit_recoveries",
+            "brz_watchtower_exit_spends",
+          ]) {
+            await conn.query(
+              `DELETE FROM ${table}
+                 WHERE user_id = ? AND leaf_id = ? AND EXISTS (
+                   SELECT 1 FROM brz_watchtower_exit_outputs
+                   WHERE user_id = ? AND leaf_id = ? AND (txid <> ? OR vout <> ?))`,
+              [
+                this.identity,
+                leafId,
+                this.identity,
+                leafId,
+                output.txid,
+                output.vout,
+              ]
+            );
+          }
+          await setChainTransaction(output.txid, output.blockHeight);
+          await conn.query(
+            `INSERT INTO brz_watchtower_exit_outputs
+                 (user_id, leaf_id, txid, vout, amount_sats, script_pubkey)
+               VALUES (?, ?, ?, ?, ?, ?)
+               ON DUPLICATE KEY UPDATE
+                 txid = VALUES(txid),
+                 vout = VALUES(vout),
+                 amount_sats = VALUES(amount_sats),
+                 script_pubkey = VALUES(script_pubkey)`,
+            [
+              this.identity,
+              leafId,
+              output.txid,
+              output.vout,
+              String(output.amountSats),
+              output.scriptPubkey,
+            ]
+          );
+        }
+        if (update.watchtowerExitRecovery != null) {
+          const recovery = update.watchtowerExitRecovery;
+          await conn.query(
+            `INSERT INTO brz_watchtower_exit_recoveries
+                 (user_id, leaf_id, txid, transaction_hex, output_amount_sats)
+               VALUES (?, ?, ?, ?, ?)
+               ON DUPLICATE KEY UPDATE txid = txid`,
+            [
+              this.identity,
+              leafId,
+              recovery.txid,
+              recovery.transactionHex,
+              String(recovery.outputAmountSats),
+            ]
+          );
+        }
+        for (const [table, chainTransaction] of [
+          ["brz_watchtower_exit_spends", update.watchtowerExitSpend],
+          ["brz_unilateral_exit_sweeps", update.unilateralExitSweep],
+        ]) {
+          if (chainTransaction == null) {
+            continue;
+          }
+          await setChainTransaction(
+            chainTransaction.txid,
+            chainTransaction.blockHeight
+          );
+          await conn.query(
+            `INSERT INTO ${table} (user_id, leaf_id, txid) VALUES (?, ?, ?)
+               ON DUPLICATE KEY UPDATE txid = VALUES(txid)`,
+            [this.identity, leafId, chainTransaction.txid]
+          );
+        }
+      });
+    } catch (error) {
+      throw new StorageError(
+        `Failed to update leaf recovery '${update.leafId}': ${error.message}`,
+        error
+      );
+    }
+  }
+
   async setLnurlMetadata(metadata) {
     try {
       await this._withTransaction(async (conn) => {
@@ -1268,7 +1487,7 @@ class MysqlStorage {
             record.id.dataId,
             record.schemaVersion,
             Math.floor(Date.now() / 1000),
-            JSON.stringify(record.updatedFields),
+            toJson(record.updatedFields),
             revision.toString(),
           ]
         );
@@ -1297,7 +1516,6 @@ class MysqlStorage {
           if (this.logger && typeof this.logger.log === "function") {
             this.logger.log({ line: msg, level: "warn" });
           } else {
-            // eslint-disable-next-line no-console
             console.warn(`[MysqlStorage] ${msg}`);
           }
         }
@@ -1324,7 +1542,7 @@ class MysqlStorage {
             record.revision.toString(),
             record.schemaVersion,
             Math.floor(Date.now() / 1000),
-            JSON.stringify(record.data),
+            toJson(record.data),
           ]
         );
 
@@ -1441,7 +1659,7 @@ class MysqlStorage {
               record.id.dataId,
               record.schemaVersion,
               Math.floor(Date.now() / 1000),
-              JSON.stringify(record.data),
+              toJson(record.data),
               record.revision.toString(),
             ]
           );
@@ -1604,7 +1822,7 @@ class MysqlStorage {
             record.revision.toString(),
             record.schemaVersion,
             Math.floor(Date.now() / 1000),
-            JSON.stringify(record.data),
+            toJson(record.data),
           ]
         );
 

package/nodejs/mysql-storage/migrations.cjs

@@ -149,7 +149,6 @@ class MysqlMigrationManager {
     if (this.logger && typeof this.logger.log === "function") {
       this.logger.log({ line: message, level });
     } else if (level === "error") {
-      // eslint-disable-next-line no-console
       console.error(`[MysqlMigrationManager] ${message}`);
     }
   }
@@ -607,6 +606,55 @@ class MysqlMigrationManager {
           `ALTER TABLE brz_unclaimed_deposits ADD COLUMN max_claim_fee JSON NULL`,
         ],
       },
+      {
+        // 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 brz_chain_transactions, keyed by txid.
+        name: "Add leaf recovery tables",
+        sql: [
+          `CREATE TABLE IF NOT EXISTS brz_leaf_recoveries (
+              user_id VARBINARY(33) NOT NULL,
+              leaf_id VARCHAR(255) NOT NULL,
+              chain_checked_at BIGINT,
+              PRIMARY KEY (user_id, leaf_id)
+          )`,
+          `CREATE TABLE IF NOT EXISTS brz_chain_transactions (
+              user_id VARBINARY(33) NOT NULL,
+              txid VARCHAR(255) NOT NULL,
+              block_height BIGINT NOT NULL,
+              PRIMARY KEY (user_id, txid)
+          )`,
+          `CREATE TABLE IF NOT EXISTS brz_watchtower_exit_outputs (
+              user_id VARBINARY(33) NOT NULL,
+              leaf_id VARCHAR(255) NOT NULL,
+              txid VARCHAR(255) NOT NULL,
+              vout BIGINT NOT NULL,
+              amount_sats BIGINT NOT NULL,
+              script_pubkey TEXT NOT NULL,
+              PRIMARY KEY (user_id, leaf_id)
+          )`,
+          `CREATE TABLE IF NOT EXISTS brz_watchtower_exit_recoveries (
+              user_id VARBINARY(33) NOT NULL,
+              leaf_id VARCHAR(255) NOT NULL,
+              txid VARCHAR(255) NOT NULL,
+              transaction_hex TEXT NOT NULL,
+              output_amount_sats BIGINT NOT NULL,
+              PRIMARY KEY (user_id, leaf_id, txid)
+          )`,
+          `CREATE TABLE IF NOT EXISTS brz_watchtower_exit_spends (
+              user_id VARBINARY(33) NOT NULL,
+              leaf_id VARCHAR(255) NOT NULL,
+              txid VARCHAR(255) NOT NULL,
+              PRIMARY KEY (user_id, leaf_id)
+          )`,
+          `CREATE TABLE IF NOT EXISTS brz_unilateral_exit_sweeps (
+              user_id VARBINARY(33) NOT NULL,
+              leaf_id VARCHAR(255) NOT NULL,
+              txid VARCHAR(255) NOT NULL,
+              PRIMARY KEY (user_id, leaf_id)
+          )`,
+        ],
+      },
     ];
   }
 }

package/nodejs/mysql-token-store/index.cjs

@@ -17,10 +17,12 @@ try {
   try {
     mysql = require("mysql2/promise");
   } catch (fallbackError) {
-    throw new Error(
+    const loadError = new Error(
       `mysql2 not found. Please install it in your project: npm install mysql2@^3.11.0\n` +
         `Original error: ${error.message}\nFallback error: ${fallbackError.message}`
     );
+    loadError.code = fallbackError.code;
+    throw loadError;
   }
 }
 
@@ -50,12 +52,6 @@ function _identityLockName(prefix, identity) {
   return prefix + hash.digest("hex").slice(0, 16);
 }
 
-function parseJson(value) {
-  if (value == null) return null;
-  if (typeof value === "string") return JSON.parse(value);
-  return value;
-}
-
 function toBool(value) {
   if (value == null) return null;
   if (typeof value === "boolean") return value;

package/nodejs/mysql-tree-store/index.cjs

@@ -22,10 +22,12 @@ try {
   try {
     mysql = require("mysql2/promise");
   } catch (fallbackError) {
-    throw new Error(
+    const loadError = new Error(
       `mysql2 not found. Please install it in your project: npm install mysql2@^3.11.0\n` +
         `Original error: ${error.message}\nFallback error: ${fallbackError.message}`
     );
+    loadError.code = fallbackError.code;
+    throw loadError;
   }
 }
 
@@ -516,6 +518,29 @@ class MysqlTreeStore {
     }
   }
 
+  /**
+   * Return the leaves, reserved or not, whose status is one of `statuses`.
+   * @param {Array<string>} statuses
+   * @returns {Promise<Array<object>>}
+   */
+  async getLeavesWithStatus(statuses) {
+    try {
+      if (!statuses || statuses.length === 0) return [];
+      const [rows] = await this.pool.query(
+        `SELECT data FROM brz_tree_leaves
+         WHERE user_id = ? AND status IN (${buildPlaceholders(statuses.length)})`,
+        [this.identity, ...statuses]
+      );
+      return rows.map((row) => parseJson(row.data));
+    } catch (error) {
+      if (error instanceof TreeStoreError) throw error;
+      throw new TreeStoreError(
+        `Failed to get leaves with status: ${error.message}`,
+        error
+      );
+    }
+  }
+
   /**
    * Set leaves from a refresh operation.
    * @param {Array} leaves - Available leaves from operators