@secondlayer/subgraphs 6.4.0 → 6.6.0

package/dist/schema/index.d.ts

@@ -16,7 +16,7 @@ import { AssetIdentifier } from "@secondlayer/stacks/filters";
 */
 type ChainReadCacheMode = "per-block" | "contract-constant";
 type ChainReadOptions = {
-	cache?: ChainReadCacheMode
+	cache?: ChainReadCacheMode;
 };
 /**
 * `ChainReadClient` with the ABI generic erased. Structurally cheap, so the
@@ -25,7 +25,7 @@ type ChainReadOptions = {
 */
 interface ErasedChainReadClient {
 	contract(contractId: string, abi: unknown, options?: ChainReadOptions): {
-		read: Record<string, (args?: Record<string, unknown>) => Promise<unknown>>
+		read: Record<string, (args?: Record<string, unknown>) => Promise<unknown>>;
 	};
 }
 /** Supported column types for subgraph schemas */
@@ -86,7 +86,7 @@ interface StxLockFilter {
 * as-of each processed block. Lets a source index "all SIP-010 tokens" etc.
 */
 type TraitScope = {
-	trait?: string
+	trait?: string;
 };
 /**
 * Scope a source to a DYNAMIC address set discovered from another source's
@@ -126,10 +126,10 @@ type TraitScope = {
 interface FactoryScope {
 	factory?: {
 		/** Source name whose events reveal the addresses. */
-		from: string
+		from: string;
 		/** Dotted path to the address on that source's payload
 		*  (e.g. `"data.pool"`, `"contractId"`, `"data.token.id"`). */
-		field: string
+		field: string;
 	};
 }
 /** FT event filters */
