65 lines
2.8 KiB
Markdown
65 lines
2.8 KiB
Markdown
<!-- file: README.md -->
|
||
<!-- version: 16 -->
|
||
|
||
# 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/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).
|
||
|
||
## Documentation
|
||
|
||
- [`RULES.md`](RULES.md) : index des règles ;
|
||
- [`ROADMAP.md`](ROADMAP.md) : objectifs par version fonctionnelle ;
|
||
- [`CHANGELOG.md`](CHANGELOG.md) : historique des versions fonctionnelles clôturées ;
|
||
- [`docs/README.md`](docs/README.md) : index documentaire ;
|
||
- [`prompts/027_v0_4_7_metaplex_token_metadata_completion.md`](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 :
|
||
|
||
```bash
|
||
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é :
|
||
|
||
```bash
|
||
cargo tauri dev -c kb-app-demo-desktop/tauri.conf.json
|
||
```
|