lightning 5.7.1 → 5.8.2

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Versions
 
+## 5.8.2
+
+- `getMasterPublicKeys`: Add method to lookup wallet extended public keys
+
 ## 5.7.1
 
 - `fundPsbt`: Correct ECPair import dependency in control flow

package/README.md

@@ -6,6 +6,8 @@ Methods for working with the Lightning Network
 
 ## Selected Projects using Lightning
 
+- [bitpay.com crypto-rpc](https://bitpay.com/) -
+    https://github.com/bitpay/crypto-rpc
 - [coinos.io](https://coinos.io/) - https://github.com/coinos/coinos-server
 - [Lightning Shell](https://lightningshell.app/) -
     https://github.com/ibz/lightning-shell
@@ -27,6 +29,8 @@ Methods for working with the Lightning Network
 - [rekr](https://rekr.app/) - https://github.com/ryan-lingle/rekr
 - [Suredbits API](https://suredbits.com/) -
     https://github.com/Suredbits/sb-api-lnd
+- [Synonym demo server](https://synonym.to) -
+    https://github.com/synonymdev/slash-pay-demo-server
 
 ## LND Authentication
 
@@ -157,6 +161,8 @@ To access unauthenticated methods like the wallet unlocker, use
     open invoices and received payments.
 - [getLockedUtxos](https://github.com/alexbosworth/ln-service#getlockedutxos): List the UTXOs
     that are currently reserved and unavailable to coin selection.
+- [getMasterPublicKeys](https://github.com/alexbosworth/ln-service#getmasterpublickeys):
+    List out master seed derived extended public keys and derivation paths.
 - [getMethods](https://github.com/alexbosworth/ln-service#getmethods): List RPC methods and
     permissions required to use them.
 - [getNetworkCentrality](https://github.com/alexbosworth/ln-service#getnetworkcentrality):

package/lnd_methods/offchain/subscribe_to_past_payments.d.ts

@@ -67,6 +67,8 @@ export type SubscribeToPastPaymentsPaymentEvent = {
 /**
  * Subscribe to successful outgoing payments
  *
+ * Payments may be omitted if LND does not finalize the payment record
+ *
  * Requires `offchain:read` permission
  *
  * Note: Method not supported on LND 0.13.4 and below

package/lnd_methods/offchain/subscribe_to_past_payments.js

@@ -21,6 +21,8 @@ const unknownFailureMessage = '2 UNKNOWN: unknown failure detail type: <nil>';
 
 /** Subscribe to successful outgoing payments
 
+  Payments may be omitted if LND does not finalize the payment record
+
   Requires `offchain:read` permission
 
   Note: Method not supported on LND 0.13.4 and below
@@ -96,6 +98,11 @@ module.exports = ({lnd}) => {
           return;
         }
 
+        // Exit early when there is no payment
+        if (!res.payment) {
+          return;
+        }
+
         // Emit payment details
         return emitter.emit(event, res.payment);
       });

package/lnd_methods/onchain/get_master_public_keys.d.ts

@@ -0,0 +1,28 @@
+import {
+  AuthenticatedLightningArgs,
+  AuthenticatedLightningMethod,
+} from '../../typescript';
+
+export type GetMasterPublicKeysArgs = AuthenticatedLightningArgs;
+
+export type GetMasterPublicKeysResult = {
+  keys: {
+    /** Key Derivation Path String> */
+    derivation_path: string;
+    /** Base58 Encoded Master Public Key String> */
+    extended_public_key: string;
+    /** Used External Keys Count Number> */
+    external_key_count: number;
+    /** Used Internal Keys Count Number> */
+    internal_key_count: number;
+    /** Node has Master Private Key Bool> */
+    is_watch_only: boolean;
+    /** Account Name String> */
+    named: string;
+  }[];
+};
+
+export const getMasterPublicKeys: AuthenticatedLightningMethod<
+  GetMasterPublicKeysArgs,
+  GetMasterPublicKeysResult
+>;

package/lnd_methods/onchain/index.d.ts

@@ -8,6 +8,7 @@ export * from './get_chain_fee_estimate';
 export * from './get_chain_fee_rate';
 export * from './get_chain_transactions';
 export * from './get_locked_utxos';
+export * from './get_master_public_keys';
 export * from './get_pending_chain_balance';
 export * from './get_sweep_transactions';
 export * from './get_utxos';

package/lnd_methods/peers/subscribe_to_peers.js

@@ -51,8 +51,6 @@ module.exports = ({lnd}) => {
 
     subscription.cancel();
 
-    subscription.removeAllListeners();
-
     return;
   });
 

package/package.json

@@ -7,33 +7,33 @@
     "url": "https://github.com/alexbosworth/lightning/issues"
   },
   "dependencies": {
-    "@grpc/grpc-js": "1.5.5",
+    "@grpc/grpc-js": "1.5.7",
     "@grpc/proto-loader": "0.6.9",
     "@types/express": "4.17.13",
-    "@types/node": "17.0.17",
+    "@types/node": "17.0.21",
     "@types/request": "2.48.8",
-    "@types/ws": "8.2.2",
+    "@types/ws": "8.5.2",
     "async": "3.2.3",
     "asyncjs-util": "1.2.8",
     "bitcoinjs-lib": "6.0.1",
     "bn.js": "5.2.0",
-    "body-parser": "1.19.1",
+    "body-parser": "1.19.2",
     "bolt07": "1.8.0",
-    "bolt09": "0.2.1",
+    "bolt09": "0.2.2",
     "cbor": "8.1.0",
     "ecpair": "2.0.1",
-    "express": "4.17.2",
+    "express": "4.17.3",
     "invoices": "2.0.4",
     "psbt": "2.0.0",
-    "tiny-secp256k1": "2.2.0",
-    "type-fest": "2.11.2"
+    "tiny-secp256k1": "2.2.1",
+    "type-fest": "2.12.0"
   },
   "description": "Lightning Network client library",
   "devDependencies": {
     "@alexbosworth/node-fetch": "2.6.2",
     "@alexbosworth/tap": "15.0.10",
     "tsd": "0.19.1",
-    "typescript": "4.5.5",
+    "typescript": "4.6.2",
     "ws": "8.5.0"
   },
   "engines": {
@@ -59,5 +59,5 @@
     "directory": "test/typescript"
   },
   "types": "index.d.ts",
-  "version": "5.7.1"
+  "version": "5.8.2"
 }

package/test/typescript/get_master_public_keys.test-d.ts

@@ -0,0 +1,19 @@
+import {expectError, expectType} from 'tsd';
+import {AuthenticatedLnd} from '../../lnd_grpc';
+import {
+  getMasterPublicKeys,
+  GetMasterPublicKeysResult,
+} from '../../lnd_methods';
+
+const lnd = {} as AuthenticatedLnd;
+
+expectError(getMasterPublicKeys());
+expectError(getMasterPublicKeys({}));
+
+expectType<GetMasterPublicKeysResult>(await getMasterPublicKeys({lnd}));
+
+expectType<void>(
+  getMasterPublicKeys({lnd}, (error, result) => {
+    expectType<GetMasterPublicKeysResult>(result);
+  })
+);