@secondlayer/shared 11.21.0 → 11.23.0

package/dist/src/index.d.ts

@@ -18,6 +18,242 @@ type FailureClass = (typeof FAILURE_CLASSES)[number];
 declare const RETRY_STATES: readonly ["open", "retrying", "halted", "resolved"];
 type RetryState = (typeof RETRY_STATES)[number];
 type BootstrapSource = "archive" | "genesis" | "import";
+import { z } from "zod";
+interface DeploySubgraphRequest {
+	name: string;
+	description?: string;
+	sources: Record<string, Record<string, unknown>>;
+	schema: Record<string, unknown>;
+	handlerCode: string;
+	/** Override the definition's startBlock for this deploy only. */
+	startBlock?: number;
+	/** Original TypeScript source, persisted so chat can read/diff/edit later. */
+	sourceCode?: string;
+	/** Validate the definition + print the DDL plan without deploying. */
+	dryRun?: boolean;
+}
+declare const DeploySubgraphRequestSchema: z.ZodType<DeploySubgraphRequest>;
+/**
+* How far a subgraph's rows can be checked without trusting the server,
+* derived from its sources and a scan of its handler. Never configured.
+*
+* - `state`: every input is a named state write, provable from block headers.
+*   Handlers run in the deterministic realm. A deployed `state` subgraph is
+*   verifiable: one with any reason is refused at deploy.
+* - `events`: an input (events, prints, tx results, `ctx.client`) needs
+*   re-execution proofs, which are not served yet.
+* - `none`: a source can never be proven as written (trait scope, tip-first
+*   backfill).
+*/
+interface SubgraphVerification {
+	level: "state" | "events" | "none";
+	/** What stands between the subgraph and checkable rows, e.g.
+	*  `print_event source "swaps" needs event proofs` or
+	*  `subgraph.ts:41:12 Date: wall-clock time differs per run`. */
+	reasons: string[];
+	/** What stays unproven even at this level, e.g. tx attribution of writes. */
+	unproven: string[];
+}
+interface DeploySubgraphResponse {
+	action: "created" | "unchanged" | "handler_updated" | "updated" | "reindexed";
+	subgraphId: string;
+	version: string;
+	message: string;
+	/** Effective indexing start height. */
+	start_block?: number;
+	operationId?: string;
+	reindexStarted?: boolean;
+	/** Bounded candidate-event denominator for the reindex just started, when the
+	*  op was classifiable as sparse/light. Absent for heavy ops (no upfront estimate
+	*  possible) — check `sl subgraphs status` after ~30s for a rate-based ETA instead. */
+	estimatedEvents?: number;
+	/** Non-blocking deploy lints (e.g. handler reads a print field never observed on-chain). */
+	warnings?: string[];
+	/** sha256 identity of what was deployed; absent on unbundled deploys. */
+	pin?: string;
+	verification?: SubgraphVerification;
+	diff?: {
+		addedTables: string[]
+		removedTables: string[]
+		addedColumns: Record<string, string[]>
+		breakingChanges: string[]
+	};
+}
+/** Prefix of the `last_error` a billing-paused subgraph carries, e.g.
+*  `billing_paused: spend_cap_reached`. Stable: the processor writes it and
+*  the watchdog and CLI key off it. */
+declare const BILLING_PAUSED_PREFIX = "billing_paused: ";
+/** The billing code in a subgraph's `last_error`, or `null` when it isn't a
+*  billing pause. */
+declare function billingPausedCode(lastError: string | null | undefined): string | null;
+interface SubgraphSummary {
+	name: string;
+	version: string;
+	status: string;
+	lastProcessedBlock: number;
+	totalProcessed: number;
+	totalRows?: number;
+	totalErrors: number;
+	tables: string[];
+	chainTip: number;
+	sourceChainTip?: number;
+	targetBlock?: number;
+	progress: number;
+	blocksRemaining?: number;
+	syncMode?: "sync" | "reindex";
+	gapCount: number;
+	/** history_filling = expected gaps while a tip-first backfill op runs. */
+	integrity: "complete" | "gaps_detected" | "history_filling";
+	/** Most recent indexing error reason + when it occurred, if any. */
+	lastError?: string | null;
+	lastErrorAt?: string | null;
+	/** Last row mutation timestamp; powers per-card freshness. */
+	updatedAt?: string | null;
+	/** Number of webhooks attached to this subgraph. */
+	webhookCount?: number;
+	createdAt: string;
+}
+interface SubgraphGapRange {
+	start: number;
+	end: number;
+	size: number;
+	reason: string;
+}
+interface SubgraphSyncInfo {
+	status: "synced" | "catching_up" | "reindexing" | "error";
+	mode?: "sync" | "reindex";
+	startBlock: number;
+	lastProcessedBlock: number;
+	/**
+	* Backward-compatible denominator for progress displays. During reindexing,
+	* this is the reindex target block rather than the live source chain tip.
+	*/
+	chainTip: number;
+	sourceChainTip?: number;
+	targetBlock?: number;
+	blocksRemaining: number;
+	processedBlocks?: number;
+	totalBlocks?: number;
+	progress: number;
+	/** Present while the populating operation is queued: approximate claim
+	*  position + honest event denominator + naive start estimate. */
+	queue?: {
+		position: number | null
+		estimatedEvents: number | null
+		estimatedStartSeconds: number | null
+	};
+	/** Event-based progress for sparse syncs (block pct is meaningless when
+	*  most heights are skipped). */
+	estimatedEvents?: number;
+	processedEvents?: number;
+	etaSeconds?: number | null;
+	gaps: {
+		count: number
+		totalMissingBlocks: number
+		ranges: SubgraphGapRange[]
+	};
+	/** history_filling = expected gaps while a tip-first backfill op runs. */
+	integrity: "complete" | "gaps_detected" | "history_filling";
+}
+interface SubgraphDetail {
+	name: string;
+	version: string;
+	schemaHash?: string;
+	/** sha256 over schema, handler bundle, startBlock, network and runtime.
+	*  Null for subgraphs deployed before pins existed. */
+	pin?: string | null;
+	/** Null for subgraphs deployed before levels were derived. */
+	verification?: SubgraphVerification | null;
+	status: string;
+	lastProcessedBlock: number;
+	description?: string;
+	sources?: Record<string, unknown>;
+	definition?: Record<string, unknown>;
+	health: {
+		totalProcessed: number
+		totalErrors: number
+		errorRate: number
+		lastError: string | null
+		lastErrorAt: string | null
+		/** True after the processor matched work but user tables still have 0 rows. */
+		emptyMapping: boolean
+	};
+	sync: SubgraphSyncInfo;
+	tables: Record<string, {
+		endpoint: string
+		columns: Record<string, {
+			type: string
+			nullable?: boolean
+			indexed?: boolean
+			searchable?: boolean
+			default?: string | number | boolean
+		}>
+		rowCount: number
+		example: string
+		indexes?: readonly (readonly string[])[]
+		uniqueKeys?: readonly (readonly string[])[]
+	}>;
+	createdAt: string;
+	updatedAt: string;
+}
+interface SubgraphGapEntry {
+	start: number;
+	end: number;
+	size: number;
+	reason: string;
+	detectedAt: string;
+	resolvedAt: string | null;
+}
+interface SubgraphGapsResponse {
+	data: SubgraphGapEntry[];
+	meta: {
+		total: number
+		totalMissingBlocks: number
+		limit: number
+		offset: number
+	};
+}
+interface ReindexResponse {
+	message: string;
+	fromBlock: number;
+	toBlock: number | string;
+	operationId?: string;
+	status?: "queued" | "running" | "cancel_requested";
+}
+interface SubgraphQueryParams {
+	sort?: string;
+	order?: string;
+	limit?: number;
+	offset?: number;
+	fields?: string;
+	filters?: Record<string, string>;
+}
+/**
+* Request shape for `GET /v1/subgraphs/:subgraphName/:tableName/aggregate`.
+* `filters` reuses the list/count where-surface; the rest name the columns to
+* aggregate. SUM/MIN/MAX columns must be numeric (uint/int, plus `_block_height`).
+*/
+interface SubgraphAggregateParams {
+	filters?: Record<string, string>;
+	count?: boolean;
+	countDistinct?: string[];
+	sum?: string[];
+	min?: string[];
+	max?: string[];
+}
+/**
+* Aggregate response. Keys are present only for requested aggregates.
+* `count`/`countDistinct` are JSON numbers (counts << 2^53); `sum`/`min`/`max`
+* are lossless strings (NUMERIC `::text`). `sum` of an empty set is `"0"`;
+* `min`/`max` are `null` when the filtered set is empty or all-null.
+*/
+interface SubgraphAggregateResponse {
+	count?: number;
+	countDistinct?: Record<string, number>;
+	sum?: Record<string, string>;
+	min?: Record<string, string | null>;
+	max?: Record<string, string | null>;
+}
 interface BlocksTable {
 	height: number;
 	hash: string;
@@ -178,6 +414,14 @@ interface SubgraphsTable {
 	expires_at: Date | null;
 	/** (event type, contract) probe pairs persisted at deploy for weight classification. */
 	sparse_probe_targets: unknown | null;
+	/** sha256 over everything that shapes rows (schema, handler bundle,
+	*  startBlock, network, runtime). NULL for unbundled or older deploys. */
+	pin: string | null;
+	/** The canonical JSON `pin` hashes, so a client can recompute it. NULL
+	*  wherever `pin` is, and for deploys before migration 0158. */
+	pin_preimage: string | null;
+	/** Level derived at deploy. NULL (older deploys) = not verifiable. */
+	verification: SubgraphVerification | null;
 	created_at: Generated<Date>;
 	updated_at: Generated<Date>;
 }
@@ -2449,213 +2693,6 @@ declare class Logger {
 	error(message: string, meta?: Record<string, any>): void;
 }
 declare const logger: Logger;
-import { z as z2 } from "zod";
-interface DeploySubgraphRequest {
-	name: string;
-	description?: string;
-	sources: Record<string, Record<string, unknown>>;
-	schema: Record<string, unknown>;
-	handlerCode: string;
-	/** Override the definition's startBlock for this deploy only. */
-	startBlock?: number;
-	/** Original TypeScript source, persisted so chat can read/diff/edit later. */
-	sourceCode?: string;
-	/** Validate the definition + print the DDL plan without deploying. */
-	dryRun?: boolean;
-}
-declare const DeploySubgraphRequestSchema: z2.ZodType<DeploySubgraphRequest>;
-interface DeploySubgraphResponse {
-	action: "created" | "unchanged" | "handler_updated" | "updated" | "reindexed";
-	subgraphId: string;
-	version: string;
-	message: string;
-	/** Effective indexing start height. */
-	start_block?: number;
-	operationId?: string;
-	reindexStarted?: boolean;
-	/** Bounded candidate-event denominator for the reindex just started, when the
-	*  op was classifiable as sparse/light. Absent for heavy ops (no upfront estimate
-	*  possible) — check `sl subgraphs status` after ~30s for a rate-based ETA instead. */
-	estimatedEvents?: number;
-	/** Non-blocking deploy lints (e.g. handler reads a print field never observed on-chain). */
-	warnings?: string[];
-	diff?: {
-		addedTables: string[]
-		removedTables: string[]
-		addedColumns: Record<string, string[]>
-		breakingChanges: string[]
-	};
-}
-/** Prefix of the `last_error` a billing-paused subgraph carries, e.g.
-*  `billing_paused: spend_cap_reached`. Stable: the processor writes it and
-*  the watchdog and CLI key off it. */
-declare const BILLING_PAUSED_PREFIX = "billing_paused: ";
-/** The billing code in a subgraph's `last_error`, or `null` when it isn't a
-*  billing pause. */
-declare function billingPausedCode(lastError: string | null | undefined): string | null;
-interface SubgraphSummary {
-	name: string;
-	version: string;
-	status: string;
-	lastProcessedBlock: number;
-	totalProcessed: number;
-	totalRows?: number;
-	totalErrors: number;
-	tables: string[];
-	chainTip: number;
-	sourceChainTip?: number;
-	targetBlock?: number;
-	progress: number;
-	blocksRemaining?: number;
-	syncMode?: "sync" | "reindex";
-	gapCount: number;
-	/** history_filling = expected gaps while a tip-first backfill op runs. */
-	integrity: "complete" | "gaps_detected" | "history_filling";
-	/** Most recent indexing error reason + when it occurred, if any. */
-	lastError?: string | null;
-	lastErrorAt?: string | null;
-	/** Last row mutation timestamp; powers per-card freshness. */
-	updatedAt?: string | null;
-	/** Number of webhooks attached to this subgraph. */
-	webhookCount?: number;
-	createdAt: string;
-}
-interface SubgraphGapRange {
-	start: number;
-	end: number;
-	size: number;
-	reason: string;
-}
-interface SubgraphSyncInfo {
-	status: "synced" | "catching_up" | "reindexing" | "error";
-	mode?: "sync" | "reindex";
-	startBlock: number;
-	lastProcessedBlock: number;
-	/**
-	* Backward-compatible denominator for progress displays. During reindexing,
-	* this is the reindex target block rather than the live source chain tip.
-	*/
-	chainTip: number;
-	sourceChainTip?: number;
-	targetBlock?: number;
-	blocksRemaining: number;
-	processedBlocks?: number;
-	totalBlocks?: number;
-	progress: number;
-	/** Present while the populating operation is queued: approximate claim
-	*  position + honest event denominator + naive start estimate. */
-	queue?: {
-		position: number | null
-		estimatedEvents: number | null
-		estimatedStartSeconds: number | null
-	};
-	/** Event-based progress for sparse syncs (block pct is meaningless when
-	*  most heights are skipped). */
-	estimatedEvents?: number;
-	processedEvents?: number;
-	etaSeconds?: number | null;
-	gaps: {
-		count: number
-		totalMissingBlocks: number
-		ranges: SubgraphGapRange[]
-	};
-	/** history_filling = expected gaps while a tip-first backfill op runs. */
-	integrity: "complete" | "gaps_detected" | "history_filling";
-}
-interface SubgraphDetail {
-	name: string;
-	version: string;
-	schemaHash?: string;
-	status: string;
-	lastProcessedBlock: number;
-	description?: string;
-	sources?: Record<string, unknown>;
-	definition?: Record<string, unknown>;
-	health: {
-		totalProcessed: number
-		totalErrors: number
-		errorRate: number
-		lastError: string | null
-		lastErrorAt: string | null
-		/** True after the processor matched work but user tables still have 0 rows. */
-		emptyMapping: boolean
-	};
-	sync: SubgraphSyncInfo;
-	tables: Record<string, {
-		endpoint: string
-		columns: Record<string, {
-			type: string
-			nullable?: boolean
-			indexed?: boolean
-			searchable?: boolean
-			default?: string | number | boolean
-		}>
-		rowCount: number
-		example: string
-		indexes?: readonly (readonly string[])[]
-		uniqueKeys?: readonly (readonly string[])[]
-	}>;
-	createdAt: string;
-	updatedAt: string;
-}
-interface SubgraphGapEntry {
-	start: number;
-	end: number;
-	size: number;
-	reason: string;
-	detectedAt: string;
-	resolvedAt: string | null;
-}
-interface SubgraphGapsResponse {
-	data: SubgraphGapEntry[];
-	meta: {
-		total: number
-		totalMissingBlocks: number
-		limit: number
-		offset: number
-	};
-}
-interface ReindexResponse {
-	message: string;
-	fromBlock: number;
-	toBlock: number | string;
-	operationId?: string;
-	status?: "queued" | "running" | "cancel_requested";
-}
-interface SubgraphQueryParams {
-	sort?: string;
-	order?: string;
-	limit?: number;
-	offset?: number;
-	fields?: string;
-	filters?: Record<string, string>;
-}
-/**
-* Request shape for `GET /v1/subgraphs/:subgraphName/:tableName/aggregate`.
-* `filters` reuses the list/count where-surface; the rest name the columns to
-* aggregate. SUM/MIN/MAX columns must be numeric (uint/int, plus `_block_height`).
-*/
-interface SubgraphAggregateParams {
-	filters?: Record<string, string>;
-	count?: boolean;
-	countDistinct?: string[];
-	sum?: string[];
-	min?: string[];
-	max?: string[];
-}
-/**
-* Aggregate response. Keys are present only for requested aggregates.
-* `count`/`countDistinct` are JSON numbers (counts << 2^53); `sum`/`min`/`max`
-* are lossless strings (NUMERIC `::text`). `sum` of an empty set is `"0"`;
-* `min`/`max` are `null` when the filtered set is empty or all-null.
-*/
-interface SubgraphAggregateResponse {
-	count?: number;
-	countDistinct?: Record<string, number>;
-	sum?: Record<string, string>;
-	min?: Record<string, string | null>;
-	max?: Record<string, string | null>;
-}
 import { z as z3 } from "zod";
 declare const WEBHOOK_FORMATS: readonly ["standard-webhooks", "inngest", "trigger", "cloudflare", "cloudevents", "raw"];
 declare const WEBHOOK_RUNTIMES: readonly ["inngest", "trigger", "cloudflare", "node"];
@@ -2990,6 +3027,7 @@ interface SubgraphAgentSchema {
 	version: string;
 	description?: string;
 	schemaHash?: string;
+	pin?: string;
 	generatedAt: string;
 	serverUrl: string;
 	sources?: Record<string, unknown>;
@@ -3406,4 +3444,4 @@ declare function publicKeyPemFromPrivate(privateKeyPem: string): string;
 declare function ed25519KeyId(publicKeyPem: string): string;
 declare function signEd25519(payload: string, privateKey: KeyObject): string;
 declare function verifyEd25519(payload: string, signatureBase64: string, publicKey: KeyObject): boolean;
-export { Account, AccountBalanceAlerts, AccountBalanceAlertsTable, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiFailedRequest, ApiFailedRequestsTable, ApiKey, ApiKeysTable, ArchiveFetch, ArchiveFetchesTable, AuthenticationError, AuthorizationError, BILLING_PAUSED_PREFIX, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, CHAIN_TRIGGER_FIELDS, CHAIN_TRIGGER_TYPES, CODE_TO_STATUS, ChainApplyDeliveryOf, ChainApplyEnvelope, ChainApplyEnvelopeOf, ChainEventEnvelope, ChainFtBurnData, ChainFtMintData, ChainFtTransferData, ChainNftBurnData, ChainNftMintData, ChainNftTransferData, ChainPrintEventData, ChainReadCacheTable, ChainReorgOrphanedEntry, ChainReorgRollbackDelivery, ChainReorgRollbackEnvelope, ChainReorgsTable, ChainStxBurnData, ChainStxLockData, ChainStxMintData, ChainStxTransferData, ChainTestDelivery, ChainTxLevelEvent, ChainWebhookDelivery, ChainWebhookEnvelope, Contract, ContractsTable, CoverageSegmentsTable, CreateWebhookRequest, CreateWebhookRequestSchema, CreateWebhookResponse, DB_TO_STREAMS_EVENT_TYPE, DECODED_EVENT_TYPES2 as DECODED_EVENT_TYPES, DEFAULT_BTC_CONFIRMATIONS, Database, DatabaseError, DbPlane, DbReadRow, DbSplitStatus, DeadLetterEventsTable, DeadRow, DecodedEventType2 as DecodedEventType, DecodedEventsTable, DecoderCheckpointsTable, DeliveryRow, DeploySubgraphRequest, DeploySubgraphRequestSchema, DeploySubgraphResponse, EMPTY_RANGE_EVENT_INDEX_SENTINEL, Env, ErrorCode, ErrorCodes, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, FeedbackTicket, FeedbackTicketsTable, ForbiddenError, IndexColumn, IndexColumnType, IndexPrimaryKey, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountBalanceAlerts, InsertAccountCredits, InsertAccountSpendCap, InsertApiFailedRequest, InsertApiKey, InsertArchiveFetch, InsertBlock, InsertContract, InsertEvent, InsertFeedbackTicket, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertStateWrite, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, InstancesTable, KeyRotatedError, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, MigrationRole, NativeClock, NotFoundError, NumericAsText, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, ParsedCreateWebhookRequest, ParsedReplayWebhookRequest, ParsedUpdateWebhookRequest, PaymentRequiredError, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5CycleSignersTable, Pox5CyclesTable, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RUNE_EVENT_TYPES, RateLimitError, ReindexResponse, RepairMode, ReplayResult, ReplayWebhookRequest, ReplayWebhookRequestSchema, RetryState, RotateSecretResponse, RunStatus, RuneApplyDeliveryOf, RuneApplyEnvelope, RuneEventType, SOURCE_READ_COLUMNS, SOURCE_READ_PKS, SOURCE_READ_TYPES, STREAMS_DB_EVENT_TYPES, STREAMS_EVENT_TYPES, STREAMS_TO_DB_EVENT_TYPES, SbtcDepositEvent, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, SbtcWithdrawalEvent, SbtcWithdrawalSweptConfirmedEvent, SecondLayerError, SentinelAccount, SentinelAccountsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, StateWrite, StateWritesArchiveTable, StateWritesTable, StreamsCursor, StreamsDbEventType, StreamsEventType, Subgraph, SubgraphAgentSchema, SubgraphAggregateParams, SubgraphAggregateResponse, SubgraphDetail, SubgraphGap, SubgraphGapEntry, SubgraphGapRange, SubgraphGapsResponse, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphQueryParams, SubgraphSpecFormat, SubgraphSpecOptions, SubgraphSummary, SubgraphSyncInfo, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, TABLE_TO_DB, TenantSuspendedError, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountBalanceAlerts, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UpdateWebhookRequest, UpdateWebhookRequestSchema, UsageLedgerRow, UsageLedgerTable, VM_EVENT_TYPES, VM_NODE_TO_STORED_TYPE2 as VM_NODE_TO_STORED_TYPE, VM_STORED_TO_NODE_TYPE, ValidationError, VersionConflictError, VmEvent, VmEventType, VmEventsArchiveTable, VmEventsTable, VmNodeEventType, WEBHOOK_FILTER_OPERATORS, WEBHOOK_FORMATS, WEBHOOK_RUNTIMES, WEBHOOK_STATUSES, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookDetail, WebhookFilter, WebhookFilterClause, WebhookFilterClauseSchema, WebhookFilterOperator, WebhookFilterOperatorSchema, WebhookFilterPrimitive, WebhookFilterPrimitiveSchema, WebhookFilterSchema, WebhookFormat, WebhookFormatSchema, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookRuntime, WebhookRuntimeSchema, WebhookSchemaColumn, WebhookSchemaTable, WebhookSchemaTables, WebhookStatus, WebhookStatusSchema, WebhookSummary, WebhooksTable, applicationDatabaseUrl, assertDbSplit, billingPausedCode, blockEndCursor, closeDb, closeDbOrTimeout, committedHeight, compareStreamsCursor, exports_hmac as crypto, decodeStreamsCursor, describeDbUrl, exports_ed25519 as ed25519, encodeStreamsCursor, finalizedBurnHeight, formatWebhookSchemaErrors, generateSubgraphAgentSchema, generateSubgraphMarkdown, generateSubgraphOpenApi, generateSubgraphSpec, getDb, getDbSplitStatus, getEnv, getErrorMessage, getMigrationRole, getRawClient, getRawClientFor, getSourceDb, getTargetDb, isBnsDecoderEnabled, isEmptyRangeCursor, isPox4DecoderEnabled, isPox5DecoderEnabled, isSbtcDecoderEnabled, jsonb, logger, onChainPlane, onControlPlane, parseJsonb, resolveSourceUrl, resolveTargetUrl, setMigrationRole, sql, validateWebhookFilterForTable };
+export { Account, AccountBalanceAlerts, AccountBalanceAlertsTable, AccountCredits, AccountCreditsTable, AccountSpendCap, AccountSpendCapsTable, AccountsTable, ApiFailedRequest, ApiFailedRequestsTable, ApiKey, ApiKeysTable, ArchiveFetch, ArchiveFetchesTable, AuthenticationError, AuthorizationError, BILLING_PAUSED_PREFIX, Block, BlocksTable, BnsMarketplaceAction, BnsMarketplaceEventsTable, BnsNameEventTopic, BnsNameEventsTable, BnsNamesTable, BnsNamespaceEventStatus, BnsNamespaceEventsTable, BnsNamespacesTable, BurnBlockRewardSlotsTable, BurnBlockRewardsTable, CHAIN_TRIGGER_FIELDS, CHAIN_TRIGGER_TYPES, CODE_TO_STATUS, ChainApplyDeliveryOf, ChainApplyEnvelope, ChainApplyEnvelopeOf, ChainEventEnvelope, ChainFtBurnData, ChainFtMintData, ChainFtTransferData, ChainNftBurnData, ChainNftMintData, ChainNftTransferData, ChainPrintEventData, ChainReadCacheTable, ChainReorgOrphanedEntry, ChainReorgRollbackDelivery, ChainReorgRollbackEnvelope, ChainReorgsTable, ChainStxBurnData, ChainStxLockData, ChainStxMintData, ChainStxTransferData, ChainTestDelivery, ChainTxLevelEvent, ChainWebhookDelivery, ChainWebhookEnvelope, Contract, ContractsTable, CoverageSegmentsTable, CreateWebhookRequest, CreateWebhookRequestSchema, CreateWebhookResponse, DB_TO_STREAMS_EVENT_TYPE, DECODED_EVENT_TYPES2 as DECODED_EVENT_TYPES, DEFAULT_BTC_CONFIRMATIONS, Database, DatabaseError, DbPlane, DbReadRow, DbSplitStatus, DeadLetterEventsTable, DeadRow, DecodedEventType2 as DecodedEventType, DecodedEventsTable, DecoderCheckpointsTable, DeliveryRow, DeploySubgraphRequest, DeploySubgraphRequestSchema, DeploySubgraphResponse, EMPTY_RANGE_EVENT_INDEX_SENTINEL, Env, ErrorCode, ErrorCodes, Event, EventsArchiveTable, EventsTable, FailureClass, FailureUnit, FeedbackTicket, FeedbackTicketsTable, ForbiddenError, IndexColumn, IndexColumnType, IndexPrimaryKey, IndexProgress, IndexProgressTable, InsertAccount, InsertAccountBalanceAlerts, InsertAccountCredits, InsertAccountSpendCap, InsertApiFailedRequest, InsertApiKey, InsertArchiveFetch, InsertBlock, InsertContract, InsertEvent, InsertFeedbackTicket, InsertIndexProgress, InsertMagicLink, InsertMempoolTransaction, InsertSession, InsertStateWrite, InsertSubgraph, InsertSubgraphGap, InsertSubgraphHealthSnapshot, InsertSubgraphOperation, InsertTransaction, InsertUsageLedgerRow, InsertVmEvent, InsertWaitlistSignup, InsertWebhook, InsertWebhookDelivery, InsertWebhookOutbox, InstancesTable, KeyRotatedError, MagicLink, MagicLinksTable, MempoolTransaction, MempoolTransactionsTable, MigrationRole, NativeClock, NotFoundError, NumericAsText, ObserverJournalStatus, ObserverJournalTable, OutboxStatus, ParsedCreateWebhookRequest, ParsedReplayWebhookRequest, ParsedUpdateWebhookRequest, PaymentRequiredError, PendingForkBlocksTable, Pox4CallsTable, Pox4FunctionName, Pox5CycleSignersTable, Pox5CyclesTable, Pox5EventTopic, Pox5EventsTable, ProcessedStripeEventsTable, RUNE_EVENT_TYPES, RateLimitError, ReindexResponse, RepairMode, ReplayResult, ReplayWebhookRequest, ReplayWebhookRequestSchema, RetryState, RotateSecretResponse, RunStatus, RuneApplyDeliveryOf, RuneApplyEnvelope, RuneEventType, SOURCE_READ_COLUMNS, SOURCE_READ_PKS, SOURCE_READ_TYPES, STREAMS_DB_EVENT_TYPES, STREAMS_EVENT_TYPES, STREAMS_TO_DB_EVENT_TYPES, SbtcDepositEvent, SbtcEventTopic, SbtcEventsTable, SbtcSettlementsTable, SbtcTokenEventType, SbtcTokenEventsTable, SbtcWithdrawalEvent, SbtcWithdrawalSweptConfirmedEvent, SecondLayerError, SentinelAccount, SentinelAccountsTable, ServiceHeartbeatsTable, Session, SessionsTable, StageBlockReceiptsTable, StageFailuresTable, StageKind, StageRegistryTable, StageRunsTable, StateWrite, StateWritesArchiveTable, StateWritesTable, StreamsCursor, StreamsDbEventType, StreamsEventType, Subgraph, SubgraphAgentSchema, SubgraphAggregateParams, SubgraphAggregateResponse, SubgraphDetail, SubgraphGap, SubgraphGapEntry, SubgraphGapRange, SubgraphGapsResponse, SubgraphGapsTable, SubgraphHealthSnapshot, SubgraphHealthSnapshotsTable, SubgraphOperation, SubgraphOperationKind, SubgraphOperationStatus, SubgraphOperationsTable, SubgraphProcessingStatsTable, SubgraphQueryParams, SubgraphSpecFormat, SubgraphSpecOptions, SubgraphSummary, SubgraphSyncInfo, SubgraphVerification, SubgraphViolationsTable, SubgraphsTable, SyncScopesTable, TABLE_TO_DB, TenantSuspendedError, Transaction, TransactionsArchiveTable, TransactionsTable, TriggerEvaluatorState, TriggerEvaluatorStateTable, UpdateAccountBalanceAlerts, UpdateAccountCredits, UpdateAccountSpendCap, UpdateApiKey, UpdateArchiveFetch, UpdateBlock, UpdateContract, UpdateEvent, UpdateIndexProgress, UpdateSubgraph, UpdateSubgraphOperation, UpdateTransaction, UpdateUsageLedgerRow, UpdateVmEvent, UpdateWebhook, UpdateWebhookOutbox, UpdateWebhookRequest, UpdateWebhookRequestSchema, UsageLedgerRow, UsageLedgerTable, VM_EVENT_TYPES, VM_NODE_TO_STORED_TYPE2 as VM_NODE_TO_STORED_TYPE, VM_STORED_TO_NODE_TYPE, ValidationError, VersionConflictError, VmEvent, VmEventType, VmEventsArchiveTable, VmEventsTable, VmNodeEventType, WEBHOOK_FILTER_OPERATORS, WEBHOOK_FORMATS, WEBHOOK_RUNTIMES, WEBHOOK_STATUSES, Waitlist, WaitlistSignup, WaitlistSignupsTable, WaitlistsTable, Webhook, WebhookDeliveriesTable, WebhookDelivery, WebhookDetail, WebhookFilter, WebhookFilterClause, WebhookFilterClauseSchema, WebhookFilterOperator, WebhookFilterOperatorSchema, WebhookFilterPrimitive, WebhookFilterPrimitiveSchema, WebhookFilterSchema, WebhookFormat, WebhookFormatSchema, WebhookKind, WebhookOutbox, WebhookOutboxTable, WebhookRuntime, WebhookRuntimeSchema, WebhookSchemaColumn, WebhookSchemaTable, WebhookSchemaTables, WebhookStatus, WebhookStatusSchema, WebhookSummary, WebhooksTable, applicationDatabaseUrl, assertDbSplit, billingPausedCode, blockEndCursor, closeDb, closeDbOrTimeout, committedHeight, compareStreamsCursor, exports_hmac as crypto, decodeStreamsCursor, describeDbUrl, exports_ed25519 as ed25519, encodeStreamsCursor, finalizedBurnHeight, formatWebhookSchemaErrors, generateSubgraphAgentSchema, generateSubgraphMarkdown, generateSubgraphOpenApi, generateSubgraphSpec, getDb, getDbSplitStatus, getEnv, getErrorMessage, getMigrationRole, getRawClient, getRawClientFor, getSourceDb, getTargetDb, isBnsDecoderEnabled, isEmptyRangeCursor, isPox4DecoderEnabled, isPox5DecoderEnabled, isSbtcDecoderEnabled, jsonb, logger, onChainPlane, onControlPlane, parseJsonb, resolveSourceUrl, resolveTargetUrl, setMigrationRole, sql, validateWebhookFilterForTable };

package/dist/src/index.js

@@ -1939,6 +1939,7 @@ function generateSubgraphAgentSchema(detail, options = {}) {
     version: detail.version,
     ...detail.description ? { description: detail.description } : {},
     ...detail.schemaHash ? { schemaHash: detail.schemaHash } : {},
+    ...detail.pin ? { pin: detail.pin } : {},
     generatedAt: generatedAt(options),
     serverUrl,
     ...detail.sources ? { sources: detail.sources } : {},
@@ -2035,6 +2036,7 @@ function generateSubgraphOpenApi(detail, options = {}) {
     "x-secondlayer-subgraph": detail.name,
     "x-secondlayer-version": detail.version,
     "x-secondlayer-schema-hash": detail.schemaHash,
+    ...detail.pin ? { "x-secondlayer-pin": detail.pin } : {},
     "x-secondlayer-generated-at": generatedAt(options),
     "x-secondlayer-sources": detail.sources ?? {},
     "x-secondlayer-tables": Object.keys(detail.tables)
@@ -2047,6 +2049,7 @@ function generateSubgraphMarkdown(detail, options = {}) {
     "",
     `Version: ${detail.version}`,
     detail.schemaHash ? `Schema hash: ${detail.schemaHash}` : undefined,
+    detail.pin ? `Pin: ${detail.pin}` : undefined,
     `Server: ${agent.serverUrl}`,
     "Responses use the `{ rows, next_cursor, tip }` envelope; paginate with `?cursor=<next_cursor>` and `_order=asc|desc` (`_offset` is rejected).",
     "",
@@ -2274,5 +2277,5 @@ export {
   validateWebhookFilterForTable
 };
 
-//# debugId=3D443FA10F99DD7264756E2164756E21
+//# debugId=77D2A28970490BCD64756E2164756E21
 //# sourceMappingURL=index.js.map