@secondlayer/cli 19.2.1 → 19.2.2

package/README.md

@@ -99,7 +99,7 @@ No account. Writes `.env.local`, restores history, prints the Stacks observer st
 | `secondlayer bootstrap --against <manifest> [--from-block <n>] [--to-block <n>] [--verify all\|blocks] [--public-key <pem>] [-y] [--json]` | Restore chain history from a verified archive into an empty database. A run that died mid-way resumes per dataset on re-run. After the load, digests for blocks, transactions, and events are checked over the restored range (`--verify blocks` skips the child datasets and the minutes they cost). Partition fetches retry three times with backoff on resets, timeouts, 429 (honoring `Retry-After`) and 5xx; a link that stays down exits `1` with a re-run hint, and the re-run resumes. Exit `0` restored, `1` diverged or interrupted, `2` refused |
 | `secondlayer observer [--mode indexer\|signer-shared] [--endpoint host:port] [--network …]` | Print the `[[events_observer]]` stanza. Signer-shared skips retries; a missed block stays a gap until `repair` |
 | `secondlayer verify [all\|raw\|decode:<name>\|subgraph:<name>] --against <manifest> [--quick\|--deep\|--anchor]` | Compare local data to a signed archive. Default target `raw`. Exit `0` clean, `1` diverged, `2` unanchored |
-| `secondlayer verify block <height\|index_block_hash> [--node <url>] [--checkpoint <file>] [--rows] [--json]` | Prove one Stacks block from the checkpoint built into this release: Bitcoin headers, burn block, signer set, signatures, state root, state diff, and with `--rows` the indexed rows. Nothing else is trusted; proofs come from the API, or a node with `--node`. Exit `0` proven, `1` a link is broken, `2` could not check |
+| `secondlayer verify block <height\|index_block_hash> [--node <url>] [--checkpoint <file>] [--rows] [--json]` | Prove one Stacks block from the checkpoint built into this release: Bitcoin headers, burn block, signer set, signatures, state root, state diff, and with `--rows` the indexed rows. Blocks below the checkpoint are tied to it by hash (parent links or one MARF proof) instead of signatures. Nothing else is trusted; proofs come from the API, or a node with `--node`. Exit `0` proven, `1` a link is broken, `2` could not check |
 | `secondlayer repair --against <archive> [--apply] [-y]` | Plan (default) or apply an archive repair. A fixed block is rewritten with its transactions and events from the archive; when the reference has no child partition for a height, the block is rewritten alone, the height is named with a `bootstrap --from-block H --to-block H` remedy, and the exit is `1`. Partition fetches retry like `bootstrap`; a link that stays down exits `1` with a re-run hint, and heights already repaired are kept |
 
 Bootstrap and repair against the official hosted archive (`archive.secondlayer.tools`)

package/dist/cli.js

