v0.1.0-pre.070

kb-pipeline/README.md

@@ -0,0 +1,36 @@
+<!-- file: kb-pipeline/README.md -->
+<!-- version: 1 -->
+
+# kb-pipeline
+
+`kb-pipeline` orchestre les traitements on-chain de `khadhroony-bot3`.
+
+## Responsabilités
+
+- backfill HTTP borné ;
+- extraction des transactions canoniques vers le modèle Core ;
+- replay contextualisé des décodeurs ;
+- matérialisation optionnelle et idempotente ;
+- préflights et inspections stateful ;
+- orchestration Token-2022, preuves et postconditions ;
+- corrélation entre instructions observées et états finaux.
+
+La crate coordonne `kb-onchain-transport`, `kb-store`, `kb-lib`, `kb-core` et `kb-program-ids`. Elle ne contient pas l’interface desktop ni les scénarios opérateur de démonstration.
+
+## Familles publiques
+
+- backfill ;
+- extraction Core ;
+- decode replay ;
+- inspections stateful Solana Core, SPL Token, ATA, Token-2022 et registre ElGamal ;
+- préflight cryptographique et orchestration d’exécution Token-2022.
+
+Voir [USAGE.md](USAGE.md) pour les contrats publics.
+
+## Documentation
+
+- [USAGE.md](USAGE.md)
+- [TODO.md](TODO.md)
+- [CHANGELOG.md](CHANGELOG.md)
+- [Architecture du pipeline](../docs/architecture/PIPELINE_ARCHITECTURE.md)
+- [Architecture du stockage](../docs/architecture/STORAGE_ARCHITECTURE.md)