@bitsocial/bitsocial-cli 0.19.41 → 0.19.43

package/README.md

@@ -32,7 +32,7 @@ Bitsocial is p2p and decentralized social media protocol built completely with I
 
 ## Install
 
-Requires [Node.js 22](https://nodejs.org/) or later.
+Requires Node.js 22 or later. We recommend using [nvm](https://github.com/nvm-sh/nvm) to install and manage Node.js versions.
 
 ```sh-session
 npm install -g @bitsocial/bitsocial-cli
@@ -344,7 +344,7 @@ EXAMPLES
   $ bitsocial challenge install ./my-local-challenge
 ```
 
-_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/challenge/install.ts)_
+_See code: [src/cli/commands/challenge/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/challenge/install.ts)_
 
 ## `bitsocial challenge list`
 
@@ -367,7 +367,7 @@ EXAMPLES
   $ bitsocial challenge list -q
 ```
 
-_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/challenge/list.ts)_
+_See code: [src/cli/commands/challenge/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/challenge/list.ts)_
 
 ## `bitsocial challenge remove NAME`
 
@@ -392,7 +392,7 @@ EXAMPLES
   $ bitsocial challenge remove @scope/my-challenge
 ```
 
-_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/challenge/remove.ts)_
+_See code: [src/cli/commands/challenge/remove.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/challenge/remove.ts)_
 
 ## `bitsocial community create`
 
@@ -417,7 +417,7 @@ EXAMPLES
     $ bitsocial community create --title 'Hello Plebs' --description 'Welcome'
 ```
 
-_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/create.ts)_
+_See code: [src/cli/commands/community/create.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/create.ts)_
 
 ## `bitsocial community delete ADDRESSES`
 
@@ -442,7 +442,7 @@ EXAMPLES
   $ bitsocial community delete 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/delete.ts)_
+_See code: [src/cli/commands/community/delete.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/delete.ts)_
 
 ## `bitsocial community edit ADDRESS`
 
@@ -494,7 +494,7 @@ EXAMPLES
     $ bitsocial community edit plebbit.bso --settings.fetchThumbnailUrls=false
 ```
 
-_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/edit.ts)_
+_See code: [src/cli/commands/community/edit.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/edit.ts)_
 
 ## `bitsocial community get [ADDRESS]`
 
@@ -525,7 +525,7 @@ EXAMPLES
   $ bitsocial community get --publicKey 12D3KooWG3XbzoVyAE6Y9vHZKF64Yuuu4TjdgQKedk14iYmTEPWu
 ```
 
-_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/get.ts)_
+_See code: [src/cli/commands/community/get.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/get.ts)_
 
 ## `bitsocial community list`
 
@@ -548,7 +548,7 @@ EXAMPLES
   $ bitsocial community list
 ```
 
-_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/list.ts)_
+_See code: [src/cli/commands/community/list.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/list.ts)_
 
 ## `bitsocial community start ADDRESSES`
 
@@ -577,7 +577,7 @@ EXAMPLES
     $ bitsocial community start $(bitsocial community list -q)
 ```
 
-_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/start.ts)_
+_See code: [src/cli/commands/community/start.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/start.ts)_
 
 ## `bitsocial community stop ADDRESSES`
 
@@ -602,7 +602,7 @@ EXAMPLES
   $ bitsocial community stop Qmb99crTbSUfKXamXwZBe829Vf6w5w5TktPkb6WstC9RFW
 ```
 
-_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/community/stop.ts)_
+_See code: [src/cli/commands/community/stop.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/community/stop.ts)_
 
 ## `bitsocial daemon`
 
@@ -613,9 +613,10 @@ USAGE
   $ bitsocial daemon --pkcRpcUrl <value> --logPath <value> [--chainProviderUrls <value>...]
 
 FLAGS