@@ -235,12 +235,12 @@ interface MapWriteFilter extends TraitScope, FactoryScope {
 * - `{ list: F }` — a list of `F`.
 */
 type PrintField = ColumnType | {
-	type: PrintField
-	optional: true
+	type: PrintField;
+	optional: true;
 } | {
-	tuple: Record<string, PrintField>
+	tuple: Record<string, PrintField>;
 } | {
-	list: PrintField
+	list: PrintField;
 };
 /**
 * Per-topic field schema for a print_event source. When declared, the handler's
@@ -252,34 +252,34 @@ type PrintField = ColumnType | {
 */
 type PrintEventPrints = Record<string, Record<string, PrintField>>;
 type PrintEventFields = FactoryScope & {
-	type: "print_event"
-	topic?: string
+	type: "print_event";
+	topic?: string;
 };
 /**
 * Pinned to one or more contract ids with no trait — `prints` is required so
 * `event.data` is typed and empty-table handlers cannot typecheck.
 */
 type PinnedPrintEventFilter = PrintEventFields & {
-	contractId: string | readonly string[]
-	trait?: undefined
-	prints: PrintEventPrints
+	contractId: string | readonly string[];
+	trait?: undefined;
+	prints: PrintEventPrints;
 };
 /**
 * Trait-scoped print source (optionally narrowed by contractId). No single
 * schema — `prints` stays optional.
 */
 type TraitPrintEventFilter = PrintEventFields & {
-	contractId?: string | readonly string[]
-	trait: string
-	prints?: PrintEventPrints
+	contractId?: string | readonly string[];
+	trait: string;
+	prints?: PrintEventPrints;
 };
 /**
 * Unpinned / factory-only print source (no contractId). `prints` optional.
 */
 type UnpinnedPrintEventFilter = PrintEventFields & {
-	contractId?: undefined
-	trait?: string
-	prints?: PrintEventPrints
+	contractId?: undefined;
+	trait?: string;
+	prints?: PrintEventPrints;
 };
 /**
 * Print-event filter. Pinned sources (contractId set, no trait) require
@@ -300,12 +300,12 @@ interface TxMeta {
 /** Context passed to subgraph handlers during event processing */
 interface SubgraphContext {
 	block: {
-		height: number
-		hash: string
-		timestamp: number
-		burnBlockHeight: number
+		height: number;
+		hash: string;
+		timestamp: number;
+		burnBlockHeight: number;
 		/** Nakamoto StacksBlockId, when the block row carries one. */
-		indexBlockHash?: string | null
+		indexBlockHash?: string | null;
 	};
 	tx: TxMeta;
 	/**
@@ -423,24 +423,24 @@ interface DeployDiff {
 * - Breaking change → auto-reindex (drop + recreate)
 */
 declare function deploySchema(db: AnyDb, def: SubgraphDefinition, handlerPath: string, opts?: {
-	forceReindex?: boolean
-	apiKeyId?: string
-	accountId?: string
-	schemaName?: string
-	handlerCode?: string
-	sourceCode?: string
+	forceReindex?: boolean;
+	apiKeyId?: string;
+	accountId?: string;
+	schemaName?: string;
+	handlerCode?: string;
+	sourceCode?: string;
 	/** Derived level to store (see `deriveVerification`). */
-	verification?: SubgraphVerification
+	verification?: SubgraphVerification;
 	/** Network baked into the pin. Defaults to `NETWORK`, then mainnet. */
-	network?: string
+	network?: string;
 }): Promise<{
-	action: "created" | "unchanged" | "handler_updated" | "updated" | "reindexed"
-	subgraphId: string
-	version: string
+	action: "created" | "unchanged" | "handler_updated" | "updated" | "reindexed";
+	subgraphId: string;
+	version: string;
 	/** Present when the deploy carried a bundled handler. */
-	pin?: string
-	diff?: DeployDiff
+	pin?: string;
+	diff?: DeployDiff;
 	/** Non-fatal caveats the caller should surface (e.g. handler grafts at tip). */
-	warnings?: string[]
+	warnings?: string[];
 }>;
 export { ColumnDiff, GeneratedSQL, TYPE_MAP, TableDiff, deploySchema, diffSchema, generateSubgraphSQL };

package/dist/schema/index.js

@@ -466,7 +466,7 @@ import { createHash as createHash2 } from "node:crypto";
 // package.json
 var package_default = {
   name: "@secondlayer/subgraphs",
-  version: "6.4.0",
+  version: "6.6.0",
   description: "Describe the Stacks data you want as one TypeScript file; it fills itself and survives reorgs.",
   license: "MIT",
   repository: {
@@ -510,6 +510,10 @@ var package_default = {
     "./testing": {
       types: "./dist/testing/index.d.ts",
       import: "./dist/testing/index.js"
+    },
+    "./verify": {
+      types: "./dist/verify/index.d.ts",
+      import: "./dist/verify/index.js"
     }
   },
   files: ["dist"],
@@ -521,14 +525,16 @@ var package_default = {
     prepublishOnly: "bun run build"
   },
   dependencies: {
-    "@secondlayer/shared": "^11.22.0",
-    "@secondlayer/stacks": "^6.1.0",
+    "@secondlayer/shared": "^11.24.0",
+    "@secondlayer/stacks": "^6.2.0",
+    "@secondlayer/verify": "^0.3.0",
     esbuild: "^0.28.2",
     kysely: "0.28.17",
     zod: "^4.3.6"
   },
   devDependencies: {
     "@types/bun": "latest",
+    bunup: "0.16.32",
     typescript: "^5"
   },
   publishConfig: {
@@ -658,7 +664,6 @@ function formatFinding(f) {
 var STATE_SOURCE_TYPES = new Set([
   "var_set",
   "map_set",
-  "map_insert",
   "map_delete"
 ]);
 var LEVEL_RANK = { state: 0, events: 1, none: 2 };
@@ -675,6 +680,9 @@ function deriveVerification(def, findings = []) {
     if (filter.trait) {
       raise("none");
       reasons.push(`source "${name}": trait scope needs a proven contract registry`);
+    } else if (filter.type === "map_insert") {
+      raise("events");
+      reasons.push(`map_insert source "${name}": map_insert vs map_set needs event proofs`);
     } else if (!STATE_SOURCE_TYPES.has(filter.type)) {
       raise("events");
       reasons.push(`${filter.type} source "${name}" needs event proofs`);
@@ -692,14 +700,12 @@ function deriveVerification(def, findings = []) {
   if (findings.length > MAX_LISTED_FINDINGS) {
     reasons.push(`…and ${findings.length - MAX_LISTED_FINDINGS} more handler findings`);
   }
-  const writesMapInsert = Object.values(def.sources ?? {}).some((s) => s.type === "map_insert");
   return {
     level,
     reasons,
     unproven: reasons.length === 0 ? [
       "tx attribution of writes: event.tx, _tx_id (needs event proofs)",
-      "intermediate writes within a block (needs event proofs)",
-      ...writesMapInsert ? ["map_insert vs map_set (needs event proofs)"] : []
+      "intermediate writes within a block (needs event proofs)"
     ] : []
   };
 }
@@ -709,15 +715,18 @@ function isDeterminismViolation(v) {
 function sha256(input) {
   return createHash2("sha256").update(input).digest("hex");
 }
-function computePin(input) {
-  const canonical = JSON.stringify({
+function pinPreimage(input) {
+  const fields = {
     handlerHash: sha256(input.handlerCode),
     network: input.network,
     runtime: input.runtime ?? SUBGRAPHS_RUNTIME,
     schemaHash: input.schemaHash,
     startBlock: input.startBlock ?? null
-  });
-  return sha256(canonical);
+  };
+  return JSON.stringify(fields);
+}
+function computePin(input) {
+  return sha256(pinPreimage(input));
 }
 
 // src/schema/deployer.ts
@@ -817,12 +826,14 @@ function renderDeployPlan(def, schemaName) {
 async function deploySchema(db, def, handlerPath, opts) {
   validateSubgraphDefinition(def);
   const { statements, hash } = generateSubgraphSQL(def, opts?.schemaName);
-  const pin = opts?.handlerCode != null ? computePin({
+  const pinInput = opts?.handlerCode != null ? {
     schemaHash: hash,
     handlerCode: opts.handlerCode,
     startBlock: def.startBlock,
     network: opts.network ?? process.env.NETWORK ?? "mainnet"
-  }) : null;
+  } : null;
+  const pin = pinInput ? computePin(pinInput) : null;
+  const preimage = pinInput ? pinPreimage(pinInput) : null;
   const identity = pin ? { pin } : {};
   const { getSubgraph, registerSubgraph } = await import("@secondlayer/shared/db/queries/subgraphs");
   const ddlDb = db;
@@ -848,6 +859,7 @@ async function deploySchema(db, def, handlerPath, opts) {
     schemaName,
     startBlock: def.startBlock,
     pin,
+    pinPreimage: preimage,
     verification: opts?.verification ?? null
   };
   if (existing) {
@@ -876,6 +888,7 @@ async function deploySchema(db, def, handlerPath, opts) {
         handlerCode: opts?.handlerCode,
         sourceCode: opts?.sourceCode,
         pin,
+        pinPreimage: preimage,
         verification: opts?.verification ?? null
       });
       return {
@@ -1078,5 +1091,5 @@ export {
   generateSubgraphSQL
 };
 
-//# debugId=437B69A70A1DC76C64756E2164756E21
+//# debugId=6A7DA7E9E6C054A564756E2164756E21
 //# sourceMappingURL=index.js.map