@cogcoin/client 1.1.7 → 1.1.9

package/dist/wallet/tx/state-persist.js

@@ -0,0 +1,54 @@
+import { saveWalletState } from "../state/storage.js";
+import { createWalletSecretReference, } from "../state/provider.js";
+import { outpointKey } from "./primitives.js";
+export async function saveWalletStatePreservingUnlock(options) {
+    const secretReference = createWalletSecretReference(options.state.walletRootId);
+    await saveWalletState({
+        primaryPath: options.paths.walletStatePath,
+        backupPath: options.paths.walletStateBackupPath,
+    }, options.state, {
+        provider: options.provider,
+        secretReference,
+    });
+}
+export function updateMutationRecord(mutation, status, nowUnixMs, options = {}) {
+    return {
+        ...mutation,
+        status,
+        lastUpdatedAtUnixMs: nowUnixMs,
+        attemptedTxid: options.attemptedTxid ?? mutation.attemptedTxid,
+        attemptedWtxid: options.attemptedWtxid ?? mutation.attemptedWtxid,
+        temporaryBuilderLockedOutpoints: options.temporaryBuilderLockedOutpoints ?? mutation.temporaryBuilderLockedOutpoints,
+        selectedFeeRateSatVb: options.selectedFeeRateSatVb ?? mutation.selectedFeeRateSatVb,
+        feeSelectionSource: options.feeSelectionSource ?? mutation.feeSelectionSource,
+    };
+}
+export async function unlockTemporaryBuilderLocks(rpc, walletName, outpoints) {
+    if (outpoints.length === 0 || rpc.lockUnspent === undefined) {
+        return;
+    }
+    await rpc.lockUnspent(walletName, true, outpoints).catch(() => undefined);
+}
+export function diffTemporaryLockedOutpoints(before, after) {
+    const beforeKeys = new Set(before.map((entry) => outpointKey(entry)));
+    return after
+        .filter((entry) => !beforeKeys.has(outpointKey(entry)))
+        .map((entry) => ({
+        txid: entry.txid,
+        vout: entry.vout,
+    }));
+}
+export async function persistWalletMutationState(options) {
+    const nextState = {
+        ...options.state,
+        stateRevision: options.state.stateRevision + 1,
+        lastWrittenAtUnixMs: options.nowUnixMs,
+    };
+    await saveWalletStatePreservingUnlock({
+        state: nextState,
+        provider: options.provider,
+        nowUnixMs: options.nowUnixMs,
+        paths: options.paths,
+    });
+    return nextState;
+}

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

@@ -0,0 +1,44 @@
+import type { RpcDecodedPsbt, RpcEstimateSmartFeeResult, RpcFinalizePsbtResult, RpcListUnspentEntry, RpcLockedUnspent, RpcMempoolEntry, RpcTestMempoolAcceptResult, RpcTransaction, RpcWalletTransaction, RpcWalletCreateFundedPsbtResult, RpcWalletProcessPsbtResult } from "../../bitcoind/types.js";
+import type { OutpointRecord, WalletStateV1 } from "../types.js";
+export interface MutationSender {
+    localIndex: number;
+    scriptPubKeyHex: string;
+    address: string;
+}
+export interface WalletMutationRpcClient {
+    listUnspent(walletName: string, minConf?: number): Promise<RpcListUnspentEntry[]>;
+    listLockUnspent?(walletName: string): Promise<RpcLockedUnspent[]>;
+    lockUnspent?(walletName: string, unlock: boolean, outputs: RpcLockedUnspent[]): Promise<boolean>;
+    getTransaction?(walletName: string, txid: string): Promise<RpcWalletTransaction>;
+    getRawTransaction?(txid: string, verbose?: boolean): Promise<RpcTransaction>;
+    getMempoolEntry?(txid: string): Promise<RpcMempoolEntry>;
+    estimateSmartFee?(confirmTarget: number, mode: "conservative" | "economical"): Promise<RpcEstimateSmartFeeResult>;
+    walletCreateFundedPsbt(walletName: string, inputs: Array<{
+        txid: string;
+        vout: number;
+    }>, outputs: unknown[], locktime: number, options: Record<string, unknown>, bip32Derivs?: boolean): Promise<RpcWalletCreateFundedPsbtResult>;
+    decodePsbt(psbt: string): Promise<RpcDecodedPsbt>;
+    walletPassphrase(walletName: string, passphrase: string, timeoutSeconds: number): Promise<null>;
+    walletProcessPsbt(walletName: string, psbt: string, sign?: boolean, sighashType?: string): Promise<RpcWalletProcessPsbtResult>;
+    walletLock(walletName: string): Promise<null>;
+    finalizePsbt(psbt: string, extract?: boolean): Promise<RpcFinalizePsbtResult>;
+    decodeRawTransaction(hex: string): Promise<RpcTransaction>;
+    testMempoolAccept(rawTransactions: string[]): Promise<RpcTestMempoolAcceptResult[]>;
+}
+export interface BuiltWalletMutationTransaction {
+    funded: RpcWalletCreateFundedPsbtResult;
+    decoded: RpcDecodedPsbt;
+    psbt: string;
+    rawHex: string;
+    txid: string;
+    wtxid: string | null;
+    temporaryBuilderLockedOutpoints: OutpointRecord[];
+}
+export interface FixedWalletInput extends OutpointRecord {
+}
+export type WalletMutationReadyReadState = {
+    localState: {
+        availability: "ready";
+        state: WalletStateV1;
+    };
+};

