@secondlayer/cli 20.0.1 → 20.1.1

package/README.md

@@ -164,7 +164,8 @@ points at.
 | Command | What it does |
 |---|---|
 | `secondlayer index ft-transfers` / `nft-transfers` / `events --event-type <t>` / `contract-calls` | Decoded Index layer. Anonymous reads OK |
-| `secondlayer streams tip` / `events` / `consume` / `reorgs` / `canonical <h>` / `dumps` | Raw chain event firehose. `consume` emits one event per line; a reorg appears inline as `{"kind":"reorg","fork_point_height":…}` and the loop rewinds to re-deliver the canonical run, so a reader drops rows at or above the fork point when it sees one. `--max-pages` must be a positive integer. **Requires `INSTANCE_TOKEN` past loopback** |
+| `secondlayer index runes` / `runes get <rune>` / `runes balances (--address <a> \| --outpoint <txid:vout>)` / `runes activity [--kind etch,mint,transfer,burn]` | Bitcoin Runes: catalog, one rune, balances, activity. Hosted answers a "not configured" note until Runes data lands there |
+| `secondlayer streams tip` / `events` / `consume` / `reorgs` / `canonical <h>` / `dumps` | Raw chain event firehose. `consume` emits one event per line; a reorg appears inline as `{"kind":"reorg","fork_point_height":…}` and the loop rewinds to re-deliver the canonical run, so a reader drops rows at or above the fork point when it sees one. `--max-pages` must be a positive integer. `events`, `events by-tx`, `consume` and `reorgs` take `--chain bitcoin` for Runes events (`rune_*` types; Stacks-only filters are refused). **Requires `INSTANCE_TOKEN` past loopback** |
 
 Reads emit JSON to stdout (`--json` accepted across all read commands); `-o/--output` is a file path, not a format.
 

package/dist/cli.js

@@ -200299,6 +200299,34 @@ function fail(action, err) {
   }
   process.exit(1);
 }
+function parseRuneSort(value) {
+  if (value === undefined)
+    return;
+  if (!RUNE_SORTS.includes(value)) {
+    throw new Error(`invalid --sort "${value}"; expected one of: ${RUNE_SORTS.join(", ")}`);
+  }
+  return value;
+}
+function parseRuneKinds(value) {
+  if (value === undefined)
+    return;
+  return value.split(",").map((raw) => {
+    const name = raw.trim();
+    if (!RUNE_KINDS.includes(name)) {
+      throw new Error(`invalid --kind "${name}"; expected one or more of: ${RUNE_KINDS.join(", ")}`);
+    }
+    return `rune_${name}`;
+  });
+}
+function runeBalanceSubject(o) {
+  if (o.address !== undefined && o.outpoint === undefined) {
+    return { address: o.address };
+  }
+  if (o.outpoint !== undefined && o.address === undefined) {
+    return { outpoint: o.outpoint };
+  }
+  throw new Error("pass --address or --outpoint (one of them)");
+}
 function heightParams(o) {
   return {
     fromHeight: o.fromHeight ? Number.parseInt(o.fromHeight, 10) : undefined,
@@ -200456,6 +200484,53 @@ function registerIndexCommand(program) {
       fail("get mempool tx", err);
     }
   });
