@cogcoin/client 1.0.2 → 1.1.0

package/dist/cli/parse.d.ts

@@ -1,3 +1,3 @@
 import type { ParsedCliArgs } from "./types.js";
-export declare const HELP_TEXT = "Usage: cogcoin <command> [options]\n\nCommands:\n  status                  Show wallet-aware local service and chain status\n  status --output json    Emit the stable v1 machine-readable status envelope\n  update                  Show the current and latest client versions and install updates\n  update --output json    Emit the stable v1 machine-readable update result envelope\n  client unlock           Unlock password-protected local wallet secrets for a limited time\n  client lock             Flush the cached client password unlock session\n  client change-password  Rotate the client password that protects local wallet secrets\n  bitcoin start           Start the managed Bitcoin daemon\n  bitcoin stop            Stop the managed Bitcoin daemon and paired indexer\n  bitcoin status          Show managed Bitcoin daemon status without starting it\n  bitcoin transfer <sats> --to <address>\n                         Send plain BTC from the wallet address\n  indexer start           Start the managed Cogcoin indexer (and bitcoind if needed)\n  indexer stop            Stop the managed Cogcoin indexer only\n  indexer status          Show managed Cogcoin indexer status without starting it\n  init                    Initialize a new local wallet root\n  init --output json      Emit the stable v1 machine-readable init result envelope\n  restore                 Restore an imported named seed from a 24-word mnemonic; run sync afterward\n  reset                   Factory-reset local Cogcoin state with interactive retention prompts\n  repair                  Recover bounded wallet/indexer/runtime state\n  wallet address          Alias for address\n  wallet ids              Alias for ids\n  mine                    Run the miner in the foreground\n  mine start              Start the miner as a background worker\n  mine stop               Stop the active background miner\n  mine setup              Configure the built-in mining provider\n  mine setup --output json\n                         Emit the stable v1 machine-readable mine setup result envelope\n  mine status             Show mining control-plane health and readiness\n  mine log                Show recent mining control-plane events\n  anchor <domain>         Anchor an owned unanchored domain with the wallet address\n  register <domain>\n                         Register a root domain or subdomain\n  transfer <domain> --to <btc-target>\n                          Transfer an unanchored domain to another BTC address or script\n  sell <domain> <price>   List an unanchored domain for sale in COG\n  unsell <domain>         Clear an active domain listing\n  buy <domain>\n                         Buy an unanchored listed domain in COG\n  send <amount> --to <btc-target>\n                         Send COG from the wallet address to another BTC target\n  claim <lock-id> --preimage <32-byte-hex>\n                         Claim an active COG lock before timeout\n  reclaim <lock-id>      Reclaim an expired COG lock as the original locker\n  cog lock <amount> --to-domain <domain> (--for <blocks-or-duration> | --until-height <height>) --condition <sha256hex>\n                         Lock COG to an anchored recipient domain\n  wallet status           Show detailed wallet-local status and service health\n  wallet init             Initialize a new local wallet root\n  wallet restore          Restore an imported named seed from a 24-word mnemonic; run sync afterward\n  wallet delete           Delete one imported named seed without affecting main\n  wallet show-mnemonic    Reveal the initialized wallet recovery phrase after typed confirmation\n  address                 Show the BTC wallet address for this wallet\n  ids                     Show the local wallet address\n  balance                 Show local wallet COG balances\n  locks                   Show locally related active COG locks\n  domain list             Alias for domains\n  domain show <domain>    Alias for show <domain>\n  domains [--anchored] [--listed] [--mineable]\n                         Show locally related domains\n  show <domain>           Show one domain and its local-wallet relationship\n  fields <domain>         List current fields on a domain\n  field <domain> <field>  Show one current field value\n  field create <domain> <field>\n                         Create a new empty anchored field\n  field set <domain> <field>\n                         Update an existing anchored field value\n  field clear <domain> <field>\n                         Clear an existing anchored field value\n  rep give <source-domain> <target-domain> <amount>\n                         Burn COG as anchored-domain reputation support\n  rep revoke <source-domain> <target-domain> <amount>\n                         Revoke visible support without refunding burned COG\n\nOptions:\n  --db <path>       Override the SQLite database path\n  --data-dir <path> Override the managed bitcoin datadir\n  --for <duration>  Relative timeout for cog lock, like 15m, 2h, or 1d\n  --message <text>  Founding message text for anchor\n  --to <btc-target> Transfer or send target as an address or spk:<hex>\n  --to-domain <domain>\n                    Recipient domain for cog lock\n  --condition <sha256hex>\n                    32-byte lock condition hash\n  --until-height <height>\n                    Absolute timeout height for cog lock\n  --preimage <32-byte-hex>\n                    Claim preimage for an active lock\n  --review <text>   Optional public review text for reputation operations\n  --satvb <n>       Override the mutation fee rate in sat/vB\n  --text <utf8>     UTF-8 payload text for endpoint or field writes\n  --json <json>     UTF-8 payload JSON text for endpoint or field writes\n  --bytes <spec>    Payload bytes as hex:<hex> or @<path>\n  --permanent       Create the field as permanent\n  --format <spec>   Advanced field format as raw:<u8>\n  --value <spec>    Advanced field value as hex:<hex>, @<path>, or utf8:<text>\n  --claimable      Show only currently claimable locks\n  --reclaimable    Show only currently reclaimable locks\n  --anchored       Show only anchored domains\n  --listed         Show only currently listed domains\n  --mineable       Show only locally mineable root domains\n  --limit <n>      Limit list rows (1..1000)\n  --all            Show all rows for list commands\n  --follow         Follow mining log output\n  --output <mode>  Output mode: text, json, or preview-json\n  --progress <mode> Progress output mode: auto, tty, or none\n  --seed <name>    Select an imported wallet seed for wallet-aware commands\n  --force          Reserved for future use\n  --force-race      Allow a visible root registration race\n  --yes             Approve eligible plain yes/no mutation confirmations non-interactively\n  --help            Show help\n  --version         Show package version\n\nQuickstart:\n  1. Run `cogcoin init` to create the wallet.\n  2. Run `cogcoin sync` to bootstrap assumeutxo and the managed Bitcoin/indexer state.\n  3. Run `cogcoin address`, then fund the wallet with about 0.0015 BTC so you can buy a 6+ character domain to start mining and still keep BTC available for mining transaction fees.\n\nExamples:\n  cogcoin status --output json\n  cogcoin bitcoin status\n  cogcoin indexer status\n  cogcoin init --output json\n  cogcoin restore --seed trading\n  cogcoin wallet address\n  cogcoin domain list --mineable\n  cogcoin register alpha-child\n  cogcoin anchor alpha\n  cogcoin register alpha --satvb 12.5\n  cogcoin buy alpha\n  cogcoin field set alpha bio --text \"hello\"\n  cogcoin rep give alpha beta 10 --review \"great operator\"\n  cogcoin mine setup --output json\n  cogcoin register alpha-child --output preview-json\n  cogcoin mine status\n";
+export declare const HELP_TEXT = "Usage: cogcoin <command> [options]\n\nCommands:\n  status                  Show wallet-aware local service and chain status\n  status --output json    Emit the stable v1 machine-readable status envelope\n  update                  Show the current and latest client versions and install updates\n  update --output json    Emit the stable v1 machine-readable update result envelope\n  client unlock           Unlock password-protected local wallet secrets for a limited time\n  client lock             Flush the cached client password unlock session\n  client change-password  Rotate the client password that protects local wallet secrets\n  bitcoin start           Start the managed Bitcoin daemon\n  bitcoin stop            Stop the managed Bitcoin daemon and paired indexer\n  bitcoin status          Show managed Bitcoin daemon status without starting it\n  bitcoin transfer <sats> --to <address>\n                         Send plain BTC from the wallet address\n  indexer start           Start the managed Cogcoin indexer (and bitcoind if needed)\n  indexer stop            Stop the managed Cogcoin indexer only\n  indexer status          Show managed Cogcoin indexer status without starting it\n  init                    Initialize a new local wallet root\n  init --output json      Emit the stable v1 machine-readable init result envelope\n  restore                 Restore an imported named seed from a 24-word mnemonic; run sync afterward\n  reset                   Factory-reset local Cogcoin state with interactive retention prompts\n  repair                  Recover bounded wallet/indexer/runtime state\n  wallet address          Alias for address\n  wallet ids              Alias for ids\n  mine                    Run the miner in the foreground\n  mine start              Start the miner as a background worker\n  mine stop               Stop the active background miner\n  mine setup              Configure the built-in mining provider\n  mine setup --output json\n                         Emit the stable v1 machine-readable mine setup result envelope\n  mine prompt             Show per-domain mining prompt state\n  mine prompt --output json\n                         Emit the stable v1 machine-readable mine prompt list envelope\n  mine prompt <domain>    Configure a per-domain mining prompt override\n  mine prompt <domain> --output json\n                         Emit the stable v1 machine-readable mine prompt result envelope\n  mine prompt list        Alias for mine prompt\n  mine status             Show mining control-plane health and readiness\n  mine log                Show recent mining control-plane events\n  anchor <domain>         Anchor an owned unanchored domain with the wallet address\n  register <domain>\n                         Register a root domain or subdomain\n  transfer <domain> --to <btc-target>\n                          Transfer an unanchored domain to another BTC address or script\n  sell <domain> <price>   List an unanchored domain for sale in COG\n  unsell <domain>         Clear an active domain listing\n  buy <domain>\n                         Buy an unanchored listed domain in COG\n  send <amount> --to <btc-target>\n                         Send COG from the wallet address to another BTC target\n  claim <lock-id> --preimage <32-byte-hex>\n                         Claim an active COG lock before timeout\n  reclaim <lock-id>      Reclaim an expired COG lock as the original locker\n  cog lock <amount> --to-domain <domain> (--for <blocks-or-duration> | --until-height <height>) --condition <sha256hex>\n                         Lock COG to an anchored recipient domain\n  wallet status           Show detailed wallet-local status and service health\n  wallet init             Initialize a new local wallet root\n  wallet restore          Restore an imported named seed from a 24-word mnemonic; run sync afterward\n  wallet delete           Delete one imported named seed without affecting main\n  wallet show-mnemonic    Reveal the initialized wallet recovery phrase after typed confirmation\n  address                 Show the BTC wallet address for this wallet\n  ids                     Show the local wallet address\n  balance                 Show local wallet COG balances\n  locks                   Show locally related active COG locks\n  domain list             Alias for domains\n  domain show <domain>    Alias for show <domain>\n  domains [--anchored] [--listed] [--mineable]\n                         Show locally related domains\n  show <domain>           Show one domain and its local-wallet relationship\n  fields <domain>         List current fields on a domain\n  field <domain> <field>  Show one current field value\n  field create <domain> <field>\n                         Create a new empty anchored field\n  field set <domain> <field>\n                         Update an existing anchored field value\n  field clear <domain> <field>\n                         Clear an existing anchored field value\n  rep give <source-domain> <target-domain> <amount>\n                         Burn COG as anchored-domain reputation support\n  rep revoke <source-domain> <target-domain> <amount>\n                         Revoke visible support without refunding burned COG\n\nOptions:\n  --db <path>       Override the SQLite database path\n  --data-dir <path> Override the managed bitcoin datadir\n  --for <duration>  Relative timeout for cog lock, like 15m, 2h, or 1d\n  --message <text>  Founding message text for anchor\n  --to <btc-target> Transfer or send target as an address or spk:<hex>\n  --to-domain <domain>\n                    Recipient domain for cog lock\n  --condition <sha256hex>\n                    32-byte lock condition hash\n  --until-height <height>\n                    Absolute timeout height for cog lock\n  --preimage <32-byte-hex>\n                    Claim preimage for an active lock\n  --review <text>   Optional public review text for reputation operations\n  --satvb <n>       Override the mutation fee rate in sat/vB\n  --text <utf8>     UTF-8 payload text for endpoint or field writes\n  --json <json>     UTF-8 payload JSON text for endpoint or field writes\n  --bytes <spec>    Payload bytes as hex:<hex> or @<path>\n  --permanent       Create the field as permanent\n  --format <spec>   Advanced field format as raw:<u8>\n  --value <spec>    Advanced field value as hex:<hex>, @<path>, or utf8:<text>\n  --claimable      Show only currently claimable locks\n  --reclaimable    Show only currently reclaimable locks\n  --anchored       Show only anchored domains\n  --listed         Show only currently listed domains\n  --mineable       Show only locally mineable root domains\n  --limit <n>      Limit list rows (1..1000)\n  --all            Show all rows for list commands\n  --follow         Follow mining log output\n  --output <mode>  Output mode: text, json, or preview-json\n  --progress <mode> Progress output mode: auto, tty, or none\n  --seed <name>    Select an imported wallet seed for wallet-aware commands\n  --force          Reserved for future use\n  --force-race      Allow a visible root registration race\n  --yes             Approve eligible plain yes/no mutation confirmations non-interactively\n  --help            Show help\n  --version         Show package version\n\nQuickstart:\n  1. Run `cogcoin init` to create the wallet.\n  2. Run `cogcoin sync` to bootstrap assumeutxo and the managed Bitcoin/indexer state.\n  3. Run `cogcoin address`, then fund the wallet with about 0.0015 BTC so you can buy a 6+ character domain to start mining and still keep BTC available for mining transaction fees.\n\nExamples:\n  cogcoin status --output json\n  cogcoin bitcoin status\n  cogcoin indexer status\n  cogcoin init --output json\n  cogcoin restore --seed trading\n  cogcoin wallet address\n  cogcoin domain list --mineable\n  cogcoin register alpha-child\n  cogcoin anchor alpha\n  cogcoin register alpha --satvb 12.5\n  cogcoin buy alpha\n  cogcoin field set alpha bio --text \"hello\"\n  cogcoin rep give alpha beta 10 --review \"great operator\"\n  cogcoin mine setup --output json\n  cogcoin mine prompt\n  cogcoin mine prompt alpha\n  cogcoin register alpha-child --output preview-json\n  cogcoin mine status\n";
 export declare function parseCliArgs(argv: string[]): ParsedCliArgs;

