khadhroony-bot3/README.md

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.

Version en développement

La version active est 0.4.7, consacrée à l’achèvement de Metaplex Token Metadata.

Les contrats de décodage, les comptes, les matérialisations, les 35 opérations officiellement constructibles, l’orchestration généraliste, les scénarios synthétiques et le panneau desktop sont présents. La clôture est repoussée jusqu’à la réalisation des campagnes Devnet des 20 opérations courantes non dépréciées.

Le registre ElGamal reste une exception indépendante : il est implémenté et validé synthétiquement, mais n’est pas déclaré validé réellement sur Devnet ou Mainnet.

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, avec scénarios UI conservés dans le desktop.

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.

Documentation

• RULES.md : index des règles ;
• ROADMAP.md : objectifs par version fonctionnelle ;
• CHANGELOG.md : historique des versions fonctionnelles clôturées ;
• docs/README.md : index documentaire ;
• prompts/027_v0_4_7_metaplex_token_metadata_completion.md : prompt actif de 0.4.7.

Validation générale

La validation finale d’une version utilise :

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