Files
khadhroony-bot3/kb-pipeline/README.md
2026-08-03 07:24:03 +02:00

45 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!-- file: kb-pipeline/README.md -->
<!-- version: 5 -->
# kb-pipeline
`kb-pipeline` est le pipeline généraliste de `khadhroony-bot3`. Il coordonne les transports, le stockage et `kb-lib` sans dépendre dun scénario de démonstration ni dun cluster particulier.
## Responsabilités
- backfill HTTP borné ;
- insertion canonique ;
- extraction Core ;
- replay contextualisé ;
- matérialisation optionnelle et idempotente ;
- lectures stateful et corrélations ;
- préflights dexécution ;
- résolution des signers ;
- orchestration simulation-first, confirmation, soumission et postvalidation ;
- diagnostics stables exploitables par des applications ou scénarios.
Pour Metaplex Token Metadata, la crate expose les lectures stateful bornées, le préflight, la validation de readiness et lagré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
- [Guide dutilisation](USAGE.md)
- [Travaux restant à réaliser](TODO.md)
- [Historique des changements](CHANGELOG.md)
- [Architecture du pipeline](../docs/architecture/PIPELINE_ARCHITECTURE.md)