lightning 5.1.0 → 5.3.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Versions
 
+## 5.3.0
+
+- `getInvoices`: Add `is_unconfirmed` to filter out canceled/settled invoices
+
+## 5.2.1
+
+- `getPendingChannels`: Add support for channel `capacity`
+
+## 5.1.1
+
+- `openChannels`: Fix `cooperative_close_address` not being set on channels
+
 ## 5.1.0
 
 - Add support for LND 0.14.1

package/README.md

@@ -15,6 +15,7 @@ Methods for working with the Lightning Network
 - [Thunderhub](https://www.thunderhub.io/) - https://github.com/apotdevin/thunderhub
 - [Lightning Roulette](https://lightning-roulette.com/) - https://github.com/igreshev/lightning-roulette
 - [Lightning Poker](https://lightning-poker.com/) - https://github.com/igreshev/lightning-poker
+- [p2plnbot](https://telegram.me/lnp2pbot) - https://github.com/grunch/p2plnbot
 - [rekr](https://rekr.app/) - https://github.com/ryan-lingle/rekr
 - [Suredbits API](https://suredbits.com/) - https://github.com/Suredbits/sb-api-lnd
 

package/lnd_methods/invoices/get_invoices.js

@@ -28,6 +28,7 @@ const type = 'default';
   Invoice `payment` is not supported on LND 0.11.1 and below
 
   {
+    [is_unconfirmed]: <Omit Canceled and Settled Invoices Bool>
     [limit]: <Page Result Limit Number>
     lnd: <Authenticated LND API Object>
     [token]: <Opaque Paging Token String>
@@ -87,16 +88,16 @@ const type = 'default';
     [next]: <Next Opaque Paging Token String>
   }
 */
-module.exports = ({limit, lnd, token}, cbk) => {
+module.exports = (args, cbk) => {
   return new Promise((resolve, reject) => {
     return asyncAuto({
       // Validate arguments
       validate: cbk => {
-        if (!!limit && !!token) {
+        if (!!args.limit && !!args.token) {
           return cbk([400, 'UnexpectedLimitWhenPagingInvoicesWithToken']);
         }
 
-        if (!isLnd({lnd, method, type})) {
+        if (!isLnd({method, type, lnd: args.lnd})) {
           return cbk([400, 'ExpectedLndForInvoiceListing']);
         }
 
@@ -106,12 +107,12 @@ module.exports = ({limit, lnd, token}, cbk) => {
       // Get the list of invoices
       listInvoices: ['validate', ({}, cbk) => {
         let offset;
-        let resultsLimit = limit || defaultLimit;
+        let resultsLimit = args.limit || defaultLimit;
 
         // When there is a token, parse it out into an offset and a limit
-        if (!!token) {
+        if (!!args.token) {
           try {
-            const pagingToken = parse(token);
+            const pagingToken = parse(args.token);
 
             offset = pagingToken.offset;
             resultsLimit = pagingToken.limit;
@@ -121,9 +122,10 @@ module.exports = ({limit, lnd, token}, cbk) => {
         }
 
         return asyncRetry({}, cbk => {
-          return lnd[type][method]({
+          return args.lnd[type][method]({
             index_offset: offset || Number(),
             num_max_invoices: resultsLimit,
+            pending_only: args.is_unconfirmed === true || undefined,
             reversed: true,
           },
           (err, res) => {

package/lnd_methods/offchain/get_pending_channels.d.ts

@@ -3,6 +3,8 @@ import {AuthenticatedLnd} from '../../lnd_grpc';
 
 export type GetPendingChannelsResult = {
   pending_channels: {
+    /** Channel Capacity Tokens */
+    capacity: number;
     /** Channel Closing Transaction Id */
     close_transaction_id?: string;
     /** Channel Is Active */

package/lnd_methods/offchain/get_pending_channels.js

@@ -25,6 +25,7 @@ const type = 'default';
   @returns via cbk or Promise
   {
     pending_channels: [{
+      capacity: <Channel Capacity Tokens Number>
       [close_transaction_id]: <Channel Closing Transaction Id String>
       is_active: <Channel Is Active Bool>
       is_closing: <Channel Is Closing Bool>
@@ -68,6 +69,7 @@ module.exports = ({lnd}, cbk) => {
         return cbk();
       },
 
+      // Get pending channels
       getPending: ['validate', ({}, cbk) => {
         return lnd[type][method]({}, (err, res) => {
           if (!!err) {

package/lnd_methods/onchain/open_channel.js

@@ -26,11 +26,11 @@ const type = 'default';
     [give_tokens]: <Tokens to Gift To Partner Number> // Defaults to zero
     [is_private]: <Channel is Private Bool> // Defaults to false
     lnd: <Authenticated LND API Object>
-    local_tokens: <Local Tokens Number>
+    local_tokens: <Total Channel Capacity Tokens Number>
     [min_confirmations]: <Spend UTXOs With Minimum Confirmations Number>
     [min_htlc_mtokens]: <Minimum HTLC Millitokens String>
-    partner_public_key: <Public Key Hex String>
     [partner_csv_delay]: <Peer Output CSV Delay Number>
+    partner_public_key: <Public Key Hex String>
     [partner_socket]: <Peer Connection Host:Port String>
   }
 

package/lnd_methods/onchain/open_channels.d.ts

@@ -19,8 +19,6 @@ export type OpenChannelsArgs = AuthenticatedLightningArgs<{
     partner_public_key: string;
     /** Peer Output CSV Delay */
     partner_csv_delay?: number;
-    /** Peer Connection Host:Port */
-    partner_socket?: string;
   }[];
   /** Do not broadcast any channel funding transactions */
   is_avoiding_broadcast?: boolean;

package/lnd_methods/onchain/open_channels.js

@@ -39,11 +39,10 @@ const type = 'default';
       [give_tokens]: <Tokens to Gift To Partner Number> // Defaults to zero
       [is_private]: <Channel is Private Bool> // Defaults to false
       [min_htlc_mtokens]: <Minimum HTLC Millitokens String>
-      partner_public_key: <Public Key Hex String>
       [partner_csv_delay]: <Peer Output CSV Delay Number>
-      [partner_socket]: <Peer Connection Host:Port String>
+      partner_public_key: <Public Key Hex String>
     }]
-    is_avoiding_broadcast: <Avoid Broadcast of All Channels Bool>
+    [is_avoiding_broadcast]: <Avoid Broadcast of All Channels Bool>
     lnd: <Authenticated LND API Object>
   }
 
@@ -95,7 +94,6 @@ module.exports = (args, cbk) => {
           min_htlc_mtokens: channel.min_htlc_mtokens,
           partner_public_key: channel.partner_public_key,
           partner_csv_delay: channel.partner_csv_delay,
-          partner_socket: channel.partner_socket,
         })));
       }],
 
@@ -108,6 +106,7 @@ module.exports = (args, cbk) => {
           const isSelfPublish = !!args.is_avoiding_broadcast;
 
           const channelOpen = args.lnd[type][method]({
+            close_address: channel.cooperative_close_address || undefined,
             funding_shim: {
               psbt_shim: {
                 no_publish: !!isSelfPublish || !channel.id.equals(lastChannel),

package/lnd_responses/pending_as_pending_channels.js

@@ -80,6 +80,7 @@ const outpointSeparator = ':';
   @returns
   {
     pending_channels: [{
+      capacity: <Channel Capacity Tokens Number>
       [close_transaction_id]: <Channel Closing Transaction Id String>
       is_active: <Channel Is Active Bool>
       is_closing: <Channel Is Closing Bool>
@@ -285,6 +286,7 @@ module.exports = args => {
     const pendingTokens = wait.pending_balance || forced.pending_balance;
 
     return {
+      capacity: Number(channel.capacity),
       close_transaction_id: endTx || undefined,
       is_active: false,
       is_closing: !chanOpen,

package/package.json

@@ -7,35 +7,35 @@
     "url": "https://github.com/alexbosworth/lightning/issues"
   },
   "dependencies": {
-    "@grpc/grpc-js": "1.4.4",
-    "@grpc/proto-loader": "0.6.7",
+    "@grpc/grpc-js": "1.5.0",
+    "@grpc/proto-loader": "0.6.9",
     "@types/express": "4.17.13",
-    "@types/node": "16.11.10",
-    "@types/request": "2.48.7",
-    "@types/ws": "8.2.0",
-    "async": "3.2.2",
+    "@types/node": "17.0.8",
+    "@types/request": "2.48.8",
+    "@types/ws": "8.2.2",
+    "async": "3.2.3",
     "asyncjs-util": "1.2.7",
     "bitcoinjs-lib": "6.0.1",
     "bn.js": "5.2.0",
-    "body-parser": "1.19.0",
-    "bolt07": "1.7.4",
+    "body-parser": "1.19.1",
+    "bolt07": "1.8.0",
     "bolt09": "0.2.0",
     "cbor": "8.1.0",
-    "express": "4.17.1",
+    "express": "4.17.2",
     "invoices": "2.0.2",
     "psbt": "1.1.10",
-    "type-fest": "2.6.0"
+    "type-fest": "2.9.0"
   },
   "description": "Lightning Network client library",
   "devDependencies": {
     "@alexbosworth/node-fetch": "2.6.2",
     "@alexbosworth/tap": "15.0.10",
-    "tsd": "0.19.0",
-    "typescript": "4.5.2",
-    "ws": "8.3.0"
+    "tsd": "0.19.1",
+    "typescript": "4.5.4",
+    "ws": "8.4.0"
   },
   "engines": {
-    "node": ">=12"
+    "node": ">=12.20"
   },
   "keywords": [
     "grpc",
@@ -57,5 +57,5 @@
     "directory": "test/typescript"
   },
   "types": "index.d.ts",
-  "version": "5.1.0"
+  "version": "5.3.0"
 }

package/test/lnd_responses/test_pending_as_pending_channels.js

@@ -99,6 +99,7 @@ const makeArgs = overrides => {
 
 const makeExpectedPending = overrides => {
   const res = {
+    capacity: 1,
     close_transaction_id: Buffer.alloc(32).toString('hex'),
     is_active: false,
     is_closing: true,