@cogcoin/client 0.5.6 → 0.5.8

package/dist/bitcoind/progress/formatting.js

@@ -1,6 +1,10 @@
 import { FIELD_LEFT, FIELD_WIDTH, PREPARING_SYNC_LINE, PROGRESS_TICK_MS, SCROLL_WINDOW_LEFT, SCROLL_WINDOW_WIDTH, STATUS_ELLIPSIS_TICK_MS, STATUS_ELLIPSIS_WIDTH, } from "./constants.js";
 export function createDefaultMessage(phase) {
     switch (phase) {
+        case "getblock_archive_download":
+            return "Downloading getblock archive.";
+        case "getblock_archive_import":
+            return "Bitcoin Core is importing getblock archive blocks.";
         case "snapshot_download":
             return "Downloading UTXO snapshot.";
         case "wait_headers_for_snapshot":
@@ -121,6 +125,10 @@ function animateStatusEllipsis(now) {
 }
 export function resolveStatusFieldText(progress, snapshotHeight, now = 0) {
     switch (progress.phase) {
+        case "getblock_archive_download":
+            return `Downloading getblock archive${animateStatusEllipsis(now)}`;
+        case "getblock_archive_import":
+            return `Importing getblock archive${animateStatusEllipsis(now)}`;
         case "paused":
         case "snapshot_download":
             return `Downloading snapshot to ${snapshotHeight}${animateStatusEllipsis(now)}`;
@@ -166,6 +174,16 @@ export const formatQuoteLineForTesting = formatQuoteLine;
 export function formatProgressLine(progress, cogcoinSyncHeight, cogcoinSyncTargetHeight, width = 120, now = Date.now()) {
     let line;
     switch (progress.phase) {
+        case "getblock_archive_download": {
+            const current = progress.downloadedBytes ?? 0;
+            const total = progress.totalBytes ?? 0;
+            const bar = renderBar(current, total, 20);
+            const percent = progress.percent ?? (total > 0 ? (current / total) * 100 : 0);
+            const speed = progress.bytesPerSecond === null ? "--" : `${formatBytes(progress.bytesPerSecond)}/s`;
+            const resumed = progress.resumed ? " resumed" : "";
+            line = `${bar} ${percent.toFixed(2)}% ${formatBytes(current)} / ${formatBytes(total)} ${speed} ETA ${formatDuration(progress.etaSeconds)}${resumed}`;
+            break;
+        }
         case "snapshot_download": {
             const current = progress.downloadedBytes ?? 0;
             const total = progress.totalBytes ?? 0;
@@ -190,6 +208,13 @@ export function formatProgressLine(progress, cogcoinSyncHeight, cogcoinSyncTarge
             line = `${bar} Bitcoin ${blocks.toLocaleString()} / ${target.toLocaleString()} ETA ${formatDuration(progress.etaSeconds)} ${progress.message}`;
             break;
         }
+        case "getblock_archive_import": {
+            const blocks = progress.blocks ?? 0;
+            const target = progress.targetHeight ?? blocks;
+            const bar = renderBar(blocks, target, 20);
+            line = `${bar} Bitcoin ${blocks.toLocaleString()} / ${target.toLocaleString()} ${progress.message}`;
+            break;
+        }
         case "cogcoin_sync": {
             const current = cogcoinSyncHeight ?? 0;
             const target = cogcoinSyncTargetHeight ?? current;

package/dist/bitcoind/progress/render-policy.d.ts

@@ -0,0 +1,35 @@
+import type { ProgressOutputMode } from "../types.js";
+export interface TtyRenderStream {
+    isTTY?: boolean;
+    columns?: number;
+    write(chunk: string): boolean | void;
+}
+export interface RenderClock {
+    now(): number;
+    setTimeout: typeof setTimeout;
+    clearTimeout: typeof clearTimeout;
+    setInterval: typeof setInterval;
+    clearInterval: typeof clearInterval;
+}
+export interface TtyRenderPolicy {
+    enabled: boolean;
+    linuxHeadlessThrottle: boolean;
+    repaintIntervalMs: number;
+}
+export declare const DEFAULT_RENDER_CLOCK: RenderClock;
+export declare function resolveTtyRenderPolicy(progressOutput: ProgressOutputMode, stream: Pick<TtyRenderStream, "isTTY">, options?: {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+}): TtyRenderPolicy;
+export declare class TtyRenderThrottle {
+    #private;
+    constructor(options: {
+        clock?: RenderClock;
+        intervalMs: number;
+        onRender: () => void;
+        throttled: boolean;
+    });
+    request(): void;
+    flush(): void;
+    cancel(): void;
+}

package/dist/bitcoind/progress/render-policy.js

@@ -0,0 +1,81 @@
+import { HEADLESS_PROGRESS_TICK_MS, PROGRESS_TICK_MS } from "./constants.js";
+export const DEFAULT_RENDER_CLOCK = {
+    now: () => Date.now(),
+    setTimeout,
+    clearTimeout,
+    setInterval,
+    clearInterval,
+};
+export function resolveTtyRenderPolicy(progressOutput, stream, options = {}) {
+    const ttyActive = stream.isTTY === true;
+    const enabled = progressOutput === "none"
+        ? false
+        : progressOutput === "tty"
+            ? true
+            : ttyActive;
+    const env = options.env ?? process.env;
+    const linuxHeadlessThrottle = enabled
+        && ttyActive
+        && (options.platform ?? process.platform) === "linux"
+        && (env.DISPLAY?.trim() ?? "").length === 0
+        && (env.WAYLAND_DISPLAY?.trim() ?? "").length === 0;
+    return {
+        enabled,
+        linuxHeadlessThrottle,
+        repaintIntervalMs: linuxHeadlessThrottle ? HEADLESS_PROGRESS_TICK_MS : PROGRESS_TICK_MS,
+    };
+}
+export class TtyRenderThrottle {
+    #clock;
+    #intervalMs;
+    #onRender;
+    #throttled;
+    #lastRenderAt = null;
+    #pendingTimer = null;
+    constructor(options) {
+        this.#clock = options.clock ?? DEFAULT_RENDER_CLOCK;
+        this.#intervalMs = options.intervalMs;
+        this.#onRender = options.onRender;
+        this.#throttled = options.throttled;
+    }
+    request() {
+        if (!this.#throttled) {
+            this.cancel();
+            this.#renderNow();
+            return;
+        }
+        const now = this.#clock.now();
+        if (this.#lastRenderAt === null || (now - this.#lastRenderAt) >= this.#intervalMs) {
+            this.cancel();
+            this.#renderNow();
+            return;
+        }
+        if (this.#pendingTimer !== null) {
+            return;
+        }
+        const delayMs = Math.max(0, this.#intervalMs - (now - this.#lastRenderAt));
+        this.#pendingTimer = this.#clock.setTimeout(() => {
+            this.#pendingTimer = null;
+            this.#renderNow();
+        }, delayMs);
+    }
+    flush() {
+        if (this.#pendingTimer === null) {
+            return;
+        }
+        this.#clock.clearTimeout(this.#pendingTimer);
+        this.#pendingTimer = null;
+        this.#renderNow();
+    }
+    cancel() {
+        if (this.#pendingTimer === null) {
+            return;
+        }
+        this.#clock.clearTimeout(this.#pendingTimer);
+        this.#pendingTimer = null;
+    }
+    #renderNow() {
+        this.#lastRenderAt = this.#clock.now();
+        this.#onRender();
+    }
+}

package/dist/bitcoind/service-paths.js

@@ -3,9 +3,6 @@ import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
 import { resolveCogcoinPathsForTesting, resolveDefaultBitcoindDataDirForTesting } from "../app-paths.js";
 export const UNINITIALIZED_WALLET_ROOT_ID = "wallet-root-uninitialized";
-function sanitizeWalletRootId(walletRootId) {
-    return walletRootId.replace(/[^a-zA-Z0-9._-]+/g, "-");
-}
 function createDataDirSuffix(dataDir) {
     return createHash("sha256").update(dataDir).digest("hex").slice(0, 12);
 }
@@ -17,7 +14,6 @@ function resolveIndexerDaemonSocketPath(serviceRootId) {
     return join(tmpdir(), `cogcoin-indexer-${socketId}.sock`);
 }
 export function resolveManagedServicePaths(dataDir, walletRootId = UNINITIALIZED_WALLET_ROOT_ID) {
-    const normalizedWalletRootId = sanitizeWalletRootId(walletRootId);
     const defaultPaths = resolveCogcoinPathsForTesting();
     const defaultBitcoindDataDir = resolveDefaultBitcoindDataDirForTesting();
     const useDefaultRoots = dataDir === defaultBitcoindDataDir;
@@ -25,8 +21,8 @@ export function resolveManagedServicePaths(dataDir, walletRootId = UNINITIALIZED
     const runtimeRoot = useDefaultRoots ? defaultPaths.runtimeRoot : join(dataRoot, "runtime");
     const indexerRoot = useDefaultRoots ? defaultPaths.indexerRoot : join(dataRoot, "indexer");
     const serviceRootId = useDefaultRoots
-        ? normalizedWalletRootId
-        : `${normalizedWalletRootId}-${createDataDirSuffix(dataDir)}`;
+        ? "managed"
+        : `managed-${createDataDirSuffix(dataDir)}`;
     const walletRuntimeRoot = join(runtimeRoot, serviceRootId);
     const indexerServiceRoot = join(indexerRoot, serviceRootId);
     return {

package/dist/bitcoind/service.d.ts

@@ -20,7 +20,11 @@ interface ManagedWalletReplicaRpc {
     }>;
     walletLock(walletName: string): Promise<null>;
 }
-type ManagedBitcoindServiceOptions = Pick<InternalManagedBitcoindOptions, "dataDir" | "chain" | "startHeight" | "walletRootId" | "rpcPort" | "zmqPort" | "p2pPort" | "pollIntervalMs" | "startupTimeoutMs" | "shutdownTimeoutMs" | "managedWalletPassphrase">;
+type ManagedBitcoindServiceOptions = Pick<InternalManagedBitcoindOptions, "dataDir" | "chain" | "startHeight" | "walletRootId" | "rpcPort" | "zmqPort" | "p2pPort" | "pollIntervalMs" | "startupTimeoutMs" | "shutdownTimeoutMs" | "managedWalletPassphrase"> & {
+    getblockArchivePath?: string | null;
+    getblockArchiveEndHeight?: number | null;
+    getblockArchiveSha256?: string | null;
+};
 export type ManagedBitcoindServiceCompatibility = "compatible" | "service-version-mismatch" | "wallet-root-mismatch" | "runtime-mismatch" | "unreachable" | "protocol-error";
 export interface ManagedBitcoindServiceProbeResult {
     compatibility: ManagedBitcoindServiceCompatibility;

package/dist/bitcoind/service.js

@@ -226,15 +226,13 @@ async function waitForRpcReady(rpc, cookieFile, expectedChain, timeoutMs) {
     throw lastError instanceof Error ? lastError : new Error("bitcoind_rpc_timeout");
 }
 function validateManagedBitcoindStatus(status, options, runtimeRoot) {
+    const legacyRuntimeRoot = join(resolveManagedServicePaths(options.dataDir ?? "", options.walletRootId ?? UNINITIALIZED_WALLET_ROOT_ID).runtimeRoot, status.walletRootId);
     if (status.serviceApiVersion !== MANAGED_BITCOIND_SERVICE_API_VERSION_VALUE) {
         throw new Error("managed_bitcoind_service_version_mismatch");
     }
-    if (status.walletRootId !== (options.walletRootId ?? UNINITIALIZED_WALLET_ROOT_ID)) {
-        throw new Error("managed_bitcoind_wallet_root_mismatch");
-    }
     if (status.chain !== options.chain
         || status.dataDir !== (options.dataDir ?? "")
-        || status.runtimeRoot !== runtimeRoot) {
+        || (status.runtimeRoot !== runtimeRoot && status.runtimeRoot !== legacyRuntimeRoot)) {
         throw new Error("managed_bitcoind_runtime_mismatch");
     }
 }
@@ -275,6 +273,8 @@ function createBitcoindServiceStatus(options) {
         rpc: options.rpc,
         zmq: options.zmq,
         p2pPort: options.p2pPort,
+        getblockArchiveEndHeight: options.getblockArchiveEndHeight,
+        getblockArchiveSha256: options.getblockArchiveSha256,
         walletReplica: options.walletReplica,
         startedAtUnixMs: options.startedAtUnixMs,
         heartbeatAtUnixMs: options.heartbeatAtUnixMs,
@@ -287,9 +287,7 @@ function mapManagedBitcoindValidationError(error) {
         compatibility: error instanceof Error
             ? error.message === "managed_bitcoind_service_version_mismatch"
                 ? "service-version-mismatch"
-                : error.message === "managed_bitcoind_wallet_root_mismatch"
-                    ? "wallet-root-mismatch"
-                    : "runtime-mismatch"
+                : "runtime-mismatch"
             : "protocol-error",
         status: null,
         error: error instanceof Error ? error.message : "managed_bitcoind_protocol_error",
@@ -366,6 +364,8 @@ async function resolveRuntimeConfig(statusPath, configPath, options) {
         zmqPort,
         p2pPort,
         dbcacheMiB: detectManagedBitcoindDbcacheMiB(),
+        getblockArchiveEndHeight: options.getblockArchiveEndHeight ?? null,
+        getblockArchiveSha256: options.getblockArchiveSha256 ?? null,
     };
 }
 async function writeBitcoinConf(filePath, options, runtimeConfig) {
@@ -407,6 +407,9 @@ function buildManagedServiceArgs(options, runtimeConfig) {
     if (options.chain === "regtest") {
         args.push("-chain=regtest");
     }
+    if (options.getblockArchivePath !== undefined && options.getblockArchivePath !== null) {
+        args.push(`-loadblock=${options.getblockArchivePath}`);
+    }
     return args;
 }
 export async function writeBitcoinConfForTesting(filePath, options, runtimeConfig) {
@@ -547,6 +550,8 @@ async function writeBitcoindStatus(paths, status) {
         rpc: status.rpc,
         zmqPort: status.zmq.port,
         p2pPort: status.p2pPort,
+        getblockArchiveEndHeight: status.getblockArchiveEndHeight,
+        getblockArchiveSha256: status.getblockArchiveSha256,
     });
 }
 async function clearManagedBitcoindRuntimeArtifacts(paths) {
@@ -590,6 +595,11 @@ export async function stopManagedBitcoindServiceWithLockHeld(options) {
 }
 export async function withClaimedUninitializedManagedRuntime(options, callback) {
     const targetWalletRootId = options.walletRootId ?? UNINITIALIZED_WALLET_ROOT_ID;
+    const targetPaths = resolveManagedServicePaths(options.dataDir, targetWalletRootId);
+    const uninitializedPaths = resolveManagedServicePaths(options.dataDir, UNINITIALIZED_WALLET_ROOT_ID);
+    if (targetPaths.walletRuntimeRoot === uninitializedPaths.walletRuntimeRoot) {
+        return callback();
+    }
     if (targetWalletRootId === UNINITIALIZED_WALLET_ROOT_ID) {
         return callback();
     }
@@ -598,7 +608,6 @@ export async function withClaimedUninitializedManagedRuntime(options, callback)
         return callback();
     }
     claimedUninitializedRuntimeKeys.add(claimKey);
-    const uninitializedPaths = resolveManagedServicePaths(options.dataDir, UNINITIALIZED_WALLET_ROOT_ID);
     const lockTimeoutMs = options.shutdownTimeoutMs ?? DEFAULT_STARTUP_TIMEOUT_MS;
     const bitcoindLock = await acquireFileLockWithRetry(uninitializedPaths.bitcoindLockPath, {
         purpose: "managed-bitcoind-claim-uninitialized",
@@ -638,12 +647,15 @@ export async function withClaimedUninitializedManagedRuntime(options, callback)
 async function refreshManagedBitcoindStatus(status, paths, options) {
     const nowUnixMs = Date.now();
     const rpc = createRpcClient(status.rpc);
+    const targetWalletRootId = options.walletRootId ?? status.walletRootId;
     try {
         await waitForRpcReady(rpc, status.rpc.cookieFile, status.chain, options.startupTimeoutMs ?? DEFAULT_STARTUP_TIMEOUT_MS);
         await validateNodeConfigForTesting(rpc, status.chain, status.zmq.endpoint);
-        const walletReplica = await loadManagedWalletReplicaIfPresent(rpc, status.walletRootId, status.dataDir);
+        const walletReplica = await loadManagedWalletReplicaIfPresent(rpc, targetWalletRootId, status.dataDir);
         const nextStatus = {
             ...status,
+            walletRootId: targetWalletRootId,
+            runtimeRoot: paths.walletRuntimeRoot,
             state: "ready",
             processId: await isProcessAlive(status.processId) ? status.processId : null,
             walletReplica,
@@ -657,6 +669,8 @@ async function refreshManagedBitcoindStatus(status, paths, options) {
     catch (error) {
         const nextStatus = {
             ...status,
+            walletRootId: targetWalletRootId,
+            runtimeRoot: paths.walletRuntimeRoot,
             state: "failed",
             processId: await isProcessAlive(status.processId) ? status.processId : null,
             heartbeatAtUnixMs: nowUnixMs,
@@ -677,6 +691,8 @@ function createNodeHandle(status, paths, options) {
         expectedChain: currentStatus.chain,
         startHeight: currentStatus.startHeight,
         dataDir: currentStatus.dataDir,
+        getblockArchiveEndHeight: currentStatus.getblockArchiveEndHeight ?? null,
+        getblockArchiveSha256: currentStatus.getblockArchiveSha256 ?? null,
         walletRootId: currentStatus.walletRootId,
         runtimeRoot: paths.walletRuntimeRoot,
         async validate() {
@@ -684,6 +700,9 @@ function createNodeHandle(status, paths, options) {
         },
         async refreshServiceStatus() {
             currentStatus = await refreshManagedBitcoindStatus(currentStatus, paths, options);
+            this.getblockArchiveEndHeight = currentStatus.getblockArchiveEndHeight ?? null;
+            this.getblockArchiveSha256 = currentStatus.getblockArchiveSha256 ?? null;
+            this.walletRootId = currentStatus.walletRootId;
             return currentStatus;
         },
         async stop() {
@@ -786,57 +805,76 @@ export async function attachOrStartManagedBitcoindService(options) {
                 await verifyBitcoindVersion(bitcoindPath);
                 const binaryVersion = SUPPORTED_BITCOIND_VERSION;
                 await mkdir(resolvedOptions.dataDir ?? "", { recursive: true });
-                const runtimeConfig = await resolveRuntimeConfig(paths.bitcoindStatusPath, paths.bitcoindRuntimeConfigPath, resolvedOptions);
-                await writeBitcoinConf(paths.bitcoinConfPath, resolvedOptions, runtimeConfig);
-                const rpcConfig = runtimeConfig.rpc;
-                const zmqConfig = {
-                    endpoint: `tcp://${LOCAL_HOST}:${runtimeConfig.zmqPort}`,
-                    topic: "hashblock",
-                    port: runtimeConfig.zmqPort,
-                    pollIntervalMs: resolvedOptions.pollIntervalMs ?? 15_000,
+                const startManagedProcess = async (startOptions) => {
+                    const runtimeConfig = await resolveRuntimeConfig(paths.bitcoindStatusPath, paths.bitcoindRuntimeConfigPath, startOptions);
+                    await writeBitcoinConf(paths.bitcoinConfPath, startOptions, runtimeConfig);
+                    const rpcConfig = runtimeConfig.rpc;
+                    const zmqConfig = {
+                        endpoint: `tcp://${LOCAL_HOST}:${runtimeConfig.zmqPort}`,
+                        topic: "hashblock",
+                        port: runtimeConfig.zmqPort,
+                        pollIntervalMs: startOptions.pollIntervalMs ?? 15_000,
+                    };
+                    const child = spawn(bitcoindPath, buildManagedServiceArgs(startOptions, runtimeConfig), {
+                        detached: true,
+                        stdio: "ignore",
+                    });
+                    child.unref();
+                    const rpc = createRpcClient(rpcConfig);
+                    try {
+                        await waitForRpcReady(rpc, rpcConfig.cookieFile, startOptions.chain, startupTimeoutMs);
+                        await validateNodeConfigForTesting(rpc, startOptions.chain, zmqConfig.endpoint);
+                    }
+                    catch (error) {
+                        if (child.pid !== undefined) {
+                            try {
+                                process.kill(child.pid, "SIGTERM");
+                            }
+                            catch {
+                                // ignore kill failures during startup cleanup
+                            }
+                        }
+                        throw error;
+                    }
+                    const nowUnixMs = Date.now();
+                    const walletRootId = startOptions.walletRootId ?? UNINITIALIZED_WALLET_ROOT_ID;
+                    const walletReplica = await loadManagedWalletReplicaIfPresent(rpc, walletRootId, startOptions.dataDir ?? "");
+                    return createBitcoindServiceStatus({
+                        binaryVersion,
+                        serviceInstanceId: randomBytes(16).toString("hex"),
+                        state: "ready",
+                        processId: child.pid ?? null,
+                        walletRootId,
+                        chain: startOptions.chain,
+                        dataDir: startOptions.dataDir ?? "",
+                        runtimeRoot: paths.walletRuntimeRoot,
+                        startHeight: startOptions.startHeight,
+                        rpc: rpcConfig,
+                        zmq: zmqConfig,
+                        p2pPort: runtimeConfig.p2pPort,
+                        getblockArchiveEndHeight: runtimeConfig.getblockArchiveEndHeight ?? null,
+                        getblockArchiveSha256: runtimeConfig.getblockArchiveSha256 ?? null,
+                        walletReplica,
+                        startedAtUnixMs: nowUnixMs,
+                        heartbeatAtUnixMs: nowUnixMs,
+                        lastError: walletReplica.message ?? null,
+                    });
                 };
-                const child = spawn(bitcoindPath, buildManagedServiceArgs(resolvedOptions, runtimeConfig), {
-                    detached: true,
-                    stdio: "ignore",
-                });
-                child.unref();
-                const rpc = createRpcClient(rpcConfig);
+                let status;
                 try {
-                    await waitForRpcReady(rpc, rpcConfig.cookieFile, resolvedOptions.chain, startupTimeoutMs);
-                    await validateNodeConfigForTesting(rpc, resolvedOptions.chain, zmqConfig.endpoint);
+                    status = await startManagedProcess(resolvedOptions);
                 }
                 catch (error) {
-                    if (child.pid !== undefined) {
-                        try {
-                            process.kill(child.pid, "SIGTERM");
-                        }
-                        catch {
-                            // ignore kill failures during startup cleanup
-                        }
+                    if (resolvedOptions.getblockArchivePath === undefined || resolvedOptions.getblockArchivePath === null) {
+                        throw error;
                     }
-                    throw error;
+                    status = await startManagedProcess({
+                        ...resolvedOptions,
+                        getblockArchivePath: null,
+                        getblockArchiveEndHeight: null,
+                        getblockArchiveSha256: null,
+                    });
                 }
-                const nowUnixMs = Date.now();
-                const walletRootId = resolvedOptions.walletRootId ?? UNINITIALIZED_WALLET_ROOT_ID;
-                const walletReplica = await loadManagedWalletReplicaIfPresent(rpc, walletRootId, resolvedOptions.dataDir ?? "");
-                const status = createBitcoindServiceStatus({
-                    binaryVersion,
-                    serviceInstanceId: randomBytes(16).toString("hex"),
-                    state: "ready",
-                    processId: child.pid ?? null,
-                    walletRootId,
-                    chain: resolvedOptions.chain,
-                    dataDir: resolvedOptions.dataDir ?? "",
-                    runtimeRoot: paths.walletRuntimeRoot,
-                    startHeight: resolvedOptions.startHeight,
-                    rpc: rpcConfig,
-                    zmq: zmqConfig,
-                    p2pPort: runtimeConfig.p2pPort,
-                    walletReplica,
-                    startedAtUnixMs: nowUnixMs,
-                    heartbeatAtUnixMs: nowUnixMs,
-                    lastError: walletReplica.message ?? null,
-                });
                 await writeBitcoindStatus(paths, status);
                 return createNodeHandle(status, paths, resolvedOptions);
             }

package/dist/bitcoind/testing.d.ts

@@ -1,9 +1,10 @@
 export { openManagedBitcoindClientInternal } from "./client.js";
+export { DefaultManagedBitcoindClient } from "./client/managed-client.js";
 export { attachOrStartIndexerDaemon, readIndexerDaemonStatusForTesting, stopIndexerDaemonService, shutdownIndexerDaemonForTesting, } from "./indexer-daemon.js";
 export { normalizeRpcBlock } from "./normalize.js";
 export { BitcoinRpcClient } from "./rpc.js";
 export { attachOrStartManagedBitcoindService, buildManagedServiceArgsForTesting, readManagedBitcoindServiceStatusForTesting, resolveManagedBitcoindDbcacheMiB, stopManagedBitcoindService, shutdownManagedBitcoindServiceForTesting, writeBitcoinConfForTesting, } from "./service.js";
-export { AssumeUtxoBootstrapController, DEFAULT_SNAPSHOT_METADATA, createBootstrapStateForTesting, downloadSnapshotFileForTesting, loadBootstrapStateForTesting, resolveBootstrapPathsForTesting, saveBootstrapStateForTesting, validateSnapshotFileForTesting, waitForHeadersForTesting, } from "./bootstrap.js";
+export { AssumeUtxoBootstrapController, DEFAULT_SNAPSHOT_METADATA, createBootstrapStateForTesting, downloadSnapshotFileForTesting, loadBootstrapStateForTesting, prepareLatestGetblockArchiveForTesting, resolveBootstrapPathsForTesting, resolveGetblockArchivePathsForTesting, resolveReadyGetblockArchiveForTesting, saveBootstrapStateForTesting, validateSnapshotFileForTesting, waitForGetblockArchiveImportForTesting, waitForHeadersForTesting, } from "./bootstrap.js";
 export { buildBitcoindArgsForTesting, createRpcClient, launchManagedBitcoindNode, resolveDefaultBitcoindDataDirForTesting, validateNodeConfigForTesting, } from "./node.js";
 export { ManagedProgressController, TtyProgressRenderer, advanceFollowSceneStateForTesting, createFollowSceneStateForTesting, createBootstrapProgressForTesting, formatCompactFollowAgeLabelForTesting, loadBannerArtForTesting, loadScrollArtForTesting, loadTrainCarArtForTesting, loadTrainArtForTesting, loadTrainSmokeArtForTesting, formatProgressLineForTesting, formatQuoteLineForTesting, renderArtFrameForTesting, renderCompletionFrameForTesting, renderFollowFrameForTesting, renderIntroFrameForTesting, resolveCompletionMessageForTesting, resolveIntroMessageForTesting, resolveStatusFieldTextForTesting, setFollowBlockTimeForTesting, setFollowBlockTimesForTesting, syncFollowSceneStateForTesting, } from "./progress.js";
 export { WritingQuoteRotator, loadWritingQuotesForTesting, shuffleIndicesForTesting, } from "./quotes.js";

package/dist/bitcoind/testing.js

@@ -1,9 +1,10 @@
 export { openManagedBitcoindClientInternal } from "./client.js";
+export { DefaultManagedBitcoindClient } from "./client/managed-client.js";
 export { attachOrStartIndexerDaemon, readIndexerDaemonStatusForTesting, stopIndexerDaemonService, shutdownIndexerDaemonForTesting, } from "./indexer-daemon.js";
 export { normalizeRpcBlock } from "./normalize.js";
 export { BitcoinRpcClient } from "./rpc.js";
 export { attachOrStartManagedBitcoindService, buildManagedServiceArgsForTesting, readManagedBitcoindServiceStatusForTesting, resolveManagedBitcoindDbcacheMiB, stopManagedBitcoindService, shutdownManagedBitcoindServiceForTesting, writeBitcoinConfForTesting, } from "./service.js";
-export { AssumeUtxoBootstrapController, DEFAULT_SNAPSHOT_METADATA, createBootstrapStateForTesting, downloadSnapshotFileForTesting, loadBootstrapStateForTesting, resolveBootstrapPathsForTesting, saveBootstrapStateForTesting, validateSnapshotFileForTesting, waitForHeadersForTesting, } from "./bootstrap.js";
+export { AssumeUtxoBootstrapController, DEFAULT_SNAPSHOT_METADATA, createBootstrapStateForTesting, downloadSnapshotFileForTesting, loadBootstrapStateForTesting, prepareLatestGetblockArchiveForTesting, resolveBootstrapPathsForTesting, resolveGetblockArchivePathsForTesting, resolveReadyGetblockArchiveForTesting, saveBootstrapStateForTesting, validateSnapshotFileForTesting, waitForGetblockArchiveImportForTesting, waitForHeadersForTesting, } from "./bootstrap.js";
 export { buildBitcoindArgsForTesting, createRpcClient, launchManagedBitcoindNode, resolveDefaultBitcoindDataDirForTesting, validateNodeConfigForTesting, } from "./node.js";
 export { ManagedProgressController, TtyProgressRenderer, advanceFollowSceneStateForTesting, createFollowSceneStateForTesting, createBootstrapProgressForTesting, formatCompactFollowAgeLabelForTesting, loadBannerArtForTesting, loadScrollArtForTesting, loadTrainCarArtForTesting, loadTrainArtForTesting, loadTrainSmokeArtForTesting, formatProgressLineForTesting, formatQuoteLineForTesting, renderArtFrameForTesting, renderCompletionFrameForTesting, renderFollowFrameForTesting, renderIntroFrameForTesting, resolveCompletionMessageForTesting, resolveIntroMessageForTesting, resolveStatusFieldTextForTesting, setFollowBlockTimeForTesting, setFollowBlockTimesForTesting, syncFollowSceneStateForTesting, } from "./progress.js";
 export { WritingQuoteRotator, loadWritingQuotesForTesting, shuffleIndicesForTesting, } from "./quotes.js";

package/dist/bitcoind/types.d.ts

@@ -1,5 +1,5 @@
 import type { BitcoinBlock, Client, ClientOptions, ClientTip } from "../types.js";
-export type BootstrapPhase = "snapshot_download" | "wait_headers_for_snapshot" | "load_snapshot" | "bitcoin_sync" | "cogcoin_sync" | "follow_tip" | "paused" | "error" | "complete";
+export type BootstrapPhase = "getblock_archive_download" | "getblock_archive_import" | "snapshot_download" | "wait_headers_for_snapshot" | "load_snapshot" | "bitcoin_sync" | "cogcoin_sync" | "follow_tip" | "paused" | "error" | "complete";
 export type ProgressOutputMode = "auto" | "tty" | "none";
 export interface SnapshotMetadata {
     url: string;
@@ -17,6 +17,28 @@ export interface SnapshotChunkManifest {
     snapshotSha256: string;
     chunkSha256s: string[];
 }
+export interface GetblockArchiveManifestBlockRecord {
+    height: number;
+    blockHash: string;
+    previousBlockHash: string;
+    recordOffset: number;
+    recordLength: number;
+    rawBlockSizeBytes: number;
+}
+export interface GetblockArchiveManifest {
+    formatVersion: number;
+    chain: "main";
+    baseSnapshotHeight: number;
+    firstBlockHeight: number;
+    endHeight: number;
+    blockCount: number;
+    artifactFilename: string;
+    artifactSizeBytes: number;
+    artifactSha256: string;
+    chunkSizeBytes: number;
+    chunkSha256s: string[];
+    blocks: GetblockArchiveManifestBlockRecord[];
+}
 export interface WritingQuote {
     quote: string;
     author: string;
@@ -63,6 +85,8 @@ export interface ManagedBitcoindRuntimeConfig {
     zmqPort: number;
     p2pPort: number;
     dbcacheMiB: number;
+    getblockArchiveEndHeight?: number | null;
+    getblockArchiveSha256?: string | null;
 }
 export declare const MANAGED_BITCOIND_SERVICE_API_VERSION = "cogcoin/bitcoind-service/v1";
 export type ManagedBitcoindServiceState = "starting" | "ready" | "stopping" | "failed";
@@ -81,6 +105,8 @@ export interface ManagedBitcoindServiceStatus {
     rpc: BitcoindRpcConfig;
     zmq: BitcoindZmqConfig;
     p2pPort: number;
+    getblockArchiveEndHeight: number | null;
+    getblockArchiveSha256: string | null;
     walletReplica: ManagedCoreWalletReplicaStatus | null;
     startedAtUnixMs: number;
     heartbeatAtUnixMs: number;
@@ -123,6 +149,10 @@ export interface ManagedBitcoindStatus {
     serviceStatus?: ManagedBitcoindObservedStatus | null;
     indexerDaemon?: ManagedIndexerDaemonObservedStatus | null;
 }
+export interface ManagedGetblockArchiveRestartRequest {
+    currentArchiveEndHeight: number | null;
+    nextArchiveEndHeight: number;
+}
 export interface ManagedBitcoindOptions extends ClientOptions {
     dataDir?: string;
     databasePath?: string;
@@ -137,6 +167,8 @@ export interface ManagedBitcoindOptions extends ClientOptions {
     managedWalletPassphrase?: string;
     onProgress?: (event: ManagedBitcoindProgressEvent) => void;
     progressOutput?: ProgressOutputMode;
+    fetchImpl?: typeof fetch;
+    confirmGetblockArchiveRestart?: (request: ManagedGetblockArchiveRestartRequest) => Promise<boolean>;
 }
 export interface ManagedBitcoindClient extends Client {
     syncToTip(): Promise<SyncResult>;
@@ -397,6 +429,8 @@ export interface ManagedBitcoindNodeHandle {
     expectedChain: "main" | "regtest";
     startHeight: number;
     dataDir: string;
+    getblockArchiveEndHeight: number | null;
+    getblockArchiveSha256: string | null;
     walletRootId?: string;
     runtimeRoot?: string;
     validate(): Promise<void>;

package/dist/cli/commands/follow.js

@@ -3,6 +3,7 @@ import { resolveWalletRootIdFromLocalArtifacts } from "../../wallet/root-resolut
 import { usesTtyProgress, writeLine } from "../io.js";
 import { classifyCliError } from "../output.js";
 import { createStopSignalWatcher } from "../signals.js";
+import { confirmGetblockArchiveRestart } from "./getblock-archive-restart.js";
 export async function runFollowCommand(parsed, context) {
     const dbPath = parsed.dbPath ?? context.resolveDefaultClientDatabasePath();
     const dataDir = parsed.dataDir ?? context.resolveDefaultBitcoindDataDir();
@@ -23,6 +24,7 @@ export async function runFollowCommand(parsed, context) {
             dataDir,
             walletRootId: walletRoot.walletRootId,
             progressOutput: parsed.progressOutput,
+            confirmGetblockArchiveRestart: async (options) => confirmGetblockArchiveRestart(parsed, context, options),
         });
         storeOwned = false;
         const stopWatcher = createStopSignalWatcher(context.signalSource, context.stderr, client, context.forceExit);

package/dist/cli/commands/getblock-archive-restart.d.ts

@@ -0,0 +1,5 @@
+import type { ParsedCliArgs, RequiredCliRunnerContext } from "../types.js";
+export declare function confirmGetblockArchiveRestart(parsed: ParsedCliArgs, context: RequiredCliRunnerContext, options: {
+    currentArchiveEndHeight: number | null;
+    nextArchiveEndHeight: number;
+}): Promise<boolean>;

package/dist/cli/commands/getblock-archive-restart.js

@@ -0,0 +1,15 @@
+export async function confirmGetblockArchiveRestart(parsed, context, options) {
+    if (parsed.assumeYes) {
+        return true;
+    }
+    const prompter = context.createPrompter();
+    if (!prompter.isInteractive) {
+        return false;
+    }
+    const currentLabel = options.currentArchiveEndHeight === null
+        ? "without a getblock archive"
+        : `with a getblock archive through height ${options.currentArchiveEndHeight.toLocaleString()}`;
+    prompter.writeLine(`Managed bitcoind is already running ${currentLabel}. A newer getblock archive through height ${options.nextArchiveEndHeight.toLocaleString()} is available.`);
+    const answer = (await prompter.prompt(`Restart managed bitcoind to load the getblock archive through height ${options.nextArchiveEndHeight.toLocaleString()}? [y/N]: `)).trim().toLowerCase();
+    return answer === "y" || answer === "yes";
+}

package/dist/cli/commands/mining-admin.js

@@ -12,11 +12,13 @@ function createCommandPrompter(parsed, context) {
 export async function runMiningAdminCommand(parsed, context) {
     try {
         const provider = context.walletSecretProvider;
+        const runtimePaths = context.resolveWalletRuntimePaths(parsed.seedName);
         if (parsed.command === "hooks-mining-enable") {
             const prompter = createCommandPrompter(parsed, context);
             const view = await context.enableMiningHooks({
                 provider,
                 prompter,
+                paths: runtimePaths,
             });
             const nextSteps = getHooksEnableMiningNextSteps();
             if (parsed.outputMode === "preview-json") {
@@ -40,6 +42,7 @@ export async function runMiningAdminCommand(parsed, context) {
         if (parsed.command === "hooks-mining-disable") {
             const view = await context.disableMiningHooks({
                 provider,
+                paths: runtimePaths,
             });
             if (parsed.outputMode === "preview-json") {
                 writeJsonValue(context.stdout, createPreviewSuccessEnvelope(resolvePreviewJsonSchema(parsed), describeCanonicalCommand(parsed), "disabled", buildHooksPreviewData("hooks-disable-mining", view)));
@@ -57,6 +60,7 @@ export async function runMiningAdminCommand(parsed, context) {
             const view = await context.setupBuiltInMining({
                 provider,
                 prompter,
+                paths: runtimePaths,
             });
             const nextSteps = getMineSetupNextSteps();
             if (parsed.outputMode === "preview-json") {