# Khadhroony Bot3 `khadhroony-bot3` est le workspace Rust consolidé succédant à `khadhroony-bot2` pour l’acquisition, le stockage, le décodage, la matérialisation, la validation et l’exécution contrôlée d’opérations Solana. ## Architecture Le workspace contient 11 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 des programmes et comptes Solana connus ; - `kb-pipeline` : backfill, extraction Core, replay et orchestration ; - `kb-pipeline-demo-scenarios` : bibliothèque de scénarios et CLI ; - `kb-onchain-transport` : transports RPC HTTP et WebSocket ; - `kb-store` : contrats de stockage et adaptateur PostgreSQL ; - `kb-wallet` : frontière de wallet et signataires, encore incomplète ; - `kb-app-demo-desktop` : bibliothèque et application Tauri de démonstration. La vue détaillée est disponible dans : - [`docs/architecture/ARCHITECTURE.md`](docs/architecture/ARCHITECTURE.md) ; - [`docs/architecture/CRATE_MAP.md`](docs/architecture/CRATE_MAP.md) ; - [`docs/architecture/PIPELINE_ARCHITECTURE.md`](docs/architecture/PIPELINE_ARCHITECTURE.md) ; - [`docs/architecture/STORAGE_ARCHITECTURE.md`](docs/architecture/STORAGE_ARCHITECTURE.md) ; - [`docs/architecture/SURFACE_CRATE_MATRIX.md`](docs/architecture/SURFACE_CRATE_MATRIX.md). ## État fonctionnel La migration a repris un périmètre proche de `khadhroony-bot2 v0.4.6`, ainsi qu’une partie du travail `0.4.7` consacré à Metaplex Token Metadata. Le workspace bot3 n’est pas encore officiellement réaligné sur `0.4.6`. Cette décision dépend de l’audit ciblé prévu dans `docs/V0_4_6_ALIGNMENT_AUDIT.md`. Le registre ElGamal ne doit pas être présenté comme validé sur Devnet ou Mainnet. ## Documentation L’index actif se trouve dans [`docs/README.md`](docs/README.md). Les règles normatives commencent dans [`RULES.md`](RULES.md). Les règles spécialisées sont placées sous [`docs/rules/`](docs/rules/). La documentation historique bot2 est conservée sous `olddocs/archivekbot2/`. Elle sert de source historique et n’est pas normative pour bot3. ## Validation générale ```bash cargo fmt --all cargo check --workspace cargo clippy --all-targets python3 scripts/audit_rust_workspace_rules.py cargo test --workspace ``` Les changements documentaires purs peuvent se limiter à l’audit des règles lorsque le delta ne modifie ni code ni configuration d’exécution. La validation frontend desktop s’effectue uniquement avec : ```bash cargo tauri dev -c kb-app-demo-desktop/tauri.conf.json ```