# Khadhroony Bobot — Global TODO / Roadmap > This roadmap is a living document. > Completed versions reflect the current implemented state. > Planned versions are indicative and may evolve as architecture and product needs become clearer. --- ## Project goals The project is split into several major applications sharing `khbb_lib`: - `khbb_listener_app` - listen to Solana data sources, - detect token / mint / token-account / bootstrap / pair / pool related activity, - enrich and store observed data. - `khbb_pattern_analyser_app` - analyze recurring patterns on tokens, mints, pools, names, lifetimes, scam patterns, bootstrap flows, early activity. - `khbb_trader_app` - consume early detections and pattern outputs, - take automated trading decisions, - apply entry/exit logic based on price, duration, confidence, and risk. --- ## Current architectural direction Current implementation started with a simple inline listener loop in order to validate: - Solana HTTP RPC transport, - Solana WebSocket transport, - raw data storage, - event normalization, - early domain classification, - heuristic signals, - HTTP enrichment, - candidate tracking. This is considered a bootstrap architecture. ### Target architecture direction The target architecture should progressively move toward: - multiple concurrent data sources, - autonomous source clients, - async task-based source runtimes, - command/event channels, - source aggregation hub, - separation between: - transport, - normalization, - enrichment, - correlation, - persistence, - strategy/trading. This especially applies to: - multiple WebSocket clients, - Yellowstone gRPC client(s), - HTTP enrichment workers, - future external data sources. --- ## Completed versions ### v0.1.x - initial project skeleton - workspace setup - strict coding conventions - config loading - tracing bootstrap - SQLite bootstrap ### v0.2.x - basic listener runtime - listener session creation - SQLite connectivity validation - initial runtime loop - first persistence primitives ### v0.3.0 - HTTP JSON-RPC client foundation - manual request ids - use of official Solana RPC request/response types where applicable - basic `getSlot` support - raw HTTP RPC storage ### v0.3.1 - tests added around config and storage - tests added around HTTP RPC request/response parsing - stronger validation of config and SQLite helpers ### v0.3.2 - HTTP polling integrated into listener runtime - `getSlot` polling stored as raw RPC traffic ### v0.4.1 - initial Solana WebSocket RPC support - subscription primitives - support for: - `slotSubscribe` - `logsSubscribe` - `programSubscribe` - raw WS message storage ### v0.4.3 - centralized WebSocket read loop improvements - safe unsubscribe handling - shutdown flow improvements - Rustls provider initialization fixes ### v0.4.4 - centralized WS dispatch between: - JSON-RPC responses - notifications - better separation of response wait logic and notification flow ### v0.4.5 - active WS subscription registry - source metadata attached to subscriptions - cleaner handling of multiple subscription kinds ### v0.4.6 - WS notification normalization layer - normalized events introduced for: - slot - logs - program notifications ### v0.5.0 - first domain event layer - normalized WS events converted into domain events ### v0.5.1 - known program registry - first known-program classification layer - SPL Token / Token-2022 / System / ComputeBudget / ATA recognition ### v0.5.2 - official `ids.rs` module added - heuristic signal layer introduced - first weak signals around: - token account activity - mint activity - initial token activity - bootstrap-style activity ### v0.5.3 - heuristic refinement - associated token account style signals - stronger bootstrap-oriented heuristics from known logs ### v0.5.4 - targeted HTTP enrichment via `getAccountInfo` - enriched account snapshot - first distinction between: - potential token account - potential mint account - unknown account ### v0.5.5 - enriched classification layer - confirmed enriched events introduced: - confirmed token account activity - confirmed mint account activity - unknown token-program-owned account activity ### v0.5.6 - local correlation layer between: - enriched events - heuristics - correlated signals introduced: - confirmed token account update - potential new token mint - potential token bootstrap flow ### v0.5.7 - candidate layer introduced - first domain candidates: - token account candidate - mint candidate - bootstrap flow candidate - listener maximum tick count made configurable ### v0.5.8 - in-memory session candidate tracker - session-local deduplication - lightweight score and confidence - per-session candidate upsert flow ### v0.5.9 - session candidate snapshots - sorted candidate summaries - confidence-based filtering - end-of-session summary logs --- ## Current status summary At the current stage, the project can already: - connect to Solana HTTP RPC, - connect to Solana WebSocket RPC, - subscribe to slot/logs/program streams, - store raw HTTP and WS payloads, - normalize notifications, - derive domain events, - classify known programs, - emit heuristic signals, - enrich accounts with `getAccountInfo`, - confirm token-account-like activity, - correlate signals, - track session candidates in memory, - summarize candidates at the end of a run. What is still missing is the transition from generic token activity detection to true: - mint detection, - token bootstrap detection, - pool/pair detection, - DEX-aware activity detection, - persistent candidate storage, - pattern analysis, - trading integration. --- ## Planned versions > Planned versions are provisional and may change. ### v0.6.0 - persist session candidates to SQLite - add dedicated candidate table(s) - persist summary-worthy candidates at end of listener session - create base persistence model reusable by analyser and trader ### v0.6.1 - refactor WebSocket client into an autonomous async source runtime - introduce command/event channel model - separate WS transport orchestration from listener business logic ### v0.6.2 - support multiple concurrent WS source clients - allow different endpoints/providers simultaneously - introduce source identity and source metadata - prepare failover / redundancy / specialization by source ### v0.6.3 - introduce Yellowstone gRPC source runtime - normalize WS + gRPC source events into a shared event model - compare and reconcile overlapping data streams ### v0.6.4 - introduce source aggregation hub - merge multi-source events into a unified ingestion pipeline - prepare source-level prioritization and deduplication ### v0.7.0 - improve token-account vs mint distinction - decode more token-specific account information - improve quality of confirmed mint detection - reduce weak false candidate generation ### v0.7.1 - introduce first persistent mint candidates - introduce first persistent token-account candidates - session-to-database promotion logic ### v0.7.2 - begin real bootstrap flow persistence and tracking - correlate: - token accounts - mint accounts - bootstrap-like logs - source timing ### v0.8.0 - begin DEX-aware detection layer - identify relevant program ids for first supported DEXes - start with a small prioritized list, likely including: - Raydium - Meteora - Pump-like ecosystems - detect pool/pair creation-related activity ### v0.8.1 - add first pair / pool candidate models - begin liquidity/bootstrap/pair-side inference - distinguish token-only activity from pair/pool activity ### v0.8.2 - add market-related enrichment: - liquidity hints - price hints - pool metadata - start preparing listener outputs for trading eligibility ### v0.9.0 - begin `khbb_pattern_analyser_app` - consume persisted candidates/signals from listener - define first recurring pattern models: - mint lifetime - suspicious bootstrap - likely scam patterns - repeated naming patterns - repeated creator behavior ### v0.9.1 - pattern scoring - candidate clustering - repeated-behavior analysis across sessions ### v1.0.0 - first end-to-end listener milestone - persistent candidate ingestion - multi-source ingestion foundations - DEX-aware first detection - pattern analyser initial interoperability --- ## Future trader-oriented roadmap ### Trader preparation - define normalized outputs consumable by `khbb_trader_app` - define candidate confidence / risk / eligibility model - define basic token entry exclusion filters - define liquidity / market-cap / bootstrap safety gates ### Early trading versions - paper-trading mode first - wallet integration - transaction builder integration - buy/sell strategy primitives - time-based and price-based exits - risk caps and kill switches --- ## Cross-cutting technical TODO ### Transport / source runtime - [ ] move away from single inline WS runtime model - [ ] introduce autonomous async WS source tasks - [ ] add multi-WS support - [ ] add gRPC source runtime - [ ] unify source event interface ### Storage - [ ] persist session candidates - [ ] define candidate history tables - [ ] define mint/pool/pair tables - [ ] define source tables / provider metadata tables ### Classification / heuristics - [ ] reduce weak token-account/mint ambiguity - [ ] improve ATA detection - [ ] refine bootstrap-flow detection - [ ] correlate logs with program/account enrichment more strongly ### DEX support - [ ] define first supported DEX list - [ ] list official program ids and account models - [ ] detect pair creation events - [ ] detect liquidity initialization - [ ] enrich pool metadata ### Pattern analysis - [ ] define persistent pattern schema - [ ] score repeated token behaviors - [ ] score suspicious creators / repeated rugs / short lifetimes ### Trading - [ ] define trader input schema - [ ] define safe simulation mode - [ ] define buy filters - [ ] define sell rules - [ ] define risk management rules --- ## Notes - Current versions intentionally favored iterative validation over final architecture purity. - The current listener runtime is considered a stepping stone, not the final source-runtime model. - Candidate/correlation layers may continue to evolve before stabilizing. - Future versions may be renumbered, merged, split, or reprioritized depending on what real Solana traffic reveals.