Sasedev/khadhroony-bot3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v0.4.7-pre.011

Browse Source
This commit is contained in:
SinuS von SifriduS
2026-08-03 07:24:03 +02:00
parent e8a744828f
commit 4b727e2990
30 changed files with 2565 additions and 286 deletions
Download Patch File Download Diff File Expand all files Collapse all files

52
kb-pipeline/README.md
View File

@@ -1,36 +1,44 @@
<!-- file: kb-pipeline/README.md -->
<!-- version: 3 -->
<!-- version: 5 -->
# kb-pipeline
`kb-pipeline` orchestre les traitements on-chain de `khadhroony-bot3`.
`kb-pipeline` est le pipeline généraliste de `khadhroony-bot3`. Il coordonne les transports, le stockage et `kb-lib` sans dépendre d’un scénario de démonstration ni d’un cluster particulier.
## 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 et Metaplex Token Metadata, 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 ;
- insertion canonique ;
- extraction Core ;
- decode replay ;
- inspections stateful Solana Core, SPL Token, ATA, Token-2022 et registre ElGamal ;
- préflights stateful et orchestrations d’exécution Token-2022 et Metaplex Token Metadata.
- replay contextualisé ;
- matérialisation optionnelle et idempotente ;
- lectures stateful et corrélations ;
- préflights d’exécution ;
- résolution des signers ;
- orchestration simulation-first, confirmation, soumission et postvalidation ;
- diagnostics stables exploitables par des applications ou scénarios.
Voir [USAGE.md](USAGE.md) pour les contrats publics.
Pour Metaplex Token Metadata, la crate expose les lectures stateful bornées, le préflight, la validation de readiness et l’agrégation des postconditions. Elle ne contient ni fixture Devnet, ni wallet de démonstration, ni séquence métier spécifique à un test.
## Surface publique principale
- campagnes de backfill et progression ;
- extraction Core et decode replay ;
- inspections stateful Solana Core et SPL ;
- `read_metaplex_token_metadata_stateful_account` ;
- `inspect_metaplex_token_metadata_preflight` ;
- `validate_metaplex_token_metadata_execution_readiness` ;
- `summarize_metaplex_token_metadata_postconditions`.
Voir [USAGE.md](USAGE.md) pour les exemples et invariants.
## Relations avec le workspace
La crate coordonne `kb-onchain-transport`, `kb-store`, `kb-lib`, `kb-core` et `kb-program-ids`. Elle ne dépend jamais de `kb-pipeline-demo-scenarios` ni de `kb-app-demo-desktop`.
## Documentation
- [USAGE.md](USAGE.md)
- [TODO.md](TODO.md)
- [CHANGELOG.md](CHANGELOG.md)
- [Guide d’utilisation](USAGE.md)
- [Travaux restant à réaliser](TODO.md)
- [Historique des changements](CHANGELOG.md)
- [Architecture du pipeline](../docs/architecture/PIPELINE_ARCHITECTURE.md)
- [Architecture du stockage](../docs/architecture/STORAGE_ARCHITECTURE.md)