@cogcoin/client 1.1.8 → 1.1.9

package/dist/cli/wallet-read-helpers.d.ts

@@ -0,0 +1,6 @@
+import type { WalletFieldView, WalletLockView, WalletReadContext } from "../wallet/read/index.js";
+export declare function listVisibleWalletLocks(context: WalletReadContext, options: {
+    claimableOnly: boolean;
+    reclaimableOnly: boolean;
+}): WalletLockView[] | null;
+export declare function listVisibleDomainFields(context: WalletReadContext, domainName: string): WalletFieldView[] | null;

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

@@ -0,0 +1,17 @@
+import { listDomainFields, listWalletLocks, } from "../wallet/read/index.js";
+export function listVisibleWalletLocks(context, options) {
+    const locks = listWalletLocks(context);
+    if (locks === null) {
+        return null;
+    }
+    if (options.claimableOnly) {
+        return locks.filter((lock) => lock.claimableNow);
+    }
+    if (options.reclaimableOnly) {
+        return locks.filter((lock) => lock.reclaimableNow);
+    }
+    return locks;
+}
+export function listVisibleDomainFields(context, domainName) {
+    return listDomainFields(context, domainName);
+}

package/dist/wallet/mining/candidate.d.ts

@@ -45,7 +45,7 @@ export declare function buildMiningGenerationRequest(options: {
         requiredWords: [string, string, string, string, string];
     }>;
     domainExtraPrompts: Record<string, string>;
-    extraPrompt: string | null;
+    fallbackInstruction: string | null;
 }): MiningSentenceGenerationRequest;
 export declare function generateCandidatesForDomains(options: {
     rpc: MiningRpcClient;

package/dist/wallet/mining/candidate.js

@@ -114,13 +114,13 @@ export function buildMiningGenerationRequest(options) {
         targetBlockHeight: options.targetBlockHeight,
         referencedBlockHashDisplay: options.referencedBlockHashDisplay,
         generatedAtUnixMs: options.generatedAtUnixMs ?? Date.now(),
-        extraPrompt: options.extraPrompt,
+        fallbackInstruction: options.fallbackInstruction,
         limits: createMiningSentenceRequestLimits(),
         rootDomains: options.domains.map((domain) => ({
             domainId: domain.domainId,
             domainName: domain.domainName,
             requiredWords: domain.requiredWords,
-            extraPrompt: options.domainExtraPrompts[domain.domainName.toLowerCase()] ?? null,
+            domainInstruction: options.domainExtraPrompts[domain.domainName.toLowerCase()] ?? null,
         })),
     };
 }
@@ -193,7 +193,7 @@ export async function generateCandidatesForDomains(options) {
             referencedBlockHashDisplay: bestBlockHash,
             domains: rootDomains,
             domainExtraPrompts: clientConfig?.mining.domainExtraPrompts ?? {},
-            extraPrompt: clientConfig?.mining.builtIn?.extraPrompt ?? null,
+            fallbackInstruction: clientConfig?.mining.builtIn?.extraPrompt ?? null,
         });
         let generated;
         try {

package/dist/wallet/mining/constants.d.ts

@@ -10,8 +10,8 @@ export declare const MINING_LOOP_INTERVAL_MS = 2000;
 export declare const MINING_BUILTIN_TIMEOUT_MS = 30000;
 export declare const MINING_SENTENCE_SCHEMA_VERSION: 1;
 export declare const MINING_SENTENCE_MAX_CANDIDATE_SENTENCE_UTF8_BYTES = 512;
-export declare const MINING_SENTENCE_MAX_CANDIDATES_PER_ROOT_DOMAIN = 8;
-export declare const MINING_SENTENCE_MAX_CANDIDATES_TOTAL = 64;
+export declare const MINING_SENTENCE_MAX_CANDIDATES_PER_ROOT_DOMAIN = 25;
+export declare const MINING_SENTENCE_MAX_CANDIDATES_TOTAL = 500;
 export declare const MINING_SENTENCE_TIMEOUT_MS = 30000;
 export declare const MINING_SHUTDOWN_GRACE_MS = 15000;
 export declare const MINING_SETTLEMENT_DUMMY_REWARD = 100n;

package/dist/wallet/mining/constants.js

@@ -10,8 +10,8 @@ export const MINING_LOOP_INTERVAL_MS = 2_000;
 export const MINING_BUILTIN_TIMEOUT_MS = 30_000;
 export const MINING_SENTENCE_SCHEMA_VERSION = 1;
 export const MINING_SENTENCE_MAX_CANDIDATE_SENTENCE_UTF8_BYTES = 512;
-export const MINING_SENTENCE_MAX_CANDIDATES_PER_ROOT_DOMAIN = 8;
-export const MINING_SENTENCE_MAX_CANDIDATES_TOTAL = 64;
+export const MINING_SENTENCE_MAX_CANDIDATES_PER_ROOT_DOMAIN = 25;
+export const MINING_SENTENCE_MAX_CANDIDATES_TOTAL = 500;
 export const MINING_SENTENCE_TIMEOUT_MS = 30_000;
 export const MINING_SHUTDOWN_GRACE_MS = 15_000;
 export const MINING_SETTLEMENT_DUMMY_REWARD = 100n;

package/dist/wallet/mining/sentence-protocol.d.ts

@@ -5,7 +5,7 @@ export interface MiningSentenceGenerationRequestV1 {
     targetBlockHeight: number;
     referencedBlockHashDisplay: string;
     generatedAtUnixMs: number;
-    extraPrompt: string | null;
+    fallbackInstruction: string | null;
     limits: {
         maxCandidatesPerRootDomain: number;
         maxCandidatesTotal: number;
@@ -16,7 +16,7 @@ export interface MiningSentenceGenerationRequestV1 {
         domainId: number;
         domainName: string;
         requiredWords: [string, string, string, string, string];
-        extraPrompt: string | null;
+        domainInstruction: string | null;
     }>;
 }
 export interface MiningSentenceCandidateV1 {

package/dist/wallet/mining/sentences.js

@@ -26,20 +26,20 @@ function createBuiltInProviderTimeoutError(options) {
     const unit = seconds === "1" ? "second" : "seconds";
     return new MiningProviderRequestError("unavailable", `The built-in ${providerName} mining provider timed out after ${seconds} ${unit}.`);
 }
-function buildSystemPrompt(extraPrompt) {
+function buildSystemPrompt(fallbackInstruction) {
     const lines = [
         "You are helping generate candidate Cogcoin mining sentences.",
         "Return only JSON matching the requested response schema.",
         "Every sentence must be a single natural-language sentence.",
         "Do not add commentary, markdown, or code fences.",
         "Do not invent domain IDs or request IDs.",
-        "Each rootDomains entry may include an extraPrompt that applies only to that domain.",
-        "If rootDomains[i].extraPrompt is present, use it only for candidates for that domainId.",
-        "If rootDomains[i].extraPrompt is null, fall back to the request-level extraPrompt when it is present.",
+        "Each rootDomains entry may include a domainInstruction that applies only to that domain.",
+        "If rootDomains[i].domainInstruction is present, use it only for candidates for that domainId.",
+        "If rootDomains[i].domainInstruction is null, fall back to the request-level fallbackInstruction when it is present.",
         "Never apply one domain's prompt to another domain's candidates.",
     ];
-    if (extraPrompt !== null && extraPrompt.trim().length > 0) {
-        lines.push(`Request-level fallback instruction: ${extraPrompt.trim()}`);
+    if (fallbackInstruction !== null && fallbackInstruction.trim().length > 0) {
+        lines.push(`Request-level fallback instruction: ${fallbackInstruction.trim()}`);
     }
     return lines.join("\n");
 }
@@ -162,7 +162,7 @@ async function requestBuiltInSentences(options) {
                     input: [
                         {
                             role: "system",
-                            content: buildSystemPrompt(options.request.extraPrompt),
+                            content: buildSystemPrompt(options.request.fallbackInstruction),
                         },
                         {
                             role: "user",
@@ -209,7 +209,7 @@ async function requestBuiltInSentences(options) {
             body: JSON.stringify({
                 model,
                 max_tokens: 1_200,
-                system: buildSystemPrompt(options.request.extraPrompt),
+                system: buildSystemPrompt(options.request.fallbackInstruction),
                 messages: [
                     {
                         role: "user",

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;
+}

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

@@ -0,0 +1,61 @@
+import { lookupDomain } from "@cogcoin/indexer/queries";
+import { attachOrStartManagedBitcoindService } from "../../../bitcoind/service.js";
+import { createRpcClient } from "../../../bitcoind/node.js";
+import type { RpcListUnspentEntry } from "../../../bitcoind/types.js";
+import type { WalletPrompter } from "../../lifecycle.js";
+import { openWalletReadContext, type WalletReadContext } from "../../read/index.js";
+import type { WalletRuntimePaths } from "../../runtime.js";
+import type { WalletSecretProvider } from "../../state/provider.js";
+import type { WalletStateV1 } from "../../types.js";
+import { type FixedWalletInput, type WalletMutationRpcClient } from "../common.js";
+import type { AnchorFoundingMessage } from "./confirm.js";
+export interface WalletAnchorRpcClient extends WalletMutationRpcClient {
+    getBlockchainInfo(): Promise<{
+        blocks: number;
+    }>;
+    sendRawTransaction(hex: string): Promise<string>;
+    getRawMempool(): Promise<string[]>;
+}
+export interface AnchorDomainOptions {
+    domainName: string;
+    foundingMessageText?: string | null;
+    promptForFoundingMessageWhenMissing?: boolean;
+    feeRateSatVb?: number | null;
+    dataDir: string;
+    databasePath: string;
+    provider?: WalletSecretProvider;
+    prompter: WalletPrompter;
+    nowUnixMs?: number;
+    paths?: WalletRuntimePaths;
+    openReadContext?: typeof openWalletReadContext;
+    attachService?: typeof attachOrStartManagedBitcoindService;
+    rpcFactory?: (config: Parameters<typeof createRpcClient>[0]) => WalletAnchorRpcClient;
+}
+export interface AnchorMutationOperation {
+    state: WalletStateV1;
+    normalizedDomainName: string;
+    chainDomain: NonNullable<ReturnType<typeof lookupDomain>>;
+    message: AnchorFoundingMessage;
+}
+export interface DirectAnchorPlan {
+    fixedInputs: FixedWalletInput[];
+    outputs: unknown[];
+    changeAddress: string;
+    changePosition: number;
+    expectedOpReturnScriptHex: string;
+    allowedFundingScriptPubKeyHex: string;
+    eligibleFundingOutpointKeys: Set<string>;
+}
+export declare function normalizeAnchorDomainName(domainName: string): string;
+export declare function resolveAnchorOperation(options: {
+    readContext: WalletReadContext;
+    normalizedDomainName: string;
+    message: AnchorFoundingMessage;
+}): AnchorMutationOperation;
+export declare function createAnchorOperationFingerprint(operation: AnchorMutationOperation): string;
+export declare function buildDirectAnchorPlan(options: {
+    state: WalletStateV1;
+    allUtxos: RpcListUnspentEntry[];
+    domainId: number;
+    foundingMessagePayloadHex: string | null;
+}): DirectAnchorPlan;