@secondlayer/cli 9.8.0 → 9.9.0

package/dist/cli.js

@@ -34817,7 +34817,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "9.8.0",
+  version: "9.9.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",
@@ -38638,6 +38638,11 @@ import { getDb as getDb2 } from "@secondlayer/shared/db";
 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 {
+  checkKeyTrust,
+  publicKeyFor,
+  verifyRegistry
+} from "@secondlayer/shared/archive/key-registry";
 import { verifyStreamsBulkManifestSignature } from "@secondlayer/shared/streams-bulk-manifest";
 function isLatestPointer(value) {
   const pointer = value;
@@ -39143,7 +39148,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 +39157,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`;
@@ -39256,6 +39275,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 +39299,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 +39325,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 +39342,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>"));
@@ -39317,6 +39364,135 @@ Exit codes:
     }
   });
 }
+// src/commands/faucet.ts
+import { randomBytes as randomBytes2 } from "node:crypto";
+import { readFile as readFile5 } from "node:fs/promises";
+import { join as join16 } 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 = join16(projectDir, "settings", "Devnet.toml");
+  let raw;
+  try {
+    raw = await readFile5(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(program2) {
+  const faucet = program2.command("faucet").description("Mint test assets on a local devnet");
+  faucet.command("sbtc").description("Mint mock sBTC to an address on your local 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 faucet sbtc --to ST1PQHQKV0RJXZFY1DGX8MNSNYVE3VGZJSRTPGZGM
+  $ sl faucet sbtc --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 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 client3 = 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 client3.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/cli.ts
 var { version } = package_default;
 program.name("secondlayer").alias("sl").description("SecondLayer CLI — dedicated Stacks indexing + real-time subgraphs").version(version).option("--network <network>", "Override network (local, testnet, mainnet)").option("--api-key <key>", "API credential (overrides SL_API_KEY)").option("--api-url <url>", "API endpoint (overrides SL_API_URL)").showSuggestionAfterError(true).showHelpAfterError("(run `sl --help` to see available commands)");
@@ -39368,6 +39544,7 @@ Examples:
 program.commandsGroup("Local development:");
 registerLocalCommand(program);
 registerDevnetCommand(program);
+registerFaucetCommand(program);
 program.commandsGroup("Diagnostics:");
 registerStatusCommand(program);
 registerDoctorCommand(program);
@@ -39381,5 +39558,5 @@ registerAccountCommand(program);
 registerKeysCommand(program);
 program.parse();
 
-//# debugId=C0418C213027DA8564756E2164756E21
+//# debugId=F913417C10273C0264756E2164756E21
 //# sourceMappingURL=cli.js.map