@secondlayer/cli 9.8.0 → 9.10.0

package/dist/cli.js

@@ -33160,12 +33160,12 @@ __export(exports_dev_state, {
   clearDevState: () => clearDevState
 });
 import { homedir as homedir4 } from "node:os";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 function getLogsDir() {
   return LOGS_DIR;
 }
 function getLogFile(service) {
-  return join10(LOGS_DIR, `${service}.log`);
+  return join11(LOGS_DIR, `${service}.log`);
 }
 async function ensureDirs() {
   await Bun.$`mkdir -p ${STATE_DIR}`.quiet();
@@ -33222,9 +33222,9 @@ async function isDevRunning() {
 }
 var STATE_DIR, DEV_STATE_PATH, LOGS_DIR;
 var init_dev_state = __esm(() => {
-  STATE_DIR = join10(homedir4(), ".secondlayer");
-  DEV_STATE_PATH = join10(STATE_DIR, "dev.json");
-  LOGS_DIR = join10(STATE_DIR, "logs");
+  STATE_DIR = join11(homedir4(), ".secondlayer");
+  DEV_STATE_PATH = join11(STATE_DIR, "dev.json");
+  LOGS_DIR = join11(STATE_DIR, "logs");
 });
 
 // src/lib/network.ts
@@ -33708,7 +33708,7 @@ __export(exports_dev_impl, {
   isDevAlreadyRunning: () => isDevAlreadyRunning
 });
 import { mkdirSync as mkdirSync5 } from "node:fs";
-import { dirname as dirname14, join as join11, resolve as resolve10 } from "node:path";
+import { dirname as dirname14, join as join12, resolve as resolve10 } from "node:path";
 async function isDevAlreadyRunning() {
   if (await isDevRunning()) {
     const running = await getRunningServices();
@@ -34317,7 +34317,7 @@ async function ensureDevPostgres(dataDir) {
   if (check.stdout.toString().trim()) {
     return false;
   }
-  const pgDataDir = join11(dataDir, "postgres");
+  const pgDataDir = join12(dataDir, "postgres");
   mkdirSync5(pgDataDir, { recursive: true });
   const stopped = await Bun.$`docker ps -aq -f name=secondlayer-dev-postgres`.quiet().nothrow();
   if (stopped.stdout.toString().trim()) {
@@ -34817,7 +34817,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "9.8.0",
+  version: "9.10.0",
   repository: {
     type: "git",
     url: "git+https://github.com/ryanwaits/secondlayer.git",
@@ -34861,8 +34861,8 @@ var package_default = {
     "@secondlayer/bundler": "^0.4.1",
     "@secondlayer/scaffold": "^1.5.1",
     "@secondlayer/sdk": "^6.51.0",
-    "@secondlayer/shared": "^7.7.0",
-    "@secondlayer/stacks": "^3.2.0",
+    "@secondlayer/shared": "^7.8.0",
+    "@secondlayer/stacks": "^3.3.1",
     "@secondlayer/subgraphs": "^3.26.4",
     esbuild: "^0.27.4",
     "smol-toml": "^1.6.1",
@@ -36522,7 +36522,7 @@ POST result (client-side, not logged):`));
 // src/commands/devnet.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
 import { existsSync as existsSync6, mkdirSync as mkdirSync4, writeFileSync as writeFileSync6 } from "node:fs";
-import { dirname as dirname8, join as join8 } from "node:path";
+import { dirname as dirname8, join as join9 } from "node:path";
 
 // src/lib/devnet-compose.ts
 var DEFAULT_IMAGE_OWNER = "ryanwaits";
@@ -36719,7 +36719,138 @@ stacks_node_events_observers = [${entry}]
 
 // src/commands/devnet.ts
 init_output();
-var COMPOSE_REL = join8(".secondlayer", "docker-compose.yml");
+
+// src/commands/faucet.ts
+import { randomBytes as randomBytes2 } from "node:crypto";
+import { readFile as readFile3 } from "node:fs/promises";
+import { join as join8 } from "node:path";
+import { http as http3, createWalletClient } from "@secondlayer/stacks";
+import { mnemonicToAccount } from "@secondlayer/stacks/accounts";
+import { devnet } from "@secondlayer/stacks/chains";
+import { Cl } from "@secondlayer/stacks/clarity";
+import { parse as parseToml2 } from "smol-toml";
+init_output();
+var DUST_LIMIT_SATS = 546n;
+var DEFAULT_AMOUNT_SATS = 1000000n;
+async function readDeployerMnemonic(projectDir) {
+  const path11 = join8(projectDir, "settings", "Devnet.toml");
+  let raw;
+  try {
+    raw = await readFile3(path11, "utf8");
+  } catch {
+    throw new Error(`could not read ${path11}`);
+  }
+  const parsed = parseToml2(raw);
+  const mnemonic = parsed.accounts?.deployer?.mnemonic;
+  if (!mnemonic) {
+    throw new Error(`no accounts.deployer.mnemonic in ${path11}`);
+  }
+  return mnemonic;
+}
+async function readBurnAnchor(rpcUrl) {
+  const info2 = await (await fetch(`${rpcUrl.replace(/\/$/, "")}/v2/info`, {
+    signal: AbortSignal.timeout(1e4)
+  })).json();
+  const height = info2.burn_block_height;
+  if (typeof height !== "number") {
+    throw new Error("node did not report a burn block height");
+  }
+  const burn = await (await fetch(`${rpcUrl.replace(/\/$/, "")}/extended/v2/burn-blocks/${height}`, { signal: AbortSignal.timeout(1e4) })).json();
+  if (!burn.burn_block_hash) {
+    throw new Error(`node did not report a hash for burn block ${height}`);
+  }
+  return { height, hash: burn.burn_block_hash.replace(/^0x/, "") };
+}
+function parseAmount(value) {
+  if (value === undefined)
+    return DEFAULT_AMOUNT_SATS;
+  const parsed = BigInt(value);
+  if (parsed < DUST_LIMIT_SATS) {
+    throw new Error(`--amount must be at least ${DUST_LIMIT_SATS} sats (the protocol dust limit), got ${parsed}`);
+  }
+  return parsed;
+}
+function registerFaucetCommand(devnetCommand) {
+  devnetCommand.command("faucet").description("Mint mock sBTC to an address on your devnet").requiredOption("--to <address>", "recipient Stacks address").option("--amount <sats>", `amount in sats (default ${DEFAULT_AMOUNT_SATS}, minimum ${DUST_LIMIT_SATS})`).option("--contract <id>", "sBTC deposit contract (default: <deployer>.sbtc-deposit)").option("--rpc-url <url>", "devnet node RPC (default http://localhost:3999)").option("--json", "Output as JSON").addHelpText("after", `
+Examples:
+  $ sl devnet faucet --to ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM
+  $ sl devnet faucet --to ST2... --amount 5000000
+
+Requires a devnet running with the sBTC contract set deployed by your
+Clarinet deployer — that deployer is the signer set on your own chain, which
+is what makes minting possible without Bitcoin.`).action(async (opts) => {
+    try {
+      const network = process.env.STACKS_NETWORK ?? "devnet";
+      if (network !== "devnet" && network !== "local") {
+        printError(`sl devnet faucet only works on devnet, not ${network}.`, {
+          hint: "Mock sBTC is mintable because you deployed the contracts. On testnet or mainnet the signer set is not yours."
+        });
+        process.exit(2);
+      }
+      const rpcUrl = opts.rpcUrl ?? "http://localhost:3999";
+      const amount = parseAmount(opts.amount);
+      const projectDir = findClarinetProject(process.cwd());
+      if (!projectDir) {
+        printError("No Clarinet project found.", {
+          hint: "Run this from a project containing Clarinet.toml, or pass --contract explicitly."
+        });
+        process.exit(2);
+      }
+      const mnemonic = await readDeployerMnemonic(projectDir);
+      const account = mnemonicToAccount(mnemonic, {
+        addressVersion: devnet.addressVersion.singleSig
+      });
+      const contract = opts.contract ?? `${account.address}.sbtc-deposit`;
+      const anchor = await readBurnAnchor(rpcUrl);
+      const client2 = createWalletClient({
+        account,
+        chain: devnet,
+        transport: http3(rpcUrl)
+      });
+      const depositTxid = randomBytes2(32).toString("hex");
+      const sweepTxid = randomBytes2(32).toString("hex");
+      note(`  minting ${amount} sats to ${opts.to}`);
+      note(`  via ${contract} as signer ${account.address}`);
+      const txid = await client2.callContract({
+        contract,
+        functionName: "complete-deposit-wrapper",
+        functionArgs: [
+          Cl.bufferFromHex(depositTxid),
+          Cl.uint(0),
+          Cl.uint(amount),
+          Cl.principal(opts.to),
+          Cl.bufferFromHex(anchor.hash),
+          Cl.uint(anchor.height),
+          Cl.bufferFromHex(sweepTxid)
+        ],
+        postConditionMode: "allow"
+      });
+      output({
+        json: opts.json,
+        data: {
+          txid,
+          recipient: opts.to,
+          amount_sats: amount.toString(),
+          contract,
+          burn_height: anchor.height
+        },
+        human: () => {
+          success(`Minted ${amount} sats of mock sBTC to ${opts.to}.`);
+          note(`  tx ${txid}`);
+          console.error(dim("  Mock sBTC on your devnet — not the canonical asset."));
+        }
+      });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      const hint = /ECONNREFUSED|fetch failed/.test(message) ? "Is your devnet running? Start it with `clarinet devnet start`." : /NoSuchContract|does not exist/.test(message) ? "Deploy the sBTC contract set to your devnet first, or pass --contract." : "Check that your Clarinet deployer matches the sBTC contract deployer.";
+      printError(message, { hint });
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/devnet.ts
+var COMPOSE_REL = join9(".secondlayer", "docker-compose.yml");
 function ensureDocker() {
   const probe = spawnSync2("docker", ["info"], { stdio: "ignore" });
   if (probe.error || probe.status !== 0) {
@@ -36747,23 +36878,24 @@ var SERVICES = [
   "migrate"
 ];
 function registerDevnetCommand(program2) {
-  const devnet = program2.command("devnet").description("Run Secondlayer services against a local Clarinet devnet");
-  devnet.command("connect").description("Point your clarinet project's devnet at a local Secondlayer stack and start it").option("--project <dir>", "Clarinet project directory (defaults to the nearest Clarinet.toml)").option("--image-tag <tag>", "Published image tag to run", DEFAULT_IMAGE_TAG).option("--owner <owner>", "ghcr image owner (namespace) to pull from").option("--no-up", "Patch config + write compose without starting docker").action(async (options3) => {
+  const devnet2 = program2.command("devnet").description("Run Secondlayer services against a local Clarinet devnet");
+  registerFaucetCommand(devnet2);
+  devnet2.command("connect").description("Point your clarinet project's devnet at a local Secondlayer stack and start it").option("--project <dir>", "Clarinet project directory (defaults to the nearest Clarinet.toml)").option("--image-tag <tag>", "Published image tag to run", DEFAULT_IMAGE_TAG).option("--owner <owner>", "ghcr image owner (namespace) to pull from").option("--no-up", "Patch config + write compose without starting docker").action(async (options3) => {
     await connect(options3);
   });
-  devnet.command("down").description("Stop the local Secondlayer stack started by `sl devnet connect`").option("--project <dir>", "Clarinet project directory").option("--purge", "Also remove volumes (wipes the local index)").action(async (options3) => {
+  devnet2.command("down").description("Stop the local Secondlayer stack started by `sl devnet connect`").option("--project <dir>", "Clarinet project directory").option("--purge", "Also remove volumes (wipes the local index)").action(async (options3) => {
     await down(options3);
   });
-  devnet.command("status").description("Snapshot of the local stack: ingest, subgraphs, and recent activity").option("-w, --watch", "Refresh every 2s until Ctrl-C").option("--limit <n>", "Recent activity rows to show", "12").action(async (options3) => {
+  devnet2.command("status").description("Snapshot of the local stack: ingest, subgraphs, and recent activity").option("-w, --watch", "Refresh every 2s until Ctrl-C").option("--limit <n>", "Recent activity rows to show", "12").action(async (options3) => {
     await status(options3);
   });
-  devnet.command("logs [service]").description("Tail stack logs — all services, or one of: indexer, api, subgraph-processor, postgres").option("--project <dir>", "Clarinet project directory").option("-f, --follow", "Follow log output").option("-n, --lines <n>", "Lines to show from the end of each log").action(async (service, options3) => {
+  devnet2.command("logs [service]").description("Tail stack logs — all services, or one of: indexer, api, subgraph-processor, postgres").option("--project <dir>", "Clarinet project directory").option("-f, --follow", "Follow log output").option("-n, --lines <n>", "Lines to show from the end of each log").action(async (service, options3) => {
     await logs(service, options3);
   });
 }
 function resolveProject(explicit) {
   if (explicit) {
-    if (!existsSync6(join8(explicit, "Clarinet.toml"))) {
+    if (!existsSync6(join9(explicit, "Clarinet.toml"))) {
       error(`No Clarinet.toml in ${explicit}`);
       process.exit(1);
     }
@@ -36779,7 +36911,7 @@ function resolveProject(explicit) {
 }
 async function connect(options3) {
   const project = resolveProject(options3.project);
-  const devnetToml = join8(project, "settings", "Devnet.toml");
+  const devnetToml = join9(project, "settings", "Devnet.toml");
   mkdirSync4(dirname8(devnetToml), { recursive: true });
   const result = ensureEventObserver(devnetToml, DEFAULT_INDEXER_OBSERVER);
   console.log(`${green("✓")} found Clarinet.toml`);
@@ -36789,7 +36921,7 @@ async function connect(options3) {
     console.log(`${green("✓")} ${result.status === "created" ? "created" : "patched"} settings/Devnet.toml`);
     console.log(dim(`    + stacks_node_events_observers = ["${DEFAULT_INDEXER_OBSERVER}"]`));
   }
-  const composePath = join8(project, COMPOSE_REL);
+  const composePath = join9(project, COMPOSE_REL);
   mkdirSync4(dirname8(composePath), { recursive: true });
   writeFileSync6(composePath, buildDevnetCompose({ owner: options3.owner, imageTag: options3.imageTag }));
   console.log(`${green("✓")} wrote ${COMPOSE_REL}`);
@@ -36819,7 +36951,7 @@ Stop with: sl devnet down`));
 }
 async function down(options3) {
   const project = resolveProject(options3.project);
-  const composePath = join8(project, COMPOSE_REL);
+  const composePath = join9(project, COMPOSE_REL);
   if (!existsSync6(composePath)) {
     error(`No ${COMPOSE_REL} in ${project} — nothing to stop. Run \`sl devnet connect\` first.`);
     process.exit(1);
@@ -36834,7 +36966,7 @@ async function down(options3) {
 }
 async function logs(service, options3) {
   const project = resolveProject(options3.project);
-  const composePath = join8(project, COMPOSE_REL);
+  const composePath = join9(project, COMPOSE_REL);
   if (!existsSync6(composePath)) {
     error(`No ${COMPOSE_REL} in ${project} — run \`sl devnet connect\` first.`);
     process.exit(1);
@@ -36960,7 +37092,7 @@ init_subgraphs2();
 init_output();
 init_resolve_auth();
 import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname9, join as join9 } from "node:path";
+import { dirname as dirname9, join as join10 } from "node:path";
 import { createStreamsClient } from "@secondlayer/sdk";
 import { STREAMS_EVENT_TYPES } from "@secondlayer/shared";
 var DEFAULT_BASE_URL3 = "https://api.secondlayer.tools";
@@ -37136,7 +37268,7 @@ Examples:
       note(`# downloading ${files.length} file(s) to ${options3.to}`);
       for (const file of files) {
         const bytes = await dumps.download(file);
-        const dest = join9(options3.to, file.path);
+        const dest = join10(options3.to, file.path);
         await mkdir3(dirname9(dest), { recursive: true });
         await writeFile3(dest, bytes);
         process.stderr.write(`# ${file.path} (${file.row_count} rows, ${bytes.byteLength} bytes)
@@ -38424,9 +38556,9 @@ init_output();
 
 // src/lib/project-file.ts
 import { existsSync as existsSync7 } from "node:fs";
-import { mkdir as mkdir4, readFile as readFile3, writeFile as writeFile4 } from "node:fs/promises";
+import { mkdir as mkdir4, readFile as readFile4, writeFile as writeFile4 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
-import { dirname as dirname15, join as join12, parse as parsePath2, resolve as resolve11 } from "node:path";
+import { dirname as dirname15, join as join13, parse as parsePath2, resolve as resolve11 } from "node:path";
 import { z as z4 } from "zod";
 var ProjectFileSchema = z4.object({
   slug: z4.string().min(1)
@@ -38438,15 +38570,15 @@ async function readActiveProject(cwd, globalDefault) {
   const home2 = resolve11(homedir5());
   const fsRoot = parsePath2(dir).root;
   while (true) {
-    const candidate = join12(dir, DIRNAME, FILENAME);
+    const candidate = join13(dir, DIRNAME, FILENAME);
     if (existsSync7(candidate)) {
       try {
-        const raw = await readFile3(candidate, "utf8");
+        const raw = await readFile4(candidate, "utf8");
         const parsed = ProjectFileSchema.parse(JSON.parse(raw));
         return { slug: parsed.slug, resolvedFrom: candidate };
       } catch {}
     }
-    if (existsSync7(join12(dir, ".git")))
+    if (existsSync7(join13(dir, ".git")))
       break;
     if (dir === home2 || dir === fsRoot)
       break;
@@ -38458,15 +38590,15 @@ async function readActiveProject(cwd, globalDefault) {
   if (globalDefault) {
     return {
       slug: globalDefault,
-      resolvedFrom: join12(homedir5(), ".secondlayer", "config.json")
+      resolvedFrom: join13(homedir5(), ".secondlayer", "config.json")
     };
   }
   return null;
 }
 async function writeActiveProject(slug, cwd) {
-  const dir = join12(resolve11(cwd), DIRNAME);
+  const dir = join13(resolve11(cwd), DIRNAME);
   await mkdir4(dir, { recursive: true });
-  const file = join12(dir, FILENAME);
+  const file = join13(dir, FILENAME);
   await writeFile4(file, `${JSON.stringify({ slug }, null, 2)}
 `, "utf8");
   return file;
@@ -38636,8 +38768,13 @@ import { getDb as getDb2 } from "@secondlayer/shared/db";
 
 // src/lib/archive-reference.ts
 import { createHash as createHash2 } from "node:crypto";
-import { readFile as readFile4 } from "node:fs/promises";
-import { dirname as dirname16, join as join13, resolve as resolve12 } from "node:path";
+import { readFile as readFile5 } from "node:fs/promises";
+import { dirname as dirname16, join as join14, resolve as resolve12 } from "node:path";
+import {
+  checkKeyTrust,
+  publicKeyFor,
+  verifyRegistry
+} from "@secondlayer/shared/archive/key-registry";
 import { verifyStreamsBulkManifestSignature } from "@secondlayer/shared/streams-bulk-manifest";
 function isLatestPointer(value) {
   const pointer = value;
@@ -38661,7 +38798,7 @@ async function loadReference(source) {
     root = url.toString();
   } else {
     const path11 = resolve12(source);
-    manifest = JSON.parse(await readFile4(path11, "utf8"));
+    manifest = JSON.parse(await readFile5(path11, "utf8"));
     root = isLatestPointer(manifest) ? dirname16(path11) : dirname16(dirname16(path11));
   }
   if (!isLatestPointer(manifest)) {
@@ -38669,7 +38806,7 @@ async function loadReference(source) {
   }
   const pointer = manifest;
   const snapshotPath = pointer.snapshot_path;
-  const resolved = isRemote ? await fetchJson(`${root.replace(/\/$/, "")}/${snapshotPath}`) : JSON.parse(await readFile4(join13(root, snapshotPath), "utf8"));
+  const resolved = isRemote ? await fetchJson(`${root.replace(/\/$/, "")}/${snapshotPath}`) : JSON.parse(await readFile5(join14(root, snapshotPath), "utf8"));
   if (pointer.snapshot_digest) {
     const digest = createHash2("sha256").update(JSON.stringify((({ signature: _s, key_id: _k, ...rest }) => rest)(resolved))).digest("hex");
     if (digest !== pointer.snapshot_digest) {
@@ -38726,7 +38863,7 @@ async function fetchVerifiedPartition(reference, partition) {
     }
     bytes = Buffer.from(await response2.arrayBuffer());
   } else {
-    bytes = await readFile4(join13(reference.root, partition.path));
+    bytes = await readFile5(join14(reference.root, partition.path));
   }
   const digest = createHash2("sha256").update(bytes).digest("hex");
   if (digest !== partition.sha256) {
@@ -38886,7 +39023,7 @@ Exit codes:
 // src/commands/repair.ts
 import { unlink as unlink2, writeFile as writeFile5 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
-import { join as join14 } from "node:path";
+import { join as join15 } from "node:path";
 import { ParquetReader } from "@dsnp/parquetjs";
 import {
   compareRangeDigests as compareRangeDigests2,
@@ -38909,7 +39046,7 @@ function asOptionalText(value) {
   return value === null || value === undefined ? null : asText(value);
 }
 async function readBlocksPartition(bytes, label) {
-  const path11 = join14(tmpdir2(), `sl-repair-${label}-${process.pid}.parquet`);
+  const path11 = join15(tmpdir2(), `sl-repair-${label}-${process.pid}.parquet`);
   await writeFile5(path11, bytes);
   try {
     const reader = await ParquetReader.openFile(path11);
@@ -39135,7 +39272,7 @@ Exit codes:
 // src/commands/bootstrap.ts
 import { unlink as unlink3, writeFile as writeFile6 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
-import { join as join15 } from "node:path";
+import { join as join16 } from "node:path";
 import { ParquetReader as ParquetReader2 } from "@dsnp/parquetjs";
 import { confirm as confirm7 } from "@inquirer/prompts";
 import {
@@ -39143,7 +39280,7 @@ import {
   writeRowsToCopyStream
 } from "@secondlayer/shared/archive/copy-loader";
 import { computeRangeDigest as computeRangeDigest3 } from "@secondlayer/shared/archive/range-digest";
-import { getDb as getDb4, getRawClient } from "@secondlayer/shared/db";
+import { getDb as getDb4, getRawClient, sql as sql3 } from "@secondlayer/shared/db";
 init_output();
 var BOOTSTRAP_EXIT = {
   OK: 0,
@@ -39152,6 +39289,20 @@ var BOOTSTRAP_EXIT = {
 };
 var BLOCKS_PER_DAY_ESTIMATE = 5400;
 var RESTORE_ROWS_PER_SECOND = 30000;
+async function readNodeTip() {
+  const url = process.env.STACKS_NODE_RPC_URL ?? "http://localhost:20443";
+  try {
+    const response2 = await fetch(`${url.replace(/\/$/, "")}/v2/info`, {
+      signal: AbortSignal.timeout(5000)
+    });
+    if (!response2.ok)
+      return null;
+    const info2 = await response2.json();
+    return typeof info2.stacks_tip_height === "number" ? info2.stacks_tip_height : null;
+  } catch {
+    return null;
+  }
+}
 function formatDuration2(seconds2) {
   if (seconds2 < 90)
     return `${Math.round(seconds2)}s`;
@@ -39162,7 +39313,7 @@ function formatDuration2(seconds2) {
   return `${(seconds2 / 86400).toFixed(1)} days`;
 }
 async function* readPartitionRows(bytes, label) {
-  const path11 = join15(tmpdir3(), `sl-bootstrap-${label}-${process.pid}.parquet`);
+  const path11 = join16(tmpdir3(), `sl-bootstrap-${label}-${process.pid}.parquet`);
   await writeFile6(path11, bytes);
   try {
     const reader = await ParquetReader2.openFile(path11);
@@ -39256,6 +39407,7 @@ Exit codes:
           process.exit(BOOTSTRAP_EXIT.REFUSED);
         }
       }
+      const nodeTipAtStart = await readNodeTip();
       const order = ["blocks", "transactions", "events"];
       const rawClient = getRawClient("source");
       const loaded = { blocks: 0, transactions: 0, events: 0 };
@@ -39279,6 +39431,24 @@ Exit codes:
           divergent++;
         }
       }
+      const network = process.env.STACKS_NETWORK ?? "mainnet";
+      await sql3`
+					INSERT INTO index_progress (
+						network, last_indexed_block, last_contiguous_block,
+						highest_seen_block, updated_at
+					) VALUES (
+						${network}, ${tipHeight}, ${tipHeight}, ${tipHeight}, NOW()
+					)
+					ON CONFLICT (network) DO UPDATE SET
+						last_indexed_block = GREATEST(index_progress.last_indexed_block, EXCLUDED.last_indexed_block),
+						last_contiguous_block = GREATEST(index_progress.last_contiguous_block, EXCLUDED.last_contiguous_block),
+						highest_seen_block = GREATEST(index_progress.highest_seen_block, EXCLUDED.highest_seen_block),
+						updated_at = NOW()
+				`.execute(db);
+      const seam = nodeTipAtStart !== null && nodeTipAtStart > tipHeight ? {
+        nodeTip: nodeTipAtStart,
+        gap: nodeTipAtStart - tipHeight
+      } : null;
       const elapsed = (Date.now() - startedAt) / 1000;
       const report = {
         status: divergent === 0 ? "restored" : "divergent",
@@ -39287,7 +39457,10 @@ Exit codes:
         rows: loaded,
         ranges_verified: referenceDigests.length,
         divergent_ranges: divergent,
-        elapsed_seconds: Math.round(elapsed)
+        elapsed_seconds: Math.round(elapsed),
+        resume_from: tipHeight + 1,
+        node_tip_at_start: nodeTipAtStart,
+        catch_up_blocks: seam?.gap ?? null
       };
       output({
         json: opts.json,
@@ -39301,7 +39474,13 @@ Exit codes:
               warn("  archive published no block digests — restore is unverified");
             }
             console.error("");
-            console.error(dim(`Your instance holds history through ${tipHeight.toLocaleString()}. Start the indexer to continue from there.`));
+            console.error(dim(`Your instance holds history through ${tipHeight.toLocaleString()} and will resume at ${(tipHeight + 1).toLocaleString()}.`));
+            if (seam) {
+              console.error(dim(`The chain advanced to ${seam.nodeTip.toLocaleString()} while restoring — ${seam.gap.toLocaleString()} blocks to catch up.`));
+              console.error(dim("  Start the indexer; it backfills that range before following the tip."));
+            } else {
+              console.error(dim("  Start the indexer to continue from there. (Node unreachable — catch-up range unknown.)"));
+            }
           } else {
             warn(`Restored ${loaded.blocks.toLocaleString()} blocks but ${divergent} ranges do not match the archive.`);
             console.error(dim("  Investigate with: sl verify --against <manifest>"));
@@ -39381,5 +39560,5 @@ registerAccountCommand(program);
 registerKeysCommand(program);
 program.parse();
 
-//# debugId=C0418C213027DA8564756E2164756E21
+//# debugId=D839AA90F21AC3D964756E2164756E21
 //# sourceMappingURL=cli.js.map