@secondlayer/cli 8.7.0 → 8.8.0

package/README.md

@@ -104,7 +104,6 @@ scoped reads and cannot mint (403). Minted keys inherit your plan's tier.
 
 | Command | What it does |
 |---|---|
-| `sl datasets list` / `query <dataset> [--filter k=v] [--cursor] [--limit] [--json]` | Foundation Datasets (sBTC, BNS, PoX-4, STX transfers). Public — no key |
 | `sl index ft-transfers` / `nft-transfers` / `events --event-type <t>` / `contract-calls` | Decoded L2 layer. Anonymous reads OK; free-tier keys rejected (Build+ for keyed) |
 | `sl streams tip` / `events` / `consume` / `reorgs` / `canonical <h>` / `pull` | Raw L1 event firehose. **Requires `SL_API_KEY`** |
 
@@ -136,16 +135,6 @@ trait — via the SDK, REST, or MCP with a `triggers` array. Every other
 `sl subscriptions` command (list/get/update/pause/resume/delete/doctor/test/
 deliveries/...) operates on both kinds.
 
-### Local dev & OSS
-
-| Command | What it does |
-|---|---|
-| `sl local up [--devnet]` / `sl local down [--devnet]` | Start/stop the full local stack (Stacks node + dev services), or a Clarinet devnet |
-| `sl local start/stop/restart/status/logs` | Manage just the local dev services |
-| `sl local node setup/start/stop/...` | Manage the local Stacks node |
-| `sl local db blocks/txs/events/gaps/truncate/resync` | Inspect the local source DB |
-| `sl devnet connect/down/status/logs` | Clarinet devnet integration |
-
 ### Other
 
 | Command | What it does |
@@ -220,6 +209,17 @@ await token.write.transfer({ amount: 100n, recipient: "SP..." })
 const supply = await token.vars.totalSupply.get()
 ```
 
+## Frozen commands
+
+Local-dev periphery: still functional, hidden from `sl --help`, no further
+investment — may be removed in a future major. The hosted dev loop
+(`sl subgraphs create/deploy`) is the supported path.
+
+- `sl local up/down/start/stop/restart/status/logs` — local stack + dev services
+- `sl local node ...` — local Stacks node management
+- `sl local db ...` — local source DB inspection
+- `sl devnet connect/down/status/logs` — Clarinet devnet integration
+
 ## Docs
 
 Full reference: https://secondlayer.tools/docs

package/dist/cli.js

@@ -31811,7 +31811,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "8.7.0",
+  version: "8.8.0",
   repository: {
     type: "git",
     url: "git+https://github.com/ryanwaits/secondlayer.git",
@@ -31861,10 +31861,10 @@ var package_default = {
     "@inquirer/prompts": "^8.2.0",
     "@secondlayer/bundler": "^0.3.7",
     "@secondlayer/scaffold": "^1.2.0",
-    "@secondlayer/sdk": "^6.20.0",
-    "@secondlayer/shared": "^6.29.0",
-    "@secondlayer/stacks": "^2.5.0",
-    "@secondlayer/subgraphs": "^3.10.0",
+    "@secondlayer/sdk": "^6.21.1",
+    "@secondlayer/shared": "^6.30.0",
+    "@secondlayer/stacks": "^2.5.1",
+    "@secondlayer/subgraphs": "^3.11.0",
     "@biomejs/js-api": "^0.7.0",
     "@biomejs/wasm-nodejs": "^1.9.0",
     esbuild: "^0.19.0",
@@ -33847,6 +33847,24 @@ stacks_node_events_observers = [${entry}]
   return { status: exists ? "added" : "created" };
 }
 
+// src/lib/frozen.ts
+function markFrozen(cmd) {
+  let warned = false;
+  const warn2 = () => {
+    if (warned)
+      return;
+    warned = true;
+    process.stderr.write(`⚠ \`sl ${cmd.name()}\` is frozen — no further investment; it may be removed in a future major. The hosted dev loop (sl subgraphs create/deploy) is the supported path.
+`);
+  };
+  cmd.hook("preAction", warn2);
+  cmd.addHelpText("beforeAll", () => {
+    warn2();
+    return "";
+  });
+  return cmd;
+}
+
 // src/commands/devnet.ts
 init_output();
 var COMPOSE_REL = join6(".secondlayer", "docker-compose.yml");