package/dist/wallet/tx/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cogcoin/client",
-  "version": "1.1.7",
+  "version": "1.1.9",
   "description": "Store-backed Cogcoin client with wallet flows, SQLite persistence, and managed Bitcoin Core integration.",
   "license": "MIT",
   "type": "module",

package/dist/cli/mining-json.d.ts

@@ -1,20 +0,0 @@
-import type { MiningControlPlaneView, MiningDomainPromptMutationResult } from "../wallet/mining/index.js";
-export declare function buildMineSetupData(view: MiningControlPlaneView): {
-    resultType: "state-change";
-    stateChange: {
-        kind: string;
-        before: Record<string, unknown> | null;
-        after: Record<string, unknown> | null;
-    };
-    state: Record<string, unknown>;
-};
-export declare function buildMinePromptData(result: MiningDomainPromptMutationResult): {
-    domain: {
-        name: string;
-        domainId: number | null;
-    };
-    previousPrompt: string | null;
-    prompt: string | null;
-    status: "updated" | "cleared";
-    fallbackPromptConfigured: boolean;
-};

package/dist/cli/mining-json.js

@@ -1,46 +0,0 @@
-import { buildStateChangeData } from "./mutation-json.js";
-function summarizeRuntime(snapshot) {
-    if (snapshot === null) {
-        return null;
-    }
-    return {
-        runMode: snapshot.runMode,
-        miningState: snapshot.miningState,
-        currentPhase: snapshot.currentPhase,
-        backgroundWorkerPid: snapshot.backgroundWorkerPid,
-        backgroundWorkerRunId: snapshot.backgroundWorkerRunId,
-        note: snapshot.note,
-    };
-}
-export function buildMineSetupData(view) {
-    const after = {
-        provider: {
-            configured: view.provider.configured,
-            provider: view.provider.provider,
-            status: view.provider.status,
-            modelId: view.provider.modelId,
-            modelOverride: view.provider.modelOverride,
-            modelSelectionSource: view.provider.modelSelectionSource,
-            effectiveModel: view.provider.effectiveModel,
-            usingDefaultModel: view.provider.usingDefaultModel,
-            extraPromptConfigured: view.provider.extraPromptConfigured,
-            estimatedDailyCostUsd: view.provider.estimatedDailyCostUsd,
-            estimatedDailyCostDisplay: view.provider.estimatedDailyCostDisplay,
-        },
-        runtime: summarizeRuntime(view.runtime),
-    };
-    return buildStateChangeData({
-        kind: "mine-setup",
-        state: after,
-        after,
-    });
-}
-export function buildMinePromptData(result) {
-    return {
-        domain: result.domain,
-        previousPrompt: result.previousPrompt,
-        prompt: result.prompt,
-        status: result.status,
-        fallbackPromptConfigured: result.fallbackPromptConfigured,
-    };
-}

package/dist/cli/mutation-json.d.ts

