ln-service 59.1.2 → 59.2.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Versions
 
+## 59.2.0
+
+- `openChannel`, `openChannels`: Add support for standard P2TR channels:
+    `is_standard_taproot`
+
 ## 59.1.2
 
 - Add support for LND 0.21.1

package/README.md

@@ -4079,6 +4079,9 @@ Requires `offchain:write`, `onchain:write`, `peers:write` permissions
 `inputs` is not supported on LND 0.16.4 and below
 
 `is_simplified_taproot` is not supported on LND 0.16.4 and below and requires
+`--protocol.simple-taproot-chans` set on both sides.
+
+`is_standard_taproot` is not supported on LND 0.21.0 and below and requires
 `--protocol.simple-taproot-chans` set on both sides.
 
     {
@@ -4096,6 +4099,7 @@ Requires `offchain:write`, `onchain:write`, `peers:write` permissions
       [is_max_funding]: <Use Maximal Chain Funds For Local Funding Bool>
       [is_private]: <Channel is Private Bool> // Defaults to false
       [is_simplified_taproot]: <Channel is Simplified Taproot Type Bool>
+      [is_standard_taproot]: <Channel is Standard Taproot Type Bool>
       [is_trusted_funding]: <Accept Funding as Trusted Bool>
       lnd: <Authenticated LND API Object>
       local_tokens: <Total Channel Capacity Tokens Number>
@@ -4148,6 +4152,9 @@ as well as a channel open request listener to accept the trusted funding.
 `description` is not supported on LND 0.16.4 and below
 
 `is_simplified_taproot` is not supported on LND 0.16.4 and below and requires
+`--protocol.simple-taproot-chans` set on both sides.
+
+`is_standard_taproot` is not supported on LND 0.21.0 and below and requires
 `--protocol.simple-taproot-chans` set on both sides.
 
     {
@@ -4161,6 +4168,7 @@ as well as a channel open request listener to accept the trusted funding.
         [is_allowing_minimal_reserve]: <Allow Peer to Have Minimal Reserve Bool>
         [is_private]: <Channel is Private Bool> // Defaults to false
         [is_simplified_taproot]: <Channel is Simplified Taproot Type Bool>
+        [is_standard_taproot]: <Channel is Standard Taproot Type Bool>
         [is_trusted_funding]: <Peer Should Avoid Waiting For Confirmation Bool>
         [min_htlc_mtokens]: <Minimum HTLC Millitokens String>
         [partner_csv_delay]: <Peer Output CSV Delay Number>

package/package.json

@@ -9,7 +9,7 @@
   "dependencies": {
     "bolt07": "1.9.5",
     "invoices": "5.0.2",
-    "lightning": "12.1.2",
+    "lightning": "12.2.0",
     "macaroon": "3.0.4"
   },
   "description": "Interaction helper for your Lightning Network daemon",
@@ -56,5 +56,5 @@
     "integration-test-0.20.0": "DOCKER_LND_VERSION=v0.20.0-beta npm run test",
     "test": "echo $DOCKER_LND_VERSION && node test/runner"
   },
-  "version": "59.1.2"
+  "version": "59.2.0"
 }

package/test/integration/test_open_standard_taproot.js

@@ -0,0 +1,94 @@
+const {equal} = require('node:assert').strict;
+const test = require('node:test');
+
+const asyncRetry = require('async/retry');
+const {spawnLightningCluster} = require('ln-docker-daemons');
+
+const {addPeer} = require('./../../');
+const {broadcastChainTransaction} = require('./../../');
+const {fundPendingChannels} = require('./../../');
+const {fundPsbt} = require('./../../');
+const {getChannels} = require('./../../');
+const {openChannel} = require('./../../');
+const {openChannels} = require('./../../');
+const {signPsbt} = require('./../../');
+
+const channelCapacityTokens = 1e6;
+const count = 100;
+const defaultFee = 1e3;
+const description = 'description';
+const interval = 250;
+const size = 2;
+const times = 1000;
+
+// Opening a standard taproot channel should open a standard taproot channel
+test(`Open standard taproot channel`, async () => {
+  // Test for LND 0.20.0 or below to exit early and avoid test
+  {
+  }
+
+  const {kill, nodes} = await spawnLightningCluster({
+    size,
+    lnd_configuration: ['--protocol.simple-taproot-chans'],
+  });
+
+  const [{generate, id, lnd}, target] = nodes;
+
+  // Try opening a standard taproot channel
+  try {
+    await generate({count});
+
+    await addPeer({lnd, public_key: target.id, socket: target.socket});
+
+    const channelOpen = await asyncRetry({interval, times}, async () => {
+      await addPeer({lnd, public_key: target.id, socket: target.socket});
+
+      try {
+        return await openChannel({
+          lnd,
+          chain_fee_tokens_per_vbyte: defaultFee,
+          is_private: true,
+          is_standard_taproot: true,
+          local_tokens: channelCapacityTokens,
+          partner_public_key: target.id,
+          socket: target.socket,
+        });
+      } catch (err) {
+        const [code, message, details] = err;
+
+        if (!!details && details.err === 'unhandled request channel type 7') {
+          return;
+        } else {
+          throw err;
+        }
+      }
+    });
+
+    // Exit early when there is no support for standard taproot
+    if (!channelOpen) {
+      return await kill({});
+    }
+
+    const channel = await asyncRetry({interval, times}, async () => {
+      await generate({});
+
+      const {channels} = await getChannels({lnd});
+
+      const [channel] = channels;
+
+      if (!channel) {
+        throw new Error('ExpectedChannelOpened');
+      }
+
+      return channel;
+    });
+
+    equal(channel.type, 'standard_taproot', 'Opened standard taproot');
+  } catch (err) {
+    equal(err, null, 'Expected no error');
+  } finally {
+    await kill({});
+  }
+
+  return;
+});