@cogcoin/client 1.1.7 → 1.1.9

package/dist/wallet/tx/domain-admin/draft.js

@@ -0,0 +1,161 @@
+import { randomBytes } from "node:crypto";
+import { lookupDomain, resolveCanonical, } from "@cogcoin/indexer/queries";
+import { createWalletMutationFeeMetadata, unlockTemporaryBuilderLocks, updateMutationRecord, } from "../common.js";
+import { persistWalletMutationState } from "../executor.js";
+import { upsertPendingMutation } from "../journal.js";
+import { bytesToHex } from "./intent.js";
+export function createDomainAdminDraftMutation(options) {
+    if (options.existing !== null && options.existing !== undefined) {
+        return {
+            ...options.existing,
+            kind: options.kind,
+            domainName: options.domainName,
+            senderScriptPubKeyHex: options.sender.scriptPubKeyHex,
+            senderLocalIndex: options.sender.localIndex,
+            recipientScriptPubKeyHex: options.recipientScriptPubKeyHex ?? null,
+            endpointValueHex: options.endpointValueHex ?? null,
+            status: "draft",
+            lastUpdatedAtUnixMs: options.nowUnixMs,
+            attemptedTxid: null,
+            attemptedWtxid: null,
+            ...createWalletMutationFeeMetadata(options.feeSelection),
+            temporaryBuilderLockedOutpoints: [],
+        };
+    }
+    return {
+        mutationId: randomBytes(12).toString("hex"),
+        kind: options.kind,
+        domainName: options.domainName,
+        parentDomainName: null,
+        senderScriptPubKeyHex: options.sender.scriptPubKeyHex,
+        senderLocalIndex: options.sender.localIndex,
+        recipientScriptPubKeyHex: options.recipientScriptPubKeyHex ?? null,
+        endpointValueHex: options.endpointValueHex ?? null,
+        intentFingerprintHex: options.intentFingerprintHex,
+        status: "draft",
+        createdAtUnixMs: options.nowUnixMs,
+        lastUpdatedAtUnixMs: options.nowUnixMs,
+        attemptedTxid: null,
+        attemptedWtxid: null,
+        ...createWalletMutationFeeMetadata(options.feeSelection),
+        temporaryBuilderLockedOutpoints: [],
+    };
+}
+function mutationConfirmedOnChain(mutation, context) {
+    if (context.snapshot === null) {
+        return false;
+    }
+    const chainDomain = lookupDomain(context.snapshot.state, mutation.domainName);
+    if (chainDomain === null || !chainDomain.anchored) {
+        return false;
+    }
+    const ownerHex = Buffer.from(chainDomain.ownerScriptPubKey).toString("hex");
+    if (ownerHex !== mutation.senderScriptPubKeyHex) {
+        return false;
+    }
+    if (mutation.kind === "endpoint") {
+        return bytesToHex(chainDomain.endpoint) === (mutation.endpointValueHex ?? "");
+    }
+    if (mutation.kind === "delegate") {
+        return bytesToHex(chainDomain.delegate) === (mutation.recipientScriptPubKeyHex ?? "");
+    }
+    if (mutation.kind === "miner") {
+        return bytesToHex(chainDomain.miner) === (mutation.recipientScriptPubKeyHex ?? "");
+    }
+    if (chainDomain.domainId === null) {
+        return false;
+    }
+    return resolveCanonical(context.snapshot.state, Buffer.from(mutation.senderScriptPubKeyHex, "hex")) === chainDomain.domainId;
+}
+function mutationNeedsRepair(mutation, context) {
+    if (context.snapshot === null) {
+        return false;
+    }
+    const chainDomain = lookupDomain(context.snapshot.state, mutation.domainName);
+    if (chainDomain === null) {
+        return false;
+    }
+    return !chainDomain.anchored || Buffer.from(chainDomain.ownerScriptPubKey).toString("hex") !== mutation.senderScriptPubKeyHex;
+}
+export async function reconcilePendingAdminMutation(options) {
+    if (options.mutation.status === "confirmed" || options.mutation.status === "live") {
+        return {
+            state: options.state,
+            mutation: options.mutation,
+            resolution: options.mutation.status,
+        };
+    }
+    if (options.mutation.status === "repair-required") {
+        return {
+            state: options.state,
+            mutation: options.mutation,
+            resolution: "repair-required",
+        };
+    }
+    if (mutationConfirmedOnChain(options.mutation, options.context)) {
+        await unlockTemporaryBuilderLocks(options.rpc, options.walletName, options.mutation.temporaryBuilderLockedOutpoints);
+        const confirmed = updateMutationRecord(options.mutation, "confirmed", options.nowUnixMs, {
+            temporaryBuilderLockedOutpoints: [],
+        });
+        let nextState = upsertPendingMutation(options.state, confirmed);
+        nextState = await persistWalletMutationState({
+            state: nextState,
+            provider: options.provider,
+            nowUnixMs: options.nowUnixMs,
+            paths: options.paths,
+        });
+        return { state: nextState, mutation: confirmed, resolution: "confirmed" };
+    }
+    if (mutationNeedsRepair(options.mutation, options.context)) {
+        await unlockTemporaryBuilderLocks(options.rpc, options.walletName, options.mutation.temporaryBuilderLockedOutpoints);
+        const repair = updateMutationRecord(options.mutation, "repair-required", options.nowUnixMs, {
+            temporaryBuilderLockedOutpoints: [],
+        });
+        let nextState = upsertPendingMutation(options.state, repair);
+        nextState = await persistWalletMutationState({
+            state: nextState,
+            provider: options.provider,
+            nowUnixMs: options.nowUnixMs,
+            paths: options.paths,
+        });
+        return { state: nextState, mutation: repair, resolution: "repair-required" };
+    }
+    const known = options.mutation.attemptedTxid === null
+        ? false
+        : await options.rpc.getRawTransaction(options.mutation.attemptedTxid, true).then(() => true).catch(() => false);
+    if (known) {
+        await unlockTemporaryBuilderLocks(options.rpc, options.walletName, options.mutation.temporaryBuilderLockedOutpoints);
+        const live = updateMutationRecord(options.mutation, "live", options.nowUnixMs, {
+            temporaryBuilderLockedOutpoints: [],
+        });
+        let nextState = upsertPendingMutation(options.state, live);
+        nextState = await persistWalletMutationState({
+            state: nextState,
+            provider: options.provider,
+            nowUnixMs: options.nowUnixMs,
+            paths: options.paths,
+        });
+        return { state: nextState, mutation: live, resolution: "live" };
+    }
+    if (options.mutation.status === "broadcast-unknown"
+        || options.mutation.status === "draft"
+        || options.mutation.status === "broadcasting") {
+        await unlockTemporaryBuilderLocks(options.rpc, options.walletName, options.mutation.temporaryBuilderLockedOutpoints);
+        const canceled = updateMutationRecord(options.mutation, "canceled", options.nowUnixMs, {
+            temporaryBuilderLockedOutpoints: [],
+        });
+        let nextState = upsertPendingMutation(options.state, canceled);
+        nextState = await persistWalletMutationState({
+            state: nextState,
+            provider: options.provider,
+            nowUnixMs: options.nowUnixMs,
+            paths: options.paths,
+        });
+        return { state: nextState, mutation: canceled, resolution: "not-seen" };
+    }
+    return {
+        state: options.state,
+        mutation: options.mutation,
+        resolution: "continue",
+    };
+}

