bitcain docs

Solana On-Chain

Solana On-Chain

Solana blockchain data tables for DEX trade tracking, whale movement alerts, wallet management, and transaction history caching.

4 tables in this group.

dex_trades

Live DEX trade feed populated by the cat-piss solana_stream.py service via Solana WebSocket subscriptions.

ColumnTypeNullableDefault
iduuidNogen_random_uuid()
signaturetextNo
dextextNo
input_minttextNo
output_minttextNo
input_amountnumericYes
output_amountnumericYes
price_usdnumericYes
trader_addresstextYes
block_timetimestamptzYes
created_attimestamptzNonow()

RLS Policies:

  • Service role can manage dex trades — ALL for {public}

Indexes:

  • idx_dex_trades_dex
  • idx_dex_trades_signature
  • idx_dex_trades_block_time
  • idx_dex_trades_trader

Data Source: bitcain-solana-stream systemd service on cat-piss server. Detects trades from Jupiter, Orca, Raydium, Raydium CLMM, and Phoenix program logs.


whale_alerts

Whale movement alerts from both CEX monitoring (news scrapers) and on-chain Solana wallet tracking.

ColumnTypeNullableDefault
iduuidNogen_random_uuid()
sourcetextYes
assettextYes
amountnumericYes
usd_valuenumericYes
directiontextYes
exchangetextYes
interpretationtextYes
detected_attimestamptzYes
created_attimestamptzNonow()
collected_attimestamptzYes

Indexes:

  • idx_whale_alerts_type
  • idx_whale_alerts_address
  • idx_whale_alerts_created

Data Sources:

  • solana-stream (source=solana-stream) — On-chain Solana whale wallet monitoring
  • News scrapers (source varies) — CEX whale movement reports

solana_wallets

User-tracked Solana wallet addresses for portfolio monitoring.

ColumnTypeNullableDefault
iduuidNogen_random_uuid()
user_iduuidYesReferences auth.users(id)
addresstextNo
labeltextYes
created_attimestamptzNonow()

RLS Policies:

  • Users can manage their own wallets — ALL where auth.uid() = user_id

Indexes:

  • idx_solana_wallets_user
  • idx_solana_wallets_address

solana_transactions

Cached parsed Solana transactions for faster repeat lookups.

ColumnTypeNullableDefault
iduuidNogen_random_uuid()
signaturetextNoUNIQUE
wallet_addresstextNo
parsed_typetextYes
parsed_datajsonbYes
block_timetimestamptzYes
fee_lamportsbigintYes
created_attimestamptzNonow()

RLS Policies:

  • Service role can manage solana transactions — ALL for {public}

Indexes:

  • idx_solana_tx_wallet
  • idx_solana_tx_type
  • idx_solana_tx_block_time

On this page