v0.4.7-pre.011

kb-lib/USAGE.md

@@ -1,5 +1,5 @@
 <!-- file: kb-lib/USAGE.md -->
-<!-- version: 5 -->
+<!-- version: 7 -->
 
 # Utilisation de kb-lib
 
@@ -117,7 +117,6 @@ println!("edition parent={:?}", edition.parent);
 
 Les signatures exactes doivent être vérifiées lors de l’utilisation : certaines familles exigent un contexte ou une identité canonique supplémentaire.
 
-
 ## Exécution typée
 
 `ExApiTypedInstructionExecutor` produit un `ExApiPreparedExecutionPlan` à partir d’une intention et d’une politique explicites. Les exécuteurs concrets incluent notamment :
@@ -157,6 +156,22 @@ println!("required_signers={}", plan.required_signers.len());
 
 Memo v1 et v3 restent non exécutables. Memo v4 est la seule génération exécutable.
 
+## Exécution Metaplex Token Metadata
+
+La surface publique repose sur :
+
+- `ExMetadataMetaplexTokenMetadataExecutor` ;
+- `ExMetaplexTokenMetadataExecutionIntent` ;
+- `ExMetaplexTokenMetadataOperation` ;
+- les constantes `EX_METAPLEX_TOKEN_METADATA_*_OPERATION` ;
+- `EX_METAPLEX_TOKEN_METADATA_SUPPORTED_OPERATION_CODES` et `EX_METAPLEX_TOKEN_METADATA_DEPRECATED_OPERATION_CODES`.
+
+Le consommateur construit un intent typé, puis appelle `ExApiTypedInstructionExecutor::build_prepared_plan`. Le plan retourné contient les instructions, comptes et signers requis, mais n’effectue ni simulation ni envoi.
+
+Les opérations courantes utilisent leur wrapper canonique final. Les versions remplacées ne possèdent pas de builder public distinct. Les opérations obsolètes encore constructibles exigent que l’intent autorise explicitement l’exécution dépréciée ; leurs variantes Rust sont marquées `#[deprecated]`.
+
+Avant utilisation du plan, le consommateur doit transmettre celui-ci au préflight et à l’orchestration de `kb-pipeline`.
+
 ## Sécurité
 
 Les types `ExSafetyChecker`, `ExSafetyDecision`, `ExSafetyEvaluation` et `ExSafetyViolation` permettent d’évaluer un plan avant son utilisation. Une décision conservatrice doit être respectée par le consommateur ; elle ne doit pas être contournée par l’application.