feat(cmd): add status command with ckb-tui

Author: RetricSu

README.md

@@ -79,6 +79,7 @@ Commands:
   transfer-all [options] [toAddress]            Transfer All CKB tokens to address, only devnet and testnet
   balance [options] [toAddress]                 Check account balance, only devnet and testnet
   debugger                                      Port of the raw CKB Standalone Debugger
+  status [options]                              Show ckb-tui status interface
   config <action> [item] [value]                do a configuration action
   help [command]                                display help for command
 ```
@@ -130,8 +131,13 @@ You can also start a proxy RPC server for public networks:
 ```sh
 offckb node --network <testnet or mainnet>
 ```
+
 Using a proxy RPC server for Testnet/Mainnet is especially helpful for debugging transactions, since failed transactions are dumped automatically.
 
+**Watch Network With TUI**
+
+Once you start the CKB Node, you can use `offckb status --network devnet/testnet/mainnet` to start a CKB-TUI interface to monitor the CKB network from your node.
+
 ### 2. Create a New Contract Project {#create-project}
 
 Generate a ready-to-use smart-contract project in JS/TS using templates:

src/cfg/setting.ts

@@ -52,9 +52,13 @@ export interface Settings {
     transactionsPath: string;
   };
   tools: {
+    rootFolder: string;
     ckbDebugger: {
       minVersion: string;
     };
+    ckbTui: {
+      version: string;
+    };
   };
 }
 
@@ -88,9 +92,13 @@ export const defaultSettings: Settings = {
     transactionsPath: path.resolve(dataPath, 'mainnet/transactions'),
   },
   tools: {
+    rootFolder: path.resolve(dataPath, 'tools'),
     ckbDebugger: {
       minVersion: '0.200.0',
     },
+    ckbTui: {
+      version: 'v0.1.0',
+    },
   },
 };
 

src/cli.ts

@@ -17,6 +17,7 @@ import { genSystemScriptsJsonFile } from './scripts/gen';
 import { CKBDebugger } from './tools/ckb-debugger';
 import { logger } from './util/logger';
 import { Network } from './type/base';
+import { status } from './cmd/status';
 
 const version = require('../package.json').version;
 const description = require('../package.json').description;
@@ -154,6 +155,14 @@ program
     return CKBDebugger.runWithArgs(process.argv.slice(2));
   });
 
+program
+  .command('status')
+  .description('Show ckb-tui status interface')
+  .option('--network <network>', 'Specify the network to deploy to', 'devnet')
+  .action(async (option) => {
+    status({ network: option.network });
+  });
+
 program
   .command('config <action> [item] [value]')
   .description('do a configuration action')

src/cmd/status.ts

@@ -0,0 +1,41 @@
+import { readSettings } from '../cfg/setting';
+import { CKBTui } from '../tools/ckb-tui';
+import { Network } from '../type/base';
+import { logger } from '../util/logger';
+
+export interface StatusOptions {
+  network?: Network;
+}
+
+export async function status({ network }: StatusOptions) {
+  const settings = readSettings();
+  const port =
+    network === Network.devnet
+      ? settings.devnet.rpcProxyPort
+      : network === Network.testnet
+        ? settings.testnet.rpcProxyPort
+        : settings.mainnet.rpcProxyPort;
+  const url = `http://127.0.0.1:${port}`;
+  const isListening = await isRPCPortListening(port);
+  if (!isListening) {
+    return logger.error(
+      `RPC port ${port} is not listening. Please make sure the ${network} node is running and Proxy RPC is enabled.`,
+    );
+  }
+  return CKBTui.runWithArgs(['-r', url]);
+}
+
+async function isRPCPortListening(port: number): Promise<boolean> {
+  const net = require('net');
+  const client = new net.Socket();
+  return new Promise<boolean>((resolve) => {
+    client.once('error', () => {
+      resolve(false);
+    });
+    client.connect(port, '127.0.0.1');
+    client.once('connect', () => {
+      client.end();
+      resolve(true);
+    });
+  });
+}

src/tools/ckb-tui.ts

