@cogcoin/client 1.2.0 → 1.2.1

package/README.md

@@ -1,6 +1,6 @@
 # `@cogcoin/client`
 
-`@cogcoin/client@1.2.0` is the reference Cogcoin client package for applications that want a local wallet, durable SQLite-backed state, and a managed Bitcoin Core integration around `@cogcoin/indexer`. It publishes the reusable client APIs, the SQLite adapter, the managed `bitcoind` integration, and the first-party `cogcoin` CLI in one package.
+`@cogcoin/client@1.2.1` is the reference Cogcoin client package for applications that want a local wallet, durable SQLite-backed state, and a managed Bitcoin Core integration around `@cogcoin/indexer`. It publishes the reusable client APIs, the SQLite adapter, the managed `bitcoind` integration, and the first-party `cogcoin` CLI in one package.
 
 Use Node 22 or newer.
 

package/dist/bitcoind/managed-runtime/bitcoind-policy.js

@@ -8,6 +8,9 @@ function isRuntimeMismatchError(error) {
     return error.message.startsWith("bitcoind_chain_expected_")
         || error.message === "managed_bitcoind_runtime_mismatch";
 }
+function isMissingRawTxZmqError(error) {
+    return error instanceof Error && error.message === "bitcoind_zmq_rawtx_missing";
+}
 function isUnreachableManagedBitcoindError(error) {
     if (error instanceof Error) {
         if ("code" in error) {
@@ -47,6 +50,13 @@ export function mapManagedBitcoindValidationError(error, status) {
     };
 }
 export function mapManagedBitcoindRuntimeProbeFailure(error, status) {
+    if (isMissingRawTxZmqError(error)) {
+        return {
+            compatibility: "rawtx-zmq-missing",
+            status,
+            error: "bitcoind_zmq_rawtx_missing",
+        };
+    }
     if (isRuntimeMismatchError(error)) {
         return {
             compatibility: "runtime-mismatch",

package/dist/bitcoind/managed-runtime/types.d.ts

@@ -2,7 +2,7 @@ import type { ClientTip } from "../../types.js";
 import type { ManagedServicePaths } from "../service-paths.js";
 import type { ManagedBitcoindObservedStatus, ManagedIndexerDaemonObservedStatus, ManagedIndexerTruthSource } from "../types.js";
 import type { WalletBitcoindStatus, WalletIndexerStatus, WalletNodeStatus, WalletServiceHealth, WalletSnapshotView } from "../../wallet/read/types.js";
-export type ManagedBitcoindServiceCompatibility = "compatible" | "service-version-mismatch" | "wallet-root-mismatch" | "runtime-mismatch" | "unreachable" | "protocol-error";
+export type ManagedBitcoindServiceCompatibility = "compatible" | "service-version-mismatch" | "wallet-root-mismatch" | "runtime-mismatch" | "rawtx-zmq-missing" | "unreachable" | "protocol-error";
 export interface ManagedBitcoindServiceProbeResult {
     compatibility: ManagedBitcoindServiceCompatibility;
     status: ManagedBitcoindObservedStatus | null;

package/dist/cli/output/rules/services.js

@@ -108,6 +108,13 @@ export const serviceErrorRules = [
                 next: "Run `cogcoin repair` so the wallet can clear the conflicting runtime and restart a compatible managed bitcoind service.",
             };
         }
+        if (errorCode === "bitcoind_zmq_rawtx_missing" || errorCode.includes("rawtx_zmq_missing")) {
+            return {
+                what: "The live managed bitcoind service is missing raw transaction ZMQ.",
+                why: "This usually means an older managed bitcoind runtime is still running without the v1.2.0 `zmqpubrawtx` setting.",
+                next: "Run `cogcoin repair` so the wallet can stop the stale managed bitcoind service and restart it with the current ZMQ configuration.",
+            };
+        }
         if (errorCode.includes("bitcoind_replica_missing")) {
             return {
                 what: "The managed Core wallet replica is missing.",

package/dist/wallet/lifecycle/repair-bitcoind.js

@@ -33,28 +33,38 @@ export async function repairManagedBitcoindStage(options) {
         bitcoindCompatibilityIssue = mapBitcoindCompatibilityToRepairIssue(initialBitcoindProbe.compatibility);
         if (initialBitcoindProbe.compatibility === "service-version-mismatch"
             || initialBitcoindProbe.compatibility === "wallet-root-mismatch"
-            || initialBitcoindProbe.compatibility === "runtime-mismatch") {
+            || initialBitcoindProbe.compatibility === "runtime-mismatch"
+            || initialBitcoindProbe.compatibility === "rawtx-zmq-missing") {
             const processId = initialBitcoindProbe.status?.processId ?? null;
             if (processId === null) {
-                throw new Error("managed_bitcoind_process_id_unavailable");
-            }
-            try {
-                process.kill(processId, "SIGTERM");
+                if (initialBitcoindProbe.compatibility !== "rawtx-zmq-missing") {
+                    throw new Error("managed_bitcoind_process_id_unavailable");
+                }
+                await clearManagedBitcoindArtifacts(options.servicePaths);
+                bitcoindServiceAction = "restarted-missing-rawtx-zmq";
             }
-            catch (error) {
-                if (!(error instanceof Error) || !("code" in error) || error.code !== "ESRCH") {
-                    throw error;
+            else {
+                try {
+                    process.kill(processId, "SIGTERM");
                 }
+                catch (error) {
+                    if (!(error instanceof Error) || !("code" in error) || error.code !== "ESRCH") {
+                        throw error;
+                    }
+                }
+                await waitForProcessExit(processId, 15_000, "managed_bitcoind_stop_timeout");
+                await clearManagedBitcoindArtifacts(options.servicePaths);
+                bitcoindServiceAction = initialBitcoindProbe.compatibility === "rawtx-zmq-missing"
+                    ? "restarted-missing-rawtx-zmq"
+                    : "stopped-incompatible-service";
             }
-            await waitForProcessExit(processId, 15_000, "managed_bitcoind_stop_timeout");
-            await clearManagedBitcoindArtifacts(options.servicePaths);
-            bitcoindServiceAction = "stopped-incompatible-service";
         }
         else if (initialBitcoindProbe.compatibility === "unreachable") {
             const hasStaleArtifacts = await Promise.all([
                 options.servicePaths.bitcoindStatusPath,
                 options.servicePaths.bitcoindPidPath,
                 options.servicePaths.bitcoindReadyPath,
+                options.servicePaths.bitcoindRuntimeConfigPath,
                 options.servicePaths.bitcoindWalletStatusPath,
             ].map(pathExists));
             if (hasStaleArtifacts.some(Boolean)) {

package/dist/wallet/lifecycle/repair-runtime.js

@@ -69,6 +69,8 @@ export function mapBitcoindCompatibilityToRepairIssue(compatibility) {
             return "wallet-root-mismatch";
         case "runtime-mismatch":
             return "runtime-mismatch";
+        case "rawtx-zmq-missing":
+            return "rawtx-zmq-missing";
         default:
             return "none";
     }
@@ -169,6 +171,7 @@ export async function clearManagedBitcoindArtifacts(servicePaths) {
     await rm(servicePaths.bitcoindStatusPath, { force: true }).catch(() => undefined);
     await rm(servicePaths.bitcoindPidPath, { force: true }).catch(() => undefined);
     await rm(servicePaths.bitcoindReadyPath, { force: true }).catch(() => undefined);
+    await rm(servicePaths.bitcoindRuntimeConfigPath, { force: true }).catch(() => undefined);
     await rm(servicePaths.bitcoindWalletStatusPath, { force: true }).catch(() => undefined);
 }
 export async function stopRecordedManagedProcess(pid, errorCode) {

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

@@ -36,8 +36,8 @@ export interface WalletRepairResult {
     recoveredFromBackup: boolean;
     recreatedManagedCoreWallet: boolean;
     resetIndexerDatabase: boolean;
-    bitcoindServiceAction: "none" | "cleared-stale-artifacts" | "stopped-incompatible-service" | "restarted-compatible-service";
-    bitcoindCompatibilityIssue: "none" | "service-version-mismatch" | "wallet-root-mismatch" | "runtime-mismatch";
+    bitcoindServiceAction: "none" | "cleared-stale-artifacts" | "stopped-incompatible-service" | "restarted-compatible-service" | "restarted-missing-rawtx-zmq";
+    bitcoindCompatibilityIssue: "none" | "service-version-mismatch" | "wallet-root-mismatch" | "runtime-mismatch" | "rawtx-zmq-missing";
     managedCoreReplicaAction: "none" | "recreated";
     bitcoindPostRepairHealth: "ready" | "catching-up" | "starting" | "failed" | "unavailable";
     indexerDaemonAction: "none" | "cleared-stale-artifacts" | "stopped-incompatible-daemon" | "restarted-compatible-daemon";

package/package.json

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