38 lines
2.5 KiB
Markdown
38 lines
2.5 KiB
Markdown
<!-- file: kb-pipeline-demo-scenarios/README.md -->
|
||
<!-- version: 7 -->
|
||
|
||
# kb-pipeline-demo-scenarios
|
||
|
||
`kb-pipeline-demo-scenarios` fournit des scénarios synthétiques et des campagnes Devnet/Testnet automatisables au-dessus de `kb-pipeline`.
|
||
|
||
La crate contient :
|
||
|
||
- la bibliothèque Rust `kb_pipeline_demo_scenarios` ;
|
||
- le binaire ciblé `kb-pipeline-demo-scenarios-cli`.
|
||
|
||
## Responsabilités
|
||
|
||
- préparer les profils, comptes et fixtures nécessaires aux campagnes de test ;
|
||
- exécuter des scénarios synthétiques déterministes ;
|
||
- exécuter des campagnes réseau explicites avec simulation ou soumission contrôlée ;
|
||
- produire des résultats structurés et des preuves vérifiables ;
|
||
- fournir des tests automatisés parallèles aux démonstrations UI, sans déplacer les scénarios UI hors du desktop ;
|
||
- conserver la séparation entre preuve synthétique, simulation RPC, soumission confirmée et postcondition stateful.
|
||
|
||
La crate couvre déjà les scénarios Solana Core et SPL historiques ainsi que le corpus synthétique Metaplex pour NFT, SFT, token fongible, collection et pNFT. Un exécuteur Devnet réel et réutilisable est disponible pour les opérations Metaplex courantes pilotées par un seul wallet de profil. Il réalise le contrôle du genesis hash, les lectures stateful bornées, le préflight, la simulation RPC exacte et, après confirmation explicite, la soumission, la confirmation et les lectures avant/après. Le runner Devnet sait construire les opérations courantes, tandis que les parcours réellement préparés fournissent leurs fixtures, preuves RPC et postconditions. Les validations spécialisées restent qualifiées séparément au lieu d’être déduites de la seule présence d’un builder.
|
||
|
||
## Binaire CLI
|
||
|
||
Le CLI a été introduit pour les préparations de fixtures qui nécessitent une commande autonome, notamment Token-2022. Il n’est pas l’interface générale obligatoire de tous les scénarios. Une commande Metaplex ne doit être ajoutée que si une préparation de fixture ne peut pas être réalisée proprement par les tests ou APIs existantes.
|
||
|
||
## Relations avec le workspace
|
||
|
||
La crate dépend du pipeline généraliste. `kb-pipeline` ne dépend jamais d’elle. Le desktop peut réutiliser ses contrats, mais conserve ses propres scénarios UI Devnet/Testnet.
|
||
|
||
## Documentation
|
||
|
||
- [Guide d’utilisation](USAGE.md)
|
||
- [Travaux restant à réaliser](TODO.md)
|
||
- [Historique des changements](CHANGELOG.md)
|
||
- [Architecture du pipeline](../docs/architecture/PIPELINE_ARCHITECTURE.md)
|