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 douze crates :
ks-core: erreurs et primitives transversales ;ks-config: chargement et validation de la configuration ;ks-lib: modèles, décodeurs, exécuteurs et matérialisateurs ;ks-logging: logging et tracing ;ks-program-ids: registre canonique des programmes et comptes Solana ;ks-pipeline: pipeline généraliste de backfill, extraction, replay et orchestration ;ks-pipeline-demo-scenarios: scénarios synthétiques et campagnes Devnet/Testnet automatisables ;ks-onchain-transport: transports RPC HTTP et WebSocket ;ks-store: contrats de stockage et adaptateur PostgreSQL ;ks-wallet: frontière de wallet et signataires ;ks-wallet-demo-scenarios: scénarios réutilisables de validation du cycle de vie et des formats wallet ;kb-app-demo-desktop: application Tauri de démonstration et validation opérateur.
La série 0.5.x prépare la séparation explicite entre le domaine applicatif khadhroony-bot et les bibliothèques généralistes khadhroony-solana. Depuis 0.5.1, les dix crates généralistes issues de la migration utilisent les noms ks-* / ks_*. 0.5.2 ajoute ks-wallet-demo-scenarios comme onzième crate généraliste, tandis que kb-app-demo-desktop conserve son nom et reste une application du workspace Bot. Le workspace, le dépôt et le répertoire racine restent nommés khadhroony-bot3 pendant cette migration et ne doivent pas être renommés avant 1.0 ou une version ultérieure explicitement dédiée. La politique de migration est définie dans docs/decisions/KHADHROONY_SOLANA_NAMESPACE_POLICY.md.
Depuis 0.5.1, les contrats de configuration source/runtime susceptibles de contenir des secrets restent backend-only et ne sont ni sérialisables ni Debug par défaut. Les crates ks-config et ks-lib ne génèrent plus de bindings TS-RS ; les surfaces TypeScript/Tauri sont possédées par les applications via des DTO explicites.
Depuis 0.5.2, ks-wallet gère plusieurs wallets persistants .kswallet protégés par mot de passe, la migration/import/export de keypairs Solana et une capacité de signature sans exposition du secret. Les validations réutilisables du cycle de mot de passe sont isolées dans ks-wallet-demo-scenarios. Le guide opérationnel est docs/guides/WALLETS.md.
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é en développement :
cargo tauri dev -c kb-app-demo-desktop/tauri.conf.json
Pour un build desktop de release :
cargo tauri build -c kb-app-demo-desktop/tauri.conf.json
Les scripts npm run dev et npm run build ne sont pas lancés directement : Tauri les pilote via sa configuration.