-  --chainProviderUrls=<value>...  [default: viem,https://ethrpc.xyz] Ethereum RPC URL(s) for .bso/.eth name resolution.
-                                  Can be specified multiple times. Defaults to viem public transport and
-                                  https://ethrpc.xyz
+  --chainProviderUrls=<value>...  [default:
+                                  https://eth.drpc.org,https://ethereum.publicnode.com,https://ethereum-rpc.publicnode.c
+                                  om,https://rpc.mevblocker.io,https://1rpc.io/eth,https://eth-pokt.nodies.app] RPC
+                                  URL(s) for .bso name resolution. Can be specified multiple times.
   --logPath=<value>               (required) [default: /home/runner/.local/state/bitsocial] Specify a directory which
                                   will be used to store logs
   --pkcRpcUrl=<value>             (required) [default: ws://localhost:9138/] Specify PKC RPC URL to listen on
@@ -640,11 +641,9 @@ EXAMPLES
   $ bitsocial daemon --pkcOptions.kuboRpcClientsOptions[0] https://remoteipfsnode.com
 
   $ bitsocial daemon --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY
-
-  $ bitsocial daemon --chainProviderUrls viem --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY
 ```
 
-_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/daemon.ts)_
+_See code: [src/cli/commands/daemon.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/daemon.ts)_
 
 ## `bitsocial help [COMMAND]`
 
@@ -701,7 +700,7 @@ EXAMPLES
   $ bitsocial logs --since 1h -f
 ```
 
-_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/logs.ts)_
+_See code: [src/cli/commands/logs.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/logs.ts)_
 
 ## `bitsocial update check`
 
@@ -718,7 +717,7 @@ EXAMPLES
   $ bitsocial update check
 ```
 
-_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/update/check.ts)_
+_See code: [src/cli/commands/update/check.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/update/check.ts)_
 
 ## `bitsocial update install [VERSION]`
 
@@ -726,13 +725,14 @@ Install a specific version of bitsocial from npm
 
 ```
 USAGE
-  $ bitsocial update install [VERSION] [--force]
+  $ bitsocial update install [VERSION] [--force] [--restart-daemons]
 
 ARGUMENTS
   [VERSION]  [default: latest] Version to install (e.g. "0.19.40" or "latest")
 
 FLAGS
-  --force  Reinstall even if already on the requested version
+  --force                 Reinstall even if already on the requested version
+  --[no-]restart-daemons  Stop all running daemons, update, and restart them with the same settings
 
 DESCRIPTION
   Install a specific version of bitsocial from npm
@@ -745,9 +745,11 @@ EXAMPLES
   $ bitsocial update install 0.19.40
 
   $ bitsocial update install --force
+
+  $ bitsocial update install --no-restart-daemons
 ```
 
-_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/update/install.ts)_
+_See code: [src/cli/commands/update/install.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/update/install.ts)_
 
 ## `bitsocial update versions`
 
@@ -769,7 +771,7 @@ EXAMPLES
   $ bitsocial update versions --limit 5
 ```
 
-_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.41/src/cli/commands/update/versions.ts)_
+_See code: [src/cli/commands/update/versions.ts](https://github.com/bitsocialnet/bitsocial-cli/blob/v0.19.43/src/cli/commands/update/versions.ts)_
 <!-- commandsstop -->
 
 ## Contribution

package/dist/cli/ascii-banner.d.ts

@@ -0,0 +1 @@
+export declare function printBanner(): void;

package/dist/cli/ascii-banner.js

@@ -0,0 +1,94 @@
+// ASCII banner, edited as two parallel grids.
+//
+// SHAPE holds the raw glyphs (braille art + figlet text). Leave these alone
+// unless you want to change the art itself.
+//
+// COLORS is the paint map. Each character corresponds 1:1 to the character
+// at the same position in SHAPE:
+//   B = blue   (#1a4fd0) — the sphere
+//   S = silver (#e5e7eb) — the rings and the "Bitsocial" text
+//   . = no color (pass the glyph through as-is; use this for spaces)
+//
+// To retouch the art, find a glyph in SHAPE, then flip the character at the
+// same column in the matching COLORS row. A common case: a ring cell came out
+// blue because the sphere mask had more dots there — change its 'B' to 'S'.
+//
+// Both grids MUST have the same number of rows. Each row in COLORS must be at
+// least as wide as the corresponding SHAPE row (extra chars are ignored).
+// Palette sourced from bitsocialnet/bitsocial-web/about/tailwind.config.ts.
+const SHAPE = [
+    "                ⢀⣴⣿⣿⣦⡀                                                                                       ",
+    "                ⣾⣿⠁⠈⣿⣷⡀                                                                                      ",
+    "               ⢸⣿⡇  ⢸⣿⣇                                                                                      ",
+    "             ⢀⣀⣼⣿⣷⣶⣶⣶⣿⣿⣄⡀                                                                                    ",
+    "          ⢀⣠⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣤⡀                                                                                 ",
+    "         ⣴⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣦               888888b.   d8b 888                               d8b          888",
+    "       ⢀⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⡀             888  \"88b  Y8P 888                               Y8P          888",
+    "  ⣀⣤⣤⣶⣶⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣶⣶⣦⣤⣀        888  .88P      888                                            888",
+    "⣰⣿⡿⠛⠉⠉ ⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿ ⠉⠉⠛⠟⣿⣦      8888888K.  888 888888 .d8888b   .d88b.   .d8888b 888  8888b.  888",
+    "⠻⣷⣦⣤⣀⣀ ⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿ ⢀⣀⣀⣴⣿⠟      888  \"Y88b 888 888    88K      d88\"\"88b d88P\"    888     \"88b 888",
+    "  ⠉⠛⠻⠿⠿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠿⠿⠟⠛⠉        888    888 888 888    \"Y8888b. 888  888 888      888 .d888888 888",
+    "       ⠈⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿              888   d88P 888 Y88b.       X88 Y88..88P Y88b.    888 888  888 888",
+    "         ⠻⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠟               8888888P\"  888  \"Y888  88888P'  \"Y88P\"   \"Y8888P 888 \"Y888888 888",
+    "          ⠈⠻⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⠟⠁                                                                                 ",
+    "             ⠉⠛⢿⣿⣿⣿⣿⣿⣿⣿⠛⠉                                                                                    ",
+    "                ⢸⣿⡆  ⣿⡿                                                                                      ",
+    "                ⠈⢿⣷⡀⣸⣿⠃                                                                                       ",
+    "                 ⠈⠿⣿⡿⠃                                                                                        "
+];
+const COLORS = [
+    "................SSSSSS.......................................................................................",
+    "................SSSSSSS......................................................................................",
+    "...............SSSSSSSS......................................................................................",
+    ".............BBBBBBBBSSBB....................................................................................",
+    "..........BBBBBBBBBBBSSBBBBB.................................................................................",
+    ".........BBBBBBBBBBBBSSBBBBBB...............SSSSSSSS...SSS.SSS...............................SSS..........SSS",
+    ".......BBBBBBBBBBBBBBSSBBBBBBBB.............SSS..SSSS..SSS.SSS...............................SSS..........SSS",
+    "..SSSSSBBBBBBBBBBBBBBSSBBBBBBBBSSSSSSS......SSS..SSSS......SSS............................................SSS",
+    "SSSSSS.BBBBBBBBBBBBBBSSBBBBBBBBSSSSSSS......SSSSSSSSS..SSS.SSSSSS.SSSSSSS...SSSSSS...SSSSSSS.SSS..SSSSSS..SSS",
+    "SSSSSS.BBBBBBBBBBBBBBSSBBBBBBBBSSSSSSS......SSS..SSSSS.SSS.SSS....SSS......SSSSSSSS.SSSSS....SSS.....SSSS.SSS",
+    "..SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS......SSS....SSS.SSS.SSS....SSSSSSSS.SSS..SSS.SSS......SSS.SSSSSSSS.SSS",
+    ".......BBBBBBBBBBBBBBSSBBBBBBBBBBBBBBB......SSS...SSSS.SSS.SSSSS.......SSS.SSSSSSSS.SSSSS....SSS.SSS..SSS.SSS",
+    ".........BBBBBBBBBBBBSSBBBBBBBBB............SSSSSSSSS..SSS..SSSSS..SSSSSSS..SSSSSS...SSSSSSS.SSS.SSSSSSSS.SSS",
+    "..........BBBBBBBBBBBSSBBBBBBB...............................................................................",
+    ".............BBBBBBBBSSBBBB..................................................................................",
+    "...............SSSSSSSSS.....................................................................................",
+    "...............SSSSSSSS......................................................................................",
+    "................SSSSSS......................................................................................."
+];
+const BLUE = "\x1b[38;2;26;79;208m";
+const SILVER = "\x1b[38;2;229;231;235m";
+const RESET = "\x1b[0m";
+function paint(shape, colors) {
+    let out = "";
+    let current = ".";
+    for (let i = 0; i < shape.length; i++) {
+        const glyph = shape[i];
+        const want = colors[i] ?? ".";
+        if (want !== current) {
+            if (current !== ".")
+                out += RESET;
+            if (want === "B")
+                out += BLUE;
+            else if (want === "S")
+                out += SILVER;
+            current = want;
+        }
+        out += glyph;
+    }
+    if (current !== ".")
+        out += RESET;
+    return out;
+}
+function supportsColor() {
+    if (process.env["NO_COLOR"])
+        return false;
+    if (process.env["FORCE_COLOR"])
+        return true;
+    return Boolean(process.stdout.isTTY);
+}
+export function printBanner() {
+    const useColor = supportsColor();
+    const lines = SHAPE.map((row, i) => (useColor ? paint(row, COLORS[i] ?? "") : row));
+    process.stdout.write(lines.join("\n") + "\n\n");
+}

package/dist/cli/commands/daemon.js

@@ -5,9 +5,11 @@ import path from "path";
 import tcpPortUsed from "tcp-port-used";
 import { getLanIpV4Address, PKCLogger, setupDebugLogger, loadKuboConfigFile, parseMultiAddrKuboRpcToUrl, parseMultiAddrIpfsGatewayToUrl } from "../../util.js";
 import { startDaemonServer } from "../../webui/daemon-server.js";
+import { printBanner } from "../ascii-banner.js";
 import { loadChallengesIntoPKC } from "../../challenge-packages/challenge-utils.js";
 import { migrateDataDirectory } from "../../common-utils/data-migration.js";
-import { createBsoResolvers } from "../../common-utils/resolvers.js";
+import { createBsoResolvers, DEFAULT_PROVIDERS } from "../../common-utils/resolvers.js";
+import { pruneStaleStates, writeDaemonState, deleteDaemonState } from "../../common-utils/daemon-state.js";
 import fs from "fs";
 import fsPromise from "fs/promises";
 /** Replace wildcard bind addresses with loopback for connectivity checks (macOS rejects connect to 0.0.0.0 with EINVAL) */
@@ -47,9 +49,9 @@ export default class Daemon extends Command {
             default: defaults.PKC_LOG_PATH
         }),
         chainProviderUrls: Flags.string({
-            description: 'Ethereum RPC URL(s) for .bso/.eth name resolution. Can be specified multiple times. Defaults to viem public transport and https://ethrpc.xyz',
+            description: "RPC URL(s) for .bso name resolution. Can be specified multiple times.",
             multiple: true,
-            default: ["viem", "https://ethrpc.xyz"]
+            default: DEFAULT_PROVIDERS
         })
     };
     static examples = [
@@ -58,7 +60,6 @@ export default class Daemon extends Command {
         "bitsocial daemon --pkcOptions.dataPath /tmp/bitsocial-datapath/",
         "bitsocial daemon --pkcOptions.kuboRpcClientsOptions[0] https://remoteipfsnode.com",
         "bitsocial daemon --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY",
-        "bitsocial daemon --chainProviderUrls viem --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY"
     ];
     _setupLogger(Logger) {
         setupDebugLogger(Logger, { enableDefaultNamespace: true });
@@ -83,7 +84,11 @@ export default class Daemon extends Command {
             deletedLogFile = logFileToDelete;
             await fsPromise.rm(path.join(logPath, logFileToDelete));
         }
-        return { logFilePath: path.join(logPath, `bitsocial_cli_daemon_${new Date().toISOString().replace(/:/g, "-")}.log`), deletedLogFile, logfilesCapacity };
+        return {
+            logFilePath: path.join(logPath, `bitsocial_cli_daemon_${new Date().toISOString().replace(/:/g, "-")}.log`),
+            deletedLogFile,
+            logfilesCapacity
+        };
     }
     async _pipeDebugLogsToLogFile(logPath, Logger) {
         const { logFilePath, deletedLogFile, logfilesCapacity } = await this._getNewLogfileByEvacuatingOldLogsIfNeeded(logPath);
@@ -149,6 +154,7 @@ export default class Daemon extends Command {
         return { logFilePath, stdoutWrite };
     }
     async run() {
+        printBanner();
         // Non-blocking update check — fire-and-forget, won't delay startup
         import("../../update/npm-registry.js")
             .then(({ fetchLatestVersion }) => fetchLatestVersion().then(async (latest) => {
@@ -200,11 +206,24 @@ export default class Daemon extends Command {
             defaultPkcOptions.kuboRpcClientsOptions = [kuboRpcEndpoint.toString()];
             const mergedPkcOptions = { ...defaultPkcOptions, ...pkcOptionsFromFlag };
             log("Merged pkc options that will be used for this node", mergedPkcOptions);
+            const { nameResolvers: _nr, ...printablePkcOptions } = mergedPkcOptions;
+            console.log("PKC options:", JSON.stringify(printablePkcOptions, null, 2));
             // Migrate data directory before creating PKC instance
             migrateDataDirectory(mergedPkcOptions.dataPath);
+            // Prune stale daemon state files (dead PIDs from crashed daemons)
+            await pruneStaleStates();
+            // Persist this daemon's PID and startup args so `bitsocial update install --restart-daemons` can stop and restart it
+            const daemonArgv = process.argv.slice(process.argv.indexOf("daemon") + 1);
+            await writeDaemonState({
+                pid: process.pid,
+                startedAt: new Date().toISOString(),
+                argv: daemonArgv,
+                pkcRpcUrl: pkcRpcUrl.toString()
+            });
             // Create BSO name resolvers for .bso/.eth domain resolution
             const bsoResolvers = createBsoResolvers(flags.chainProviderUrls, mergedPkcOptions.dataPath);
             mergedPkcOptions.nameResolvers = [...(mergedPkcOptions.nameResolvers || []), ...bsoResolvers];
+            console.log(".bso name resolvers:", bsoResolvers.map((r) => r.provider).join(", "));
             let mainProcessExited = false;
             let pendingKuboStart;
             // Kubo Node may fail randomly, we need to set a listener so when it exits because of an error we restart it
@@ -421,6 +440,8 @@ export default class Daemon extends Command {
                 console.log("\nShutting down Bitsocial daemon, it may take a few seconds to shut down all communities and the IPFS node...");
                 log("Received signal to exit, shutting down both kubo and pkc rpc. Please wait, it may take a few seconds");
                 mainProcessExited = true;
+                // Remove daemon state file so update install knows we're gone
+                await deleteDaemonState(process.pid).catch(() => { });
                 // Start killing Kubo immediately, in parallel with daemon server destroy.
                 // This way Kubo receives SIGINT right away, even if daemonServer.destroy() hangs.
                 const kuboKillPromise = killKuboProcess();

package/dist/cli/commands/update/install.d.ts

@@ -6,7 +6,9 @@ export default class Install extends Command {
     };
     static flags: {
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "restart-daemons": import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     static examples: string[];
     run(): Promise<void>;
+    private _restartDaemons;
 }

package/dist/cli/commands/update/install.js

@@ -1,8 +1,9 @@
 import { Args, Flags, Command } from "@oclif/core";
+import { spawn } from "child_process";
 import tcpPortUsed from "tcp-port-used";
-import defaults from "../../../common-utils/defaults.js";
 import { fetchLatestVersion, installGlobal } from "../../../update/npm-registry.js";
 import { compareVersions } from "../../../update/semver.js";
+import { getAliveDaemonStates } from "../../../common-utils/daemon-state.js";
 export default class Install extends Command {
     static description = "Install a specific version of bitsocial from npm";
     static args = {
@@ -16,21 +17,54 @@ export default class Install extends Command {
         force: Flags.boolean({
             description: "Reinstall even if already on the requested version",
             default: false
+        }),
+        "restart-daemons": Flags.boolean({
+            description: "Stop all running daemons, update, and restart them with the same settings",
+            default: true,
+            allowNo: true
         })
     };
     static examples = [
         "bitsocial update install",
         "bitsocial update install latest",
         "bitsocial update install 0.19.40",
-        "bitsocial update install --force"
+        "bitsocial update install --force",
+        "bitsocial update install --no-restart-daemons"
     ];
     async run() {
         const { args, flags } = await this.parse(Install);
-        // Check if daemon is running — refuse to update while it's active
-        const rpcPort = Number(defaults.PKC_RPC_URL.port);
-        const daemonRunning = await tcpPortUsed.check(rpcPort, "127.0.0.1").catch(() => false);
-        if (daemonRunning) {
-            this.error(`Daemon is running on port ${rpcPort}. Stop it first with Ctrl-C, then run 'bitsocial update install'.`, { exit: 1 });
+        // Check for running daemons via state files
+        const aliveDaemons = await getAliveDaemonStates();
+        if (aliveDaemons.length > 0) {
+            if (!flags["restart-daemons"]) {
+                this.error(`${aliveDaemons.length} daemon(s) running. Stop them first, then retry.`, { exit: 1 });
+            }
+            // Stop all running daemons
+            for (const d of aliveDaemons) {
+                this.log(`Stopping daemon (PID ${d.pid})...`);
+                try {
+                    process.kill(d.pid, "SIGINT");
+                }
+                catch (e) {
+                    if (e.code === "ESRCH") {
+                        this.log(`  PID ${d.pid} already exited.`);
+                        continue;
+                    }
+                    throw e;
+                }
+            }
+            // Wait for all daemon ports to be free
+            for (const d of aliveDaemons) {
+                const url = new URL(d.pkcRpcUrl);
+                const port = Number(url.port);
+                const host = url.hostname;
+                this.log(`Waiting for port ${port} to be free...`);
+                const freed = await tcpPortUsed.waitUntilFree(port, 500, 30000).then(() => true).catch(() => false);
+                if (!freed) {
+                    this.error(`Daemon (PID ${d.pid}) did not shut down within 30 seconds on port ${port}.`, { exit: 1 });
+                }
+            }
+            this.log("All daemons stopped.");
         }
         // Resolve the target version
         let targetVersion;
@@ -49,6 +83,10 @@ export default class Install extends Command {
         // Skip if already on this version (unless --force)
         if (compareVersions(current, targetVersion) === 0 && !flags.force) {
             this.log(`Already on v${current}. Use --force to reinstall.`);
+            if (aliveDaemons.length > 0 && flags["restart-daemons"]) {
+                // We stopped daemons but don't need to update — restart them
+                await this._restartDaemons(aliveDaemons);
+            }
             return;
         }
         this.log(`Installing bitsocial-cli@${targetVersion}...`);
@@ -59,5 +97,35 @@ export default class Install extends Command {
             this.error(`Update failed: ${err.message}`, { exit: 1 });
         }
         this.log(`Installed bitsocial v${targetVersion} (was v${current}).`);
+        // Restart daemons with the new binary
+        if (aliveDaemons.length > 0 && flags["restart-daemons"]) {
+            await this._restartDaemons(aliveDaemons);
+        }
+    }
+    async _restartDaemons(daemons) {
+        this.log(`Restarting ${daemons.length} daemon(s)...`);
+        for (const d of daemons) {
+            const argStr = d.argv.length > 0 ? d.argv.join(" ") : "(defaults)";
+            this.log(`  Starting daemon with args: ${argStr}`);
+            const child = spawn("bitsocial", ["daemon", ...d.argv], {
+                detached: true,
+                stdio: "ignore"
+            });
+            child.unref();
+            if (!child.pid) {
+                this.warn(`Failed to spawn daemon for args: ${argStr}`);
+                continue;
+            }
+            // Wait briefly for the daemon's RPC port to come up
+            const url = new URL(d.pkcRpcUrl);
+            const port = Number(url.port);
+            const started = await tcpPortUsed.waitUntilUsed(port, 500, 30000).then(() => true).catch(() => false);
+            if (started) {
+                this.log(`  Daemon started (port ${port}).`);
+            }
+            else {
+                this.warn(`  Daemon may not have started — port ${port} not responding after 30s. Check logs with: bitsocial logs`);
+            }
+        }
     }
 }

package/dist/cli/hooks/init/banner-hook.d.ts

@@ -0,0 +1,3 @@
+import { Hook } from "@oclif/core";
+declare const hook: Hook<"init">;
+export default hook;

package/dist/cli/hooks/init/banner-hook.js

@@ -0,0 +1,15 @@
+import { printBanner } from "../../ascii-banner.js";
+const hook = async function (opts) {
+    // Skip when --version is being handled by version-hook
+    if (process.argv.includes("--version"))
+        return;
+    // Show banner on bare `bitsocial` invocation (no command, no help flag).
+    // oclif sets opts.id to undefined when no command is matched; argv length > 2
+    // means the user passed flags/args and expects normal command output.
+    const bareInvocation = process.argv.length <= 2;
+    const helpInvocation = !opts.id && (process.argv.includes("--help") || process.argv.includes("-h") || process.argv.includes("help"));
+    if (bareInvocation || helpInvocation) {
+        printBanner();
+    }
+};
+export default hook;

package/dist/common-utils/daemon-state.d.ts

@@ -0,0 +1,16 @@
+export interface DaemonState {
+    pid: number;
+    startedAt: string;
+    argv: string[];
+    pkcRpcUrl: string;
+}
+/** Write a daemon state file atomically (write to .tmp then rename). */
+export declare function writeDaemonState(state: DaemonState): Promise<void>;
+/** Read all state files from the daemon states directory. */
+export declare function readAllDaemonStates(): Promise<DaemonState[]>;
+/** Delete a specific daemon's state file. Ignores ENOENT. */
+export declare function deleteDaemonState(pid: number): Promise<void>;
+/** Delete state files for dead PIDs from disk. */
+export declare function pruneStaleStates(): Promise<void>;
+/** Read all states, delete stale files (dead PIDs) from disk, return only alive ones. */
+export declare function getAliveDaemonStates(): Promise<DaemonState[]>;

package/dist/common-utils/daemon-state.js

@@ -0,0 +1,85 @@
+import defaults from "./defaults.js";
+import path from "path";
+import fs from "fs/promises";
+const DAEMON_STATES_DIR = path.join(defaults.PKC_DATA_PATH, ".daemon_states");
+function stateFilePath(pid) {
+    return path.join(DAEMON_STATES_DIR, `${pid}-daemon.state`);
+}
+/** Write a daemon state file atomically (write to .tmp then rename). */
+export async function writeDaemonState(state) {
+    await fs.mkdir(DAEMON_STATES_DIR, { recursive: true });
+    const dest = stateFilePath(state.pid);
+    const tmp = dest + ".tmp";
+    await fs.writeFile(tmp, JSON.stringify(state, null, 2));
+    await fs.rename(tmp, dest);
+}
+/** Read all state files from the daemon states directory. */
+export async function readAllDaemonStates() {
+    let entries;
+    try {
+        entries = await fs.readdir(DAEMON_STATES_DIR);
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return [];
+        throw e;
+    }
+    const states = [];
+    for (const entry of entries) {
+        if (!entry.endsWith("-daemon.state"))
+            continue;
+        try {
+            const content = await fs.readFile(path.join(DAEMON_STATES_DIR, entry), "utf-8");
+            states.push(JSON.parse(content));
+        }
+        catch {
+            // Corrupted or partially written — skip
+        }
+    }
+    return states;
+}
+/** Delete a specific daemon's state file. Ignores ENOENT. */
+export async function deleteDaemonState(pid) {
+    try {
+        await fs.unlink(stateFilePath(pid));
+    }
+    catch (e) {
+        if (e.code !== "ENOENT")
+            throw e;
+    }
+}
+/** Check whether a PID is alive. */
+function isPidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        if (e.code === "EPERM")
+            return true; // alive but owned by another user
+        return false; // ESRCH — no such process
+    }
+}
+/** Delete state files for dead PIDs from disk. */
+export async function pruneStaleStates() {
+    const states = await readAllDaemonStates();
+    for (const state of states) {
+        if (!isPidAlive(state.pid)) {
+            await deleteDaemonState(state.pid);
+        }
+    }
+}
+/** Read all states, delete stale files (dead PIDs) from disk, return only alive ones. */
+export async function getAliveDaemonStates() {
+    const states = await readAllDaemonStates();
+    const alive = [];
+    for (const state of states) {
+        if (isPidAlive(state.pid)) {
+            alive.push(state);
+        }
+        else {
+            await deleteDaemonState(state.pid);
+        }
+    }
+    return alive;
+}

package/dist/common-utils/resolvers.d.ts

@@ -1,2 +1,3 @@
 import { BsoResolver } from "@bitsocial/bso-resolver";
+export declare const DEFAULT_PROVIDERS: string[];
 export declare function createBsoResolvers(providers?: string[], dataPath?: string): BsoResolver[];

package/dist/common-utils/resolvers.js

@@ -1,5 +1,12 @@
 import { BsoResolver } from "@bitsocial/bso-resolver";
-const DEFAULT_PROVIDERS = ["viem", "https://ethrpc.xyz"];
+export const DEFAULT_PROVIDERS = [
+    "https://eth.drpc.org",
+    "https://ethereum.publicnode.com",
+    "https://ethereum-rpc.publicnode.com",
+    "https://rpc.mevblocker.io",
+    "https://1rpc.io/eth",
+    "https://eth-pokt.nodies.app"
+];
 export function createBsoResolvers(providers, dataPath) {
     const resolverProviders = providers && providers.length > 0 ? providers : DEFAULT_PROVIDERS;
     return resolverProviders.map((provider) => new BsoResolver({ key: `bso-${provider}`, provider, dataPath }));

package/oclif.manifest.json

@@ -9,8 +9,7 @@
         "bitsocial daemon --pkcRpcUrl ws://localhost:53812",
         "bitsocial daemon --pkcOptions.dataPath /tmp/bitsocial-datapath/",
         "bitsocial daemon --pkcOptions.kuboRpcClientsOptions[0] https://remoteipfsnode.com",
-        "bitsocial daemon --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY",
-        "bitsocial daemon --chainProviderUrls viem --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY"
+        "bitsocial daemon --chainProviderUrls https://mainnet.infura.io/v3/YOUR_KEY"
       ],
       "flags": {
         "pkcRpcUrl": {
@@ -32,11 +31,15 @@
           "type": "option"
         },
         "chainProviderUrls": {
-          "description": "Ethereum RPC URL(s) for .bso/.eth name resolution. Can be specified multiple times. Defaults to viem public transport and https://ethrpc.xyz",
+          "description": "RPC URL(s) for .bso name resolution. Can be specified multiple times.",
           "name": "chainProviderUrls",
           "default": [
-            "viem",
-            "https://ethrpc.xyz"
+            "https://eth.drpc.org",
+            "https://ethereum.publicnode.com",
+            "https://ethereum-rpc.publicnode.com",
+            "https://rpc.mevblocker.io",
+            "https://1rpc.io/eth",
+            "https://eth-pokt.nodies.app"
           ],
           "hasDynamicHelp": false,
           "multiple": true,
@@ -640,7 +643,8 @@
         "bitsocial update install",
         "bitsocial update install latest",
         "bitsocial update install 0.19.40",
-        "bitsocial update install --force"
+        "bitsocial update install --force",
+        "bitsocial update install --no-restart-daemons"
       ],
       "flags": {
         "force": {
@@ -648,6 +652,12 @@
           "name": "force",
           "allowNo": false,
           "type": "boolean"
+        },
+        "restart-daemons": {
+          "description": "Stop all running daemons, update, and restart them with the same settings",
+          "name": "restart-daemons",
+          "allowNo": true,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -703,5 +713,5 @@
       ]
     }
   },
-  "version": "0.19.41"
+  "version": "0.19.43"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@bitsocial/bitsocial-cli",
-    "version": "0.19.41",
+    "version": "0.19.43",
     "description": "Command line interface to Bitsocial API",
     "types": "./dist/index.d.ts",
     "homepage": "https://github.com/bitsocialnet/bitsocial-cli",
@@ -62,7 +62,8 @@
         },
         "hooks": {
             "init": [
-                "./dist/cli/hooks/init/version-hook"
+                "./dist/cli/hooks/init/version-hook",
+                "./dist/cli/hooks/init/banner-hook"
             ],
             "prerun": [
                 "./dist/cli/hooks/prerun/parse-dynamic-flags-hook"
@@ -110,13 +111,13 @@
         "wait-on": "6.0.1"
     },
     "dependencies": {
-        "@bitsocial/bso-resolver": "0.0.4",
+        "@bitsocial/bso-resolver": "0.0.5",
         "@multiformats/multiaddr": "13.0.1",
         "@oclif/core": "4.8.0",
         "@oclif/plugin-help": "6.2.36",
         "@oclif/plugin-not-found": "3.2.73",
         "@oclif/table": "0.5.1",
-        "@pkcprotocol/pkc-js": "0.0.16",
+        "@pkcprotocol/pkc-js": "0.0.17",
         "dataobject-parser": "1.2.22",
         "decompress": "4.2.1",
         "env-paths": "2.2.1",