package/dist/wallet/tx/domain-admin/index.d.ts

@@ -0,0 +1,9 @@
+import type { ClearDomainDelegateOptions, ClearDomainEndpointOptions, ClearDomainMinerOptions, DomainAdminMutationResult, SetDomainCanonicalOptions, SetDomainDelegateOptions, SetDomainEndpointOptions, SetDomainMinerOptions } from "./types.js";
+export type { ClearDomainDelegateOptions, ClearDomainEndpointOptions, ClearDomainMinerOptions, DomainAdminMutationResult, DomainAdminResolvedEffect, DomainAdminResolvedSenderSummary, DomainAdminResolvedSummary, DomainAdminResolvedTargetSummary, SetDomainCanonicalOptions, SetDomainDelegateOptions, SetDomainEndpointOptions, SetDomainMinerOptions, } from "./types.js";
+export declare function setDomainEndpoint(options: SetDomainEndpointOptions): Promise<DomainAdminMutationResult>;
+export declare function clearDomainEndpoint(options: ClearDomainEndpointOptions): Promise<DomainAdminMutationResult>;
+export declare function setDomainDelegate(options: SetDomainDelegateOptions): Promise<DomainAdminMutationResult>;
+export declare function clearDomainDelegate(options: ClearDomainDelegateOptions): Promise<DomainAdminMutationResult>;
+export declare function setDomainMiner(options: SetDomainMinerOptions): Promise<DomainAdminMutationResult>;
+export declare function clearDomainMiner(options: ClearDomainMinerOptions): Promise<DomainAdminMutationResult>;
+export declare function setDomainCanonical(options: SetDomainCanonicalOptions): Promise<DomainAdminMutationResult>;

