@cogcoin/client 0.5.5 → 0.5.7

package/dist/cli/mutation-json.js

@@ -140,6 +140,36 @@ export function buildAnchorMutationData(result, options) {
         },
     });
 }
+export function buildAnchorClearMutationData(result) {
+    const before = result.cleared
+        ? {
+            localAnchorIntent: "reserved",
+            dedicatedIndex: result.releasedDedicatedIndex,
+            familyStatus: result.previousFamilyStatus,
+            familyStep: result.previousFamilyStep,
+        }
+        : null;
+    const after = result.cleared
+        ? {
+            localAnchorIntent: "none",
+            dedicatedIndex: null,
+            familyStatus: "canceled",
+            familyStep: result.previousFamilyStep,
+        }
+        : null;
+    return buildStateChangeData({
+        kind: "anchor-clear",
+        state: {
+            domainName: result.domainName,
+            cleared: result.cleared,
+            previousFamilyStatus: result.previousFamilyStatus,
+            previousFamilyStep: result.previousFamilyStep,
+            releasedDedicatedIndex: result.releasedDedicatedIndex,
+        },
+        before,
+        after,
+    });
+}
 export function buildResetMutationData(result) {
     return buildOperationData({
         kind: "reset",
@@ -150,6 +180,7 @@ export function buildResetMutationData(result) {
             walletOldRootId: result.walletOldRootId,
             walletNewRootId: result.walletNewRootId,
             bootstrapSnapshot: result.bootstrapSnapshot,
+            bitcoinDataDir: result.bitcoinDataDir,
             stoppedProcesses: result.stoppedProcesses,
             secretCleanupStatus: result.secretCleanupStatus,
         },
@@ -165,10 +196,26 @@ export function buildResetMutationData(result) {
             walletOldRootId: result.walletOldRootId,
             walletNewRootId: result.walletNewRootId,
             bootstrapSnapshot: result.bootstrapSnapshot,
+            bitcoinDataDir: result.bitcoinDataDir,
             removedPaths: result.removedPaths,
         },
     });
 }
