@secondlayer/shared 6.9.0 → 6.11.0

package/dist/src/node/local-client.d.ts

@@ -33,6 +33,35 @@ interface EventsTable {
 	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 IndexProgressTable {
 	network: string;
 	last_indexed_block: Generated<number>;
@@ -380,6 +409,26 @@ interface Pox4SignersDailyTable {
 	aggregation_calls: Generated<number>;
 	updated_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>;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
+interface BurnBlockRewardSlotsTable {
+	cursor: string;
+	burn_block_height: number;
+	burn_block_hash: string;
+	slot_index: number;
+	holder_btc: string;
+	canonical: Generated<boolean>;
+	created_at: Generated<Date>;
+}
 type SbtcEventTopic = "completed-deposit" | "withdrawal-create" | "withdrawal-accept" | "withdrawal-reject" | "key-rotation" | "update-protocol-contract";
 interface SbtcEventsTable {
 	cursor: string;
@@ -531,6 +580,8 @@ interface Database {
 	blocks: BlocksTable;
 	transactions: TransactionsTable;
 	events: EventsTable;
+	transactions_archive: TransactionsArchiveTable;
+	events_archive: EventsArchiveTable;
 	index_progress: IndexProgressTable;
 	contracts: ContractsTable;
 	subgraphs: SubgraphsTable;
@@ -568,6 +619,8 @@ interface Database {
 	pox4_calls: Pox4CallsTable;
 	pox4_cycles_daily: Pox4CyclesDailyTable;
 	pox4_signers_daily: Pox4SignersDailyTable;
+	burn_block_rewards: BurnBlockRewardsTable;
+	burn_block_reward_slots: BurnBlockRewardSlotsTable;
 	sbtc_events: SbtcEventsTable;
 	sbtc_token_events: SbtcTokenEventsTable;
 	sbtc_supply_snapshots: SbtcSupplySnapshotsTable;

package/migrations/0066_public_l2_decoded_events.ts

@@ -1,6 +1,7 @@
 import { type Kysely, sql } from "kysely";
 
-export async function up(db: Kysely<unknown>): Promise<void> {
+// biome-ignore lint/suspicious/noExplicitAny: migration DDL is intentionally schema-dynamic
+export async function up(db: Kysely<any>): Promise<void> {
 	await sql`
 		ALTER TABLE decoded_events
 			ADD COLUMN microblock_hash TEXT,
@@ -41,7 +42,8 @@ export async function up(db: Kysely<unknown>): Promise<void> {
 	`.execute(db);
 }
 
-export async function down(db: Kysely<unknown>): Promise<void> {
+// biome-ignore lint/suspicious/noExplicitAny: migration DDL is intentionally schema-dynamic
+export async function down(db: Kysely<any>): Promise<void> {
 	await sql`DROP INDEX IF EXISTS decoded_events_recipient_height_event_idx`.execute(
 		db,
 	);

package/migrations/0067_product_usage_counters.ts

@@ -1,6 +1,7 @@
 import { type Kysely, sql } from "kysely";
 
-export async function up(db: Kysely<unknown>): Promise<void> {
+// biome-ignore lint/suspicious/noExplicitAny: migration DDL is intentionally schema-dynamic
+export async function up(db: Kysely<any>): Promise<void> {
 	await sql`SET lock_timeout = '30s'`.execute(db);
 	await sql`
 		ALTER TABLE usage_daily
@@ -9,7 +10,8 @@ export async function up(db: Kysely<unknown>): Promise<void> {
 	`.execute(db);
 }
 
-export async function down(db: Kysely<unknown>): Promise<void> {
+// biome-ignore lint/suspicious/noExplicitAny: migration DDL is intentionally schema-dynamic
+export async function down(db: Kysely<any>): Promise<void> {
 	await sql`
 		ALTER TABLE usage_daily
 			DROP COLUMN IF EXISTS index_decoded_events_returned,

package/migrations/0083_burnchain_rewards.ts

@@ -0,0 +1,63 @@
+import { type Kysely, sql } from "kysely";
+
+// Burnchain (Bitcoin) PoX reward data, sourced from the stacks-node
+// /new_burn_block event observer payload (reward_recipients / reward_slot_holders),
+// which the indexer previously discarded. Two views per burn block:
+//   - burn_block_rewards: actual BTC payouts (one row per reward slot, ≤2/block).
+//     Populated only during a reward cycle's reward phase.
+//   - burn_block_reward_slots: reward-set membership (eligible BTC addresses).
+// Both are keyed by (burn_block_height, index) via `cursor`; the handler does
+// delete-by-height-then-insert (replace-per-height), which makes redelivery and
+// shallow burnchain reorgs idempotent. `canonical` is reserved for a future
+// mark-non-canonical reorg path; v1 keeps every row canonical.
+export async function up(db: Kysely<unknown>): Promise<void> {
+	await sql`SET lock_timeout = '30s'`.execute(db);
+
+	await sql`
+		CREATE TABLE IF NOT EXISTS burn_block_rewards (
+			cursor TEXT PRIMARY KEY,
+			burn_block_height BIGINT NOT NULL,
+			burn_block_hash TEXT NOT NULL,
+			reward_index INTEGER NOT NULL,
+			recipient_btc TEXT NOT NULL,
+			amount_sats TEXT NOT NULL,
+			burn_amount TEXT NOT NULL DEFAULT '0',
+			canonical BOOLEAN NOT NULL DEFAULT true,
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		)
+	`.execute(db);
+
+	await sql`CREATE INDEX IF NOT EXISTS burn_block_rewards_canonical_height_idx ON burn_block_rewards (canonical, burn_block_height)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS burn_block_rewards_recipient_height_idx ON burn_block_rewards (recipient_btc, burn_block_height)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS burn_block_rewards_hash_idx ON burn_block_rewards (burn_block_hash)`.execute(
+		db,
+	);
+
+	await sql`
+		CREATE TABLE IF NOT EXISTS burn_block_reward_slots (
+			cursor TEXT PRIMARY KEY,
+			burn_block_height BIGINT NOT NULL,
+			burn_block_hash TEXT NOT NULL,
+			slot_index INTEGER NOT NULL,
+			holder_btc TEXT NOT NULL,
+			canonical BOOLEAN NOT NULL DEFAULT true,
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		)
+	`.execute(db);
+
+	await sql`CREATE INDEX IF NOT EXISTS burn_block_reward_slots_canonical_height_idx ON burn_block_reward_slots (canonical, burn_block_height)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS burn_block_reward_slots_holder_height_idx ON burn_block_reward_slots (holder_btc, burn_block_height)`.execute(
+		db,
+	);
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+	await sql`DROP TABLE IF EXISTS burn_block_reward_slots`.execute(db);
+	await sql`DROP TABLE IF EXISTS burn_block_rewards`.execute(db);
+}

package/migrations/0084_reorg_archive.ts

@@ -0,0 +1,59 @@
+import { type Kysely, sql } from "kysely";
+
+// Reorg archive: when a reorg reuses a height, the indexer replaces the
+// transactions/events at that height (persistBlock). Previously the orphaned
+// rows were DELETEd outright. Instead, we now copy them here first so the raw
+// log is preserved (queryable + auditable) rather than destroyed — the
+// "immutable log" the availability layer promises. Append-only; a synthetic
+// archive_id lets the same original row be archived across multiple reorgs.
+export async function up(db: Kysely<unknown>): Promise<void> {
+	await sql`SET lock_timeout = '30s'`.execute(db);
+
+	await sql`
+		CREATE TABLE IF NOT EXISTS transactions_archive (
+			archive_id BIGSERIAL PRIMARY KEY,
+			tx_id TEXT NOT NULL,
+			block_height BIGINT NOT NULL,
+			tx_index INTEGER NOT NULL,
+			type TEXT NOT NULL,
+			sender TEXT NOT NULL,
+			status TEXT NOT NULL,
+			contract_id TEXT,
+			function_name TEXT,
+			function_args JSONB,
+			raw_result TEXT,
+			raw_tx TEXT NOT NULL,
+			created_at TIMESTAMPTZ NOT NULL,
+			orphaned_block_hash TEXT,
+			archived_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		)
+	`.execute(db);
+
+	await sql`CREATE INDEX IF NOT EXISTS transactions_archive_height_idx ON transactions_archive (block_height)`.execute(
+		db,
+	);
+
+	await sql`
+		CREATE TABLE IF NOT EXISTS events_archive (
+			archive_id BIGSERIAL PRIMARY KEY,
+			id TEXT NOT NULL,
+			tx_id TEXT NOT NULL,
+			block_height BIGINT NOT NULL,
+			event_index INTEGER NOT NULL,
+			type TEXT NOT NULL,
+			data JSONB,
+			created_at TIMESTAMPTZ NOT NULL,
+			orphaned_block_hash TEXT,
+			archived_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		)
+	`.execute(db);
+
+	await sql`CREATE INDEX IF NOT EXISTS events_archive_height_idx ON events_archive (block_height)`.execute(
+		db,
+	);
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+	await sql`DROP TABLE IF EXISTS events_archive`.execute(db);
+	await sql`DROP TABLE IF EXISTS transactions_archive`.execute(db);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@secondlayer/shared",
-	"version": "6.9.0",
+	"version": "6.11.0",
 	"license": "MIT",
 	"repository": {
 		"type": "git",