@@ -29440,7 +29440,7 @@ var init_git_status = () => {};
 
 // ../../node_modules/typescript/lib/typescript.js
 var require_typescript = __commonJS(function(exports, module) {
-  var __dirname = "/Users/ryan/projects/secondlayer/.claude/worktrees/agent-adcb760acc54b4c28/node_modules/typescript/lib", __filename = "/Users/ryan/projects/secondlayer/.claude/worktrees/agent-adcb760acc54b4c28/node_modules/typescript/lib/typescript.js";
+  var __dirname = "/Users/ryan/projects/secondlayer/.claude/worktrees/agent-a6ba56a9f98cf6ff7/node_modules/typescript/lib", __filename = "/Users/ryan/projects/secondlayer/.claude/worktrees/agent-a6ba56a9f98cf6ff7/node_modules/typescript/lib/typescript.js";
   /*! *****************************************************************************
   Copyright (c) Microsoft Corporation. All rights reserved.
   Licensed under the Apache License, Version 2.0 (the "License"); you may not use
@@ -202526,7 +202526,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "19.2.1",
+  version: "19.2.2",
   description: "Run a Stacks index on your own hardware — set it up, restore verified history, and keep it current.",
   repository: {
     type: "git",
@@ -202569,7 +202569,7 @@ var package_default = {
     "@secondlayer/shared": "^11.20.0",
     "@secondlayer/stacks": "^6.1.1",
     "@secondlayer/subgraphs": "^6.3.6",
-    "@secondlayer/verify": "^0.1.0",
+    "@secondlayer/verify": "^0.2.0",
     esbuild: "^0.28.2",
     "smol-toml": "^1.8.0",
     zod: "^4.3.6"
@@ -204015,6 +204015,7 @@ import {
   unhex
 } from "@secondlayer/verify";
 var LINKS = [
+  { step: "ancestry", label: "ancestry" },
   { step: "block", label: "block" },
   { step: "bitcoin", label: "bitcoin" },
   { step: "burn", label: "burn" },
@@ -204065,7 +204066,9 @@ function prepareSource(src) {
       return src.getBitcoinHeaders(from, count);
     }
   };
-  const { getStateWrites, getVmEvents } = src;
+  const { getEpoch2Header, getStateWrites, getVmEvents } = src;
+  if (getEpoch2Header)
+    out.getEpoch2Header = (id) => getEpoch2Header.call(src, id);
   if (getStateWrites)
     out.getStateWrites = (height) => getStateWrites.call(src, height);
   if (getVmEvents)
@@ -204077,6 +204080,14 @@ function prepareSource(src) {
 }
 function linkDetail(step, r, cp, rows) {
   switch (step) {
+    case "ancestry": {
+      const a = r.ancestry;
+      if (!a)
+        return "";
+      const checkpoint = parseNakamotoHeader(unhex(cp.stacks.header));
+      const start = a.fromHeight === Number(checkpoint.chainLength) ? `the checkpoint ${n(a.fromHeight)}` : `block ${n(a.fromHeight)}`;
+      return a.via === "marf" ? `${n(r.height ?? 0)} proven in the state of ${start} (one MARF proof)` : `${n(r.height ?? 0)} reached from ${start} by parent links`;
+    }
     case "block":
       return `${n(r.height ?? 0)}  ${r.blockId}`;
     case "bitcoin":
@@ -204101,18 +204112,29 @@ function linkDetail(step, r, cp, rows) {
       return `${n(r.rowsChecked ?? 0)} vm_events rows match the diff`;
   }
 }
+function notNeeded(step, r) {
+  if (!r.ancestry)
+    return false;
+  if (step === "bitcoin" || step === "burn")
+    return r.burnHeight === undefined;
+  return step === "signer-set" || step === "signatures";
+}
 function report(r, cp, rows) {
   const first = r.failures[0];
   const broken = first ? LINKS.findIndex((l) => l.step === first.step) : LINKS.length;
   for (const [i, link] of LINKS.entries()) {
     const label = link.label.padEnd(LABEL_WIDTH);
     const failure = r.failures.find((f) => f.step === link.step);
+    if (link.step === "ancestry" && !failure && !r.ancestry)
+      continue;
     if (failure)
       writeData(`${red("✗")} ${label}  ${failure.message}`);
     else if (link.step === "rows" && !rows)
       writeData(dim(`· ${label}  not checked (pass --rows)`));
     else if (i > broken)
       writeData(dim(`· ${label}  not checked: an earlier link is broken`));
+    else if (notNeeded(link.step, r))
+      writeData(dim(`· ${label}  not needed: the block is hash-chained to the checkpoint`));
     else if (link.step === "rows" && r.rowsChecked === undefined)
       writeData(dim(`· ${label}  not checked: the source serves no indexed rows`));
     else
@@ -204161,6 +204183,8 @@ async function runVerifyBlock(ref, opts, deps = {}) {
 function attachVerifyBlockCommand(verify) {
   return verify.command("block").description("Prove one Stacks block from the checkpoint built into this release, trusting nothing else").argument("<ref>", "block height or index block hash").option("--node <url>", "read blocks and MARF proofs from this Stacks node RPC instead of the API").option("--checkpoint <file>", "trust this checkpoint JSON instead of the one built into this release").option("--rows", "also prove the indexer's rows for the block (state_writes, vm_events) against its state diff").addHelpText("after", `
 What is proven, link by link:
+  ancestry    below the checkpoint only: the block's id, from the checkpoint by
+              parent links or one MARF proof (signer links are then not needed)
   bitcoin     headers from the checkpoint to the block's burn block: proof-of-work and retargets
   burn        the block's consensus hash commits to that Bitcoin block
   cycle       the reward cycle's signer set, proven forward from the checkpoint's set
@@ -209505,5 +209529,5 @@ registerCreditsCommand(program);
 registerArchiveCommand(program);
 program.parse();
 
-//# debugId=063D7FC6388E8ABC64756E2164756E21
+//# debugId=92924A7AE61FB1AF64756E2164756E21
 //# sourceMappingURL=cli.js.map