package/dist/cli/parse.js

@@ -31,6 +31,13 @@ Commands:
   mine setup              Configure the built-in mining provider
   mine setup --output json
                          Emit the stable v1 machine-readable mine setup result envelope
+  mine prompt             Show per-domain mining prompt state
+  mine prompt --output json
+                         Emit the stable v1 machine-readable mine prompt list envelope
+  mine prompt <domain>    Configure a per-domain mining prompt override
+  mine prompt <domain> --output json
+                         Emit the stable v1 machine-readable mine prompt result envelope
+  mine prompt list        Alias for mine prompt
   mine status             Show mining control-plane health and readiness
   mine log                Show recent mining control-plane events
   anchor <domain>         Anchor an owned unanchored domain with the wallet address
@@ -135,6 +142,8 @@ Examples:
   cogcoin field set alpha bio --text "hello"
   cogcoin rep give alpha beta 10 --review "great operator"
   cogcoin mine setup --output json
+  cogcoin mine prompt
+  cogcoin mine prompt alpha
   cogcoin register alpha-child --output preview-json
   cogcoin mine status
 `;
@@ -223,6 +232,8 @@ function supportsSeedFlag(command) {
         case "mine-start":
         case "mine-stop":
         case "mine-setup":
+        case "mine-prompt":
+        case "mine-prompt-list":
         case "mine-status":
         case "mine-log":
         case "wallet-delete":
@@ -648,6 +659,14 @@ export function parseCliArgs(argv) {
                     index += 1;
                     continue;
                 }
+                if (subcommand === "prompt") {
+                    const action = argv[index + 2] ?? null;
+                    command = action === null || action.startsWith("--") || action === "list"
+                        ? "mine-prompt-list"
+                        : "mine-prompt";
+                    index += action === "list" ? 2 : 1;
+                    continue;
+                }
                 if (subcommand === "status") {
                     command = "mine-status";
                     index += 1;
@@ -889,6 +908,7 @@ export function parseCliArgs(argv) {
         || command === "mine-start"
         || command === "mine-stop"
         || command === "mine-setup"
+        || command === "mine-prompt-list"
         || command === "mine-status"
         || command === "mine-log"
         || command === "wallet-address"
@@ -912,6 +932,9 @@ export function parseCliArgs(argv) {
         && args.length !== 1) {
         throw new Error("cli_missing_domain_argument");
     }
+    if (command === "mine-prompt" && args.length !== 1) {
+        throw new Error("cli_missing_domain_argument");
+    }
     if ((command === "domain-endpoint-set"
         || command === "domain-endpoint-clear"
         || command === "domain-delegate-clear"

package/dist/cli/read-json.d.ts

@@ -1,5 +1,5 @@
 import type { WalletDomainView, WalletFieldView, WalletLockView, WalletReadContext } from "../wallet/read/index.js";
-import type { MiningControlPlaneView, MiningEventRecord } from "../wallet/mining/index.js";
+import type { MiningControlPlaneView, MiningDomainPromptListResult, MiningEventRecord } from "../wallet/mining/index.js";
 import type { PendingMutationRecord } from "../wallet/types.js";
 import type { JsonAvailabilityEntry, JsonPage } from "./output.js";
 export interface ReadJsonResult<T> {
@@ -137,6 +137,18 @@ export declare function buildMineLogJson(events: MiningEventRecord[], page: Json
     rotation: number[];
     page: JsonPage;
 }>;
+export declare function buildMinePromptListJson(result: MiningDomainPromptListResult): ReadJsonResult<{
+    fallbackPromptConfigured: boolean;
+    prompts: Array<{
+        domain: {
+            name: string;
+            domainId: number | null;
+        };
+        mineable: boolean;
+        prompt: string | null;
+        effectivePromptSource: "domain" | "global-fallback" | "none";
+    }>;
+}>;
 export declare function buildBalanceJson(context: WalletReadContext): ReadJsonResult<{
     assetLabel: string;
     totalCogtoshi: string | null;

package/dist/cli/read-json.js

@@ -410,6 +410,9 @@ export function buildMineStatusJson(mining) {
             ? "Run `cogcoin mine setup` and clear or correct the provider model."
             : "Run `cogcoin mine setup` and choose a valid provider model.");
     }
+    else if (mining.runtime.currentPublishDecision === "publish-paused-insufficient-funds") {
+        nextSteps.push("Wait for enough safe BTC funding to become spendable for the next publish; mining resumes automatically.");
+    }
     else if (mining.runtime.pauseReason === "zero-reward") {
         nextSteps.push("Wait for the next positive-reward target height; mining resumes automatically.");
     }
@@ -489,6 +492,34 @@ export function buildMineLogJson(events, page, rotation) {
         },
     };
 }
+export function buildMinePromptListJson(result) {
+    const explanations = [];
+    const nextSteps = [];
+    if (result.prompts.length === 0) {
+        explanations.push("No mineable root domains or stored per-domain mining prompts are configured.");
+        nextSteps.push("Run `cogcoin domains --mineable` to see eligible mining domains.");
+    }
+    else {
+        const nextDomainPrompt = result.prompts.find((entry) => entry.mineable && entry.prompt === null);
+        if (nextDomainPrompt !== undefined) {
+            nextSteps.push(`cogcoin mine prompt ${nextDomainPrompt.domain.name}`);
+        }
+    }
+    return {
+        warnings: [],
+        explanations,
+        nextSteps,
+        data: {
+            fallbackPromptConfigured: result.fallbackPromptConfigured,
+            prompts: result.prompts.map((entry) => ({
+                domain: entry.domain,
+                mineable: entry.mineable,
+                prompt: entry.prompt,
+                effectivePromptSource: entry.effectivePromptSource,
+            })),
+        },
+    };
+}
 export function buildBalanceJson(context) {
     const messages = createBaseMessages(context);
     const total = walletCogBalance(context);

package/dist/cli/runner.js

@@ -92,7 +92,8 @@ export async function runCli(argv, contextOverrides = {}) {
             || parsed.command === "mine-stop") {
             return runMiningRuntimeCommand(parsed, context);
         }
-        if (parsed.command === "mine-setup") {
+        if (parsed.command === "mine-setup"
+            || parsed.command === "mine-prompt") {
             return runMiningAdminCommand(parsed, context);
         }
         if (parsed.command === "init"
@@ -139,7 +140,8 @@ export async function runCli(argv, contextOverrides = {}) {
             || parsed.command === "rep-revoke") {
             return runWalletMutationCommand(parsed, context);
         }
-        if (parsed.command === "mine-status"
+        if (parsed.command === "mine-prompt-list"
+            || parsed.command === "mine-status"
             || parsed.command === "mine-log") {
             return runMiningReadCommand(parsed, context);
         }

package/dist/cli/signals.d.ts

@@ -1,4 +1,16 @@
 import type { InterruptibleOutcome, ManagedClientLike, SignalSource, StopSignalWatcher, WritableLike } from "./types.js";
+export declare function createCloseSignalWatcher(options: {
+    signalSource: SignalSource;
+    stderr: WritableLike;
+    closeable: {
+        close(): Promise<void>;
+    };
+    forceExit: (code: number) => never | void;
+    lockPaths?: readonly string[];
+    firstMessage?: string | null;
+    successMessage?: string | null;
+    failureMessage?: string | null;
+}): StopSignalWatcher;
 export declare function createStopSignalWatcher(signalSource: SignalSource, stderr: WritableLike, client: ManagedClientLike, forceExit: (code: number) => never | void, lockPaths?: readonly string[]): StopSignalWatcher;
 export declare function createOwnedLockCleanupSignalWatcher(signalSource: SignalSource, forceExit: (code: number) => never | void, lockPaths: readonly string[]): StopSignalWatcher;
 export declare function waitForCompletionOrStop<T>(promise: Promise<T>, stopWatcher: StopSignalWatcher): Promise<InterruptibleOutcome<T>>;

package/dist/cli/signals.js

@@ -1,12 +1,12 @@
 import { writeLine } from "./io.js";
 import { clearLockIfOwnedByCurrentProcess } from "../wallet/fs/lock.js";
-export function createStopSignalWatcher(signalSource, stderr, client, forceExit, lockPaths = []) {
+export function createCloseSignalWatcher(options) {
     let closing = false;
     let resolved = false;
     let onSignal = () => { };
     const cleanup = () => {
-        signalSource.off("SIGINT", onSignal);
-        signalSource.off("SIGTERM", onSignal);
+        options.signalSource.off("SIGINT", onSignal);
+        options.signalSource.off("SIGTERM", onSignal);
     };
     const promise = new Promise((resolve) => {
         const settle = (code) => {
@@ -18,26 +18,32 @@ export function createStopSignalWatcher(signalSource, stderr, client, forceExit,
             resolve(code);
         };
         const releaseOwnedLocks = async () => {
-            await Promise.allSettled([...new Set(lockPaths)].map(async (lockPath) => {
+            await Promise.allSettled([...new Set(options.lockPaths ?? [])].map(async (lockPath) => {
                 await clearLockIfOwnedByCurrentProcess(lockPath);
             }));
         };
         const onFirstSignal = () => {
             closing = true;
-            writeLine(stderr, "Detaching from managed Cogcoin client and resuming background indexer follow...");
-            void client.close().then(async () => {
+            if (options.firstMessage !== null && options.firstMessage !== undefined) {
+                writeLine(options.stderr, options.firstMessage);
+            }
+            void options.closeable.close().then(async () => {
                 await releaseOwnedLocks();
                 if (resolved) {
                     return;
                 }
-                writeLine(stderr, "Detached cleanly; background indexer follow resumed.");
+                if (options.successMessage !== null && options.successMessage !== undefined) {
+                    writeLine(options.stderr, options.successMessage);
+                }
                 settle(0);
             }, async () => {
                 await releaseOwnedLocks();
                 if (resolved) {
                     return;
                 }
-                writeLine(stderr, "Detach failed before background indexer follow was confirmed.");
+                if (options.failureMessage !== null && options.failureMessage !== undefined) {
+                    writeLine(options.stderr, options.failureMessage);
+                }
                 settle(1);
             });
         };
@@ -47,23 +53,35 @@ export function createStopSignalWatcher(signalSource, stderr, client, forceExit,
                 return;
             }
             settle(130);
-            if (lockPaths.length === 0) {
-                forceExit(130);
+            if ((options.lockPaths ?? []).length === 0) {
+                options.forceExit(130);
                 return;
             }
             void releaseOwnedLocks().finally(() => {
-                forceExit(130);
+                options.forceExit(130);
             });
         };
     });
-    signalSource.on("SIGINT", onSignal);
-    signalSource.on("SIGTERM", onSignal);
+    options.signalSource.on("SIGINT", onSignal);
+    options.signalSource.on("SIGTERM", onSignal);
     return {
         cleanup,
         isStopping: () => closing,
         promise,
     };
 }
+export function createStopSignalWatcher(signalSource, stderr, client, forceExit, lockPaths = []) {
+    return createCloseSignalWatcher({
+        signalSource,
+        stderr,
+        closeable: client,
+        forceExit,
+        lockPaths,
+        firstMessage: "Detaching from managed Cogcoin client and resuming background indexer follow...",
+        successMessage: "Detached cleanly; background indexer follow resumed.",
+        failureMessage: "Detach failed before background indexer follow was confirmed.",
+    });
+}
 export function createOwnedLockCleanupSignalWatcher(signalSource, forceExit, lockPaths) {
     let stopping = false;
     let resolved = false;

package/dist/cli/types.d.ts

@@ -1,4 +1,5 @@
 import type { inspectPassiveClientStatus } from "../passive-status.js";
+import type { ManagedIndexerMonitor, openManagedIndexerMonitor } from "../bitcoind/indexer-monitor.js";
 import { createRpcClient } from "../bitcoind/node.js";
 import type { ManagedBitcoindProgressEvent } from "../bitcoind/types.js";
 import { attachOrStartIndexerDaemon, probeIndexerDaemon, readObservedIndexerDaemonStatus, stopIndexerDaemonService } from "../bitcoind/indexer-daemon.js";
@@ -10,11 +11,11 @@ import type { WalletPrompter, initializeWallet, deleteImportedWalletSeed, previe
 import type { openWalletReadContext } from "../wallet/read/index.js";
 import { loadRawWalletStateEnvelope, loadWalletState } from "../wallet/state/storage.js";
 import type { WalletSecretProvider } from "../wallet/state/provider.js";
-import type { ensureBuiltInMiningSetupIfNeeded, followMiningLog, inspectMiningControlPlane, readMiningLog, runForegroundMining, setupBuiltInMining, startBackgroundMining, stopBackgroundMining } from "../wallet/mining/index.js";
+import type { ensureBuiltInMiningSetupIfNeeded, followMiningLog, inspectMiningControlPlane, inspectMiningDomainPromptState, readMiningLog, runForegroundMining, setupBuiltInMining, startBackgroundMining, stopBackgroundMining, updateMiningDomainPrompt } from "../wallet/mining/index.js";
 import type { anchorDomain, transferBitcoin, buyDomain, claimCogLock, clearDomainDelegate, clearDomainEndpoint, clearDomainMiner, clearField, createField, giveReputation, lockCogToDomain, registerDomain, reclaimCogLock, revokeReputation, sendCog, setField, setDomainCanonical, setDomainDelegate, setDomainEndpoint, setDomainMiner, sellDomain, transferDomain } from "../wallet/tx/index.js";
 export type ProgressOutput = "auto" | "tty" | "none";
 export type OutputMode = "text" | "json" | "preview-json";
-export type CommandName = "init" | "restore" | "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" | "domain-anchor" | "register" | "domain-register" | "transfer" | "domain-transfer" | "sell" | "domain-sell" | "unsell" | "domain-unsell" | "buy" | "domain-buy" | "domain-endpoint-set" | "domain-endpoint-clear" | "domain-delegate-set" | "domain-delegate-clear" | "domain-miner-set" | "domain-miner-clear" | "domain-canonical" | "field-list" | "field-show" | "field-create" | "field-set" | "field-clear" | "send" | "claim" | "reclaim" | "cog-send" | "cog-claim" | "cog-reclaim" | "cog-lock" | "rep-give" | "rep-revoke" | "cog-balance" | "cog-locks" | "mine" | "mine-start" | "mine-stop" | "mine-setup" | "mine-status" | "mine-log" | "wallet-init" | "wallet-delete" | "wallet-restore" | "wallet-show-mnemonic" | "wallet-status" | "wallet-address" | "wallet-ids" | "address" | "ids" | "balance" | "locks" | "domain-list" | "domains" | "domain-show" | "show" | "fields" | "field";
+export type CommandName = "init" | "restore" | "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" | "domain-anchor" | "register" | "domain-register" | "transfer" | "domain-transfer" | "sell" | "domain-sell" | "unsell" | "domain-unsell" | "buy" | "domain-buy" | "domain-endpoint-set" | "domain-endpoint-clear" | "domain-delegate-set" | "domain-delegate-clear" | "domain-miner-set" | "domain-miner-clear" | "domain-canonical" | "field-list" | "field-show" | "field-create" | "field-set" | "field-clear" | "send" | "claim" | "reclaim" | "cog-send" | "cog-claim" | "cog-reclaim" | "cog-lock" | "rep-give" | "rep-revoke" | "cog-balance" | "cog-locks" | "mine" | "mine-start" | "mine-stop" | "mine-setup" | "mine-prompt" | "mine-prompt-list" | "mine-status" | "mine-log" | "wallet-init" | "wallet-delete" | "wallet-restore" | "wallet-show-mnemonic" | "wallet-status" | "wallet-address" | "wallet-ids" | "address" | "ids" | "balance" | "locks" | "domain-list" | "domains" | "domain-show" | "show" | "fields" | "field";
 export interface WritableLike {
     isTTY?: boolean;
     write(chunk: string): void;
@@ -71,7 +72,6 @@ export interface ManagedClientLike {
         bestHeight: number;
     }>;
     playSyncCompletionScene?(): Promise<void>;
-    detachToBackgroundFollow?(): Promise<void>;
     startFollowingTip(): Promise<void>;
     getNodeStatus(): Promise<{
         indexedTip: {
@@ -83,6 +83,8 @@ export interface ManagedClientLike {
     }>;
     close(): Promise<void>;
 }
+export interface ManagedIndexerMonitorLike extends ManagedIndexerMonitor {
+}
 export interface CliRunnerContext {
     stdout?: WritableLike;
     stderr?: WritableLike;
@@ -100,7 +102,6 @@ export interface CliRunnerContext {
     openSqliteStore?: typeof openSqliteStore;
     openManagedBitcoindClient?: (options: {
         store: ClientStoreAdapter;
-        databasePath?: string;
         dataDir?: string;
         walletRootId?: string;
         progressOutput?: ProgressOutput;
@@ -110,6 +111,7 @@ export interface CliRunnerContext {
             nextArchiveEndHeight: number;
         }) => Promise<boolean>;
     }) => Promise<ManagedClientLike>;
+    openManagedIndexerMonitor?: typeof openManagedIndexerMonitor;
     attachManagedBitcoindService?: typeof attachOrStartManagedBitcoindService;
     probeManagedBitcoindService?: typeof probeManagedBitcoindService;
     stopManagedBitcoindService?: typeof stopManagedBitcoindService;
@@ -150,11 +152,13 @@ export interface CliRunnerContext {
     giveReputation?: typeof giveReputation;
     revokeReputation?: typeof revokeReputation;
     inspectMiningControlPlane?: typeof inspectMiningControlPlane;
+    inspectMiningDomainPromptState?: typeof inspectMiningDomainPromptState;
     ensureBuiltInMiningSetupIfNeeded?: typeof ensureBuiltInMiningSetupIfNeeded;
     runForegroundMining?: typeof runForegroundMining;
     startBackgroundMining?: typeof startBackgroundMining;
     stopBackgroundMining?: typeof stopBackgroundMining;
     setupBuiltInMining?: typeof setupBuiltInMining;
+    updateMiningDomainPrompt?: typeof updateMiningDomainPrompt;
     readMiningLog?: typeof readMiningLog;
     followMiningLog?: typeof followMiningLog;
     repairWallet?: typeof repairWallet;

package/dist/cli/update-service.d.ts

@@ -1,19 +1,10 @@
+import { compareSemver, parseSemver, type ParsedSemver } from "../semver.js";
 export declare const UPDATE_CHECK_CACHE_SCHEMA_VERSION = 1;
 export declare const UPDATE_CHECK_MAX_AGE_MS: number;
 export declare const PASSIVE_UPDATE_CHECK_TIMEOUT_MS = 500;
 export declare const EXPLICIT_UPDATE_CHECK_TIMEOUT_MS = 5000;
 export declare const UPDATE_CHECK_URL = "https://registry.npmjs.org/@cogcoin/client/latest";
 export declare const CLI_INSTALL_COMMAND = "npm install -g @cogcoin/client";
-export interface ParsedSemver {
-    major: number;
-    minor: number;
-    patch: number;
-    prerelease: Array<{
-        raw: string;
-        numeric: boolean;
-        numericValue: number | null;
-    }>;
-}
 export interface UpdateCheckCache {
     schemaVersion: typeof UPDATE_CHECK_CACHE_SCHEMA_VERSION;
     lastCheckedAtUnixMs: number;
@@ -31,8 +22,7 @@ export type UpdateCheckResult = {
     errorKind: string;
 };
 export declare function createEmptyUpdateCheckCache(): UpdateCheckCache;
-export declare function parseSemver(version: string): ParsedSemver | null;
-export declare function compareSemver(left: string, right: string): number | null;
+export { compareSemver, parseSemver, type ParsedSemver };
 export declare function isUpdateCheckDisabled(env: NodeJS.ProcessEnv): boolean;
 export declare function loadUpdateCheckCache(cachePath: string): Promise<UpdateCheckCache | null>;
 export declare function shouldRefreshUpdateCheck(cache: UpdateCheckCache, now: number): boolean;

package/dist/cli/update-service.js

@@ -1,4 +1,5 @@
 import { readFile } from "node:fs/promises";
+import { compareSemver, parseSemver, } from "../semver.js";
 import { writeJsonFileAtomic } from "../wallet/fs/atomic.js";
 export const UPDATE_CHECK_CACHE_SCHEMA_VERSION = 1;
 export const UPDATE_CHECK_MAX_AGE_MS = 24 * 60 * 60 * 1000;
@@ -16,74 +17,7 @@ export function createEmptyUpdateCheckCache() {
         lastNotifiedAtUnixMs: null,
     };
 }
-export function parseSemver(version) {
-    const match = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.exec(version.trim());
-    if (match === null) {
-        return null;
-    }
-    const prerelease = match[4] === undefined
-        ? []
-        : match[4].split(".").map((raw) => ({
-            raw,
-            numeric: /^(0|[1-9]\d*)$/.test(raw),
-            numericValue: /^(0|[1-9]\d*)$/.test(raw) ? Number(raw) : null,
-        }));
-    return {
-        major: Number(match[1]),
-        minor: Number(match[2]),
-        patch: Number(match[3]),
-        prerelease,
-    };
-}
-export function compareSemver(left, right) {
-    const leftParsed = parseSemver(left);
-    const rightParsed = parseSemver(right);
-    if (leftParsed === null || rightParsed === null) {
-        return null;
-    }
-    if (leftParsed.major !== rightParsed.major) {
-        return leftParsed.major > rightParsed.major ? 1 : -1;
-    }
-    if (leftParsed.minor !== rightParsed.minor) {
-        return leftParsed.minor > rightParsed.minor ? 1 : -1;
-    }
-    if (leftParsed.patch !== rightParsed.patch) {
-        return leftParsed.patch > rightParsed.patch ? 1 : -1;
-    }
-    if (leftParsed.prerelease.length === 0 && rightParsed.prerelease.length === 0) {
-        return 0;
-    }
-    if (leftParsed.prerelease.length === 0) {
-        return 1;
-    }
-    if (rightParsed.prerelease.length === 0) {
-        return -1;
-    }
-    const maxLength = Math.max(leftParsed.prerelease.length, rightParsed.prerelease.length);
-    for (let index = 0; index < maxLength; index += 1) {
-        const leftIdentifier = leftParsed.prerelease[index];
-        const rightIdentifier = rightParsed.prerelease[index];
-        if (leftIdentifier === undefined) {
-            return -1;
-        }
-        if (rightIdentifier === undefined) {
-            return 1;
-        }
-        if (leftIdentifier.numeric && rightIdentifier.numeric) {
-            if (leftIdentifier.numericValue !== rightIdentifier.numericValue) {
-                return leftIdentifier.numericValue > rightIdentifier.numericValue ? 1 : -1;
-            }
-            continue;
-        }
-        if (leftIdentifier.numeric !== rightIdentifier.numeric) {
-            return leftIdentifier.numeric ? -1 : 1;
-        }
-        if (leftIdentifier.raw !== rightIdentifier.raw) {
-            return leftIdentifier.raw > rightIdentifier.raw ? 1 : -1;
-        }
-    }
-    return 0;
-}
+export { compareSemver, parseSemver };
 export function isUpdateCheckDisabled(env) {
     const raw = env.COGCOIN_DISABLE_UPDATE_CHECK;
     if (raw === undefined) {

package/dist/semver.d.ts

@@ -0,0 +1,12 @@
+export interface ParsedSemver {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease: Array<{
+        raw: string;
+        numeric: boolean;
+        numericValue: number | null;
+    }>;
+}
+export declare function parseSemver(version: string): ParsedSemver | null;
+export declare function compareSemver(left: string, right: string): number | null;

package/dist/semver.js

@@ -0,0 +1,68 @@
+export function parseSemver(version) {
+    const match = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.exec(version.trim());
+    if (match === null) {
+        return null;
+    }
+    const prerelease = match[4] === undefined
+        ? []
+        : match[4].split(".").map((raw) => ({
+            raw,
+            numeric: /^(0|[1-9]\d*)$/.test(raw),
+            numericValue: /^(0|[1-9]\d*)$/.test(raw) ? Number(raw) : null,
+        }));
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        prerelease,
+    };
+}
+export function compareSemver(left, right) {
+    const leftParsed = parseSemver(left);
+    const rightParsed = parseSemver(right);
+    if (leftParsed === null || rightParsed === null) {
+        return null;
+    }
+    if (leftParsed.major !== rightParsed.major) {
+        return leftParsed.major > rightParsed.major ? 1 : -1;
+    }
+    if (leftParsed.minor !== rightParsed.minor) {
+        return leftParsed.minor > rightParsed.minor ? 1 : -1;
+    }
+    if (leftParsed.patch !== rightParsed.patch) {
+        return leftParsed.patch > rightParsed.patch ? 1 : -1;
+    }
+    if (leftParsed.prerelease.length === 0 && rightParsed.prerelease.length === 0) {
+        return 0;
+    }
+    if (leftParsed.prerelease.length === 0) {
+        return 1;
+    }
+    if (rightParsed.prerelease.length === 0) {
+        return -1;
+    }
+    const maxLength = Math.max(leftParsed.prerelease.length, rightParsed.prerelease.length);
+    for (let index = 0; index < maxLength; index += 1) {
+        const leftIdentifier = leftParsed.prerelease[index];
+        const rightIdentifier = rightParsed.prerelease[index];
+        if (leftIdentifier === undefined) {
+            return -1;
+        }
+        if (rightIdentifier === undefined) {
+            return 1;
+        }
+        if (leftIdentifier.numeric && rightIdentifier.numeric) {
+            if (leftIdentifier.numericValue !== rightIdentifier.numericValue) {
+                return leftIdentifier.numericValue > rightIdentifier.numericValue ? 1 : -1;
+            }
+            continue;
+        }
+        if (leftIdentifier.numeric !== rightIdentifier.numeric) {
+            return leftIdentifier.numeric ? -1 : 1;
+        }
+        if (leftIdentifier.raw !== rightIdentifier.raw) {
+            return leftIdentifier.raw > rightIdentifier.raw ? 1 : -1;
+        }
+    }
+    return 0;
+}

package/dist/wallet/lifecycle.js

@@ -174,7 +174,6 @@ async function normalizeLoadedWalletStateIfNeeded(options) {
             dataDir: options.dataDir,
             chain: "main",
             startHeight: 0,
-            serviceLifetime: "ephemeral",
             walletRootId: state.walletRootId,
         });
         try {
@@ -271,7 +270,6 @@ async function recreateManagedCoreWalletReplica(state, provider, paths, dataDir,
         dataDir,
         chain: "main",
         startHeight: 0,
-        serviceLifetime: "ephemeral",
         walletRootId: state.walletRootId,
         managedWalletPassphrase: state.managedCoreWallet.internalPassphrase,
     });
@@ -804,7 +802,6 @@ async function importDescriptorIntoManagedCoreWallet(state, provider, paths, dat
         dataDir,
         chain: "main",
         startHeight: 0,
-        serviceLifetime: "ephemeral",
         walletRootId: state.walletRootId,
         managedWalletPassphrase: state.managedCoreWallet.internalPassphrase,
     });
@@ -890,7 +887,6 @@ export async function verifyManagedCoreWalletReplica(state, dataDir, dependencie
             dataDir,
             chain: "main",
             startHeight: 0,
-            serviceLifetime: "ephemeral",
             walletRootId: state.walletRootId,
         });
         const rpc = (dependencies.rpcFactory ?? createRpcClient)(node.rpc);
@@ -1260,7 +1256,6 @@ export async function deleteImportedWalletSeed(options) {
                 dataDir: options.dataDir,
                 chain: "main",
                 startHeight: 0,
-                serviceLifetime: "ephemeral",
             });
             const rpc = (options.rpcFactory ?? createRpcClient)(node.rpc);
             const walletName = sanitizeWalletName(seedRecord.walletRootId);
@@ -1423,7 +1418,6 @@ export async function repairWallet(options) {
             dataDir: options.dataDir,
             chain: "main",
             startHeight: 0,
-            serviceLifetime: "ephemeral",
             walletRootId: repairedState.walletRootId,
         });
         const bitcoindRpc = (options.rpcFactory ?? createRpcClient)(bitcoindHandle.rpc);