@cogcoin/client 1.1.3 → 1.1.5

package/README.md

@@ -1,6 +1,6 @@
 # `@cogcoin/client`
 
-`@cogcoin/client@1.1.0` is the reference Cogcoin client package for applications that want a local wallet, durable SQLite-backed state, and a managed Bitcoin Core integration around `@cogcoin/indexer`. It publishes the reusable client APIs, the SQLite adapter, the managed `bitcoind` integration, and the first-party `cogcoin` CLI in one package.
+`@cogcoin/client@1.1.5` is the reference Cogcoin client package for applications that want a local wallet, durable SQLite-backed state, and a managed Bitcoin Core integration around `@cogcoin/indexer`. It publishes the reusable client APIs, the SQLite adapter, the managed `bitcoind` integration, and the first-party `cogcoin` CLI in one package.
 
 Use Node 22 or newer.
 
@@ -131,21 +131,20 @@ Managed node subpath:
 The installed `cogcoin` command covers the first-party local wallet and node workflow:
 
 - update commands such as `update` to compare the current CLI version with the latest npm release and install it
-- wallet lifecycle commands such as `init`, `restore`, `wallet delete`, `wallet show-mnemonic`, and `repair`
+- wallet lifecycle commands such as `init`, `reset`, `wallet show-mnemonic`, and `repair`
 - sync and service commands such as `status`, `sync`, `follow`, `bitcoin start`, `bitcoin stop`, `bitcoin status`, `indexer start`, `indexer stop`, and `indexer status`
 - domain and field commands such as `register`, `anchor`, `show`, `domains`, `fields`, `buy`, `sell`, and `transfer`
 - COG and reputation commands such as `send`, `cog lock`, `claim`, `reclaim`, `rep give`, and `rep revoke`
 - mining commands such as `mine`, `mine start`, `mine stop`, `mine status`, `mine log`, `mine setup`, `mine prompt`, and `mine prompt list`
 
-The CLI also supports stable `--output json` and `--output preview-json` envelopes on the commands that advertise machine-readable output.
 Use `cogcoin mine prompt <domain>` to set or clear a per-domain mining prompt override for one anchored root domain, and `cogcoin mine prompt list` to inspect the current per-domain prompt state alongside the global fallback prompt.
 Interactive text invocations periodically check the npm registry for newer `@cogcoin/client` releases and print `npm install -g @cogcoin/client` when a newer version is available.
 Set `COGCOIN_DISABLE_UPDATE_CHECK=1` to disable the CLI update notice entirely.
 Ordinary `sync`, `follow`, and wallet-aware read/status flows detach from the managed Bitcoin and indexer services on exit instead of stopping them.
 Use the explicit `bitcoin ...` and `indexer ...` commands when you want direct service inspection or start/stop control.
 For provider-backed local wallets, normal reads, mutations, and mining setup flows load local wallet state on demand whenever the local secret provider is available.
-`cogcoin restore` and `cogcoin wallet restore` rebuild a fresh local wallet from a 24-word English BIP39 mnemonic and recreate the managed Core wallet replica.
-Run `cogcoin sync` afterward to bootstrap the managed Bitcoin/indexer state.
+When no wallet exists yet, `cogcoin init` interactively lets you either create a new wallet or restore an existing one from a 24-word English BIP39 mnemonic, then continues into sync.
+To replace an existing wallet with a different mnemonic, run `cogcoin reset`, choose `clear wallet entropy`, and then rerun `cogcoin init`.
 
 ## SQLite Store
 

package/dist/bitcoind/node.js

@@ -5,6 +5,7 @@ import { promisify } from "node:util";
 import net from "node:net";
 import { getBitcoindPath } from "@cogcoin/bitcoin";
 import { resolveDefaultBitcoindDataDirForTesting } from "../app-paths.js";
+import { DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS } from "./types.js";
 import { BitcoinRpcClient } from "./rpc.js";
 const execFileAsync = promisify(execFile);
 const SUPPORTED_BITCOIND_VERSION = "30.2.0";
