@secondlayer/shared 6.1.0 → 6.3.0

package/migrations/0071_sbtc_dataset.ts

@@ -0,0 +1,126 @@
+import { type Kysely, sql } from "kysely";
+
+export async function up(db: Kysely<unknown>): Promise<void> {
+	await sql`SET lock_timeout = '30s'`.execute(db);
+
+	// Protocol-state events from sbtc-registry: completed-deposit,
+	// withdrawal-create, withdrawal-accept, withdrawal-reject, key-rotation,
+	// update-protocol-contract.
+	await sql`
+		CREATE TABLE IF NOT EXISTS sbtc_events (
+			cursor TEXT PRIMARY KEY,
+			block_height BIGINT NOT NULL,
+			block_time TIMESTAMPTZ NOT NULL,
+			tx_id TEXT NOT NULL,
+			tx_index INTEGER NOT NULL,
+			event_index INTEGER NOT NULL,
+			topic TEXT NOT NULL,
+			request_id BIGINT,
+			amount TEXT,
+			sender TEXT,
+			recipient_btc_version INTEGER,
+			recipient_btc_hashbytes TEXT,
+			bitcoin_txid TEXT,
+			output_index INTEGER,
+			sweep_txid TEXT,
+			burn_hash TEXT,
+			burn_height BIGINT,
+			signer_bitmap TEXT,
+			max_fee TEXT,
+			fee TEXT,
+			block_height_at_request BIGINT,
+			governance_contract_type INTEGER,
+			governance_new_contract TEXT,
+			signer_aggregate_pubkey TEXT,
+			signer_threshold INTEGER,
+			signer_address TEXT,
+			signer_keys_count INTEGER,
+			canonical BOOLEAN NOT NULL DEFAULT true,
+			source_cursor TEXT NOT NULL,
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+			CONSTRAINT sbtc_events_topic_check CHECK (topic IN (
+				'completed-deposit',
+				'withdrawal-create',
+				'withdrawal-accept',
+				'withdrawal-reject',
+				'key-rotation',
+				'update-protocol-contract'
+			))
+		)
+	`.execute(db);
+
+	await sql`CREATE INDEX IF NOT EXISTS sbtc_events_canonical_height_idx ON sbtc_events (canonical, block_height)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS sbtc_events_topic_height_idx ON sbtc_events (topic, block_height)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS sbtc_events_request_id_idx ON sbtc_events (request_id) WHERE request_id IS NOT NULL`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS sbtc_events_bitcoin_txid_idx ON sbtc_events (bitcoin_txid) WHERE bitcoin_txid IS NOT NULL`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS sbtc_events_sender_height_idx ON sbtc_events (sender, block_height) WHERE sender IS NOT NULL`.execute(
+		db,
+	);
+
+	// SIP-010 events on sbtc-token: transfer / mint / burn.
+	await sql`
+		CREATE TABLE IF NOT EXISTS sbtc_token_events (
+			cursor TEXT PRIMARY KEY,
+			block_height BIGINT NOT NULL,
+			block_time TIMESTAMPTZ NOT NULL,
+			tx_id TEXT NOT NULL,
+			tx_index INTEGER NOT NULL,
+			event_index INTEGER NOT NULL,
+			event_type TEXT NOT NULL,
+			sender TEXT,
+			recipient TEXT,
+			amount TEXT NOT NULL,
+			memo TEXT,
+			canonical BOOLEAN NOT NULL DEFAULT true,
+			source_cursor TEXT NOT NULL,
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+			CONSTRAINT sbtc_token_events_type_check CHECK (event_type IN (
+				'transfer',
+				'mint',
+				'burn'
+			))
+		)
+	`.execute(db);
+
+	await sql`CREATE INDEX IF NOT EXISTS sbtc_token_events_canonical_height_idx ON sbtc_token_events (canonical, block_height)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS sbtc_token_events_type_height_idx ON sbtc_token_events (event_type, block_height)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS sbtc_token_events_sender_height_idx ON sbtc_token_events (sender, block_height) WHERE sender IS NOT NULL`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS sbtc_token_events_recipient_height_idx ON sbtc_token_events (recipient, block_height) WHERE recipient IS NOT NULL`.execute(
+		db,
+	);
+
+	// Daily supply rollup. Computed by the aggregator job.
+	await sql`
+		CREATE TABLE IF NOT EXISTS sbtc_supply_snapshots (
+			date TEXT PRIMARY KEY,
+			total_supply TEXT NOT NULL DEFAULT '0',
+			mints_today TEXT NOT NULL DEFAULT '0',
+			burns_today TEXT NOT NULL DEFAULT '0',
+			deposit_count INTEGER NOT NULL DEFAULT 0,
+			withdrawal_create_count INTEGER NOT NULL DEFAULT 0,
+			withdrawal_accept_count INTEGER NOT NULL DEFAULT 0,
+			withdrawal_reject_count INTEGER NOT NULL DEFAULT 0,
+			updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		)
+	`.execute(db);
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+	await sql`DROP TABLE IF EXISTS sbtc_supply_snapshots`.execute(db);
+	await sql`DROP TABLE IF EXISTS sbtc_token_events`.execute(db);
+	await sql`DROP TABLE IF EXISTS sbtc_events`.execute(db);
+}

package/migrations/0072_bns_dataset.ts

@@ -0,0 +1,177 @@
+import { type Kysely, sql } from "kysely";
+
+export async function up(db: Kysely<unknown>): Promise<void> {
+	await sql`SET lock_timeout = '30s'`.execute(db);
+
+	// Name-lifecycle events from BNS-V2 (the `topic`-discriminated payloads):
+	// new-name, transfer-name, renew-name, burn-name, new-airdrop.
+	await sql`
+		CREATE TABLE IF NOT EXISTS bns_name_events (
+			cursor TEXT PRIMARY KEY,
+			block_height BIGINT NOT NULL,
+			block_time TIMESTAMPTZ NOT NULL,
+			tx_id TEXT NOT NULL,
+			tx_index INTEGER NOT NULL,
+			event_index INTEGER NOT NULL,
+			topic TEXT NOT NULL,
+			namespace TEXT NOT NULL,
+			name TEXT NOT NULL,
+			fqn TEXT NOT NULL,
+			owner TEXT,
+			bns_id TEXT NOT NULL,
+			registered_at BIGINT,
+			imported_at BIGINT,
+			renewal_height BIGINT,
+			stx_burn TEXT,
+			preordered_by TEXT,
+			hashed_salted_fqn_preorder TEXT,
+			canonical BOOLEAN NOT NULL DEFAULT true,
+			source_cursor TEXT NOT NULL,
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+			CONSTRAINT bns_name_events_topic_check CHECK (topic IN (
+				'new-name',
+				'transfer-name',
+				'renew-name',
+				'burn-name',
+				'new-airdrop'
+			))
+		)
+	`.execute(db);
+
+	await sql`CREATE INDEX IF NOT EXISTS bns_name_events_canonical_height_idx ON bns_name_events (canonical, block_height)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS bns_name_events_namespace_name_idx ON bns_name_events (namespace, name)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS bns_name_events_owner_height_idx ON bns_name_events (owner, block_height) WHERE owner IS NOT NULL`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS bns_name_events_topic_height_idx ON bns_name_events (topic, block_height)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS bns_name_events_bns_id_idx ON bns_name_events (bns_id)`.execute(
+		db,
+	);
+
+	// Namespace-lifecycle events (the `status`-discriminated payloads).
+	await sql`
+		CREATE TABLE IF NOT EXISTS bns_namespace_events (
+			cursor TEXT PRIMARY KEY,
+			block_height BIGINT NOT NULL,
+			block_time TIMESTAMPTZ NOT NULL,
+			tx_id TEXT NOT NULL,
+			tx_index INTEGER NOT NULL,
+			event_index INTEGER NOT NULL,
+			status TEXT NOT NULL,
+			namespace TEXT NOT NULL,
+			manager TEXT,
+			manager_frozen BOOLEAN,
+			manager_transfers_disabled BOOLEAN,
+			price_function TEXT,
+			price_frozen BOOLEAN,
+			lifetime BIGINT,
+			revealed_at BIGINT,
+			launched_at BIGINT,
+			canonical BOOLEAN NOT NULL DEFAULT true,
+			source_cursor TEXT NOT NULL,
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+			CONSTRAINT bns_namespace_events_status_check CHECK (status IN (
+				'launch',
+				'transfer-manager',
+				'freeze-manager',
+				'update-price-manager',
+				'freeze-price-manager',
+				'turn-off-manager-transfers'
+			))
+		)
+	`.execute(db);
+
+	await sql`CREATE INDEX IF NOT EXISTS bns_namespace_events_canonical_height_idx ON bns_namespace_events (canonical, block_height)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS bns_namespace_events_namespace_status_idx ON bns_namespace_events (namespace, status)`.execute(
+		db,
+	);
+
+	// Marketplace events (the `a`-discriminated payloads on the BNS-V2 NFT).
+	await sql`
+		CREATE TABLE IF NOT EXISTS bns_marketplace_events (
+			cursor TEXT PRIMARY KEY,
+			block_height BIGINT NOT NULL,
+			block_time TIMESTAMPTZ NOT NULL,
+			tx_id TEXT NOT NULL,
+			tx_index INTEGER NOT NULL,
+			event_index INTEGER NOT NULL,
+			action TEXT NOT NULL,
+			bns_id TEXT NOT NULL,
+			price_ustx TEXT,
+			commission TEXT,
+			canonical BOOLEAN NOT NULL DEFAULT true,
+			source_cursor TEXT NOT NULL,
+			created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+			CONSTRAINT bns_marketplace_events_action_check CHECK (action IN (
+				'list-in-ustx',
+				'unlist-in-ustx',
+				'buy-in-ustx'
+			))
+		)
+	`.execute(db);
+
+	await sql`CREATE INDEX IF NOT EXISTS bns_marketplace_events_canonical_height_idx ON bns_marketplace_events (canonical, block_height)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS bns_marketplace_events_bns_id_idx ON bns_marketplace_events (bns_id)`.execute(
+		db,
+	);
+
+	// Current-state projection of names (decoder maintains via upsert).
+	await sql`
+		CREATE TABLE IF NOT EXISTS bns_names (
+			fqn TEXT PRIMARY KEY,
+			namespace TEXT NOT NULL,
+			name TEXT NOT NULL,
+			owner TEXT NOT NULL,
+			bns_id TEXT NOT NULL,
+			registered_at BIGINT,
+			renewal_height BIGINT,
+			last_event_cursor TEXT NOT NULL,
+			last_event_at TIMESTAMPTZ NOT NULL,
+			updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		)
+	`.execute(db);
+
+	await sql`CREATE INDEX IF NOT EXISTS bns_names_owner_idx ON bns_names (owner)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS bns_names_namespace_registered_idx ON bns_names (namespace, registered_at)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX IF NOT EXISTS bns_names_renewal_height_idx ON bns_names (renewal_height) WHERE renewal_height IS NOT NULL`.execute(
+		db,
+	);
+
+	// Current-state projection of namespaces.
+	await sql`
+		CREATE TABLE IF NOT EXISTS bns_namespaces (
+			namespace TEXT PRIMARY KEY,
+			manager TEXT,
+			manager_frozen BOOLEAN NOT NULL DEFAULT false,
+			price_frozen BOOLEAN NOT NULL DEFAULT false,
+			lifetime BIGINT,
+			launched_at BIGINT,
+			last_event_cursor TEXT NOT NULL,
+			last_event_at TIMESTAMPTZ NOT NULL,
+			name_count INTEGER NOT NULL DEFAULT 0,
+			updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+		)
+	`.execute(db);
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+	await sql`DROP TABLE IF EXISTS bns_namespaces`.execute(db);
+	await sql`DROP TABLE IF EXISTS bns_names`.execute(db);
+	await sql`DROP TABLE IF EXISTS bns_marketplace_events`.execute(db);
+	await sql`DROP TABLE IF EXISTS bns_namespace_events`.execute(db);
+	await sql`DROP TABLE IF EXISTS bns_name_events`.execute(db);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@secondlayer/shared",
-	"version": "6.1.0",
+	"version": "6.3.0",
 	"type": "module",
 	"main": "./dist/src/index.js",
 	"types": "./dist/src/index.d.ts",
@@ -188,7 +188,7 @@
 		"prepublishOnly": "bun run build"
 	},
 	"dependencies": {
-		"@secondlayer/stacks": "^2.0.1",
+		"@secondlayer/stacks": "^2.1.0",
 		"kysely": "0.28.15",
 		"kysely-postgres-js": "3.0.0",
 		"postgres": "^3.4.6",