65 lines
2.7 KiB
Markdown
65 lines
2.7 KiB
Markdown
<!-- file: README.md -->
|
||
<!-- version: 14 -->
|
||
|
||
# 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
|
||
```
|