@secondlayer/cli 9.1.0 → 9.3.0

package/dist/cli.js

@@ -28910,7 +28910,7 @@ export default defineSubgraph({
 `;
 }
 function sip010Balances(name) {
-  return `import { defineSubgraph } from "@secondlayer/subgraphs";
+  return `import { defineSchema, defineSubgraph, readContractAt, type TypedSubgraphContext } from "@secondlayer/subgraphs";
 
 /**
  * Track SIP-010 token balances per (asset_identifier, holder).
@@ -28919,10 +28919,59 @@ function sip010Balances(name) {
  * token by adding \`assetIdentifier: "SP...token::token-name"\` to each
  * source filter.
  *
+ * Balances are moved with \`ctx.increment\`, which applies a DELTA in one
+ * atomic statement. That matters: a read-modify-write (findOne → compute →
+ * upsert) loses concurrent updates to the same row, and it is not replay-safe
+ * under \`backfillMode: "concurrent"\`. Deltas commute, so order doesn't
+ * matter and a reorg rewind reverses cleanly via the journal.
+ *
+ * Token metadata (decimals/symbol) comes from the token contract itself via
+ * \`readContractAt\`, so \`amount\` stops being a bare integer nobody can
+ * render. The read is pinned to the block being processed — a handler stays a
+ * pure function of its block — and \`cache: "contract-constant"\` says these
+ * two values can never change for a given token, so each is fetched ONCE
+ * instead of once per block.
+ *
  * Query examples once deployed:
  *   GET /v1/subgraphs/${name}/balances?_search=SP1...
  *   GET /v1/subgraphs/${name}/balances?holder=SP1...
+ *   GET /v1/subgraphs/${name}/tokens
  */
+
+/** The two SIP-010 read-only functions this subgraph calls. */
+const SIP010_ABI = {
+  functions: [
+    { name: "get-decimals", access: "read-only", args: [], outputs: { response: { ok: "uint128", error: "uint128" } } },
+    { name: "get-symbol", access: "read-only", args: [], outputs: { response: { ok: { "string-ascii": { length: 32 } }, error: "uint128" } } },
+  ],
+} as const;
+
+/** Tokens already labelled in this process — metadata is immutable, so one
+ *  resolution per token is enough even across a backfill. */
+const labelled = new Set<string>();
+
+// Hoisted so the helper below can be typed against it.
+const schema = defineSchema({
+  balances: {
+    columns: {
+      asset_identifier: { type: "text", indexed: true, search: true },
+      holder: { type: "principal", indexed: true, search: true },
+      amount: { type: "uint" },
+    },
+    // increment() upserts on this key.
+    uniqueKeys: [["asset_identifier", "holder"]],
+  },
+  tokens: {
+    columns: {
+      asset_identifier: { type: "text", indexed: true },
+      contract_id: { type: "text" },
+      symbol: { type: "text" },
+      decimals: { type: "uint" },
+    },
+    uniqueKeys: [["asset_identifier"]],
+  },
+});
+
 export default defineSubgraph({
   name: "${name}",
   version: "1.0.0",
@@ -28934,55 +28983,46 @@ export default defineSubgraph({
     burn: { type: "ft_burn" },
   },
 
-  schema: {
-    balances: {
-      columns: {
-        asset_identifier: { type: "text", indexed: true, search: true },
-        holder: { type: "principal", indexed: true, search: true },
-        amount: { type: "uint" },
-      },
-      uniqueKeys: [["asset_identifier", "holder"]],
-    },
-  },
+  schema,
 
   handlers: {
     transfer: async (event, ctx) => {
+      await labelToken(event.assetIdentifier, ctx);
       const amount = BigInt(event.amount ?? 0);
       if (event.sender) {
-        await adjust(ctx, event.assetIdentifier, event.sender, -amount);
+        ctx.increment("balances", { asset_identifier: event.assetIdentifier, holder: event.sender }, { amount: -amount });
       }
       if (event.recipient) {
-        await adjust(ctx, event.assetIdentifier, event.recipient, amount);
+        ctx.increment("balances", { asset_identifier: event.assetIdentifier, holder: event.recipient }, { amount });
       }
     },
-    mint: async (event, ctx) => {
+    mint: (event, ctx) => {
       if (event.recipient) {
-        await adjust(ctx, event.assetIdentifier, event.recipient, BigInt(event.amount ?? 0));
+        ctx.increment("balances", { asset_identifier: event.assetIdentifier, holder: event.recipient }, { amount: BigInt(event.amount ?? 0) });
       }
     },
-    burn: async (event, ctx) => {
+    burn: (event, ctx) => {
       if (event.sender) {
-        await adjust(ctx, event.assetIdentifier, event.sender, -BigInt(event.amount ?? 0));
+        ctx.increment("balances", { asset_identifier: event.assetIdentifier, holder: event.sender }, { amount: -BigInt(event.amount ?? 0) });
       }
     },
   },
 });
 
-async function adjust(
-  // biome-ignore lint/suspicious/noExplicitAny: subgraph runtime ctx shape
-  ctx: any,
-  assetIdentifier: string,
-  holder: string,
-  delta: bigint,
-): Promise<void> {
-  const existing = await ctx.findOne("balances", { asset_identifier: assetIdentifier, holder });
-  const current = existing ? BigInt(existing.amount) : 0n;
-  const next = current + delta;
-  await ctx.upsert(
-    "balances",
-    { asset_identifier: assetIdentifier, holder },
-    { asset_identifier: assetIdentifier, holder, amount: next },
-  );
+/** Resolve a token's symbol + decimals from its contract, once. */
+async function labelToken(
+  assetIdentifier: string | undefined,
+  ctx: TypedSubgraphContext<typeof schema>,
+) {
+  if (!assetIdentifier || labelled.has(assetIdentifier)) return;
+  labelled.add(assetIdentifier);
+  const contractId = assetIdentifier.split("::")[0];
+  const token = readContractAt(ctx, contractId, SIP010_ABI, { cache: "contract-constant" });
+  const [decimals, symbol] = await Promise.all([
+    token.read.getDecimals({}),
+    token.read.getSymbol({}),
+  ]);
+  ctx.upsert("tokens", { asset_identifier: assetIdentifier }, { asset_identifier: assetIdentifier, contract_id: contractId, symbol, decimals });
 }
 `;
 }
@@ -29206,6 +29246,223 @@ function deriveBaseUrl(apiUrl) {
   }
 }
 