package/dist/wallet/tx/domain-admin/index.js

@@ -0,0 +1,150 @@
+import { mergeFixedWalletInputs } from "../common.js";
+import { executeWalletMutationOperation, publishWalletMutation, resolveExistingWalletMutation, } from "../executor.js";
+import { createDomainAdminDraftMutation, reconcilePendingAdminMutation, } from "./draft.js";
+import { createResolvedDomainAdminSenderSummary, createDomainAdminIntentFingerprint, normalizeDomainAdminDomainName, resolveAnchoredDomainOperation, } from "./intent.js";
+import { buildPlanForDomainAdminOperation, buildDomainAdminTransaction, } from "./plan.js";
+import { createDomainAdminResult, createDomainAdminReuseResult, } from "./result.js";
+import { createCanonicalVariant } from "./variants/canonical.js";
+import { createClearDelegateVariant, createSetDelegateVariant, } from "./variants/delegate.js";
+import { createClearEndpointVariant, createSetEndpointVariant, } from "./variants/endpoint.js";
+import { createClearMinerVariant, createSetMinerVariant, } from "./variants/miner.js";
+async function submitDomainAdminMutation(options, variant) {
+    const execution = await executeWalletMutationOperation({
+        ...options,
+        controlLockPurpose: variant.errorPrefix,
+        preemptionReason: variant.errorPrefix,
+        async resolveOperation(readContext) {
+            const normalizedDomainName = normalizeDomainAdminDomainName(options.domainName);
+            const operation = resolveAnchoredDomainOperation(readContext, normalizedDomainName, variant.errorPrefix, { requireRoot: variant.requireRoot });
+            return {
+                ...operation,
+                normalizedDomainName,
+                resolvedSender: createResolvedDomainAdminSenderSummary(operation.sender, operation.senderSelector),
+                payload: await variant.createPayload(operation),
+            };
+        },
+        createIntentFingerprint(operation) {
+            return createDomainAdminIntentFingerprint([
+                variant.kind,
+                operation.state.walletRootId,
+                ...variant.intentParts(operation),
+            ]);
+        },
+        async resolveExistingMutation({ operation, existingMutation, execution }) {
+            if (existingMutation === null) {
+                return {
+                    state: operation.state,
+                    replacementFixedInputs: null,
+                    result: null,
+                };
+            }
+            return resolveExistingWalletMutation({
+                existingMutation,
+                execution,
+                repairRequiredErrorCode: `${variant.errorPrefix}_repair_required`,
+                reconcileExistingMutation: (mutation) => reconcilePendingAdminMutation({
+                    state: operation.state,
+                    mutation,
+                    provider: execution.provider,
+                    nowUnixMs: execution.nowUnixMs,
+                    paths: execution.paths,
+                    rpc: execution.rpc,
+                    walletName: execution.walletName,
+                    context: execution.readContext,
+                }),
+                createReuseResult: ({ mutation, resolution, fees }) => createDomainAdminReuseResult({
+                    variant,
+                    operation,
+                    mutation,
+                    resolution,
+                    fees,
+                }),
+            });
+        },
+        confirm({ operation }) {
+            return variant.confirm(operation);
+        },
+        createDraftMutation({ operation, existingMutation, execution, intentFingerprintHex }) {
+            return {
+                mutation: createDomainAdminDraftMutation({
+                    kind: variant.kind,
+                    domainName: operation.normalizedDomainName,
+                    sender: operation.sender,
+                    intentFingerprintHex,
+                    nowUnixMs: execution.nowUnixMs,
+                    feeSelection: execution.feeSelection,
+                    recipientScriptPubKeyHex: operation.payload.recipientScriptPubKeyHex ?? null,
+                    endpointValueHex: operation.payload.endpointValueHex ?? null,
+                    existing: existingMutation,
+                }),
+                prepared: null,
+            };
+        },
+        async build({ operation, state, execution, replacementFixedInputs }) {
+            const adminPlan = buildPlanForDomainAdminOperation({
+                state,
+                allUtxos: await execution.rpc.listUnspent(execution.walletName, 1),
+                sender: operation.sender,
+                opReturnData: operation.payload.opReturnData,
+                errorPrefix: variant.errorPrefix,
+            });
+            return buildDomainAdminTransaction({
+                rpc: execution.rpc,
+                walletName: execution.walletName,
+                state,
+                plan: {
+                    ...adminPlan,
+                    fixedInputs: mergeFixedWalletInputs(adminPlan.fixedInputs, replacementFixedInputs),
+                },
+                feeRateSatVb: execution.feeSelection.feeRateSatVb,
+            });
+        },
+        publish({ 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: variant.errorPrefix,
+            });
+        },
+        createResult({ operation, mutation, built, status, reusedExisting, fees }) {
+            return createDomainAdminResult({
+                variant,
+                operation,
+                mutation,
+                builtTxid: built?.txid ?? null,
+                status: status,
+                reusedExisting,
+                fees,
+            });
+        },
+    });
+    return execution.result;
+}
+export async function setDomainEndpoint(options) {
+    return submitDomainAdminMutation(options, await createSetEndpointVariant(options));
+}
+export async function clearDomainEndpoint(options) {
+    return submitDomainAdminMutation(options, createClearEndpointVariant(options));
+}
+export async function setDomainDelegate(options) {
+    return submitDomainAdminMutation(options, createSetDelegateVariant(options));
+}
+export async function clearDomainDelegate(options) {
+    return submitDomainAdminMutation(options, createClearDelegateVariant(options));
+}
+export async function setDomainMiner(options) {
+    return submitDomainAdminMutation(options, createSetMinerVariant(options));
+}
+export async function clearDomainMiner(options) {
+    return submitDomainAdminMutation(options, createClearMinerVariant(options));
+}
+export async function setDomainCanonical(options) {
+    return submitDomainAdminMutation(options, createCanonicalVariant(options));
+}

