@secondlayer/shared 7.11.2 → 9.0.0

package/dist/src/db/queries/sync-scope.d.ts

@@ -0,0 +1,1006 @@
+import { Kysely } from "kysely";
+/**
+* Coverage-kernel constraints. SQL CHECKs in migration 0116 must stay
+* identical — property tests treat this file as the spec.
+*/
+declare const STAGE_KINDS: readonly ["raw", "decode", "subgraph", "queue"];
+type StageKind = (typeof STAGE_KINDS)[number];
+declare const NATIVE_CLOCKS: readonly ["block", "cursor", "queue"];
+type NativeClock = (typeof NATIVE_CLOCKS)[number];
+declare const REPAIR_MODES: readonly ["range_safe", "full_reindex", "archive_replay", "none"];
+type RepairMode = (typeof REPAIR_MODES)[number];
+declare const RUN_STATUSES: readonly ["pending", "running", "complete", "syncing", "lagging", "gap", "stale", "failed", "unverified_import", "unanchored", "source_unavailable", "out_of_scope", "disabled", "halted"];
+type RunStatus = (typeof RUN_STATUSES)[number];
+declare const FAILURE_UNITS: readonly ["block", "range", "cursor", "queue"];
+type FailureUnit = (typeof FAILURE_UNITS)[number];
+declare const FAILURE_CLASSES: readonly ["omission", "version", "digest_mismatch", "crash", "reorg", "source_gap", "handler", "timeout", "unknown"];
+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";
+type SyncScope = {
+	network: string
+	start_height: number
+	target_height: number | null
+	bootstrap: {
+		source: BootstrapSource
+		manifest_digest: string | null
+		genesis_hash: string | null
+	}
+};
+import { ColumnType, Generated } from "kysely";
+interface BlocksTable {
+	height: number;
+	hash: string;
+	parent_hash: string;
+	burn_block_height: number;
+	burn_block_hash: ColumnType<string | null, string | null | undefined, string | null>;
+	/** Nakamoto StacksBlockId. Null on rows ingested before it was persisted. */
+	index_block_hash: ColumnType<string | null, string | null | undefined, string | null>;
+	timestamp: number;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
+interface TransactionsTable {
+	tx_id: string;
+	block_height: number;
+	tx_index: Generated<number>;
+	type: string;
+	sender: string;
+	status: string;
+	contract_id: string | null;
+	function_name: string | null;
+	function_args: Generated<unknown | null>;
+	raw_result: Generated<string | null>;
+	raw_tx: string;
+	created_at: Generated<Date>;
+}
+interface EventsTable {
+	id: Generated<string>;
+	tx_id: string;
+	block_height: number;
+	event_index: number;
+	type: string;
+	data: unknown;
+	created_at: Generated<Date>;
+}
+interface TransactionsArchiveTable {
+	archive_id: Generated<string>;
+	tx_id: string;
+	block_height: number;
+	tx_index: number;
+	type: string;
+	sender: string;
+	status: string;
+	contract_id: string | null;
+	function_name: string | null;
+	function_args: unknown | null;
+	raw_result: string | null;
+	raw_tx: string;
+	created_at: Date;
+	orphaned_block_hash: string | null;
+	archived_at: Generated<Date>;
+}
+interface EventsArchiveTable {
+	archive_id: Generated<string>;
+	id: string;
+	tx_id: string;
+	block_height: number;
+	event_index: number;
+	type: string;
+	data: unknown;
+	created_at: Date;
+	orphaned_block_hash: string | null;
+	archived_at: Generated<Date>;
+}
+interface DeadLetterEventsTable {
+	id: Generated<string>;
+	block_height: number;
+	tx_id: string;
+	event_index: number;
+	event_type: string;
+	data: unknown;
+	reason: string;
+	created_at: Generated<Date>;
+}
+interface MempoolTransactionsTable {
+	seq: Generated<string>;
+	tx_id: string;
+	raw_tx: string;
+	type: string;
+	sender: string;
+	contract_id: string | null;
+	function_name: string | null;
+	function_args: unknown | null;
+	received_at: Generated<Date>;
+}
+interface IndexProgressTable {
+	network: string;
+	last_indexed_block: Generated<number>;
+	last_contiguous_block: Generated<number>;
+	highest_seen_block: Generated<number>;
+	updated_at: Generated<Date>;
+}
+interface SubgraphsTable {
+	id: Generated<string>;
+	name: string;
+	version: Generated<string>;
+	status: Generated<string>;
+	definition: Record<string, unknown>;
+	schema_hash: string;
+	handler_path: string;
+	schema_name: string | null;
+	start_block: Generated<number>;
+	last_processed_block: Generated<number>;
+	reindex_from_block: number | null;
+	reindex_to_block: number | null;
+	last_error: string | null;
+	last_error_at: Date | null;
+	total_processed: Generated<number>;
+	total_errors: Generated<number>;
+	account_id: string;
+	handler_code: string | null;
+	source_code: string | null;
+	project_id: string | null;
+	visibility: Generated<string>;
+	/** Paid (wallet-ghost) deploys expire unless renewed or claimed; NULL = no expiry. */
+	expires_at: Date | null;
+	/** (event type, contract) probe pairs persisted at deploy for weight classification. */
+	sparse_probe_targets: unknown | null;
+	database_url_enc: ColumnType<Buffer | null, Buffer | null | undefined, Buffer | null>;
+	sandbox_workers: Generated<boolean>;
+	created_at: Generated<Date>;
+	updated_at: Generated<Date>;
+}
+interface ContractsTable {
+	contract_id: string;
+	deployer: string;
+	block_height: number;
+	canonical: Generated<boolean>;
+	abi: unknown | null;
+	declared_traits: Generated<string[]>;
+	inferred_standards: Generated<string[]>;
+	abi_status: Generated<string>;
+	abi_fetched_at: Date | null;
+	created_at: Generated<Date>;
+}
+interface SubgraphGapsTable {
+	id: Generated<string>;
+	subgraph_id: string;
+	subgraph_name: string;
+	gap_start: number;
+	gap_end: number;
+	reason: string;
+	detected_at: Generated<Date>;
+	resolved_at: Date | null;
+}
+type SubgraphOperationKind = "reindex" | "backfill";
+type SubgraphOperationStatus = "queued" | "running" | "completed" | "failed" | "cancelled";
+interface SubgraphOperationsTable {
+	id: Generated<string>;
+	subgraph_id: string;
+	subgraph_name: string;
+	account_id: string | null;
+	kind: ColumnType<SubgraphOperationKind, SubgraphOperationKind, SubgraphOperationKind>;
+	status: ColumnType<SubgraphOperationStatus, SubgraphOperationStatus | undefined, SubgraphOperationStatus>;
+	from_block: number | null;
+	to_block: number | null;
+	cancel_requested: Generated<boolean>;
+	locked_by: string | null;
+	locked_until: Date | null;
+	started_at: Date | null;
+	finished_at: Date | null;
+	processed_blocks: number | null;
+	error: string | null;
+	created_at: Generated<Date>;
+	updated_at: Generated<Date>;
+	/** 'light' (contract-scoped sparse) | 'heavy' (broad). Claim budgets heavy. */
+	weight: Generated<string>;
+	/** Candidate-event denominator computed at enqueue (sparse ops only). */
+	estimated_events: string | number | bigint | null;
+	/** Events processed so far — written by the progress flush. */
+	processed_events: string | number | bigint | null;
+	/** Backfill ops' own crash checkpoint — advanced conditionally in-tx with
+	*  each written block; replays skip at/below it. NULL for reindex ops
+	*  (those checkpoint on subgraphs.last_processed_block). */
+	cursor_block: string | number | bigint | null;
+}
+interface ApiKeysTable {
+	id: Generated<string>;
+	key_hash: string;
+	key_prefix: string;
+	name: string | null;
+	status: Generated<string>;
+	rate_limit: Generated<number>;
+	ip_address: string;
+	account_id: string;
+	product: Generated<"account" | "streams" | "index">;
+	tier: "free" | "build" | "scale" | "enterprise" | null;
+	last_used_at: Date | null;
+	revoked_at: Date | null;
+	created_at: Generated<Date>;
+}
+/** Singleton self-host / publisher identity. Network is immutable. */
+interface InstancesTable {
+	id: Generated<string>;
+	network: string;
+	created_at: Generated<Date>;
+}
+interface AccountsTable {
+	id: Generated<string>;
+	/** NULL for unclaimed ghost accounts (anonymous self-serve keys). */
+	email: string | null;
+	/** True for anonymous self-serve accounts until claimed via magic link. */
+	ghost: Generated<boolean>;
+	/** Stacks principal owning a wallet-ghost account (x402-paid deploys). */
+	wallet_principal: string | null;
+	display_name: string | null;
+	bio: string | null;
+	avatar_url: string | null;
+	stripe_customer_id: string | null;
+	/** Opt-out toggle for the subgraph reindex-completion email. Defaults true. */
+	notify_reindex_complete: Generated<boolean>;
+	created_at: Generated<Date>;
+}
+interface SessionsTable {
+	id: Generated<string>;
+	token_hash: string;
+	token_prefix: string;
+	account_id: string;
+	ip_address: string;
+	expires_at: Generated<Date>;
+	revoked_at: Date | null;
+	last_used_at: Date | null;
+	created_at: Generated<Date>;
+}
+interface MagicLinksTable {
+	id: Generated<string>;
+	email: string;
+	token: string;
+	code: string | null;
+	expires_at: Date;
+	used_at: Date | null;
+	failed_attempts: Generated<number>;
+	created_at: Generated<Date>;
+}
+interface SubgraphProcessingStatsTable {
+	id: Generated<string>;
+	subgraph_name: string;
+	api_key_id: string | null;
+	bucket_start: Date | null;
+	bucket_end: Date | null;
+	blocks_processed: number | null;
+	total_time_ms: number | null;
+	handler_time_ms: number | null;
+	flush_time_ms: number | null;
+	max_block_time_ms: number | null;
+	max_handler_time_ms: number | null;
+	avg_ops_per_block: number | null;
+	is_catchup: Generated<boolean>;
+	created_at: Generated<Date>;
+}
+interface SubgraphTableSnapshotsTable {
+	id: Generated<string>;
+	subgraph_name: string;
+	api_key_id: string | null;
+	table_name: string;
+	row_count: number | null;
+	created_at: Generated<Date>;
+}
+interface SubgraphHealthSnapshotsTable {
+	id: Generated<string>;
+	subgraph_id: string;
+	total_processed: number;
+	total_errors: number;
+	last_processed_block: number | null;
+	captured_at: Generated<Date>;
+}
+interface ProcessedStripeEventsTable {
+	event_id: string;
+	event_type: string;
+	processed_at: Generated<Date>;
+}
+interface DecodedEventsTable {
+	cursor: string;
+	block_height: number;
+	tx_id: string;
+	tx_index: number;
+	event_index: number;
+	event_type: string;
+	microblock_hash: string | null;
+	canonical: Generated<boolean>;
+	contract_id: string | null;
+	sender: string | null;
+	recipient: string | null;
+	amount: string | null;
+	asset_identifier: string | null;
+	value: string | null;
+	memo: string | null;
+	/** Decoded payload for event types that don't fit the flat columns
+	*  (e.g. `print`: { topic, value, raw_value }). Null for transfer types. */
+	payload: unknown | null;
+	source_cursor: string;
+	created_at: Generated<Date>;
+}
+interface DecoderCheckpointsTable {
+	decoder_name: string;
+	last_cursor: string | null;
+	updated_at: Generated<Date>;
+}
+interface ChainReorgsTable {
+	id: Generated<string>;
+	detected_at: Generated<Date>;
+	fork_point_height: number;
+	old_index_block_hash: string | null;
+	new_index_block_hash: string | null;
+	orphaned_from_height: number;
+	orphaned_from_event_index: number;
+	orphaned_to_height: number;
+	orphaned_to_event_index: number;
+	new_canonical_height: number;
+	new_canonical_event_index: number;
+	created_at: Generated<Date>;
+}
+type Pox4FunctionName = "stack-stx" | "delegate-stx" | "stack-extend" | "stack-increase" | "revoke-delegate-stx" | "delegate-stack-stx" | "delegate-stack-extend" | "delegate-stack-increase" | "stack-aggregation-commit" | "stack-aggregation-commit-indexed" | "stack-aggregation-increase" | "set-signer-key-authorization";
+interface Pox4CallsTable {
+	cursor: string;
+	block_height: number;
+	block_time: Date;
+	burn_block_height: number;
+	tx_id: string;
+	tx_index: number;
+	function_name: Pox4FunctionName;
+	caller: string;
+	stacker: string | null;
+	delegate_to: string | null;
+	amount_ustx: string | null;
+	lock_period: number | null;
+	pox_addr_version: number | null;
+	pox_addr_hashbytes: string | null;
+	pox_addr_btc: string | null;
+	start_cycle: number | null;
+	end_cycle: number | null;
+	signer_key: string | null;
+	signer_signature: string | null;
+	auth_id: string | null;
+	max_amount: string | null;
+	reward_cycle: number | null;
+	aggregated_amount_ustx: string | null;
+	aggregated_signer_index: number | null;
+	auth_period: number | null;
+	auth_topic: string | null;
+	auth_allowed: boolean | null;
+	result_ok: boolean;
+	result_raw: string;
+	canonical: Generated<boolean>;
+	source_cursor: string;
+	created_at: Generated<Date>;
+}
+interface Pox4CyclesDailyTable {
+	date: string;
+	reward_cycle: number;
+	total_stacked_ustx: Generated<string>;
+	solo_stackers: Generated<number>;
+	delegated_principals: Generated<number>;
+	unique_pools: Generated<number>;
+	unique_signers: Generated<number>;
+	calls_today: Generated<number>;
+	updated_at: Generated<Date>;
+}
+interface Pox4SignersDailyTable {
+	date: string;
+	reward_cycle: number;
+	signer_key: string;
+	weight_ustx: Generated<string>;
+	stacker_count: Generated<number>;
+	aggregation_calls: Generated<number>;
+	updated_at: Generated<Date>;
+}
+type Pox5EventTopic = "set-bond-admin" | "set-pause-admin" | "pause-rewards" | "setup-bond" | "add-to-allowlist" | "register-for-bond" | "update-bond-registration" | "register-signer" | "stake" | "stake-update" | "announce-l1-early-exit" | "unstake-sbtc" | "unstake" | "calculate-rewards" | "bond-distribution" | "claim-rewards" | "claim-staker-rewards-for-signer" | "grant-signer-key" | "revoke-signer-grant";
+interface Pox5EventsTable {
+	cursor: string;
+	block_height: number;
+	block_time: Date;
+	tx_id: string;
+	tx_index: number;
+	event_index: number;
+	topic: Pox5EventTopic;
+	staker: string | null;
+	signer: string | null;
+	signer_manager: string | null;
+	bond_index: number | null;
+	amount_ustx: string | null;
+	amount_sats: string | null;
+	reward_cycle: number | null;
+	first_reward_cycle: number | null;
+	unlock_cycle: number | null;
+	unlock_burn_height: number | null;
+	is_l1_lock: boolean | null;
+	signer_key: string | null;
+	data: unknown;
+	canonical: Generated<boolean>;
+	source_cursor: string;
+	created_at: Generated<Date>;
+}
+interface BurnBlockRewardsTable {
+	cursor: string;
+	burn_block_height: number;
+	burn_block_hash: string;
+	reward_index: number;
+	recipient_btc: string;
+	amount_sats: string;
+	burn_amount: Generated<string>;
+	created_at: Generated<Date>;
+}
+interface BurnBlockRewardSlotsTable {
+	cursor: string;
+	burn_block_height: number;
+	burn_block_hash: string;
+	slot_index: number;
+	holder_btc: string;
+	created_at: Generated<Date>;
+}
+type SbtcEventTopic = "completed-deposit" | "withdrawal-create" | "withdrawal-accept" | "withdrawal-reject" | "key-rotation" | "update-protocol-contract";
+interface SbtcEventsTable {
+	cursor: string;
+	block_height: number;
+	block_time: Date;
+	tx_id: string;
+	tx_index: number;
+	event_index: number;
+	topic: SbtcEventTopic;
+	request_id: number | null;
+	amount: string | null;
+	sender: string | null;
+	recipient_btc_version: number | null;
+	recipient_btc_hashbytes: string | null;
+	bitcoin_txid: string | null;
+	output_index: number | null;
+	sweep_txid: string | null;
+	burn_hash: string | null;
+	burn_height: number | null;
+	signer_bitmap: string | null;
+	max_fee: string | null;
+	fee: string | null;
+	block_height_at_request: number | null;
+	governance_contract_type: number | null;
+	governance_new_contract: string | null;
+	signer_aggregate_pubkey: string | null;
+	signer_threshold: number | null;
+	signer_address: string | null;
+	signer_keys_count: number | null;
+	canonical: Generated<boolean>;
+	source_cursor: string;
+	created_at: Generated<Date>;
+}
+type SbtcTokenEventType = "transfer" | "mint" | "burn";
+interface SbtcTokenEventsTable {
+	cursor: string;
+	block_height: number;
+	block_time: Date;
+	tx_id: string;
+	tx_index: number;
+	event_index: number;
+	event_type: SbtcTokenEventType;
+	sender: string | null;
+	recipient: string | null;
+	amount: string;
+	memo: string | null;
+	canonical: Generated<boolean>;
+	source_cursor: string;
+	created_at: Generated<Date>;
+}
+/**
+* BTC L1 settlement status for sBTC withdrawal sweeps. Filled by the indexer's
+* settlement-confirmer worker, which polls our own bitcoind for confirmations of
+* each `withdrawal-accept`'s `sweep_txid` and surfaces real settlement on the
+* withdrawal lifecycle (the API's `settlement.{btc_confirmations,
+* settlement_confirmed}` placeholder). Keyed on `sweep_txid` (not `request_id`):
+* a request can produce more than one sweep over its life (RBF/rebroadcast), so
+* each broadcast keeps its own confirmation history.
+*/
+interface SbtcSettlementsTable {
+	sweep_txid: string;
+	request_id: number;
+	btc_confirmations: Generated<number>;
+	settlement_confirmed: Generated<boolean>;
+	/** Confirming Bitcoin block — null while the sweep is unconfirmed. */
+	block_hash: string | null;
+	block_height: number | null;
+	first_seen_at: Generated<Date>;
+	last_checked_at: Generated<Date>;
+	/** Set once, when `settlement_confirmed` first flips true. */
+	confirmed_at: Date | null;
+	updated_at: Generated<Date>;
+}
+interface SbtcSupplySnapshotsTable {
+	date: string;
+	total_supply: Generated<string>;
+	mints_today: Generated<string>;
+	burns_today: Generated<string>;
+	deposit_count: Generated<number>;
+	withdrawal_create_count: Generated<number>;
+	withdrawal_accept_count: Generated<number>;
+	withdrawal_reject_count: Generated<number>;
+	updated_at: Generated<Date>;
+}
+type BnsNameEventTopic = "new-name" | "transfer-name" | "renew-name" | "burn-name" | "new-airdrop";
+interface BnsNameEventsTable {
+	cursor: string;
+	block_height: number;
+	block_time: Date;
+	tx_id: string;
+	tx_index: number;
+	event_index: number;
+	topic: BnsNameEventTopic;
+	namespace: string;
+	name: string;
+	fqn: string;
+	owner: string | null;
+	bns_id: string;
+	registered_at: number | null;
+	imported_at: number | null;
+	renewal_height: number | null;
+	stx_burn: string | null;
+	preordered_by: string | null;
+	hashed_salted_fqn_preorder: string | null;
+	canonical: Generated<boolean>;
+	source_cursor: string;
+	created_at: Generated<Date>;
+}
+type BnsNamespaceEventStatus = "launch" | "transfer-manager" | "freeze-manager" | "update-price-manager" | "freeze-price-manager" | "turn-off-manager-transfers";
+interface BnsNamespaceEventsTable {
+	cursor: string;
+	block_height: number;
+	block_time: Date;
+	tx_id: string;
+	tx_index: number;
+	event_index: number;
+	status: BnsNamespaceEventStatus;
+	namespace: string;
+	manager: string | null;
+	manager_frozen: boolean | null;
+	manager_transfers_disabled: boolean | null;
+	price_function: string | null;
+	price_frozen: boolean | null;
+	lifetime: number | null;
+	revealed_at: number | null;
+	launched_at: number | null;
+	canonical: Generated<boolean>;
+	source_cursor: string;
+	created_at: Generated<Date>;
+}
+type BnsMarketplaceAction = "list-in-ustx" | "unlist-in-ustx" | "buy-in-ustx";
+interface BnsMarketplaceEventsTable {
+	cursor: string;
+	block_height: number;
+	block_time: Date;
+	tx_id: string;
+	tx_index: number;
+	event_index: number;
+	action: BnsMarketplaceAction;
+	bns_id: string;
+	price_ustx: string | null;
+	commission: string | null;
+	canonical: Generated<boolean>;
+	source_cursor: string;
+	created_at: Generated<Date>;
+}
+interface BnsNamesTable {
+	fqn: string;
+	namespace: string;
+	name: string;
+	owner: string;
+	bns_id: string;
+	registered_at: number | null;
+	renewal_height: number | null;
+	last_event_cursor: string;
+	last_event_at: Date;
+	updated_at: Generated<Date>;
+}
+interface BnsNamespacesTable {
+	namespace: string;
+	manager: string | null;
+	manager_frozen: Generated<boolean>;
+	price_frozen: Generated<boolean>;
+	lifetime: number | null;
+	launched_at: number | null;
+	last_event_cursor: string;
+	last_event_at: Date;
+	name_count: Generated<number>;
+	updated_at: Generated<Date>;
+}
+/**
+* Memoized `ctx.client.readOnly()` results. Keyed on `index_block_hash` so a
+* reorg-replaced block never inherits the orphaned fork's answer; a NULL
+* `index_block_hash` marks a caller-declared contract-constant value, cached
+* once per contract+args instead of once per block.
+*/
+interface ChainReadCacheTable {
+	id: Generated<number>;
+	contract_id: string;
+	function_name: string;
+	args_hash: string;
+	index_block_hash: string | null;
+	block_height: ColumnType<number | null, number | null | undefined, number | null>;
+	result_hex: string;
+	created_at: Generated<Date>;
+}
+/**
+* A block that arrived for a height we already hold, staged until a later
+* block's `parent_hash` says which of the two the chain kept. See migration
+* 0112 — adopting on first sight picked the losing fork twice.
+*/
+interface PendingForkBlocksTable {
+	height: number;
+	block_hash: string;
+	parent_hash: string;
+	/** The canonical hash we held at this height when the contender arrived. */
+	incumbent_hash: string;
+	/** The raw observer payload, replayed verbatim if this fork wins. */
+	payload: ColumnType<unknown, unknown, unknown>;
+	received_at: Generated<Date>;
+}
+type ObserverJournalStatus = "received" | "processed" | "failed";
+/**
+* Exact observer callback receipt. `raw_body` is immutable evidence; the
+* processing columns are updated only after the current derived-state write
+* succeeds or fails.
+*/
+interface ObserverJournalTable {
+	sequence: Generated<string>;
+	network: string;
+	path: string;
+	source: string | null;
+	received_at: Generated<Date>;
+	raw_body: ColumnType<Buffer, Buffer, Buffer>;
+	raw_body_sha256: string;
+	status: ColumnType<ObserverJournalStatus, ObserverJournalStatus | undefined, ObserverJournalStatus>;
+	semantic_sha256: string | null;
+	block_height: number | null;
+	block_hash: string | null;
+	burn_block_height: number | null;
+	burn_block_hash: string | null;
+	result: unknown | null;
+	error: string | null;
+	processed_at: Date | null;
+}
+/** Declared coverage stage. Identity is the `id` string (`raw`, `decode:stx`, …). */
+interface StageRegistryTable {
+	id: string;
+	kind: StageKind;
+	depends_on: string | null;
+	native_clock: NativeClock;
+	producer_version: string;
+	repair_mode: RepairMode;
+	enabled: Generated<boolean>;
+	created_at: Generated<Date>;
+}
+/** One versioned sweep of a stage. */
+interface StageRunsTable {
+	id: Generated<string>;
+	stage_id: string;
+	code_hash: string;
+	config_hash: string;
+	handler_hash: string | null;
+	target_height: number | null;
+	target_cursor: string | null;
+	status: RunStatus;
+	complete_through: number | null;
+	started_at: Generated<Date>;
+	finished_at: Date | null;
+}
+/** Per-block acknowledgement. Unique on (stage, height, hash). */
+interface StageBlockReceiptsTable {
+	id: Generated<string>;
+	stage_id: string;
+	run_id: string | null;
+	block_height: number;
+	block_hash: string;
+	input_count: number;
+	input_digest: string;
+	effect_digest: string;
+	finalized: Generated<boolean>;
+	compacted_at: Date | null;
+	created_at: Generated<Date>;
+}
+/** Compacted finalized range. Only sealed after receipts in the range finalize. */
+interface CoverageSegmentsTable {
+	id: Generated<string>;
+	stage_id: string;
+	from_height: number;
+	to_height: number;
+	chain_digest: string;
+	input_digest: string;
+	output_digest: string;
+	sealed_at: Generated<Date>;
+}
+/** Exact unit or range that failed, plus retry/retention state. */
+interface StageFailuresTable {
+	id: Generated<string>;
+	stage_id: string;
+	run_id: string | null;
+	unit_kind: FailureUnit;
+	from_height: number | null;
+	to_height: number | null;
+	class: FailureClass;
+	retry_state: RetryState;
+	retry_count: Generated<number>;
+	last_error: string | null;
+	created_at: Generated<Date>;
+	resolved_at: Date | null;
+	retain_until: Generated<Date>;
+}
+/**
+* The instance's declared scope — one row per network. `start_height` is what
+* makes missing history below it deliberate rather than a gap.
+*/
+interface SyncScopesTable {
+	network: string;
+	start_height: number;
+	target_height: number | null;
+	bootstrap_source: BootstrapSource;
+	bootstrap_manifest_digest: string | null;
+	genesis_hash: string | null;
+	created_at: Generated<Date>;
+	updated_at: Generated<Date>;
+}
+interface Database {
+	blocks: BlocksTable;
+	transactions: TransactionsTable;
+	events: EventsTable;
+	transactions_archive: TransactionsArchiveTable;
+	events_archive: EventsArchiveTable;
+	dead_letter_events: DeadLetterEventsTable;
+	mempool_transactions: MempoolTransactionsTable;
+	index_progress: IndexProgressTable;
+	contracts: ContractsTable;
+	subgraphs: SubgraphsTable;
+	api_keys: ApiKeysTable;
+	instances: InstancesTable;
+	accounts: AccountsTable;
+	sessions: SessionsTable;
+	magic_links: MagicLinksTable;
+	subgraph_health_snapshots: SubgraphHealthSnapshotsTable;
+	subgraph_processing_stats: SubgraphProcessingStatsTable;
+	subgraph_table_snapshots: SubgraphTableSnapshotsTable;
+	subgraph_gaps: SubgraphGapsTable;
+	subgraph_operations: SubgraphOperationsTable;
+	processed_stripe_events: ProcessedStripeEventsTable;
+	account_spend_caps: AccountSpendCapsTable;
+	account_credits: AccountCreditsTable;
+	subscriptions: SubscriptionsTable;
+	subscription_outbox: SubscriptionOutboxTable;
+	subscription_deliveries: SubscriptionDeliveriesTable;
+	trigger_evaluator_state: TriggerEvaluatorStateTable;
+	decoded_events: DecodedEventsTable;
+	decoder_checkpoints: DecoderCheckpointsTable;
+	chain_reorgs: ChainReorgsTable;
+	pox4_calls: Pox4CallsTable;
+	pox4_cycles_daily: Pox4CyclesDailyTable;
+	pox4_signers_daily: Pox4SignersDailyTable;
+	pox5_events: Pox5EventsTable;
+	burn_block_rewards: BurnBlockRewardsTable;
+	burn_block_reward_slots: BurnBlockRewardSlotsTable;
+	sbtc_events: SbtcEventsTable;
+	sbtc_token_events: SbtcTokenEventsTable;
+	sbtc_settlements: SbtcSettlementsTable;
+	sbtc_supply_snapshots: SbtcSupplySnapshotsTable;
+	bns_name_events: BnsNameEventsTable;
+	bns_namespace_events: BnsNamespaceEventsTable;
+	bns_marketplace_events: BnsMarketplaceEventsTable;
+	bns_names: BnsNamesTable;
+	bns_namespaces: BnsNamespacesTable;
+	service_heartbeats: ServiceHeartbeatsTable;
+	x402_payments: X402PaymentsTable;
+	x402_balances: X402BalancesTable;
+	chain_read_cache: ChainReadCacheTable;
+	pending_fork_blocks: PendingForkBlocksTable;
+	observer_journal: ObserverJournalTable;
+	sync_scopes: SyncScopesTable;
+	stage_registry: StageRegistryTable;
+	stage_runs: StageRunsTable;
+	stage_block_receipts: StageBlockReceiptsTable;
+	coverage_segments: CoverageSegmentsTable;
+	stage_failures: StageFailuresTable;
+}
+/** Prepaid x402 credit — one running USD-micros balance per payer principal. */
+interface X402BalancesTable {
+	principal: string;
+	balance_usd_micros: Generated<string | number | bigint>;
+	/** Month bucket ("YYYY-MM") the spend counter applies to. */
+	spent_month: string | null;
+	spent_month_usd_micros: Generated<string | number | bigint>;
+	updated_at: Generated<Date>;
+}
+interface ServiceHeartbeatsTable {
+	name: string;
+	updated_at: Generated<Date>;
+}
+/** x402 pay-per-request ledger (control plane). One row per settled payment,
+*  keyed by challenge nonce + settled txid. `state` tracks confirmed-tier
+*  settlement and post-serve reorg reversal. */
+interface X402PaymentsTable {
+	id: Generated<string>;
+	nonce: string;
+	txid: string;
+	asset: string;
+	amount: string;
+	payer: string;
+	surface: string;
+	state: Generated<"pending" | "confirmed" | "reverted">;
+	created_at: Generated<Date>;
+	updated_at: Generated<Date>;
+	/** "payment" = per-call settle; "deposit" = prepaid balance top-up. */
+	kind: Generated<string>;
+	/** Linked claimed account once the paying wallet is attached (continuity). */
+	account_id: string | null;
+	/** USD-micros to credit on confirmation, for deposit rows the reconciler
+	*  settles asynchronously. NULL for per-call settles (credit nothing). */
+	credit_usd_micros: string | null;
+	/** Idempotency key: stamped exactly once when this row's credit is applied.
+	*  NULL means never credited (or not a credit-bearing row). Pre-migration
+	*  non-pending deposit rows are backfilled to a non-null sentinel so the
+	*  reconciler's heal path can never double-credit them. */
+	credited_at: Generated<Date> | null;
+}
+interface AccountSpendCapsTable {
+	account_id: string;
+	monthly_cap_cents: number | null;
+	compute_cap_cents: number | null;
+	storage_cap_cents: number | null;
+	alert_threshold_pct: Generated<number>;
+	alert_sent_at: Date | null;
+	frozen_at: Date | null;
+	updated_at: Generated<Date>;
+}
+/** Prepaid dev credits — card-funded balance per account (peer to x402_balances). */
+interface AccountCreditsTable {
+	account_id: string;
+	balance_usd_micros: Generated<string | number | bigint>;
+	/** Month bucket ("YYYY-MM") the spend counter applies to. */
+	spent_month: string | null;
+	spent_month_usd_micros: Generated<string | number | bigint>;
+	/** Null = auto-refill off. */
+	refill_below_usd_micros: string | number | bigint | null;
+	refill_pack_usd: number | null;
+	refill_last_at: Date | null;
+	updated_at: Generated<Date>;
+}
+type SubscriptionStatus = "active" | "paused" | "error";
+/** Polymorphic subscription mode: `subgraph` reacts to processed table rows;
+*  `chain` reacts to raw chain events matched directly off the Index/Streams
+*  clock (no subgraph). See migration 0088. */
+type SubscriptionKind = "subgraph" | "chain";
+type SubscriptionFormat = "standard-webhooks" | "inngest" | "trigger" | "cloudflare" | "cloudevents" | "raw";
+type SubscriptionRuntime = "inngest" | "trigger" | "cloudflare" | "node";
+interface SubscriptionsTable {
+	id: Generated<string>;
+	account_id: string;
+	project_id: string | null;
+	name: string;
+	status: ColumnType<SubscriptionStatus, SubscriptionStatus | undefined, SubscriptionStatus>;
+	kind: ColumnType<SubscriptionKind, SubscriptionKind | undefined, SubscriptionKind>;
+	/** Null for chain subscriptions (CHECK subscriptions_kind_shape). */
+	subgraph_name: string | null;
+	/** Null for chain subscriptions (CHECK subscriptions_kind_shape). */
+	table_name: string | null;
+	/** Chain-trigger filter array (the `SubgraphFilter` shape, JSON). Null for
+	*  subgraph subscriptions. Typed loosely here to avoid a shared→subgraphs
+	*  import cycle; the Zod schema in schemas/subscriptions.ts owns the shape. */
+	triggers: unknown | null;
+	filter: Generated<unknown>;
+	format: ColumnType<SubscriptionFormat, SubscriptionFormat | undefined, SubscriptionFormat>;
+	runtime: SubscriptionRuntime | null;
+	url: string;
+	signing_secret_enc: Buffer;
+	auth_config: Generated<unknown>;
+	max_retries: Generated<number>;
+	timeout_ms: Generated<number>;
+	concurrency: Generated<number>;
+	circuit_failures: Generated<number>;
+	circuit_opened_at: Date | null;
+	last_delivery_at: Date | null;
+	last_success_at: Date | null;
+	last_error: string | null;
+	created_at: Generated<Date>;
+	updated_at: Generated<Date>;
+}
+type OutboxStatus = "pending" | "delivered" | "dead";
+interface SubscriptionOutboxTable {
+	id: Generated<string>;
+	subscription_id: string;
+	kind: ColumnType<SubscriptionKind, SubscriptionKind | undefined, SubscriptionKind>;
+	/** Null for chain-subscription rows. */
+	subgraph_name: string | null;
+	/** Null for chain-subscription rows. */
+	table_name: string | null;
+	block_height: number | bigint;
+	tx_id: string | null;
+	row_pk: unknown;
+	event_type: string;
+	payload: unknown;
+	dedup_key: string;
+	attempt: Generated<number>;
+	next_attempt_at: Generated<Date>;
+	status: ColumnType<OutboxStatus, OutboxStatus | undefined, OutboxStatus>;
+	is_replay: Generated<boolean>;
+	delivered_at: Date | null;
+	failed_at: Date | null;
+	locked_by: string | null;
+	locked_until: Date | null;
+	created_at: Generated<Date>;
+}
+interface SubscriptionDeliveriesTable {
+	id: Generated<string>;
+	/** Nullable after migration 0077 — outbox row may be cleaned up while
+	*  delivery telemetry is retained. */
+	outbox_id: string | null;
+	subscription_id: string;
+	attempt: number;
+	status_code: number | null;
+	response_headers: unknown | null;
+	response_body: string | null;
+	error_message: string | null;
+	duration_ms: number | null;
+	dispatched_at: Generated<Date>;
+}
+/** Single-row (id always TRUE) high-water mark for the chain-trigger evaluator.
+*  One loop serves all chain subscriptions, so the cursor is global. */
+interface TriggerEvaluatorStateTable {
+	id: Generated<boolean>;
+	last_processed_block: ColumnType<bigint, bigint | number | undefined, bigint | number>;
+	/** Watermark for the async sBTC settlement-confirmed webhook scan; null until
+	*  the evaluator fast-forwards it on first run. */
+	last_settlement_scan_at: ColumnType<Date | null, Date | null | undefined, Date | null>;
+	updated_at: Generated<Date>;
+}
+/**
+* The instance's declared sync scope.
+*
+* An instance that starts at height N is not an instance missing the first N
+* blocks — but nothing in the schema said so, so every consumer had to guess
+* from `MIN(height)`. `sync_scopes` records the declaration; this module is the
+* only place that reads it, and it always answers in the `SyncScope` shape the
+* coverage evaluator consumes.
+*
+* `resolveSyncScope` never fails on an instance that predates the table: with
+* no row it derives a scope from what the database already shows, so an
+* existing install keeps working without a backfill dance.
+*/
+/**
+* Declares a forward-only instance: history below this height is deliberately
+* absent, not lost. Read only when no `sync_scopes` row exists — a recorded
+* scope always wins, because it is the one an operator committed to.
+*/
+declare const SYNC_START_HEIGHT_ENV = "SECONDLAYER_SYNC_START_HEIGHT";
+declare class InvalidSyncStartHeightError extends Error {
+	readonly value: string;
+	readonly name = "InvalidSyncStartHeightError";
+	constructor(value: string);
+}
+/**
+* Throws rather than ignoring a malformed value: a typo'd start height that
+* silently falls back to genesis would report a real forward-only instance as
+* an 8M-block gap, which is the exact confusion this table exists to end.
+*/
+declare function syncStartHeightFromEnv(env?: NodeJS.ProcessEnv): number | null;
+declare function getSyncScope(db: Kysely<Database>, network: string): Promise<SyncScope | null>;
+/**
+* Record (or restate) the scope for a network. Bootstrap and re-bootstrap are
+* the writers; the upsert is idempotent so re-running a restore over the same
+* archive does not fork the declaration.
+*/
+declare function upsertSyncScope(db: Kysely<Database>, scope: SyncScope): Promise<SyncScope>;
+/**
+* The persisted scope, or one derived from the database when none was ever
+* recorded.
+*
+* The derivation is deliberately conservative: it claims only what the data
+* already shows (the lowest canonical block, the genesis hash if genesis is
+* present) and never invents provenance — an instance whose history starts
+* above genesis with no recorded bootstrap is an `import`, not an archive
+* restore we can vouch for.
+*/
+declare function resolveSyncScope(db: Kysely<Database>, network: string): Promise<SyncScope>;
+export { upsertSyncScope, syncStartHeightFromEnv, resolveSyncScope, getSyncScope, SYNC_START_HEIGHT_ENV, InvalidSyncStartHeightError };