+// src/commands/subgraph-test.ts
+var exports_subgraph_test = {};
+__export(exports_subgraph_test, {
+  runSubgraphTest: () => runSubgraphTest
+});
+import { createHash } from "node:crypto";
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { dirname as dirname3, resolve as resolve2 } from "node:path";
+import { Index } from "@secondlayer/sdk";
+function filterHashOf(sources) {
+  const stable = JSON.stringify(Object.fromEntries(Object.entries(sources).sort(([a4], [b2]) => a4.localeCompare(b2))), (_k, v2) => typeof v2 === "bigint" ? `${v2}n` : v2);
+  return createHash("sha256").update(stable).digest("hex").slice(0, 16);
+}
+function cassettePath(name) {
+  return resolve2(CASSETTE_DIR, `${name}.json`);
+}
+function loadCassette(name, filterHash) {
+  const path11 = cassettePath(name);
+  if (!existsSync2(path11))
+    return null;
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync3(path11, "utf8"));
+  } catch {
+    return { stale: "unreadable" };
+  }
+  if (parsed.decoderVersion !== DECODER_VERSION) {
+    return { stale: `recorded by decoder v${parsed.decoderVersion}` };
+  }
+  if (parsed.filterHash !== filterHash) {
+    return { stale: "sources changed since it was recorded" };
+  }
+  return parsed;
+}
+function eventTypeFor(filter) {
+  if (filter.type === "print_event")
+    return "print";
+  if (filter.type === "contract_call" || filter.type === "contract_deploy") {
+    return null;
+  }
+  return filter.type;
+}
+async function runSubgraphTest(file, options3) {
+  const absPath = resolve2(file);
+  if (!existsSync2(absPath)) {
+    error(`File not found: ${absPath}`);
+    process.exit(1);
+  }
+  const { readFile: readFile3 } = await import("node:fs/promises");
+  const { bundleSubgraphCode } = await import("@secondlayer/bundler");
+  const { createTestContext, buildEvent } = await import("@secondlayer/subgraphs/testing");
+  const source = await readFile3(absPath, "utf8");
+  const bundled = await bundleSubgraphCode(source);
+  const sources = bundled.sources ?? {};
+  const filterHash = filterHashOf(sources);
+  const mod = await import(`${absPath}?t=${Date.now()}`);
+  const def = mod.default;
+  if (!def?.handlers || !def.schema) {
+    error("File must default-export a defineSubgraph() definition with handlers and schema.");
+    process.exit(1);
+  }
+  const cached = loadCassette(bundled.name, filterHash);
+  if (cached && "stale" in cached) {
+    warn(`Cassette discarded (${cached.stale}) — re-recording.`);
+  }
+  const usable = cached && !("stale" in cached) ? cached : null;
+  let events;
+  let fromHeight;
+  let toHeight;
+  if (usable && options3.offline !== false && !options3.from) {
+    info(`Replaying cassette: blocks ${usable.fromHeight}–${usable.toHeight}, recorded ${usable.recordedAt}`);
+    events = usable.events;
+    fromHeight = usable.fromHeight;
+    toHeight = usable.toHeight;
+  } else {
+    if (options3.offline) {
+      error("No usable cassette for --offline. Record one first: sl subgraphs test <file> --from <h> --to <h>");
+      process.exit(1);
+    }
+    if (!options3.from) {
+      error("--from <height> is required for the first run (Index reads are metered). Later runs replay the cassette.");
+      process.exit(1);
+    }
+    fromHeight = Number(options3.from);
+    toHeight = options3.to ? Number(options3.to) : fromHeight + 100;
+    if (!Number.isInteger(fromHeight) || !Number.isInteger(toHeight)) {
+      error("--from/--to must be integers.");
+      process.exit(1);
+    }
+    const limit = options3.limit ? Number(options3.limit) : 500;
+    const index = new Index;
+    events = {};
+    for (const [name, filter] of Object.entries(sources)) {
+      const eventType = eventTypeFor(filter);
+      if (eventType === null) {
+        warn(`source "${name}" (${filter.type}) is not readable from index.events — skipped.`);
+        continue;
+      }
+      info(`Fetching ${name} (${eventType}) blocks ${fromHeight}–${toHeight}…`);
+      try {
+        const envelope = await index.events.list({
+          eventType,
+          ...filter.contractId ? {
+            contractId: Array.isArray(filter.contractId) ? filter.contractId : filter.contractId
+          } : {},
+          fromHeight,
+          toHeight,
+          limit
+        });
+        events[name] = envelope.events;
+      } catch (err) {
+        const e2 = err;
+        if (e2?.status === 402) {
+          const details = e2.body?.details;
+          error(`Blocks ${fromHeight}–${toHeight} are below the free read window.${details?.oldest_seekable_height ? ` Try --from ${details.oldest_seekable_height}, or add a paid API key (SL_API_KEY) to test against older history.` : " Add a paid API key (SL_API_KEY) to test against older history."}`);
+          process.exit(1);
+        }
+        throw err;
+      }
+    }
+    if (options3.record !== false) {
+      const cassette = {
+        decoderVersion: DECODER_VERSION,
+        filterHash,
+        subgraph: bundled.name,
+        fromHeight,
+        toHeight,
+        recordedAt: new Date().toISOString(),
+        events
+      };
+      const path11 = cassettePath(bundled.name);
+      mkdirSync(dirname3(path11), { recursive: true });
+      writeFileSync2(path11, `${JSON.stringify(cassette, (_k, v2) => typeof v2 === "bigint" ? `${v2}n` : v2, 2)}
+`);
+      info(`Recorded cassette → ${path11}`);
+    }
+  }
+  const ctx = createTestContext(def.schema);
+  let applied = 0;
+  let failed = 0;
+  const failures = [];
+  for (const [name, rows] of Object.entries(events)) {
+    const handler = def.handlers[name] ?? def.handlers["*"];
+    if (typeof handler !== "function") {
+      warn(`source "${name}": no handler — skipped.`);
+      continue;
+    }
+    const filter = sources[name];
+    for (const row of rows) {
+      const payload = toHandlerPayload(filter, row);
+      if (filter?.type === "print_event" && filter.topic && payload.topic !== filter.topic) {
+        continue;
+      }
+      try {
+        await handler(buildEvent(filter, payload), ctx);
+        applied++;
+      } catch (err) {
+        failed++;
+        if (failures.length < 5) {
+          failures.push(`  ${name} @ ${row.cursor}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+      }
+    }
+  }
+  info("");
+  const tables = Object.keys(def.schema);
+  let totalRows = 0;
+  for (const table of tables) {
+    const rows = await ctx.rows(table);
+    totalRows += rows.length;
+    info(`  ${table.padEnd(24)} ${String(rows.length).padStart(6)} rows`);
+    const sample = rows[0];
+    if (sample) {
+      const preview = Object.entries(sample).filter(([k2]) => !k2.startsWith("_")).slice(0, 4).map(([k2, v2]) => `${k2}=${String(v2).slice(0, 24)}`).join("  ");
+      info(`  ${"".padEnd(24)} ${preview}`);
+    }
+  }
+  info("");
+  if (failed > 0) {
+    warn(`${failed} handler error${failed === 1 ? "" : "s"}:`);
+    for (const f2 of failures)
+      warn(f2);
+  }
+  const fetched = Object.values(events).reduce((n3, r2) => n3 + r2.length, 0);
+  if (fetched === 0) {
+    warn(`No events matched these sources in blocks ${fromHeight}–${toHeight}. Widen the range (--to) or check the source filters.`);
+    return;
+  }
+  if (totalRows === 0) {
+    error(`${applied} event${applied === 1 ? "" : "s"} applied, but NO rows were written — the shape of the field-mapping bug that shipped a 0-row subgraph. Check your handler's field names against the payload.`);
+    process.exit(1);
+  }
+  success(`${applied} event${applied === 1 ? "" : "s"} → ${totalRows} row${totalRows === 1 ? "" : "s"} across ${tables.length} table${tables.length === 1 ? "" : "s"} (blocks ${fromHeight}–${toHeight})`);
+}
+function toHandlerPayload(_filter, row) {
+  if (row.event_type === "print") {
+    const payload = row.payload;
+    return {
+      contractId: row.contract_id ?? "",
+      topic: payload?.topic ?? "",
+      data: payload?.value ?? {}
+    };
+  }
+  const r2 = row;
+  return {
+    ...r2.sender !== undefined ? { sender: r2.sender } : {},
+    ...r2.recipient !== undefined ? { recipient: r2.recipient } : {},
+    ...r2.amount !== undefined ? { amount: BigInt(String(r2.amount)) } : {},
+    ...r2.asset_identifier !== undefined ? { assetIdentifier: r2.asset_identifier } : {},
+    ...r2.value !== undefined ? { tokenId: r2.value } : {}
+  };
+}
+var CASSETTE_DIR = "cassettes", DECODER_VERSION = 1;
+var init_subgraph_test = __esm(() => {
+  init_output();
+});
+
 // src/commands/subgraphs.ts
 var exports_subgraphs = {};
 __export(exports_subgraphs, {
@@ -29224,13 +29481,13 @@ __export(exports_subgraphs, {
 });
 import { spawn as spawn2 } from "node:child_process";
 import {
-  existsSync as existsSync2,
-  mkdirSync,
-  readFileSync as readFileSync3,
+  existsSync as existsSync3,
+  mkdirSync as mkdirSync2,
+  readFileSync as readFileSync4,
   watch,
-  writeFileSync as writeFileSync2
+  writeFileSync as writeFileSync3
 } from "node:fs";
-import { basename, dirname as dirname3, extname, join as join4, resolve as resolve2 } from "node:path";
+import { basename, dirname as dirname4, extname, join as join4, resolve as resolve3 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 import { confirm as confirm3 } from "@inquirer/prompts";
 import {
@@ -29319,8 +29576,8 @@ function ormFlagsConflictingWithPayloads(getOptionValueSource) {
   return Object.entries(ORM_ONLY_CODEGEN_FLAGS).filter(([key]) => getOptionValueSource(key) === "cli").map(([, flag]) => flag);
 }
 async function runPayloadsCodegen(file, output2) {
-  const absPath = resolve2(file);
-  if (!existsSync2(absPath)) {
+  const absPath = resolve3(file);
+  if (!existsSync3(absPath)) {
     error(`File not found: ${absPath}`);
     process.exit(1);
   }
@@ -29365,7 +29622,7 @@ async function runPayloadsCodegen(file, output2) {
     process.exit(1);
   }
   const out = generatePrintPayloadTypes({ sources });
-  const outPath = resolve2(output2 ?? join4(dirname3(absPath), `${basename(absPath, extname(absPath))}.payloads.d.ts`));
+  const outPath = resolve3(output2 ?? join4(dirname4(absPath), `${basename(absPath, extname(absPath))}.payloads.d.ts`));
   await writeTextFile(outPath, out);
   success(`Wrote print payload types to ${outPath}`);
 }
@@ -29390,10 +29647,10 @@ async function writeOrPrintSubgraphSpec(spec, format2, output2) {
     process.stdout.write(text2);
     return;
   }
-  const outPath = resolve2(output2);
-  const dir = resolve2(outPath, "..");
-  if (!existsSync2(dir))
-    mkdirSync(dir, { recursive: true });
+  const outPath = resolve3(output2);
+  const dir = resolve3(outPath, "..");
+  if (!existsSync3(dir))
+    mkdirSync2(dir, { recursive: true });
   await writeTextFile(outPath, text2);
   success(`Created ${outPath}`);
 }
@@ -29484,15 +29741,15 @@ function createLocalSubgraphDetail(input2) {
   };
 }
 function readCliSubgraphsDependency() {
-  const here = dirname3(fileURLToPath3(import.meta.url));
+  const here = dirname4(fileURLToPath3(import.meta.url));
   const candidates = [
-    resolve2(here, "..", "..", "package.json"),
-    resolve2(here, "..", "package.json")
+    resolve3(here, "..", "..", "package.json"),
+    resolve3(here, "..", "package.json")
   ];
   for (const candidate of candidates) {
-    if (!existsSync2(candidate))
+    if (!existsSync3(candidate))
       continue;
-    const pkg = JSON.parse(readFileSync3(candidate, "utf8"));
+    const pkg = JSON.parse(readFileSync4(candidate, "utf8"));
     const dep = pkg.dependencies?.["@secondlayer/subgraphs"];
     if (dep)
       return dep;
@@ -29502,8 +29759,8 @@ function readCliSubgraphsDependency() {
 function ensureScaffoldPackageJson(dir) {
   const packagePath = join4(dir, "package.json");
   const subgraphsDep = readCliSubgraphsDependency();
-  if (!existsSync2(packagePath)) {
-    writeFileSync2(packagePath, `${JSON.stringify({
+  if (!existsSync3(packagePath)) {
+    writeFileSync3(packagePath, `${JSON.stringify({
       type: "module",
       dependencies: {
         "@secondlayer/subgraphs": subgraphsDep
@@ -29512,14 +29769,14 @@ function ensureScaffoldPackageJson(dir) {
 `, "utf8");
     return;
   }
-  const pkg = JSON.parse(readFileSync3(packagePath, "utf8"));
+  const pkg = JSON.parse(readFileSync4(packagePath, "utf8"));
   if (pkg.dependencies?.["@secondlayer/subgraphs"])
     return;
   pkg.dependencies = {
     ...pkg.dependencies ?? {},
     "@secondlayer/subgraphs": subgraphsDep
   };
-  writeFileSync2(packagePath, `${JSON.stringify(pkg, null, 2)}
+  writeFileSync3(packagePath, `${JSON.stringify(pkg, null, 2)}
 `, "utf8");
 }
 async function runBunInstall(dir) {
@@ -29687,9 +29944,9 @@ ${SUBGRAPH_TEMPLATE_SLUGS.map((s2) => `  ${s2.padEnd(20)} ${SUBGRAPH_TEMPLATE_DE
 `)}`);
       process.exit(1);
     }
-    const dir = resolve2("subgraphs");
-    const filePath = resolve2(dir, `${name}.ts`);
-    if (existsSync2(filePath)) {
+    const dir = resolve3("subgraphs");
+    const filePath = resolve3(dir, `${name}.ts`);
+    if (existsSync3(filePath)) {
       error(`File already exists: ${filePath}`);
       process.exit(1);
     }
@@ -29717,8 +29974,8 @@ Check the contract id, and that the contract has emitted print events (schemas a
     } else {
       content = generateSubgraphTemplate(name, slug);
     }
-    if (!existsSync2(dir)) {
-      mkdirSync(dir, { recursive: true });
+    if (!existsSync3(dir)) {
+      mkdirSync2(dir, { recursive: true });
     }
     await writeTextFile(filePath, content);
     success(`Created ${filePath}`);
@@ -29731,8 +29988,8 @@ Check the contract id, and that the contract has emitted print events (schemas a
   });
   subgraphs.command("dev <file>").description("Watch a subgraph file and auto-redeploy on change").action(async (file) => {
     await requireLocalNetwork();
-    const absPath = resolve2(file);
-    if (!existsSync2(absPath)) {
+    const absPath = resolve3(file);
+    if (!existsSync3(absPath)) {
       error(`File not found: ${absPath}`);
       process.exit(1);
     }
@@ -29792,7 +30049,7 @@ Stopped watching.`);
   });
   subgraphs.command("deploy <file>").alias("update").description("Deploy a subgraph definition file (alias: update — deploy is create-or-update)").option("--start-block <n>", "Override the subgraph definition startBlock for this deploy").option("--tip-first", "Go live at chain tip immediately; history backfills in the background (requires order-tolerant handlers — commutative or insert-only writes)").option("--dry-run", "Validate and preview deploy without writing changes").option("-y, --yes", "Skip the reindex confirmation prompt").option("--database-url <url>", "BYO data plane: write the subgraph's schema/rows to your own Postgres. With --dry-run, prints the DDL + grant script and verifies the connection.").option("--strict", "Run `tsc --noEmit` against the handler before deploy (slower; catches TS type errors)").option("--visibility <visibility>", "Read visibility: public (anon /v1 reads, global name claim) or private (your key only). Defaults: managed → public, BYO → private.").action(async (file, options3) => {
     try {
-      const absPath = resolve2(file);
+      const absPath = resolve3(file);
       const config = await loadConfig2();
       if (config.network !== "local") {
         await requireAuth();
@@ -30093,8 +30350,8 @@ Synced — exiting watch.`));
     try {
       const format2 = parseSubgraphSpecFormat(options3.format);
       const specOptions = options3.server ? { serverUrl: options3.server } : undefined;
-      const absPath = resolve2(nameOrFile);
-      if (nameOrFile.endsWith(".ts") && !existsSync2(absPath)) {
+      const absPath = resolve3(nameOrFile);
+      if (nameOrFile.endsWith(".ts") && !existsSync3(absPath)) {
         error(`File not found: ${absPath}`);
         process.exit(1);
       }
@@ -30113,6 +30370,13 @@ Synced — exiting watch.`));
     deprecatedCodegenNotice("sl subgraphs codegen", options3.payloads ? "sl codegen prints" : "sl codegen subgraph");
     await runSubgraphSchemaCodegen(file, options3, (key) => command.getOptionValueSource(key));
   });
+  subgraphs.command("test <file>").description("Run a subgraph's handlers against real chain data without deploying").option("--from <height>", "Start block height (required on first run)").option("--to <height>", "End block height (defaults to --from + 100)").option("--offline", "Replay the recorded cassette; never hit the network").option("--no-record", "Don't write a cassette").option("--limit <n>", "Max events per source", "500").addHelpText("after", `
+Examples:
+  $ sl subgraphs test subgraphs/bns-names.ts --from 167484 --to 167600
+  $ sl subgraphs test subgraphs/bns-names.ts --offline`).action(async (file, options3) => {
+    const { runSubgraphTest: runSubgraphTest2 } = await Promise.resolve().then(() => (init_subgraph_test(), exports_subgraph_test));
+    await runSubgraphTest2(file, options3);
+  });
   subgraphs.command("reindex <name>").description("Reindex a subgraph from historical blocks (drops + reprocesses)").option("--from-block <n>", "Start block height").option("--to-block <n>", "End block height").option("-y, --yes", "Skip confirmation").addHelpText("after", `
 Examples:
   $ sl subgraphs reindex my-graph -y
@@ -30372,7 +30636,7 @@ Examples:
         error("a <contractAddress> is required (or use --trait)");
         process.exit(1);
       }
-      const outPath = resolve2(options3.output);
+      const outPath = resolve3(options3.output);
       let content;
       if (trait) {
         info(`Generating trait-scoped scaffold for ${trait}...`);
@@ -30392,9 +30656,9 @@ Examples:
           functions: options3.functions?.split(",").map((f2) => f2.trim()).filter(Boolean)
         });
       }
-      const dir = resolve2(outPath, "..");
-      if (!existsSync2(dir))
-        mkdirSync(dir, { recursive: true });
+      const dir = resolve3(outPath, "..");
+      if (!existsSync3(dir))
+        mkdirSync2(dir, { recursive: true });
       await writeTextFile(outPath, content);
       ensureScaffoldPackageJson(dir);
       success(`Created ${outPath}`);
@@ -30427,14 +30691,14 @@ async function runSubgraphClientCodegen(subgraphName, options3) {
       error("--output <path> is required");
       process.exit(1);
     }
-    const outPath = resolve2(options3.output);
+    const outPath = resolve3(options3.output);
     info(`Fetching subgraph metadata for "${subgraphName}"...`);
     const subgraphDetail = await getSubgraphApi(subgraphName);
     info("Generating typed client...");
     const content = await generateSubgraphConsumer(subgraphName, subgraphDetail);
-    const dir = resolve2(outPath, "..");
-    if (!existsSync2(dir))
-      mkdirSync(dir, { recursive: true });
+    const dir = resolve3(outPath, "..");
+    if (!existsSync3(dir))
+      mkdirSync2(dir, { recursive: true });
     await writeTextFile(outPath, content);
     success(`Created ${outPath}`);
   } catch (err) {
@@ -30457,8 +30721,8 @@ async function runSubgraphSchemaCodegen(file, options3, optionSource, defaultTar
       error(`Unsupported --target "${target}" (supported: prisma, drizzle, kysely).`);
       process.exit(1);
     }
-    const absPath = resolve2(file);
-    if (!existsSync2(absPath)) {
+    const absPath = resolve3(file);
+    if (!existsSync3(absPath)) {
       error(`File not found: ${absPath}`);
       process.exit(1);
     }
@@ -30485,7 +30749,7 @@ async function runSubgraphSchemaCodegen(file, options3, optionSource, defaultTar
       modelsOnly: options3.modelsOnly
     });
     if (options3.output) {
-      await writeTextFile(resolve2(options3.output), out);
+      await writeTextFile(resolve3(options3.output), out);
       success(`Wrote ${target} schema to ${options3.output}`);
       const next = target === "prisma" ? "point its datasource at your BYO database, then `prisma generate`." : target === "drizzle" ? "point your Drizzle connection at your BYO database (treat tables read-only)." : "import the `DB` type into `new Kysely<DB>()` against your BYO database.";
       info(`Next: ${next}`);
@@ -30527,10 +30791,10 @@ __export(exports_index_api, {
   runIndexCodegen: () => runIndexCodegen,
   registerIndexCommand: () => registerIndexCommand
 });
-import { resolve as resolve3 } from "node:path";
-import { Index } from "@secondlayer/sdk";
+import { resolve as resolve4 } from "node:path";
+import { Index as Index2 } from "@secondlayer/sdk";
 function client() {
-  return new Index({
+  return new Index2({
     baseUrl: process.env.SL_API_URL ?? DEFAULT_BASE_URL,
     apiKey: resolveEnvKey()
   });
@@ -30719,7 +30983,7 @@ async function runIndexCodegen(o3) {
       datasourceEnv: o3.env
     });
     if (o3.output) {
-      await writeTextFile(resolve3(o3.output), out);
+      await writeTextFile(resolve4(o3.output), out);
       success(`Wrote ${target} Index schema to ${o3.output}`);
     } else {
       process.stdout.write(out);
@@ -30831,9 +31095,9 @@ var init_query = __esm(() => {
   CLOSE = {};
   Query = class Query extends Promise {
     constructor(strings, args, handler, canceller, options3 = {}) {
-      let resolve4, reject;
+      let resolve5, reject;
       super((a4, b2) => {
-        resolve4 = a4;
+        resolve5 = a4;
         reject = b2;
       });
       this.tagged = Array.isArray(strings.raw);
@@ -30844,7 +31108,7 @@ var init_query = __esm(() => {
       this.options = options3;
       this.state = null;
       this.statement = null;
-      this.resolve = (x2) => (this.active = false, resolve4(x2));
+      this.resolve = (x2) => (this.active = false, resolve5(x2));
       this.reject = (x2) => (this.active = false, reject(x2));
       this.active = false;
       this.cancelled = null;
@@ -30892,12 +31156,12 @@ var init_query = __esm(() => {
             if (this.executed && !this.active)
               return { done: true };
             prev && prev();
-            const promise = new Promise((resolve4, reject) => {
+            const promise = new Promise((resolve5, reject) => {
               this.cursorFn = (value) => {
-                resolve4({ value, done: false });
+                resolve5({ value, done: false });
                 return new Promise((r2) => prev = r2);
               };
-              this.resolve = () => (this.active = false, resolve4({ done: true }));
+              this.resolve = () => (this.active = false, resolve5({ done: true }));
               this.reject = (x2) => (this.active = false, reject(x2));
             });
             this.execute();
@@ -31451,12 +31715,12 @@ function Connection(options3, queues = {}, { onopen = noop4, onend = noop4, oncl
     x2.on("drain", drain);
     return x2;
   }
-  async function cancel({ pid, secret }, resolve4, reject) {
+  async function cancel({ pid, secret }, resolve5, reject) {
     try {
       cancelMessage = bytes_default().i32(16).i32(80877102).i32(pid).i32(secret).end(16);
       await connect();
       socket.once("error", reject);
-      socket.once("close", resolve4);
+      socket.once("close", resolve5);
     } catch (error3) {
       reject(error3);
     }
@@ -32329,7 +32593,7 @@ var noop5 = () => {};
 // ../../node_modules/postgres/src/large.js
 import Stream2 from "stream";
 function largeObject(sql, oid, mode = 131072 | 262144) {
-  return new Promise(async (resolve4, reject) => {
+  return new Promise(async (resolve5, reject) => {
     await sql.begin(async (sql2) => {
       let finish;
       !oid && ([{ oid }] = await sql2`select lo_creat(-1) as oid`);
@@ -32355,7 +32619,7 @@ function largeObject(sql, oid, mode = 131072 | 262144) {
           ) seek
         `
       };
-      resolve4(lo);
+      resolve5(lo);
       return new Promise(async (r2) => finish = r2);
       async function readable2({
         highWaterMark = 2048 * 8,
@@ -32515,8 +32779,8 @@ function Postgres(a4, b3) {
   }
   async function reserve() {
     const queue = queue_default();
-    const c4 = open.length ? open.shift() : await new Promise((resolve4, reject) => {
-      const query = { reserve: resolve4, reject };
+    const c4 = open.length ? open.shift() : await new Promise((resolve5, reject) => {
+      const query = { reserve: resolve5, reject };
       queries.push(query);
       closed.length && connect(closed.shift(), query);
     });
@@ -32553,9 +32817,9 @@ function Postgres(a4, b3) {
       let uncaughtError, result;
       name && await sql2`savepoint ${sql2(name)}`;
       try {
-        result = await new Promise((resolve4, reject) => {
+        result = await new Promise((resolve5, reject) => {
           const x2 = fn2(sql2);
-          Promise.resolve(Array.isArray(x2) ? Promise.all(x2) : x2).then(resolve4, reject);
+          Promise.resolve(Array.isArray(x2) ? Promise.all(x2) : x2).then(resolve5, reject);
         });
         if (uncaughtError)
           throw uncaughtError;
@@ -32612,8 +32876,8 @@ function Postgres(a4, b3) {
     return c4.execute(query) ? move(c4, busy) : move(c4, full);
   }
   function cancel(query) {
-    return new Promise((resolve4, reject) => {
-      query.state ? query.active ? connection_default(options3).cancel(query.state, resolve4, reject) : query.cancelled = { resolve: resolve4, reject } : (queries.remove(query), query.cancelled = true, query.reject(Errors.generic("57014", "canceling statement due to user request")), resolve4());
+    return new Promise((resolve5, reject) => {
+      query.state ? query.active ? connection_default(options3).cancel(query.state, resolve5, reject) : query.cancelled = { resolve: resolve5, reject } : (queries.remove(query), query.cancelled = true, query.reject(Errors.generic("57014", "canceling statement due to user request")), resolve5());
     });
   }
   async function end({ timeout = null } = {}) {
@@ -32629,11 +32893,11 @@ function Postgres(a4, b3) {
   async function close() {
     await Promise.all(connections.map((c4) => c4.end()));
   }
-  async function destroy(resolve4) {
+  async function destroy(resolve5) {
     await Promise.all(connections.map((c4) => c4.terminate()));
     while (queries.length)
       queries.shift().reject(Errors.connection("CONNECTION_DESTROYED", options3));
-    resolve4();
+    resolve5();
   }
   function connect(c4, query) {
     move(c4, connecting);
@@ -33273,11 +33537,11 @@ var init_manager = __esm(() => {
 });
 
 // src/services/indexer.ts
-import { dirname as dirname8, resolve as resolve5 } from "node:path";
+import { dirname as dirname9, resolve as resolve6 } from "node:path";
 async function startIndexer(options3) {
   const port = options3.port ?? 3700;
-  const rootDir = dirname8(dirname8(dirname8(dirname8(import.meta.dir))));
-  const indexerPath = resolve5(rootDir, "packages/indexer/src/index.ts");
+  const rootDir = dirname9(dirname9(dirname9(dirname9(import.meta.dir))));
+  const indexerPath = resolve6(rootDir, "packages/indexer/src/index.ts");
   await serviceManager.start(SERVICE_NAME, ["bun", "run", "--watch", indexerPath], {
     port,
     env: {
@@ -33293,10 +33557,10 @@ var init_indexer = __esm(() => {
 });
 
 // src/services/worker.ts
-import { dirname as dirname9, resolve as resolve6 } from "node:path";
+import { dirname as dirname10, resolve as resolve7 } from "node:path";
 async function startWorker(options3) {
-  const rootDir = dirname9(dirname9(dirname9(dirname9(import.meta.dir))));
-  const workerPath = resolve6(rootDir, "packages/worker/src/index.ts");
+  const rootDir = dirname10(dirname10(dirname10(dirname10(import.meta.dir))));
+  const workerPath = resolve7(rootDir, "packages/worker/src/index.ts");
   await serviceManager.start(SERVICE_NAME2, ["bun", "run", "--watch", workerPath], {
     onStdout: options3.onLog,
     onStderr: options3.onLog
@@ -33308,11 +33572,11 @@ var init_worker = __esm(() => {
 });
 
 // src/services/api.ts
-import { dirname as dirname10, resolve as resolve7 } from "node:path";
+import { dirname as dirname11, resolve as resolve8 } from "node:path";
 async function startApi(options3) {
   const port = options3.port ?? 3800;
-  const rootDir = dirname10(dirname10(dirname10(dirname10(import.meta.dir))));
-  const apiPath = resolve7(rootDir, "packages/api/src/index.ts");
+  const rootDir = dirname11(dirname11(dirname11(dirname11(import.meta.dir))));
+  const apiPath = resolve8(rootDir, "packages/api/src/index.ts");
   await serviceManager.start(SERVICE_NAME3, ["bun", "run", "--watch", apiPath], {
     port,
     env: {
@@ -33328,10 +33592,10 @@ var init_api2 = __esm(() => {
 });
 
 // src/services/subgraph-processor.ts
-import { dirname as dirname11, resolve as resolve8 } from "node:path";
+import { dirname as dirname12, resolve as resolve9 } from "node:path";
 async function startSubgraphProcessor(options3) {
-  const rootDir = dirname11(dirname11(dirname11(dirname11(import.meta.dir))));
-  const servicePath = resolve8(rootDir, "packages/subgraphs/src/service.ts");
+  const rootDir = dirname12(dirname12(dirname12(dirname12(import.meta.dir))));
+  const servicePath = resolve9(rootDir, "packages/subgraphs/src/service.ts");
   await serviceManager.start(SERVICE_NAME4, ["bun", "run", "--watch", servicePath], {
     env: {
       SUBGRAPH_CONCURRENCY: String(options3.concurrency ?? 5)
@@ -33365,8 +33629,8 @@ __export(exports_dev_impl, {
   restartDev: () => restartDev,
   isDevAlreadyRunning: () => isDevAlreadyRunning
 });
-import { mkdirSync as mkdirSync4 } from "node:fs";
-import { dirname as dirname12, join as join11, resolve as resolve9 } from "node:path";
+import { mkdirSync as mkdirSync5 } from "node:fs";
+import { dirname as dirname13, join as join11, resolve as resolve10 } from "node:path";
 async function isDevAlreadyRunning() {
   if (await isDevRunning()) {
     const running = await getRunningServices();
@@ -33444,10 +33708,10 @@ async function runBackground(options3) {
     startedAt: new Date().toISOString()
   };
   try {
-    const packagesDir = dirname12(dirname12(dirname12(dirname12(import.meta.dir))));
+    const packagesDir = dirname13(dirname13(dirname13(dirname13(import.meta.dir))));
     const env2 = { DATABASE_URL: databaseUrl, DEV_MODE: "true" };
     const apiLogFile = getLogFile("api");
-    const apiProc = Bun.spawn(["bun", "run", resolve9(packagesDir, "packages/api/src/index.ts")], {
+    const apiProc = Bun.spawn(["bun", "run", resolve10(packagesDir, "packages/api/src/index.ts")], {
       env: { ...process.env, ...env2, PORT: String(apiPort) },
       stdout: Bun.file(apiLogFile),
       stderr: Bun.file(apiLogFile)
@@ -33460,7 +33724,7 @@ async function runBackground(options3) {
     };
     console.log(green("  ✓ API"), dim(`http://localhost:${apiPort}`));
     const indexerLogFile = getLogFile("indexer");
-    const indexerProc = Bun.spawn(["bun", "run", resolve9(packagesDir, "packages/indexer/src/index.ts")], {
+    const indexerProc = Bun.spawn(["bun", "run", resolve10(packagesDir, "packages/indexer/src/index.ts")], {
       env: { ...process.env, ...env2, PORT: String(indexerPort) },
       stdout: Bun.file(indexerLogFile),
       stderr: Bun.file(indexerLogFile)
@@ -33474,7 +33738,7 @@ async function runBackground(options3) {
     console.log(green("  ✓ Indexer"), dim(`http://localhost:${indexerPort}`));
     if (options3.worker) {
       const workerLogFile = getLogFile("worker");
-      const workerProc = Bun.spawn(["bun", "run", resolve9(packagesDir, "packages/worker/src/index.ts")], {
+      const workerProc = Bun.spawn(["bun", "run", resolve10(packagesDir, "packages/worker/src/index.ts")], {
         env: { ...process.env, ...env2 },
         stdout: Bun.file(workerLogFile),
         stderr: Bun.file(workerLogFile)
@@ -33492,7 +33756,7 @@ async function runBackground(options3) {
       const subgraphsProc = Bun.spawn([
         "bun",
         "run",
-        resolve9(packagesDir, "packages/subgraphs/src/service.ts")
+        resolve10(packagesDir, "packages/subgraphs/src/service.ts")
       ], {
         env: { ...process.env, ...env2 },
         stdout: Bun.file(subgraphsLogFile),
@@ -33794,7 +34058,7 @@ async function restartDev() {
   await clearDevState();
   await clearLogs();
   const config = await loadConfig2();
-  const packagesDir = dirname12(dirname12(dirname12(dirname12(import.meta.dir))));
+  const packagesDir = dirname13(dirname13(dirname13(dirname13(import.meta.dir))));
   const env2 = state.env;
   const newState = {
     services: {},
@@ -33804,7 +34068,7 @@ async function restartDev() {
   };
   const apiPort = config.ports.api;
   const apiLogFile = getLogFile("api");
-  const apiProc = Bun.spawn(["bun", "run", resolve9(packagesDir, "packages/api/src/index.ts")], {
+  const apiProc = Bun.spawn(["bun", "run", resolve10(packagesDir, "packages/api/src/index.ts")], {
     env: { ...process.env, ...env2, PORT: String(apiPort) },
     stdout: Bun.file(apiLogFile),
     stderr: Bun.file(apiLogFile)
@@ -33818,7 +34082,7 @@ async function restartDev() {
   console.log(green("  ✓ API"), dim(`http://localhost:${apiPort}`));
   const indexerPort = config.ports.indexer;
   const indexerLogFile = getLogFile("indexer");
-  const indexerProc = Bun.spawn(["bun", "run", resolve9(packagesDir, "packages/indexer/src/index.ts")], {
+  const indexerProc = Bun.spawn(["bun", "run", resolve10(packagesDir, "packages/indexer/src/index.ts")], {
     env: { ...process.env, ...env2, PORT: String(indexerPort) },
     stdout: Bun.file(indexerLogFile),
     stderr: Bun.file(indexerLogFile)
@@ -33832,7 +34096,7 @@ async function restartDev() {
   console.log(green("  ✓ Indexer"), dim(`http://localhost:${indexerPort}`));
   if (state.services.worker) {
     const workerLogFile = getLogFile("worker");
-    const workerProc = Bun.spawn(["bun", "run", resolve9(packagesDir, "packages/worker/src/index.ts")], {
+    const workerProc = Bun.spawn(["bun", "run", resolve10(packagesDir, "packages/worker/src/index.ts")], {
       env: { ...process.env, ...env2 },
       stdout: Bun.file(workerLogFile),
       stderr: Bun.file(workerLogFile)
@@ -33847,7 +34111,7 @@ async function restartDev() {
   }
   if (state.services.subgraphs) {
     const subgraphsLogFile = getLogFile("subgraphs");
-    const subgraphsProc = Bun.spawn(["bun", "run", resolve9(packagesDir, "packages/subgraphs/src/service.ts")], {
+    const subgraphsProc = Bun.spawn(["bun", "run", resolve10(packagesDir, "packages/subgraphs/src/service.ts")], {
       env: { ...process.env, ...env2 },
       stdout: Bun.file(subgraphsLogFile),
       stderr: Bun.file(subgraphsLogFile)
@@ -33976,7 +34240,7 @@ async function ensureDevPostgres(dataDir) {
     return false;
   }
   const pgDataDir = join11(dataDir, "postgres");
-  mkdirSync4(pgDataDir, { recursive: true });
+  mkdirSync5(pgDataDir, { recursive: true });
   const stopped = await Bun.$`docker ps -aq -f name=secondlayer-dev-postgres`.quiet().nothrow();
   if (stopped.stdout.toString().trim()) {
     await Bun.$`docker rm secondlayer-dev-postgres`.quiet().nothrow();
@@ -33991,8 +34255,8 @@ async function ensureDevPostgres(dataDir) {
   throw new Error("PostgreSQL failed to start");
 }
 async function runMigrations(databaseUrl) {
-  const packagesDir = dirname12(dirname12(dirname12(dirname12(import.meta.dir))));
-  const migrateScript = resolve9(packagesDir, "packages/shared/src/db/migrate.ts");
+  const packagesDir = dirname13(dirname13(dirname13(dirname13(import.meta.dir))));
+  const migrateScript = resolve10(packagesDir, "packages/shared/src/db/migrate.ts");
   const result = await Bun.$`DATABASE_URL=${databaseUrl} bun run ${migrateScript}`.quiet().nothrow();
   if (result.exitCode !== 0) {
     throw new Error(`Migration failed: ${result.stderr.toString()}`);
@@ -34475,7 +34739,7 @@ var {
 // package.json
 var package_default = {
   name: "@secondlayer/cli",
-  version: "9.1.0",
+  version: "9.3.0",
   repository: {
     type: "git",
     url: "git+https://github.com/ryanwaits/secondlayer.git",
@@ -34500,7 +34764,11 @@ var package_default = {
       import: "./dist/plugins/index.js"
     }
   },
-  files: ["dist", "templates", "README.md"],
+  files: [
+    "dist",
+    "templates",
+    "README.md"
+  ],
   scripts: {
     build: "bunup",
     dev: "bunup --watch",
@@ -34508,7 +34776,13 @@ var package_default = {
     typecheck: "tsc --noEmit",
     prepublishOnly: "bun run build"
   },
-  keywords: ["stacks", "clarity", "blockchain", "smart-contracts", "cli"],
+  keywords: [
+    "stacks",
+    "clarity",
+    "blockchain",
+    "smart-contracts",
+    "cli"
+  ],
   author: "",
   license: "MIT",
   dependencies: {
@@ -34517,8 +34791,8 @@ var package_default = {
     "@secondlayer/scaffold": "^1.5.0",
     "@secondlayer/sdk": "^6.36.0",
     "@secondlayer/shared": "^7.0.3",
-    "@secondlayer/stacks": "^2.21.0",
-    "@secondlayer/subgraphs": "^3.21.0",
+    "@secondlayer/stacks": "^2.22.0",
+    "@secondlayer/subgraphs": "^3.23.0",
     "@biomejs/js-api": "^0.7.0",
     "@biomejs/wasm-nodejs": "^1.9.0",
     esbuild: "^0.27.4",
@@ -35213,14 +35487,14 @@ init_output();
 init_resolve_auth();
 import {
   copyFileSync,
-  existsSync as existsSync3,
-  mkdirSync as mkdirSync2,
-  readFileSync as readFileSync4,
+  existsSync as existsSync4,
+  mkdirSync as mkdirSync3,
+  readFileSync as readFileSync5,
   readdirSync,
   statSync as statSync2,
-  writeFileSync as writeFileSync3
+  writeFileSync as writeFileSync4
 } from "node:fs";
-import { dirname as dirname4, join as join6, relative, resolve as resolve4 } from "node:path";
+import { dirname as dirname5, join as join6, relative, resolve as resolve5 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 import { input as input2, select as select3 } from "@inquirer/prompts";
 import { SecondLayer as SecondLayer3 } from "@secondlayer/sdk";
@@ -35235,17 +35509,17 @@ var FORMAT_BY_RUNTIME = {
   node: "standard-webhooks"
 };
 function templatesRoot() {
-  const here = dirname4(fileURLToPath4(import.meta.url));
-  const candidateDist = resolve4(here, "..", "templates", "subscriptions");
-  if (existsSync3(candidateDist))
+  const here = dirname5(fileURLToPath4(import.meta.url));
+  const candidateDist = resolve5(here, "..", "templates", "subscriptions");
+  if (existsSync4(candidateDist))
     return candidateDist;
-  return resolve4(here, "..", "..", "templates", "subscriptions");
+  return resolve5(here, "..", "..", "templates", "subscriptions");
 }
 function copyTemplate(src2, dest, vars) {
-  if (!existsSync3(src2)) {
+  if (!existsSync4(src2)) {
     throw new Error(`template dir missing: ${src2}`);
   }
-  mkdirSync2(dest, { recursive: true });
+  mkdirSync3(dest, { recursive: true });
   const entries2 = readdirSync(src2);
   for (const entry of entries2) {
     const from = join6(src2, entry);
@@ -35254,9 +35528,9 @@ function copyTemplate(src2, dest, vars) {
     if (st.isDirectory()) {
       copyTemplate(from, to, vars);
     } else {
-      const raw = readFileSync4(from, "utf8");
+      const raw = readFileSync5(from, "utf8");
       const rendered = raw.replace(/\{\{([A-Z_]+)\}\}/g, (match, key) => vars[key] ?? match);
-      writeFileSync3(to, rendered);
+      writeFileSync4(to, rendered);
     }
   }
 }
@@ -35265,7 +35539,7 @@ function parseTriggersInput(opts) {
   if (opts.triggersFile) {
     let parsed;
     try {
-      parsed = JSON.parse(readFileSync4(opts.triggersFile, "utf8"));
+      parsed = JSON.parse(readFileSync5(opts.triggersFile, "utf8"));
     } catch (err) {
       throw new Error(`Could not read/parse --triggers-file ${opts.triggersFile}: ${err instanceof Error ? err.message : String(err)}`);
     }
@@ -35350,9 +35624,9 @@ async function createSubscription(name, opts) {
     }
   }
   const eventName = `${subgraph}.${table}.created`;
-  const targetDir = resolve4(process.cwd(), name);
+  const targetDir = resolve5(process.cwd(), name);
   if (!opts.scaffold === false) {
-    if (existsSync3(targetDir)) {
+    if (existsSync4(targetDir)) {
       error(`Directory already exists: ${relative(process.cwd(), targetDir)}`);
       process.exit(1);
     }
@@ -35403,15 +35677,15 @@ async function createSubscription(name, opts) {
   if (signingSecret && !opts.scaffold === false) {
     const envTarget = join6(targetDir, ".env");
     const envExample = join6(targetDir, ".env.example");
-    if (existsSync3(envExample) && !existsSync3(envTarget)) {
+    if (existsSync4(envExample) && !existsSync4(envTarget)) {
       copyFileSync(envExample, envTarget);
     }
-    if (!existsSync3(envTarget)) {
-      writeFileSync3(envTarget, `SIGNING_SECRET=${signingSecret}
+    if (!existsSync4(envTarget)) {
+      writeFileSync4(envTarget, `SIGNING_SECRET=${signingSecret}
 `);
     } else {
-      const cur = readFileSync4(envTarget, "utf8");
-      writeFileSync3(envTarget, cur.match(/^SIGNING_SECRET=/m) ? cur.replace(/^SIGNING_SECRET=.*/m, `SIGNING_SECRET=${signingSecret}`) : `${cur}
+      const cur = readFileSync5(envTarget, "utf8");
+      writeFileSync4(envTarget, cur.match(/^SIGNING_SECRET=/m) ? cur.replace(/^SIGNING_SECRET=.*/m, `SIGNING_SECRET=${signingSecret}`) : `${cur}
 SIGNING_SECRET=${signingSecret}
 `);
     }
@@ -36178,8 +36452,8 @@ POST result (client-side, not logged):`));
 }
 // src/commands/devnet.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { existsSync as existsSync5, mkdirSync as mkdirSync3, writeFileSync as writeFileSync5 } from "node:fs";
-import { dirname as dirname6, join as join8 } from "node:path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync4, writeFileSync as writeFileSync6 } from "node:fs";
+import { dirname as dirname7, join as join8 } from "node:path";
 
 // src/lib/devnet-compose.ts
 var DEFAULT_IMAGE_OWNER = "ryanwaits";
@@ -36321,24 +36595,24 @@ volumes:
 }
 
 // src/lib/devnet-config.ts
-import { existsSync as existsSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "node:fs";
-import { dirname as dirname5, join as join7, parse as parsePath } from "node:path";
+import { existsSync as existsSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "node:fs";
+import { dirname as dirname6, join as join7, parse as parsePath } from "node:path";
 import { parse as parseToml } from "smol-toml";
 var DEFAULT_INDEXER_OBSERVER = "host.docker.internal:3700";
 function findClarinetProject(startDir) {
   let dir = startDir;
   const { root } = parsePath(dir);
   while (true) {
-    if (existsSync4(join7(dir, "Clarinet.toml")))
+    if (existsSync5(join7(dir, "Clarinet.toml")))
       return dir;
     if (dir === root)
       return null;
-    dir = dirname5(dir);
+    dir = dirname6(dir);
   }
 }
 function ensureEventObserver(devnetTomlPath, endpoint = DEFAULT_INDEXER_OBSERVER) {
-  const exists = existsSync4(devnetTomlPath);
-  const original = exists ? readFileSync5(devnetTomlPath, "utf8") : "";
+  const exists = existsSync5(devnetTomlPath);
+  const original = exists ? readFileSync6(devnetTomlPath, "utf8") : "";
   if (original.trim()) {
     const parsed = parseToml(original);
     const observers = parsed.devnet?.stacks_node_events_observers;
@@ -36352,7 +36626,7 @@ function ensureEventObserver(devnetTomlPath, endpoint = DEFAULT_INDEXER_OBSERVER
     const at = (arrayStart.index ?? 0) + arrayStart[0].length;
     const next = original.slice(at).trimStart().startsWith("]") ? entry : `${entry}, `;
     const patched = original.slice(0, at) + next + original.slice(at);
-    writeFileSync4(devnetTomlPath, patched);
+    writeFileSync5(devnetTomlPath, patched);
     return { status: "added" };
   }
   const header = original.match(/^\[devnet\]\s*$/m);
@@ -36360,7 +36634,7 @@ function ensureEventObserver(devnetTomlPath, endpoint = DEFAULT_INDEXER_OBSERVER
     const at = (header.index ?? 0) + header[0].length;
     const patched = `${original.slice(0, at)}
 stacks_node_events_observers = [${entry}]${original.slice(at)}`;
-    writeFileSync4(devnetTomlPath, patched);
+    writeFileSync5(devnetTomlPath, patched);
     return { status: "added" };
   }
   const prefix = original && !original.endsWith(`
@@ -36370,7 +36644,7 @@ stacks_node_events_observers = [${entry}]${original.slice(at)}`;
 ` : ""}[devnet]
 stacks_node_events_observers = [${entry}]
 `;
-  writeFileSync4(devnetTomlPath, block);
+  writeFileSync5(devnetTomlPath, block);
   return { status: exists ? "added" : "created" };
 }
 
@@ -36420,7 +36694,7 @@ function registerDevnetCommand(program2) {
 }
 function resolveProject(explicit) {
   if (explicit) {
-    if (!existsSync5(join8(explicit, "Clarinet.toml"))) {
+    if (!existsSync6(join8(explicit, "Clarinet.toml"))) {
       error(`No Clarinet.toml in ${explicit}`);
       process.exit(1);
     }
@@ -36437,7 +36711,7 @@ function resolveProject(explicit) {
 async function connect(options3) {
   const project = resolveProject(options3.project);
   const devnetToml = join8(project, "settings", "Devnet.toml");
-  mkdirSync3(dirname6(devnetToml), { recursive: true });
+  mkdirSync4(dirname7(devnetToml), { recursive: true });
   const result = ensureEventObserver(devnetToml, DEFAULT_INDEXER_OBSERVER);
   console.log(`${green("✓")} found Clarinet.toml`);
   if (result.status === "present") {
@@ -36447,8 +36721,8 @@ async function connect(options3) {
     console.log(dim(`    + stacks_node_events_observers = ["${DEFAULT_INDEXER_OBSERVER}"]`));
   }
   const composePath = join8(project, COMPOSE_REL);
-  mkdirSync3(dirname6(composePath), { recursive: true });
-  writeFileSync5(composePath, buildDevnetCompose({ owner: options3.owner, imageTag: options3.imageTag }));
+  mkdirSync4(dirname7(composePath), { recursive: true });
+  writeFileSync6(composePath, buildDevnetCompose({ owner: options3.owner, imageTag: options3.imageTag }));
   console.log(`${green("✓")} wrote ${COMPOSE_REL}`);
   if (!options3.up) {
     console.log(dim(`
@@ -36477,7 +36751,7 @@ Stop with: sl devnet down`));
 async function down(options3) {
   const project = resolveProject(options3.project);
   const composePath = join8(project, COMPOSE_REL);
-  if (!existsSync5(composePath)) {
+  if (!existsSync6(composePath)) {
     error(`No ${COMPOSE_REL} in ${project} — nothing to stop. Run \`sl devnet connect\` first.`);
     process.exit(1);
   }
@@ -36492,7 +36766,7 @@ async function down(options3) {
 async function logs(service, options3) {
   const project = resolveProject(options3.project);
   const composePath = join8(project, COMPOSE_REL);
-  if (!existsSync5(composePath)) {
+  if (!existsSync6(composePath)) {
     error(`No ${COMPOSE_REL} in ${project} — run \`sl devnet connect\` first.`);
     process.exit(1);
   }
@@ -36617,7 +36891,7 @@ init_subgraphs2();
 init_output();
 init_resolve_auth();
 import { mkdir as mkdir3, writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname7, join as join9 } from "node:path";
+import { dirname as dirname8, join as join9 } from "node:path";
 import { createStreamsClient } from "@secondlayer/sdk";
 import { STREAMS_EVENT_TYPES } from "@secondlayer/shared";
 var DEFAULT_BASE_URL3 = "https://api.secondlayer.tools";
@@ -36794,7 +37068,7 @@ Examples:
       for (const file of files) {
         const bytes = await dumps.download(file);
         const dest = join9(options3.to, file.path);
-        await mkdir3(dirname7(dest), { recursive: true });
+        await mkdir3(dirname8(dest), { recursive: true });
         await writeFile3(dest, bytes);
         process.stderr.write(`# ${file.path} (${file.row_count} rows, ${bytes.byteLength} bytes)
 `);
@@ -38080,10 +38354,10 @@ init_http();
 init_output();
 
 // src/lib/project-file.ts
-import { existsSync as existsSync6 } from "node:fs";
+import { existsSync as existsSync7 } from "node:fs";
 import { mkdir as mkdir4, readFile as readFile3, writeFile as writeFile4 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
-import { dirname as dirname13, join as join12, parse as parsePath2, resolve as resolve10 } from "node:path";
+import { dirname as dirname14, join as join12, parse as parsePath2, resolve as resolve11 } from "node:path";
 import { z as z4 } from "zod";
 var ProjectFileSchema = z4.object({
   slug: z4.string().min(1)
@@ -38091,23 +38365,23 @@ var ProjectFileSchema = z4.object({
 var FILENAME = "project";
 var DIRNAME = ".secondlayer";
 async function readActiveProject(cwd, globalDefault) {
-  let dir = resolve10(cwd);
-  const home2 = resolve10(homedir5());
+  let dir = resolve11(cwd);
+  const home2 = resolve11(homedir5());
   const fsRoot = parsePath2(dir).root;
   while (true) {
     const candidate = join12(dir, DIRNAME, FILENAME);
-    if (existsSync6(candidate)) {
+    if (existsSync7(candidate)) {
       try {
         const raw = await readFile3(candidate, "utf8");
         const parsed = ProjectFileSchema.parse(JSON.parse(raw));
         return { slug: parsed.slug, resolvedFrom: candidate };
       } catch {}
     }
-    if (existsSync6(join12(dir, ".git")))
+    if (existsSync7(join12(dir, ".git")))
       break;
     if (dir === home2 || dir === fsRoot)
       break;
-    const parent = dirname13(dir);
+    const parent = dirname14(dir);
     if (parent === dir)
       break;
     dir = parent;
@@ -38121,7 +38395,7 @@ async function readActiveProject(cwd, globalDefault) {
   return null;
 }
 async function writeActiveProject(slug, cwd) {
-  const dir = join12(resolve10(cwd), DIRNAME);
+  const dir = join12(resolve11(cwd), DIRNAME);
   await mkdir4(dir, { recursive: true });
   const file = join12(dir, FILENAME);
   await writeFile4(file, `${JSON.stringify({ slug }, null, 2)}
@@ -38345,5 +38619,5 @@ registerAccountCommand(program);
 registerKeysCommand(program);
 program.parse();
 
-//# debugId=D8E1B996905C6BA564756E2164756E21
+//# debugId=083CEA7A9489EF8064756E2164756E21
 //# sourceMappingURL=cli.js.map