@secondlayer/subgraphs 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/src/index.d.ts +219 -0
- package/dist/src/index.js +956 -0
- package/dist/src/index.js.map +22 -0
- package/dist/src/runtime/block-processor.d.ts +100 -0
- package/dist/src/runtime/block-processor.js +501 -0
- package/dist/src/runtime/block-processor.js.map +16 -0
- package/dist/src/runtime/catchup.d.ts +78 -0
- package/dist/src/runtime/catchup.js +630 -0
- package/dist/src/runtime/catchup.js.map +18 -0
- package/dist/src/runtime/clarity.d.ts +15 -0
- package/dist/src/runtime/clarity.js +41 -0
- package/dist/src/runtime/clarity.js.map +10 -0
- package/dist/src/runtime/context.d.ts +69 -0
- package/dist/src/runtime/context.js +177 -0
- package/dist/src/runtime/context.js.map +10 -0
- package/dist/src/runtime/processor.d.ts +8 -0
- package/dist/src/runtime/processor.js +770 -0
- package/dist/src/runtime/processor.js.map +20 -0
- package/dist/src/runtime/reindex.d.ts +84 -0
- package/dist/src/runtime/reindex.js +738 -0
- package/dist/src/runtime/reindex.js.map +19 -0
- package/dist/src/runtime/reorg.d.ts +78 -0
- package/dist/src/runtime/reorg.js +536 -0
- package/dist/src/runtime/reorg.js.map +17 -0
- package/dist/src/runtime/runner.d.ts +147 -0
- package/dist/src/runtime/runner.js +130 -0
- package/dist/src/runtime/runner.js.map +11 -0
- package/dist/src/runtime/source-matcher.d.ts +53 -0
- package/dist/src/runtime/source-matcher.js +111 -0
- package/dist/src/runtime/source-matcher.js.map +11 -0
- package/dist/src/runtime/stats.d.ts +24 -0
- package/dist/src/runtime/stats.js +75 -0
- package/dist/src/runtime/stats.js.map +10 -0
- package/dist/src/schema/index.d.ts +117 -0
- package/dist/src/schema/index.js +305 -0
- package/dist/src/schema/index.js.map +13 -0
- package/dist/src/service.d.ts +0 -0
- package/dist/src/service.js +780 -0
- package/dist/src/service.js.map +21 -0
- package/dist/src/types.d.ts +80 -0
- package/dist/src/types.js +22 -0
- package/dist/src/types.js.map +10 -0
- package/dist/src/validate.d.ts +84 -0
- package/dist/src/validate.js +59 -0
- package/dist/src/validate.js.map +10 -0
- package/package.json +49 -0
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": 3,
|
|
3
|
+
"sources": ["../src/types.ts", "../src/runtime/context.ts", "../src/runtime/source-matcher.ts", "../src/runtime/clarity.ts", "../src/runtime/runner.ts", "../src/runtime/block-processor.ts", "../src/schema/utils.ts", "../src/runtime/stats.ts", "../src/runtime/reindex.ts", "../src/schema/generator.ts"],
|
|
4
|
+
"sourcesContent": [
|
|
5
|
+
"/** Supported column types for subgraph schemas */\nexport type ColumnType =\n | \"text\"\n | \"uint\"\n | \"int\"\n | \"principal\"\n | \"boolean\"\n | \"timestamp\"\n | \"jsonb\";\n\n/** Column definition in a subgraph table */\nexport interface SubgraphColumn {\n type: ColumnType;\n nullable?: boolean;\n indexed?: boolean;\n search?: boolean;\n default?: string | number | boolean;\n}\n\n/** Table definition within a subgraph schema */\nexport interface SubgraphTable {\n columns: Record<string, SubgraphColumn>;\n /** Composite indexes (each entry is an array of column names) */\n indexes?: string[][];\n /** Unique key constraints (each entry is an array of column names). Required for upsert. */\n uniqueKeys?: string[][];\n}\n\n/** Subgraph schema — maps table names to table definitions */\nexport type SubgraphSchema = Record<string, SubgraphTable>;\n\n/** Source filter for what blockchain data this subgraph processes */\nexport interface SubgraphSource {\n /** Contract principal (e.g., SP000...::contract-name). Supports * wildcards. */\n contract?: string;\n /** Event name/topic to filter on */\n event?: string;\n /** Function name to filter on */\n function?: string;\n /** Transaction type filter (e.g., \"stx_transfer\", \"contract_call\") */\n type?: string;\n /** Minimum amount filter (for stx_transfer sources) */\n minAmount?: bigint;\n}\n\n/** Context passed to subgraph handlers during event processing */\nexport interface SubgraphContext {\n block: { height: number; hash: string; timestamp: number; burnBlockHeight: number };\n tx: { txId: string; sender: string; type: string; status: string };\n insert(table: string, row: Record<string, unknown>): void;\n update(table: string, where: Record<string, unknown>, set: Record<string, unknown>): void;\n upsert(table: string, key: Record<string, unknown>, row: Record<string, unknown>): void;\n delete(table: string, where: Record<string, unknown>): void;\n findOne(table: string, where: Record<string, unknown>): Promise<Record<string, unknown> | null>;\n findMany(table: string, where: Record<string, unknown>): Promise<Record<string, unknown>[]>;\n}\n\n/** Handler function that processes events and writes to the subgraph */\nexport type SubgraphHandler = (\n event: Record<string, unknown>,\n ctx: SubgraphContext,\n) => Promise<void> | void;\n\n/**\n * Derive the source key used to look up handlers.\n * - { contract: \"SP123.market\", function: \"list\" } → \"SP123.market::list\"\n * - { contract: \"SP123.market\", event: \"sale\" } → \"SP123.market::sale\"\n * - { contract: \"SP123.market\" } → \"SP123.market\"\n * - { type: \"stx_transfer\" } → \"stx_transfer\"\n */\nexport function sourceKey(source: SubgraphSource): string {\n if (source.contract) {\n if (source.function) return `${source.contract}::${source.function}`;\n if (source.event) return `${source.contract}::${source.event}`;\n return source.contract;\n }\n if (source.type) return source.type;\n return \"*\";\n}\n\n/** Complete subgraph definition */\nexport interface SubgraphDefinition {\n /** Unique subgraph name (lowercase, alphanumeric + hyphens) */\n name: string;\n /** Semantic version */\n version?: string;\n /** Human description */\n description?: string;\n /** What blockchain data to process — one or more source filters */\n sources: SubgraphSource[];\n /** Tables in this subgraph */\n schema: SubgraphSchema;\n /** Keyed handler functions — keys match sourceKey() output, \"*\" is catch-all */\n handlers: Record<string, SubgraphHandler>;\n}\n",
|
|
6
|
+
"import { sql, type Kysely, type Transaction } from \"kysely\";\nimport type { Database } from \"@secondlayer/shared/db\";\nimport { logger } from \"@secondlayer/shared/logger\";\nimport type { SubgraphSchema } from \"../types.ts\";\n\ntype AnyDb = Kysely<Database> | Transaction<Database>;\n\ninterface WriteOp {\n kind: \"insert\" | \"update\" | \"delete\";\n table: string;\n data: Record<string, unknown>;\n /** For update: SET clause */\n set?: Record<string, unknown>;\n}\n\nexport interface BlockMeta {\n height: number;\n hash: string;\n timestamp: number;\n burnBlockHeight: number;\n}\n\nexport interface TxMeta {\n txId: string;\n sender: string;\n type: string;\n status: string;\n}\n\n/** Validate that a column name is safe for SQL identifiers */\nfunction validateColumnName(name: string): void {\n if (!/^[a-z_][a-z0-9_]*$/i.test(name)) {\n throw new Error(`Invalid column name: ${name}`);\n }\n}\n\n/**\n * Runtime context passed to subgraph handlers.\n * Batches writes and flushes them atomically at the end of a block.\n * Reads execute immediately against the DB (pre-flush state).\n */\nexport class SubgraphContext {\n readonly block: BlockMeta;\n private _tx: TxMeta;\n private readonly db: AnyDb;\n private readonly pgSchemaName: string;\n private readonly subgraphSchema: SubgraphSchema;\n private readonly ops: WriteOp[] = [];\n\n constructor(\n db: AnyDb,\n pgSchemaName: string,\n subgraphSchema: SubgraphSchema,\n block: BlockMeta,\n tx: TxMeta,\n ) {\n this.db = db;\n this.pgSchemaName = pgSchemaName;\n this.subgraphSchema = subgraphSchema;\n this.block = block;\n this._tx = tx;\n }\n\n get tx(): TxMeta {\n return this._tx;\n }\n\n /** Update the current transaction context (used by runner between events) */\n setTx(tx: TxMeta): void {\n this._tx = tx;\n }\n\n // --- Write operations (batched) ---\n\n insert(table: string, row: Record<string, unknown>): void {\n this.validateTable(table);\n this.ops.push({ kind: \"insert\", table, data: row });\n }\n\n update(\n table: string,\n where: Record<string, unknown>,\n set: Record<string, unknown>,\n ): void {\n this.validateTable(table);\n this.ops.push({ kind: \"update\", table, data: where, set });\n }\n\n upsert(\n table: string,\n key: Record<string, unknown>,\n row: Record<string, unknown>,\n ): void {\n this.validateTable(table);\n const tableDef = this.subgraphSchema[table]!;\n const keyColumns = Object.keys(key);\n\n // Check if there's a matching uniqueKeys constraint\n const hasUniqueConstraint = tableDef.uniqueKeys?.some(\n (uk) => uk.length === keyColumns.length && uk.every((c) => keyColumns.includes(c)),\n );\n\n if (hasUniqueConstraint) {\n // Use ON CONFLICT for proper upsert\n this.ops.push({ kind: \"insert\", table, data: { ...key, ...row, _upsert_keys: keyColumns } });\n } else {\n // Fallback: log warning, use findOne + conditional insert/update\n logger.warn(\"upsert called without matching uniqueKeys constraint, using fallback\", {\n table,\n keys: keyColumns,\n });\n this.ops.push({ kind: \"insert\", table, data: { ...key, ...row, _upsert_fallback_keys: keyColumns, _upsert_fallback_set: row } });\n }\n }\n\n delete(table: string, where: Record<string, unknown>): void {\n this.validateTable(table);\n this.ops.push({ kind: \"delete\", table, data: where });\n }\n\n // --- Read operations (immediate) ---\n\n async findOne(\n table: string,\n where: Record<string, unknown>,\n ): Promise<Record<string, unknown> | null> {\n this.validateTable(table);\n const qualifiedTable = `\"${this.pgSchemaName}\".\"${table}\"`;\n const { clause } = buildWhereClause(where);\n const query = `SELECT * FROM ${qualifiedTable} WHERE ${clause} LIMIT 1`;\n const { rows } = await sql.raw(query).execute(this.db);\n return (rows as Record<string, unknown>[])[0] ?? null;\n }\n\n async findMany(\n table: string,\n where: Record<string, unknown>,\n ): Promise<Record<string, unknown>[]> {\n this.validateTable(table);\n const qualifiedTable = `\"${this.pgSchemaName}\".\"${table}\"`;\n const { clause } = buildWhereClause(where);\n const query = `SELECT * FROM ${qualifiedTable} WHERE ${clause}`;\n const { rows } = await sql.raw(query).execute(this.db);\n return rows as Record<string, unknown>[];\n }\n\n // --- Flush ---\n\n /** Number of pending write operations */\n get pendingOps(): number {\n return this.ops.length;\n }\n\n /**\n * Execute all batched writes in a single transaction.\n * Auto-populates _block_height, _tx_id, _created_at on inserts.\n */\n async flush(): Promise<number> {\n if (this.ops.length === 0) return 0;\n\n const opsToFlush = [...this.ops];\n this.ops.length = 0;\n\n const statements = this.buildStatements(opsToFlush);\n\n // If db is already a transaction, execute directly\n if (\"isTransaction\" in this.db) {\n for (const stmt of statements) {\n await sql.raw(stmt).execute(this.db);\n }\n } else {\n await (this.db as Kysely<Database>).transaction().execute(async (tx) => {\n for (const stmt of statements) {\n await sql.raw(stmt).execute(tx);\n }\n });\n }\n\n return opsToFlush.length;\n }\n\n /** Build SQL statements from write ops */\n private buildStatements(ops: WriteOp[]): string[] {\n const statements: string[] = [];\n\n for (const op of ops) {\n const qualifiedTable = `\"${this.pgSchemaName}\".\"${op.table}\"`;\n\n switch (op.kind) {\n case \"insert\": {\n const upsertKeys = op.data._upsert_keys as string[] | undefined;\n const fallbackKeys = op.data._upsert_fallback_keys as string[] | undefined;\n const fallbackSet = op.data._upsert_fallback_set as Record<string, unknown> | undefined;\n const data = { ...op.data };\n delete data._upsert_keys;\n delete data._upsert_fallback_keys;\n delete data._upsert_fallback_set;\n\n // Auto-populate meta columns\n data._block_height = this.block.height;\n data._tx_id = this._tx.txId;\n data._created_at = \"NOW()\";\n\n const cols = Object.keys(data);\n cols.forEach(validateColumnName);\n const vals = cols.map((c) =>\n data[c] === \"NOW()\" ? \"NOW()\" : escapeLiteral(data[c]),\n );\n let stmt = `INSERT INTO ${qualifiedTable} (${cols.map((c) => `\"${c}\"`).join(\", \")}) VALUES (${vals.join(\", \")})`;\n\n if (upsertKeys && upsertKeys.length > 0) {\n const updateCols = cols.filter((c) => !upsertKeys.includes(c) && !c.startsWith(\"_\"));\n if (updateCols.length > 0) {\n const setClauses = updateCols.map((c) => `\"${c}\" = EXCLUDED.\"${c}\"`);\n stmt += ` ON CONFLICT (${upsertKeys.map((k) => `\"${k}\"`).join(\", \")}) DO UPDATE SET ${setClauses.join(\", \")}`;\n } else {\n stmt += ` ON CONFLICT (${upsertKeys.map((k) => `\"${k}\"`).join(\", \")}) DO NOTHING`;\n }\n } else if (fallbackKeys && fallbackSet) {\n // Fallback upsert: use ON CONFLICT DO UPDATE but without a declared constraint\n // This will just be a plain INSERT — if it conflicts, PG will raise an error.\n // The caller was already warned. This is the best we can do without a unique constraint.\n }\n\n statements.push(stmt);\n break;\n }\n case \"update\": {\n const setEntries = Object.entries(op.set!);\n setEntries.forEach(([k]) => validateColumnName(k));\n const setClauses = setEntries.map(\n ([k, v]) => `\"${k}\" = ${escapeLiteral(v)}`,\n );\n const { clause } = buildWhereClause(op.data);\n statements.push(\n `UPDATE ${qualifiedTable} SET ${setClauses.join(\", \")} WHERE ${clause}`,\n );\n break;\n }\n case \"delete\": {\n const { clause } = buildWhereClause(op.data);\n statements.push(`DELETE FROM ${qualifiedTable} WHERE ${clause}`);\n break;\n }\n }\n }\n\n return statements;\n }\n\n private validateTable(table: string): void {\n if (!this.subgraphSchema[table]) {\n throw new Error(\n `Table \"${table}\" not found in subgraph schema. Available: [${Object.keys(this.subgraphSchema).join(\", \")}]`,\n );\n }\n }\n}\n\n// --- Helpers ---\n\nfunction escapeLiteral(value: unknown): string {\n if (value === null || value === undefined) return \"NULL\";\n if (typeof value === \"number\" || typeof value === \"bigint\") return String(value);\n if (typeof value === \"boolean\") return value ? \"TRUE\" : \"FALSE\";\n if (typeof value === \"object\") return `'${JSON.stringify(value).replace(/'/g, \"''\")}'::jsonb`;\n // String — escape single quotes\n return `'${String(value).replace(/'/g, \"''\")}'`;\n}\n\nfunction buildWhereClause(where: Record<string, unknown>): {\n clause: string;\n values: unknown[];\n} {\n const entries = Object.entries(where);\n if (entries.length === 0) return { clause: \"TRUE\", values: [] };\n\n entries.forEach(([k]) => validateColumnName(k));\n const parts = entries.map(([k, v]) => `\"${k}\" = ${escapeLiteral(v)}`);\n return { clause: parts.join(\" AND \"), values: [] };\n}\n",
|
|
7
|
+
"import { type SubgraphSource, sourceKey } from \"../types.ts\";\n\nexport interface MatchedTx {\n tx: { tx_id: string; type: string; sender: string; status: string; contract_id?: string | null; function_name?: string | null };\n events: { id: string; tx_id: string; type: string; event_index: number; data: unknown }[];\n /** Which source produced this match — used for handler dispatch */\n sourceKey: string;\n}\n\n/**\n * Check if a string matches a pattern with `*` wildcard support.\n */\nfunction matchPattern(value: string, pattern: string): boolean {\n if (!pattern.includes(\"*\")) return value === pattern;\n const regex = pattern\n .replace(/[.+^${}()|[\\]\\\\]/g, \"\\\\$&\")\n .replace(/\\*/g, \".*\");\n return new RegExp(`^${regex}$`).test(value);\n}\n\ntype TxRecord = { tx_id: string; type: string; sender: string; status: string; contract_id?: string | null; function_name?: string | null };\ntype EventRecord = { id: string; tx_id: string; type: string; event_index: number; data: unknown };\n\n/**\n * Match a single source against transactions and events.\n */\nfunction matchSource(\n source: SubgraphSource,\n transactions: TxRecord[],\n eventsByTx: Map<string, EventRecord[]>,\n): MatchedTx[] {\n const results: MatchedTx[] = [];\n const key = sourceKey(source);\n\n for (const tx of transactions) {\n // Type-based matching (e.g., token_transfer → matches tx.type)\n if (source.type) {\n if (!matchPattern(tx.type, source.type)) continue;\n\n const txEvents = eventsByTx.get(tx.tx_id) ?? [];\n\n // Collect all events for this tx (type-based sources match the whole tx)\n let matchedEvents = txEvents;\n\n // minAmount filter — check events with an amount field\n if (source.minAmount !== undefined) {\n const amountEvents = matchedEvents.filter((e) => {\n const data = e.data as Record<string, unknown> | null;\n const rawAmount = data?.amount as string | number | undefined;\n if (rawAmount === undefined) return false;\n const amount = BigInt(rawAmount);\n return amount >= source.minAmount!;\n });\n if (amountEvents.length === 0) continue;\n matchedEvents = amountEvents;\n }\n\n results.push({ tx, events: matchedEvents, sourceKey: key });\n continue;\n }\n\n // Contract-based matching\n if (source.contract) {\n const txContractMatch = tx.contract_id && matchPattern(tx.contract_id, source.contract);\n\n // Function filter\n if (source.function && tx.function_name) {\n if (!matchPattern(tx.function_name, source.function)) continue;\n } else if (source.function && !tx.function_name) {\n continue;\n }\n\n const txEvents = eventsByTx.get(tx.tx_id) ?? [];\n let matchedEvents = txEvents;\n\n if (!txContractMatch) {\n // Check if any events match the contract\n matchedEvents = txEvents.filter((e) => {\n const data = e.data as Record<string, unknown> | null;\n const contractIdentifier = data?.contract_identifier as string | undefined;\n return contractIdentifier && matchPattern(contractIdentifier, source.contract!);\n });\n if (matchedEvents.length === 0) continue;\n }\n\n // Event type / topic filter\n if (source.event) {\n matchedEvents = matchedEvents.filter((e) => {\n if (matchPattern(e.type, source.event!)) return true;\n const data = e.data as Record<string, unknown> | null;\n const topic = data?.topic as string | undefined;\n return topic ? matchPattern(topic, source.event!) : false;\n });\n }\n\n if (txContractMatch || matchedEvents.length > 0) {\n results.push({ tx, events: matchedEvents, sourceKey: key });\n }\n }\n }\n\n return results;\n}\n\n/**\n * Match all sources against a block's transactions and events.\n * Deduplicates by (txId, sourceKey) — each handler key fires at most once per tx.\n */\nexport function matchSources(\n sources: SubgraphSource[],\n transactions: TxRecord[],\n events: EventRecord[],\n): MatchedTx[] {\n // Index events by txId\n const eventsByTx = new Map<string, EventRecord[]>();\n for (const event of events) {\n const list = eventsByTx.get(event.tx_id) ?? [];\n list.push(event);\n eventsByTx.set(event.tx_id, list);\n }\n\n const seen = new Set<string>();\n const results: MatchedTx[] = [];\n\n for (const source of sources) {\n const matches = matchSource(source, transactions, eventsByTx);\n for (const match of matches) {\n const dedupeKey = `${match.tx.tx_id}:${match.sourceKey}`;\n if (!seen.has(dedupeKey)) {\n seen.add(dedupeKey);\n results.push(match);\n }\n }\n }\n\n return results;\n}\n",
|
|
8
|
+
"import { cvToJSON, deserializeCV } from \"@secondlayer/stacks/clarity\";\n\n/**\n * Decode a hex-encoded Clarity value to a JS object.\n * Returns original value on failure.\n */\nexport function decodeClarityValue(hex: string): unknown {\n try {\n const cleanHex = hex.startsWith(\"0x\") ? hex.slice(2) : hex;\n const cv = deserializeCV(cleanHex);\n return cvToJSON(cv);\n } catch {\n return hex;\n }\n}\n\n/**\n * Recursively decode all hex-encoded Clarity values in an object.\n * Any string starting with \"0x\" and longer than 10 chars is attempted.\n */\nexport function decodeEventData(data: unknown): unknown {\n if (typeof data === \"string\" && data.startsWith(\"0x\") && data.length > 10) {\n return decodeClarityValue(data);\n }\n\n if (Array.isArray(data)) {\n return data.map(decodeEventData);\n }\n\n if (typeof data === \"object\" && data !== null) {\n const decoded: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(data)) {\n decoded[key] = decodeEventData(value);\n }\n return decoded;\n }\n\n return data;\n}\n\n/**\n * Decode function args array (hex-encoded Clarity values).\n */\nexport function decodeFunctionArgs(args: string[]): unknown[] {\n return args.map(decodeClarityValue);\n}\n",
|
|
9
|
+
"import { logger } from \"@secondlayer/shared/logger\";\nimport { getErrorMessage } from \"@secondlayer/shared\";\nimport type { SubgraphDefinition } from \"../types.ts\";\nimport type { SubgraphContext } from \"./context.ts\";\nimport type { MatchedTx } from \"./source-matcher.ts\";\nimport { decodeEventData } from \"./clarity.ts\";\n\n/** Max consecutive handler errors before marking subgraph as error */\nconst DEFAULT_ERROR_THRESHOLD = 50;\n\nexport interface RunResult {\n processed: number;\n errors: number;\n}\n\n/**\n * Resolve the handler for a matched tx.\n * Looks up by sourceKey first, then falls back to \"*\" catch-all.\n */\nfunction resolveHandler(handlers: SubgraphDefinition[\"handlers\"], key: string) {\n return handlers[key] ?? handlers[\"*\"] ?? null;\n}\n\n/**\n * Run a subgraph's keyed handlers against all matched transactions/events.\n *\n * Each MatchedTx carries a sourceKey from the matcher. The runner looks up\n * the corresponding handler in subgraph.handlers, falling back to \"*\".\n *\n * Does NOT flush — caller is responsible for flushing ctx after run.\n */\nexport async function runHandlers(\n subgraph: SubgraphDefinition,\n matched: MatchedTx[],\n ctx: SubgraphContext,\n opts?: { errorThreshold?: number },\n): Promise<RunResult> {\n let processed = 0;\n let errors = 0;\n const threshold = opts?.errorThreshold ?? DEFAULT_ERROR_THRESHOLD;\n\n for (const { tx, events, sourceKey } of matched) {\n const handler = resolveHandler(subgraph.handlers, sourceKey);\n if (!handler) {\n logger.warn(\"No handler found for source key\", { subgraph: subgraph.name, sourceKey, txId: tx.tx_id });\n continue;\n }\n\n ctx.setTx({\n txId: tx.tx_id,\n sender: tx.sender,\n type: tx.type,\n status: tx.status,\n });\n\n // If no events but tx matched, call handler with tx-level data\n if (events.length === 0) {\n try {\n const txPayload: Record<string, unknown> = {\n tx: {\n txId: tx.tx_id,\n sender: tx.sender,\n type: tx.type,\n status: tx.status,\n contractId: tx.contract_id,\n functionName: tx.function_name,\n },\n };\n await handler(txPayload, ctx);\n processed++;\n } catch (err) {\n errors++;\n logger.error(\"Subgraph handler error\", {\n subgraph: subgraph.name,\n sourceKey,\n txId: tx.tx_id,\n error: getErrorMessage(err),\n });\n }\n continue;\n }\n\n for (const event of events) {\n if (errors >= threshold) {\n logger.error(\"Subgraph error threshold reached, skipping remaining events\", {\n subgraph: subgraph.name,\n errors,\n threshold,\n });\n return { processed, errors };\n }\n\n try {\n const decoded = decodeEventData(event.data) as Record<string, unknown>;\n const eventPayload: Record<string, unknown> = {\n ...decoded,\n _eventId: event.id,\n _eventType: event.type,\n _eventIndex: event.event_index,\n tx: {\n txId: tx.tx_id,\n sender: tx.sender,\n type: tx.type,\n status: tx.status,\n contractId: tx.contract_id,\n functionName: tx.function_name,\n },\n };\n\n await handler(eventPayload, ctx);\n processed++;\n } catch (err) {\n errors++;\n logger.error(\"Subgraph handler error\", {\n subgraph: subgraph.name,\n sourceKey,\n txId: tx.tx_id,\n eventId: event.id,\n eventType: event.type,\n error: getErrorMessage(err),\n });\n }\n }\n }\n\n return { processed, errors };\n}\n",
|
|
10
|
+
"import { sql, type Transaction } from \"kysely\";\nimport { getDb, type Database } from \"@secondlayer/shared/db\";\nimport { logger } from \"@secondlayer/shared/logger\";\nimport { updateSubgraphStatus, recordSubgraphProcessed } from \"@secondlayer/shared/db/queries/subgraphs\";\nimport type { SubgraphDefinition } from \"../types.ts\";\nimport { pgSchemaName } from \"../schema/utils.ts\";\nimport { SubgraphContext, type BlockMeta, type TxMeta } from \"./context.ts\";\nimport { matchSources } from \"./source-matcher.ts\";\nimport { runHandlers } from \"./runner.ts\";\n\nexport interface ProcessBlockTiming {\n totalMs: number;\n handlerMs: number;\n flushMs: number;\n}\n\nexport interface ProcessBlockResult {\n blockHeight: number;\n matched: number;\n processed: number;\n errors: number;\n skipped: boolean;\n timing?: ProcessBlockTiming;\n}\n\n/**\n * Process a single block through a single subgraph's pipeline.\n *\n * Flow:\n * 1. Load block + txs + events from DB\n * 2. Run source matcher\n * 3. Run handlers with SubgraphContext\n * 4. Flush context (commit writes atomically)\n * 5. Update subgraph.last_processed_block\n */\nexport interface ProcessBlockOptions {\n /** Skip updating last_processed_block in DB (reindex batches this externally). */\n skipProgressUpdate?: boolean;\n}\n\nexport async function processBlock(\n subgraph: SubgraphDefinition,\n subgraphName: string,\n blockHeight: number,\n opts?: ProcessBlockOptions,\n): Promise<ProcessBlockResult> {\n const db = getDb();\n const blockStart = performance.now();\n const result: ProcessBlockResult = {\n blockHeight,\n matched: 0,\n processed: 0,\n errors: 0,\n skipped: false,\n };\n\n // 1. Load block\n const block = await db\n .selectFrom(\"blocks\")\n .selectAll()\n .where(\"height\", \"=\", blockHeight)\n .executeTakeFirst();\n\n if (!block) {\n logger.warn(\"Block not found for subgraph processing\", { subgraph: subgraphName, blockHeight });\n result.skipped = true;\n return result;\n }\n\n if (!block.canonical) {\n logger.debug(\"Skipping non-canonical block\", { subgraph: subgraphName, blockHeight });\n result.skipped = true;\n return result;\n }\n\n // 2. Load txs + events\n const txs = await db\n .selectFrom(\"transactions\")\n .selectAll()\n .where(\"block_height\", \"=\", blockHeight)\n .execute();\n\n const evts = await db\n .selectFrom(\"events\")\n .selectAll()\n .where(\"block_height\", \"=\", blockHeight)\n .execute();\n\n // 3. Match source\n const matched = matchSources(subgraph.sources, txs, evts);\n result.matched = matched.length;\n\n if (matched.length === 0) {\n if (!opts?.skipProgressUpdate) {\n await updateSubgraphStatus(db, subgraphName, \"active\", blockHeight);\n }\n return result;\n }\n\n // 4. Create context and run handlers\n // Use stored schema_name from DB if available, otherwise compute\n const subgraphRecord = await db\n .selectFrom(\"subgraphs\")\n .select(\"schema_name\")\n .where(\"name\", \"=\", subgraphName)\n .executeTakeFirst();\n const schemaName = subgraphRecord?.schema_name ?? pgSchemaName(subgraphName);\n const blockMeta: BlockMeta = {\n height: block.height,\n hash: block.hash,\n timestamp: block.timestamp,\n burnBlockHeight: block.burn_block_height,\n };\n const initialTx: TxMeta = {\n txId: \"\",\n sender: \"\",\n type: \"\",\n status: \"\",\n };\n\n // Wrap entire block processing in a single transaction\n let handlerMs = 0;\n let flushMs = 0;\n\n await db.transaction().execute(async (tx: Transaction<Database>) => {\n const ctx = new SubgraphContext(tx, schemaName, subgraph.schema, blockMeta, initialTx);\n\n const handlerStart = performance.now();\n const runResult = await runHandlers(subgraph, matched, ctx);\n handlerMs = performance.now() - handlerStart;\n\n result.processed = runResult.processed;\n result.errors = runResult.errors;\n\n // 5. Flush writes\n if (ctx.pendingOps > 0) {\n const flushStart = performance.now();\n await ctx.flush();\n flushMs = performance.now() - flushStart;\n }\n\n // 6. Update progress + health metrics (same transaction)\n if (!opts?.skipProgressUpdate) {\n const status = runResult.errors > 0 && runResult.processed === 0 ? \"error\" : \"active\";\n await updateSubgraphStatus(tx, subgraphName, status, blockHeight);\n }\n\n if (!opts?.skipProgressUpdate && (runResult.processed > 0 || runResult.errors > 0)) {\n const lastError = runResult.errors > 0\n ? `${runResult.errors} error(s) at block ${blockHeight}`\n : undefined;\n await recordSubgraphProcessed(tx, subgraphName, runResult.processed, runResult.errors, lastError);\n }\n });\n\n const totalMs = performance.now() - blockStart;\n result.timing = {\n totalMs: Math.round(totalMs),\n handlerMs: Math.round(handlerMs),\n flushMs: Math.round(flushMs),\n };\n\n // 7. Row count warning — sample every 1000 blocks\n if (blockHeight % 1000 === 0) {\n try {\n const tables = Object.keys(subgraph.schema);\n for (const table of tables) {\n const { rows } = await sql.raw(\n `SELECT COUNT(*) as count FROM \"${schemaName}\".\"${table}\"`,\n ).execute(db);\n const count = Number((rows[0] as Record<string, unknown>).count);\n if (count >= 10_000_000) {\n logger.warn(\"Subgraph table exceeds 10M rows\", { subgraph: subgraphName, table, count });\n }\n }\n } catch {\n // Table may not exist yet\n }\n }\n\n return result;\n}\n",
|
|
11
|
+
"// Re-export canonical pgSchemaName from shared\nexport { pgSchemaName } from \"@secondlayer/shared/db/queries/subgraphs\";\n",
|
|
12
|
+
"import type { Kysely } from \"kysely\";\nimport type { Database } from \"@secondlayer/shared/db\";\nimport type { ProcessBlockTiming } from \"./block-processor.ts\";\n\ninterface StatsEntry {\n subgraphName: string;\n apiKeyId: string | null;\n bucketStart: Date;\n blocksProcessed: number;\n totalTimeMs: number;\n handlerTimeMs: number;\n flushTimeMs: number;\n maxBlockTimeMs: number;\n maxHandlerTimeMs: number;\n totalOps: number;\n isCatchup: boolean;\n}\n\nconst FLUSH_INTERVAL_BLOCKS = 100;\nconst FLUSH_INTERVAL_MS = 60_000;\n\n/**\n * Accumulates per-block timing stats and flushes to DB periodically.\n * One instance per subgraph during catchup/reindex/live processing.\n */\nexport class StatsAccumulator {\n private current: StatsEntry;\n private lastFlush = Date.now();\n\n constructor(\n private subgraphName: string,\n private apiKeyId: string | null,\n private isCatchup: boolean,\n ) {\n this.current = this.newEntry();\n }\n\n record(timing: ProcessBlockTiming, opsCount: number): void {\n this.current.blocksProcessed++;\n this.current.totalTimeMs += timing.totalMs;\n this.current.handlerTimeMs += timing.handlerMs;\n this.current.flushTimeMs += timing.flushMs;\n this.current.maxBlockTimeMs = Math.max(this.current.maxBlockTimeMs, timing.totalMs);\n this.current.maxHandlerTimeMs = Math.max(this.current.maxHandlerTimeMs, timing.handlerMs);\n this.current.totalOps += opsCount;\n }\n\n shouldFlush(): boolean {\n return (\n this.current.blocksProcessed >= FLUSH_INTERVAL_BLOCKS ||\n Date.now() - this.lastFlush >= FLUSH_INTERVAL_MS\n );\n }\n\n async flush(db: Kysely<Database>): Promise<void> {\n if (this.current.blocksProcessed === 0) return;\n\n const entry = this.current;\n this.current = this.newEntry();\n this.lastFlush = Date.now();\n\n const avgOpsPerBlock = entry.blocksProcessed > 0\n ? entry.totalOps / entry.blocksProcessed\n : 0;\n\n await db\n .insertInto(\"subgraph_processing_stats\")\n .values({\n subgraph_name: entry.subgraphName,\n api_key_id: entry.apiKeyId,\n bucket_start: entry.bucketStart,\n bucket_end: new Date(),\n blocks_processed: entry.blocksProcessed,\n total_time_ms: Math.round(entry.totalTimeMs),\n handler_time_ms: Math.round(entry.handlerTimeMs),\n flush_time_ms: Math.round(entry.flushTimeMs),\n max_block_time_ms: Math.round(entry.maxBlockTimeMs),\n max_handler_time_ms: Math.round(entry.maxHandlerTimeMs),\n avg_ops_per_block: parseFloat(avgOpsPerBlock.toFixed(2)),\n is_catchup: entry.isCatchup,\n })\n .execute();\n }\n\n private newEntry(): StatsEntry {\n return {\n subgraphName: this.subgraphName,\n apiKeyId: this.apiKeyId,\n bucketStart: new Date(),\n blocksProcessed: 0,\n totalTimeMs: 0,\n handlerTimeMs: 0,\n flushTimeMs: 0,\n maxBlockTimeMs: 0,\n maxHandlerTimeMs: 0,\n totalOps: 0,\n isCatchup: this.isCatchup,\n };\n }\n}\n",
|
|
13
|
+
"import { getDb, getRawClient } from \"@secondlayer/shared/db\";\nimport { updateSubgraphStatus } from \"@secondlayer/shared/db/queries/subgraphs\";\nimport { logger } from \"@secondlayer/shared/logger\";\nimport { getErrorMessage } from \"@secondlayer/shared\";\nimport { generateSubgraphSQL } from \"../schema/generator.ts\";\nimport { pgSchemaName } from \"../schema/utils.ts\";\nimport type { SubgraphDefinition } from \"../types.ts\";\nimport { processBlock } from \"./block-processor.ts\";\nimport { StatsAccumulator } from \"./stats.ts\";\n\nconst LOG_INTERVAL = 1000;\n\nexport interface ReindexOptions {\n fromBlock?: number;\n toBlock?: number;\n schemaName?: string;\n}\n\n/**\n * Reindex a subgraph by dropping its tables, recreating them, and reprocessing\n * all historical blocks through the handler pipeline.\n */\nexport async function reindexSubgraph(\n def: SubgraphDefinition,\n opts?: ReindexOptions,\n): Promise<{ processed: number }> {\n const db = getDb();\n const client = getRawClient();\n const subgraphName = def.name;\n const schemaName = opts?.schemaName ?? pgSchemaName(subgraphName);\n\n // Set status to reindexing\n await updateSubgraphStatus(db, subgraphName, \"reindexing\");\n\n logger.info(\"Reindex starting\", { subgraph: subgraphName });\n\n try {\n // Drop and recreate schema + tables\n await client.unsafe(`DROP SCHEMA IF EXISTS \"${schemaName}\" CASCADE`);\n\n const { statements } = generateSubgraphSQL(def, schemaName);\n for (const stmt of statements) {\n await client.unsafe(stmt);\n }\n\n logger.info(\"Schema recreated for reindex\", { subgraph: subgraphName });\n\n // Determine block range\n const fromBlock = opts?.fromBlock ?? 1;\n let toBlock: number;\n\n if (opts?.toBlock != null) {\n toBlock = opts.toBlock;\n } else {\n const progress = await db\n .selectFrom(\"index_progress\")\n .selectAll()\n .where(\"network\", \"=\", process.env.NETWORK ?? \"mainnet\")\n .executeTakeFirst();\n toBlock = progress?.last_indexed_block ?? progress?.last_contiguous_block ?? 0;\n }\n\n if (fromBlock > toBlock) {\n logger.info(\"No blocks to reindex\", { subgraph: subgraphName, fromBlock, toBlock });\n await updateSubgraphStatus(db, subgraphName, \"active\", 0);\n return { processed: 0 };\n }\n\n const totalBlocks = toBlock - fromBlock + 1;\n logger.info(\"Reindexing blocks\", { subgraph: subgraphName, fromBlock, toBlock, totalBlocks });\n\n // Look up api_key_id for stats\n const subgraphRow = await db\n .selectFrom(\"subgraphs\")\n .select(\"api_key_id\")\n .where(\"name\", \"=\", subgraphName)\n .executeTakeFirst();\n\n const stats = new StatsAccumulator(subgraphName, subgraphRow?.api_key_id ?? null, false);\n let blocksProcessed = 0;\n let totalEventsProcessed = 0;\n let totalErrors = 0;\n const PROGRESS_INTERVAL = 100; // update DB progress every N blocks\n\n for (let height = fromBlock; height <= toBlock; height++) {\n const result = await processBlock(def, subgraphName, height, { skipProgressUpdate: true });\n blocksProcessed++;\n totalEventsProcessed += result.processed;\n totalErrors += result.errors;\n\n if (result.timing) {\n stats.record(result.timing, result.processed);\n if (stats.shouldFlush()) {\n await stats.flush(db);\n }\n }\n\n // Batch progress updates to avoid NOTIFY storm\n if (blocksProcessed % PROGRESS_INTERVAL === 0) {\n await updateSubgraphStatus(db, subgraphName, \"reindexing\", height);\n }\n\n if (blocksProcessed % LOG_INTERVAL === 0) {\n logger.info(\"Reindex progress\", {\n subgraph: subgraphName,\n processed: blocksProcessed,\n total: totalBlocks,\n currentBlock: height,\n pct: Math.round((blocksProcessed / totalBlocks) * 100),\n });\n }\n }\n\n // Flush remaining stats\n await stats.flush(db);\n\n // Write final health metrics in one update\n const { recordSubgraphProcessed } = await import(\"@secondlayer/shared/db/queries/subgraphs\");\n if (totalEventsProcessed > 0 || totalErrors > 0) {\n await recordSubgraphProcessed(db, subgraphName, totalEventsProcessed, totalErrors,\n totalErrors > 0 ? `${totalErrors} error(s) during reindex` : undefined);\n }\n\n // Done — set back to active\n await updateSubgraphStatus(db, subgraphName, \"active\", toBlock);\n\n logger.info(\"Reindex complete\", { subgraph: subgraphName, blocks: blocksProcessed, events: totalEventsProcessed, errors: totalErrors });\n return { processed: blocksProcessed };\n } catch (err) {\n logger.error(\"Reindex failed\", {\n subgraph: subgraphName,\n error: getErrorMessage(err),\n });\n await updateSubgraphStatus(db, subgraphName, \"error\");\n throw err;\n }\n}\n",
|
|
14
|
+
"import type { ColumnType, SubgraphDefinition } from \"../types.ts\";\nimport { pgSchemaName } from \"./utils.ts\";\n\nexport const TYPE_MAP: Record<ColumnType, string> = {\n text: \"TEXT\",\n uint: \"BIGINT\",\n int: \"INTEGER\",\n principal: \"TEXT\",\n boolean: \"BOOLEAN\",\n timestamp: \"TIMESTAMPTZ\",\n jsonb: \"JSONB\",\n};\n\nexport interface GeneratedSQL {\n statements: string[];\n hash: string;\n}\n\nfunction escapeLiteralDefault(value: unknown): string {\n if (value === null || value === undefined) return \"NULL\";\n if (typeof value === \"number\" || typeof value === \"bigint\") return String(value);\n if (typeof value === \"boolean\") return value ? \"TRUE\" : \"FALSE\";\n return `'${String(value).replace(/'/g, \"''\")}'`;\n}\n\n/**\n * Generates PostgreSQL DDL statements for a subgraph definition.\n * Creates a dedicated schema `subgraph_<name>` with one table per schema entry,\n * each with auto-columns and indexes.\n */\nexport function generateSubgraphSQL(def: SubgraphDefinition, schemaNameOverride?: string): GeneratedSQL {\n const schemaName = schemaNameOverride ?? pgSchemaName(def.name);\n const statements: string[] = [];\n\n // Check if any column uses search (trigram)\n const needsTrgm = Object.values(def.schema).some((table) =>\n Object.values(table.columns).some((col) => col.search),\n );\n\n if (needsTrgm) {\n statements.push(`CREATE EXTENSION IF NOT EXISTS pg_trgm`);\n }\n\n // Schema namespace\n statements.push(`CREATE SCHEMA IF NOT EXISTS ${schemaName}`);\n\n // One table per schema entry\n for (const [tableName, tableDef] of Object.entries(def.schema)) {\n const qualifiedName = `${schemaName}.${tableName}`;\n\n // Auto-columns + user columns\n const columnDefs: string[] = [\n `_id BIGSERIAL PRIMARY KEY`,\n `_block_height BIGINT NOT NULL`,\n `_tx_id TEXT NOT NULL`,\n `_created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()`,\n ];\n\n for (const [colName, col] of Object.entries(tableDef.columns)) {\n const sqlType = TYPE_MAP[col.type];\n const nullable = col.nullable ? \"\" : \" NOT NULL\";\n let colDef = `${colName} ${sqlType}${nullable}`;\n if (col.default !== undefined) {\n colDef += ` DEFAULT ${escapeLiteralDefault(col.default)}`;\n }\n columnDefs.push(colDef);\n }\n\n statements.push(\n `CREATE TABLE IF NOT EXISTS ${qualifiedName} (\\n ${columnDefs.join(\",\\n \")}\\n)`,\n );\n\n // Auto-indexes on meta columns\n statements.push(\n `CREATE INDEX IF NOT EXISTS idx_${schemaName}_${tableName}_block_height ON ${qualifiedName} (_block_height)`,\n );\n statements.push(\n `CREATE INDEX IF NOT EXISTS idx_${schemaName}_${tableName}_tx_id ON ${qualifiedName} (_tx_id)`,\n );\n\n // Single-column indexes\n for (const [colName, col] of Object.entries(tableDef.columns)) {\n if (col.indexed) {\n statements.push(\n `CREATE INDEX IF NOT EXISTS idx_${schemaName}_${tableName}_${colName} ON ${qualifiedName} (${colName})`,\n );\n }\n }\n\n // Trigram GIN indexes for search columns\n for (const [colName, col] of Object.entries(tableDef.columns)) {\n if (col.search) {\n statements.push(\n `CREATE INDEX IF NOT EXISTS idx_${schemaName}_${tableName}_${colName}_trgm ON ${qualifiedName} USING gin (${colName} gin_trgm_ops)`,\n );\n }\n }\n\n // Composite indexes\n if (tableDef.indexes) {\n for (let i = 0; i < tableDef.indexes.length; i++) {\n const cols = tableDef.indexes[i]!;\n const idxName = `idx_${schemaName}_${tableName}_composite_${i}`;\n statements.push(\n `CREATE INDEX IF NOT EXISTS ${idxName} ON ${qualifiedName} (${cols.join(\", \")})`,\n );\n }\n }\n\n // Unique constraints (required for upsert ON CONFLICT)\n if (tableDef.uniqueKeys) {\n for (let i = 0; i < tableDef.uniqueKeys.length; i++) {\n const cols = tableDef.uniqueKeys[i]!;\n const constraintName = `uq_${schemaName}_${tableName}_${cols.join(\"_\")}`;\n statements.push(\n `ALTER TABLE ${qualifiedName} ADD CONSTRAINT ${constraintName} UNIQUE (${cols.join(\", \")})`,\n );\n }\n }\n }\n\n // Hash based on schema structure (excludes handler)\n const hashInput = JSON.stringify({\n name: def.name,\n version: def.version,\n schema: def.schema,\n sources: def.sources,\n }, (_key, value) => typeof value === \"bigint\" ? value.toString() : value);\n const hash = String(Bun.hash(hashInput));\n\n return { statements, hash };\n}\n"
|
|
15
|
+
],
|
|
16
|
+
"mappings": "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",
|
|
17
|
+
"debugId": "1C1BF85F61D4F46664756E2164756E21",
|
|
18
|
+
"names": []
|
|
19
|
+
}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/** Supported column types for subgraph schemas */
|
|
2
|
+
type ColumnType = "text" | "uint" | "int" | "principal" | "boolean" | "timestamp" | "jsonb";
|
|
3
|
+
/** Column definition in a subgraph table */
|
|
4
|
+
interface SubgraphColumn {
|
|
5
|
+
type: ColumnType;
|
|
6
|
+
nullable?: boolean;
|
|
7
|
+
indexed?: boolean;
|
|
8
|
+
search?: boolean;
|
|
9
|
+
default?: string | number | boolean;
|
|
10
|
+
}
|
|
11
|
+
/** Table definition within a subgraph schema */
|
|
12
|
+
interface SubgraphTable {
|
|
13
|
+
columns: Record<string, SubgraphColumn>;
|
|
14
|
+
/** Composite indexes (each entry is an array of column names) */
|
|
15
|
+
indexes?: string[][];
|
|
16
|
+
/** Unique key constraints (each entry is an array of column names). Required for upsert. */
|
|
17
|
+
uniqueKeys?: string[][];
|
|
18
|
+
}
|
|
19
|
+
/** Subgraph schema — maps table names to table definitions */
|
|
20
|
+
type SubgraphSchema = Record<string, SubgraphTable>;
|
|
21
|
+
/** Source filter for what blockchain data this subgraph processes */
|
|
22
|
+
interface SubgraphSource {
|
|
23
|
+
/** Contract principal (e.g., SP000...::contract-name). Supports * wildcards. */
|
|
24
|
+
contract?: string;
|
|
25
|
+
/** Event name/topic to filter on */
|
|
26
|
+
event?: string;
|
|
27
|
+
/** Function name to filter on */
|
|
28
|
+
function?: string;
|
|
29
|
+
/** Transaction type filter (e.g., "stx_transfer", "contract_call") */
|
|
30
|
+
type?: string;
|
|
31
|
+
/** Minimum amount filter (for stx_transfer sources) */
|
|
32
|
+
minAmount?: bigint;
|
|
33
|
+
}
|
|
34
|
+
/** Context passed to subgraph handlers during event processing */
|
|
35
|
+
interface SubgraphContext {
|
|
36
|
+
block: {
|
|
37
|
+
height: number
|
|
38
|
+
hash: string
|
|
39
|
+
timestamp: number
|
|
40
|
+
burnBlockHeight: number
|
|
41
|
+
};
|
|
42
|
+
tx: {
|
|
43
|
+
txId: string
|
|
44
|
+
sender: string
|
|
45
|
+
type: string
|
|
46
|
+
status: string
|
|
47
|
+
};
|
|
48
|
+
insert(table: string, row: Record<string, unknown>): void;
|
|
49
|
+
update(table: string, where: Record<string, unknown>, set: Record<string, unknown>): void;
|
|
50
|
+
upsert(table: string, key: Record<string, unknown>, row: Record<string, unknown>): void;
|
|
51
|
+
delete(table: string, where: Record<string, unknown>): void;
|
|
52
|
+
findOne(table: string, where: Record<string, unknown>): Promise<Record<string, unknown> | null>;
|
|
53
|
+
findMany(table: string, where: Record<string, unknown>): Promise<Record<string, unknown>[]>;
|
|
54
|
+
}
|
|
55
|
+
/** Handler function that processes events and writes to the subgraph */
|
|
56
|
+
type SubgraphHandler = (event: Record<string, unknown>, ctx: SubgraphContext) => Promise<void> | void;
|
|
57
|
+
/** Complete subgraph definition */
|
|
58
|
+
interface SubgraphDefinition {
|
|
59
|
+
/** Unique subgraph name (lowercase, alphanumeric + hyphens) */
|
|
60
|
+
name: string;
|
|
61
|
+
/** Semantic version */
|
|
62
|
+
version?: string;
|
|
63
|
+
/** Human description */
|
|
64
|
+
description?: string;
|
|
65
|
+
/** What blockchain data to process — one or more source filters */
|
|
66
|
+
sources: SubgraphSource[];
|
|
67
|
+
/** Tables in this subgraph */
|
|
68
|
+
schema: SubgraphSchema;
|
|
69
|
+
/** Keyed handler functions — keys match sourceKey() output, "*" is catch-all */
|
|
70
|
+
handlers: Record<string, SubgraphHandler>;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Handle a chain reorg for all active subgraphs.
|
|
74
|
+
* Deletes rows at the reorged block height from all subgraph tables,
|
|
75
|
+
* then reprocesses the new canonical block.
|
|
76
|
+
*/
|
|
77
|
+
declare function handleSubgraphReorg(blockHeight: number, loadSubgraphDef: (handlerPath: string) => Promise<SubgraphDefinition>): Promise<void>;
|
|
78
|
+
export { handleSubgraphReorg };
|