feat: new grpc call for subscribring alerts such as low balance (#864)

lib/cli/commands/subscribealerts.ts

@@ -0,0 +1,62 @@
+import { ServiceError, status } from 'grpc';
+import { Arguments } from 'yargs';
+import { XudClient } from '../../proto/xudrpc_grpc_pb';
+import * as xudrpc from '../../proto/xudrpc_pb';
+import { setTimeoutPromise } from '../../utils/utils';
+import { loadXudClient } from '../command';
+
+export const command = 'subscribealerts';
+
+export const describe = 'subscribe alerts such as low balance';
+
+export const builder = {};
+
+export const handler = async (argv: Arguments) => {
+  await ensureConnection(argv, true);
+};
+
+let client: XudClient;
+
+const ensureConnection = async (argv: Arguments, printError?: boolean) => {
+  if (!client) {
+    client = await loadXudClient(argv);
+  }
+  client.waitForReady(Date.now() + 3000, (error: Error | null) => {
+    if (error) {
+      if (error.message === 'Failed to connect before the deadline') {
+        console.error(`could not connect to xud at ${argv.rpchost}:${argv.rpcport}, is xud running?`);
+        process.exit(1);
+      }
+
+      if (printError) console.error(`${error.name}: ${error.message}`);
+      setTimeout(ensureConnection.bind(undefined, argv, printError), 3000);
+    } else {
+      console.log('Successfully connected, subscribing for alerts');
+      subscribeAlerts(argv);
+    }
+  });
+};
+
+const subscribeAlerts = (argv: Arguments<any>) => {
+  const request = new xudrpc.SubscribeAlertsRequest();
+  const alertsSubscription = client.subscribeAlerts(request);
+
+  alertsSubscription.on('data', (alert: xudrpc.Alert) => {
+    console.log(`${alert.getType()}: ${alert.getMessage()}`);
+  });
+  alertsSubscription.on('end', reconnect.bind(undefined, argv));
+  alertsSubscription.on('error', async (err: ServiceError) => {
+    if (err.code === status.UNIMPLEMENTED) {
+      console.error("xud is locked, run 'xucli unlock', 'xucli create', or 'xucli restore' then try again");
+      process.exit(1);
+    }
+    console.warn(`Unexpected error occured: ${err.message}, reconnecting in 1 second`);
+    await setTimeoutPromise(1000);
+    await ensureConnection(argv);
+  });
+};
+
+const reconnect = async (argv: Arguments) => {
+  console.log('Stream has closed, trying to reconnect');
+  await ensureConnection(argv, false);
+};

lib/constants/enums.ts

@@ -180,3 +180,7 @@ export enum DisconnectionReason {
   AuthFailureInvalidSignature = 12,
   WireProtocolErr = 13,
 }
+
+export enum AlertType {
+  NoBalance = 0,
+}

lib/grpc/GrpcService.ts

@@ -870,6 +870,24 @@ class GrpcService {
     }
   }
 
+  /*
+   * See [[Service.subscribeAlerts]]
+   */
+  public subscribeAlerts: grpc.handleServerStreamingCall<xudrpc.SubscribeAlertsRequest, xudrpc.Alert> = (call) => {
+    if (!this.isReady(this.service, call)) {
+      return;
+    }
+
+    const cancelled$ = getCancelled$(call);
+    this.service.subscribeAlerts((type, message) => {
+      const alert = new xudrpc.Alert();
+      alert.setType(type as number);
+      alert.setMessage(message);
+      call.write(alert);
+    },
+    cancelled$);
+  }
+
   /*
    * See [[Service.subscribeOrders]]
    */