This commit is contained in:
2026-08-01 21:27:14 +02:00
parent e91d0aa2cb
commit ae85852648
38 changed files with 413 additions and 291 deletions

View File

@@ -1,10 +1,20 @@
<!-- file: README.md -->
<!-- version: 14 -->
<!-- version: 15 -->
# Khadhroony Bot3
`khadhroony-bot3` est le workspace Rust consolidé succédant à `khadhroony-bot2` pour lacquisition, le stockage, le décodage, la matérialisation, la validation et lexécution contrôlée dopérations Solana.
## Version fonctionnelle
Le workspace est aligné sur le périmètre fonctionnel de `khadhroony-bot2 0.4.6` dans la nouvelle architecture bot3. Les différences de structure sont intentionnelles : les modèles, décodeurs, exécuteurs et matérialisateurs sont consolidés dans `kb-lib`, le stockage dans `kb-store` et les transports RPC dans `kb-onchain-transport`.
Exceptions documentées :
- le registre ElGamal est implémenté avec validations synthétiques et garde-fous fail-closed, mais nest pas déclaré validé réellement sur Devnet ou Mainnet ;
- Metaplex Token Metadata possède déjà ses décodeurs dinstructions et de comptes ainsi quune matérialisation substantielle, mais son exécuteur, son orchestration complète et ses démonstrations appartiennent à `0.4.7` ;
- les améliorations structurelles de `kb-config`, `kb-logging` et `kb-store` sont reportées à `0.5.x`.
## Architecture
Le workspace contient 11 crates :
@@ -29,21 +39,13 @@ La vue détaillée est disponible dans :
- [`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 quune partie du travail `0.4.7` consacré à Metaplex Token Metadata.
Le workspace bot3 nest pas encore officiellement réaligné sur `0.4.6`. Cette décision dépend de laudit 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
Lindex 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 nest pas normative pour bot3.
Les documents historiques de bot2, bobobot et de la migration bot3 sont conservés sous `olddocs/`. Ils servent de sources historiques et ne sont pas normatifs.
## Validation générale
@@ -55,8 +57,6 @@ python3 scripts/audit_rust_workspace_rules.py
cargo test --workspace
```
Les changements documentaires purs peuvent se limiter à laudit des règles lorsque le delta ne modifie ni code ni configuration dexécution.
La validation frontend desktop seffectue uniquement avec :
```bash