@@ -156,7 +157,7 @@ export async function launchManagedBitcoindNode(options) {
         endpoint: zmqEndpoint,
         topic: "hashblock",
         port: zmqPort,
-        pollIntervalMs: options.pollIntervalMs ?? 15_000,
+        pollIntervalMs: options.pollIntervalMs ?? DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS,
     };
     const child = spawn(bitcoindPath, buildBitcoindArgsForTesting(resolvedOptions, rpcPort, zmqPort, p2pPort), {
         stdio: ["ignore", "pipe", "pipe"],

package/dist/bitcoind/progress/tty-renderer.js

@@ -90,14 +90,15 @@ export class TtyProgressRenderer {
         const width = Math.max(20, this.#stream.columns ?? 120);
         const progressLine = formatProgressLine(progress, cogcoinSyncHeight, cogcoinSyncTargetHeight, width, now);
         const extraLines = (renderOptions.extraLines ?? []).map((line) => truncateLine(line, width));
+        const renderedExtraLines = extraLines.length > 0 ? ["", ...extraLines] : [""];
         const lines = width >= ART_WIDTH
             ? [...renderFollowFrame(followScene, statusFieldText, now, {
                     artworkCogText: renderOptions.artworkCogText ?? null,
                     artworkSatText: renderOptions.artworkSatText ?? null,
                     artworkStatusLeftText: renderOptions.artworkStatusLeftText ?? null,
                     artworkStatusRightText: renderOptions.artworkStatusRightText ?? null,
-                }), "", progressLine, "", ...extraLines]
-            : [truncateLine(NEUTRAL_MESSAGE_TITLE, width), progressLine, "", ...extraLines];
+                }), "", progressLine, ...renderedExtraLines]
+            : [truncateLine(NEUTRAL_MESSAGE_TITLE, width), progressLine, ...renderedExtraLines];
         const frame = lines.join("\n");
         this.#resetFrameIfExternalWritesDetected();
         if (!this.#rendered) {

package/dist/bitcoind/service.js

@@ -2,7 +2,6 @@ import { randomBytes } from "node:crypto";
 import { execFile, spawn } from "node:child_process";
 import { access, constants, mkdir, readFile, readdir, rm } from "node:fs/promises";
 import { dirname, join } from "node:path";
-import { totalmem } from "node:os";
 import { promisify } from "node:util";
 import net from "node:net";
 import { getBitcoindPath } from "@cogcoin/bitcoin";
@@ -12,37 +11,20 @@ import { writeRuntimeStatusFile } from "../wallet/fs/status-file.js";
 import { stopIndexerDaemonServiceWithLockHeld } from "./indexer-daemon.js";
 import { createRpcClient, validateNodeConfigForTesting } from "./node.js";
 import { resolveManagedServicePaths, UNINITIALIZED_WALLET_ROOT_ID } from "./service-paths.js";
-import { MANAGED_BITCOIND_SERVICE_API_VERSION as MANAGED_BITCOIND_SERVICE_API_VERSION_VALUE } from "./types.js";
+import { DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS, MANAGED_BITCOIND_SERVICE_API_VERSION as MANAGED_BITCOIND_SERVICE_API_VERSION_VALUE, } from "./types.js";
 const execFileAsync = promisify(execFile);
 const LOCAL_HOST = "127.0.0.1";
 const SUPPORTED_BITCOIND_VERSION = "30.2.0";
 const DEFAULT_STARTUP_TIMEOUT_MS = 30_000;
 const DEFAULT_SHUTDOWN_TIMEOUT_MS = 15_000;
-const DEFAULT_DBCACHE_MIB = 450;
+const DEFAULT_DBCACHE_MIB = 2048;
 const claimedUninitializedRuntimeKeys = new Set();
-const GIB = 1024 ** 3;
 export function resolveManagedBitcoindDbcacheMiB(totalRamBytes) {
-    if (!Number.isFinite(totalRamBytes) || totalRamBytes <= 0) {
-        return DEFAULT_DBCACHE_MIB;
-    }
-    if (totalRamBytes < 8 * GIB) {
-        return 450;
-    }
-    if (totalRamBytes < 16 * GIB) {
-        return 768;
-    }
-    if (totalRamBytes < 32 * GIB) {
-        return 1024;
-    }
-    return 2048;
+    void totalRamBytes;
+    return DEFAULT_DBCACHE_MIB;
 }
 function detectManagedBitcoindDbcacheMiB() {
-    try {
-        return resolveManagedBitcoindDbcacheMiB(totalmem());
-    }
-    catch {
-        return DEFAULT_DBCACHE_MIB;
-    }
+    return DEFAULT_DBCACHE_MIB;
 }
 function sleep(ms) {
     return new Promise((resolve) => {
@@ -826,7 +808,7 @@ export async function attachOrStartManagedBitcoindService(options) {
                         endpoint: `tcp://${LOCAL_HOST}:${runtimeConfig.zmqPort}`,
                         topic: "hashblock",
                         port: runtimeConfig.zmqPort,
-                        pollIntervalMs: startOptions.pollIntervalMs ?? 15_000,
+                        pollIntervalMs: startOptions.pollIntervalMs ?? DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS,
                     };
                     const spawnOptions = startOptions.serviceLifetime === "ephemeral"
                         ? {

package/dist/bitcoind/types.d.ts

@@ -87,6 +87,7 @@ export interface ManagedBitcoindRuntimeConfig {
     getblockArchiveEndHeight?: number | null;
     getblockArchiveSha256?: string | null;
 }
+export declare const DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS = 2000;
 export declare const MANAGED_BITCOIND_SERVICE_API_VERSION = "cogcoin/bitcoind-service/v1";
 export type ManagedBitcoindServiceState = "starting" | "ready" | "stopping" | "failed";
 export interface ManagedBitcoindServiceStatus {

package/dist/bitcoind/types.js

@@ -1,3 +1,4 @@
+export const DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS = 2_000;
 export const MANAGED_BITCOIND_SERVICE_API_VERSION = "cogcoin/bitcoind-service/v1";
 export const INDEXER_DAEMON_SERVICE_API_VERSION = "cogcoin/indexer-ipc/v1";
 export const INDEXER_DAEMON_SCHEMA_VERSION = "cogcoin/indexer-db/v1";

package/dist/cli/command-registry.d.ts

@@ -0,0 +1,39 @@
+export type CommandHandlerFamily = "status" | "update" | "sync" | "follow" | "client-admin" | "service-runtime" | "wallet-admin" | "wallet-read" | "wallet-mutation" | "mining-admin" | "mining-runtime" | "mining-read";
+export type CommandName = "init" | "reset" | "repair" | "update" | "sync" | "status" | "client-lock" | "client-change-password" | "client-unlock" | "follow" | "bitcoin-start" | "bitcoin-stop" | "bitcoin-status" | "bitcoin-transfer" | "indexer-start" | "indexer-stop" | "indexer-status" | "anchor" | "register" | "transfer" | "sell" | "unsell" | "buy" | "domain-endpoint-set" | "domain-endpoint-clear" | "domain-delegate-set" | "domain-delegate-clear" | "domain-miner-set" | "domain-miner-clear" | "domain-canonical" | "fields" | "field" | "field-create" | "field-set" | "field-clear" | "send" | "claim" | "reclaim" | "cog-lock" | "rep-give" | "rep-revoke" | "mine" | "mine-start" | "mine-stop" | "mine-setup" | "mine-prompt" | "mine-prompt-list" | "mine-status" | "mine-log" | "wallet-show-mnemonic" | "wallet-status" | "address" | "ids" | "balance" | "locks" | "domains" | "show";
+type AliasMatchMode = "always" | "requires-arg" | "end-or-flag";
+interface HelpEntry {
+    usage: string;
+    description: string;
+}
+interface CommandAlias {
+    tokens: readonly string[];
+    matchMode?: AliasMatchMode;
+}
+export interface CommandSpec {
+    id: CommandName;
+    handlerFamily: CommandHandlerFamily;
+    supportsYes: boolean;
+    supportsSatvb: boolean;
+    aliases: readonly CommandAlias[];
+    helpEntries: readonly HelpEntry[];
+    describeCommand(args: readonly string[], options: {
+        follow: boolean;
+    }): string;
+}
+export interface CommandMatch {
+    command: CommandName;
+    consumedTokens: number;
+    invokedTokens: readonly string[];
+}
+export declare function getCommandSpec(command: CommandName | null): CommandSpec | null;
+export declare function resolveCommandMatch(argv: readonly string[], startIndex: number): CommandMatch | null;
+export declare function resolveUnknownCommandError(argv: readonly string[], startIndex: number): string;
+export declare function getCommandHandlerFamily(command: CommandName | null): CommandHandlerFamily | null;
+export declare function commandSupportsYesFlag(command: CommandName | null): boolean;
+export declare function commandSupportsSatvb(command: CommandName | null): boolean;
+export declare function describeCanonicalCommandFromArgs(command: CommandName | null, args: readonly string[], options?: {
+    follow: boolean;
+}): string;
+export declare function renderHelpText(): string;
+export declare function listCommandSpecsForTesting(): readonly CommandSpec[];
+export {};