khadhroony-bot3/README.md

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/CRATE_MAP.md ;
• docs/architecture/PIPELINE_ARCHITECTURE.md ;
• docs/architecture/STORAGE_ARCHITECTURE.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.

Les règles normatives commencent dans RULES.md. Les règles spécialisées sont placées sous 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

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 :

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