<!-- file: README.md -->
<!-- version: 17 -->

# 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.

## 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 et validation opérateur.

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).

## Capacités principales

- acquisition HTTP et WebSocket ;
- stockage PostgreSQL canonique ;
- extraction Solana Core et replay contextualisé ;
- décodeurs, matérialisateurs et exécuteurs Solana Core et SPL ;
- exécution simulation-first avec contrôle des signers, coûts, confirmations et postconditions ;
- scénarios synthétiques, campagnes réseau réutilisables et panneaux desktop ;
- couverture Metaplex Token Metadata bornée, avec parcours Devnet représentatifs réellement exécutés.

Le statut précis d’une version appartient au [`CHANGELOG.md`](CHANGELOG.md), au [`ROADMAP.md`](ROADMAP.md) et aux rapports de validation, pas au présent README généraliste.

## Documentation

- [`RULES.md`](RULES.md) : index des règles ;
- [`ROADMAP.md`](ROADMAP.md) : trajectoire fonctionnelle ;
- [`CHANGELOG.md`](CHANGELOG.md) : versions fonctionnelles clôturées ;
- [`docs/README.md`](docs/README.md) : index documentaire ;
- [`prompts/001.README.md`](prompts/001.README.md) : prompts actifs.

## 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
```

Lorsque le desktop est concerné :

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