@cogcoin/client 1.1.8 → 1.1.10

package/dist/wallet/read/managed-services.js

@@ -1,14 +1,10 @@
-import { deserializeIndexerState, loadBundledGenesisParameters } from "@cogcoin/indexer";
+import { loadBundledGenesisParameters } from "@cogcoin/indexer";
 import { attachOrStartIndexerDaemon, INDEXER_DAEMON_BACKGROUND_FOLLOW_RECOVERY_FAILED, probeIndexerDaemon, readObservedIndexerDaemonStatus, readSnapshotWithRetry, } from "../../bitcoind/indexer-daemon.js";
-import { deriveManagedBitcoindWalletStatus, resolveManagedBitcoindProbeDecision, } from "../../bitcoind/managed-runtime/bitcoind-policy.js";
-import { deriveManagedIndexerWalletStatus, resolveIndexerDaemonProbeDecision, } from "../../bitcoind/managed-runtime/indexer-policy.js";
 import { createRpcClient } from "../../bitcoind/node.js";
-import { resolveCogcoinProcessingStartHeight } from "../../bitcoind/processing-start-height.js";
 import { attachOrStartManagedBitcoindService, probeManagedBitcoindService, } from "../../bitcoind/service.js";
 import { verifyManagedCoreWalletReplica } from "../lifecycle.js";
