ln-service 57.2.0 → 57.3.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Versions
 
+## 57.3.0
+
+- `getConfiguration`: Add method to return configuration information
+
 ## 57.2.0
 
 - `deleteChainTransaction`: Add method to delete a chain transaction

package/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2017-2023 Alex Bosworth
+Copyright (c) 2017-2024 Alex Bosworth
 Copyright (c) 2017 BitcoinJS
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

package/README.md

@@ -187,6 +187,7 @@ for `unlocker` methods.
 - [getChannelBalance](#getchannelbalance) - Get the balance of channel funds
 - [getChannels](#getchannels) - Get all open channels
 - [getClosedChannels](#getclosedchannels) - Get previously open channels
+- [getConfiguration](#getconfiguration) - Get configuration information
 - [getConnectedWatchtowers](#getconnectedwatchtowers) - Get connected towers
 - [getEphemeralChannelIds](#getephemeralchannelids) - Get other channel ids
 - [getFailedPayments](#getfailedpayments) - Get payments that were failed back
@@ -1972,6 +1973,36 @@ const {getClosedChannels} = require('ln-service');
 const breachCount = await getClosedChannels({lnd, is_breach_close: true});
 ```
 
+### getConfiguration
+
+Get the current configuration file settings and the output log
+
+Requires `info:read`, `offchain:read`, `onchain:read`, `peers:read`
+permissions
+
+This method is not supported on LND 0.17.3 and below
+
+    {
+      lnd: <Authenticated LND API Object>
+    }
+
+    @returns via cbk or Promise
+    {
+      log: [<Log Line String>]
+      options: [{
+        type: <Option Type String>
+        value: <Option Value String>
+      }]
+    }
+
+Example:
+
+```node
+const {getConfiguration} = require('ln-service');
+const {log, options} = await getConfiguration({});
+const minimumChannelSize = options.find(n => n.type === 'minchansize').value;
+```
+
 ### getConnectedWatchtowers
 
 Get a list of connected watchtowers and watchtower info
@@ -2341,6 +2372,7 @@ Requires `invoices:read` permission
       [chain_address]: <Fallback Chain Address String>
       cltv_delta: <CLTV Delta Number>
       [confirmed_at]: <Settled at ISO 8601 Date String>
+      [confirmed_index]: <Confirmed Index Number>
       created_at: <ISO 8601 Date String>
       description: <Description String>
       [description_hash]: <Description Hash Hex String>

package/index.js

@@ -46,6 +46,7 @@ const {getChannel} = require('lightning');
 const {getChannelBalance} = require('lightning');
 const {getChannels} = require('lightning');
 const {getClosedChannels} = require('lightning');
+const {getConfiguration} = require('lightning');
 const {getConnectedWatchtowers} = require('lightning');
 const {getEphemeralChannelIds} = require('lightning');
 const {getFailedPayments} = require('lightning');
@@ -205,6 +206,7 @@ module.exports = {
   getChannelBalance,
   getChannels,
   getClosedChannels,
+  getConfiguration,
   getConnectedWatchtowers,
   getEphemeralChannelIds,
   getFailedPayments,

package/package.json

@@ -9,7 +9,7 @@
   "dependencies": {
     "bolt07": "1.8.4",
     "invoices": "3.0.0",
-    "lightning": "10.2.0",
+    "lightning": "10.3.1",
     "macaroon": "3.0.4"
   },
   "description": "Interaction helper for your Lightning Network daemon",
@@ -24,7 +24,7 @@
     "bn.js": "5.2.1",
     "bs58check": "3.0.1",
     "ecpair": "2.1.0",
-    "ln-docker-daemons": "6.0.6",
+    "ln-docker-daemons": "6.0.7",
     "p2tr": "2.0.0",
     "portfinder": "1.0.32",
     "psbt": "3.0.0",
@@ -69,5 +69,5 @@
     "integration-test-0.14.4": "DOCKER_LND_VERSION=v0.14.4-beta npm run test",
     "test": "echo $DOCKER_LND_VERSION && node test/runner"
   },
-  "version": "57.2.0"
+  "version": "57.3.0"
 }

package/test/integration/test_get_configuration.js

@@ -0,0 +1,35 @@
+const {deepEqual} = require('node:assert').strict;
+const {equal} = require('node:assert').strict;
+const {ok} = require('node:assert').strict;
+const test = require('node:test');
+
+const asyncRetry = require('async/retry');
+const {spawnLightningCluster} = require('ln-docker-daemons');
+
+const {getConfiguration} = require('./../../');
+const {getWalletInfo} = require('./../../');
+
+// Getting the configuration info should return info about the config
+test(`Get configuration info`, async () => {
+  const {kill, nodes} = await spawnLightningCluster({});
+
+  const [{lnd}] = nodes;
+
+  try {
+    const {log, options} = await getConfiguration({lnd});
+
+    ok(!!log.length, 'Got the log lines');
+
+    const color = options.find(n => n.type === 'color').value.toLowerCase();
+
+    equal(color, (await getWalletInfo({lnd})).color, 'Got color from config');
+
+    await kill({});
+  } catch (err) {
+    await kill({});
+
+    deepEqual(err, [501, 'GetDebugConfigurationInfoNotSupported'], '404');
+  }
+
+  return;
+});

package/test/integration/test_get_forwards.js

@@ -24,12 +24,16 @@ test('Get forwards', async () => {
 
   const [{generate, lnd}, target, remote] = nodes;
 
-  await setupChannel({generate, lnd, to: target});
+  await asyncRetry({interval, times}, async () => {
+    await addPeer({lnd, public_key: remote.id, socket: remote.socket});
 
-  await setupChannel({
-    lnd: target.lnd,
-    generate: target.generate,
-    to: remote,
+    await setupChannel({generate, lnd, to: target});
+
+    await setupChannel({
+      lnd: target.lnd,
+      generate: target.generate,
+      to: remote,
+    });
   });
 
   await addPeer({lnd, public_key: remote.id, socket: remote.socket});

package/test/integration/test_get_network_centrality.js

@@ -24,14 +24,16 @@ test(`Get network centrality`, async () => {
   try {
     await control.generate({count: 100});
 
-    await addPeer({lnd, public_key: remote.id, socket: remote.socket});
+    await asyncRetry({interval, times}, async () => {
+      await addPeer({lnd, public_key: remote.id, socket: remote.socket});
 
-    await setupChannel({lnd, generate: control.generate, to: target});
+      await setupChannel({lnd, generate: control.generate, to: target});
 
-    await setupChannel({
-      generate: target.generate,
-      lnd: target.lnd,
-      to: remote,
+      await setupChannel({
+        generate: target.generate,
+        lnd: target.lnd,
+        to: remote,
+      });
     });
 
     await asyncRetry({interval, times}, async () => {

package/test/routerrpc-integration/test_is_destination_payable.js

@@ -2,12 +2,15 @@ const {deepEqual} = require('node:assert').strict;
 const {equal} = require('node:assert').strict;
 const test = require('node:test');
 
+const asyncRetry = require('async/retry');
 const {setupChannel} = require('ln-docker-daemons');
 const {spawnLightningCluster} = require('ln-docker-daemons');
 
 const {isDestinationPayable} = require('./../../');
 
+const interval = 100;
 const size = 2;
+const times = 1000;
 const tokens = 1e6 / 2;
 
 // Determining if a route is payable should indicate if a route can be found
@@ -17,7 +20,9 @@ test('Is destination payable', async () => {
   const [{generate, lnd}, target] = nodes;
 
   try {
-    await setupChannel({generate, lnd, to: target});
+    await asyncRetry({interval, times}, async () => {
+      await setupChannel({generate, lnd, to: target});
+    });
 
     const canPay = await isDestinationPayable({lnd, destination: target.id});
 

package/test/routerrpc-integration/test_pay_via_payment_request.js

@@ -42,7 +42,9 @@ test(`Pay via payment request`, async () => {
       }
     });
 
-    const channel = await setupChannel({generate, lnd, to: target});
+    const channel = await asyncRetry({interval, times}, async () => {
+      return await setupChannel({generate, lnd, to: target});
+    });
 
     // Make sure that an error is returned when there is no route
     try {