@secondlayer/subgraphs 6.3.2 → 6.3.4

package/dist/index.d.ts

@@ -1197,8 +1197,25 @@ type SparseProbeTarget = {
 *  a contract_call/contract_deploy source matches transactions, which the
 *  event probe can't see. */
 declare function canSparseScan(subgraph: SubgraphDefinition): boolean;
-/** Probe targets for a subgraph's filters: decoded type + contract scope when\\n*  the filter pins one (assetIdentifier "SP….contract::asset" or contractId). */
+/**
+* The (decoded event type, contract scope) pairs a subgraph's filters can
+* match. One function feeds BOTH the sparse probe and the event walks, so a
+* new contract-pinning filter field is added here once.
+*
+* Per event type: if ANY filter for it is unscoped, a single unscoped target
+* covers everything (today's behavior); otherwise one target per distinct
+* pinned contract.
+*/
 declare function sparseProbeTargets(subgraph: SubgraphDefinition): SparseProbeTarget[];
+/**
+* streams-index eligibility: every source must be a known event-type or
+* contract_call/contract_deploy filter (no array-style sources, which leak the
+* unreconstructable `_eventId`). Trait scope IS allowed — trait resolution
+* reads the contract registry on the platform DB (`targetDb`), which the
+* processor always holds, so it's source-independent. Everything else stays on
+* the DB tap.
+*/
+declare function isStreamsIndexEligible(subgraph: SubgraphDefinition): boolean;
 interface ReindexOptions {
 	/**
 	* Floor on the walk's first block — NOT a caller-supplied range. When set
@@ -1212,4 +1229,4 @@ interface ReindexOptions {
 	operationId?: string;
 	signal?: AbortSignal;
 }
-export { AggregateResult, AggregateSpec, AnyEvent, ChainReadCacheMode, ChainReadClient, ChainReadError, ChainReadMethods, ChainReadOptions, ColumnDiff, ColumnToTS, ColumnType, ComparisonFilter, ContractCallEvent, ContractCallFilter, ContractCallPayload, ContractDeployFilter, ContractDeployPayload, DeployDiff, DeployPlan, DrizzleGenOptions, ErasedChainReadClient, EventForFilter, FactoryScope, FindManyOptions, FindManyPage, FtBurnFilter, FtBurnPayload, FtMintFilter, FtMintPayload, FtTransferFilter, FtTransferPayload, GeneratedSQL, IndexCodegenOptions, IndexCodegenTarget, InferColumnType, InferContext, InferSubgraphClient, InferTableRow, InferredPrintField, InferredTopicSchema, KyselyGenOptions, MapDeletePayload, MapWritePayload, NestedContractCallPayload, NftBurnFilter, NftBurnPayload, NftMintFilter, NftMintPayload, NftTransferFilter, NftTransferPayload, PinnedPrintEventFilter, PrintDataOf, PrintEventFilter, PrintEventFor, PrintEventPayload, PrintEventPrints, PrintField, PrintFieldToTS, PrintSample, PrintValidationResult, PrismaGenOptions, ReindexOptions, RowValue, SparseProbeTarget, StxBurnFilter, StxBurnPayload, StxLockFilter, StxLockPayload, StxMintFilter, StxMintPayload, StxTransferFilter, StxTransferPayload, SubgraphColumn, SubgraphContext, SubgraphDefinition, SubgraphFilter, SubgraphHandler, SubgraphSchema, SubgraphTable, SubgraphTableClient, SubgraphTip, SubscribeOptions, SystemRow, TableDiff, TraitPrintEventFilter, TxMeta, TypedHandlers, TypedSubgraphContext, TypedSubgraphDefinition, UnpinnedPrintEventFilter, VarSetPayload, WhereInput, WriteRow, camelizeKeys, canSparseScan, defineSchema, defineSubgraph, deploySchema, diffSchema, filterFieldsByType, generateDrizzleSchema, generateIndexSchema, generateKyselySchema, generatePrismaSchema, generateSubgraphSQL, hasBreakingChanges, inferPrintTopics, pgSchemaName, readContractAt, renderDeployPlan, sparseProbeTargets, validateSubgraphDefinition };
+export { AggregateResult, AggregateSpec, AnyEvent, ChainReadCacheMode, ChainReadClient, ChainReadError, ChainReadMethods, ChainReadOptions, ColumnDiff, ColumnToTS, ColumnType, ComparisonFilter, ContractCallEvent, ContractCallFilter, ContractCallPayload, ContractDeployFilter, ContractDeployPayload, DeployDiff, DeployPlan, DrizzleGenOptions, ErasedChainReadClient, EventForFilter, FactoryScope, FindManyOptions, FindManyPage, FtBurnFilter, FtBurnPayload, FtMintFilter, FtMintPayload, FtTransferFilter, FtTransferPayload, GeneratedSQL, IndexCodegenOptions, IndexCodegenTarget, InferColumnType, InferContext, InferSubgraphClient, InferTableRow, InferredPrintField, InferredTopicSchema, KyselyGenOptions, MapDeletePayload, MapWritePayload, NestedContractCallPayload, NftBurnFilter, NftBurnPayload, NftMintFilter, NftMintPayload, NftTransferFilter, NftTransferPayload, PinnedPrintEventFilter, PrintDataOf, PrintEventFilter, PrintEventFor, PrintEventPayload, PrintEventPrints, PrintField, PrintFieldToTS, PrintSample, PrintValidationResult, PrismaGenOptions, ReindexOptions, RowValue, SparseProbeTarget, StxBurnFilter, StxBurnPayload, StxLockFilter, StxLockPayload, StxMintFilter, StxMintPayload, StxTransferFilter, StxTransferPayload, SubgraphColumn, SubgraphContext, SubgraphDefinition, SubgraphFilter, SubgraphHandler, SubgraphSchema, SubgraphTable, SubgraphTableClient, SubgraphTip, SubscribeOptions, SystemRow, TableDiff, TraitPrintEventFilter, TxMeta, TypedHandlers, TypedSubgraphContext, TypedSubgraphDefinition, UnpinnedPrintEventFilter, VarSetPayload, WhereInput, WriteRow, camelizeKeys, canSparseScan, defineSchema, defineSubgraph, deploySchema, diffSchema, filterFieldsByType, generateDrizzleSchema, generateIndexSchema, generateKyselySchema, generatePrismaSchema, generateSubgraphSQL, hasBreakingChanges, inferPrintTopics, isStreamsIndexEligible, pgSchemaName, readContractAt, renderDeployPlan, sparseProbeTargets, validateSubgraphDefinition };

package/dist/index.js

@@ -1979,18 +1979,44 @@ function canSparseScan(subgraph) {
     return false;
   return filters.every((f) => Boolean(EVENT_FILTER_TO_INDEX_TYPE[f.type]));
 }
+var MAX_PINNED_CONTRACTS = 20;
+function pinnedContracts(filter) {
+  const f = filter;
+  if (f.trait || f.factory)
+    return null;
+  const ids = Array.isArray(f.contractId) ? [...f.contractId] : f.contractId ? [f.contractId] : f.assetIdentifier ? [f.assetIdentifier.split("::")[0]] : [];
+  if (ids.length === 0 || ids.length > MAX_PINNED_CONTRACTS)
+    return null;
+  if (ids.some((id) => !id || id.includes("*")))
+    return null;
+  return ids;
+}
 function sparseProbeTargets(subgraph) {
-  const targets = new Map;
+  const byType = new Map;
   for (const f of sourceFilters(subgraph)) {
     const eventType = EVENT_FILTER_TO_INDEX_TYPE[f.type];
     if (!eventType)
       continue;
-    const scoped = f;
-    const contractId = scoped.contractId ?? scoped.assetIdentifier?.split("::")[0];
-    const key = `${eventType}|${contractId ?? ""}`;
-    targets.set(key, { eventType, ...contractId ? { contractId } : {} });
+    const pinned = pinnedContracts(f);
+    const prev = byType.get(eventType);
+    if (!pinned || prev === "all") {
+      byType.set(eventType, "all");
+      continue;
+    }
+    const set = prev ?? new Set;
+    for (const id of pinned)
+      set.add(id);
+    byType.set(eventType, set);
+  }
+  const targets = [];
+  for (const [eventType, scope] of byType) {
+    if (scope === "all")
+      targets.push({ eventType });
+    else
+      for (const contractId of scope)
+        targets.push({ eventType, contractId });
   }
-  return [...targets.values()];
+  return targets;
 }
 
 class PostgresBlockSource {
@@ -2056,6 +2082,30 @@ function indexEventTypesForFilterTypes(filterTypes) {
   }
   return [...types];
 }
+function isStreamsIndexEligible(subgraph) {
+  if (Array.isArray(subgraph.sources))
+    return false;
+  const filters = sourceFilters(subgraph);
+  if (filters.length === 0)
+    return false;
+  for (const f of filters) {
+    const known = EVENT_FILTER_TO_INDEX_TYPE[f.type] || TX_SOURCE_TYPES.has(f.type);
+    if (!known)
+      return false;
+  }
+  return true;
+}
+function dedupeEvents(rows) {
+  const seen = new Set;
+  return rows.filter((e) => {
+    const key = `${e.event_type}|${e.block_height}|${e.event_index}`;
+    if (seen.has(key))
+      return false;
+    seen.add(key);
+    return true;
+  });
+}
+
 class PublicApiBlockSource {
   http;
   eventTypes;
@@ -2067,6 +2117,13 @@ class PublicApiBlockSource {
     this.probeTargets = probeTargets;
     this.needsTransactions = needsTransactions;
   }
+  walkTargets() {
+    const scoped = this.needsTransactions ? undefined : this.probeTargets;
+    return this.eventTypes.flatMap((eventType) => {
+      const own = scoped?.filter((t) => t.eventType === eventType);
+      return own?.length ? own : [{ eventType }];
+    });
+  }
   async nextDataHeight(afterHeight, untilHeight) {
     if (!this.probeTargets?.length)
       return afterHeight + 1;
@@ -2088,8 +2145,9 @@ class PublicApiBlockSource {
     const [blocks, txRows, eventLists] = await Promise.all([
       this.http.walkBlocks(fromHeight, toHeight),
       this.needsTransactions ? this.http.walkTransactions(fromHeight, toHeight) : Promise.resolve([]),
-      Promise.all(this.eventTypes.map((t) => this.http.walkEvents(t, fromHeight, toHeight, withTx)))
+      Promise.all(this.walkTargets().map((t) => this.http.walkEvents(t.eventType, fromHeight, toHeight, withTx, t.contractId)))
     ]);
+    const events = dedupeEvents(eventLists.flat());
     const map = new Map;
     for (const b of blocks) {
       map.set(b.block_height, {
@@ -2098,21 +2156,19 @@ class PublicApiBlockSource {
         events: []
       });
     }
-    const txs = this.needsTransactions ? txRows.map(reconstructTransaction) : synthesizeTxsFromEvents(eventLists.flat());
+    const txs = this.needsTransactions ? txRows.map(reconstructTransaction) : synthesizeTxsFromEvents(events);
     for (const t of txs) {
       map.get(t.block_height)?.txs.push(t);
     }
-    for (const list of eventLists) {
-      for (const e of list) {
-        const bd = map.get(e.block_height);
-        if (!bd)
-          continue;
-        if (VM_INDEX_EVENT_TYPES.has(e.event_type)) {
-          bd.vmEvents ??= [];
-          bd.vmEvents.push(reconstructEvent(e));
-        } else {
-          bd.events.push(reconstructEvent(e));
-        }
+    for (const e of events) {
+      const bd = map.get(e.block_height);
+      if (!bd)
+        continue;
+      if (VM_INDEX_EVENT_TYPES.has(e.event_type)) {
+        bd.vmEvents ??= [];
+        bd.vmEvents.push(reconstructEvent(e));
+      } else {
+        bd.events.push(reconstructEvent(e));
       }
     }
     for (const bd of map.values()) {
@@ -2143,6 +2199,7 @@ export {
   generateSubgraphSQL,
   hasBreakingChanges,
   inferPrintTopics,
+  isStreamsIndexEligible,
   pgSchemaName,
   readContractAt,
   renderDeployPlan,
@@ -2150,5 +2207,5 @@ export {
   validateSubgraphDefinition
 };
 
-//# debugId=175D87BFA125A4A764756E2164756E21
+//# debugId=9E0F3F4652CCD15164756E2164756E21
 //# sourceMappingURL=index.js.map