@secondlayer/shared

Foundational utilities for Second Layer services: DB layer (Kysely + postgres-js), Zod schemas, crypto (Standard Webhooks signing, AES-GCM secret envelope), logger, pricing, env/mode utils, Stacks node clients.

Testing

# Run tests (DB tests skip without DATABASE_URL)
bun test

# Run with database
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/secondlayer_test bun test

Migrations

DATABASE_URL=... bun run migrate

Exports

Path	Description
@secondlayer/shared	Core utilities (errors, logger, env, db layer, subgraph/subscription schemas)
@secondlayer/shared/db	Kysely database layer
@secondlayer/shared/db/schema	Database schema + row types
@secondlayer/shared/db/queries/*	Query helpers (integrity, chain-reorgs, subgraphs, subgraph-gaps, subgraph-operations, subscriptions)
@secondlayer/shared/schemas	Zod schemas (subgraphs, subscriptions)
@secondlayer/shared/schemas/subgraphs	Subgraph schemas
@secondlayer/shared/schemas/subscriptions	Subscription schemas
@secondlayer/shared/subgraphs/spec	Subgraph spec generation
@secondlayer/shared/queue/listener	Postgres LISTEN/NOTIFY helper (used for block notifications)
@secondlayer/shared/logger	Logger
@secondlayer/shared/errors	Error types
@secondlayer/shared/mode	INSTANCE_MODE dispatch (platform / dedicated / oss)
@secondlayer/shared/crypto/secrets	AES-GCM secret envelope
@secondlayer/shared/crypto/standard-webhooks	Standard Webhooks signing
@secondlayer/shared/node	Stacks node client
@secondlayer/shared/node/*	Stacks node clients (hiro-client, local-client, hiro-pg-client, archive-client)