v0.4.8-pre.012

docs/validation/V0_4_8_PRE_012_TOKEN_2022_METADATA_DEVNET_VALIDATION_REPORT.md

@@ -0,0 +1,83 @@
+<!-- file: docs/validation/V0_4_8_PRE_012_TOKEN_2022_METADATA_DEVNET_VALIDATION_REPORT.md -->
+<!-- version: 1 -->
+
+# Validation Devnet `0.4.8-pre.012` — Token-2022 Token Metadata
+
+## Statut
+
+**Préparée, non exécutée.**
+
+Aucune signature, aucun slot et aucune postcondition réseau ne sont préremplis dans ce rapport. La preuve synthétique ou la seule réussite des tests locaux ne doit pas être présentée comme une validation Devnet confirmée.
+
+## Périmètre réseau
+
+Program ID :
+
+```text
+TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
+```
+
+Campagne ordonnée :
+
+1. `InitializeTokenMetadata` ;
+2. `UpdateTokenMetadataField` ;
+3. `EmitTokenMetadata` ;
+4. `RemoveTokenMetadataKey` ;
+5. `UpdateTokenMetadataAuthority`.
+
+La préparation crée un mint Token-2022 frais avec `MetadataPointer` auto-référent, préfinancé pour les réallocations de metadata atteintes pendant la campagne.
+
+## Matrice initiale
+
+| Scénario                               | Statut initial | Preuve réseau |
+|----------------------------------------|----------------|---------------|
+| `token_2022_metadata_initialize`       | `not_run`      | aucune        |
+| `token_2022_metadata_update_field`     | `not_run`      | aucune        |
+| `token_2022_metadata_emit`             | `not_run`      | aucune        |
+| `token_2022_metadata_remove_key`       | `not_run`      | aucune        |
+| `token_2022_metadata_update_authority` | `not_run`      | aucune        |
+
+Source machine-readable : `test-fixtures/contract-matrices/SPL_TOKEN_2022_METADATA_DEVNET_VALIDATION_MATRIX.json`.
+
+## Commande opérateur
+
+Après les validations locales de compilation :
+
+```bash
+KB_DEVNET_TOKEN_2022_METADATA_CAMPAIGN_TEST=1 \
+KB_DEVNET_TOKEN_2022_METADATA_OPERATOR_CONFIRMED=1 \
+KB_POSTGRES_TEST_URL='postgresql://…' \
+cargo test -p kb-pipeline-demo-scenarios optional_devnet_token_2022_metadata_campaign_from_env -- --nocapture
+```
+
+`KB_DEVNET_PROFILE` permet de sélectionner un profil précis ; `KB_DEVNET_CONFIG_PATH` permet de remplacer le fichier de configuration par défaut.
+
+## Preuves à enregistrer
+
+Pour les quatre mutations :
+
+- simulation réussie ;
+- signature ;
+- confirmation et slot ;
+- hydratation canonique ;
+- extraction Core ;
+- replay Token-2022 ;
+- matérialisation instructionnelle Token Metadata ;
+- postcondition stateful ;
+- seconde passe d'idempotence.
+
+Pour `Emit` :
+
+- simulation réussie ;
+- `returnData` et longueur décodée ;
+- signature ;
+- confirmation et slot ;
+- hydratation canonique ;
+- extraction Core ;
+- replay Token-2022 ;
+- postcondition stateful comparée au contenu décodé ;
+- seconde passe d'idempotence.
+
+## Résultat attendu
+
+La campagne est considérée validée uniquement si les cinq étapes sont confirmées et si leurs postconditions sont `Confirmed`. Après exécution, ce rapport et la matrice doivent être mis à jour avec les preuves réellement observées ; aucune valeur ne doit être reconstruite ou inventée.