@secondlayer/shared 6.7.0 → 6.8.1

package/dist/src/db/index.d.ts

@@ -305,6 +305,9 @@ interface DecodedEventsTable {
 	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>;
 }

package/dist/src/db/queries/chain-reorgs.d.ts

@@ -286,6 +286,9 @@ interface DecodedEventsTable {
 	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>;
 }

package/dist/src/db/queries/integrity.d.ts

@@ -287,6 +287,9 @@ interface DecodedEventsTable {
 	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>;
 }

package/dist/src/db/queries/subgraph-gaps.d.ts

@@ -287,6 +287,9 @@ interface DecodedEventsTable {
 	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>;
 }

package/dist/src/db/queries/subgraph-operations.d.ts

@@ -287,6 +287,9 @@ interface DecodedEventsTable {
 	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>;
 }

package/dist/src/db/queries/subgraphs.d.ts

@@ -287,6 +287,9 @@ interface DecodedEventsTable {
 	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>;
 }

package/dist/src/db/queries/subscriptions.d.ts

@@ -287,6 +287,9 @@ interface DecodedEventsTable {
 	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>;
 }

package/dist/src/db/schema.d.ts

@@ -286,6 +286,9 @@ interface DecodedEventsTable {
 	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>;
 }

package/dist/src/index.d.ts

@@ -286,6 +286,9 @@ interface DecodedEventsTable {
 	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>;
 }

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

@@ -287,6 +287,9 @@ interface DecodedEventsTable {
 	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>;
 }

package/migrations/0079_decoded_events_payload.ts

@@ -0,0 +1,12 @@
+import { type Kysely, sql } from "kysely";
+
+// Adds a generic JSONB column for decoded event types whose payload doesn't fit
+// the flat transfer columns — first consumer is `print` (topic + decoded Clarity
+// value + raw hex). Nullable; every existing transfer row leaves it null.
+export async function up(db: Kysely<unknown>): Promise<void> {
+	await sql`ALTER TABLE decoded_events ADD COLUMN payload JSONB`.execute(db);
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+	await sql`ALTER TABLE decoded_events DROP COLUMN payload`.execute(db);
+}

package/migrations/0080_decoded_events_evt_canon_created_idx.ts

@@ -0,0 +1,22 @@
+import { type Kysely, sql } from "kysely";
+
+// Composite index backing the l2-decoder /health freshness probe
+// (`readLatestDecodedAt`): `WHERE event_type = ? AND canonical = ?
+// ORDER BY created_at DESC LIMIT 1`. Without it that query seq-scans the
+// full decoded_events table (~18GB) and sorts millions of rows per call;
+// /health fans it out per decoder, so under load Postgres pinned several
+// cores. With this index it's an instant index-only scan.
+//
+// Already created CONCURRENTLY on prod; IF NOT EXISTS makes this a no-op
+// there and a cheap build on fresh/dev databases (small data).
+export async function up(db: Kysely<unknown>): Promise<void> {
+	await sql`CREATE INDEX IF NOT EXISTS decoded_events_evt_canon_created_idx ON decoded_events (event_type, canonical, created_at DESC)`.execute(
+		db,
+	);
+}
+
+export async function down(db: Kysely<unknown>): Promise<void> {
+	await sql`DROP INDEX IF EXISTS decoded_events_evt_canon_created_idx`.execute(
+		db,
+	);
+}

package/package.json

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