lightning 10.26.3 → 10.27.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Versions
 
+## 10.27.1
+
+- `getPendingChannels`: Add support for `opening_funding_height`,
+    `opening_waiting_blocks`
+
 ## 10.26.3
 
 - Add support for LND 0.19.3

package/lnd_methods/offchain/get_pending_channels.d.ts

@@ -69,6 +69,10 @@ export type GetPendingChannelsResult = {
     transaction_weight?: number;
     /** Channel Commitment Transaction Type */
     type?: string;
+    /** Funding Seen At Best Block Height */
+    opening_funding_height?: number;
+    /** Open Activation Waiting Blocks Count */
+    opening_waiting_blocks?: number;
   }[];
 };
 
@@ -79,6 +83,18 @@ export type GetPendingChannelsResult = {
 channel may be opening, closing, or active.
  * 
  * Requires `offchain:read` permission
+ * 
+ * `is_private` is not supported in LND 0.14.5 or before
+ *
+ * `description` is not supported in LND 0.16.4 or before
+ *
+ * `blocks_until_expiry` is not supported in LND 0.16.4 or before
+ *
+ * `close_transaction` is not supported in LND 0.17.5 or before
+ *
+ * `opening_funding_height` is not supported in LND 0.19.3 or before
+ *
+ * `opening_waiting_blocks` is not supported in LND 0.19.3 or before
  */
 export const getPendingChannels: AuthenticatedLightningMethod<
   {lnd: AuthenticatedLnd},

package/lnd_methods/offchain/get_pending_channels.js

@@ -25,6 +25,10 @@ const type = 'default';
 
   `close_transaction` is not supported in LND 0.17.5 or before
 
+  `opening_funding_height` is not supported in LND 0.19.3 or before
+
+  `opening_waiting_blocks` is not supported in LND 0.19.3 or before
+
   {
     lnd: <Authenticated LND API Object>
   }
@@ -45,6 +49,8 @@ const type = 'default';
       is_timelocked: <Channel Local Funds Constrained by Timelock Script Bool>
       local_balance: <Channel Local Tokens Balance Number>
       local_reserve: <Channel Local Reserved Tokens Number>
+      [opening_funding_height]: <Funding Seen At Best Block Height Number>
+      [opening_waiting_blocks]: <Open Activation Waiting Blocks Count Number>
       partner_public_key: <Channel Peer Public Key String>
       [pending_balance]: <Tokens Pending Recovery Number>
       [pending_payments]: [{

package/lnd_responses/pending_as_pending_channels.js

@@ -41,6 +41,8 @@ const outpointSeparator = ':';
         capacity: <Channel Capacity Tokens Count String>
         channel_point: <Channel Outpoint String>
         commitment_type: <Type of Channel String>
+        confirmation_height: <Best Chain Block Height Funding Seen Number>
+        confirmations_until_active: <Blocks Remaining to Channel Active Number>
         initiator: <Channel Creator Status String>
         local_balance: <Local Balance Tokens String>
         local_chan_reserve_sat: <Local Side Channel Reserve Tokens String>
@@ -97,6 +99,8 @@ const outpointSeparator = ':';
       is_timelocked: <Channel Local Funds Constrained by Timelock Script Bool>
       local_balance: <Channel Local Tokens Balance Number>
       local_reserve: <Channel Local Reserved Tokens Number>
+      [opening_funding_height]: <Funding Seen At Best Block Height Number>
+      [opening_waiting_blocks]: <Open Activation Waiting Blocks Count Number>
       partner_public_key: <Channel Peer Public Key String>
       [pending_balance]: <Tokens Pending Recovery Number>
       [pending_payments]: [{
@@ -247,6 +251,8 @@ module.exports = args => {
 
     sum[pending.channel.channel_point] = {
       funding_expiry: Number(pending.funding_expiry_blocks) || undefined,
+      open_blocks: Number(pending.confirmations_until_active) || undefined,
+      open_height: Number(pending.confirmation_height) || undefined,
       transaction_fee: Number(pending.commit_fee),
       transaction_weight: Number(pending.commit_weight),
     };
@@ -311,6 +317,8 @@ module.exports = args => {
       is_timelocked: forced.timelock_blocks !== undefined,
       local_balance: Number(channel.local_balance),
       local_reserve: Number(channel.local_chan_reserve_sat),
+      opening_funding_height: !chanOpen ? undefined : chanOpen.open_height,
+      opening_waiting_blocks: !chanOpen ? undefined : chanOpen.open_blocks,
       partner_public_key: channel.remote_node_pub,
       pending_balance: pendingTokens || undefined,
       pending_payments: forced.pending_payments || undefined,

package/package.json

@@ -7,9 +7,9 @@
     "url": "https://github.com/alexbosworth/lightning/issues"
   },
   "dependencies": {
-    "@grpc/grpc-js": "1.13.4",
+    "@grpc/grpc-js": "1.14.0",
     "@grpc/proto-loader": "0.8.0",
-    "@types/node": "24.4.0",
+    "@types/node": "24.5.2",
     "@types/request": "2.48.13",
     "@types/ws": "8.18.1",
     "async": "3.2.6",
@@ -22,7 +22,7 @@
     "invoices": "4.0.0",
     "psbt": "4.0.0",
     "tiny-secp256k1": "2.2.4",
-    "type-fest": "5.0.0"
+    "type-fest": "5.0.1"
   },
   "description": "Lightning Network client library",
   "devDependencies": {
@@ -53,5 +53,5 @@
     "directory": "test/typescript"
   },
   "types": "index.d.ts",
-  "version": "10.26.3"
+  "version": "10.27.1"
 }

package/test/lnd_responses/test_pending_as_pending_channels.js

@@ -57,7 +57,8 @@ const makePendingForceClosingChannel = overrides => {
 const makePendingOpenChannel = overrides => {
   const res = {
     channel: makeChannel({}),
-    confirmation_height: 1,
+    confirmation_height: 0,
+    confirmations_until_active: 0,
     commit_fee: '1',
     commit_weight: '1',
     fee_per_kw: '1',
@@ -114,6 +115,8 @@ const makeExpectedPending = overrides => {
     is_timelocked: true,
     local_balance: 1,
     local_reserve: 1,
+    opening_funding_height: undefined,
+    opening_waiting_blocks: undefined,
     partner_public_key: Buffer.alloc(33).toString('hex'),
     pending_balance: 1,
     pending_payments: [{
@@ -438,6 +441,36 @@ const tests = [
       ],
     }),
   },
+  {
+    args: makeArgs({
+      pending_force_closing_channels: [],
+      pending_open_channels: [
+        makePendingOpenChannel({
+          confirmation_height: 1,
+          confirmations_until_active: 3,
+        }),
+      ],
+      waiting_close_channels: [],
+    }),
+    description: 'Pending open channels are mapped',
+    expected: makeExpected({
+      pending_channels: [
+        makeExpectedPending({
+          close_transaction_id: undefined,
+          is_closing: false,
+          is_opening: true,
+          is_timelocked: false,
+          opening_funding_height: 1,
+          opening_waiting_blocks: 3,
+          pending_balance: undefined,
+          pending_payments: undefined,
+          recovered_tokens: undefined,
+          timelock_blocks: undefined,
+          timelock_expiration: undefined,
+        }),
+      ],
+    }),
+  },
 ];
 
 tests.forEach(({args, description, error, expected}) => {