TeenaDOCUMENTATION · V0
How Teena works,
without the hype.
This page documents what exists today, what does not exist yet, and the technical rules we will preserve as Teena evolves from observation into intelligence and, later, controlled execution.
CURRENT STATEv0 · Ingestion
Helius → Supabase is connected and verified. Normalization, scoring and paper trading are the next layers.
Purpose
Teena observes Solana memecoin activity from its earliest on-chain signals. The goal is not to guess a winner. It is to build an objective historical dataset that reveals which patterns tend to appear before different outcomes: graduation, growth, drawdown or rug.
Real data onlyNo market metric, result or performance number is shown unless Teena actually measured it.
No look-aheadA simulated decision may only use information available at that moment.
Paper trading firstBefore real capital is connected, rules will be tested through traceable simulated execution.
Alpha ≠ riskOpportunity and risk signals will be modeled separately.
v0 architecture
The current architecture captures first and reasons later. RAW events remain the source of truth so derived layers can be recalculated without rewriting history.
1 · SOLANAPump.fun and PumpSwap generate mainnet activity.
2 · HELIUSA RAW webhook observes the programs/addresses we care about.
3 · INGESTA Supabase Edge Function validates and stores each delivery.
4 · DATAPostgres holds RAW events, tokens, trades, snapshots, outcomes and entities.
5 · TEENA UIVercel reads from a public read-only API and renders only existing data.
Webhook authentication and service credentials are never exposed in the public interface or documentation.
What works today
Helius webhook · LIVERAW mainnet delivery has been verified with real test deliveries.
Persistence · LIVEDeliveries are stored in Supabase with timestamps and payloads.
Read API · LIVEThe UI reads counters and recent token data through a read-only Edge Function.
Dashboard · LIVEThe web app refreshes regularly and reflects the actual pipeline state.
What is not active yet
v0.1Decoder + token and trade normalizationNEXT
v0.2Curve, holder and milestone snapshotsPLANNED
v0.3Creator clusters, distribution and wallet intelligencePLANNED
v0.4Separate risk and alpha scoringPLANNED
v0.5Paper trader and Strategy LabPLANNED
v1Connected wallet with execution controlsFUTURE
Research rule
If we did not know it at that moment, we do not use it.
Historical features must be reconstructed using only information available up to the evaluated timestamp. No enriching the past with future data. This rule will underpin backtesting, paper trading and any future strategy.
Historical features must be reconstructed using only information available up to the evaluated timestamp. No enriching the past with future data. This rule will underpin backtesting, paper trading and any future strategy.