package/dist/wallet/tx/domain-admin/intent.d.ts

@@ -0,0 +1,12 @@
+import { type MutationSender } from "../common.js";
+import { normalizeBtcTarget } from "../targets.js";
+import type { DomainAdminOperation, DomainAdminResolvedSenderSummary, DomainAdminResolvedTargetSummary, ReadyWalletReadContext } from "./types.js";
+export declare function normalizeDomainAdminDomainName(domainName: string): string;
+export declare function bytesToHex(value: Uint8Array | null | undefined): string;
+export declare function createDomainAdminIntentFingerprint(parts: Array<string | number | bigint>): string;
+export declare function createResolvedDomainAdminSenderSummary(sender: MutationSender, selector: string): DomainAdminResolvedSenderSummary;
+export declare function createResolvedDomainAdminTargetSummary(target: ReturnType<typeof normalizeBtcTarget>): DomainAdminResolvedTargetSummary;
+export declare function resolveAnchoredDomainOperation(context: ReadyWalletReadContext, domainName: string, errorPrefix: string, options?: {
+    requireRoot?: boolean;
+    rejectReadOnly?: boolean;
+}): DomainAdminOperation;

package/dist/wallet/tx/domain-admin/intent.js

@@ -0,0 +1,61 @@
+import { createHash } from "node:crypto";
+import { lookupDomain } from "@cogcoin/indexer/queries";
+import { validateDomainName } from "../../cogop/index.js";
+import { assertWalletMutationContextReady, createFundingMutationSender, } from "../common.js";
+import { normalizeBtcTarget } from "../targets.js";
+export function normalizeDomainAdminDomainName(domainName) {
+    const normalized = domainName.trim().toLowerCase();
+    if (normalized.length === 0) {
+        throw new Error("wallet_domain_admin_missing_domain");
+    }
+    validateDomainName(normalized);
+    return normalized;
+}
+export function bytesToHex(value) {
+    return Buffer.from(value ?? new Uint8Array()).toString("hex");
+}
+export function createDomainAdminIntentFingerprint(parts) {
+    return createHash("sha256")
+        .update(parts.map((part) => String(part)).join("\n"))
+        .digest("hex");
+}
+export function createResolvedDomainAdminSenderSummary(sender, selector) {
+    return {
+        selector,
+        localIndex: sender.localIndex,
+        scriptPubKeyHex: sender.scriptPubKeyHex,
+        address: sender.address,
+    };
+}
+export function createResolvedDomainAdminTargetSummary(target) {
+    return {
+        scriptPubKeyHex: target.scriptPubKeyHex,
+        address: target.address,
+        opaque: target.opaque,
+    };
+}
+export function resolveAnchoredDomainOperation(context, domainName, errorPrefix, options = {}) {
+    void options.rejectReadOnly;
+    assertWalletMutationContextReady(context, errorPrefix);
+    const chainDomain = lookupDomain(context.snapshot.state, domainName);
+    if (chainDomain === null) {
+        throw new Error(`${errorPrefix}_domain_not_found`);
+    }
+    if (!chainDomain.anchored) {
+        throw new Error(`${errorPrefix}_domain_not_anchored`);
+    }
+    if (options.requireRoot && domainName.includes("-")) {
+        throw new Error(`${errorPrefix}_root_domain_required`);
+    }
+    const ownerHex = Buffer.from(chainDomain.ownerScriptPubKey).toString("hex");
+    if (ownerHex !== context.localState.state.funding.scriptPubKeyHex || context.model.walletAddress == null) {
+        throw new Error(`${errorPrefix}_owner_not_locally_controlled`);
+    }
+    return {
+        readContext: context,
+        state: context.localState.state,
+        sender: createFundingMutationSender(context.localState.state),
+        senderSelector: context.model.walletAddress,
+        chainDomain,
+    };
+}

