@cogcoin/client 1.1.3 → 1.1.4

package/README.md

@@ -1,6 +1,6 @@
 # `@cogcoin/client`
 
-`@cogcoin/client@1.1.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.1.4` 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/node.js

@@ -5,6 +5,7 @@ import { promisify } from "node:util";
 import net from "node:net";
 import { getBitcoindPath } from "@cogcoin/bitcoin";
 import { resolveDefaultBitcoindDataDirForTesting } from "../app-paths.js";
+import { DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS } from "./types.js";
 import { BitcoinRpcClient } from "./rpc.js";
 const execFileAsync = promisify(execFile);
 const SUPPORTED_BITCOIND_VERSION = "30.2.0";
@@ -156,7 +157,7 @@ export async function launchManagedBitcoindNode(options) {
         endpoint: zmqEndpoint,
         topic: "hashblock",
         port: zmqPort,
-        pollIntervalMs: options.pollIntervalMs ?? 15_000,
+        pollIntervalMs: options.pollIntervalMs ?? DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS,
     };
     const child = spawn(bitcoindPath, buildBitcoindArgsForTesting(resolvedOptions, rpcPort, zmqPort, p2pPort), {
         stdio: ["ignore", "pipe", "pipe"],

package/dist/bitcoind/service.js

@@ -2,7 +2,6 @@ import { randomBytes } from "node:crypto";
 import { execFile, spawn } from "node:child_process";
 import { access, constants, mkdir, readFile, readdir, rm } from "node:fs/promises";
 import { dirname, join } from "node:path";
-import { totalmem } from "node:os";
 import { promisify } from "node:util";
 import net from "node:net";
 import { getBitcoindPath } from "@cogcoin/bitcoin";
@@ -12,37 +11,20 @@ import { writeRuntimeStatusFile } from "../wallet/fs/status-file.js";
 import { stopIndexerDaemonServiceWithLockHeld } from "./indexer-daemon.js";
 import { createRpcClient, validateNodeConfigForTesting } from "./node.js";
 import { resolveManagedServicePaths, UNINITIALIZED_WALLET_ROOT_ID } from "./service-paths.js";
-import { MANAGED_BITCOIND_SERVICE_API_VERSION as MANAGED_BITCOIND_SERVICE_API_VERSION_VALUE } from "./types.js";
+import { DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS, MANAGED_BITCOIND_SERVICE_API_VERSION as MANAGED_BITCOIND_SERVICE_API_VERSION_VALUE, } from "./types.js";
 const execFileAsync = promisify(execFile);
 const LOCAL_HOST = "127.0.0.1";
 const SUPPORTED_BITCOIND_VERSION = "30.2.0";
 const DEFAULT_STARTUP_TIMEOUT_MS = 30_000;
 const DEFAULT_SHUTDOWN_TIMEOUT_MS = 15_000;
-const DEFAULT_DBCACHE_MIB = 450;
+const DEFAULT_DBCACHE_MIB = 4096;
 const claimedUninitializedRuntimeKeys = new Set();
-const GIB = 1024 ** 3;
 export function resolveManagedBitcoindDbcacheMiB(totalRamBytes) {
-    if (!Number.isFinite(totalRamBytes) || totalRamBytes <= 0) {
-        return DEFAULT_DBCACHE_MIB;
-    }
-    if (totalRamBytes < 8 * GIB) {
-        return 450;
-    }
-    if (totalRamBytes < 16 * GIB) {
-        return 768;
-    }
-    if (totalRamBytes < 32 * GIB) {
-        return 1024;
-    }
-    return 2048;
+    void totalRamBytes;
+    return DEFAULT_DBCACHE_MIB;
 }
 function detectManagedBitcoindDbcacheMiB() {
-    try {
-        return resolveManagedBitcoindDbcacheMiB(totalmem());
-    }
-    catch {
-        return DEFAULT_DBCACHE_MIB;
-    }
+    return DEFAULT_DBCACHE_MIB;
 }
 function sleep(ms) {
     return new Promise((resolve) => {
@@ -826,7 +808,7 @@ export async function attachOrStartManagedBitcoindService(options) {
                         endpoint: `tcp://${LOCAL_HOST}:${runtimeConfig.zmqPort}`,
                         topic: "hashblock",
                         port: runtimeConfig.zmqPort,
-                        pollIntervalMs: startOptions.pollIntervalMs ?? 15_000,
+                        pollIntervalMs: startOptions.pollIntervalMs ?? DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS,
                     };
                     const spawnOptions = startOptions.serviceLifetime === "ephemeral"
                         ? {

package/dist/bitcoind/types.d.ts

@@ -87,6 +87,7 @@ export interface ManagedBitcoindRuntimeConfig {
     getblockArchiveEndHeight?: number | null;
     getblockArchiveSha256?: string | null;
 }
+export declare const DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS = 2000;
 export declare const MANAGED_BITCOIND_SERVICE_API_VERSION = "cogcoin/bitcoind-service/v1";
 export type ManagedBitcoindServiceState = "starting" | "ready" | "stopping" | "failed";
 export interface ManagedBitcoindServiceStatus {

package/dist/bitcoind/types.js

@@ -1,3 +1,4 @@
+export const DEFAULT_MANAGED_BITCOIND_FOLLOW_POLL_INTERVAL_MS = 2_000;
 export const MANAGED_BITCOIND_SERVICE_API_VERSION = "cogcoin/bitcoind-service/v1";
 export const INDEXER_DAEMON_SERVICE_API_VERSION = "cogcoin/indexer-ipc/v1";
 export const INDEXER_DAEMON_SCHEMA_VERSION = "cogcoin/indexer-db/v1";

package/dist/wallet/read/context.d.ts

@@ -1,6 +1,6 @@
 import { readSnapshotWithRetry } from "../../bitcoind/indexer-daemon.js";
 import { type WalletSecretProvider } from "../state/provider.js";
-import type { WalletLocalStateStatus, WalletReadContext } from "./types.js";
+import type { WalletBitcoindStatus, WalletLocalStateStatus, WalletNodeStatus, WalletReadContext, WalletServiceHealth } from "./types.js";
 import type { WalletRuntimePaths } from "../runtime.js";
 declare function inspectWalletLocalState(options?: {
     dataDir?: string;
@@ -9,6 +9,10 @@ declare function inspectWalletLocalState(options?: {
     paths?: WalletRuntimePaths;
     walletControlLockHeld?: boolean;
 }): Promise<WalletLocalStateStatus>;
+export declare function deriveNodeHealthForTesting(status: WalletNodeStatus | null, bitcoindHealth: WalletBitcoindStatus["health"]): {
+    health: WalletServiceHealth;
+    message: string | null;
+};
 export declare function openWalletReadContext(options: {
     dataDir: string;
     databasePath: string;

package/dist/wallet/read/context.js

@@ -20,6 +20,9 @@ import { describeClientPasswordLockedMessage, describeClientPasswordMigrationMes
 import { createWalletReadModel } from "./project.js";
 const DEFAULT_SERVICE_START_TIMEOUT_MS = 10_000;
 const STALE_HEARTBEAT_THRESHOLD_MS = 15_000;
+const TOLERATED_NODE_HEADER_LEAD_BLOCKS = 2;
+const TOLERATED_NODE_HEADER_LEAD_MESSAGE = "Bitcoin headers can briefly lead validated blocks; a short 1-2 block lead is normal and is being tolerated.";
+const NODE_CATCHING_UP_MESSAGE = "Bitcoin Core is still catching up to headers.";
 function btcAmountToSats(value) {
     return BigInt(Math.round(value * 100_000_000));
 }
@@ -351,14 +354,23 @@ function deriveBitcoindHealth(options) {
 function deriveNodeHealth(status, bitcoindHealth) {
     if (bitcoindHealth !== "ready" || status === null || !status.ready) {
         return {
-            health: "unavailable",
-            message: "Bitcoin service is unavailable.",
+            health: "catching-up",
+            message: NODE_CATCHING_UP_MESSAGE,
         };
     }
-    if (status.nodeBestHeight !== null && status.nodeHeaderHeight !== null && status.nodeBestHeight < status.nodeHeaderHeight) {
+    const headerLead = status.nodeBestHeight !== null && status.nodeHeaderHeight !== null
+        ? status.nodeHeaderHeight - status.nodeBestHeight
+        : null;
+    if (headerLead !== null && headerLead > 0) {
+        if (headerLead <= TOLERATED_NODE_HEADER_LEAD_BLOCKS) {
+            return {
+                health: "synced",
+                message: TOLERATED_NODE_HEADER_LEAD_MESSAGE,
+            };
+        }
         return {
             health: "catching-up",
-            message: "Bitcoin Core is still catching up to headers.",
+            message: NODE_CATCHING_UP_MESSAGE,
         };
     }
     return {
@@ -366,6 +378,9 @@ function deriveNodeHealth(status, bitcoindHealth) {
         message: null,
     };
 }
+export function deriveNodeHealthForTesting(status, bitcoindHealth) {
+    return deriveNodeHealth(status, bitcoindHealth);
+}
 function deriveIndexerHealth(options) {
     const daemonStatus = options.source === "lease"
         ? options.daemonStatus

package/package.json

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