@cogcoin/client 1.1.8 → 1.1.9

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

@@ -0,0 +1,101 @@
+import { createHash } from "node:crypto";
+import { lookupDomain } from "@cogcoin/indexer/queries";
+import { attachOrStartManagedBitcoindService } from "../../../bitcoind/service.js";
+import { createRpcClient } from "../../../bitcoind/node.js";
+import { openWalletReadContext } from "../../read/index.js";
+import { serializeDomainAnchor, validateDomainName, } from "../../cogop/index.js";
+import { assertWalletMutationContextReady, outpointKey, } from "../common.js";
+function normalizeDomainName(domainName) {
+    const normalized = domainName.trim().toLowerCase();
+    if (normalized.length === 0) {
+        throw new Error("wallet_anchor_missing_domain");
+    }
+    validateDomainName(normalized);
+    return normalized;
+}
+function createIntentFingerprint(parts) {
+    return createHash("sha256")
+        .update(parts.map((part) => String(part)).join("\n"))
+        .digest("hex");
+}
+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");
+}
+function sortUtxos(entries) {
+    return entries
+        .slice()
+        .sort((left, right) => right.amount - left.amount
+        || left.txid.localeCompare(right.txid)
+        || left.vout - right.vout);
+}
+function isSpendableFundingUtxo(entry, fundingScriptPubKeyHex) {
+    return entry.scriptPubKey === fundingScriptPubKeyHex
+        && entry.confirmations >= 1
+        && entry.spendable !== false
+        && entry.safe !== false;
+}
+export function normalizeAnchorDomainName(domainName) {
+    return normalizeDomainName(domainName);
+}
+export function resolveAnchorOperation(options) {
+    assertWalletMutationContextReady(options.readContext, "wallet_anchor");
+    const state = options.readContext.localState.state;
+    const chainDomain = lookupDomain(options.readContext.snapshot.state, options.normalizedDomainName);
+    if (chainDomain === null) {
+        throw new Error("wallet_anchor_domain_not_found");
+    }
+    if (chainDomain.anchored) {
+        throw new Error("wallet_anchor_domain_already_anchored");
+    }
+    const ownerHex = Buffer.from(chainDomain.ownerScriptPubKey).toString("hex");
+    const localScriptHexes = new Set([
+        state.funding.scriptPubKeyHex,
+        ...(state.localScriptPubKeyHexes ?? []),
+    ]);
+    if (!localScriptHexes.has(ownerHex)) {
+        throw new Error("wallet_anchor_owner_not_locally_controlled");
+    }
+    if (state.funding.address.trim() === "") {
+        throw new Error("wallet_anchor_owner_identity_not_supported");
+    }
+    return {
+        state,
+        normalizedDomainName: options.normalizedDomainName,
+        chainDomain,
+        message: options.message,
+    };
+}
+export function createAnchorOperationFingerprint(operation) {
+    return createIntentFingerprint([
+        "anchor",
+        operation.state.walletRootId,
+        operation.normalizedDomainName,
+        operation.state.funding.scriptPubKeyHex,
+        operation.message.payloadHex ?? "",
+    ]);
+}
+export function buildDirectAnchorPlan(options) {
+    const fundingUtxos = sortUtxos(options.allUtxos.filter((entry) => isSpendableFundingUtxo(entry, options.state.funding.scriptPubKeyHex)));
+    const foundingPayload = options.foundingMessagePayloadHex === null
+        ? undefined
+        : Buffer.from(options.foundingMessagePayloadHex, "hex");
+    const opReturnData = serializeDomainAnchor(options.domainId, foundingPayload).opReturnData;
+    return {
+        fixedInputs: [],
+        outputs: [{ data: Buffer.from(opReturnData).toString("hex") }],
+        changeAddress: options.state.funding.address,
+        changePosition: 1,
+        expectedOpReturnScriptHex: encodeOpReturnScript(opReturnData),
+        allowedFundingScriptPubKeyHex: options.state.funding.scriptPubKeyHex,
+        eligibleFundingOutpointKeys: new Set(fundingUtxos.map((entry) => outpointKey({ txid: entry.txid, vout: entry.vout }))),
+    };
+}

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