-const TOLERATED_NODE_HEADER_LEAD_BLOCKS = 2;
-const TOLERATED_NODE_HEADER_LEAD_MESSAGE = "Bitcoin headers can briefly lead validated blocks; a short 1-2 block lead is normal and is being tolerated.";
-const NODE_CATCHING_UP_MESSAGE = "Bitcoin Core is still catching up to headers.";
+import { deriveNodeHealthForTesting, openManagedWalletBitcoindReadState, } from "./managed-bitcoind.js";
+import { openManagedWalletIndexerReadState, } from "./managed-indexer.js";
 const defaultManagedWalletReadServiceDeps = {
     loadBundledGenesisParameters,
     probeManagedBitcoindService,
@@ -20,203 +16,34 @@ const defaultManagedWalletReadServiceDeps = {
     readSnapshotWithRetry,
     readObservedIndexerDaemonStatus,
 };
-function deriveNodeHealth(status, bitcoindHealth) {
-    if (bitcoindHealth !== "ready" || status === null || !status.ready) {
-        return {
-            health: "catching-up",
-            message: NODE_CATCHING_UP_MESSAGE,
-        };
-    }
-    const headerLead = status.nodeBestHeight !== null && status.nodeHeaderHeight !== null
-        ? status.nodeHeaderHeight - status.nodeBestHeight
-        : null;
-    if (headerLead !== null && headerLead > 0) {
-        if (headerLead <= TOLERATED_NODE_HEADER_LEAD_BLOCKS) {
-            return {
-                health: "synced",
-                message: TOLERATED_NODE_HEADER_LEAD_MESSAGE,
-            };
-        }
-        return {
-            health: "catching-up",
-            message: NODE_CATCHING_UP_MESSAGE,
-        };
-    }
-    return {
-        health: "synced",
-        message: null,
-    };
-}
-export function deriveNodeHealthForTesting(status, bitcoindHealth) {
-    return deriveNodeHealth(status, bitcoindHealth);
-}
-async function attachNodeStatus(options, dependencies) {
-    try {
-        const probe = await dependencies.probeManagedBitcoindService({
-            dataDir: options.dataDir,
-            chain: "main",
-            startHeight: 0,
-            walletRootId: options.walletRootId,
-            startupTimeoutMs: options.startupTimeoutMs,
-        });
-        const decision = resolveManagedBitcoindProbeDecision(probe);
-        if (decision.action === "reject") {
-            return {
-                handle: null,
-                rpc: null,
-                status: null,
-                observedStatus: probe.status,
-                error: decision.error,
-            };
-        }
-        const genesis = await dependencies.loadBundledGenesisParameters();
-        const handle = await dependencies.attachOrStartManagedBitcoindService({
-            dataDir: options.dataDir,
-            chain: "main",
-            startHeight: resolveCogcoinProcessingStartHeight(genesis),
-            walletRootId: options.walletRootId,
-            startupTimeoutMs: options.startupTimeoutMs,
-        });
-        const rpc = dependencies.createRpcClient(handle.rpc);
-        const [chainInfo, serviceStatus] = await Promise.all([
-            rpc.getBlockchainInfo(),
-            handle.refreshServiceStatus?.(),
-        ]);
-        const status = {
-            ready: true,
-            chain: chainInfo.chain,
-            pid: handle.pid,
-            walletRootId: handle.walletRootId ?? null,
-            nodeBestHeight: chainInfo.blocks,
-            nodeBestHashHex: chainInfo.bestblockhash,
-            nodeHeaderHeight: chainInfo.headers,
-            serviceUpdatedAtUnixMs: serviceStatus?.updatedAtUnixMs ?? null,
-            serviceStatus: serviceStatus ?? null,
-            walletReplica: serviceStatus?.walletReplica ?? null,
-            walletReplicaMessage: serviceStatus?.walletReplica?.message ?? null,
-        };
-        return {
-            handle,
-            rpc,
-            status,
-            observedStatus: serviceStatus ?? null,
-            error: null,
-        };
-    }
-    catch (error) {
-        return {
-            handle: null,
-            rpc: null,
-            status: null,
-            observedStatus: null,
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-}
 export async function openManagedWalletReadServiceBundle(options, dependencies = defaultManagedWalletReadServiceDeps) {
-    const node = await attachNodeStatus({
+    const bitcoindState = await openManagedWalletBitcoindReadState({
         dataDir: options.dataDir,
         walletRootId: options.walletRootId,
+        localState: options.localState,
         startupTimeoutMs: options.startupTimeoutMs,
     }, dependencies);
-    if (options.localState.state !== null && node.status !== null) {
-        const verifiedReplica = await dependencies.verifyManagedCoreWalletReplica(options.localState.state, options.dataDir, {
-            nodeHandle: node.handle ?? undefined,
-        });
-        node.status = {
-            ...node.status,
-            walletReplica: verifiedReplica,
-            walletReplicaMessage: verifiedReplica.message ?? null,
-        };
-    }
-    const bitcoind = deriveManagedBitcoindWalletStatus({
-        status: node.observedStatus,
-        nodeStatus: node.status,
-        startupError: node.error,
-    });
-    const nodeDerived = deriveNodeHealth(node.status, bitcoind.health);
-    let daemonClient = null;
-    let daemonStatus = null;
-    let observedDaemonStatus = null;
-    let snapshot = null;
-    let indexerSource = "none";
-    let daemonError = null;
-    try {
-        const probe = await dependencies.probeIndexerDaemon({
-            dataDir: options.dataDir,
-            walletRootId: options.walletRootId,
-        });
-        const probeDecision = resolveIndexerDaemonProbeDecision({
-            probe,
-            expectedBinaryVersion: options.expectedIndexerBinaryVersion,
-        });
-        if (probeDecision.action !== "reject") {
-            await probe.client?.close().catch(() => undefined);
-            daemonClient = await dependencies.attachOrStartIndexerDaemon({
-                dataDir: options.dataDir,
-                databasePath: options.databasePath,
-                walletRootId: options.walletRootId,
-                startupTimeoutMs: options.startupTimeoutMs,
-                ensureBackgroundFollow: true,
-                expectedBinaryVersion: options.expectedIndexerBinaryVersion,
-            });
-        }
-        else {
-            observedDaemonStatus = probe.status;
-            indexerSource = probe.status === null ? "none" : "probe";
-            daemonError = probeDecision.error;
-        }
-        if (daemonClient !== null) {
-            const lease = await dependencies.readSnapshotWithRetry(daemonClient, options.walletRootId);
-            daemonStatus = lease.status;
-            observedDaemonStatus = lease.status;
-            snapshot = {
-                tip: lease.payload.tip,
-                state: deserializeIndexerState(Buffer.from(lease.payload.stateBase64, "base64")),
-                source: "lease",
-                daemonInstanceId: lease.payload.daemonInstanceId,
-                snapshotSeq: lease.payload.snapshotSeq,
-                openedAtUnixMs: lease.payload.openedAtUnixMs,
-            };
-            indexerSource = "lease";
-        }
-    }
-    catch (error) {
-        daemonError = error instanceof Error ? error.message : String(error);
-        if (daemonError === INDEXER_DAEMON_BACKGROUND_FOLLOW_RECOVERY_FAILED) {
-            await daemonClient?.close().catch(() => undefined);
-            await node.handle?.stop().catch(() => undefined);
-            throw error;
-        }
-        if (observedDaemonStatus === null) {
-            observedDaemonStatus = await dependencies.readObservedIndexerDaemonStatus({
-                dataDir: options.dataDir,
-                walletRootId: options.walletRootId,
-            }).catch(() => null);
-            if (observedDaemonStatus !== null) {
-                indexerSource = "status-file";
-            }
-        }
-    }
-    const indexer = deriveManagedIndexerWalletStatus({
-        daemonStatus,
-        observedStatus: observedDaemonStatus,
-        snapshot,
-        source: indexerSource,
+    const indexerState = await openManagedWalletIndexerReadState({
+        dataDir: options.dataDir,
+        databasePath: options.databasePath,
+        walletRootId: options.walletRootId,
+        startupTimeoutMs: options.startupTimeoutMs,
+        expectedIndexerBinaryVersion: options.expectedIndexerBinaryVersion,
         now: options.now,
-        startupError: daemonError,
-    });
+        nodeHandle: bitcoindState.node.handle,
+    }, dependencies);
     return {
-        node,
-        bitcoind,
-        nodeHealth: nodeDerived.health,
-        nodeMessage: nodeDerived.message,
-        daemonClient,
-        indexer,
-        snapshot,
+        node: bitcoindState.node,
+        bitcoind: bitcoindState.bitcoind,
+        nodeHealth: bitcoindState.nodeHealth,
+        nodeMessage: bitcoindState.nodeMessage,
+        daemonClient: indexerState.daemonClient,
+        indexer: indexerState.indexer,
+        snapshot: indexerState.snapshot,
         async close() {
-            await daemonClient?.close().catch(() => undefined);
-            await node.handle?.stop().catch(() => undefined);
+            await indexerState.daemonClient?.close().catch(() => undefined);
+            await bitcoindState.node.handle?.stop().catch(() => undefined);
         },
     };
 }
+export { deriveNodeHealthForTesting };

package/dist/wallet/tx/anchor/confirm.d.ts

@@ -0,0 +1,15 @@
+import type { WalletPrompter } from "../../lifecycle.js";
+export interface AnchorFoundingMessage {
+    text: string | null;
+    payloadHex: string | null;
+}
+export declare function resolveFoundingMessage(options: {
+    foundingMessageText: string | null | undefined;
+    promptForFoundingMessageWhenMissing?: boolean;
+    prompter: WalletPrompter;
+}): Promise<AnchorFoundingMessage>;
+export declare function confirmDirectAnchor(prompter: WalletPrompter, options: {
+    domainName: string;
+    walletAddress: string;
+    foundingMessageText: string | null;
+}): Promise<void>;

package/dist/wallet/tx/anchor/confirm.js

@@ -0,0 +1,60 @@
+import { encodeSentence } from "@cogcoin/scoring";
+function encodeFoundingMessage(foundingMessageText) {
+    const trimmed = foundingMessageText?.trim() ?? "";
+    if (trimmed === "") {
+        return Promise.resolve({
+            text: null,
+            payloadHex: null,
+        });
+    }
+    return encodeSentence(trimmed)
+        .then((payload) => ({
+        text: trimmed,
+        payloadHex: Buffer.from(payload).toString("hex"),
+    }))
+        .catch((error) => {
+        throw new Error(error instanceof Error ? `wallet_anchor_invalid_message_${error.message}` : "wallet_anchor_invalid_message");
+    });
+}
+function extractAnchorInvalidMessageReason(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (message === "wallet_anchor_invalid_message") {
+        return null;
+    }
+    if (!message.startsWith("wallet_anchor_invalid_message_")) {
+        return null;
+    }
+    const reason = message.slice("wallet_anchor_invalid_message_".length).trim();
+    return reason === "" ? null : reason;
+}
+export async function resolveFoundingMessage(options) {
+    if (!options.promptForFoundingMessageWhenMissing || options.foundingMessageText != null) {
+        return encodeFoundingMessage(options.foundingMessageText ?? null);
+    }
+    for (;;) {
+        const answer = await options.prompter.prompt("Founding message (optional, press Enter to skip): ");
+        try {
+            return await encodeFoundingMessage(answer);
+        }
+        catch (error) {
+            const reason = extractAnchorInvalidMessageReason(error);
+            options.prompter.writeLine("Founding message cannot be encoded in canonical Coglex.");
+            if (reason !== null) {
+                options.prompter.writeLine(`Reason: ${reason}`);
+            }
+        }
+    }
+}
+export async function confirmDirectAnchor(prompter, options) {
+    prompter.writeLine(`You are anchoring "${options.domainName}".`);
+    prompter.writeLine(`Wallet address: ${options.walletAddress}`);
+    prompter.writeLine("Anchoring publishes a standalone DOMAIN_ANCHOR from the local wallet address.");
+    if (options.foundingMessageText !== null) {
+        prompter.writeLine("The founding message bytes will be public in mempool and on-chain.");
+        prompter.writeLine(`Founding message: ${options.foundingMessageText}`);
+    }
+    const answer = (await prompter.prompt("Type the domain name to continue: ")).trim();
+    if (answer !== options.domainName) {
+        throw new Error("wallet_anchor_confirmation_rejected");
+    }
+}

package/dist/wallet/tx/anchor/draft.d.ts

@@ -0,0 +1,39 @@
+import type { WalletRuntimePaths } from "../../runtime.js";
+import type { WalletSecretProvider } from "../../state/provider.js";
+import type { PendingMutationRecord, WalletStateV1 } from "../../types.js";
+import type { WalletReadContext } from "../../read/index.js";
+import { type WalletMutationFeeSelection } from "../common.js";
+import type { AnchorMutationOperation, WalletAnchorRpcClient } from "./intent.js";
+export declare function createDraftAnchorMutation(options: {
+    state: WalletStateV1;
+    domainName: string;
+    intentFingerprintHex: string;
+    nowUnixMs: number;
+    feeSelection: WalletMutationFeeSelection;
+    existing?: PendingMutationRecord | null;
+}): PendingMutationRecord;
+export declare function upsertAnchoredDomainRecord(options: {
+    state: WalletStateV1;
+    domainName: string;
+    domainId: number;
+    foundingMessageText: string | null;
+}): WalletStateV1;
+export declare function anchorConfirmedOnSnapshot(options: {
+    snapshot: NonNullable<WalletReadContext["snapshot"]>;
+    state: WalletStateV1;
+    domainName: string;
+}): boolean;
+export declare function reconcilePendingAnchorMutation(options: {
+    operation: AnchorMutationOperation;
+    mutation: PendingMutationRecord;
+    provider: WalletSecretProvider;
+    nowUnixMs: number;
+    paths: WalletRuntimePaths;
+    rpc: WalletAnchorRpcClient;
+    walletName: string;
+    context: WalletReadContext;
+}): Promise<{
+    state: WalletStateV1;
+    mutation: PendingMutationRecord;
+    resolution: "confirmed" | "live" | "repair-required" | "not-seen" | "continue";
+}>;

package/dist/wallet/tx/anchor/draft.js

@@ -0,0 +1,167 @@
+import { randomBytes } from "node:crypto";
+import { lookupDomain } from "@cogcoin/indexer/queries";
+import { createWalletMutationFeeMetadata, unlockTemporaryBuilderLocks, updateMutationRecord, } from "../common.js";
+import { persistWalletMutationState } from "../executor.js";
+import { upsertPendingMutation } from "../journal.js";
+export function createDraftAnchorMutation(options) {
+    const existing = options.existing ?? null;
+    if (existing !== null) {
+        return {
+            ...existing,
+            kind: "anchor",
+            domainName: options.domainName,
+            parentDomainName: null,
+            senderScriptPubKeyHex: options.state.funding.scriptPubKeyHex,
+            senderLocalIndex: 0,
+            intentFingerprintHex: options.intentFingerprintHex,
+            status: "draft",
+            lastUpdatedAtUnixMs: options.nowUnixMs,
+            attemptedTxid: null,
+            attemptedWtxid: null,
+            ...createWalletMutationFeeMetadata(options.feeSelection),
+            temporaryBuilderLockedOutpoints: [],
+        };
+    }
+    return {
+        mutationId: randomBytes(12).toString("hex"),
+        kind: "anchor",
+        domainName: options.domainName,
+        parentDomainName: null,
+        senderScriptPubKeyHex: options.state.funding.scriptPubKeyHex,
+        senderLocalIndex: 0,
+        intentFingerprintHex: options.intentFingerprintHex,
+        status: "draft",
+        createdAtUnixMs: options.nowUnixMs,
+        lastUpdatedAtUnixMs: options.nowUnixMs,
+        attemptedTxid: null,
+        attemptedWtxid: null,
+        ...createWalletMutationFeeMetadata(options.feeSelection),
+        temporaryBuilderLockedOutpoints: [],
+    };
+}
+export function upsertAnchoredDomainRecord(options) {
+    const domains = options.state.domains.slice();
+    const existingIndex = domains.findIndex((entry) => entry.name === options.domainName);
+    const current = existingIndex >= 0 ? domains[existingIndex] : null;
+    const nextRecord = {
+        name: options.domainName,
+        domainId: options.domainId,
+        currentOwnerScriptPubKeyHex: options.state.funding.scriptPubKeyHex,
+        canonicalChainStatus: "anchored",
+        foundingMessageText: options.foundingMessageText ?? current?.foundingMessageText ?? null,
+        birthTime: current?.birthTime ?? options.state.lastWrittenAtUnixMs,
+    };
+    if (existingIndex >= 0) {
+        domains[existingIndex] = nextRecord;
+    }
+    else {
+        domains.push(nextRecord);
+    }
+    return {
+        ...options.state,
+        domains,
+    };
+}
+export function anchorConfirmedOnSnapshot(options) {
+    const chainDomain = lookupDomain(options.snapshot.state, options.domainName);
+    if (chainDomain === null || !chainDomain.anchored) {
+        return false;
+    }
+    const ownerHex = Buffer.from(chainDomain.ownerScriptPubKey).toString("hex");
+    return ownerHex === options.state.funding.scriptPubKeyHex
+        || (options.state.localScriptPubKeyHexes ?? []).includes(ownerHex);
+}
+async function saveState(options) {
+    return persistWalletMutationState(options);
+}
+export async function reconcilePendingAnchorMutation(options) {
+    if (options.mutation.status === "repair-required") {
+        return {
+            state: options.operation.state,
+            mutation: options.mutation,
+            resolution: "repair-required",
+        };
+    }
+    if (options.context.snapshot !== null && anchorConfirmedOnSnapshot({
+        snapshot: options.context.snapshot,
+        state: options.operation.state,
+        domainName: options.mutation.domainName,
+    })) {
+        await unlockTemporaryBuilderLocks(options.rpc, options.walletName, options.mutation.temporaryBuilderLockedOutpoints);
+        const confirmedMutation = updateMutationRecord(options.mutation, "confirmed", options.nowUnixMs, {
+            temporaryBuilderLockedOutpoints: [],
+        });
+        const chainDomain = lookupDomain(options.context.snapshot.state, options.mutation.domainName);
+        const nextState = upsertAnchoredDomainRecord({
+            state: upsertPendingMutation(options.operation.state, confirmedMutation),
+            domainName: options.mutation.domainName,
+            domainId: chainDomain?.domainId ?? 0,
+            foundingMessageText: options.operation.message.text,
+        });
+        return {
+            state: await saveState({
+                state: nextState,
+                provider: options.provider,
+                nowUnixMs: options.nowUnixMs,
+                paths: options.paths,
+            }),
+            mutation: confirmedMutation,
+            resolution: "confirmed",
+        };
+    }
+    if (options.mutation.attemptedTxid !== null) {
+        const mempool = await options.rpc.getRawMempool().catch(() => []);
+        if (mempool.includes(options.mutation.attemptedTxid)) {
+            await unlockTemporaryBuilderLocks(options.rpc, options.walletName, options.mutation.temporaryBuilderLockedOutpoints);
+            const liveMutation = updateMutationRecord(options.mutation, "live", options.nowUnixMs, {
+                temporaryBuilderLockedOutpoints: [],
+            });
+            const domainId = (options.context.snapshot === null
+                ? null
+                : lookupDomain(options.context.snapshot.state, options.mutation.domainName)?.domainId)
+                ?? options.operation.state.domains.find((domain) => domain.name === options.mutation.domainName)?.domainId
+                ?? 0;
+            const nextState = upsertAnchoredDomainRecord({
+                state: upsertPendingMutation(options.operation.state, liveMutation),
+                domainName: options.mutation.domainName,
+                domainId,
+                foundingMessageText: options.operation.message.text,
+            });
+            return {
+                state: await saveState({
+                    state: nextState,
+                    provider: options.provider,
+                    nowUnixMs: options.nowUnixMs,
+                    paths: options.paths,
+                }),
+                mutation: liveMutation,
+                resolution: "live",
+            };
+        }
+    }
+    if (options.mutation.status === "broadcast-unknown"
+        || options.mutation.status === "live"
+        || options.mutation.status === "draft"
+        || options.mutation.status === "broadcasting") {
+        await unlockTemporaryBuilderLocks(options.rpc, options.walletName, options.mutation.temporaryBuilderLockedOutpoints);
+        const canceledMutation = updateMutationRecord(options.mutation, "canceled", options.nowUnixMs, {
+            temporaryBuilderLockedOutpoints: [],
+        });
+        const nextState = upsertPendingMutation(options.operation.state, canceledMutation);
+        return {
+            state: await saveState({
+                state: nextState,
+                provider: options.provider,
+                nowUnixMs: options.nowUnixMs,
+                paths: options.paths,
+            }),
+            mutation: canceledMutation,
+            resolution: "not-seen",
+        };
+    }
+    return {
+        state: options.operation.state,
+        mutation: options.mutation,
+        resolution: "continue",
+    };
+}

package/dist/wallet/tx/anchor/index.d.ts

@@ -0,0 +1,5 @@
+import { type AnchorDomainOptions } from "./intent.js";
+import { type AnchorDomainResult } from "./result.js";
+export type { AnchorDomainOptions } from "./intent.js";
+export type { AnchorDomainResult } from "./result.js";
+export declare function anchorDomain(options: AnchorDomainOptions): Promise<AnchorDomainResult>;

package/dist/wallet/tx/anchor/index.js

@@ -0,0 +1,148 @@
+import { buildWalletMutationTransactionWithReserveFallback, mergeFixedWalletInputs, updateMutationRecord, } from "../common.js";
+import { executeWalletMutationOperation, publishWalletMutation, resolveExistingWalletMutation, } from "../executor.js";
+import { upsertPendingMutation } from "../journal.js";
+import { confirmDirectAnchor, resolveFoundingMessage } from "./confirm.js";
+import { anchorConfirmedOnSnapshot, createDraftAnchorMutation, reconcilePendingAnchorMutation, upsertAnchoredDomainRecord, } from "./draft.js";
+import { buildDirectAnchorPlan, createAnchorOperationFingerprint, normalizeAnchorDomainName, resolveAnchorOperation, } from "./intent.js";
+import { validateDirectAnchorDraft } from "./plan.js";
+import { createAnchorResult, createAnchorReuseResult, } from "./result.js";
+export async function anchorDomain(options) {
+    if (!options.prompter.isInteractive) {
+        throw new Error("wallet_anchor_requires_tty");
+    }
+    const normalizedDomainName = normalizeAnchorDomainName(options.domainName);
+    const execution = await executeWalletMutationOperation({
+        ...options,
+        controlLockPurpose: "wallet-anchor",
+        preemptionReason: "wallet-anchor",
+        async resolveOperation(readContext) {
+            const message = await resolveFoundingMessage({
+                foundingMessageText: options.foundingMessageText,
+                promptForFoundingMessageWhenMissing: options.promptForFoundingMessageWhenMissing,
+                prompter: options.prompter,
+            });
+            return resolveAnchorOperation({
+                readContext,
+                normalizedDomainName,
+                message,
+            });
+        },
+        createIntentFingerprint(operation) {
+            return createAnchorOperationFingerprint(operation);
+        },
+        async resolveExistingMutation({ operation, existingMutation, execution }) {
+            if (existingMutation === null) {
+                return { state: operation.state, replacementFixedInputs: null, result: null };
+            }
+            return resolveExistingWalletMutation({
+                existingMutation,
+                execution,
+                repairRequiredErrorCode: "wallet_anchor_repair_required",
+                reconcileExistingMutation: (mutation) => reconcilePendingAnchorMutation({
+                    operation,
+                    mutation,
+                    provider: execution.provider,
+                    nowUnixMs: execution.nowUnixMs,
+                    paths: execution.paths,
+                    rpc: execution.rpc,
+                    walletName: execution.walletName,
+                    context: execution.readContext,
+                }),
+                createReuseResult: ({ mutation, resolution, fees }) => createAnchorReuseResult({
+                    operation,
+                    mutation,
+                    resolution,
+                    fees,
+                }),
+            });
+        },
+        confirm({ operation }) {
+            return confirmDirectAnchor(options.prompter, {
+                domainName: operation.normalizedDomainName,
+                walletAddress: operation.state.funding.address,
+                foundingMessageText: operation.message.text,
+            });
+        },
+        createDraftMutation({ operation, existingMutation, execution, intentFingerprintHex }) {
+            return {
+                mutation: createDraftAnchorMutation({
+                    state: operation.state,
+                    domainName: operation.normalizedDomainName,
+                    intentFingerprintHex,
+                    nowUnixMs: execution.nowUnixMs,
+                    feeSelection: execution.feeSelection,
+                    existing: existingMutation ?? null,
+                }),
+                prepared: null,
+            };
+        },
+        async build({ operation, state, execution, replacementFixedInputs }) {
+            const directAnchorPlan = buildDirectAnchorPlan({
+                state,
+                allUtxos: await execution.rpc.listUnspent(execution.walletName, 1),
+                domainId: operation.chainDomain.domainId,
+                foundingMessagePayloadHex: operation.message.payloadHex,
+            });
+            return buildWalletMutationTransactionWithReserveFallback({
+                rpc: execution.rpc,
+                walletName: execution.walletName,
+                state,
+                plan: {
+                    ...directAnchorPlan,
+                    fixedInputs: mergeFixedWalletInputs(directAnchorPlan.fixedInputs, replacementFixedInputs),
+                },
+                validateFundedDraft: validateDirectAnchorDraft,
+                finalizeErrorCode: "wallet_anchor_finalize_failed",
+                mempoolRejectPrefix: "wallet_anchor_mempool_rejected",
+                feeRate: execution.feeSelection.feeRateSatVb,
+            });
+        },
+        publish({ operation, state, execution, built, mutation }) {
+            return publishWalletMutation({
+                rpc: execution.rpc,
+                walletName: execution.walletName,
+                snapshotHeight: execution.readContext.snapshot?.tip?.height ?? null,
+                built,
+                mutation,
+                state,
+                provider: execution.provider,
+                nowUnixMs: execution.nowUnixMs,
+                paths: execution.paths,
+                errorPrefix: "wallet_anchor",
+                async afterAccepted({ state: acceptedState, broadcastingMutation, built, nowUnixMs }) {
+                    const finalStatus = anchorConfirmedOnSnapshot({
+                        snapshot: execution.readContext.snapshot,
+                        state: acceptedState,
+                        domainName: operation.normalizedDomainName,
+                    }) ? "confirmed" : "live";
+                    const finalMutation = updateMutationRecord(broadcastingMutation, finalStatus, nowUnixMs, {
+                        attemptedTxid: built.txid,
+                        attemptedWtxid: built.wtxid,
+                        temporaryBuilderLockedOutpoints: [],
+                    });
+                    return {
+                        state: upsertAnchoredDomainRecord({
+                            state: upsertPendingMutation(acceptedState, finalMutation),
+                            domainName: operation.normalizedDomainName,
+                            domainId: operation.chainDomain.domainId,
+                            foundingMessageText: operation.message.text,
+                        }),
+                        mutation: finalMutation,
+                        status: finalStatus,
+                    };
+                },
+            });
+        },
+        createResult({ operation, mutation, built, status, reusedExisting, fees }) {
+            return createAnchorResult({
+                operation,
+                mutation,
+                builtTxid: built?.txid ?? null,
+                status: status,
+                reusedExisting,
+                fees,
+            });
+        },
+    });
+    return execution.result;
+}