package/dist/wallet/tx/domain-admin/plan.d.ts

@@ -0,0 +1,19 @@
+import type { RpcDecodedPsbt, RpcListUnspentEntry } from "../../../bitcoind/types.js";
+import { type MutationSender } from "../common.js";
+import type { BuiltDomainAdminTransaction, DomainAdminPlan, DomainAdminRpcClient } from "./types.js";
+import type { WalletStateV1 } from "../../types.js";
+export declare function buildPlanForDomainAdminOperation(options: {
+    state: WalletStateV1;
+    allUtxos: RpcListUnspentEntry[];
+    sender: MutationSender;
+    opReturnData: Uint8Array;
+    errorPrefix: string;
+}): DomainAdminPlan;
+export declare function validateFundedDomainAdminDraft(decoded: RpcDecodedPsbt, funded: BuiltDomainAdminTransaction["funded"], plan: DomainAdminPlan): void;
+export declare function buildDomainAdminTransaction(options: {
+    rpc: DomainAdminRpcClient;
+    walletName: string;
+    state: WalletStateV1;
+    plan: DomainAdminPlan;
+    feeRateSatVb: number;
+}): Promise<BuiltDomainAdminTransaction>;

package/dist/wallet/tx/domain-admin/plan.js

@@ -0,0 +1,64 @@
+import { buildWalletMutationTransactionWithReserveFallback, outpointKey, } from "../common.js";
+function encodeOpReturnScript(payload) {
+    if (payload.length <= 75) {
+        return Buffer.concat([
+            Buffer.from([0x6a, payload.length]),
+            Buffer.from(payload),
+        ]).toString("hex");
+    }
+    return Buffer.concat([
+        Buffer.from([0x6a, 0x4c, payload.length]),
+        Buffer.from(payload),
+    ]).toString("hex");
+}
+export function buildPlanForDomainAdminOperation(options) {
+    const fundingUtxos = options.allUtxos.filter((entry) => entry.scriptPubKey === options.state.funding.scriptPubKeyHex
+        && entry.confirmations >= 1
+        && entry.spendable !== false
+        && entry.safe !== false);
+    return {
+        sender: options.sender,
+        changeAddress: options.state.funding.address,
+        fixedInputs: [],
+        outputs: [{ data: Buffer.from(options.opReturnData).toString("hex") }],
+        changePosition: 1,
+        expectedOpReturnScriptHex: encodeOpReturnScript(options.opReturnData),
+        allowedFundingScriptPubKeyHex: options.state.funding.scriptPubKeyHex,
+        eligibleFundingOutpointKeys: new Set(fundingUtxos.map((entry) => outpointKey({ txid: entry.txid, vout: entry.vout }))),
+        errorPrefix: options.errorPrefix,
+    };
+}
+export function validateFundedDomainAdminDraft(decoded, funded, plan) {
+    const inputs = decoded.tx.vin;
+    const outputs = decoded.tx.vout;
+    if (inputs.length === 0) {
+        throw new Error(`${plan.errorPrefix}_missing_sender_input`);
+    }
+    if (outputs[0]?.scriptPubKey?.hex !== plan.expectedOpReturnScriptHex) {
+        throw new Error(`${plan.errorPrefix}_opreturn_mismatch`);
+    }
+    if (funded.changepos === -1) {
+        if (outputs.length !== 1) {
+            throw new Error(`${plan.errorPrefix}_unexpected_output_count`);
+        }
+        return;
+    }
+    if (funded.changepos !== plan.changePosition || outputs.length !== 2) {
+        throw new Error(`${plan.errorPrefix}_change_position_mismatch`);
+    }
+    if (outputs[funded.changepos]?.scriptPubKey?.hex !== plan.allowedFundingScriptPubKeyHex) {
+        throw new Error(`${plan.errorPrefix}_change_output_mismatch`);
+    }
+}
+export async function buildDomainAdminTransaction(options) {
+    return buildWalletMutationTransactionWithReserveFallback({
+        rpc: options.rpc,
+        walletName: options.walletName,
+        state: options.state,
+        plan: options.plan,
+        validateFundedDraft: validateFundedDomainAdminDraft,
+        finalizeErrorCode: `${options.plan.errorPrefix}_finalize_failed`,
+        mempoolRejectPrefix: `${options.plan.errorPrefix}_mempool_rejected`,
+        feeRate: options.feeRateSatVb,
+    });
+}

