@breeztech/breez-sdk-spark 0.25.0 → 0.27.0-dev1

package/nodejs/breez_sdk_spark_wasm.js

@@ -1974,6 +1974,24 @@ function newSharedSdkContext(config) {
 }
 exports.newSharedSdkContext = newSharedSdkContext;
 
+/**
+ * Reads a `SparkConfig` from JSON, for a deployment that publishes its
+ * operators, service provider and certificates as a file. Set it on
+ * `Config.sparkConfig` to connect a wallet to that deployment.
+ * @param {string} json
+ * @returns {SparkConfig}
+ */
+function parseSparkConfig(json) {
+    const ptr0 = passStringToWasm0(json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.parseSparkConfig(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+exports.parseSparkConfig = parseSparkConfig;
+
 /**
  * `PostgreSQL`-backed storage built from `config`.
  * @param {PostgresStorageConfig} config
@@ -2935,6 +2953,10 @@ function __wbg_get_imports() {
             const ret = arg0.listTokensOutputs();
             return ret;
         }, arguments); },
+        __wbg_listWatchedDepositAddresses_55fe8af0643e3ea9: function() { return handleError(function (arg0) {
+            const ret = arg0.listWatchedDepositAddresses();
+            return ret;
+        }, arguments); },
         __wbg_log_cf86719f8acabfda: function(arg0, arg1) {
             arg0.log(arg1);
         },
@@ -3634,6 +3656,18 @@ function __wbg_get_imports() {
             const ret = arg0.updateTokenOutputs(arg1, arg2);
             return ret;
         }, arguments); },
+        __wbg_updateWatchedDepositAddress_260322f77dee1443: function() { return handleError(function (arg0, arg1, arg2, arg3) {
+            let deferred0_0;
+            let deferred0_1;
+            try {
+                deferred0_0 = arg1;
+                deferred0_1 = arg2;
+                const ret = arg0.updateWatchedDepositAddress(getStringFromWasm0(arg1, arg2), arg3);
+                return ret;
+            } finally {
+                wasm.__wbindgen_free(deferred0_0, deferred0_1, 1);
+            }
+        }, arguments); },
         __wbg_url_68fd9a221360e0db: function(arg0, arg1) {
             const ret = arg1.url;
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -3669,47 +3703,47 @@ function __wbg_get_imports() {
             return ret;
         },
         __wbindgen_cast_0000000000000001: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 22, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 21, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375);
             return ret;
         },
         __wbindgen_cast_0000000000000002: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 397, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [Externref], shim_idx: 384, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h3b28fbbc8b451a25);
             return ret;
         },
         __wbindgen_cast_0000000000000003: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("CloseEvent")], shim_idx: 397, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("CloseEvent")], shim_idx: 384, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h3b28fbbc8b451a25_2);
             return ret;
         },
         __wbindgen_cast_0000000000000004: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 397, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("MessageEvent")], shim_idx: 384, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h3b28fbbc8b451a25_3);
             return ret;
         },
         __wbindgen_cast_0000000000000005: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("SessionStore")], shim_idx: 22, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_4);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("SessionStore")], shim_idx: 21, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_4);
             return ret;
         },
         __wbindgen_cast_0000000000000006: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("Storage")], shim_idx: 22, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_5);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("Storage")], shim_idx: 21, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_5);
             return ret;
         },
         __wbindgen_cast_0000000000000007: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("TokenStore")], shim_idx: 22, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_6);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("TokenStore")], shim_idx: 21, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_6);
             return ret;
         },
         __wbindgen_cast_0000000000000008: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("TreeStore")], shim_idx: 22, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
-            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_7);
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [NamedExternref("TreeStore")], shim_idx: 21, ret: Result(Unit), inner_ret: Some(Result(Unit)) }, mutable: true }) -> Externref`.
+            const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_7);
             return ret;
         },
         __wbindgen_cast_0000000000000009: function(arg0, arg1) {
-            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 402, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+            // Cast intrinsic for `Closure(Closure { owned: true, function: Function { arguments: [], shim_idx: 388, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
             const ret = makeMutClosure(arg0, arg1, wasm_bindgen__convert__closures_____invoke__h484cd36e13f37bd7);
             return ret;
         },
@@ -3817,36 +3851,36 @@ function wasm_bindgen__convert__closures_____invoke__h3b28fbbc8b451a25_3(arg0, a
     wasm.wasm_bindgen__convert__closures_____invoke__h3b28fbbc8b451a25_3(arg0, arg1, arg2);
 }
 
-function wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522(arg0, arg1, arg2) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375(arg0, arg1, arg2) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375(arg0, arg1, arg2);
     if (ret[1]) {
         throw takeFromExternrefTable0(ret[0]);
     }
 }
 
-function wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_4(arg0, arg1, arg2) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_4(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_4(arg0, arg1, arg2) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_4(arg0, arg1, arg2);
     if (ret[1]) {
         throw takeFromExternrefTable0(ret[0]);
     }
 }
 
-function wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_5(arg0, arg1, arg2) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_5(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_5(arg0, arg1, arg2) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_5(arg0, arg1, arg2);
     if (ret[1]) {
         throw takeFromExternrefTable0(ret[0]);
     }
 }
 
-function wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_6(arg0, arg1, arg2) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_6(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_6(arg0, arg1, arg2) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_6(arg0, arg1, arg2);
     if (ret[1]) {
         throw takeFromExternrefTable0(ret[0]);
     }
 }
 
-function wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_7(arg0, arg1, arg2) {
-    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_7(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_7(arg0, arg1, arg2) {
+    const ret = wasm.wasm_bindgen__convert__closures_____invoke__h0a7e586e9273e375_7(arg0, arg1, arg2);
     if (ret[1]) {
         throw takeFromExternrefTable0(ret[0]);
     }

package/nodejs/breez_sdk_spark_wasm_bg.wasm.d.ts

@@ -128,6 +128,7 @@ export const initLogging: (a: any, b: number, c: number) => any;
 export const mysqlStorage: (a: any) => number;
 export const newRestChainService: (a: number, b: number, c: any, d: any, e: number) => any;
 export const newSharedSdkContext: (a: any) => any;
+export const parseSparkConfig: (a: number, b: number) => [number, number, number];
 export const passkeyclient_checkAvailability: (a: number) => any;
 export const passkeyclient_connectWithPasskey: (a: number, b: any) => any;
 export const passkeyclient_labels: (a: number) => number;
@@ -189,11 +190,11 @@ export const __wbg_externalsparksignerhandle_free: (a: number, b: number) => voi
 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__h62bc116e0c266522: (a: number, b: number, c: any) => [number, number];
-export const wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_4: (a: number, b: number, c: any) => [number, number];
-export const wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_5: (a: number, b: number, c: any) => [number, number];
-export const wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_6: (a: number, b: number, c: any) => [number, number];
-export const wasm_bindgen__convert__closures_____invoke__h62bc116e0c266522_7: (a: number, b: number, c: any) => [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;

package/nodejs/index.mjs

@@ -21,6 +21,7 @@ export const {
   mysqlStorage,
   newRestChainService,
   newSharedSdkContext,
+  parseSparkConfig,
   postgresStorage,
   singleKeyCpfpSigner,
   start,

package/nodejs/mysql-storage/index.cjs

@@ -801,7 +801,7 @@ class MysqlStorage {
   async listDeposits() {
     try {
       const [rows] = await this.pool.query(
-        "SELECT txid, vout, amount_sats, is_mature, claim_error, refund_tx, refund_tx_id, instant_claim_status, refund_state FROM brz_unclaimed_deposits WHERE user_id = ?",
+        "SELECT txid, vout, amount_sats, is_mature, claim_error, refund_tx, refund_tx_id, instant_claim_status, refund_state, max_claim_fee FROM brz_unclaimed_deposits WHERE user_id = ?",
         [this.identity]
       );
 
@@ -816,6 +816,7 @@ class MysqlStorage {
         refundTxId: row.refund_tx_id,
         instantClaimStatus: parseJson(row.instant_claim_status),
         refundState: parseJson(row.refund_state),
+        maxClaimFee: parseJson(row.max_claim_fee),
       }));
     } catch (error) {
       throw new StorageError(
@@ -868,6 +869,18 @@ class MysqlStorage {
             payload.refundTxid,
           ]
         );
+      } else if (payload.type === "maxClaimFee") {
+        await this.pool.query(
+          `UPDATE brz_unclaimed_deposits
+           SET max_claim_fee = ?
+           WHERE user_id = ? AND txid = ? AND vout = ?`,
+          [
+            payload.maxFee ? JSON.stringify(payload.maxFee) : null,
+            this.identity,
+            txid,
+            vout,
+          ]
+        );
       } else {
         throw new StorageError(`Unknown payload type: ${payload.type}`);
       }
@@ -880,6 +893,59 @@ class MysqlStorage {
     }
   }
 
+  async listWatchedDepositAddresses() {
+    try {
+      const [rows] = await this.pool.query(
+        `SELECT address, issued_at, seen FROM brz_watched_deposit_addresses
+           WHERE user_id = ? ORDER BY issued_at DESC`,
+        [this.identity]
+      );
+      return rows.map((row) => ({
+        address: row.address,
+        issuedAt: BigInt(row.issued_at),
+        seen: toBool(row.seen) ?? false,
+      }));
+    } catch (error) {
+      throw new StorageError(
+        `Failed to list watched deposit addresses: ${error.message}`,
+        error
+      );
+    }
+  }
+
+  async updateWatchedDepositAddress(address, payload) {
+    try {
+      if (payload.type === "watch") {
+        await this.pool.query(
+          `INSERT INTO brz_watched_deposit_addresses (user_id, address, issued_at, seen)
+             VALUES (?, ?, ?, FALSE)
+             ON DUPLICATE KEY UPDATE issued_at = VALUES(issued_at), seen = FALSE`,
+          [this.identity, address, String(payload.issuedAt)]
+        );
+      } else if (payload.type === "seen") {
+        await this.pool.query(
+          `UPDATE brz_watched_deposit_addresses SET seen = TRUE
+             WHERE user_id = ? AND address = ?`,
+          [this.identity, address]
+        );
+      } else if (payload.type === "unwatch") {
+        await this.pool.query(
+          `DELETE FROM brz_watched_deposit_addresses
+             WHERE user_id = ? AND address = ? AND issued_at = ?`,
+          [this.identity, address, String(payload.issuedAt)]
+        );
+      } else {
+        throw new StorageError(`Unknown payload type: ${payload.type}`);
+      }
+    } catch (error) {
+      if (error instanceof StorageError) throw error;
+      throw new StorageError(
+        `Failed to update watched deposit address '${address}': ${error.message}`,
+        error
+      );
+    }
+  }
+
   async setLnurlMetadata(metadata) {
     try {
       await this._withTransaction(async (conn) => {

package/nodejs/mysql-storage/migrations.cjs

@@ -584,6 +584,29 @@ class MysqlMigrationManager {
           `ALTER TABLE brz_unclaimed_deposits ADD COLUMN refund_state JSON NULL`,
         ],
       },
+      {
+        // Deposit addresses polled on-chain for deposits still in the mempool.
+        // Rows are removed once watching them can no longer lead to an early
+        // claim, so the table holds only the live watch set.
+        name: "Add brz_watched_deposit_addresses",
+        sql: [
+          `CREATE TABLE IF NOT EXISTS brz_watched_deposit_addresses (
+              user_id VARBINARY(33) NOT NULL,
+              address VARCHAR(255) NOT NULL,
+              issued_at BIGINT NOT NULL,
+              seen BOOLEAN NOT NULL DEFAULT FALSE,
+              PRIMARY KEY (user_id, address)
+          )`,
+        ],
+      },
+      {
+        // The fee ceiling standing for one deposit as a JSON-encoded MaxFee,
+        // overriding the configured one. NULL when the configured one applies.
+        name: "Add max claim fee to brz_unclaimed_deposits",
+        sql: [
+          `ALTER TABLE brz_unclaimed_deposits ADD COLUMN max_claim_fee JSON NULL`,
+        ],
+      },
     ];
   }
 }

package/nodejs/postgres-storage/index.cjs

@@ -730,7 +730,7 @@ class PostgresStorage {
   async listDeposits() {
     try {
       const result = await this.pool.query(
-        "SELECT txid, vout, amount_sats, is_mature, claim_error, refund_tx, refund_tx_id, instant_claim_status, refund_state FROM brz_unclaimed_deposits WHERE user_id = $1",
+        "SELECT txid, vout, amount_sats, is_mature, claim_error, refund_tx, refund_tx_id, instant_claim_status, refund_state, max_claim_fee FROM brz_unclaimed_deposits WHERE user_id = $1",
         [this.identity]
       );
 
@@ -744,6 +744,7 @@ class PostgresStorage {
         refundTxId: row.refund_tx_id,
         instantClaimStatus: row.instant_claim_status || null,
         refundState: row.refund_state || null,
+        maxClaimFee: row.max_claim_fee || null,
       }));
     } catch (error) {
       throw new StorageError(
@@ -796,6 +797,18 @@ class PostgresStorage {
             payload.refundTxid,
           ]
         );
+      } else if (payload.type === "maxClaimFee") {
+        await this.pool.query(
+          `UPDATE brz_unclaimed_deposits
+           SET max_claim_fee = $1
+           WHERE user_id = $2 AND txid = $3 AND vout = $4`,
+          [
+            payload.maxFee ? JSON.stringify(payload.maxFee) : null,
+            this.identity,
+            txid,
+            vout,
+          ]
+        );
       } else {
         throw new StorageError(`Unknown payload type: ${payload.type}`);
       }
@@ -808,6 +821,59 @@ class PostgresStorage {
     }
   }
 
+  async listWatchedDepositAddresses() {
+    try {
+      const result = await this.pool.query(
+        `SELECT address, issued_at, seen FROM brz_watched_deposit_addresses
+           WHERE user_id = $1 ORDER BY issued_at DESC`,
+        [this.identity]
+      );
+      return result.rows.map((row) => ({
+        address: row.address,
+        issuedAt: BigInt(row.issued_at),
+        seen: row.seen ?? false,
+      }));
+    } catch (error) {
+      throw new StorageError(
+        `Failed to list watched deposit addresses: ${error.message}`,
+        error
+      );
+    }
+  }
+
+  async updateWatchedDepositAddress(address, payload) {
+    try {
+      if (payload.type === "watch") {
+        await this.pool.query(
+          `INSERT INTO brz_watched_deposit_addresses (user_id, address, issued_at, seen)
+             VALUES ($1, $2, $3, FALSE)
+             ON CONFLICT(user_id, address) DO UPDATE SET issued_at = EXCLUDED.issued_at, seen = FALSE`,
+          [this.identity, address, String(payload.issuedAt)]
+        );
+      } else if (payload.type === "seen") {
+        await this.pool.query(
+          `UPDATE brz_watched_deposit_addresses SET seen = TRUE
+             WHERE user_id = $1 AND address = $2`,
+          [this.identity, address]
+        );
+      } else if (payload.type === "unwatch") {
+        await this.pool.query(
+          `DELETE FROM brz_watched_deposit_addresses
+             WHERE user_id = $1 AND address = $2 AND issued_at = $3`,
+          [this.identity, address, String(payload.issuedAt)]
+        );
+      } else {
+        throw new StorageError(`Unknown payload type: ${payload.type}`);
+      }
+    } catch (error) {
+      if (error instanceof StorageError) throw error;
+      throw new StorageError(
+        `Failed to update watched deposit address '${address}': ${error.message}`,
+        error
+      );
+    }
+  }
+
   async setLnurlMetadata(metadata) {
     try {
       await this._withTransaction(async (client) => {

package/nodejs/postgres-storage/migrations.cjs

@@ -540,6 +540,29 @@ class PostgresMigrationManager {
           `ALTER TABLE brz_unclaimed_deposits ADD COLUMN refund_state JSONB`,
         ],
       },
+      {
+        // Deposit addresses polled on-chain for deposits still in the mempool.
+        // Rows are removed once watching them can no longer lead to an early
+        // claim, so the table holds only the live watch set.
+        name: "Add brz_watched_deposit_addresses",
+        sql: [
+          `CREATE TABLE IF NOT EXISTS brz_watched_deposit_addresses (
+              user_id BYTEA NOT NULL,
+              address TEXT NOT NULL,
+              issued_at BIGINT NOT NULL,
+              seen BOOLEAN NOT NULL DEFAULT FALSE,
+              PRIMARY KEY (user_id, address)
+          )`,
+        ],
+      },
+      {
+        // The fee ceiling standing for one deposit as a JSON-encoded MaxFee,
+        // overriding the configured one. NULL when the configured one applies.
+        name: "Add max claim fee to brz_unclaimed_deposits",
+        sql: [
+          `ALTER TABLE brz_unclaimed_deposits ADD COLUMN max_claim_fee JSONB`,
+        ],
+      },
     ];
   }
 }

package/nodejs/storage/index.cjs

@@ -700,7 +700,7 @@ class SqliteStorage {
   listDeposits() {
     try {
       const stmt = this.db.prepare(`
-                SELECT txid, vout, amount_sats, is_mature, claim_error, refund_tx, refund_tx_id, instant_claim_status, refund_state
+                SELECT txid, vout, amount_sats, is_mature, claim_error, refund_tx, refund_tx_id, instant_claim_status, refund_state, max_claim_fee
                 FROM unclaimed_deposits
             `);
 
@@ -718,6 +718,9 @@ class SqliteStorage {
             ? JSON.parse(row.instant_claim_status)
             : null,
           refundState: row.refund_state ? JSON.parse(row.refund_state) : null,
+          maxClaimFee: row.max_claim_fee
+            ? JSON.parse(row.max_claim_fee)
+            : null,
         }))
       );
     } catch (error) {
@@ -767,6 +770,18 @@ class SqliteStorage {
         `);
 
         stmt.run(JSON.stringify(payload.state), txid, vout, payload.refundTxid);
+      } else if (payload.type === "maxClaimFee") {
+        const stmt = this.db.prepare(`
+          UPDATE unclaimed_deposits
+          SET max_claim_fee = ?
+          WHERE txid = ? AND vout = ?
+        `);
+
+        stmt.run(
+          payload.maxFee ? JSON.stringify(payload.maxFee) : null,
+          txid,
+          vout
+        );
       } else {
         return Promise.reject(
           new StorageError(`Unknown payload type: ${payload.type}`)
@@ -784,6 +799,71 @@ class SqliteStorage {
     }
   }
 
+  listWatchedDepositAddresses() {
+    try {
+      const rows = this.db
+        .prepare(
+          `SELECT address, issued_at, seen FROM watched_deposit_addresses
+             ORDER BY issued_at DESC`
+        )
+        .all();
+      return Promise.resolve(
+        rows.map((row) => ({
+          address: row.address,
+          issuedAt: row.issued_at,
+          seen: Boolean(row.seen),
+        }))
+      );
+    } catch (error) {
+      return Promise.reject(
+        new StorageError(
+          `Failed to list watched deposit addresses: ${error.message}`,
+          error
+        )
+      );
+    }
+  }
+
+  updateWatchedDepositAddress(address, payload) {
+    try {
+      if (payload.type === "watch") {
+        this.db
+          .prepare(
+            `INSERT INTO watched_deposit_addresses (address, issued_at, seen)
+               VALUES (?, ?, 0)
+               ON CONFLICT(address) DO UPDATE SET issued_at = excluded.issued_at, seen = 0`
+          )
+          .run(address, payload.issuedAt);
+      } else if (payload.type === "seen") {
+        this.db
+          .prepare(
+            "UPDATE watched_deposit_addresses SET seen = 1 WHERE address = ?"
+          )
+          .run(address);
+      } else if (payload.type === "unwatch") {
+        this.db
+          .prepare(
+            `DELETE FROM watched_deposit_addresses
+               WHERE address = ? AND issued_at = ?`
+          )
+          .run(address, payload.issuedAt);
+      } else {
+        return Promise.reject(
+          new StorageError(`Unknown payload type: ${payload.type}`)
+        );
+      }
+      return Promise.resolve();
+    } catch (error) {
+      if (error instanceof StorageError) return Promise.reject(error);
+      return Promise.reject(
+        new StorageError(
+          `Failed to update watched deposit address '${address}': ${error.message}`,
+          error
+        )
+      );
+    }
+  }
+
   setLnurlMetadata(metadata) {
     try {
       const stmt = this.db.prepare(

package/nodejs/storage/migrations.cjs

@@ -500,6 +500,27 @@ class MigrationManager {
         name: "Add refund state to unclaimed_deposits",
         sql: [`ALTER TABLE unclaimed_deposits ADD COLUMN refund_state TEXT`],
       },
+      {
+        // Deposit addresses polled on-chain for deposits still in the mempool.
+        // Rows are removed once watching them can no longer lead to an early
+        // claim, so the table holds only the live watch set.
+        name: "Add watched_deposit_addresses",
+        sql: [
+          `CREATE TABLE IF NOT EXISTS watched_deposit_addresses (
+              address TEXT PRIMARY KEY,
+              issued_at INTEGER NOT NULL,
+              seen INTEGER NOT NULL DEFAULT 0
+          )`,
+        ],
+      },
+      {
+        // The fee ceiling standing for one deposit as a JSON-encoded MaxFee,
+        // overriding the configured one. NULL when the configured one applies.
+        name: "Add max claim fee to unclaimed_deposits",
+        sql: [
+          `ALTER TABLE unclaimed_deposits ADD COLUMN max_claim_fee TEXT`,
+        ],
+      },
     ];
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@breeztech/breez-sdk-spark",
-    "version": "0.25.0",
+    "version": "0.27.0-dev1",
     "description": "Breez Spark SDK",
     "repository": "https://github.com/breez/spark-sdk",
     "author": "Breez <contact@breez.technology> (https://github.com/breez)",

package/ssr/index.js

@@ -108,6 +108,11 @@ export function newSharedSdkContext(...args) {
   return _module.newSharedSdkContext(...args);
 }
 
+export function parseSparkConfig(...args) {
+  if (!_module) _notInitialized('parseSparkConfig');
+  return _module.parseSparkConfig(...args);
+}
+
 export function postgresStorage(...args) {
   if (!_module) _notInitialized('postgresStorage');
   return _module.postgresStorage(...args);