@cogcoin/client 0.5.15 → 1.0.1

package/dist/cli/wallet-format.js

@@ -1,12 +1,23 @@
-import { findDomainField, findWalletDomain, formatFieldFormat, listDomainFields, listWalletLocks, } from "../wallet/read/index.js";
+import { getBalance } from "@cogcoin/indexer/queries";
+import { findDomainField, findWalletDomain, formatFieldFormat, isRootDomainName, listDomainFields, listWalletLocks, } from "../wallet/read/index.js";
+import { loadBalanceArtText } from "./art.js";
 import { formatMiningSummaryLine } from "./mining-format.js";
-import { getBootstrapSyncNextStep } from "./workflow-hints.js";
-function formatCogAmount(value) {
+import { formatNextStepLines, getBootstrapSyncNextStep, getFundingQuickstartGuidance, } from "./workflow-hints.js";
+const BALANCE_QUICKSTART_THRESHOLD_SATS = 150000n;
+const BALANCE_BUY_ROOT_THRESHOLD_SATS = 100000n;
+const BALANCE_MINING_THRESHOLD_SATS = 10000n;
+function formatUnitAmount(value, unit) {
     const sign = value < 0n ? "-" : "";
     const absolute = value < 0n ? -value : value;
     const whole = absolute / 100000000n;
     const fraction = absolute % 100000000n;
-    return `${sign}${whole.toString()}.${fraction.toString().padStart(8, "0")} COG`;
+    return `${sign}${whole.toString()}.${fraction.toString().padStart(8, "0")} ${unit}`;
+}
+function formatCogAmount(value) {
+    return formatUnitAmount(value, "COG");
+}
+function formatBitcoinAmount(value) {
+    return value === null ? "unavailable BTC" : formatUnitAmount(value, "BTC");
 }
 function formatServiceHealth(health) {
     return health.replaceAll("-", " ");
@@ -26,12 +37,6 @@ function formatIndexerTruthSource(source) {
             return "none";
     }
 }
-function formatUnlockExpiry(unlockUntilUnixMs) {
-    if (unlockUntilUnixMs === null) {
-        return "locked";
-    }
-    return `unlocked until ${new Date(unlockUntilUnixMs).toISOString()}`;
-}
 function isReputationMutation(mutation) {
     return (mutation.kind === "rep-give" || mutation.kind === "rep-revoke")
         && mutation.recipientDomainName !== undefined
@@ -75,6 +80,13 @@ function formatPendingMutationDomainLabel(mutation) {
     return kind;
 }
 export function getRepairRecommendation(context) {
+    if (context.localState.clientPasswordReadiness === "setup-required"
+        || context.localState.clientPasswordReadiness === "migration-required") {
+        return "Run `cogcoin init` to configure the client password and migrate local wallet secrets.";
+    }
+    if (context.localState.unlockRequired) {
+        return null;
+    }
     if (context.localState.availability === "uninitialized") {
         return "Run `cogcoin init` to create a new local wallet root.";
     }
@@ -96,32 +108,18 @@ export function getRepairRecommendation(context) {
         return "Run `cogcoin repair` to recover the managed indexer daemon and local indexer artifacts.";
     }
     if (context.localState.state?.miningState.state === "repair-required"
-        || context.localState.state?.proactiveFamilies.some((family) => family.status === "repair-required")
-        || context.localState.state?.domains.some((domain) => domain.localAnchorIntent === "repair-required")
         || (context.localState.state?.pendingMutations ?? []).some((mutation) => mutation.status === "repair-required")) {
         return "Run `cogcoin repair` before relying on local wallet state.";
     }
     return null;
 }
-export function getMutationRecommendation(context) {
-    const clearableAnchorFamily = (context.localState.state?.proactiveFamilies ?? []).find((family) => family.type === "anchor"
-        && family.status === "draft"
-        && family.currentStep === "reserved");
-    if (clearableAnchorFamily?.domainName != null) {
-        return `Run \`cogcoin anchor clear ${clearableAnchorFamily.domainName}\` to cancel the local pending anchor reservation, or rerun \`cogcoin anchor ${clearableAnchorFamily.domainName}\` to continue anchoring.`;
-    }
-    const unresolvedFamily = (context.localState.state?.proactiveFamilies ?? []).find((family) => (family.type === "anchor" || family.type === "field")
-        && (family.status === "broadcast-unknown" || family.status === "repair-required"));
-    if (unresolvedFamily !== undefined) {
-        if (unresolvedFamily.status === "repair-required") {
-            return unresolvedFamily.type === "field"
-                ? "Run `cogcoin repair` before starting another field family."
-                : "Run `cogcoin repair` before starting another anchor family.";
-        }
-        return unresolvedFamily.type === "field"
-            ? `Rerun \`cogcoin field create ${unresolvedFamily.domainName} ${unresolvedFamily.fieldName} ...\` to reconcile the pending field family, or run \`cogcoin repair\` if it remains unresolved.`
-            : `Rerun \`cogcoin anchor ${unresolvedFamily.domainName}\` to reconcile the pending anchor family, or run \`cogcoin repair\` if it remains unresolved.`;
+export function getClientUnlockRecommendation(context) {
+    if (context.localState.unlockRequired) {
+        return "Run `cogcoin client unlock` to temporarily unlock wallet-local secrets.";
     }
+    return null;
+}
+export function getMutationRecommendation(context) {
     const pendingMutations = context.localState.state?.pendingMutations ?? [];
     const unresolved = pendingMutations.find((mutation) => mutation.status === "broadcast-unknown" || mutation.status === "repair-required");
     if (unresolved === undefined) {
@@ -133,6 +131,9 @@ export function getMutationRecommendation(context) {
     if (unresolved.kind === "register") {
         return `Rerun \`cogcoin register ${unresolved.domainName}\` to reconcile the pending registration, or run \`cogcoin repair\` if it remains unresolved.`;
     }
+    if (unresolved.kind === "anchor") {
+        return `Rerun \`cogcoin anchor ${unresolved.domainName}\` to reconcile the pending anchor, or run \`cogcoin repair\` if it remains unresolved.`;
+    }
     if (unresolved.kind === "transfer") {
         return `Rerun \`cogcoin transfer ${unresolved.domainName}\` with the same target to reconcile the pending transfer, or run \`cogcoin repair\` if it remains unresolved.`;
     }
@@ -187,22 +188,12 @@ export function getMutationRecommendation(context) {
         : "Rerun the same `cogcoin claim ...` command to reconcile the pending claim, or run `cogcoin repair` if it remains unresolved.";
 }
 function appendPendingMutationSummary(lines, context) {
-    const pendingFamilies = (context.localState.state?.proactiveFamilies ?? [])
-        .filter((family) => (family.type === "anchor" || family.type === "field")
-        && family.status !== "confirmed"
-        && family.status !== "canceled");
     const pendingMutations = (context.localState.state?.pendingMutations ?? [])
         .filter((mutation) => mutation.status !== "confirmed" && mutation.status !== "canceled");
-    if (pendingFamilies.length === 0 && pendingMutations.length === 0) {
+    if (pendingMutations.length === 0) {
         lines.push("Pending mutations: none");
         return;
     }
-    for (const family of pendingFamilies) {
-        const label = family.type === "field"
-            ? `Pending field family: ${family.domainName ?? "unknown"}.${family.fieldName ?? "unknown"}`
-            : `Pending anchor family: ${family.domainName ?? "unknown"}`;
-        lines.push(`${label}  ${family.status}${family.currentStep === null || family.currentStep === undefined ? "" : `  step ${family.currentStep}`}${family.reservedDedicatedIndex == null ? "" : `  index ${family.reservedDedicatedIndex}`}`);
-    }
     for (const mutation of pendingMutations) {
         lines.push(`Pending mutation: ${formatPendingMutationSummaryLabel(mutation)}  ${mutation.status}  sender spk:${mutation.senderScriptPubKeyHex}${mutation.priceCogtoshi === undefined || mutation.priceCogtoshi === null ? "" : `  price ${formatCogAmount(mutation.priceCogtoshi)}`}${mutation.amountCogtoshi === undefined || mutation.amountCogtoshi === null ? "" : `  amount ${formatCogAmount(mutation.amountCogtoshi)}`}${isReputationMutation(mutation) ? "" : mutation.recipientDomainName === undefined || mutation.recipientDomainName === null ? "" : `  domain ${mutation.recipientDomainName}`}${mutation.lockId === undefined || mutation.lockId === null ? "" : `  lock ${mutation.lockId}`}${mutation.recipientScriptPubKeyHex === undefined || mutation.recipientScriptPubKeyHex === null ? "" : `  recipient spk:${mutation.recipientScriptPubKeyHex}`}${mutation.kind === "endpoint" ? (mutation.endpointValueHex === "" ? "  endpoint clear" : `  endpoint-bytes ${(mutation.endpointValueHex?.length ?? 0) / 2}`) : ""}${mutation.kind === "field-create" || mutation.kind === "field-set" ? `  format ${formatFieldFormat(mutation.fieldFormat ?? 0)}` : ""}${mutation.kind === "field-clear" ? "  clear" : ""}${mutation.reviewPayloadHex === undefined || mutation.reviewPayloadHex === null ? "" : "  review"}`);
     }
@@ -213,6 +204,7 @@ function listPendingDomainMutations(context, domainName) {
         || mutation.kind === "transfer"
         || mutation.kind === "sell"
         || mutation.kind === "buy"
+        || mutation.kind === "anchor"
         || mutation.kind === "endpoint"
         || mutation.kind === "delegate"
         || mutation.kind === "miner"
@@ -224,26 +216,13 @@ function listPendingDomainMutations(context, domainName) {
         && mutation.status !== "confirmed"
         && mutation.status !== "canceled");
 }
-function listPendingAnchorFamilies(context, domainName) {
-    return (context.localState.state?.proactiveFamilies ?? [])
-        .filter((family) => family.type === "anchor"
-        && family.domainName === domainName
-        && family.status !== "confirmed"
-        && family.status !== "canceled");
-}
-function listPendingFieldFamilies(context, domainName) {
-    return (context.localState.state?.proactiveFamilies ?? [])
-        .filter((family) => family.type === "field"
-        && family.domainName === domainName
-        && family.status !== "confirmed"
-        && family.status !== "canceled");
-}
 function listPendingDomainShowMutations(context, domainName) {
     return (context.localState.state?.pendingMutations ?? [])
         .filter((mutation) => (mutation.kind === "register"
         || mutation.kind === "transfer"
         || mutation.kind === "sell"
         || mutation.kind === "buy"
+        || mutation.kind === "anchor"
         || mutation.kind === "endpoint"
         || mutation.kind === "delegate"
         || mutation.kind === "miner"
@@ -308,7 +287,6 @@ function appendServiceSummary(lines, context) {
 function appendWalletAvailability(lines, context) {
     lines.push(`Wallet state: ${context.localState.availability}`);
     lines.push(`Wallet root: ${context.model?.walletRootId ?? context.localState.walletRootId ?? context.nodeStatus?.walletRootId ?? "none"}`);
-    lines.push(`Wallet unlock: ${formatUnlockExpiry(context.localState.unlockUntilUnixMs)}`);
     if (context.localState.message !== null) {
         lines.push(`Wallet note: ${context.localState.message}`);
     }
@@ -325,8 +303,11 @@ function appendWalletAvailability(lines, context) {
         lines.push(`Recommended next step: ${repairRecommendation}`);
     }
     else {
-        const bootstrapSync = getBootstrapSyncNextStep(context);
-        if (bootstrapSync !== null) {
+        const clientUnlockRecommendation = getClientUnlockRecommendation(context);
+        if (clientUnlockRecommendation !== null) {
+            lines.push(`Recommended next step: ${clientUnlockRecommendation}`);
+        }
+        else if (getBootstrapSyncNextStep(context) !== null) {
             lines.push("Recommended next step: Run `cogcoin sync` to bootstrap assumeutxo and the managed Bitcoin/indexer state.");
         }
     }
@@ -347,7 +328,7 @@ function isMiningOverviewOk(mining) {
         && mining.runtime.indexerHealth === "synced"
         && mining.runtime.miningState !== "repair-required"
         && mining.runtime.miningState !== "paused-stale"
-        && !(mining.runtime.miningState === "paused" && mining.runtime.liveMiningFamilyInMempool === true);
+        && !(mining.runtime.miningState === "paused" && mining.runtime.livePublishInMempool === true);
 }
 function buildOverviewPathsSection(context) {
     return [
@@ -360,7 +341,6 @@ function buildOverviewWalletSection(context) {
     const lines = [
         overviewEntry(`State: ${context.localState.availability}`, context.localState.availability === "ready"),
         overviewEntry(`Root: ${walletRoot}`, walletRoot !== "none"),
-        overviewEntry(`Unlock: ${formatUnlockExpiry(context.localState.unlockUntilUnixMs)}`, context.localState.unlockUntilUnixMs !== null),
     ];
     if (context.localState.message !== null) {
         lines.push(overviewEntry(`Note: ${context.localState.message}`, false));
@@ -422,28 +402,17 @@ function buildOverviewLocalInventorySection(context) {
         return [overviewEntry("Status: Wallet-derived sections unavailable", false)];
     }
     return [
-        overviewEntry(`Local identities: ${context.model.identities.length}`, true),
+        overviewEntry("Local wallet address: 1", true),
         overviewEntry(`Locally related domains: ${context.model.domains.length}`, true),
-        overviewEntry(`Read-only identities: ${context.model.readOnlyIdentityCount}`, true),
     ];
 }
 function buildOverviewPendingWorkSection(context) {
-    const pendingFamilies = (context.localState.state?.proactiveFamilies ?? [])
-        .filter((family) => (family.type === "anchor" || family.type === "field")
-        && family.status !== "confirmed"
-        && family.status !== "canceled");
     const pendingMutations = (context.localState.state?.pendingMutations ?? [])
         .filter((mutation) => mutation.status !== "confirmed" && mutation.status !== "canceled");
-    if (pendingFamilies.length === 0 && pendingMutations.length === 0) {
+    if (pendingMutations.length === 0) {
         return [overviewEntry("Status: none", true)];
     }
     const lines = [];
-    for (const family of pendingFamilies) {
-        const label = family.type === "field"
-            ? `Field family: ${family.domainName ?? "unknown"}.${family.fieldName ?? "unknown"}`
-            : `Anchor family: ${family.domainName ?? "unknown"}`;
-        lines.push(overviewEntry(`${label}  ${family.status}${family.currentStep === null || family.currentStep === undefined ? "" : `  step ${family.currentStep}`}${family.reservedDedicatedIndex == null ? "" : `  index ${family.reservedDedicatedIndex}`}`, false));
-    }
     for (const mutation of pendingMutations) {
         lines.push(overviewEntry(`Mutation: ${formatPendingMutationSummaryLabel(mutation)}  ${mutation.status}  sender spk:${mutation.senderScriptPubKeyHex}${mutation.priceCogtoshi === undefined || mutation.priceCogtoshi === null ? "" : `  price ${formatCogAmount(mutation.priceCogtoshi)}`}${mutation.amountCogtoshi === undefined || mutation.amountCogtoshi === null ? "" : `  amount ${formatCogAmount(mutation.amountCogtoshi)}`}${isReputationMutation(mutation) ? "" : mutation.recipientDomainName === undefined || mutation.recipientDomainName === null ? "" : `  domain ${mutation.recipientDomainName}`}${mutation.lockId === undefined || mutation.lockId === null ? "" : `  lock ${mutation.lockId}`}${mutation.recipientScriptPubKeyHex === undefined || mutation.recipientScriptPubKeyHex === null ? "" : `  recipient spk:${mutation.recipientScriptPubKeyHex}`}${mutation.kind === "endpoint" ? (mutation.endpointValueHex === "" ? "  endpoint clear" : `  endpoint-bytes ${(mutation.endpointValueHex?.length ?? 0) / 2}`) : ""}${mutation.kind === "field-create" || mutation.kind === "field-set" ? `  format ${formatFieldFormat(mutation.fieldFormat ?? 0)}` : ""}${mutation.kind === "field-clear" ? "  clear" : ""}${mutation.reviewPayloadHex === undefined || mutation.reviewPayloadHex === null ? "" : "  review"}`, false));
     }
@@ -454,6 +423,10 @@ function getOverviewNextStep(context) {
     if (repairRecommendation !== null) {
         return repairRecommendation;
     }
+    const clientUnlockRecommendation = getClientUnlockRecommendation(context);
+    if (clientUnlockRecommendation !== null) {
+        return clientUnlockRecommendation;
+    }
     if (getBootstrapSyncNextStep(context) !== null) {
         return "Run `cogcoin sync` to bootstrap assumeutxo and the managed Bitcoin/indexer state.";
     }
@@ -482,46 +455,178 @@ export function formatDetailedWalletStatusReport(context) {
         lines.push("Wallet details are unavailable until the encrypted wallet state can be read.");
         return lines.join("\n");
     }
-    lines.push(`Funding identity: ${context.model.fundingIdentity?.selectors[0] ?? "unavailable"}`);
-    lines.push(`Funding address: ${context.model.fundingIdentity?.address ?? "unavailable"}`);
-    lines.push(`Controlled identities: ${context.model.identities.length}`);
+    lines.push(`Wallet address: ${context.model.walletAddress ?? "unavailable"}`);
+    lines.push(`Wallet script: spk:${context.model.walletScriptPubKeyHex ?? "unavailable"}`);
+    lines.push("Local wallet addresses: 1");
     lines.push(`Locally related domains: ${context.model.domains.length}`);
-    lines.push(`Read-only identities: ${context.model.readOnlyIdentityCount}`);
     appendPendingMutationSummary(lines, context);
     return lines.join("\n");
 }
 export function formatFundingAddressReport(context) {
-    const lines = ["BTC Funding Address"];
-    if (context.model?.fundingIdentity === null || context.model === null) {
+    const lines = ["BTC Wallet Address"];
+    if (context.model === null) {
         appendWalletAvailability(lines, context);
         return lines.join("\n");
     }
-    lines.push(`Selector: ${context.model.fundingIdentity.selectors[0]}`);
-    lines.push(`Address: ${context.model.fundingIdentity.address ?? "unavailable"}`);
-    lines.push(`ScriptPubKey: spk:${context.model.fundingIdentity.scriptPubKeyHex}`);
+    lines.push(`Address: ${context.model.walletAddress ?? "unavailable"}`);
+    lines.push(`ScriptPubKey: spk:${context.model.walletScriptPubKeyHex}`);
+    return lines.join("\n");
+}
+function renderBalanceArtLine(templateLine, label, value) {
+    const labelIndex = templateLine.indexOf(label);
+    if (labelIndex === -1) {
+        throw new Error(`balance_art_label_missing_${label}`);
+    }
+    const fieldStart = labelIndex + label.length;
+    const borderIndex = Math.max(templateLine.lastIndexOf("│"), templateLine.lastIndexOf("|"));
+    if (borderIndex <= fieldStart) {
+        throw new Error(`balance_art_field_invalid_${label}`);
+    }
+    const fieldWidth = borderIndex - fieldStart;
+    const fieldValue = value.slice(0, fieldWidth).padEnd(fieldWidth, " ");
+    const rendered = `${templateLine.slice(0, fieldStart)}${fieldValue}${templateLine.slice(borderIndex)}`;
+    if (rendered.length !== templateLine.length) {
+        throw new Error(`balance_art_render_width_invalid_${label}`);
+    }
+    return rendered;
+}
+function renderBalanceArtCard(context) {
+    const templateLines = loadBalanceArtText().split("\n");
+    const fundingAddress = context.model.walletAddress ?? "unavailable";
+    const spendableCog = getBalance(context.snapshot.state, new Uint8Array(Buffer.from(context.model.walletScriptPubKeyHex, "hex")));
+    return templateLines.map((line) => {
+        if (line.includes("Funding address:")) {
+            return renderBalanceArtLine(line, "Funding address:", ` ${fundingAddress}`);
+        }
+        if (line.includes("Bitcoin Balance:")) {
+            return renderBalanceArtLine(line, "Bitcoin Balance:", ` ${formatBitcoinAmount(context.fundingSpendableSats ?? null)}`);
+        }
+        if (line.includes("Cogcoin Balance:")) {
+            return renderBalanceArtLine(line, "Cogcoin Balance:", ` ${formatCogAmount(spendableCog)}`);
+        }
+        if (line.includes("mempool.space/address/")) {
+            return renderBalanceArtLine(line, "mempool.space/address/", fundingAddress);
+        }
+        return line;
+    });
+}
+function hasRegisteredOrAnchoredDomain(model) {
+    return model.domains.some((domain) => domain.localRelationship === "local"
+        && (domain.chainStatus === "registered-unanchored" || domain.chainStatus === "anchored"));
+}
+function listBalanceDomainsByStatus(model, status) {
+    return model.domains
+        .filter((domain) => domain.localRelationship === "local" && domain.chainStatus === status)
+        .sort((left, right) => left.name.localeCompare(right.name));
+}
+function shouldShowBalanceQuickstart(context) {
+    return context.fundingSpendableSats !== null
+        && context.fundingSpendableSats < BALANCE_QUICKSTART_THRESHOLD_SATS
+        && !hasRegisteredOrAnchoredDomain(context.model);
+}
+function formatBalanceDomainSection(title, icon, domains, emptyLabel) {
+    const domainItems = domains.map((domain) => `${icon} ${domain.name}`);
+    const wrappedDomainLines = [];
+    let currentLine = "";
+    for (const item of domainItems) {
+        const candidate = currentLine.length === 0 ? item : `${currentLine}, ${item}`;
+        if (candidate.length <= 80) {
+            currentLine = candidate;
+            continue;
+        }
+        if (currentLine.length > 0) {
+            wrappedDomainLines.push(currentLine);
+        }
+        currentLine = item;
+    }
+    if (currentLine.length > 0) {
+        wrappedDomainLines.push(currentLine);
+    }
+    return [
+        title,
+        ...(domains.length === 0
+            ? [emptyLabel]
+            : wrappedDomainLines),
+    ];
+}
+function getBalanceNextSteps(context) {
+    const anchoredDomains = listBalanceDomainsByStatus(context.model, "anchored");
+    const anchoredRootDomains = anchoredDomains.filter((domain) => isRootDomainName(domain.name));
+    const unanchoredDomains = listBalanceDomainsByStatus(context.model, "registered-unanchored");
+    if (anchoredRootDomains.length > 0) {
+        if (context.fundingSpendableSats !== null && context.fundingSpendableSats < BALANCE_MINING_THRESHOLD_SATS) {
+            return [`Transfer BTC to ${context.model.walletAddress ?? "this wallet address"} so your anchored root domain can keep mining.`];
+        }
+        if (context.fundingSpendableSats !== null && context.fundingSpendableSats > BALANCE_MINING_THRESHOLD_SATS) {
+            if (context.mining?.provider.status === "missing") {
+                return ["Run `cogcoin mine setup` to configure your mining provider."];
+            }
+            return ["Run `cogcoin mine` to start mining with your anchored root domain."];
+        }
+        return [];
+    }
+    if (unanchoredDomains.length > 0) {
+        return [`Run \`cogcoin anchor ${unanchoredDomains[0].name}\` to anchor your unanchored domain.`];
+    }
+    if (context.fundingSpendableSats !== null && context.fundingSpendableSats > BALANCE_BUY_ROOT_THRESHOLD_SATS) {
+        return ["Buy a 6+ character root domain with `cogcoin register <root>`."];
+    }
+    return [];
+}
+function listPendingBalanceLines(context) {
+    const lines = [];
+    for (const mutation of (context.localState.state?.pendingMutations ?? [])
+        .filter((entry) => (entry.kind === "send" || entry.kind === "lock" || entry.kind === "claim")
+        && entry.status !== "confirmed"
+        && entry.status !== "canceled")) {
+        const label = mutation.kind === "claim" && mutation.preimageHex === "0000000000000000000000000000000000000000000000000000000000000000"
+            ? "reclaim"
+            : mutation.kind;
+        lines.push(`Pending: ${label}  ${mutation.status}${mutation.amountCogtoshi === null || mutation.amountCogtoshi === undefined ? "" : `  ${formatCogAmount(mutation.amountCogtoshi)}`}`);
+    }
+    return lines;
+}
+function formatReadyBalanceReport(context) {
+    const anchoredDomains = listBalanceDomainsByStatus(context.model, "anchored");
+    const unanchoredDomains = listBalanceDomainsByStatus(context.model, "registered-unanchored");
+    const nextStepLines = formatNextStepLines(getBalanceNextSteps(context));
+    const lines = [
+        "",
+        ...renderBalanceArtCard(context),
+        "",
+        ...formatBalanceDomainSection("Anchored Domains", "⌂", anchoredDomains, "--- No anchored domains ---"),
+        "",
+        ...formatBalanceDomainSection("Unanchored Domains", "~", unanchoredDomains, "--- No unanchored domains ---"),
+    ];
+    if (shouldShowBalanceQuickstart(context)) {
+        lines.push("");
+        lines.push(`Quickstart: ${getFundingQuickstartGuidance()}`);
+    }
+    if (nextStepLines.length > 0) {
+        lines.push("");
+        lines.push(...nextStepLines);
+    }
+    const pendingLines = listPendingBalanceLines(context);
+    if (pendingLines.length > 0) {
+        lines.push("");
+        lines.push(...pendingLines);
+    }
     return lines.join("\n");
 }
 export function formatIdentityListReport(context, options = {}) {
-    const lines = ["Wallet Identities"];
+    const lines = ["Wallet Address"];
     if (context.model === null) {
         appendWalletAvailability(lines, context);
         return lines.join("\n");
     }
-    const identities = context.model.identities;
-    if (identities.length === 0) {
-        lines.push("No local identities are recorded yet.");
-        return lines.join("\n");
-    }
-    const limit = options.all ? null : options.limit ?? null;
-    const renderedIdentities = limit === null ? identities : identities.slice(0, limit);
-    for (const identity of renderedIdentities) {
-        const domains = identity.ownedDomainNames.length === 0 ? "none" : identity.ownedDomainNames.join(", ");
-        const balance = identity.observedCogBalance === null ? "unavailable" : formatCogAmount(identity.observedCogBalance);
-        lines.push(`${identity.selectors[0]}  ${identity.effectiveStatus}  ${identity.address ?? `spk:${identity.scriptPubKeyHex}`}  balance ${balance}  domains ${domains}  selectors ${identity.selectors.join(", ")}`);
-    }
-    if (limit !== null && identities.length > limit) {
-        lines.push(`Showing first ${renderedIdentities.length} of ${identities.length}. Use --limit <n> or --all for more.`);
-    }
+    const domains = context.model.domains
+        .filter((domain) => domain.localRelationship === "local")
+        .map((domain) => domain.name)
+        .sort();
+    const balance = context.snapshot === null
+        ? null
+        : getBalance(context.snapshot.state, new Uint8Array(Buffer.from(context.model.walletScriptPubKeyHex, "hex")));
+    lines.push(`${context.model.walletAddress ?? `spk:${context.model.walletScriptPubKeyHex}`}  balance ${balance === null ? "unavailable" : formatCogAmount(balance)}  domains ${domains.length === 0 ? "none" : domains.join(", ")}`);
     return lines.join("\n");
 }
 export function formatBalanceReport(context) {
@@ -534,23 +639,7 @@ export function formatBalanceReport(context) {
         lines.push(`Indexer-backed balances are unavailable while the indexer is ${formatServiceHealth(context.indexer.health)}.`);
         return lines.join("\n");
     }
-    const spendableTotal = context.model.identities.reduce((sum, identity) => identity.readOnly || identity.observedCogBalance === null
-        ? sum
-        : sum + identity.observedCogBalance, 0n);
-    lines.push(`Spendable total: ${formatCogAmount(spendableTotal)}`);
-    for (const identity of context.model.identities) {
-        lines.push(`${identity.selectors[0]}  ${identity.address ?? `spk:${identity.scriptPubKeyHex}`}  ${formatCogAmount(identity.observedCogBalance ?? 0n)}${identity.readOnly ? "  read-only" : ""}`);
-    }
-    for (const mutation of (context.localState.state?.pendingMutations ?? [])
-        .filter((entry) => (entry.kind === "send" || entry.kind === "lock" || entry.kind === "claim")
-        && entry.status !== "confirmed"
-        && entry.status !== "canceled")) {
-        const label = mutation.kind === "claim" && mutation.preimageHex === "0000000000000000000000000000000000000000000000000000000000000000"
-            ? "reclaim"
-            : mutation.kind;
-        lines.push(`Pending: ${label}  ${mutation.status}${mutation.amountCogtoshi === null || mutation.amountCogtoshi === undefined ? "" : `  ${formatCogAmount(mutation.amountCogtoshi)}`}`);
-    }
-    return lines.join("\n");
+    return formatReadyBalanceReport(context);
 }
 export function formatLocksReport(context, options = {}) {
     const lines = ["COG Locks"];
@@ -621,8 +710,6 @@ export function formatDomainsReport(context, options = {}) {
         : visibleDomains.slice(0, options.limit);
     for (const domain of renderedDomains) {
         const pending = listPendingDomainMutations(context, domain.name);
-        const pendingAnchors = listPendingAnchorFamilies(context, domain.name);
-        const pendingFieldFamilies = listPendingFieldFamilies(context, domain.name);
         const pendingFieldMutations = listPendingFieldMutations(context, domain.name);
         const pendingText = pending.length === 0
             ? ""
@@ -635,18 +722,10 @@ export function formatDomainsReport(context, options = {}) {
                         : mutation.kind === "miner" && mutation.recipientScriptPubKeyHex === null
                             ? `miner-clear:${mutation.status}`
                             : `${mutation.kind}:${mutation.status}`).join(",")}`;
-        const pendingFieldsText = pendingFieldMutations.length === 0 && pendingFieldFamilies.length === 0
-            ? ""
-            : `  field-pending ${[
-                ...pendingFieldMutations.map((mutation) => `${mutation.fieldName}:${mutation.kind}:${mutation.status}`),
-                ...pendingFieldFamilies.map((family) => `${family.fieldName}:family:${family.status}${family.currentStep == null ? "" : `:${family.currentStep}`}`),
-            ].join(",")}`;
-        const anchorText = pendingAnchors.length === 0 && (domain.localAnchorIntent === null || domain.localAnchorIntent === "none")
+        const pendingFieldsText = pendingFieldMutations.length === 0
             ? ""
-            : `  anchor ${(domain.localAnchorIntent === null || domain.localAnchorIntent === "none")
-                ? pendingAnchors.map((family) => `${family.currentStep ?? "reserved"}:${family.status}`).join(",")
-                : domain.localAnchorIntent}`;
-        lines.push(`${domain.name}  ${domain.chainStatus}  ${domain.localRelationship}  owner ${domain.ownerLocalIndex === null ? (domain.ownerAddress ?? domain.ownerScriptPubKeyHex ?? "unknown") : `id:${domain.ownerLocalIndex}`}  fields ${formatMaybe(domain.fieldCount)}${domain.readOnly ? "  read-only" : ""}${anchorText}${pendingText}${pendingFieldsText}`);
+            : `  field-pending ${pendingFieldMutations.map((mutation) => `${mutation.fieldName}:${mutation.kind}:${mutation.status}`).join(",")}`;
+        lines.push(`${domain.name}  ${domain.chainStatus}  ${domain.localRelationship}  owner ${domain.ownerAddress ?? domain.ownerScriptPubKeyHex ?? "unknown"}  fields ${formatMaybe(domain.fieldCount)}${pendingText}${pendingFieldsText}`);
     }
     if (!options.all && options.limit !== null && options.limit !== undefined && visibleDomains.length > options.limit) {
         lines.push(`Showing first ${renderedDomains.length} of ${visibleDomains.length}. Use --limit <n> or --all for more.`);
@@ -666,7 +745,7 @@ export function formatDomainReport(context, domainName) {
     }
     lines.push(`Domain ID: ${formatMaybe(view.domain.domainId)}`);
     lines.push(`Anchored: ${view.domain.anchored === null ? "unknown" : (view.domain.anchored ? "yes" : "no")}`);
-    lines.push(`Owner: ${view.domain.ownerLocalIndex === null ? (view.domain.ownerAddress ?? view.domain.ownerScriptPubKeyHex ?? "unknown") : `id:${view.domain.ownerLocalIndex}`}`);
+    lines.push(`Owner: ${view.domain.ownerAddress ?? view.domain.ownerScriptPubKeyHex ?? "unknown"}`);
     lines.push(`Local relationship: ${view.localRelationship}`);
     lines.push(`Listing price: ${view.domain.listingPriceCogtoshi === null ? "none" : formatCogAmount(view.domain.listingPriceCogtoshi)}`);
     lines.push(`Field count: ${formatMaybe(view.domain.fieldCount)}`);
@@ -679,17 +758,10 @@ export function formatDomainReport(context, domainName) {
         lines.push(`Reputation total supported: ${view.domain.totalSupportedCogtoshi === null ? "unavailable" : formatCogAmount(view.domain.totalSupportedCogtoshi)}`);
         lines.push(`Reputation total revoked: ${view.domain.totalRevokedCogtoshi === null ? "unavailable" : formatCogAmount(view.domain.totalRevokedCogtoshi)}`);
     }
-    lines.push(`Local anchor intent: ${view.domain.localAnchorIntent ?? "none"}`);
     lines.push(`Delegate: ${view.domain.delegateScriptPubKeyHex ?? "none"}`);
     lines.push(`Designated miner: ${view.domain.minerScriptPubKeyHex ?? "none"}`);
     lines.push(`Endpoint: ${view.domain.endpointText ?? "none"}`);
     lines.push(`Founding message: ${view.domain.foundingMessageText ?? "none"}`);
-    for (const family of listPendingAnchorFamilies(context, domainName)) {
-        lines.push(`Pending anchor family: ${family.status}${family.currentStep == null ? "" : `  step ${family.currentStep}`}${family.reservedDedicatedIndex == null ? "" : `  index ${family.reservedDedicatedIndex}`}`);
-    }
-    for (const family of listPendingFieldFamilies(context, domainName)) {
-        lines.push(`Pending field family: ${family.fieldName ?? "unknown"}  ${family.status}${family.currentStep == null ? "" : `  step ${family.currentStep}`}`);
-    }
     for (const mutation of listPendingDomainShowMutations(context, domainName)) {
         lines.push(`Pending mutation: ${formatPendingMutationDomainLabel(mutation)}  ${mutation.status}`);
     }
@@ -726,9 +798,6 @@ export function formatFieldsReport(context, domainName, options = {}) {
     for (const mutation of listPendingFieldMutations(context, domainName)) {
         lines.push(`Pending field mutation: ${mutation.fieldName ?? "unknown"}  ${mutation.kind}  ${mutation.status}`);
     }
-    for (const family of listPendingFieldFamilies(context, domainName)) {
-        lines.push(`Pending field family: ${family.fieldName ?? "unknown"}  ${family.status}${family.currentStep == null ? "" : `  step ${family.currentStep}`}`);
-    }
     if (!options.all && options.limit !== null && options.limit !== undefined && fields.length > options.limit) {
         lines.push(`Showing first ${renderedFields.length} of ${fields.length}. Use --limit <n> or --all for more.`);
     }
@@ -742,8 +811,6 @@ export function formatFieldReport(context, domainName, fieldName) {
     }
     const field = findDomainField(context, domainName, fieldName);
     const pendingMutations = listPendingFieldMutations(context, domainName, fieldName);
-    const pendingFamilies = listPendingFieldFamilies(context, domainName)
-        .filter((family) => family.fieldName === fieldName);
     if (field === null) {
         lines.push("Field not found.");
     }
@@ -759,8 +826,5 @@ export function formatFieldReport(context, domainName, fieldName) {
     for (const mutation of pendingMutations) {
         lines.push(`Pending field mutation: ${mutation.kind}  ${mutation.status}`);
     }
-    for (const family of pendingFamilies) {
-        lines.push(`Pending field family: ${family.status}${family.currentStep == null ? "" : `  step ${family.currentStep}`}`);
-    }
     return lines.join("\n");
 }

package/dist/cli/workflow-hints.d.ts

@@ -1,14 +1,14 @@
-import type { WalletIdentityView, WalletLockView, WalletReadContext } from "../wallet/read/index.js";
+import type { WalletLockView, WalletReadContext } from "../wallet/read/index.js";
 export declare function formatNextStepLines(nextSteps: readonly string[]): string[];
 export declare function getFundingQuickstartGuidance(): string;
 export declare function getInitNextSteps(): string[];
 export declare function getRestoreNextSteps(): string[];
+export declare function getSetupUnlockGuidanceLines(unlockSeconds: number): string[];
 export declare function getBootstrapSyncNextStep(context: Pick<WalletReadContext, "bitcoind" | "indexer" | "nodeHealth">): string | null;
 export declare function getRegisterNextSteps(domainName: string, registerKind: "root" | "subdomain"): string[];
 export declare function getAnchorNextSteps(domainName: string): string[];
-export declare function getHooksEnableMiningNextSteps(): string[];
 export declare function getMineSetupNextSteps(): string[];
 export declare function getMineStopNextSteps(): string[];
 export declare function getAddressNextSteps(context: Pick<WalletReadContext, "bitcoind" | "indexer" | "nodeHealth">, address: string | null | undefined): string[];
-export declare function getIdsNextSteps(identities: readonly WalletIdentityView[] | null | undefined): string[];
+export declare function getIdsNextSteps(walletAddress: string | null | undefined): string[];
 export declare function getLocksNextSteps(locks: readonly WalletLockView[] | null | undefined): string[];

package/dist/cli/workflow-hints.js

@@ -13,6 +13,12 @@ export function getInitNextSteps() {
 export function getRestoreNextSteps() {
     return ["cogcoin sync", "cogcoin address"];
 }
+export function getSetupUnlockGuidanceLines(unlockSeconds) {
+    return [
+        `Client unlock: active for ${unlockSeconds} seconds.`,
+        "Use `cogcoin client unlock` to lengthen this unlock window, or `cogcoin client lock` to lock immediately.",
+    ];
+}
 function blocksSyncBootstrap(context) {
     return context.bitcoind.health === "service-version-mismatch"
         || context.bitcoind.health === "wallet-root-mismatch"
@@ -50,9 +56,6 @@ export function getAnchorNextSteps(domainName) {
     }
     return nextSteps;
 }
-export function getHooksEnableMiningNextSteps() {
-    return ["cogcoin mine", "cogcoin mine start"];
-}
 export function getMineSetupNextSteps() {
     return ["cogcoin mine", "cogcoin mine start"];
 }
@@ -71,13 +74,13 @@ export function getAddressNextSteps(context, address) {
     nextSteps.push("fund this wallet, then run cogcoin status");
     return nextSteps;
 }
-export function getIdsNextSteps(identities) {
-    return identities === null || identities === undefined || identities.length === 0
+export function getIdsNextSteps(walletAddress) {
+    return walletAddress === null || walletAddress === undefined || walletAddress.length === 0
         ? []
         : [
-            "cogcoin register <root> --from <selector>",
-            "cogcoin send ... --from <selector>",
-            "cogcoin cog lock ... --from <selector>",
+            "cogcoin register <root>",
+            "cogcoin send ...",
+            "cogcoin cog lock ...",
         ];
 }
 export function getLocksNextSteps(locks) {

package/dist/client/default-client.d.ts

@@ -1,5 +1,5 @@
 import type { BitcoinBlock, GenesisParameters, IndexerState } from "@cogcoin/indexer/types";
-import type { ApplyBlockResult, Client, ClientStoreAdapter, ClientTip } from "../types.js";
+import type { ApplyBlockResult, Client, ClientCheckpoint, ClientStoreAdapter, ClientTip } from "../types.js";
 export declare class DefaultClient implements Client {
     #private;
     constructor(store: ClientStoreAdapter, genesisParameters: GenesisParameters, state: IndexerState, tip: ClientTip | null, snapshotInterval: number, blockRecordRetention: number);
@@ -7,5 +7,7 @@ export declare class DefaultClient implements Client {
     getState(): Promise<IndexerState>;
     applyBlock(block: BitcoinBlock): Promise<ApplyBlockResult>;
     rewindToHeight(height: number): Promise<ClientTip | null>;
+    restoreCheckpoint(checkpoint: ClientCheckpoint): Promise<ClientTip>;
+    resetToInitialState(): Promise<null>;
     close(): Promise<void>;
 }