@cogcoin/client 0.5.5 → 0.5.7

package/dist/cli/commands/wallet-admin.js

@@ -1,5 +1,5 @@
 import { parseUnlockDurationToMs } from "../../wallet/lifecycle.js";
-import { buildInitMutationData, buildResetMutationData, buildRestoreMutationData, buildUnlockMutationData, buildRepairMutationData, buildWalletExportMutationData, buildWalletImportMutationData, buildWalletLockMutationData, } from "../mutation-json.js";
+import { buildInitMutationData, buildResetMutationData, buildRestoreMutationData, buildWalletDeleteMutationData, buildUnlockMutationData, buildRepairMutationData, buildWalletExportMutationData, buildWalletImportMutationData, buildWalletLockMutationData, } from "../mutation-json.js";
 import { buildResetPreviewData, buildRepairPreviewData, buildWalletLockPreviewData, } from "../preview-json.js";
 import { writeLine } from "../io.js";
 import { createTerminalPrompter } from "../prompt.js";
@@ -21,8 +21,68 @@ function getResetWarnings(result) {
         ? ["Some existing Cogcoin secret-provider entries could not be discovered from the remaining local wallet artifacts and may need manual cleanup."]
         : [];
 }
+function getResetNextSteps(result) {
+    return result.walletAction === "deleted" || result.walletAction === "not-present"
+        ? ["Run `cogcoin init` to create a new wallet."]
+        : ["Run `cogcoin sync` to bootstrap assumeutxo and the managed Bitcoin/indexer state."];
+}
+function formatResetBitcoinDataDirStatus(result) {
+    if (result.bitcoinDataDir.status === "outside-reset-scope") {
+        return "preserved (outside reset scope)";
+    }
+    return result.bitcoinDataDir.status;
+}
+function resetTextEntry(label, value, ok) {
+    return {
+        text: `${label}: ${value}`,
+        ok,
+    };
+}
+function formatResetSection(header, entries) {
+    return [header, ...entries.map((entry) => `${entry.ok ? "✓" : "✗"} ${entry.text}`)].join("\n");
+}
+function formatResetResultText(result) {
+    const warnings = getResetWarnings(result);
+    const nextStep = getResetNextSteps(result)[0] ?? null;
+    const secretCleanupOk = result.secretCleanupStatus !== "unknown" && result.secretCleanupStatus !== "failed";
+    const managedCleanupOk = result.stoppedProcesses.survivors === 0;
+    const outcomeEntries = [
+        resetTextEntry("Wallet action", result.walletAction, true),
+        resetTextEntry("Snapshot", result.bootstrapSnapshot.status, true),
+        resetTextEntry("Bitcoin datadir", formatResetBitcoinDataDirStatus(result), true),
+        resetTextEntry("Secret cleanup", result.secretCleanupStatus, secretCleanupOk),
+    ];
+    if (result.walletAction !== "retain-mnemonic" && result.walletOldRootId !== null) {
+        outcomeEntries.push(resetTextEntry("Previous wallet root", result.walletOldRootId, true));
+    }
+    if (result.walletAction !== "retain-mnemonic" && result.walletNewRootId !== null) {
+        outcomeEntries.push(resetTextEntry("New wallet root", result.walletNewRootId, true));
+    }
+    const sections = [
+        formatResetSection("Paths", [
+            resetTextEntry("Data root", result.dataRoot, true),
+        ]),
+        formatResetSection("Reset Outcome", outcomeEntries),
+        formatResetSection("Managed Cleanup", [
+            resetTextEntry("Managed bitcoind processes stopped", String(result.stoppedProcesses.managedBitcoind), managedCleanupOk),
+            resetTextEntry("Indexer daemons stopped", String(result.stoppedProcesses.indexerDaemon), managedCleanupOk),
+            resetTextEntry("Background miners stopped", String(result.stoppedProcesses.backgroundMining), managedCleanupOk),
+        ]),
+    ];
+    if (warnings.length > 0) {
+        sections.push(formatResetSection("Warnings", warnings.map((warning) => resetTextEntry("Warning", warning, false))));
+    }
+    const parts = [
+        "\n⛭ Cogcoin Reset ⛭",
+        ...sections,
+    ];
+    if (nextStep !== null) {
+        parts.push(`Next step: ${nextStep}`);
+    }
+    return parts.join("\n\n");
+}
 export async function runWalletAdminCommand(parsed, context) {
-    const runtimePaths = context.resolveWalletRuntimePaths();
+    const runtimePaths = context.resolveWalletRuntimePaths(parsed.seedName);
     const stopWatcher = createOwnedLockCleanupSignalWatcher(context.signalSource, context.forceExit, [
         runtimePaths.walletControlLockPath,
         runtimePaths.miningControlLockPath,
@@ -31,14 +91,15 @@ export async function runWalletAdminCommand(parsed, context) {
     ]);
     try {
         const outcome = await waitForCompletionOrStop((async () => {
-            const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
             const provider = context.walletSecretProvider;
             if (parsed.command === "init" || parsed.command === "wallet-init") {
+                const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
                 const prompter = createCommandPrompter(parsed, context);
                 const result = await context.initializeWallet({
                     dataDir,
                     provider,
                     prompter,
+                    paths: runtimePaths,
                 });
                 const nextSteps = getInitNextSteps();
                 if (parsed.outputMode === "json") {
@@ -59,11 +120,13 @@ export async function runWalletAdminCommand(parsed, context) {
                 return 0;
             }
             if (parsed.command === "restore" || parsed.command === "wallet-restore") {
+                const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
                 const prompter = createCommandPrompter(parsed, context);
                 const result = await context.restoreWalletFromMnemonic({
                     dataDir,
                     provider,
                     prompter,
+                    paths: runtimePaths,
                 });
                 const nextSteps = getRestoreNextSteps();
                 const explanations = ["Managed Bitcoin/indexer bootstrap is deferred until you run `cogcoin sync`."];
@@ -75,7 +138,7 @@ export async function runWalletAdminCommand(parsed, context) {
                     }));
                     return 0;
                 }
-                writeLine(context.stdout, "Wallet restored from mnemonic.");
+                writeLine(context.stdout, `Wallet seed "${result.seedName}" restored from mnemonic.`);
                 writeLine(context.stdout, `Wallet root: ${result.walletRootId}`);
                 writeLine(context.stdout, `Funding address: ${result.fundingAddress}`);
                 writeLine(context.stdout, `Unlocked until: ${new Date(result.unlockUntilUnixMs).toISOString()}`);
@@ -88,12 +151,40 @@ export async function runWalletAdminCommand(parsed, context) {
                 }
                 return 0;
             }
+            if (parsed.command === "wallet-delete") {
+                const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
+                const prompter = createCommandPrompter(parsed, context);
+                const result = await context.deleteImportedWalletSeed({
+                    dataDir,
+                    provider,
+                    prompter,
+                    assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
+                });
+                if (parsed.outputMode === "json") {
+                    writeJsonValue(context.stdout, createMutationSuccessEnvelope(resolveStableMutationJsonSchema(parsed), describeCanonicalCommand(parsed), "deleted", buildWalletDeleteMutationData(result)));
+                    return 0;
+                }
+                writeLine(context.stdout, `Imported wallet seed "${result.seedName}" deleted.`);
+                writeLine(context.stdout, `Wallet root: ${result.walletRootId}`);
+                return 0;
+            }
+            if (parsed.command === "wallet-show-mnemonic") {
+                const prompter = createCommandPrompter(parsed, context);
+                await context.showWalletMnemonic({
+                    provider,
+                    prompter,
+                    paths: runtimePaths,
+                });
+                return 0;
+            }
             const dbPath = parsed.dbPath ?? context.resolveDefaultClientDatabasePath();
             if (parsed.command === "unlock" || parsed.command === "wallet-unlock") {
                 const durationMs = parseUnlockDurationToMs(parsed.unlockFor);
                 const result = await context.unlockWallet({
                     provider,
                     unlockDurationMs: durationMs,
+                    paths: runtimePaths,
                 });
                 if (parsed.outputMode === "json") {
                     writeJsonValue(context.stdout, createMutationSuccessEnvelope(resolveStableMutationJsonSchema(parsed), describeCanonicalCommand(parsed), "unlocked", buildUnlockMutationData(result)));
@@ -105,6 +196,7 @@ export async function runWalletAdminCommand(parsed, context) {
                 return 0;
             }
             if (parsed.command === "reset") {
+                const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
                 if (parsed.outputMode === "preview-json") {
                     const preview = await context.previewResetWallet({
                         dataDir,
@@ -122,32 +214,15 @@ export async function runWalletAdminCommand(parsed, context) {
                 if (parsed.outputMode === "json") {
                     writeJsonValue(context.stdout, createMutationSuccessEnvelope(resolveStableMutationJsonSchema(parsed), describeCanonicalCommand(parsed), "completed", buildResetMutationData(result), {
                         warnings: getResetWarnings(result),
-                        nextSteps: result.walletAction === "deleted" || result.walletAction === "not-present"
-                            ? ["Run `cogcoin init` to create a new wallet."]
-                            : ["Run `cogcoin status` to inspect the reset local state."],
+                        nextSteps: getResetNextSteps(result),
                     }));
                     return 0;
                 }
-                writeLine(context.stdout, "Cogcoin reset completed.");
-                writeLine(context.stdout, `Data root: ${result.dataRoot}`);
-                writeLine(context.stdout, `Wallet action: ${result.walletAction}`);
-                writeLine(context.stdout, `Snapshot: ${result.bootstrapSnapshot.status}`);
-                writeLine(context.stdout, `Secret cleanup: ${result.secretCleanupStatus}`);
-                writeLine(context.stdout, `Managed bitcoind processes stopped: ${result.stoppedProcesses.managedBitcoind}`);
-                writeLine(context.stdout, `Indexer daemons stopped: ${result.stoppedProcesses.indexerDaemon}`);
-                writeLine(context.stdout, `Background miners stopped: ${result.stoppedProcesses.backgroundMining}`);
-                if (result.walletOldRootId !== null) {
-                    writeLine(context.stdout, `Previous wallet root: ${result.walletOldRootId}`);
-                }
-                if (result.walletNewRootId !== null) {
-                    writeLine(context.stdout, `New wallet root: ${result.walletNewRootId}`);
-                }
-                for (const warning of getResetWarnings(result)) {
-                    writeLine(context.stdout, `Warning: ${warning}`);
-                }
+                writeLine(context.stdout, formatResetResultText(result));
                 return 0;
             }
             if (parsed.command === "wallet-export") {
+                const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
                 const prompter = createCommandPrompter(parsed, context);
                 const result = await context.exportWallet({
                     archivePath: parsed.args[0],
@@ -155,6 +230,7 @@ export async function runWalletAdminCommand(parsed, context) {
                     databasePath: dbPath,
                     provider,
                     prompter,
+                    paths: runtimePaths,
                 });
                 if (parsed.outputMode === "json") {
                     writeJsonValue(context.stdout, createMutationSuccessEnvelope(resolveStableMutationJsonSchema(parsed), describeCanonicalCommand(parsed), "exported", buildWalletExportMutationData(result)));
@@ -166,6 +242,7 @@ export async function runWalletAdminCommand(parsed, context) {
                 return 0;
             }
             if (parsed.command === "wallet-import") {
+                const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
                 const prompter = createCommandPrompter(parsed, context);
                 const result = await context.importWallet({
                     archivePath: parsed.args[0],
@@ -173,6 +250,7 @@ export async function runWalletAdminCommand(parsed, context) {
                     databasePath: dbPath,
                     provider,
                     prompter,
+                    paths: runtimePaths,
                 });
                 if (parsed.outputMode === "json") {
                     writeJsonValue(context.stdout, createMutationSuccessEnvelope(resolveStableMutationJsonSchema(parsed), describeCanonicalCommand(parsed), "imported", buildWalletImportMutationData(result)));
@@ -185,9 +263,11 @@ export async function runWalletAdminCommand(parsed, context) {
                 return 0;
             }
             if (parsed.command === "wallet-lock") {
+                const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
                 const result = await context.lockWallet({
                     dataDir,
                     provider,
+                    paths: runtimePaths,
                 });
                 if (parsed.outputMode === "preview-json") {
                     writeJsonValue(context.stdout, createPreviewSuccessEnvelope(resolvePreviewJsonSchema(parsed), describeCanonicalCommand(parsed), "locked", buildWalletLockPreviewData(result)));
@@ -202,11 +282,13 @@ export async function runWalletAdminCommand(parsed, context) {
                 return 0;
             }
             if (parsed.command === "repair") {
+                const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
                 const result = await context.repairWallet({
                     dataDir,
                     databasePath: dbPath,
                     provider,
                     assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
                 });
                 if (parsed.outputMode === "preview-json") {
                     writeJsonValue(context.stdout, createPreviewSuccessEnvelope(resolvePreviewJsonSchema(parsed), describeCanonicalCommand(parsed), "completed", buildRepairPreviewData(result), {

package/dist/cli/commands/wallet-mutation.js

@@ -1,7 +1,7 @@
 import { parseCogAmountToCogtoshi, } from "../../wallet/tx/index.js";
-import { buildAnchorMutationData, buildCogMutationData, buildDomainAdminMutationData, buildDomainMarketMutationData, buildFieldMutationData, buildRegisterMutationData, buildReputationMutationData, } from "../mutation-json.js";
-import { buildAnchorPreviewData, buildCogPreviewData, buildDomainAdminPreviewData, buildDomainMarketPreviewData, buildFieldPreviewData, buildRegisterPreviewData, buildReputationPreviewData, } from "../preview-json.js";
-import { isAnchorMutationCommand, isBuyMutationCommand, isClaimMutationCommand, isReclaimMutationCommand, isRegisterMutationCommand, isReputationMutationCommand, isSellOrUnsellMutationCommand, isSendMutationCommand, isTransferMutationCommand, isUnsellMutationCommand, isWalletMutationCommand, } from "../mutation-command-groups.js";
+import { buildAnchorMutationData, buildAnchorClearMutationData, buildCogMutationData, buildDomainAdminMutationData, buildDomainMarketMutationData, buildFieldMutationData, buildRegisterMutationData, buildReputationMutationData, } from "../mutation-json.js";
+import { buildAnchorPreviewData, buildAnchorClearPreviewData, buildCogPreviewData, buildDomainAdminPreviewData, buildDomainMarketPreviewData, buildFieldPreviewData, buildRegisterPreviewData, buildReputationPreviewData, } from "../preview-json.js";
+import { isAnchorClearMutationCommand, isAnchorMutationCommand, isBuyMutationCommand, isClaimMutationCommand, isReclaimMutationCommand, isRegisterMutationCommand, isReputationMutationCommand, isSellOrUnsellMutationCommand, isSendMutationCommand, isTransferMutationCommand, isUnsellMutationCommand, isWalletMutationCommand, } from "../mutation-command-groups.js";
 import { commandMutationNextSteps, workflowMutationNextSteps, writeMutationCommandSuccess, } from "../mutation-success.js";
 import { writeLine } from "../io.js";
 import { formatBuyBuyerSummary, formatBuySellerSummary, formatBuySettlementSummary, formatCogClaimPath, formatCogSenderSummary, formatDomainAdminEffect, formatDomainAdminPayloadSummary, formatDomainAdminSenderSummary, formatDomainAdminTargetSummary, formatDomainMarketEconomicEffect, formatDomainMarketRecipientSummary, formatDomainMarketSenderSummary, formatFieldEffect, formatFieldPath, formatFieldSenderSummary, formatFieldValueSummary, formatRegisterEconomicEffect, formatRegisterSenderSummary, formatReputationEffect, formatReputationReviewSummary, formatReputationSenderSummary, } from "../mutation-text-format.js";
@@ -31,7 +31,7 @@ function createCommandPrompter(parsed, context) {
         : context.createPrompter();
 }
 export async function runWalletMutationCommand(parsed, context) {
-    const runtimePaths = context.resolveWalletRuntimePaths();
+    const runtimePaths = context.resolveWalletRuntimePaths(parsed.seedName);
     const stopWatcher = createOwnedLockCleanupSignalWatcher(context.signalSource, context.forceExit, [
         runtimePaths.walletControlLockPath,
         runtimePaths.miningControlLockPath,
@@ -47,6 +47,38 @@ export async function runWalletMutationCommand(parsed, context) {
             const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
             const dbPath = parsed.dbPath ?? context.resolveDefaultClientDatabasePath();
             const prompter = createCommandPrompter(parsed, context);
+            if (isAnchorClearMutationCommand(parsed.command)) {
+                const result = await context.clearPendingAnchor({
+                    domainName: parsed.args[0],
+                    dataDir,
+                    databasePath: dbPath,
+                    provider: context.walletSecretProvider,
+                    prompter,
+                    assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
+                });
+                const nextSteps = result.cleared
+                    ? workflowMutationNextSteps([`cogcoin show ${result.domainName}`, `cogcoin anchor ${result.domainName}`])
+                    : commandMutationNextSteps(`cogcoin show ${result.domainName}`);
+                return writeMutationCommandSuccess(parsed, context, {
+                    data: buildAnchorClearMutationData(result),
+                    previewData: buildAnchorClearPreviewData(result),
+                    reusedExisting: false,
+                    reusedMessage: "",
+                    outcome: result.cleared ? "cleared" : "noop",
+                    nextSteps,
+                    text: {
+                        heading: result.cleared ? "Pending anchor cleared." : "No pending anchor to clear.",
+                        fields: [
+                            { label: "Domain", value: result.domainName },
+                            { label: "Cleared", value: result.cleared ? "yes" : "no" },
+                            { label: "Previous status", value: result.previousFamilyStatus ?? "", when: result.previousFamilyStatus !== null },
+                            { label: "Previous step", value: result.previousFamilyStep ?? "", when: result.previousFamilyStep !== null },
+                            { label: "Released dedicated index", value: String(result.releasedDedicatedIndex), when: result.releasedDedicatedIndex !== null },
+                        ],
+                    },
+                });
+            }
             if (isAnchorMutationCommand(parsed.command)) {
                 const result = await context.anchorDomain({
                     domainName: parsed.args[0],
@@ -55,6 +87,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     databasePath: dbPath,
                     provider: context.walletSecretProvider,
                     prompter,
+                    paths: runtimePaths,
                 });
                 const nextSteps = getAnchorNextSteps(result.domainName);
                 return writeMutationCommandSuccess(parsed, context, {
@@ -89,6 +122,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     provider: context.walletSecretProvider,
                     prompter,
                     assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
                 });
                 const nextSteps = getRegisterNextSteps(result.domainName, result.registerKind);
                 return writeMutationCommandSuccess(parsed, context, {
@@ -126,6 +160,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     provider: context.walletSecretProvider,
                     prompter,
                     assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
                 });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildDomainMarketMutationData(result, {
@@ -162,6 +197,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     provider: context.walletSecretProvider,
                     prompter,
                     assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
                 });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildDomainMarketMutationData(result, {
@@ -200,6 +236,7 @@ export async function runWalletMutationCommand(parsed, context) {
                         provider: context.walletSecretProvider,
                         prompter,
                         assumeYes: parsed.assumeYes,
+                        paths: runtimePaths,
                     })
                     : await context.clearDomainEndpoint({
                         domainName: parsed.args[0],
@@ -208,6 +245,7 @@ export async function runWalletMutationCommand(parsed, context) {
                         provider: context.walletSecretProvider,
                         prompter,
                         assumeYes: parsed.assumeYes,
+                        paths: runtimePaths,
                     });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildDomainAdminMutationData(result, {
@@ -242,6 +280,7 @@ export async function runWalletMutationCommand(parsed, context) {
                         provider: context.walletSecretProvider,
                         prompter,
                         assumeYes: parsed.assumeYes,
+                        paths: runtimePaths,
                     })
                     : await context.clearDomainDelegate({
                         domainName: parsed.args[0],
@@ -250,6 +289,7 @@ export async function runWalletMutationCommand(parsed, context) {
                         provider: context.walletSecretProvider,
                         prompter,
                         assumeYes: parsed.assumeYes,
+                        paths: runtimePaths,
                     });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildDomainAdminMutationData(result, {
@@ -284,6 +324,7 @@ export async function runWalletMutationCommand(parsed, context) {
                         provider: context.walletSecretProvider,
                         prompter,
                         assumeYes: parsed.assumeYes,
+                        paths: runtimePaths,
                     })
                     : await context.clearDomainMiner({
                         domainName: parsed.args[0],
@@ -292,6 +333,7 @@ export async function runWalletMutationCommand(parsed, context) {
                         provider: context.walletSecretProvider,
                         prompter,
                         assumeYes: parsed.assumeYes,
+                        paths: runtimePaths,
                     });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildDomainAdminMutationData(result, {
@@ -324,6 +366,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     provider: context.walletSecretProvider,
                     prompter,
                     assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
                 });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildDomainAdminMutationData(result, {
@@ -363,6 +406,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     provider: context.walletSecretProvider,
                     prompter,
                     assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
                 });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildFieldMutationData(result),
@@ -399,6 +443,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     provider: context.walletSecretProvider,
                     prompter,
                     assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
                 });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildFieldMutationData(result),
@@ -429,6 +474,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     provider: context.walletSecretProvider,
                     prompter,
                     assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
                 });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildFieldMutationData(result),
@@ -459,6 +505,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     provider: context.walletSecretProvider,
                     prompter,
                     assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
                 });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildCogMutationData(result, {
@@ -497,6 +544,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     provider: context.walletSecretProvider,
                     prompter,
                     assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
                 });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildCogMutationData(result, {
@@ -536,6 +584,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     databasePath: dbPath,
                     provider: context.walletSecretProvider,
                     prompter,
+                    paths: runtimePaths,
                 });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildCogMutationData(result, {
@@ -569,6 +618,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     databasePath: dbPath,
                     provider: context.walletSecretProvider,
                     prompter,
+                    paths: runtimePaths,
                 });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildCogMutationData(result, {
@@ -607,6 +657,7 @@ export async function runWalletMutationCommand(parsed, context) {
                         provider: context.walletSecretProvider,
                         prompter,
                         assumeYes: parsed.assumeYes,
+                        paths: runtimePaths,
                     })
                     : await context.revokeReputation({
                         sourceDomainName: parsed.args[0],
@@ -618,6 +669,7 @@ export async function runWalletMutationCommand(parsed, context) {
                         provider: context.walletSecretProvider,
                         prompter,
                         assumeYes: parsed.assumeYes,
+                        paths: runtimePaths,
                     });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildReputationMutationData(result),
@@ -649,6 +701,7 @@ export async function runWalletMutationCommand(parsed, context) {
                     provider: context.walletSecretProvider,
                     prompter,
                     assumeYes: parsed.assumeYes,
+                    paths: runtimePaths,
                 });
                 return writeMutationCommandSuccess(parsed, context, {
                     data: buildDomainMarketMutationData(result, {

package/dist/cli/commands/wallet-read.js

@@ -39,11 +39,13 @@ function emitJson(context, parsed, schema, result) {
 export async function runWalletReadCommand(parsed, context) {
     const dbPath = parsed.dbPath ?? context.resolveDefaultClientDatabasePath();
     const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
+    const runtimePaths = context.resolveWalletRuntimePaths(parsed.seedName);
     await context.ensureDirectory(dirname(dbPath));
     const readContext = await context.openWalletReadContext({
         dataDir,
         databasePath: dbPath,
         secretProvider: context.walletSecretProvider,
+        paths: runtimePaths,
     });
     try {
         switch (parsed.command) {

package/dist/cli/context.js

@@ -6,15 +6,15 @@ import { resolveDefaultBitcoindDataDirForTesting, resolveDefaultClientDatabasePa
 import { openManagedBitcoindClient } from "../bitcoind/index.js";
 import { inspectPassiveClientStatus } from "../passive-status.js";
 import { openSqliteStore } from "../sqlite/index.js";
-import { exportWallet, importWallet, initializeWallet, lockWallet, previewResetWallet, repairWallet, resetWallet, restoreWalletFromMnemonic, unlockWallet, } from "../wallet/lifecycle.js";
+import { exportWallet, importWallet, initializeWallet, deleteImportedWalletSeed, lockWallet, previewResetWallet, repairWallet, resetWallet, restoreWalletFromMnemonic, showWalletMnemonic, unlockWallet, } from "../wallet/lifecycle.js";
 import { resolveWalletRuntimePathsForTesting } from "../wallet/runtime.js";
 import { 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 { disableMiningHooks, enableMiningHooks, followMiningLog, inspectMiningControlPlane, readMiningLog, runForegroundMining, setupBuiltInMining, startBackgroundMining, stopBackgroundMining, } from "../wallet/mining/index.js";
 import { createLazyDefaultWalletSecretProvider } from "../wallet/state/provider.js";
-import { 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 { 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 { createTerminalPrompter } from "./prompt.js";
 export async function readPackageVersionFromDisk() {
     const raw = await readFile(new URL("../../package.json", import.meta.url), "utf8");
@@ -39,10 +39,13 @@ export function createDefaultContext(overrides = {}) {
         previewResetWallet: overrides.previewResetWallet ?? previewResetWallet,
         exportWallet: overrides.exportWallet ?? exportWallet,
         importWallet: overrides.importWallet ?? importWallet,
+        deleteImportedWalletSeed: overrides.deleteImportedWalletSeed ?? deleteImportedWalletSeed,
+        showWalletMnemonic: overrides.showWalletMnemonic ?? showWalletMnemonic,
         unlockWallet: overrides.unlockWallet ?? unlockWallet,
         lockWallet: overrides.lockWallet ?? lockWallet,
         registerDomain: overrides.registerDomain ?? registerDomain,
         anchorDomain: overrides.anchorDomain ?? anchorDomain,
+        clearPendingAnchor: overrides.clearPendingAnchor ?? clearPendingAnchor,
         transferDomain: overrides.transferDomain ?? transferDomain,
         sellDomain: overrides.sellDomain ?? sellDomain,
         buyDomain: overrides.buyDomain ?? buyDomain,
@@ -88,10 +91,11 @@ export function createDefaultContext(overrides = {}) {
         stopIndexerDaemonService: overrides.stopIndexerDaemonService ?? stopIndexerDaemonService,
         readPackageVersion: overrides.readPackageVersion ?? readPackageVersionFromDisk,
         loadWalletState: overrides.loadWalletState ?? loadWalletState,
+        loadRawWalletStateEnvelope: overrides.loadRawWalletStateEnvelope ?? loadRawWalletStateEnvelope,
         loadUnlockSession: overrides.loadUnlockSession ?? loadUnlockSession,
         loadWalletExplicitLock: overrides.loadWalletExplicitLock ?? loadWalletExplicitLock,
         resolveDefaultBitcoindDataDir: overrides.resolveDefaultBitcoindDataDir ?? resolveDefaultBitcoindDataDirForTesting,
         resolveDefaultClientDatabasePath: overrides.resolveDefaultClientDatabasePath ?? resolveDefaultClientDatabasePathForTesting,
-        resolveWalletRuntimePaths: overrides.resolveWalletRuntimePaths ?? resolveWalletRuntimePathsForTesting,
+        resolveWalletRuntimePaths: overrides.resolveWalletRuntimePaths ?? ((seedName) => resolveWalletRuntimePathsForTesting({ seedName })),
     };
 }

package/dist/cli/mutation-command-groups.d.ts

@@ -1,8 +1,9 @@
 import type { CommandName } from "./types.js";
-export declare const walletMutationCommands: readonly ["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-create", "field-set", "field-clear", "send", "cog-send", "claim", "cog-claim", "reclaim", "cog-reclaim", "cog-lock", "rep-give", "rep-revoke"];
+export declare const walletMutationCommands: readonly ["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-create", "field-set", "field-clear", "send", "cog-send", "claim", "cog-claim", "reclaim", "cog-reclaim", "cog-lock", "rep-give", "rep-revoke"];
 export type WalletMutationCommand = (typeof walletMutationCommands)[number];
 export declare function isWalletMutationCommand(command: CommandName | null): command is WalletMutationCommand;
 export declare function isAnchorMutationCommand(command: CommandName | null): command is "anchor" | "domain-anchor";
+export declare function isAnchorClearMutationCommand(command: CommandName | null): command is "anchor-clear" | "domain-anchor-clear";
 export declare function isRegisterMutationCommand(command: CommandName | null): command is "register" | "domain-register";
 export declare function isTransferMutationCommand(command: CommandName | null): command is "transfer" | "domain-transfer";
 export declare function isSellMutationCommand(command: CommandName | null): command is "sell" | "domain-sell";

package/dist/cli/mutation-command-groups.js

@@ -1,6 +1,8 @@
 export const walletMutationCommands = [
     "anchor",
+    "anchor-clear",
     "domain-anchor",
+    "domain-anchor-clear",
     "register",
     "domain-register",
     "transfer",
@@ -39,6 +41,9 @@ export function isWalletMutationCommand(command) {
 export function isAnchorMutationCommand(command) {
     return command === "anchor" || command === "domain-anchor";
 }
+export function isAnchorClearMutationCommand(command) {
+    return command === "anchor-clear" || command === "domain-anchor-clear";
+}
 export function isRegisterMutationCommand(command) {
     return command === "register" || command === "domain-register";
 }

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

@@ -1,5 +1,5 @@
-import type { AnchorDomainResult, CogMutationResult, DomainAdminMutationResult, DomainMarketMutationResult, FieldMutationResult, RegisterDomainResult, ReputationMutationResult } from "../wallet/tx/index.js";
-import type { WalletInitializationResult, WalletExportResult, WalletImportResult, WalletRepairResult, WalletResetResult, WalletRestoreResult, WalletUnlockResult } from "../wallet/lifecycle.js";
+import type { AnchorDomainResult, ClearPendingAnchorResult, CogMutationResult, DomainAdminMutationResult, DomainMarketMutationResult, FieldMutationResult, RegisterDomainResult, ReputationMutationResult } from "../wallet/tx/index.js";
+import type { WalletInitializationResult, WalletExportResult, WalletImportResult, WalletDeleteResult, WalletRepairResult, WalletResetResult, WalletRestoreResult, WalletUnlockResult } from "../wallet/lifecycle.js";
 export declare function buildSingleTxMutationData(options: {
     kind: string;
     localStatus: string;
@@ -222,6 +222,15 @@ export declare function buildAnchorMutationData(result: AnchorDomainResult, opti
     };
     intent: Record<string, unknown>;
 };
+export declare function buildAnchorClearMutationData(result: ClearPendingAnchorResult): {
+    resultType: "state-change";
+    stateChange: {
+        kind: string;
+        before: Record<string, unknown> | null;
+        after: Record<string, unknown> | null;
+    };
+    state: Record<string, unknown>;
+};
 export declare function buildResetMutationData(result: WalletResetResult): {
     resultType: "operation";
     operation: {
@@ -229,6 +238,13 @@ export declare function buildResetMutationData(result: WalletResetResult): {
     };
     state: Record<string, unknown> | null;
 };
+export declare function buildWalletDeleteMutationData(result: WalletDeleteResult): {
+    resultType: "operation";
+    operation: {
+        kind: string;
+    };
+    state: Record<string, unknown> | null;
+};
 export declare function buildDomainAdminMutationData(result: DomainAdminMutationResult, options: {
     commandKind: "domain-endpoint-set" | "domain-endpoint-clear" | "domain-delegate-set" | "domain-delegate-clear" | "domain-miner-set" | "domain-miner-clear" | "domain-canonical";
 }): {