@@ -1,325 +0,0 @@
-import type { AnchorDomainResult, BitcoinTransferResult, CogMutationResult, DomainAdminMutationResult, DomainMarketMutationResult, FieldMutationResult, RegisterDomainResult, ReputationMutationResult, WalletMutationFeeSummary } from "../wallet/tx/index.js";
-import type { WalletInitializationResult, WalletRepairResult, WalletResetResult } from "../wallet/lifecycle.js";
-export declare function buildSingleTxMutationData(options: {
-    kind: string;
-    localStatus: string;
-    txid: string | null | undefined;
-    wtxid?: string | null | undefined;
-    reusedExisting: boolean;
-    intent: Record<string, unknown>;
-    fees: WalletMutationFeeSummary;
-    journalKind?: string | null;
-    intentFingerprintHex?: string | null;
-}): {
-    resultType: "single-tx-mutation";
-    mutation: {
-        kind: string;
-        journalKind: string;
-        localStatus: string;
-        reusedExisting: boolean;
-        intentFingerprintHex: string | null;
-    };
-    transaction: {
-        txid: string | null;
-        wtxid: string | null;
-    };
-    fees: WalletMutationFeeSummary;
-    intent: Record<string, unknown>;
-};
-export declare function buildStateChangeData(options: {
-    kind: string;
-    state: Record<string, unknown>;
-    before?: Record<string, unknown> | null;
-    after?: Record<string, unknown> | null;
-}): {
-    resultType: "state-change";
-    stateChange: {
-        kind: string;
-        before: Record<string, unknown> | null;
-        after: Record<string, unknown> | null;
-    };
-    state: Record<string, unknown>;
-};
-export declare function buildOperationData(options: {
-    kind: string;
-    state?: Record<string, unknown> | null;
-    operation: Record<string, unknown>;
-}): {
-    resultType: "operation";
-    operation: {
-        kind: string;
-    };
-    state: Record<string, unknown> | null;
-};
-export declare function buildBitcoinTransferData(result: BitcoinTransferResult): {
-    resultType: "operation";
-    operation: {
-        kind: string;
-    };
-    state: Record<string, unknown> | null;
-};
-export declare function buildRegisterMutationData(result: RegisterDomainResult, options: {
-    forceRace: boolean;
-}): {
-    resolved: {
-        path: "root" | "subdomain";
-        parentDomainName: string | null;
-        sender: {
-            selector: string;
-            localIndex: number;
-            scriptPubKeyHex: string;
-            address: string;
-        };
-        economicEffect: {
-            kind: "treasury-payment" | "cog-burn";
-            amount: string | null;
-        };
-    };
-    resultType: "single-tx-mutation";
-    mutation: {
-        kind: string;
-        journalKind: string;
-        localStatus: string;
-        reusedExisting: boolean;
-        intentFingerprintHex: string | null;
-    };
-    transaction: {
-        txid: string | null;
-        wtxid: string | null;
-    };
-    fees: WalletMutationFeeSummary;
-    intent: Record<string, unknown>;
-};
-export declare function buildDomainMarketMutationData(result: DomainMarketMutationResult, options: {
-    commandKind: "transfer" | "sell" | "unsell" | "buy";
-}): {
-    resolved: {
-        buyer: {
-            selector: string;
-            localIndex: number;
-            scriptPubKeyHex: string;
-            address: string;
-        } | null;
-        seller: {
-            scriptPubKeyHex: string;
-            address: string | null;
-        } | null;
-        sender?: undefined;
-        recipient?: undefined;
-        economicEffect?: undefined;
-    } | {
-        sender: {
-            selector: string;
-            localIndex: number;
-            scriptPubKeyHex: string;
-            address: string;
-        };
-        recipient: {
-            scriptPubKeyHex: string;
-            address: string | null;
-            opaque: boolean;
-        } | null;
-        economicEffect: {
-            kind: "ownership-transfer";
-            clearsListing: boolean;
-            listedPriceCogtoshi?: undefined;
-        } | {
-            kind: "listing-set" | "listing-clear";
-            listedPriceCogtoshi: string;
-            clearsListing?: undefined;
-        };
-        buyer?: undefined;
-        seller?: undefined;
-    } | null;
-    resultType: "single-tx-mutation";
-    mutation: {
-        kind: string;
-        journalKind: string;
-        localStatus: string;
-        reusedExisting: boolean;
-        intentFingerprintHex: string | null;
-    };
-    transaction: {
-        txid: string | null;
-        wtxid: string | null;
-    };
-    fees: WalletMutationFeeSummary;
-    intent: Record<string, unknown>;
-};
-export declare function buildCogMutationData(result: CogMutationResult, options: {
-    commandKind: "send" | "claim" | "reclaim" | "cog-lock";
-    timeoutBlocksOrDuration?: string | null;
-    timeoutHeight?: string | null;
-    conditionHex?: string | null;
-}): {
-    resolved: {
-        claimPath?: import("../wallet/tx/cog.js").CogResolvedClaimPath | null | undefined;
-        sender: {
-            selector: string;
-            localIndex: number;
-            scriptPubKeyHex: string;
-            address: string;
-        };
-    };
-    resultType: "single-tx-mutation";
-    mutation: {
-        kind: string;
-        journalKind: string;
-        localStatus: string;
-        reusedExisting: boolean;
-        intentFingerprintHex: string | null;
-    };
-    transaction: {
-        txid: string | null;
-        wtxid: string | null;
-    };
-    fees: WalletMutationFeeSummary;
-    intent: Record<string, unknown>;
-};
-export declare function buildAnchorMutationData(result: AnchorDomainResult, options: {
-    foundingMessageText: string | null;
-}): {
-    resultType: "single-tx-mutation";
-    mutation: {
-        kind: string;
-        journalKind: string;
-        localStatus: string;
-        reusedExisting: boolean;
-        intentFingerprintHex: string | null;
-    };
-    transaction: {
-        txid: string | null;
-        wtxid: string | null;
-    };
-    fees: WalletMutationFeeSummary;
-    intent: Record<string, unknown>;
-};
-export declare function buildResetMutationData(result: WalletResetResult): {
-    resultType: "operation";
-    operation: {
-        kind: string;
-    };
-    state: Record<string, unknown> | null;
-};
-export declare function buildDomainAdminMutationData(result: DomainAdminMutationResult, options: {
-    commandKind: "domain-endpoint-set" | "domain-endpoint-clear" | "domain-delegate-set" | "domain-delegate-clear" | "domain-miner-set" | "domain-miner-clear" | "domain-canonical";
-}): {
-    resolved: {
-        sender: {
-            selector: string;
-            localIndex: number;
-            scriptPubKeyHex: string;
-            address: string;
-        };
-        target: {
-            scriptPubKeyHex: string;
-            address: string | null;
-            opaque: boolean;
-        } | null;
-        effect: {
-            kind: "endpoint-set";
-            byteLength: number;
-        } | {
-            kind: "endpoint-clear" | "delegate-set" | "delegate-clear" | "miner-set" | "miner-clear" | "canonicalize-owner";
-            byteLength?: undefined;
-        };
-    } | null;
-    resultType: "single-tx-mutation";
-    mutation: {
-        kind: string;
-        journalKind: string;
-        localStatus: string;
-        reusedExisting: boolean;
-        intentFingerprintHex: string | null;
-    };
-    transaction: {
-        txid: string | null;
-        wtxid: string | null;
-    };
-    fees: WalletMutationFeeSummary;
-    intent: Record<string, unknown>;
-};
-export declare function buildFieldMutationData(result: FieldMutationResult): {
-    resolved: {
-        sender: {
-            selector: string;
-            localIndex: number;
-            scriptPubKeyHex: string;
-            address: string;
-        };
-        path: import("../wallet/tx/field.js").FieldResolvedPath;
-        value: {
-            format: number;
-            byteLength: number;
-        } | null;
-        effect: {
-            kind: "create-empty-field" | "write-field-value" | "clear-field-value";
-            burnCogtoshi: "0" | "1" | "100";
-        };
-    } | null;
-    resultType: "single-tx-mutation";
-    mutation: {
-        kind: string;
-        journalKind: string;
-        localStatus: string;
-        reusedExisting: boolean;
-        intentFingerprintHex: string | null;
-    };
-    transaction: {
-        txid: string | null;
-        wtxid: string | null;
-    };
-    fees: WalletMutationFeeSummary;
-    intent: Record<string, unknown>;
-};
-export declare function buildReputationMutationData(result: ReputationMutationResult): {
-    resolved: {
-        sender: {
-            selector: string;
-            localIndex: number;
-            scriptPubKeyHex: string;
-            address: string;
-        };
-        effect: {
-            kind: "give-support" | "revoke-support";
-            burnCogtoshi: string;
-        };
-        review: {
-            included: boolean;
-            byteLength: number | null;
-        };
-        selfStake: boolean;
-    } | null;
-    resultType: "single-tx-mutation";
-    mutation: {
-        kind: string;
-        journalKind: string;
-        localStatus: string;
-        reusedExisting: boolean;
-        intentFingerprintHex: string | null;
-    };
-    transaction: {
-        txid: string | null;
-        wtxid: string | null;
-    };
-    fees: WalletMutationFeeSummary;
-    intent: Record<string, unknown>;
-};
-export declare function buildInitMutationData(result: WalletInitializationResult): {
-    resultType: "state-change";
-    stateChange: {
-        kind: string;
-        before: Record<string, unknown> | null;
-        after: Record<string, unknown> | null;
-    };
-    state: Record<string, unknown>;
-};
-export declare function buildRepairMutationData(result: WalletRepairResult): {
-    resultType: "state-change";
-    stateChange: {
-        kind: string;
-        before: Record<string, unknown> | null;
-        after: Record<string, unknown> | null;
-    };
-    state: Record<string, unknown>;
-};