@@ -0,0 +1,120 @@
+import { spawnSync, execSync } from 'child_process';
+import * as path from 'path';
+import * as fs from 'fs';
+import { readSettings } from '../cfg/setting';
+import { logger } from '../util/logger';
+
+export class CKBTui {
+  private static binaryPath: string | null = null;
+
+  private static getBinaryPath(): string {
+    if (!this.binaryPath) {
+      const settings = readSettings();
+      const binDir = settings.tools.rootFolder;
+      const version = settings.tools.ckbTui.version;
+      this.binaryPath = path.join(binDir, 'ckb-tui');
+
+      if (!fs.existsSync(this.binaryPath)) {
+        this.downloadBinary(version);
+      }
+    }
+    return this.binaryPath;
+  }
+
+  private static downloadBinary(version: string) {
+    const platform = process.platform;
+    const arch = process.arch;
+    let assetName: string;
+
+    if (platform === 'darwin') {
+      if (arch === 'arm64') {
+        assetName = `ckb-tui-with-node-macos-aarch64.tar.gz`;
+      } else {
+        throw new Error(`Unsupported architecture for macOS: ${arch}`);
+      }
+    } else if (platform === 'linux') {
+      if (arch === 'x64') {
+        assetName = `ckb-tui-with-node-linux-amd64.tar.gz`;
+      } else {
+        throw new Error(`Unsupported architecture for Linux: ${arch}`);
+      }
+    } else if (platform === 'win32') {
+      if (arch === 'x64') {
+        assetName = `ckb-tui-with-node-windows-amd64.zip`;
+      } else {
+        throw new Error(`Unsupported architecture for Windows: ${arch}`);
+      }
+    } else {
+      throw new Error(`Unsupported platform: ${platform}`);
+    }
+
+    const downloadUrl = `https://github.com/Officeyutong/ckb-tui/releases/download/${version}/${assetName}`;
+    const binDir = path.dirname(this.binaryPath!);
+    const archivePath = path.join(binDir, assetName);
+
+    try {
+      logger.info(`Downloading ckb-tui from ${downloadUrl}...`);
+      execSync(`curl -L -o "${archivePath}" "${downloadUrl}"`, { stdio: 'inherit' });
+
+      logger.info('Extracting...');
+      if (assetName.endsWith('.tar.gz')) {
+        execSync(`tar -xzf "${archivePath}" -C "${binDir}"`, { stdio: 'inherit' });
+      } else if (assetName.endsWith('.zip')) {
+        execSync(`unzip "${archivePath}" -d "${binDir}"`, { stdio: 'inherit' });
+      }
+
+      // Assume the binary is extracted as 'ckb-tui' or 'ckb-tui.exe'
+      // todo: fix the bin name
+      const extractedBinary = platform === 'win32' ? 'ckb-tui.exe' : 'ckb-tui-macos-amd64';
+      const extractedPath = path.join(binDir, extractedBinary);
+      if (fs.existsSync(extractedPath)) {
+        fs.renameSync(extractedPath, this.binaryPath!);
+      } else {
+        // If in a subfolder, find it
+        const files = fs.readdirSync(binDir);
+        for (const file of files) {
+          const filePath = path.join(binDir, file);
+          if (fs.statSync(filePath).isDirectory()) {
+            const candidate = path.join(filePath, extractedBinary);
+            if (fs.existsSync(candidate)) {
+              fs.renameSync(candidate, this.binaryPath!);
+              break;
+            }
+          }
+        }
+      }
+
+      // Make executable on Unix
+      if (platform !== 'win32') {
+        execSync(`chmod +x "${this.binaryPath}"`);
+      }
+
+      // Clean up archive
+      fs.unlinkSync(archivePath);
+
+      logger.info('ckb-tui installed successfully.');
+    } catch (error) {
+      logger.error('Failed to download/install ckb-tui:', (error as Error).message);
+      throw error;
+    }
+  }
+
+  static isInstalled(): boolean {
+    try {
+      const path = this.getBinaryPath();
+      return fs.existsSync(path);
+    } catch {
+      return false;
+    }
+  }
+
+  static run(args: string[] = []) {
+    const binaryPath = this.getBinaryPath();
+    const command = `"${binaryPath}" ${args.join(' ')}`;
+    return spawnSync(command, { stdio: 'inherit', shell: true });
+  }
+
+  static runWithArgs(args: string[]) {
+    this.run(args);
+  }
+}