@@ -0,0 +1,3 @@
+import type { BuiltWalletMutationTransaction } from "../common.js";
+import type { DirectAnchorPlan } from "./intent.js";
+export declare function validateDirectAnchorDraft(decoded: BuiltWalletMutationTransaction["decoded"], funded: BuiltWalletMutationTransaction["funded"], plan: DirectAnchorPlan): void;

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

@@ -0,0 +1,18 @@
+export function validateDirectAnchorDraft(decoded, funded, plan) {
+    const outputs = decoded.tx.vout;
+    if (outputs[0]?.scriptPubKey?.hex !== plan.expectedOpReturnScriptHex) {
+        throw new Error("wallet_anchor_opreturn_mismatch");
+    }
+    if (funded.changepos === -1) {
+        if (outputs.length !== 1) {
+            throw new Error("wallet_anchor_unexpected_output_count");
+        }
+        return;
+    }
+    if (funded.changepos !== plan.changePosition || outputs.length !== 2) {
+        throw new Error("wallet_anchor_change_position_mismatch");
+    }
+    if (outputs[funded.changepos]?.scriptPubKey?.hex !== plan.allowedFundingScriptPubKeyHex) {
+        throw new Error("wallet_anchor_change_output_mismatch");
+    }
+}

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

@@ -0,0 +1,25 @@
+import type { PendingMutationRecord } from "../../types.js";
+import type { WalletMutationFeeSummary } from "../common.js";
+import type { AnchorMutationOperation } from "./intent.js";
+export interface AnchorDomainResult {
+    domainName: string;
+    txid: string;
+    status: "live" | "confirmed";
+    reusedExisting: boolean;
+    foundingMessageText?: string | null;
+    fees: WalletMutationFeeSummary;
+}
+export declare function createAnchorReuseResult(options: {
+    operation: AnchorMutationOperation;
+    mutation: PendingMutationRecord;
+    resolution: "confirmed" | "live";
+    fees: WalletMutationFeeSummary;
+}): AnchorDomainResult;
+export declare function createAnchorResult(options: {
+    operation: AnchorMutationOperation;
+    mutation: PendingMutationRecord;
+    builtTxid: string | null;
+    status: "live" | "confirmed";
+    reusedExisting: boolean;
+    fees: WalletMutationFeeSummary;
+}): AnchorDomainResult;

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

@@ -0,0 +1,20 @@
+export function createAnchorReuseResult(options) {
+    return {
+        domainName: options.operation.normalizedDomainName,
+        txid: options.mutation.attemptedTxid ?? "unknown",
+        status: options.resolution,
+        reusedExisting: true,
+        foundingMessageText: options.operation.message.text,
+        fees: options.fees,
+    };
+}
+export function createAnchorResult(options) {
+    return {
+        domainName: options.operation.normalizedDomainName,
+        txid: options.mutation.attemptedTxid ?? options.builtTxid ?? "unknown",
+        status: options.status,
+        reusedExisting: options.reusedExisting,
+        foundingMessageText: options.operation.message.text,
+        fees: options.fees,
+    };
+}

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

@@ -1,39 +1 @@
-import { attachOrStartManagedBitcoindService } from "../../bitcoind/service.js";
-import { createRpcClient } from "../../bitcoind/node.js";
-import type { WalletPrompter } from "../lifecycle.js";
-import { type WalletRuntimePaths } from "../runtime.js";
-import { type WalletSecretProvider } from "../state/provider.js";
-import { openWalletReadContext } from "../read/index.js";
-import { type WalletMutationFeeSummary, type WalletMutationRpcClient } from "./common.js";
-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 AnchorDomainResult {
-    domainName: string;
-    txid: string;
-    status: "live" | "confirmed";
-    reusedExisting: boolean;
-    foundingMessageText?: string | null;
-    fees: WalletMutationFeeSummary;
-}
-export declare function anchorDomain(options: AnchorDomainOptions): Promise<AnchorDomainResult>;
-export {};
+export * from "./anchor/index.js";