@cogcoin/client 0.5.5 → 0.5.7

package/dist/cli/types.d.ts

@@ -5,17 +5,17 @@ import { attachOrStartManagedBitcoindService, probeManagedBitcoindService, stopM
 import { openSqliteStore } from "../sqlite/index.js";
 import type { ClientStoreAdapter } from "../types.js";
 import type { WalletRuntimePaths } from "../wallet/runtime.js";
-import type { exportWallet, WalletPrompter, importWallet, initializeWallet, lockWallet, previewResetWallet, repairWallet, resetWallet, restoreWalletFromMnemonic, unlockWallet } from "../wallet/lifecycle.js";
+import type { exportWallet, WalletPrompter, importWallet, initializeWallet, deleteImportedWalletSeed, lockWallet, previewResetWallet, repairWallet, resetWallet, restoreWalletFromMnemonic, showWalletMnemonic, unlockWallet } from "../wallet/lifecycle.js";
 import type { openWalletReadContext } from "../wallet/read/index.js";
 import { loadWalletExplicitLock } from "../wallet/state/explicit-lock.js";
 import { loadUnlockSession } from "../wallet/state/session.js";
-import { loadWalletState } from "../wallet/state/storage.js";
+import { loadRawWalletStateEnvelope, loadWalletState } from "../wallet/state/storage.js";
 import type { WalletSecretProvider } from "../wallet/state/provider.js";
 import type { disableMiningHooks, enableMiningHooks, followMiningLog, inspectMiningControlPlane, readMiningLog, runForegroundMining, setupBuiltInMining, startBackgroundMining, stopBackgroundMining } from "../wallet/mining/index.js";
-import type { anchorDomain, 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";
+import type { anchorDomain, clearPendingAnchor, 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" | "sync" | "status" | "follow" | "bitcoin-start" | "bitcoin-stop" | "bitcoin-status" | "indexer-start" | "indexer-stop" | "indexer-status" | "unlock" | "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" | "hooks-mining-enable" | "hooks-mining-disable" | "hooks-mining-status" | "mine" | "mine-start" | "mine-stop" | "mine-setup" | "mine-status" | "mine-log" | "wallet-export" | "wallet-import" | "wallet-init" | "wallet-restore" | "wallet-lock" | "wallet-unlock" | "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" | "sync" | "status" | "follow" | "bitcoin-start" | "bitcoin-stop" | "bitcoin-status" | "indexer-start" | "indexer-stop" | "indexer-status" | "unlock" | "anchor" | "anchor-clear" | "domain-anchor" | "domain-anchor-clear" | "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" | "hooks-mining-enable" | "hooks-mining-disable" | "hooks-mining-status" | "mine" | "mine-start" | "mine-stop" | "mine-setup" | "mine-status" | "mine-log" | "wallet-export" | "wallet-import" | "wallet-init" | "wallet-delete" | "wallet-restore" | "wallet-show-mnemonic" | "wallet-lock" | "wallet-unlock" | "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;
@@ -36,6 +36,7 @@ export interface ParsedCliArgs {
     dbPath: string | null;
     dataDir: string | null;
     progressOutput: ProgressOutput;
+    seedName: string | null;
     unlockFor: string | null;
     assumeYes: boolean;
     forceRace: boolean;
@@ -93,7 +94,12 @@ export interface CliRunnerContext {
         store: ClientStoreAdapter;
         databasePath?: string;
         dataDir?: string;
+        walletRootId?: string;
         progressOutput?: ProgressOutput;
+        confirmGetblockArchiveRestart?: (options: {
+            currentArchiveEndHeight: number | null;
+            nextArchiveEndHeight: number;
+        }) => Promise<boolean>;
     }) => Promise<ManagedClientLike>;
     attachManagedBitcoindService?: typeof attachOrStartManagedBitcoindService;
     probeManagedBitcoindService?: typeof probeManagedBitcoindService;
@@ -106,6 +112,7 @@ export interface CliRunnerContext {
     inspectPassiveClientStatus?: typeof inspectPassiveClientStatus;
     openWalletReadContext?: typeof openWalletReadContext;
     loadWalletState?: typeof loadWalletState;
+    loadRawWalletStateEnvelope?: typeof loadRawWalletStateEnvelope;
     loadUnlockSession?: typeof loadUnlockSession;
     loadWalletExplicitLock?: typeof loadWalletExplicitLock;
     initializeWallet?: typeof initializeWallet;
@@ -113,10 +120,13 @@ export interface CliRunnerContext {
     previewResetWallet?: typeof previewResetWallet;
     exportWallet?: typeof exportWallet;
     importWallet?: typeof importWallet;
+    deleteImportedWalletSeed?: typeof deleteImportedWalletSeed;
+    showWalletMnemonic?: typeof showWalletMnemonic;
     unlockWallet?: typeof unlockWallet;
     lockWallet?: typeof lockWallet;
     registerDomain?: typeof registerDomain;
     anchorDomain?: typeof anchorDomain;
+    clearPendingAnchor?: typeof clearPendingAnchor;
     transferDomain?: typeof transferDomain;
     sellDomain?: typeof sellDomain;
     buyDomain?: typeof buyDomain;
@@ -153,7 +163,7 @@ export interface CliRunnerContext {
     readPackageVersion?: () => Promise<string>;
     resolveDefaultBitcoindDataDir?: () => string;
     resolveDefaultClientDatabasePath?: () => string;
-    resolveWalletRuntimePaths?: () => WalletRuntimePaths;
+    resolveWalletRuntimePaths?: (seedName?: string | null) => WalletRuntimePaths;
 }
 export interface StopSignalWatcher {
     cleanup(): void;

package/dist/cli/types.js

@@ -5,4 +5,4 @@ import { attachOrStartManagedBitcoindService, probeManagedBitcoindService, stopM
 import { openSqliteStore } from "../sqlite/index.js";
 import { loadWalletExplicitLock } from "../wallet/state/explicit-lock.js";
 import { loadUnlockSession } from "../wallet/state/session.js";
-import { loadWalletState } from "../wallet/state/storage.js";
+import { loadRawWalletStateEnvelope, loadWalletState } from "../wallet/state/storage.js";

package/dist/cli/wallet-format.js

@@ -104,6 +104,12 @@ export function getRepairRecommendation(context) {
     return null;
 }
 export function getMutationRecommendation(context) {
+    const clearableAnchorFamily = (context.localState.state?.proactiveFamilies ?? []).find((family) => family.type === "anchor"
+        && family.status === "draft"
+        && family.currentStep === "reserved");
+    if (clearableAnchorFamily?.domainName != null) {
+        return `Run \`cogcoin anchor clear ${clearableAnchorFamily.domainName}\` to cancel the local pending anchor reservation, or rerun \`cogcoin anchor ${clearableAnchorFamily.domainName}\` to continue anchoring.`;
+    }
     const unresolvedFamily = (context.localState.state?.proactiveFamilies ?? []).find((family) => (family.type === "anchor" || family.type === "field")
         && (family.status === "broadcast-unknown" || family.status === "repair-required"));
     if (unresolvedFamily !== undefined) {
@@ -329,24 +335,144 @@ function appendWalletAvailability(lines, context) {
         lines.push(`Mutation note: ${mutationRecommendation}`);
     }
 }
-export function formatWalletOverviewReport(context) {
+function overviewEntry(text, ok) {
+    return { text, ok };
+}
+function formatOverviewSection(header, entries) {
+    return [header, ...entries.map((entry) => `${entry.ok ? "✓" : "✗"} ${entry.text}`)].join("\n");
+}
+function isMiningOverviewOk(mining) {
+    return mining.runtime.bitcoindHealth === "ready"
+        && mining.runtime.nodeHealth === "synced"
+        && mining.runtime.indexerHealth === "synced"
+        && mining.runtime.miningState !== "repair-required"
+        && mining.runtime.miningState !== "paused-stale"
+        && !(mining.runtime.miningState === "paused" && mining.runtime.liveMiningFamilyInMempool === true);
+}
+function buildOverviewPathsSection(context) {
+    return [
+        overviewEntry(`DB path: ${context.databasePath}`, true),
+        overviewEntry(`Bitcoin datadir: ${context.dataDir}`, true),
+    ];
+}
+function buildOverviewWalletSection(context) {
+    const walletRoot = context.model?.walletRootId ?? context.localState.walletRootId ?? context.nodeStatus?.walletRootId ?? "none";
     const lines = [
-        "Cogcoin Status",
-        `DB path: ${context.databasePath}`,
-        `Bitcoin datadir: ${context.dataDir}`,
+        overviewEntry(`State: ${context.localState.availability}`, context.localState.availability === "ready"),
+        overviewEntry(`Root: ${walletRoot}`, walletRoot !== "none"),
+        overviewEntry(`Unlock: ${formatUnlockExpiry(context.localState.unlockUntilUnixMs)}`, context.localState.unlockUntilUnixMs !== null),
     ];
-    appendWalletAvailability(lines, context);
-    appendServiceSummary(lines, context);
-    if (context.model !== null) {
-        lines.push(`Local identities: ${context.model.identities.length}`);
-        lines.push(`Locally related domains: ${context.model.domains.length}`);
-        lines.push(`Read-only identities: ${context.model.readOnlyIdentityCount}`);
+    if (context.localState.message !== null) {
+        lines.push(overviewEntry(`Note: ${context.localState.message}`, false));
     }
-    else {
-        lines.push("Wallet-derived sections: unavailable");
+    const nodeStatus = context.nodeStatus;
+    const replica = nodeStatus?.walletReplica ?? null;
+    if (replica !== null) {
+        lines.push(overviewEntry(`Managed Core wallet: ${replica.proofStatus ?? "not-proven"}`, replica.proofStatus === "ready"));
     }
-    appendPendingMutationSummary(lines, context);
-    return lines.join("\n");
+    if (nodeStatus?.walletReplicaMessage) {
+        lines.push(overviewEntry(`Managed Core note: ${nodeStatus.walletReplicaMessage}`, replica?.proofStatus === "ready"));
+    }
+    return lines;
+}
+function buildOverviewServicesSection(context) {
+    const bitcoindOk = context.bitcoind.health === "ready";
+    const nodeOk = context.nodeHealth === "synced";
+    const indexerOk = context.indexer.health === "synced";
+    const lines = [
+        overviewEntry(`Managed bitcoind: ${formatServiceHealth(context.bitcoind.health)}`, bitcoindOk),
+    ];
+    if (context.bitcoind.message !== null) {
+        lines.push(overviewEntry(`Managed bitcoind note: ${context.bitcoind.message}`, bitcoindOk));
+    }
+    lines.push(overviewEntry(`Bitcoin service: ${formatServiceHealth(context.nodeHealth)}`, nodeOk));
+    if (context.nodeStatus !== null) {
+        lines.push(overviewEntry(`Bitcoin best height: ${formatMaybe(context.nodeStatus.nodeBestHeight)}`, nodeOk));
+        lines.push(overviewEntry(`Bitcoin headers: ${formatMaybe(context.nodeStatus.nodeHeaderHeight)}`, nodeOk));
+    }
+    if (context.nodeMessage !== null) {
+        lines.push(overviewEntry(`Bitcoin note: ${context.nodeMessage}`, nodeOk));
+    }
+    lines.push(overviewEntry(`Indexer service: ${formatServiceHealth(context.indexer.health)}`, indexerOk));
+    lines.push(overviewEntry(`Indexer truth source: ${formatIndexerTruthSource(context.indexer.source)}`, indexerOk));
+    if (context.indexer.daemonInstanceId !== null && context.indexer.daemonInstanceId !== undefined) {
+        lines.push(overviewEntry(`Indexer daemon instance: ${context.indexer.daemonInstanceId}`, indexerOk));
+    }
+    if (context.indexer.snapshotSeq !== null && context.indexer.snapshotSeq !== undefined) {
+        lines.push(overviewEntry(`Indexer snapshot sequence: ${context.indexer.snapshotSeq}`, indexerOk));
+    }
+    if (context.indexer.status?.reorgDepth !== null && context.indexer.status?.reorgDepth !== undefined) {
+        lines.push(overviewEntry(`Indexer reorg depth: ${context.indexer.status.reorgDepth}`, indexerOk));
+    }
+    lines.push(overviewEntry(`Indexer tip height: ${context.indexer.snapshotTip === null ? "unavailable" : context.indexer.snapshotTip.height}`, indexerOk));
+    if (context.indexer.message !== null) {
+        lines.push(overviewEntry(`Indexer note: ${context.indexer.message}`, indexerOk));
+    }
+    if (context.mining !== undefined) {
+        const miningOk = isMiningOverviewOk(context.mining);
+        lines.push(overviewEntry(`Mining: ${formatMiningSummaryLine(context.mining)}`, miningOk));
+        if (context.mining.runtime.note !== null) {
+            lines.push(overviewEntry(`Mining note: ${context.mining.runtime.note}`, miningOk));
+        }
+    }
+    return lines;
+}
+function buildOverviewLocalInventorySection(context) {
+    if (context.model === null) {
+        return [overviewEntry("Status: Wallet-derived sections unavailable", false)];
+    }
+    return [
+        overviewEntry(`Local identities: ${context.model.identities.length}`, true),
+        overviewEntry(`Locally related domains: ${context.model.domains.length}`, true),
+        overviewEntry(`Read-only identities: ${context.model.readOnlyIdentityCount}`, true),
+    ];
+}
+function buildOverviewPendingWorkSection(context) {
+    const pendingFamilies = (context.localState.state?.proactiveFamilies ?? [])
+        .filter((family) => (family.type === "anchor" || family.type === "field")
+        && family.status !== "confirmed"
+        && family.status !== "canceled");
+    const pendingMutations = (context.localState.state?.pendingMutations ?? [])
+        .filter((mutation) => mutation.status !== "confirmed" && mutation.status !== "canceled");
+    if (pendingFamilies.length === 0 && pendingMutations.length === 0) {
+        return [overviewEntry("Status: none", true)];
+    }
+    const lines = [];
+    for (const family of pendingFamilies) {
+        const label = family.type === "field"
+            ? `Field family: ${family.domainName ?? "unknown"}.${family.fieldName ?? "unknown"}`
+            : `Anchor family: ${family.domainName ?? "unknown"}`;
+        lines.push(overviewEntry(`${label}  ${family.status}${family.currentStep === null || family.currentStep === undefined ? "" : `  step ${family.currentStep}`}${family.reservedDedicatedIndex == null ? "" : `  index ${family.reservedDedicatedIndex}`}`, false));
+    }
+    for (const mutation of pendingMutations) {
+        lines.push(overviewEntry(`Mutation: ${formatPendingMutationSummaryLabel(mutation)}  ${mutation.status}  sender spk:${mutation.senderScriptPubKeyHex}${mutation.priceCogtoshi === undefined || mutation.priceCogtoshi === null ? "" : `  price ${formatCogAmount(mutation.priceCogtoshi)}`}${mutation.amountCogtoshi === undefined || mutation.amountCogtoshi === null ? "" : `  amount ${formatCogAmount(mutation.amountCogtoshi)}`}${isReputationMutation(mutation) ? "" : mutation.recipientDomainName === undefined || mutation.recipientDomainName === null ? "" : `  domain ${mutation.recipientDomainName}`}${mutation.lockId === undefined || mutation.lockId === null ? "" : `  lock ${mutation.lockId}`}${mutation.recipientScriptPubKeyHex === undefined || mutation.recipientScriptPubKeyHex === null ? "" : `  recipient spk:${mutation.recipientScriptPubKeyHex}`}${mutation.kind === "endpoint" ? (mutation.endpointValueHex === "" ? "  endpoint clear" : `  endpoint-bytes ${(mutation.endpointValueHex?.length ?? 0) / 2}`) : ""}${mutation.kind === "field-create" || mutation.kind === "field-set" ? `  format ${formatFieldFormat(mutation.fieldFormat ?? 0)}` : ""}${mutation.kind === "field-clear" ? "  clear" : ""}${mutation.reviewPayloadHex === undefined || mutation.reviewPayloadHex === null ? "" : "  review"}`, false));
+    }
+    return lines;
+}
+function getOverviewNextStep(context) {
+    const repairRecommendation = getRepairRecommendation(context);
+    if (repairRecommendation !== null) {
+        return repairRecommendation;
+    }
+    if (getBootstrapSyncNextStep(context) !== null) {
+        return "Run `cogcoin sync` to bootstrap assumeutxo and the managed Bitcoin/indexer state.";
+    }
+    return getMutationRecommendation(context);
+}
+export function formatWalletOverviewReport(context) {
+    const parts = [
+        "\n⛭ Cogcoin Status ⛭",
+        formatOverviewSection("Paths", buildOverviewPathsSection(context)),
+        formatOverviewSection("Wallet", buildOverviewWalletSection(context)),
+        formatOverviewSection("Services", buildOverviewServicesSection(context)),
+        formatOverviewSection("Local Inventory", buildOverviewLocalInventorySection(context)),
+        formatOverviewSection("Pending Work", buildOverviewPendingWorkSection(context)),
+    ];
+    const nextStep = getOverviewNextStep(context);
+    if (nextStep !== null) {
+        parts.push(`Next step: ${nextStep}`);
+    }
+    return parts.join("\n\n");
 }
 export function formatDetailedWalletStatusReport(context) {
     const lines = ["Cogcoin Wallet Status"];

package/dist/wallet/lifecycle.d.ts

@@ -12,7 +12,7 @@ export interface WalletPrompter {
     writeLine(message: string): void;
     prompt(message: string): Promise<string>;
     promptHidden?(message: string): Promise<string>;
-    clearSensitiveDisplay?(scope: "mnemonic-reveal"): void | Promise<void>;
+    clearSensitiveDisplay?(scope: "mnemonic-reveal" | "restore-mnemonic-entry"): void | Promise<void>;
 }
 export interface WalletInitializationResult {
     walletRootId: string;
@@ -42,12 +42,18 @@ export interface WalletImportResult {
     state: WalletStateV1;
 }
 export interface WalletRestoreResult {
+    seedName?: string | null;
     walletRootId: string;
     fundingAddress: string;
     unlockUntilUnixMs: number;
     state: WalletStateV1;
     warnings?: string[];
 }
+export interface WalletDeleteResult {
+    seedName: string;
+    walletRootId: string;
+    deleted: boolean;
+}
 export interface WalletRepairResult {
     walletRootId: string;
     recoveredFromBackup: boolean;
@@ -156,6 +162,12 @@ export declare function initializeWallet(options: {
     attachService?: typeof attachOrStartManagedBitcoindService;
     rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletLifecycleRpcClient;
 }): Promise<WalletInitializationResult>;
+export declare function showWalletMnemonic(options: {
+    provider?: WalletSecretProvider;
+    prompter: WalletPrompter;
+    nowUnixMs?: number;
+    paths?: WalletRuntimePaths;
+}): Promise<void>;
 export declare function unlockWallet(options?: {
     provider?: WalletSecretProvider;
     nowUnixMs?: number;
@@ -208,6 +220,14 @@ export declare function restoreWalletFromMnemonic(options: {
     attachService?: typeof attachOrStartManagedBitcoindService;
     rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletLifecycleRpcClient;
 }): Promise<WalletRestoreResult>;
+export declare function deleteImportedWalletSeed(options: {
+    dataDir: string;
+    provider?: WalletSecretProvider;
+    prompter: WalletPrompter;
+    assumeYes?: boolean;
+    nowUnixMs?: number;
+    paths?: WalletRuntimePaths;
+}): Promise<WalletDeleteResult>;
 export declare function repairWallet(options: {
     dataDir: string;
     databasePath: string;