+  const runes = index.command("runes").description("List etched runes (Bitcoin; run `runes get <rune>` for one)").option("--search <prefix>", "Name prefix, spacers and case ignored").option("--sort <order>", "number (etch order) or mints (busiest first)").option("--cursor <cursor>", "Resume token from a previous next_cursor").option("--limit <n>", "Rows per page").option("--json", "Print the full envelope as JSON").action(async (o) => {
+    try {
+      emit(await client().runes.list({
+        search: o.search,
+        sort: parseRuneSort(o.sort),
+        cursor: o.cursor,
+        limit: o.limit ? Number.parseInt(o.limit, 10) : undefined
+      }), o.json);
+    } catch (err) {
+      fail("list runes", err);
+    }
+  });
+  runes.command("get <rune>").description("Get one rune by id (840000:3) or name, any spacing or case").option("--json", "Print as JSON").action(async (rune, _o, cmd) => {
+    const o = cmd.optsWithGlobals();
+    try {
+      emitOne(await client().runes.get(rune), `rune ${rune}`, o.json);
+    } catch (err) {
+      fail("get rune", err);
+    }
+  });
+  runes.command("balances").description("Current rune balances by address or outpoint (Bitcoin)").option("--address <address>", "Bitcoin address").option("--outpoint <txid:vout>", "Unspent output").option("--rune <ref>", "Narrow to one rune (id or name)").option("--cursor <cursor>", "Resume token from a previous next_cursor").option("--limit <n>", "Rows per page").option("--json", "Print the full envelope as JSON").action(async (_o, cmd) => {
+    const o = cmd.optsWithGlobals();
+    try {
+      emit(await client().runes.balances({
+        ...runeBalanceSubject(o),
+        rune: o.rune,
+        cursor: o.cursor,
+        limit: o.limit ? Number.parseInt(o.limit, 10) : undefined
+      }), o.json);
+    } catch (err) {
+      fail("list rune balances", err);
+    }
+  });
+  runes.command("activity").description("List rune etches, mints, transfers and burns (Bitcoin)").option("--rune <ref>", "Filter by rune (id or name)").option("--address <address>", "Filter by Bitcoin address").option("--kind <kinds>", `Comma list of ${RUNE_KINDS.join(", ")}`).option("--txid <txid>", "Filter by Bitcoin transaction id").option("--from-height <n>", "Start Bitcoin block height (inclusive)").option("--to-height <n>", "End Bitcoin block height (inclusive)").option("--cursor <cursor>", "Resume token from a previous next_cursor").option("--limit <n>", "Rows per page").option("--json", "Print the full envelope as JSON").action(async (_o, cmd) => {
+    const o = cmd.optsWithGlobals();
+    try {
+      emit(await client().runes.activity.list({
+        ...heightParams(o),
+        rune: o.rune,
+        address: o.address,
+        kind: parseRuneKinds(o.kind),
+        txid: o.txid
+      }), o.json);
+    } catch (err) {
+      fail("list rune activity", err);
+    }
+  });
 }
 async function runIndexCodegen(o) {
   try {
@@ -200482,12 +200557,14 @@ async function runIndexCodegen(o) {
     process.exit(1);
   }
 }
-var VALID_INDEX_TYPES;
+var VALID_INDEX_TYPES, RUNE_SORTS, RUNE_KINDS;
 var init_index_api = __esm(() => {
   init_fs();
   init_output();
   init_resolve_auth();
   VALID_INDEX_TYPES = DECODED_EVENT_TYPES3;
+  RUNE_SORTS = ["number", "mints"];
+  RUNE_KINDS = ["etch", "mint", "transfer", "burn"];
 });
 
 // ../../node_modules/postgres/src/query.js
@@ -202569,7 +202646,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "20.0.1",
+  version: "20.1.1",
   description: "Run a Stacks index on your own hardware — set it up, restore verified history, and keep it current.",
   repository: {
     type: "git",
@@ -202608,11 +202685,11 @@ var package_default = {
     "@inquirer/prompts": "^8.2.0",
     "@secondlayer/bundler": "^0.7.1",
     "@secondlayer/scaffold": "^1.6.2",
-    "@secondlayer/sdk": "^15.0.0",
-    "@secondlayer/shared": "^12.0.0",
-    "@secondlayer/stacks": "^6.2.0",
-    "@secondlayer/subgraphs": "^7.0.1",
-    "@secondlayer/verify": "^0.5.0",
+    "@secondlayer/sdk": "^15.0.1",
+    "@secondlayer/shared": "^12.1.1",
+    "@secondlayer/stacks": "^6.2.1",
+    "@secondlayer/subgraphs": "^7.0.2",
+    "@secondlayer/verify": "^0.5.3",
     esbuild: "^0.28.2",
     "smol-toml": "^1.9.1",
     zod: "^4.3.6"
@@ -206729,7 +206806,7 @@ import { createHash as createHash5 } from "node:crypto";
 import { mkdir as mkdir3, open as open2, rename as rename2 } from "node:fs/promises";
 import { dirname as dirname8, isAbsolute, resolve as resolve7, sep as sep2 } from "node:path";
 import { createStreamsClient } from "@secondlayer/sdk";
-import { STREAMS_EVENT_TYPES } from "@secondlayer/shared";
+import { RUNE_EVENT_TYPES, STREAMS_EVENT_TYPES } from "@secondlayer/shared";
 var VALID_TYPES = STREAMS_EVENT_TYPES;
 function client2() {
   return createStreamsClient({
@@ -206791,17 +206868,40 @@ async function downloadDumpTo(file, dest, fetchImpl, url) {
   await rename2(part, dest);
   return bytes;
 }
-function parseTypes(value, flag = "--types") {
+function parseChain(value) {
+  if (value === undefined || value === "stacks")
+    return;
+  if (value !== "bitcoin") {
+    throw new Error(`invalid --chain "${value}"; expected stacks or bitcoin`);
+  }
+  return "bitcoin";
+}
+function parseTypes(value, flag = "--types", chain) {
   if (!value)
     return;
+  const valid = chain === "bitcoin" ? RUNE_EVENT_TYPES : VALID_TYPES;
   const parts = value.split(",").map((s) => s.trim());
   for (const p of parts) {
-    if (!VALID_TYPES.includes(p)) {
-      throw new Error(`invalid ${flag} value "${p}"; expected one of: ${VALID_TYPES.join(", ")}`);
+    if (!valid.includes(p)) {
+      throw new Error(`invalid ${flag} value "${p}"; expected one of: ${valid.join(", ")}`);
     }
   }
   return parts;
 }
+function rejectStacksFilters(chain, o) {
+  if (chain !== "bitcoin")
+    return;
+  for (const [flag, value] of [
+    ["--contract-id", o.contractId],
+    ["--sender", o.sender],
+    ["--recipient", o.recipient]
+  ]) {
+    if (value !== undefined) {
+      throw new Error(`${flag} is Stacks-only; drop it with --chain bitcoin`);
+    }
+  }
+}
+var CHAIN_HELP = "stacks (default) or bitcoin (Runes events, their own cursors)";
 function parseList(value) {
   if (value === undefined)
     return;
@@ -206862,16 +206962,20 @@ function registerStreamsCommand(program) {
       process.exit(1);
     }
   });
-  const events = streams.command("events").description("List events (cursor-paginated; one page per call)").option("--types <types>", `comma-separated event types (${VALID_TYPES.join(", ")})`).option("--event-type <type>", "alias for a single-value --types (the Index spelling)").option("--not-types <types>", "comma-separated event types to exclude").option("--contract-id <ids>", "comma-separated contract identifier(s)").option("--sender <addrs>", "comma-separated sender principal(s)").option("--recipient <addrs>", "comma-separated recipient principal(s)").option("--cursor <cursor>", "start cursor (block_height:event_index)").option("--from-block <n>", "filter to blocks >= n").option("--to-block <n>", "filter to blocks <= n").option("--limit <n>", "page size (1-1000, default 100)", "100").option("--json", "Output as JSON (streams always emits JSON)").addHelpText("after", `
+  const events = streams.command("events").description("List events (cursor-paginated; one page per call)").option("--chain <chain>", CHAIN_HELP).option("--types <types>", `comma-separated event types (${VALID_TYPES.join(", ")}; ${RUNE_EVENT_TYPES.join(", ")} with --chain bitcoin)`).option("--event-type <type>", "alias for a single-value --types (the Index spelling)").option("--not-types <types>", "comma-separated event types to exclude").option("--contract-id <ids>", "comma-separated contract identifier(s)").option("--sender <addrs>", "comma-separated sender principal(s)").option("--recipient <addrs>", "comma-separated recipient principal(s)").option("--cursor <cursor>", "start cursor (block_height:event_index)").option("--from-block <n>", "filter to blocks >= n").option("--to-block <n>", "filter to blocks <= n").option("--limit <n>", "page size (1-1000, default 100)", "100").option("--json", "Output as JSON (streams always emits JSON)").addHelpText("after", `
 Examples:
   $ secondlayer streams events --types stx_transfer,print --limit 50
   $ secondlayer streams events --not-types print --contract-id SP00....token,SP01....token
   $ secondlayer streams events --sender SP1...,SP2... --from-block 150000 --to-block 160000
-  $ secondlayer streams events --cursor 150000:3`).action(async (options) => {
+  $ secondlayer streams events --cursor 150000:3
+  $ secondlayer streams events --chain bitcoin --types rune_mint --limit 50`).action(async (options) => {
     try {
+      const chain = parseChain(options.chain);
+      rejectStacksFilters(chain, options);
       const envelope = await client2().events.list({
-        types: parseTypes(options.types ?? options.eventType),
-        notTypes: parseTypes(options.notTypes, "--not-types"),
+        chain,
+        types: parseTypes(options.types ?? options.eventType, "--types", chain),
+        notTypes: parseTypes(options.notTypes, "--not-types", chain),
         contractId: parseList(options.contractId),
         sender: parseList(options.sender),
         recipient: parseList(options.recipient),
@@ -206886,22 +206990,26 @@ Examples:
       process.exit(1);
     }
   });
-  events.command("by-tx <txId>").description("List all events emitted by a single transaction").option("--json", "Output as JSON (streams always emits JSON)").action(async (txId) => {
+  events.command("by-tx <txId>").description("List all events emitted by a single transaction").option("--chain <chain>", CHAIN_HELP).option("--json", "Output as JSON (streams always emits JSON)").action(async (txId, _o, cmd) => {
+    const options = cmd.optsWithGlobals();
     try {
-      const envelope = await client2().events.byTxId(txId);
+      const chain = parseChain(options.chain);
+      const envelope = chain ? await client2().events.byTxId(txId, { chain }) : await client2().events.byTxId(txId);
       writeData(JSON.stringify(envelope, null, 2));
     } catch (err) {
       error(err instanceof Error ? err.message : String(err));
       process.exit(1);
     }
   });
-  streams.command("consume").description("Long-running pull from a cursor; emits one event per line (jsonl) until SIGINT or --max-pages").option("--types <types>", `comma-separated event types (${VALID_TYPES.join(", ")})`).option("--not-types <types>", "comma-separated event types to exclude").option("--contract-id <ids>", "comma-separated contract identifier(s)").option("--sender <addrs>", "comma-separated sender principal(s)").option("--recipient <addrs>", "comma-separated recipient principal(s)").option("--cursor <cursor>", "start cursor (block_height:event_index)").option("--batch-size <n>", "events per batch (1-1000, default 100)", "100").option("--max-pages <n>", "stop after N pages (default: run until SIGINT)").addHelpText("after", `
+  streams.command("consume").description("Long-running pull from a cursor; emits one event per line (jsonl) until SIGINT or --max-pages").option("--chain <chain>", CHAIN_HELP).option("--types <types>", `comma-separated event types (${VALID_TYPES.join(", ")}; ${RUNE_EVENT_TYPES.join(", ")} with --chain bitcoin)`).option("--not-types <types>", "comma-separated event types to exclude").option("--contract-id <ids>", "comma-separated contract identifier(s)").option("--sender <addrs>", "comma-separated sender principal(s)").option("--recipient <addrs>", "comma-separated recipient principal(s)").option("--cursor <cursor>", "start cursor (block_height:event_index)").option("--batch-size <n>", "events per batch (1-1000, default 100)", "100").option("--max-pages <n>", "stop after N pages (default: run until SIGINT)").addHelpText("after", `
 Examples:
   $ secondlayer streams consume --types print --cursor 150000:0
   $ secondlayer streams consume --not-types print --sender SP1...,SP2... --batch-size 500 --max-pages 10`).action(async (options) => {
     try {
       const batchSize = parseLimit(options.batchSize) ?? 100;
       const maxPages = parseMaxPages(options.maxPages);
+      const chain = parseChain(options.chain);
+      rejectStacksFilters(chain, options);
       note('# streaming events to stdout (jsonl); reorgs appear inline as {"kind":"reorg"}; next_cursor printed to stderr');
       const handlers = consumeHandlers({
         stdout: (line) => process.stdout.write(`${line}
@@ -206910,9 +207018,10 @@ Examples:
 `)
       });
       await client2().events.consume({
+        chain,
         fromCursor: options.cursor,
-        types: parseTypes(options.types),
-        notTypes: parseTypes(options.notTypes, "--not-types"),
+        types: parseTypes(options.types, "--types", chain),
+        notTypes: parseTypes(options.notTypes, "--not-types", chain),
         contractId: parseList(options.contractId),
         sender: parseList(options.sender),
         recipient: parseList(options.recipient),
@@ -206927,9 +207036,11 @@ Examples:
       process.exit(1);
     }
   });
-  streams.command("reorgs").description("List recent reorgs (cursor-paginated)").requiredOption("--since <cursor>", "start cursor (block_height:event_index)").option("--limit <n>", "page size (default 100)", "100").option("--json", "Output as JSON (streams always emits JSON)").action(async (options) => {
+  streams.command("reorgs").description("List recent reorgs (cursor-paginated)").requiredOption("--since <cursor>", "start cursor (block_height:event_index)").option("--chain <chain>", CHAIN_HELP).option("--limit <n>", "page size (default 100)", "100").option("--json", "Output as JSON (streams always emits JSON)").action(async (options) => {
     try {
+      const chain = parseChain(options.chain);
       const envelope = await client2().reorgs.list({
+        ...chain && { chain },
         since: options.since,
         limit: parseLimit(options.limit)
       });
@@ -208493,8 +208604,8 @@ services:
     profiles: ["full-node"]
 
   stacks-node:
-    # Consensus-critical — digest-pinned to 4.0.1. See docker/oss/docker-compose.yml.
-    image: ghcr.io/stacks-network/stacks-core:4.0.1@sha256:ceb768f881ef52a1d2792a2b4a89d81e092b1df11293b04c31ce36613c3f9711
+    # Consensus-critical — digest-pinned to 4.0.5. See docker/oss/docker-compose.yml.
+    image: ghcr.io/stacks-network/stacks-core:4.0.5@sha256:51aa7bf6f990b99fa010ebb23abe78653cf1f1d129ab8e7d88b1fe11a403c97d
     volumes:
       - \${STACKS_DATA_DIR:-./data/stacks}:/stacks-blockchain/data
       - ./Config.toml:/stacks-blockchain/Config.toml:ro
@@ -209393,5 +209504,5 @@ registerCreditsCommand(program);
 registerArchiveCommand(program);
 program.parse();
 
-//# debugId=255DFF8A4862FC7D64756E2164756E21
+//# debugId=E9EB99B555C4CFDB64756E2164756E21
 //# sourceMappingURL=cli.js.map