package/dist/wallet/tx/domain-admin/result.d.ts

@@ -0,0 +1,19 @@
+import type { PendingMutationRecord } from "../../types.js";
+import type { WalletMutationFeeSummary } from "../common.js";
+import type { DomainAdminMutationResult, DomainAdminVariant, StandaloneDomainAdminOperation } from "./types.js";
+export declare function createDomainAdminReuseResult(options: {
+    variant: DomainAdminVariant;
+    operation: StandaloneDomainAdminOperation;
+    mutation: PendingMutationRecord;
+    resolution: "confirmed" | "live";
+    fees: WalletMutationFeeSummary;
+}): DomainAdminMutationResult;
+export declare function createDomainAdminResult(options: {
+    variant: DomainAdminVariant;
+    operation: StandaloneDomainAdminOperation;
+    mutation: PendingMutationRecord;
+    builtTxid: string | null;
+    status: "live" | "confirmed";
+    reusedExisting: boolean;
+    fees: WalletMutationFeeSummary;
+}): DomainAdminMutationResult;

package/dist/wallet/tx/domain-admin/result.js

@@ -0,0 +1,33 @@
+function createResolvedSummary(operation) {
+    return {
+        sender: operation.resolvedSender,
+        target: operation.payload.resolvedTarget,
+        effect: operation.payload.resolvedEffect,
+    };
+}
+export function createDomainAdminReuseResult(options) {
+    return {
+        kind: options.variant.kind,
+        domainName: options.operation.normalizedDomainName,
+        txid: options.mutation.attemptedTxid ?? "unknown",
+        status: options.resolution,
+        reusedExisting: true,
+        recipientScriptPubKeyHex: options.operation.payload.recipientScriptPubKeyHex ?? null,
+        endpointValueHex: options.operation.payload.endpointValueHex ?? null,
+        resolved: createResolvedSummary(options.operation),
+        fees: options.fees,
+    };
+}
+export function createDomainAdminResult(options) {
+    return {
+        kind: options.variant.kind,
+        domainName: options.operation.normalizedDomainName,
+        txid: options.mutation.attemptedTxid ?? options.builtTxid ?? "unknown",
+        status: options.status,
+        reusedExisting: options.reusedExisting,
+        recipientScriptPubKeyHex: options.operation.payload.recipientScriptPubKeyHex ?? null,
+        endpointValueHex: options.operation.payload.endpointValueHex ?? null,
+        resolved: createResolvedSummary(options.operation),
+        fees: options.fees,
+    };
+}