@secondlayer/shared 6.18.0 → 6.20.0

package/dist/src/index.js

@@ -56,6 +56,9 @@ function getEnv() {
   cachedEnv = { ...result.data, enabledNetworks };
   return cachedEnv;
 }
+function isPox4DecoderEnabled() {
+  return process.env.POX4_DECODER_ENABLED !== "false";
+}
 // src/logger.ts
 var LOG_LEVELS = {
   debug: 0,
@@ -150,6 +153,232 @@ import { Kysely } from "kysely";
 import { PostgresJSDialect } from "kysely-postgres-js";
 import postgres from "postgres";
 import { sql as sql2 } from "kysely";
+
+// src/db/source-read-columns.ts
+var SOURCE_READ_COLUMNS = {
+  blocks: [
+    "burn_block_hash",
+    "burn_block_height",
+    "canonical",
+    "hash",
+    "height",
+    "parent_hash",
+    "timestamp"
+  ],
+  decoded_events: [
+    "amount",
+    "asset_identifier",
+    "block_height",
+    "canonical",
+    "contract_id",
+    "cursor",
+    "event_index",
+    "event_type",
+    "memo",
+    "payload",
+    "recipient",
+    "sender",
+    "tx_id",
+    "tx_index",
+    "value"
+  ],
+  transactions: [
+    "block_height",
+    "contract_id",
+    "function_args",
+    "function_name",
+    "raw_result",
+    "raw_tx",
+    "sender",
+    "status",
+    "tx_id",
+    "tx_index",
+    "type"
+  ],
+  mempool_transactions: [
+    "contract_id",
+    "function_args",
+    "function_name",
+    "raw_tx",
+    "received_at",
+    "sender",
+    "seq",
+    "tx_id",
+    "type"
+  ],
+  pox4_calls: [
+    "aggregated_amount_ustx",
+    "aggregated_signer_index",
+    "amount_ustx",
+    "auth_allowed",
+    "auth_id",
+    "auth_period",
+    "auth_topic",
+    "block_height",
+    "block_time",
+    "burn_block_height",
+    "caller",
+    "canonical",
+    "cursor",
+    "delegate_to",
+    "end_cycle",
+    "function_name",
+    "lock_period",
+    "max_amount",
+    "pox_addr_btc",
+    "pox_addr_hashbytes",
+    "pox_addr_version",
+    "result_ok",
+    "reward_cycle",
+    "signer_key",
+    "signer_signature",
+    "source_cursor",
+    "stacker",
+    "start_cycle",
+    "tx_id",
+    "tx_index"
+  ],
+  sbtc_events: [
+    "amount",
+    "bitcoin_txid",
+    "block_height",
+    "block_time",
+    "burn_hash",
+    "burn_height",
+    "canonical",
+    "cursor",
+    "event_index",
+    "fee",
+    "governance_contract_type",
+    "governance_new_contract",
+    "max_fee",
+    "output_index",
+    "recipient_btc_hashbytes",
+    "recipient_btc_version",
+    "request_id",
+    "sender",
+    "signer_address",
+    "signer_aggregate_pubkey",
+    "signer_bitmap",
+    "signer_keys_count",
+    "signer_threshold",
+    "sweep_txid",
+    "topic",
+    "tx_id",
+    "tx_index"
+  ],
+  sbtc_token_events: [
+    "amount",
+    "block_height",
+    "block_time",
+    "canonical",
+    "cursor",
+    "event_index",
+    "event_type",
+    "memo",
+    "recipient",
+    "sender",
+    "tx_id",
+    "tx_index"
+  ],
+  bns_name_events: [
+    "block_height",
+    "block_time",
+    "bns_id",
+    "canonical",
+    "cursor",
+    "event_index",
+    "fqn",
+    "hashed_salted_fqn_preorder",
+    "imported_at",
+    "name",
+    "namespace",
+    "owner",
+    "preordered_by",
+    "registered_at",
+    "renewal_height",
+    "stx_burn",
+    "topic",
+    "tx_id",
+    "tx_index"
+  ],
+  bns_namespace_events: [
+    "block_height",
+    "block_time",
+    "canonical",
+    "cursor",
+    "event_index",
+    "launched_at",
+    "lifetime",
+    "manager",
+    "manager_frozen",
+    "manager_transfers_disabled",
+    "namespace",
+    "price_frozen",
+    "price_function",
+    "revealed_at",
+    "status",
+    "tx_id",
+    "tx_index"
+  ],
+  bns_marketplace_events: [
+    "action",
+    "block_height",
+    "block_time",
+    "bns_id",
+    "canonical",
+    "commission",
+    "cursor",
+    "event_index",
+    "price_ustx",
+    "tx_id",
+    "tx_index"
+  ],
+  bns_names: [
+    "bns_id",
+    "fqn",
+    "last_event_at",
+    "last_event_cursor",
+    "name",
+    "namespace",
+    "owner",
+    "registered_at",
+    "renewal_height"
+  ],
+  bns_namespaces: [
+    "last_event_at",
+    "last_event_cursor",
+    "launched_at",
+    "lifetime",
+    "manager",
+    "manager_frozen",
+    "name_count",
+    "namespace",
+    "price_frozen"
+  ],
+  burn_block_rewards: [
+    "amount_sats",
+    "burn_amount",
+    "burn_block_hash",
+    "burn_block_height",
+    "canonical",
+    "cursor",
+    "recipient_btc",
+    "reward_index"
+  ],
+  burn_block_reward_slots: [
+    "burn_block_hash",
+    "burn_block_height",
+    "canonical",
+    "cursor",
+    "holder_btc",
+    "slot_index"
+  ],
+  events: ["block_height", "data", "event_index", "tx_id", "type"],
+  chain_reorgs: ["detected_at"]
+};
+
+// src/db/index.ts
 var DEFAULT_URL = "postgres://postgres:postgres@localhost:5432/secondlayer_dev";
 var pools = new Map;
 var poolSeq = 0;
@@ -182,6 +411,54 @@ function resolveSourceUrl() {
 function resolveTargetUrl() {
   return process.env.TARGET_DATABASE_URL || process.env.DATABASE_URL || DEFAULT_URL;
 }
+function describeDbUrl(url) {
+  try {
+    const u = new URL(url);
+    return `${u.hostname}${u.port ? `:${u.port}` : ""}${u.pathname}`;
+  } catch {
+    return "invalid-url";
+  }
+}
+function getDbSplitStatus() {
+  const source = resolveSourceUrl();
+  const target = resolveTargetUrl();
+  const active = source !== target;
+  return {
+    mode: active ? "split" : "single",
+    active,
+    sourceDb: describeDbUrl(source),
+    targetDb: describeDbUrl(target)
+  };
+}
+function assertDbSplit() {
+  const isProd = false;
+  const wantsSplit = !!(process.env.SOURCE_DATABASE_URL || process.env.TARGET_DATABASE_URL);
+  const databaseUrlSet = !!process.env.DATABASE_URL;
+  const source = resolveSourceUrl();
+  const target = resolveTargetUrl();
+  if (wantsSplit && !databaseUrlSet && (source === DEFAULT_URL || target === DEFAULT_URL)) {
+    const which = source === DEFAULT_URL ? "SOURCE_DATABASE_URL" : "TARGET_DATABASE_URL";
+    const msg = `${which} unset and DATABASE_URL absent — resolving to built-in DEFAULT_URL; refusing to silently use the wrong database`;
+    if (isProd)
+      console.error(`❌ ${msg}`);
+    else
+      console.warn(`⚠️  ${msg}`);
+    return;
+  }
+  if (!wantsSplit) {
+    if (isProd) {
+      console.warn("⚠️  DB split dormant — all services share one Postgres failure domain (SOURCE_/TARGET_DATABASE_URL unset)");
+    }
+    return;
+  }
+  if (source === target) {
+    const msg = "DB split requested but SOURCE_DATABASE_URL === TARGET_DATABASE_URL (check for a typo or a stray DATABASE_URL fallback)";
+    if (isProd)
+      console.error(`❌ ${msg}`);
+    else
+      console.warn(`⚠️  ${msg}`);
+  }
+}
 function getOrCreatePool(url) {
   const existing = pools.get(url);
   if (existing) {
@@ -1212,6 +1489,48 @@ var DECODED_EVENT_TYPES = [
   "print"
 ];
 var STREAMS_EVENT_TYPES = DECODED_EVENT_TYPES;
+// src/db-event-types.ts
+var STREAMS_DB_EVENT_TYPES = [
+  "stx_transfer_event",
+  "stx_mint_event",
+  "stx_burn_event",
+  "stx_lock_event",
+  "ft_transfer_event",
+  "ft_mint_event",
+  "ft_burn_event",
+  "nft_transfer_event",
+  "nft_mint_event",
+  "nft_burn_event",
+  "smart_contract_event",
+  "contract_event"
+];
+var DB_TO_STREAMS_EVENT_TYPE = {
+  stx_transfer_event: "stx_transfer",
+  stx_mint_event: "stx_mint",
+  stx_burn_event: "stx_burn",
+  stx_lock_event: "stx_lock",
+  ft_transfer_event: "ft_transfer",
+  ft_mint_event: "ft_mint",
+  ft_burn_event: "ft_burn",
+  nft_transfer_event: "nft_transfer",
+  nft_mint_event: "nft_mint",
+  nft_burn_event: "nft_burn",
+  smart_contract_event: "print",
+  contract_event: "print"
+};
+var STREAMS_TO_DB_EVENT_TYPES = {
+  stx_transfer: ["stx_transfer_event"],
+  stx_mint: ["stx_mint_event"],
+  stx_burn: ["stx_burn_event"],
+  stx_lock: ["stx_lock_event"],
+  ft_transfer: ["ft_transfer_event"],
+  ft_mint: ["ft_mint_event"],
+  ft_burn: ["ft_burn_event"],
+  nft_transfer: ["nft_transfer_event"],
+  nft_mint: ["nft_mint_event"],
+  nft_burn: ["nft_burn_event"],
+  print: ["smart_contract_event", "contract_event"]
+};
 // src/finality.ts
 var DEFAULT_BTC_CONFIRMATIONS = 6;
 function finalizedBurnHeight(burnTipHeight, confirmations = DEFAULT_BTC_CONFIRMATIONS) {
@@ -1300,12 +1619,14 @@ export {
   parseJsonb,
   logger,
   jsonb,
+  isPox4DecoderEnabled,
   getTargetDb,
   getSourceDb,
   getRawClientFor,
   getRawClient,
   getErrorMessage,
   getEnv,
+  getDbSplitStatus,
   getDb,
   generateSubgraphSpec,
   generateSubgraphOpenApi,
@@ -1318,6 +1639,7 @@ export {
   decodeStreamsCursor,
   exports_hmac as crypto,
   closeDb,
+  assertDbSplit,
   VersionConflictError,
   ValidationError,
   UpdateSubscriptionRequestSchema,
@@ -1338,7 +1660,10 @@ export {
   SUBSCRIPTION_RUNTIMES,
   SUBSCRIPTION_FORMATS,
   SUBSCRIPTION_FILTER_OPERATORS,
+  STREAMS_TO_DB_EVENT_TYPES,
   STREAMS_EVENT_TYPES,
+  STREAMS_DB_EVENT_TYPES,
+  SOURCE_READ_COLUMNS,
   ReplaySubscriptionRequestSchema,
   RateLimitError,
   PrintEventFilterSchema,
@@ -1358,6 +1683,7 @@ export {
   DatabaseError,
   DEFAULT_BTC_CONFIRMATIONS,
   DECODED_EVENT_TYPES,
+  DB_TO_STREAMS_EVENT_TYPE,
   CreateSubscriptionRequestSchema,
   ContractDeployFilterSchema,
   ContractCallFilterSchema,
@@ -1367,5 +1693,5 @@ export {
   AuthenticationError
 };
 
-//# debugId=A2EF93E9235ADDCA64756E2164756E21
+//# debugId=80DED0C0E8D3237364756E2164756E21
 //# sourceMappingURL=index.js.map