v0.4.7-pre.011
This commit is contained in:
@@ -1,23 +1,20 @@
|
||||
<!-- file: kb-pipeline/CHANGELOG.md -->
|
||||
<!-- version: 12 -->
|
||||
<!-- version: 14 -->
|
||||
|
||||
# CHANGELOG — kb-pipeline
|
||||
|
||||
## 0.4.7-pre.007-delta-fix-001 — correction et documentation de l’API Metaplex
|
||||
## 0.4.7-pre.011 — réouverture des validations réseau
|
||||
|
||||
- ajout de la rustdoc manquante sur les paramètres de dérivation des comptes edition et token record ;
|
||||
- correction du test de préflight utilisant le code stable de `PuffMetadata` ;
|
||||
- ajout d’exemples d’utilisation des lectures stateful, du préflight, de l’orchestration simulation-first et des postconditions Metaplex.
|
||||
### Documentation
|
||||
|
||||
## 0.4.7-pre.007
|
||||
- réorganisation des quatre documents de crate ;
|
||||
- clarification que les campagnes Devnet appartiennent à `kb-pipeline-demo-scenarios`, tandis que `kb-pipeline` reste généraliste et indépendant des scénarios.
|
||||
|
||||
- ajout des lectures stateful bornées Metaplex Token Metadata ;
|
||||
- ajout du préflight, de l’orchestration simulation-first et des postconditions explicites.
|
||||
## 0.4.7-pre.007 — orchestration Metaplex généraliste
|
||||
|
||||
## 0.4.7-pre.003-delta-fix-002 — dette de compatibilité des exécuteurs
|
||||
|
||||
- ajout d’un TODO de réaudit de l’orchestration après extension future des exécuteurs Solana Core/SPL aux opérations obsolètes encore constructibles ;
|
||||
- exigence de propager les avertissements de dépréciation et l’approbation opérateur sans réintroduire les versions remplacées intermédiaires.
|
||||
- ajout des lectures stateful bornées, du préflight, de l’orchestration simulation-first et des postconditions ;
|
||||
- correction de la rustdoc et ajout d’exemples publics ;
|
||||
- ajout des diagnostics de dépréciation et de l’approbation opérateur.
|
||||
|
||||
## 0.4.6
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -1,25 +1,19 @@
|
||||
<!-- file: kb-pipeline/TODO.md -->
|
||||
<!-- version: 8 -->
|
||||
<!-- version: 10 -->
|
||||
|
||||
# TODO — kb-pipeline
|
||||
|
||||
## `0.4.7`
|
||||
|
||||
- [x] Metaplex Token Metadata - intégrer les lectures stateful bornées, le préflight et l’orchestration simulation-first généraliste.
|
||||
- [x] Metaplex Token Metadata - ajouter la résolution des signers, les diagnostics de dépréciation et les postconditions explicites.
|
||||
- [ ] Metaplex Token Metadata - compléter en `pre.008` les fixtures et campagnes Devnet/Testnet dans `kb-pipeline-demo-scenarios`.
|
||||
|
||||
## Réaudit ultérieur des surfaces historiques
|
||||
|
||||
- [ ] Version à déterminer - après le réaudit des exécuteurs Solana Core et SPL dans `kb-lib`, vérifier que `kb-pipeline` orchestre sans filtrage implicite les opérations courantes et les opérations obsolètes explicitement approuvées.
|
||||
- [ ] Préflight et diagnostics - propager les statuts de remplacement canonique, les avertissements de dépréciation et l’approbation opérateur exigée par les builders obsolètes.
|
||||
- [ ] Tests - ajouter les cas pipeline nécessaires pour les opérations dépréciées réintroduites, sans créer de chemins d’exécution pour les versions remplacées intermédiaires.
|
||||
- [ ] Version à déterminer - après le réaudit des exécuteurs Solana Core et SPL dans `kb-lib`, vérifier que le pipeline orchestre sans filtrage implicite les opérations courantes et les opérations obsolètes explicitement approuvées.
|
||||
- [ ] Préflight et diagnostics - propager les remplacements canoniques, avertissements de dépréciation et approbations opérateur des surfaces réauditées.
|
||||
- [ ] Tests - ajouter les cas pipeline nécessaires aux opérations dépréciées réintroduites, sans créer de chemin pour les versions remplacées intermédiaires.
|
||||
|
||||
## Versions ultérieures
|
||||
|
||||
- [ ] Dette technique - auditer les duplications résiduelles entre orchestrations SPL Token classique et Token-2022.
|
||||
- [ ] Dette technique - auditer les duplications résiduelles entre les orchestrations SPL Token classique et Token-2022.
|
||||
|
||||
## Report conditionnel — registre ElGamal
|
||||
|
||||
- [ ] Réseau - confirmer l’existence et le déploiement du programme avant toute campagne.
|
||||
- [ ] Réseau - confirmer l’existence et le déploiement du programme avant toute campagne réelle.
|
||||
- [ ] Intégration - compléter uniquement les couches justifiées par un scénario réellement exécutable.
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
<!-- file: kb-pipeline/USAGE.md -->
|
||||
<!-- version: 4 -->
|
||||
<!-- version: 5 -->
|
||||
|
||||
# Utilisation de kb-pipeline
|
||||
|
||||
|
||||
Reference in New Issue
Block a user