@@ -33877,7 +33895,7 @@ var SERVICES = [
   "migrate"
 ];
 function registerDevnetCommand(program2) {
-  const devnet = program2.command("devnet").description("Run Secondlayer services against a local Clarinet devnet");
+  const devnet = markFrozen(program2.command("devnet", { hidden: true }).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 (options) => {
     await connect(options);
   });
@@ -34595,7 +34613,7 @@ function sip010Balances(name) {
 
 /**
  * Track SIP-010 token balances per (asset_identifier, holder).
- * Mirrors the shape of the Foundation Datasets sBTC token-events
+ * Mirrors the shape of the curated sBTC token-events view
  * surface — but works for ANY SIP-010 token. Constrain to a single
  * token by adding \`assetIdentifier: "SP...token::token-name"\` to each
  * source filter.
@@ -34672,8 +34690,7 @@ function sbtcFlows(name) {
 
 /**
  * Track sBTC protocol flows: deposits, withdrawals, signer rotations,
- * governance updates. Mirrors the shape of the Foundation Datasets
- * \`/v1/datasets/sbtc/events\` surface but in your own subgraph.
+ * governance updates — your own indexed view of the sbtc-registry contract.
  *
  * Source contract: sbtc-registry (mainnet).
  *
@@ -34740,13 +34757,10 @@ function poxStacking(name) {
 
 /**
  * Track Stacking lifecycle calls on PoX-4 — solo stacking, delegation,
- * extension, increase, aggregation, signer-key authorizations. Mirrors
- * the shape of the Foundation Datasets \`/v1/datasets/pox-4/calls\`
- * surface as your own subgraph.
+ * extension, increase, aggregation, signer-key authorizations.
  *
  * Note: PoX-4 emits zero print events; this subgraph captures contract
- * calls. Decoding function args + raw_result is left to your handler —
- * the dataset shows one possible shape.
+ * calls. Decoding function args + raw_result is left to your handler.
  *
  * Query examples once deployed:
  *   GET /v1/subgraphs/${name}/calls?function_name=stack-stx
@@ -34794,8 +34808,7 @@ function bnsNames(name) {
 
 /**
  * Track BNS-V2 name lifecycle events — registrations, transfers,
- * renewals, burns, airdrops. Mirrors the Foundation Datasets
- * \`/v1/datasets/bns/name-events\` surface as your own subgraph.
+ * renewals, burns, airdrops.
  *
  * Source: BNS-V2 print events (topic-discriminated payloads).
  *
@@ -35347,6 +35360,9 @@ Stopped watching.`);
           ...options2.databaseUrl ? { databaseUrl: options2.databaseUrl } : {},
           ...visibility ? { visibility } : {}
         });
+        if (result.start_block_clamped) {
+          info(`  Free tier indexes forward from deploy (start block ${result.start_block}) — upgrade for genesis backfill.`);
+        }
         const printDeployFooter = async () => {
           try {
             const { apiUrl } = await resolveAuth();
@@ -35362,6 +35378,9 @@ Stopped watching.`);
               info(`  Publish:   sl subgraphs publish ${effectiveDef.name} (open anon /v1 reads)`);
             }
             info(`  Watch:     sl subgraphs status ${effectiveDef.name}`);
+            if (firstTable) {
+              info(`  Webhook:   sl subscriptions create ${effectiveDef.name}-hook --subgraph ${effectiveDef.name} --table ${firstTable} --url <your-endpoint>`);
+            }
           } catch {}
         };
         if (result.action === "unchanged") {
@@ -36154,72 +36173,16 @@ Examples:
     }
   });
 }
-// src/commands/datasets.ts
-init_output();
-import { CURSOR_SLUGS, Datasets } from "@secondlayer/sdk";
-var DEFAULT_BASE_URL3 = "https://api.secondlayer.tools";
-function client2() {
-  return new Datasets({ baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL3 });
-}
-function parseFilters(pairs) {
-  const out = {};
-  for (const pair of pairs ?? []) {
-    const eq = pair.indexOf("=");
-    if (eq <= 0) {
-      throw new Error(`invalid --filter "${pair}" (expected key=value)`);
-    }
-    out[pair.slice(0, eq)] = pair.slice(eq + 1);
-  }
-  return out;
-}
-function registerDatasetsCommand(program2) {
-  const datasets = program2.command("datasets").description("Query Foundation Datasets (sBTC, BNS, PoX-4, STX transfers)");
-  datasets.command("list").description("List the dataset catalog + freshness").action(async () => {
-    try {
-      const catalog = await client2().listDatasets();
-      writeData(JSON.stringify(catalog, null, 2));
-    } catch (err) {
-      error(`Failed to list datasets: ${err}`);
-      process.exit(1);
-    }
-  });
-  datasets.command("query <dataset>").description(`Query a cursor-paginated dataset (${Object.keys(CURSOR_SLUGS).join(", ")})`).option("--filter <key=value...>", "Filter as key=value (e.g. --filter stacker=SP… --filter address=SP…)").option("--limit <n>", "Rows per page").option("--cursor <cursor>", "Resume token from a previous next_cursor").option("--json", "Print the full envelope as JSON").addHelpText("after", `
-Examples:
-  $ sl datasets query stx-transfers --filter sender=SP2J6ZY... --limit 100
-  $ sl datasets query sbtc-events --filter amount.gte=1000
-  $ sl datasets query bns-events --cursor 150000:3 --json`).action(async (dataset, options2) => {
-    try {
-      const params = parseFilters(options2.filter);
-      if (options2.limit)
-        params.limit = Number.parseInt(options2.limit, 10);
-      if (options2.cursor)
-        params.cursor = options2.cursor;
-      const env = await client2().query(dataset, params);
-      output({
-        json: options2.json,
-        data: env,
-        human: () => {
-          writeData(JSON.stringify(env.rows, null, 2));
-          if (env.next_cursor)
-            note(`next_cursor: ${env.next_cursor}`);
-        }
-      });
-    } catch (err) {
-      error(`Failed to query dataset: ${err}`);
-      process.exit(1);
-    }
-  });
-}
 // src/commands/index-api.ts
 init_output();
 init_fs();
 init_resolve_auth();
 import { resolve as resolve3 } from "node:path";
 import { Index } from "@secondlayer/sdk";
-var DEFAULT_BASE_URL4 = "https://api.secondlayer.tools";
-function client3() {
+var DEFAULT_BASE_URL3 = "https://api.secondlayer.tools";
+function client2() {
   return new Index({
-    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL4,
+    baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL3,
     apiKey: resolveEnvKey()
   });
 }
@@ -36295,7 +36258,7 @@ function registerIndexCommand(program2) {
   const heightFlags = (cmd) => cmd.option("--from-height <n>", "Start block height (inclusive)").option("--to-height <n>", "End 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");
   rangeFlags(index.command("ft-transfers")).description("List decoded SIP-010 fungible-token transfers").option("--sender <principal>", "Filter by sender").option("--recipient <principal>", "Filter by recipient").action(async (o) => {
     try {
-      emit(await client3().ftTransfers.list({
+      emit(await client2().ftTransfers.list({
         ...rangeParams(o),
         sender: o.sender,
         recipient: o.recipient
@@ -36306,7 +36269,7 @@ function registerIndexCommand(program2) {
   });
   rangeFlags(index.command("nft-transfers")).description("List decoded SIP-009 non-fungible-token transfers").option("--sender <principal>", "Filter by sender").option("--recipient <principal>", "Filter by recipient").option("--asset-identifier <id>", "Filter by asset identifier").action(async (o) => {
     try {
-      emit(await client3().nftTransfers.list({
+      emit(await client2().nftTransfers.list({
         ...rangeParams(o),
         sender: o.sender,
         recipient: o.recipient,
@@ -36318,7 +36281,7 @@ function registerIndexCommand(program2) {
   });
   rangeFlags(index.command("events")).description("List decoded events by type (stx_*, ft/nft mint/burn, print, …)").requiredOption("--event-type <type>", "Decoded event type (required)").option("--sender <principal>", "Filter by sender").option("--recipient <principal>", "Filter by recipient").option("--asset-identifier <id>", "Filter by asset identifier").action(async (o) => {
     try {
-      emit(await client3().events.list({
+      emit(await client2().events.list({
         eventType: o.eventType,
         ...rangeParams(o),
         sender: o.sender,
@@ -36331,7 +36294,7 @@ function registerIndexCommand(program2) {
   });
   rangeFlags(index.command("contract-calls")).description("List decoded contract calls (function, args, result)").option("--function-name <name>", "Filter by called function").option("--sender <principal>", "Filter by caller").action(async (o) => {
     try {
-      emit(await client3().contractCalls.list({
+      emit(await client2().contractCalls.list({
         ...rangeParams(o),
         functionName: o.functionName,
         sender: o.sender
@@ -36342,21 +36305,21 @@ function registerIndexCommand(program2) {
   });
   heightFlags(index.command("canonical")).description("List the canonical Stacks block sequence (height + hash)").action(async (o) => {
     try {
-      emit(await client3().canonical.list(heightParams(o)), o.json);
+      emit(await client2().canonical.list(heightParams(o)), o.json);
     } catch (err) {
       fail("list canonical blocks", err);
     }
   });
   const blocks = heightFlags(index.command("blocks")).description("List decoded blocks (run `blocks get <ref>` for one block)").action(async (o) => {
     try {
-      emit(await client3().blocks.list(heightParams(o)), o.json);
+      emit(await client2().blocks.list(heightParams(o)), o.json);
     } catch (err) {
       fail("list blocks", err);
     }
   });
   blocks.command("get <ref>").description("Get a single block by height or block hash").option("--json", "Print as JSON").action(async (ref, o) => {
     try {
-      const block = await client3().blocks.get(/^\d+$/.test(ref) ? Number.parseInt(ref, 10) : ref);
+      const block = await client2().blocks.get(/^\d+$/.test(ref) ? Number.parseInt(ref, 10) : ref);
       emitOne(block, `block ${ref}`, o.json);
     } catch (err) {
       fail("get block", err);
@@ -36364,7 +36327,7 @@ function registerIndexCommand(program2) {
   });
   const transactions = rangeFlags(index.command("transactions")).description("List decoded transactions (run `transactions get <txId>` for one)").option("--type <type>", "Filter by transaction type").option("--sender <principal>", "Filter by sender").action(async (o) => {
     try {
-      emit(await client3().transactions.list({
+      emit(await client2().transactions.list({
         ...rangeParams(o),
         type: o.type,
         sender: o.sender
@@ -36375,14 +36338,14 @@ function registerIndexCommand(program2) {
   });
   transactions.command("get <txId>").description("Get a single transaction by tx_id").option("--json", "Print as JSON").action(async (txId, o) => {
     try {
-      emitOne(await client3().transactions.get(txId), `tx ${txId}`, o.json);
+      emitOne(await client2().transactions.get(txId), `tx ${txId}`, o.json);
     } catch (err) {
       fail("get transaction", err);
     }
   });
   heightFlags(index.command("stacking")).description("List decoded PoX-4 stacking actions").option("--function-name <name>", "Filter by PoX function name").option("--stacker <principal>", "Filter by stacker").option("--caller <principal>", "Filter by caller").action(async (o) => {
     try {
-      emit(await client3().stacking.list({
+      emit(await client2().stacking.list({
         ...heightParams(o),
         functionName: o.functionName,
         stacker: o.stacker,
@@ -36394,7 +36357,7 @@ function registerIndexCommand(program2) {
   });
   const mempool = index.command("mempool").description("List pending mempool transactions (run `mempool get <txId>` for one)").option("--contract-id <id>", "Filter to pending calls to a contract").option("--sender <principal>", "Filter by sender").option("--type <type>", "Filter by transaction type").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 client3().mempool.list({
+      emit(await client2().mempool.list({
         contractId: o.contractId,
         sender: o.sender,
         type: o.type,
@@ -36407,7 +36370,7 @@ function registerIndexCommand(program2) {
   });
   mempool.command("get <txId>").description("Get a single pending transaction by tx_id (404 once mined)").option("--json", "Print as JSON").action(async (txId, o) => {
     try {
-      emitOne(await client3().mempool.get(txId), `pending tx ${txId}`, o.json);
+      emitOne(await client2().mempool.get(txId), `pending tx ${txId}`, o.json);
     } catch (err) {
       fail("get mempool tx", err);
     }
@@ -36417,7 +36380,7 @@ function registerIndexCommand(program2) {
 init_output();
 init_resolve_auth();
 import { SecondLayer as SecondLayer4 } from "@secondlayer/sdk";
-var DEFAULT_BASE_URL5 = "https://api.secondlayer.tools";
+var DEFAULT_BASE_URL4 = "https://api.secondlayer.tools";
 function registerKeysCommand(program2) {
   const keys = program2.command("keys").description("Manage API keys");
   keys.command("create").description("Mint a scoped streams/index read key (requires an account-level key)").option("--product <product>", "Key scope: streams or index", "streams").option("--name <name>", "Optional label for the key").option("--json", "Print the full response as JSON").action(async (o) => {
@@ -36432,7 +36395,7 @@ function registerKeysCommand(program2) {
     }
     try {
       const sl = new SecondLayer4({
-        baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL5,
+        baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL4,
         apiKey
       });
       const minted = await sl.apiKeys.create({
@@ -37359,7 +37322,7 @@ async function stopStack(options2) {
   }
 }
 function registerLocalCommand(program2) {
-  const local = program2.command("local").description("Manage local development environment and Stacks node").hook("preAction", async (_thisCommand, actionCommand) => {
+  const local = markFrozen(program2.command("local", { hidden: true }).description("Manage local development environment and Stacks node")).hook("preAction", async (_thisCommand, actionCommand) => {
     if (actionCommand.name() === "help")
       return;
     await requireLocalNetwork();
@@ -37944,7 +37907,6 @@ program.commandsGroup("Data products:");
 registerSubgraphsCommand(program);
 registerSubscriptionsCommand(program);
 registerStreamsCommand(program);
-registerDatasetsCommand(program);
 registerIndexCommand(program);
 program.commandsGroup("Project & codegen:");
 registerProjectCommand(program);
@@ -37972,5 +37934,5 @@ registerAccountCommand(program);
 registerKeysCommand(program);
 program.parse();
 
-//# debugId=5C2D0497F3EEA0AA64756E2164756E21
+//# debugId=B164F591CA98B53C64756E2164756E21
 //# sourceMappingURL=cli.js.map