@cogcoin/client 0.5.15 → 1.0.1

package/dist/cli/read-json.js

@@ -1,6 +1,7 @@
+import { getBalance } from "@cogcoin/indexer/queries";
 import { findDomainField, findWalletDomain, listDomainFields, listWalletLocks, } from "../wallet/read/index.js";
 import { getAddressNextSteps, getBootstrapSyncNextStep, getFundingQuickstartGuidance, getIdsNextSteps, getLocksNextSteps, } from "./workflow-hints.js";
-import { getMutationRecommendation, getRepairRecommendation } from "./wallet-format.js";
+import { getClientUnlockRecommendation, getMutationRecommendation, getRepairRecommendation, } from "./wallet-format.js";
 function decimalOrNull(value) {
     return value === null || value === undefined ? null : value.toString();
 }
@@ -30,7 +31,13 @@ function createBaseMessages(context) {
     if (repairRecommendation !== null) {
         nextSteps.push(repairRecommendation);
     }
-    if (repairRecommendation === null) {
+    const clientUnlockRecommendation = repairRecommendation === null
+        ? getClientUnlockRecommendation(context)
+        : null;
+    if (clientUnlockRecommendation !== null) {
+        nextSteps.push(clientUnlockRecommendation);
+    }
+    if (repairRecommendation === null && clientUnlockRecommendation === null) {
         const bootstrapSync = getBootstrapSyncNextStep(context);
         if (bootstrapSync !== null) {
             nextSteps.push(bootstrapSync);
@@ -135,14 +142,6 @@ export function buildAvailability(context) {
         },
     };
     if (context.mining !== undefined) {
-        availability.hooks = {
-            available: context.mining.hook.mode !== "unavailable",
-            stale: context.mining.hook.operatorValidationState === "stale",
-            reason: context.mining.hook.validationError ?? context.mining.hook.trustMessage,
-            state: context.mining.hook.validationState,
-            operatorValidationState: context.mining.hook.operatorValidationState,
-            cooldownActive: context.mining.hook.cooldownActive,
-        };
         availability.backgroundWorker = {
             available: context.mining.runtime.backgroundWorkerPid !== null,
             stale: context.mining.runtime.backgroundWorkerHealth === "stale-heartbeat"
@@ -154,21 +153,24 @@ export function buildAvailability(context) {
     }
     return availability;
 }
-function mapIdentity(identity) {
+function walletCogBalance(context) {
+    if (context.snapshot === null || context.model === null) {
+        return null;
+    }
+    return getBalance(context.snapshot.state, new Uint8Array(Buffer.from(context.model.walletScriptPubKeyHex, "hex")));
+}
+function mapWalletAddress(context) {
+    const localDomains = context.model === null
+        ? []
+        : context.model.domains
+            .filter((domain) => domain.localRelationship === "local")
+            .map((domain) => domain.name)
+            .sort((left, right) => left.localeCompare(right));
     return {
-        index: identity.index,
-        scriptPubKeyHex: identity.scriptPubKeyHex,
-        address: identity.address,
-        selectors: identity.selectors,
-        assignedDomainNames: identity.assignedDomainNames,
-        ownedDomainNames: identity.ownedDomainNames,
-        anchoredOwnedDomainNames: identity.anchoredOwnedDomainNames,
-        localStatus: identity.localStatus,
-        effectiveStatus: identity.effectiveStatus,
-        canonicalDomainId: identity.canonicalDomainId,
-        canonicalDomainName: identity.canonicalDomainName,
-        observedCogBalance: decimalOrNull(identity.observedCogBalance),
-        readOnly: identity.readOnly,
+        address: context.model?.walletAddress ?? null,
+        scriptPubKeyHex: context.model?.walletScriptPubKeyHex ?? null,
+        localDomains,
+        observedCogBalance: decimalOrNull(walletCogBalance(context)),
     };
 }
 function mapDomain(domain) {
@@ -177,11 +179,9 @@ function mapDomain(domain) {
         domainId: domain.domainId,
         anchored: domain.anchored,
         ownerScriptPubKeyHex: domain.ownerScriptPubKeyHex,
-        ownerLocalIndex: domain.ownerLocalIndex,
         ownerAddress: domain.ownerAddress,
         localRelationship: domain.localRelationship,
         chainStatus: domain.chainStatus,
-        localAnchorIntent: domain.localAnchorIntent,
         foundingMessageText: domain.foundingMessageText,
         endpointText: domain.endpointText,
         delegateScriptPubKeyHex: domain.delegateScriptPubKeyHex,
@@ -270,7 +270,7 @@ function buildMiningStatusData(mining) {
                 domainId: mining.runtime.currentDomainId,
                 name: mining.runtime.currentDomainName,
             },
-        liveMiningFamilyInMempool: mining.runtime.liveMiningFamilyInMempool,
+        livePublishInMempool: mining.runtime.livePublishInMempool,
         publishDecision: mining.runtime.currentPublishDecision,
         fees: {
             currentFeeRateSatVb: mining.runtime.currentFeeRateSatVb,
@@ -288,10 +288,6 @@ function buildMiningStatusData(mining) {
         phase: mining.runtime.currentPhase,
         lastSuspendDetectedAtUnixMs: mining.runtime.lastSuspendDetectedAtUnixMs,
         pauseReason: mining.runtime.pauseReason,
-        hookMode: mining.runtime.hookMode,
-        hookValidationState: mining.runtime.lastValidationState,
-        hookOperatorValidationState: mining.runtime.lastOperatorValidationState,
-        hookCooldownActive: mining.hook.cooldownActive,
         providerState: mining.runtime.providerState,
         tipsAligned: mining.runtime.tipsAligned,
         sameDomainCompetitorSuppressed: mining.runtime.sameDomainCompetitorSuppressed,
@@ -310,7 +306,6 @@ export function buildStatusJson(context) {
             wallet: {
                 availability: context.localState.availability,
                 walletRootId: context.model?.walletRootId ?? context.localState.walletRootId ?? context.nodeStatus?.walletRootId ?? null,
-                unlockUntilUnixMs: context.localState.unlockUntilUnixMs,
                 managedCoreReplicaStatus: context.nodeStatus?.walletReplica?.proofStatus ?? null,
             },
             btc: {
@@ -335,56 +330,45 @@ export function buildStatusJson(context) {
             },
             domains: {
                 relatedCount: context.model?.domains.length ?? null,
-                readOnlyIdentityCount: context.model?.readOnlyIdentityCount ?? null,
+                readOnlyIdentityCount: 0,
                 pendingMutationCount: (context.localState.state?.pendingMutations ?? []).filter((mutation) => mutation.status !== "confirmed" && mutation.status !== "canceled").length ?? null,
-                pendingFamilyCount: context.localState.state?.proactiveFamilies.filter((family) => family.status !== "confirmed" && family.status !== "canceled").length ?? null,
+                pendingFamilyCount: 0,
             },
             mining: context.mining === undefined ? null : buildMiningStatusData(context.mining),
-            hooks: context.mining === undefined
-                ? null
-                : {
-                    mode: context.mining.hook.mode,
-                    validationState: context.mining.hook.validationState,
-                    operatorValidationState: context.mining.hook.operatorValidationState,
-                    trustStatus: context.mining.hook.trustStatus,
-                    providerConfigured: context.mining.provider.configured,
-                    cooldownActive: context.mining.hook.cooldownActive,
-                },
             availability: buildAvailability(context),
         },
     };
 }
 export function buildAddressJson(context) {
     const messages = createBaseMessages(context);
-    const fundingIdentity = context.model?.fundingIdentity ?? null;
     return {
         ...messages,
         explanations: dedupeStrings([
             ...messages.explanations,
-            ...(fundingIdentity?.address == null ? [] : [getFundingQuickstartGuidance()]),
+            ...(context.model?.walletAddress == null ? [] : [getFundingQuickstartGuidance()]),
         ]),
         nextSteps: dedupeStrings([
             ...messages.nextSteps,
-            ...getAddressNextSteps(context, fundingIdentity?.address),
+            ...getAddressNextSteps(context, context.model?.walletAddress ?? null),
         ]),
         data: {
-            address: fundingIdentity?.address ?? null,
-            scriptPubKeyHex: fundingIdentity?.scriptPubKeyHex ?? null,
+            address: context.model?.walletAddress ?? null,
+            scriptPubKeyHex: context.model?.walletScriptPubKeyHex ?? null,
             network: context.localState.state?.network ?? context.nodeStatus?.chain ?? null,
             availability: buildAvailability(context),
         },
     };
 }
-export function buildIdsJson(context, page, identities) {
+export function buildIdsJson(context, page) {
     const messages = createBaseMessages(context);
     return {
         ...messages,
         nextSteps: dedupeStrings([
             ...messages.nextSteps,
-            ...getIdsNextSteps(context.model === null ? null : identities),
+            ...getIdsNextSteps(context.model?.walletAddress ?? null),
         ]),
         data: {
-            identities: context.model === null ? null : identities.map(mapIdentity),
+            addresses: context.model === null ? null : [mapWalletAddress(context)],
             page,
             availability: buildAvailability(context),
         },
@@ -392,73 +376,13 @@ export function buildIdsJson(context, page, identities) {
 }
 export function buildWalletStatusJson(context) {
     const messages = createBaseMessages(context);
-    const fundingIdentity = context.model?.fundingIdentity ?? null;
-    const lockState = context.localState.availability === "ready" && context.localState.unlockUntilUnixMs !== null
-        ? "unlocked"
-        : context.localState.availability;
     return {
         ...messages,
         data: {
-            lockState,
-            unlockUntilUnixMs: context.localState.unlockUntilUnixMs,
-            fundingAddress: fundingIdentity?.address ?? null,
-            fundingScriptPubKeyHex: fundingIdentity?.scriptPubKeyHex ?? null,
-            availability: buildAvailability(context),
-        },
-    };
-}
-export function buildHooksStatusJson(mining) {
-    const warnings = [];
-    const explanations = [];
-    const nextSteps = [];
-    if (mining.hook.operatorValidationState === "failed" || mining.hook.operatorValidationState === "stale") {
-        warnings.push(`Mining hook validation is ${mining.hook.operatorValidationState}.`);
-    }
-    if (mining.hook.cooldownActive) {
-        warnings.push("Mining hook launch is paused during the cooldown window.");
-    }
-    if (mining.hook.validationError !== null) {
-        explanations.push(mining.hook.validationError);
-    }
-    if (mining.hook.trustMessage !== null) {
-        explanations.push(mining.hook.trustMessage);
-    }
-    const launchFingerprintState = mining.hook.currentLaunchFingerprint === null
-        ? "unavailable"
-        : mining.hook.validatedLaunchFingerprint === null
-            ? "not-validated"
-            : mining.hook.currentLaunchFingerprint === mining.hook.validatedLaunchFingerprint
-                ? "matched"
-                : "stale";
-    const fullFingerprintState = mining.hook.currentFullFingerprint === null
-        ? (mining.hook.verifyUsed ? "unavailable" : "not-verified")
-        : mining.hook.validatedFullFingerprint === null
-            ? "not-validated"
-            : mining.hook.currentFullFingerprint === mining.hook.validatedFullFingerprint
-                ? "matched"
-                : "stale";
-    return {
-        warnings: dedupeStrings(warnings),
-        explanations: dedupeStrings(explanations),
-        nextSteps: dedupeStrings(nextSteps),
-        data: {
-            mode: mining.hook.mode,
-            validationState: mining.hook.validationState,
-            operatorValidationState: mining.hook.operatorValidationState,
-            launchFingerprintState,
-            fullFingerprintState,
-            lastValidationAtUnixMs: mining.hook.validatedAtUnixMs,
-            lastValidationError: mining.hook.validationError,
-            trustChecks: {
-                trustStatus: mining.hook.trustStatus,
-                trustMessage: mining.hook.trustMessage,
-                entrypointExists: mining.hook.entrypointExists,
-                packageStatus: mining.hook.packageStatus,
-                packageMessage: mining.hook.packageMessage,
-                cooldownUntilUnixMs: mining.hook.cooldownUntilUnixMs,
-                cooldownActive: mining.hook.cooldownActive,
-                consecutiveFailureCount: mining.hook.consecutiveFailureCount,
-            },
+            availability: context.localState.availability,
+            walletAddress: context.model?.walletAddress ?? null,
+            walletScriptPubKeyHex: context.model?.walletScriptPubKeyHex ?? null,
+            services: buildAvailability(context),
         },
     };
 }
@@ -476,7 +400,7 @@ export function buildMineStatusJson(mining) {
         nextSteps.push("Wait for mining to finish rechecking health after the local runtime resumed.");
     }
     else if (mining.runtime.miningState === "paused-stale" || mining.runtime.miningState === "paused") {
-        nextSteps.push("Wait for the live mempool family to settle, or rerun mining when you want replacements to resume.");
+        nextSteps.push("Wait for the live mining publish to settle, or rerun mining when you want replacements to resume.");
     }
     if (mining.runtime.note !== null) {
         explanations.push(mining.runtime.note);
@@ -491,14 +415,6 @@ export function buildMineStatusJson(mining) {
         data: {
             ...buildMiningStatusData(mining),
             availability: {
-                hooks: {
-                    available: mining.hook.mode !== "unavailable",
-                    stale: mining.hook.operatorValidationState === "stale",
-                    reason: mining.hook.validationError,
-                    state: mining.hook.validationState,
-                    operatorValidationState: mining.hook.operatorValidationState,
-                    cooldownActive: mining.hook.cooldownActive,
-                },
                 bitcoind: {
                     available: mining.runtime.bitcoindHealth === "ready" || mining.runtime.bitcoindHealth === "starting",
                     stale: mining.runtime.bitcoindHealth === "starting",
@@ -558,15 +474,14 @@ export function buildMineLogJson(events, page, rotation) {
 }
 export function buildBalanceJson(context) {
     const messages = createBaseMessages(context);
-    const total = context.model === null || context.snapshot === null
-        ? null
-        : context.model.identities.reduce((sum, identity) => identity.readOnly || identity.observedCogBalance === null ? sum : sum + identity.observedCogBalance, 0n);
+    const total = walletCogBalance(context);
     return {
         ...messages,
         data: {
             assetLabel: "COG",
             totalCogtoshi: decimalOrNull(total),
-            identities: context.model?.identities.map(mapIdentity) ?? null,
+            walletAddress: context.model?.walletAddress ?? null,
+            walletScriptPubKeyHex: context.model?.walletScriptPubKeyHex ?? null,
             pending: (context.localState.state?.pendingMutations ?? [])
                 .filter((mutation) => (mutation.kind === "send" || mutation.kind === "lock" || mutation.kind === "claim")
                 && mutation.status !== "confirmed"
@@ -619,17 +534,6 @@ export function buildShowJson(context, domainName) {
                 : {
                     ...mapDomain(found.domain),
                     pendingMutations: listPendingMutationsForDomain(context, domainName).map(mapPendingMutation),
-                    pendingFamilies: (context.localState.state?.proactiveFamilies ?? [])
-                        .filter((family) => family.domainName === domainName
-                        && family.status !== "confirmed"
-                        && family.status !== "canceled")
-                        .map((family) => ({
-                        type: family.type,
-                        status: family.status,
-                        step: family.currentStep ?? null,
-                        reservedDedicatedIndex: family.reservedDedicatedIndex ?? null,
-                        fieldName: family.fieldName ?? null,
-                    })),
                 },
             availability: buildAvailability(context),
         },

package/dist/cli/runner.js

@@ -3,6 +3,7 @@ import { writeLine } from "./io.js";
 import { classifyCliError, createCommandJsonErrorEnvelope, createErrorEnvelope, formatCliTextError, inferOutputMode, isStructuredOutputMode, writeJsonValue, } from "./output.js";
 import { HELP_TEXT, parseCliArgs } from "./parse.js";
 import { runFollowCommand } from "./commands/follow.js";
+import { runClientAdminCommand } from "./commands/client-admin.js";
 import { runMiningAdminCommand } from "./commands/mining-admin.js";
 import { runMiningReadCommand } from "./commands/mining-read.js";
 import { runMiningRuntimeCommand } from "./commands/mining-runtime.js";
@@ -69,6 +70,11 @@ export async function runCli(argv, contextOverrides = {}) {
         if (parsed.command === "status") {
             return runStatusCommand(parsed, context);
         }
+        if (parsed.command === "client-lock"
+            || parsed.command === "client-unlock"
+            || parsed.command === "client-change-password") {
+            return runClientAdminCommand(parsed, context);
+        }
         if (parsed.command === "bitcoin-start"
             || parsed.command === "bitcoin-stop"
             || parsed.command === "bitcoin-status"
@@ -82,30 +88,21 @@ export async function runCli(argv, contextOverrides = {}) {
             || parsed.command === "mine-stop") {
             return runMiningRuntimeCommand(parsed, context);
         }
-        if (parsed.command === "hooks-mining-enable"
-            || parsed.command === "hooks-mining-disable"
-            || parsed.command === "mine-setup") {
+        if (parsed.command === "mine-setup") {
             return runMiningAdminCommand(parsed, context);
         }
         if (parsed.command === "init"
             || parsed.command === "restore"
             || parsed.command === "reset"
             || parsed.command === "repair"
-            || parsed.command === "unlock"
-            || parsed.command === "wallet-export"
-            || parsed.command === "wallet-import"
             || parsed.command === "wallet-init"
             || parsed.command === "wallet-delete"
             || parsed.command === "wallet-restore"
-            || parsed.command === "wallet-show-mnemonic"
-            || parsed.command === "wallet-unlock"
-            || parsed.command === "wallet-lock") {
+            || parsed.command === "wallet-show-mnemonic") {
             return runWalletAdminCommand(parsed, context);
         }
         if (parsed.command === "anchor"
-            || parsed.command === "anchor-clear"
             || parsed.command === "domain-anchor"
-            || parsed.command === "domain-anchor-clear"
             || parsed.command === "register"
             || parsed.command === "domain-register"
             || parsed.command === "transfer"
@@ -126,6 +123,7 @@ export async function runCli(argv, contextOverrides = {}) {
             || parsed.command === "field-create"
             || parsed.command === "field-set"
             || parsed.command === "field-clear"
+            || parsed.command === "bitcoin-transfer"
             || parsed.command === "send"
             || parsed.command === "claim"
             || parsed.command === "reclaim"
@@ -137,8 +135,7 @@ export async function runCli(argv, contextOverrides = {}) {
             || parsed.command === "rep-revoke") {
             return runWalletMutationCommand(parsed, context);
         }
-        if (parsed.command === "hooks-mining-status"
-            || parsed.command === "mine-status"
+        if (parsed.command === "mine-status"
             || parsed.command === "mine-log") {
             return runMiningReadCommand(parsed, context);
         }

package/dist/cli/sync-progress.d.ts

@@ -0,0 +1,6 @@
+import type { ManagedBitcoindProgressEvent } from "../bitcoind/types.js";
+import type { ParsedCliArgs } from "./types.js";
+export declare function createSyncProgressReporter(options: {
+    progressOutput: ParsedCliArgs["progressOutput"];
+    write: (line: string) => void;
+}): (event: ManagedBitcoindProgressEvent) => void;

package/dist/cli/sync-progress.js

@@ -0,0 +1,91 @@
+import { formatBytes, formatDuration } from "../bitcoind/progress/formatting.js";
+const SYNC_PROGRESS_LOG_INTERVAL_MS = 5_000;
+export function createSyncProgressReporter(options) {
+    let lastPhase = null;
+    let lastMessage = "";
+    let lastDownloadPrintedAt = 0;
+    let lastDownloadBytes = null;
+    let lastImportPrintedAt = 0;
+    let lastImportBlocks = null;
+    const infoEnabled = options.progressOutput !== "none";
+    function shouldPrintEntryMessage(message, phase) {
+        if (message === "Waiting to start managed sync." || message === "Sync complete.") {
+            return false;
+        }
+        if (message.startsWith("Warning:")) {
+            return true;
+        }
+        if (!infoEnabled) {
+            return false;
+        }
+        if (phase === "getblock_archive_download" || phase === "getblock_archive_import") {
+            return true;
+        }
+        return phase === "snapshot_download"
+            || phase === "wait_headers_for_snapshot"
+            || phase === "load_snapshot"
+            || phase === "bitcoin_sync"
+            || phase === "cogcoin_sync"
+            || message.includes("Getblock manifest")
+            || message.startsWith("Fetching Getblock manifest.")
+            || message.startsWith("Refreshing Getblock manifest.")
+            || message.startsWith("Using Getblock range ");
+    }
+    function formatDownloadLine(label, event) {
+        const current = event.progress.downloadedBytes ?? 0;
+        const total = event.progress.totalBytes ?? 0;
+        const percent = event.progress.percent ?? (total > 0 ? (current / total) * 100 : 0);
+        const speed = event.progress.bytesPerSecond === null ? "--" : `${formatBytes(event.progress.bytesPerSecond)}/s`;
+        return `${label}: ${percent.toFixed(2)}% (${formatBytes(current)} / ${formatBytes(total)}, ${speed}, ETA ${formatDuration(event.progress.etaSeconds)})`;
+    }
+    return (event) => {
+        const message = event.progress.message.trim();
+        const phaseChanged = event.phase !== lastPhase;
+        const messageChanged = message !== lastMessage;
+        if ((phaseChanged || messageChanged) && shouldPrintEntryMessage(message, event.phase)) {
+            options.write(message);
+        }
+        if (infoEnabled && event.phase === "getblock_archive_download") {
+            const now = Date.now();
+            const currentBytes = event.progress.downloadedBytes ?? 0;
+            const isComplete = (event.progress.percent ?? 0) >= 100;
+            const shouldPrintMilestone = phaseChanged
+                || lastDownloadBytes !== currentBytes && (isComplete
+                    || now - lastDownloadPrintedAt >= SYNC_PROGRESS_LOG_INTERVAL_MS);
+            if (shouldPrintMilestone) {
+                options.write(formatDownloadLine("Getblock download", event));
+                lastDownloadPrintedAt = now;
+                lastDownloadBytes = currentBytes;
+            }
+        }
+        else if (infoEnabled && event.phase === "snapshot_download") {
+            const now = Date.now();
+            const currentBytes = event.progress.downloadedBytes ?? 0;
+            const isComplete = (event.progress.percent ?? 0) >= 100;
+            const shouldPrintMilestone = phaseChanged
+                || lastDownloadBytes !== currentBytes && (isComplete
+                    || now - lastDownloadPrintedAt >= SYNC_PROGRESS_LOG_INTERVAL_MS);
+            if (shouldPrintMilestone) {
+                options.write(formatDownloadLine("Snapshot download", event));
+                lastDownloadPrintedAt = now;
+                lastDownloadBytes = currentBytes;
+            }
+        }
+        else if (infoEnabled && event.phase === "getblock_archive_import") {
+            const now = Date.now();
+            const currentBlocks = event.progress.blocks ?? 0;
+            const targetBlocks = event.progress.targetHeight ?? currentBlocks;
+            const isComplete = currentBlocks >= targetBlocks;
+            const shouldPrintMilestone = phaseChanged
+                || lastImportBlocks !== currentBlocks && (isComplete
+                    || now - lastImportPrintedAt >= SYNC_PROGRESS_LOG_INTERVAL_MS);
+            if (shouldPrintMilestone) {
+                options.write(`Getblock import: Bitcoin ${currentBlocks.toLocaleString()} / ${targetBlocks.toLocaleString()}`);
+                lastImportPrintedAt = now;
+                lastImportBlocks = currentBlocks;
+            }
+        }
+        lastPhase = event.phase;
+        lastMessage = message;
+    };
+}

package/dist/cli/types.d.ts

@@ -6,17 +6,15 @@ 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, deleteImportedWalletSeed, lockWallet, previewResetWallet, repairWallet, resetWallet, restoreWalletFromMnemonic, showWalletMnemonic, unlockWallet } from "../wallet/lifecycle.js";
+import type { WalletPrompter, initializeWallet, deleteImportedWalletSeed, previewResetWallet, repairWallet, resetWallet, restoreWalletFromMnemonic, showWalletMnemonic } 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 { 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, 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";
+import type { ensureBuiltInMiningSetupIfNeeded, followMiningLog, inspectMiningControlPlane, readMiningLog, runForegroundMining, setupBuiltInMining, startBackgroundMining, stopBackgroundMining } 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" | "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 type CommandName = "init" | "restore" | "reset" | "repair" | "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 interface WritableLike {
     isTTY?: boolean;
     write(chunk: string): void;
@@ -40,6 +38,7 @@ export interface ParsedCliArgs {
     seedName: string | null;
     unlockFor: string | null;
     assumeYes: boolean;
+    force: boolean;
     forceRace: boolean;
     anchorMessage: string | null;
     transferTarget: string | null;
@@ -49,12 +48,12 @@ export interface ParsedCliArgs {
     fieldPermanent: boolean;
     fieldFormat: string | null;
     fieldValue: string | null;
-    fromIdentity: string | null;
     lockRecipientDomain: string | null;
     conditionHex: string | null;
     untilHeight: string | null;
     preimageHex: string | null;
     reviewText: string | null;
+    satvb: number | null;
     locksClaimableOnly: boolean;
     locksReclaimableOnly: boolean;
     domainsAnchoredOnly: boolean;
@@ -62,7 +61,6 @@ export interface ParsedCliArgs {
     domainsMineableOnly: boolean;
     listLimit: number | null;
     listAll: boolean;
-    verify: boolean;
     follow: boolean;
 }
 export interface ManagedClientLike {
@@ -73,6 +71,7 @@ export interface ManagedClientLike {
         bestHeight: number;
     }>;
     playSyncCompletionScene?(): Promise<void>;
+    detachToBackgroundFollow?(): Promise<void>;
     startFollowingTip(): Promise<void>;
     getNodeStatus(): Promise<{
         indexedTip: {
@@ -118,20 +117,14 @@ export interface CliRunnerContext {
     openWalletReadContext?: typeof openWalletReadContext;
     loadWalletState?: typeof loadWalletState;
     loadRawWalletStateEnvelope?: typeof loadRawWalletStateEnvelope;
-    loadUnlockSession?: typeof loadUnlockSession;
-    loadWalletExplicitLock?: typeof loadWalletExplicitLock;
     initializeWallet?: typeof initializeWallet;
     restoreWalletFromMnemonic?: typeof restoreWalletFromMnemonic;
     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;
+    transferBitcoin?: typeof transferBitcoin;
     transferDomain?: typeof transferDomain;
     sellDomain?: typeof sellDomain;
     buyDomain?: typeof buyDomain;
@@ -151,9 +144,8 @@ export interface CliRunnerContext {
     clearField?: typeof clearField;
     giveReputation?: typeof giveReputation;
     revokeReputation?: typeof revokeReputation;
-    enableMiningHooks?: typeof enableMiningHooks;
-    disableMiningHooks?: typeof disableMiningHooks;
     inspectMiningControlPlane?: typeof inspectMiningControlPlane;
+    ensureBuiltInMiningSetupIfNeeded?: typeof ensureBuiltInMiningSetupIfNeeded;
     runForegroundMining?: typeof runForegroundMining;
     startBackgroundMining?: typeof startBackgroundMining;
     stopBackgroundMining?: typeof stopBackgroundMining;

package/dist/cli/types.js

@@ -3,6 +3,4 @@ import { createRpcClient } from "../bitcoind/node.js";
 import { attachOrStartIndexerDaemon, probeIndexerDaemon, readObservedIndexerDaemonStatus, stopIndexerDaemonService, } from "../bitcoind/indexer-daemon.js";
 import { attachOrStartManagedBitcoindService, probeManagedBitcoindService, stopManagedBitcoindService, } from "../bitcoind/service.js";
 import { openSqliteStore } from "../sqlite/index.js";
-import { loadWalletExplicitLock } from "../wallet/state/explicit-lock.js";
-import { loadUnlockSession } from "../wallet/state/session.js";
 import { loadRawWalletStateEnvelope, loadWalletState } from "../wallet/state/storage.js";

package/dist/cli/wallet-format.d.ts

@@ -1,5 +1,6 @@
 import type { WalletDomainView, WalletReadContext } from "../wallet/read/index.js";
 export declare function getRepairRecommendation(context: WalletReadContext): string | null;
+export declare function getClientUnlockRecommendation(context: WalletReadContext): string | null;
 export declare function getMutationRecommendation(context: WalletReadContext): string | null;
 export declare function formatWalletOverviewReport(context: WalletReadContext, version: string): string;
 export declare function formatDetailedWalletStatusReport(context: WalletReadContext): string;