+export function buildWalletDeleteMutationData(result) {
+    return buildOperationData({
+        kind: "wallet-delete",
+        state: {
+            seedName: result.seedName,
+            walletRootId: result.walletRootId,
+            deleted: result.deleted,
+        },
+        operation: {
+            seedName: result.seedName,
+            walletRootId: result.walletRootId,
+            deleted: result.deleted,
+        },
+    });
+}
 export function buildDomainAdminMutationData(result, options) {
     const data = buildSingleTxMutationData({
         kind: options.commandKind,
@@ -259,6 +306,7 @@ export function buildWalletLockMutationData(result) {
 }
 export function buildInitMutationData(result) {
     const after = {
+        seedName: "main",
         walletRootId: result.walletRootId,
         fundingAddress: result.fundingAddress,
         unlockUntilUnixMs: result.unlockUntilUnixMs,
@@ -273,6 +321,7 @@ export function buildInitMutationData(result) {
 }
 export function buildRestoreMutationData(result) {
     const after = {
+        seedName: result.seedName ?? null,
         walletRootId: result.walletRootId,
         fundingAddress: result.fundingAddress,
         unlockUntilUnixMs: result.unlockUntilUnixMs,

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

@@ -12,6 +12,7 @@ export declare function writeMutationCommandSuccess(parsed: ParsedCliArgs, conte
     reusedExisting: boolean;
     reusedMessage: string;
     nextSteps: MutationSuccessNextSteps;
+    outcome?: string;
     text: {
         heading: string;
         fields: MutationTextField[];

package/dist/cli/mutation-success.js

@@ -21,7 +21,7 @@ function reuseExplanation(reusedExisting, message) {
 }
 export function writeMutationCommandSuccess(parsed, context, options) {
     if (parsed.outputMode === "preview-json") {
-        writeJsonValue(context.stdout, createPreviewSuccessEnvelope(resolvePreviewJsonSchema(parsed), describeCanonicalCommand(parsed), mutationOutcome(options.reusedExisting), options.previewData ?? options.data, {
+        writeJsonValue(context.stdout, createPreviewSuccessEnvelope(resolvePreviewJsonSchema(parsed), describeCanonicalCommand(parsed), options.outcome ?? mutationOutcome(options.reusedExisting), options.previewData ?? options.data, {
             explanations: reuseExplanation(options.reusedExisting, options.reusedMessage),
             nextSteps: options.nextSteps.json,
             warnings: options.warnings,
@@ -29,7 +29,7 @@ export function writeMutationCommandSuccess(parsed, context, options) {
         return 0;
     }
     if (parsed.outputMode === "json") {
-        writeJsonValue(context.stdout, createMutationSuccessEnvelope(resolveStableMutationJsonSchema(parsed), describeCanonicalCommand(parsed), mutationOutcome(options.reusedExisting), options.data, {
+        writeJsonValue(context.stdout, createMutationSuccessEnvelope(resolveStableMutationJsonSchema(parsed), describeCanonicalCommand(parsed), options.outcome ?? mutationOutcome(options.reusedExisting), options.data, {
             explanations: reuseExplanation(options.reusedExisting, options.reusedMessage),
             nextSteps: options.nextSteps.json,
             warnings: options.warnings,

package/dist/cli/output.js

@@ -151,10 +151,13 @@ export function classifyCliError(error) {
     }
     if (message === "wallet_typed_confirmation_rejected"
         || message === "wallet_export_overwrite_declined"
+        || message === "wallet_delete_confirmation_required"
         || message === "wallet_prompt_value_required"
         || message === "wallet_archive_passphrase_mismatch"
         || message === "wallet_restore_mnemonic_invalid"
         || message === "wallet_restore_replace_confirmation_required"
+        || message === "wallet_seed_name_invalid"
+        || message === "wallet_seed_name_reserved"
         || message === "reset_wallet_choice_invalid"
         || message === "reset_wallet_passphrase_required"
         || message === "reset_wallet_access_failed") {
@@ -185,6 +188,10 @@ function isBlockedError(message) {
         || message === "wallet_export_core_replica_not_ready"
         || message === "wallet_export_tip_mismatch"
         || message === "wallet_export_requires_quiescent_local_state"
+        || message === "wallet_restore_requires_main_wallet"
+        || message === "wallet_seed_name_exists"
+        || message === "wallet_seed_not_found"
+        || message === "wallet_delete_main_not_supported"
         || message === "wallet_repair_indexer_reset_requires_yes"
         || message === "managed_bitcoind_service_version_mismatch"
         || message === "managed_bitcoind_wallet_root_mismatch"
@@ -303,6 +310,34 @@ export function createCliErrorPresentation(errorCode, fallbackMessage) {
             next: "Run `cogcoin status` to inspect the existing wallet, or export/import it instead of reinitializing.",
         };
     }
+    if (errorCode === "wallet_restore_requires_main_wallet") {
+        return {
+            what: "Main wallet is required before importing another seed.",
+            why: "Named restore only creates imported seeds. Cogcoin requires the primary `main` wallet to exist first so shared local state has a canonical default seed.",
+            next: "Run `cogcoin init`, then rerun `cogcoin restore --seed <name>`.",
+        };
+    }
+    if (errorCode === "wallet_seed_name_exists") {
+        return {
+            what: "Seed name is already in use.",
+            why: "This machine already has a wallet seed registered with that name.",
+            next: "Choose a different `--seed` name, or delete the imported seed first with `cogcoin wallet delete --seed <name>`.",
+        };
+    }
+    if (errorCode === "wallet_seed_not_found") {
+        return {
+            what: "Seed was not found.",
+            why: "No local wallet seed is registered under that name.",
+            next: "Check `--seed <name>` and retry.",
+        };
+    }
+    if (errorCode === "wallet_delete_main_not_supported") {
+        return {
+            what: "The main wallet cannot be deleted with `wallet delete`.",
+            why: "This command only removes imported seeds. The canonical `main` wallet is part of the base local client state.",
+            next: "Use `cogcoin reset` if you need to remove the main wallet.",
+        };
+    }
     if (errorCode === "local-state-corrupt" || errorCode.includes("repair_required") || errorCode.includes("repair-required")) {
         return {
             what: "Local recovery is required.",
@@ -342,7 +377,7 @@ export function createCliErrorPresentation(errorCode, fallbackMessage) {
         return {
             what: "Recovery phrase is invalid.",
             why: "Mnemonic-only restore accepts only a valid 24-word English BIP39 phrase with a matching checksum.",
-            next: "Rerun `cogcoin restore` and enter the 24 recovery words in the original order.",
+            next: "Rerun `cogcoin restore --seed <name>` and enter the 24 recovery words in the original order.",
         };
     }
     if (errorCode === "wallet_restore_replace_confirmation_required") {
@@ -352,6 +387,41 @@ export function createCliErrorPresentation(errorCode, fallbackMessage) {
             next: "Rerun `cogcoin restore` in an interactive terminal and type \"RESTORE\" when prompted.",
         };
     }
+    if (errorCode === "wallet_seed_name_invalid" || errorCode === "wallet_seed_name_reserved" || errorCode === "cli_invalid_seed_name") {
+        return {
+            what: "Seed name is invalid.",
+            why: "Wallet seed names must be lowercase slugs like `trading` or `cold-backup`, and `main` is reserved.",
+            next: "Choose a different seed name and retry.",
+        };
+    }
+    if (errorCode === "cli_missing_seed_name") {
+        return {
+            what: "A seed name is required.",
+            why: "This command needs `--seed <name>` to identify which imported wallet seed it should restore or delete.",
+            next: "Rerun the command with `--seed <name>`.",
+        };
+    }
+    if (errorCode === "cli_seed_not_supported_for_command" || errorCode === "wallet_init_seed_not_supported" || errorCode === "wallet_import_seed_not_supported") {
+        return {
+            what: "This command does not support `--seed`.",
+            why: "Only wallet-aware commands are seed-selectable. Global lifecycle and shared service commands still operate on the shared local client state.",
+            next: "Drop `--seed` for this command and retry.",
+        };
+    }
+    if (errorCode === "wallet_anchor_clear_inconsistent_state") {
+        return {
+            what: "Pending anchor state is inconsistent.",
+            why: "The domain still shows local pending anchor state, but the wallet could not find a matching clearable reserved anchor family.",
+            next: "Run `cogcoin repair`, then inspect the domain again before retrying `cogcoin anchor clear`.",
+        };
+    }
+    if (errorCode.startsWith("wallet_anchor_clear_not_clearable_")) {
+        return {
+            what: "Pending anchor cannot be cleared safely.",
+            why: "This command only clears a local pre-broadcast reservation. The anchor family is already beyond that safe stage or may have been observed by the wallet.",
+            next: "Rerun `cogcoin anchor <domain>` to reconcile the family, or run `cogcoin repair` if it remains unresolved.",
+        };
+    }
     if (errorCode === "mining_hooks_enable_trust_acknowledgement_required") {
         return {
             what: "Trust acknowledgement is still required.",
@@ -735,6 +805,10 @@ export function describeCanonicalCommand(parsed) {
         case "restore":
         case "wallet-restore":
             return "cogcoin restore";
+        case "wallet-delete":
+            return "cogcoin wallet delete";
+        case "wallet-show-mnemonic":
+            return "cogcoin wallet show-mnemonic";
         case "unlock":
         case "wallet-unlock":
             return "cogcoin unlock";
@@ -747,6 +821,9 @@ export function describeCanonicalCommand(parsed) {
         case "anchor":
         case "domain-anchor":
             return `cogcoin anchor ${args[0] ?? "<domain>"}`;
+        case "anchor-clear":
+        case "domain-anchor-clear":
+            return `cogcoin anchor clear ${args[0] ?? "<domain>"}`;
         case "register":
         case "domain-register":
             return `cogcoin register ${args[0] ?? "<domain>"}`;
@@ -916,6 +993,8 @@ export function resolveStableMutationJsonSchema(parsed) {
         case "restore":
         case "wallet-restore":
             return "cogcoin/restore/v1";
+        case "wallet-delete":
+            return "cogcoin/wallet-delete/v1";
         case "unlock":
         case "wallet-unlock":
             return "cogcoin/unlock/v1";
@@ -932,6 +1011,9 @@ export function resolveStableMutationJsonSchema(parsed) {
         case "anchor":
         case "domain-anchor":
             return "cogcoin/anchor/v1";
+        case "anchor-clear":
+        case "domain-anchor-clear":
+            return "cogcoin/anchor-clear/v1";
         case "register":
         case "domain-register":
             return "cogcoin/register/v1";
@@ -1010,7 +1092,9 @@ export function resolvePreviewJsonSchema(parsed) {
         case "reset":
         case "repair":
         case "anchor":
+        case "anchor-clear":
         case "domain-anchor":
+        case "domain-anchor-clear":
         case "register":
         case "domain-register":
         case "transfer":
@@ -1065,6 +1149,7 @@ function createSchemaProbe(command) {
         dbPath: null,
         dataDir: null,
         progressOutput: "auto",
+        seedName: null,
         unlockFor: null,
         assumeYes: false,
         forceRace: false,

package/dist/cli/parse.d.ts

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

package/dist/cli/parse.js

@@ -12,7 +12,7 @@ Commands:
   indexer status          Show managed Cogcoin indexer status without starting it
   init                    Initialize a new local wallet root
   init --output json      Emit the stable v1 machine-readable init result envelope
-  restore                 Restore a fresh local wallet from a 24-word mnemonic; run sync afterward
+  restore                 Restore an imported named seed from a 24-word mnemonic; run sync afterward
   reset                   Factory-reset local Cogcoin state with interactive retention prompts
   repair                  Recover bounded wallet/indexer/runtime state
   unlock                  Clear an explicit wallet lock and unlock for a limited duration
@@ -30,6 +30,7 @@ Commands:
   mine status             Show mining control-plane health and readiness
   mine log                Show recent mining control-plane events
   anchor <domain>         Anchor an owned unanchored domain with the Tx1/Tx2 family
+  anchor clear <domain>   Clear a local-only pending anchor reservation before broadcast
   register <domain> [--from <identity>]
                          Register a root domain or subdomain
   transfer <domain> --to <btc-target>
@@ -47,7 +48,9 @@ Commands:
                          Lock COG to an anchored recipient domain
   wallet status           Show detailed wallet-local status and service health
   wallet init             Initialize a new local wallet root
-  wallet restore          Restore a fresh local wallet from a 24-word mnemonic; run sync afterward
+  wallet restore          Restore an imported named seed from a 24-word mnemonic; run sync afterward
+  wallet delete           Delete one imported named seed without affecting main
+  wallet show-mnemonic    Reveal the initialized wallet recovery phrase after typed confirmation
   wallet unlock           Clear an explicit wallet lock and unlock for a limited duration
   wallet lock             Lock the local wallet and disable on-demand unlock
   wallet export <path>    Export a portable encrypted wallet archive
@@ -107,6 +110,7 @@ Options:
   --follow         Follow mining log output
   --output <mode>  Output mode: text, json, or preview-json
   --progress <mode> Progress output mode: auto, tty, or none
+  --seed <name>    Select an imported wallet seed for wallet-aware commands
   --force-race      Allow a visible root registration race
   --yes             Approve eligible plain yes/no mutation confirmations non-interactively
   --help            Show help
@@ -122,6 +126,7 @@ Examples:
   cogcoin bitcoin status
   cogcoin indexer status
   cogcoin init --output json
+  cogcoin restore --seed trading
   cogcoin wallet address
   cogcoin domain list --mineable
   cogcoin register alpha-child
@@ -138,7 +143,12 @@ Examples:
 `;
 function supportsYesFlag(command) {
     switch (command) {
+        case "sync":
+        case "follow":
         case "repair":
+        case "wallet-delete":
+        case "anchor-clear":
+        case "domain-anchor-clear":
         case "register":
         case "domain-register":
         case "transfer":
@@ -173,6 +183,81 @@ function supportsYesFlag(command) {
             return false;
     }
 }
+function supportsSeedFlag(command) {
+    switch (command) {
+        case "status":
+        case "unlock":
+        case "anchor":
+        case "anchor-clear":
+        case "domain-anchor":
+        case "domain-anchor-clear":
+        case "register":
+        case "domain-register":
+        case "transfer":
+        case "domain-transfer":
+        case "sell":
+        case "domain-sell":
+        case "unsell":
+        case "domain-unsell":
+        case "buy":
+        case "domain-buy":
+        case "domain-endpoint-set":
+        case "domain-endpoint-clear":
+        case "domain-delegate-set":
+        case "domain-delegate-clear":
+        case "domain-miner-set":
+        case "domain-miner-clear":
+        case "domain-canonical":
+        case "field-list":
+        case "field-show":
+        case "field-create":
+        case "field-set":
+        case "field-clear":
+        case "send":
+        case "claim":
+        case "reclaim":
+        case "cog-send":
+        case "cog-claim":
+        case "cog-reclaim":
+        case "cog-lock":
+        case "rep-give":
+        case "rep-revoke":
+        case "cog-balance":
+        case "cog-locks":
+        case "mine":
+        case "mine-start":
+        case "mine-stop":
+        case "mine-setup":
+        case "mine-status":
+        case "mine-log":
+        case "wallet-export":
+        case "wallet-delete":
+        case "wallet-restore":
+        case "restore":
+        case "wallet-show-mnemonic":
+        case "wallet-lock":
+        case "wallet-unlock":
+        case "wallet-status":
+        case "wallet-address":
+        case "wallet-ids":
+        case "address":
+        case "ids":
+        case "balance":
+        case "locks":
+        case "domain-list":
+        case "domains":
+        case "domain-show":
+        case "show":
+        case "fields":
+        case "field":
+            return true;
+        default:
+            return false;
+    }
+}
+function requiresSeedFlag(command) {
+    return command === "restore" || command === "wallet-restore" || command === "wallet-delete";
+}
 export function parseCliArgs(argv) {
     let command = null;
     const args = [];
@@ -182,6 +267,7 @@ export function parseCliArgs(argv) {
     let dbPath = null;
     let dataDir = null;
     let progressOutput = "auto";
+    let seedName = null;
     let unlockFor = null;
     let assumeYes = false;
     let forceRace = false;
@@ -235,6 +321,17 @@ export function parseCliArgs(argv) {
             }
             continue;
         }
+        if (token === "--seed") {
+            index += 1;
+            seedName = argv[index] ?? null;
+            if (seedName === null) {
+                throw new Error("cli_missing_seed_name");
+            }
+            if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(seedName)) {
+                throw new Error("cli_invalid_seed_name");
+            }
+            continue;
+        }
         if (token === "--data-dir") {
             index += 1;
             dataDir = argv[index] ?? null;
@@ -451,6 +548,16 @@ export function parseCliArgs(argv) {
                     index += 1;
                     continue;
                 }
+                if (subcommand === "delete") {
+                    command = "wallet-delete";
+                    index += 1;
+                    continue;
+                }
+                if (subcommand === "show-mnemonic") {
+                    command = "wallet-show-mnemonic";
+                    index += 1;
+                    continue;
+                }
                 if (subcommand === "unlock") {
                     command = "wallet-unlock";
                     index += 1;
@@ -580,6 +687,12 @@ export function parseCliArgs(argv) {
                     continue;
                 }
                 if (subcommand === "anchor") {
+                    const action = argv[index + 2] ?? null;
+                    if (action === "clear") {
+                        command = "domain-anchor-clear";
+                        index += 2;
+                        continue;
+                    }
                     command = "domain-anchor";
                     index += 1;
                     continue;
@@ -755,6 +868,11 @@ export function parseCliArgs(argv) {
                 || token === "domains"
                 || token === "show"
                 || token === "fields") {
+                if (token === "anchor" && argv[index + 1] === "clear") {
+                    command = "anchor-clear";
+                    index += 1;
+                    continue;
+                }
                 command = token;
                 continue;
             }
@@ -774,6 +892,7 @@ export function parseCliArgs(argv) {
         || command === "reset"
         || command === "unlock"
         || command === "wallet-init"
+        || command === "wallet-delete"
         || command === "wallet-restore"
         || command === "wallet-lock"
         || command === "wallet-unlock"
@@ -806,7 +925,11 @@ export function parseCliArgs(argv) {
     if ((command === "register" || command === "domain-register") && args.length !== 1) {
         throw new Error("cli_missing_domain_argument");
     }
-    if ((command === "anchor" || command === "domain-anchor") && args.length !== 1) {
+    if ((command === "anchor"
+        || command === "domain-anchor"
+        || command === "anchor-clear"
+        || command === "domain-anchor-clear")
+        && args.length !== 1) {
         throw new Error("cli_missing_domain_argument");
     }
     if ((command === "domain-endpoint-set"
@@ -862,6 +985,12 @@ export function parseCliArgs(argv) {
     if (assumeYes && !supportsYesFlag(command)) {
         throw new Error("cli_yes_not_supported_for_command");
     }
+    if (seedName !== null && !supportsSeedFlag(command)) {
+        throw new Error("cli_seed_not_supported_for_command");
+    }
+    if (requiresSeedFlag(command) && seedName === null) {
+        throw new Error("cli_missing_seed_name");
+    }
     if (forceRace && command !== "register" && command !== "domain-register") {
         throw new Error("cli_force_race_not_supported_for_command");
     }
@@ -1006,6 +1135,7 @@ export function parseCliArgs(argv) {
         dbPath,
         dataDir,
         progressOutput,
+        seedName,
         unlockFor,
         assumeYes,
         forceRace,

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

@@ -1,4 +1,4 @@
-import type { AnchorDomainResult, CogMutationResult, DomainAdminMutationResult, DomainMarketMutationResult, FieldMutationResult, RegisterDomainResult, ReputationMutationResult } from "../wallet/tx/index.js";
+import type { AnchorDomainResult, ClearPendingAnchorResult, CogMutationResult, DomainAdminMutationResult, DomainMarketMutationResult, FieldMutationResult, RegisterDomainResult, ReputationMutationResult } from "../wallet/tx/index.js";
 import type { WalletRepairResult, WalletResetPreview } from "../wallet/lifecycle.js";
 import type { MiningControlPlaneView, MiningRuntimeStatusV1 } from "../wallet/mining/index.js";
 export declare function buildSingleTxMutationPreviewData(options: {
@@ -223,6 +223,15 @@ export declare function buildAnchorPreviewData(result: AnchorDomainResult, optio
     };
     intent: Record<string, unknown>;
 };
+export declare function buildAnchorClearPreviewData(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 buildDomainAdminPreviewData(result: DomainAdminMutationResult, options: {
     commandKind: "domain-endpoint-set" | "domain-endpoint-clear" | "domain-delegate-set" | "domain-delegate-clear" | "domain-miner-set" | "domain-miner-clear" | "domain-canonical";
 }): {

package/dist/cli/preview-json.js

@@ -140,6 +140,36 @@ export function buildAnchorPreviewData(result, options) {
         },
     });
 }
+export function buildAnchorClearPreviewData(result) {
+    const before = result.cleared
+        ? {
+            localAnchorIntent: "reserved",
+            dedicatedIndex: result.releasedDedicatedIndex,
+            familyStatus: result.previousFamilyStatus,
+            familyStep: result.previousFamilyStep,
+        }
+        : null;
+    const after = result.cleared
+        ? {
+            localAnchorIntent: "none",
+            dedicatedIndex: null,
+            familyStatus: "canceled",
+            familyStep: result.previousFamilyStep,
+        }
+        : null;
+    return buildStateChangePreviewData({
+        kind: "anchor-clear",
+        state: {
+            domainName: result.domainName,
+            cleared: result.cleared,
+            previousFamilyStatus: result.previousFamilyStatus,
+            previousFamilyStep: result.previousFamilyStep,
+            releasedDedicatedIndex: result.releasedDedicatedIndex,
+        },
+        before,
+        after,
+    });
+}
 export function buildDomainAdminPreviewData(result, options) {
     const data = buildSingleTxMutationPreviewData({
         kind: options.commandKind,
@@ -234,6 +264,7 @@ export function buildResetPreviewData(result) {
             trackedProcessKinds: result.trackedProcessKinds,
             willDeleteOsSecrets: result.willDeleteOsSecrets,
             bootstrapSnapshot: result.bootstrapSnapshot,
+            bitcoinDataDir: result.bitcoinDataDir,
             walletPrompt: result.walletPrompt,
         },
         operation: {
@@ -241,6 +272,7 @@ export function buildResetPreviewData(result) {
             confirmationPhrase: result.confirmationPhrase,
             walletPrompt: result.walletPrompt,
             bootstrapSnapshot: result.bootstrapSnapshot,
+            bitcoinDataDir: result.bitcoinDataDir,
             trackedProcessKinds: result.trackedProcessKinds,
             willDeleteOsSecrets: result.willDeleteOsSecrets,
             removedPaths: result.removedPaths,

package/dist/cli/prompt.js

@@ -53,7 +53,7 @@ export function createTerminalPrompter(input, output) {
             if (!input.isTTY || !output.isTTY) {
                 return;
             }
-            if (scope === "mnemonic-reveal") {
+            if (scope === "mnemonic-reveal" || scope === "restore-mnemonic-entry") {
                 output.write(CLEAR_SENSITIVE_DISPLAY_SEQUENCE);
             }
         },

package/dist/cli/runner.js

@@ -76,13 +76,17 @@ export async function runCli(argv, contextOverrides = {}) {
             || 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") {
             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"