Khadhroony Bot3

khadhroony-bot3 est un workspace Rust 2024 dédié à l’acquisition, au décodage, à la matérialisation et à l’exécution contrôlée de transactions Solana.

Architecture

Le workspace contient onze crates :

• kb-core : erreurs et primitives transversales ;
• kb-config : chargement et validation de la configuration ;
• kb-lib : modèles, décodeurs, exécuteurs et matérialisateurs ;
• kb-logging : logging et tracing ;
• kb-program-ids : registre canonique des programmes et comptes Solana ;
• kb-pipeline : pipeline généraliste de backfill, extraction, replay et orchestration ;
• kb-pipeline-demo-scenarios : scénarios synthétiques et campagnes Devnet/Testnet automatisables ;
• kb-onchain-transport : transports RPC HTTP et WebSocket ;
• kb-store : contrats de stockage et adaptateur PostgreSQL ;
• kb-wallet : frontière de wallet et signataires ;
• kb-app-demo-desktop : application Tauri de démonstration et validation opérateur.

Références :

• docs/architecture/ARCHITECTURE.md ;
• docs/architecture/CRATE_MAP.md ;
• docs/architecture/PIPELINE_ARCHITECTURE.md ;
• docs/architecture/STORAGE_ARCHITECTURE.md ;
• docs/architecture/SURFACE_CRATE_MATRIX.md.

Capacités principales

• acquisition HTTP et WebSocket ;
• stockage PostgreSQL canonique ;
• extraction Solana Core et replay contextualisé ;
• décodeurs, matérialisateurs et exécuteurs Solana Core et SPL ;
• exécution simulation-first avec contrôle des signers, coûts, confirmations et postconditions ;
• scénarios synthétiques, campagnes réseau réutilisables et panneaux desktop ;
• couverture Metaplex Token Metadata bornée, avec parcours Devnet représentatifs réellement exécutés.

Le statut précis d’une version appartient au CHANGELOG.md, au ROADMAP.md et aux rapports de validation, pas au présent README généraliste.

Documentation

• RULES.md : index des règles ;
• ROADMAP.md : trajectoire fonctionnelle ;
• CHANGELOG.md : versions fonctionnelles clôturées ;
• docs/README.md : index documentaire ;
• prompts/001.README.md : prompts actifs.

Validation générale

cargo fmt --all
cargo check --workspace
cargo clippy --all-targets
python3 scripts/audit_rust_workspace_rules.py
cargo test --workspace

Lorsque le desktop est concerné :

cargo tauri dev -c kb-app-demo-desktop/tauri.conf.json