v0.4.8-pre.010

kb-app-demo-desktop/USAGE.md

@@ -1,5 +1,5 @@
 <!-- file: kb-app-demo-desktop/USAGE.md -->
-<!-- version: 6 -->
+<!-- version: 9 -->
 
 # Utilisation de kb-app-demo-desktop
 
@@ -207,16 +207,18 @@ La simulation et l’envoi doivent rester explicitement distingués dans les req
 
 ### Exécution Metadata Devnet
 
-Le panneau Metadata charge les opérations courantes depuis `demo_execution_metadata_current_operations` et peut demander un modèle avec `demo_execution_metadata_operation_template`.
+Le backend distingue le module commun Metadata, Metaplex Token Metadata et Solana Program Metadata.
+
+Le panneau Metadata charge les opérations courantes depuis `demo_execution_metadata_metaplex_token_metadata_current_operations` et peut demander un modèle avec `demo_execution_metadata_metaplex_token_metadata_operation_template`.
 
 ```typescript
 const operationJson = await invoke(
-  "demo_execution_metadata_operation_template",
+  "demo_execution_metadata_metaplex_token_metadata_operation_template",
   { operation: "verify" }
 );
 
 const summary = await invoke(
-  "demo_execution_metadata_execute",
+  "demo_execution_metadata_metaplex_token_metadata_execute",
   {
     request: {
       profileName: "devnet",
@@ -303,3 +305,23 @@ Le panneau distingue préparation de l’étape, simulation exacte et soumission
 ### Préparation de la fixture Metaplex `Create`
 
 Le panneau desktop peut créer ou réutiliser un mint SPL classique Devnet à zéro décimale. Le préparateur dérive ensuite automatiquement les PDA `metadata` et `master edition` et génère un intent `Create` typé. Les valeurs entre chevrons des modèles génériques restent des placeholders non exécutables.
+
+### Campagne Solana Program Metadata
+
+Ouvrir l’accordéon **Solana Program Metadata**, sélectionner un profil Devnet persistant et préparer sa base. L’inventaire affiche deux parcours totalisant neuf opérations :
+
+```text
+Buffer   : Allocate → Extend → Write → SetAuthority → Trim → Close
+Metadata : Initialize → SetData → SetImmutable
+```
+
+Après confirmation explicite, le bouton **Exécuter la campagne complète** appelle le runner réutilisable. Celui-ci réalise deux transferts de préfinancement, puis les neuf simulations et soumissions dans l’ordre. Le panneau affiche :
+
+- la fixture et les opérations préparées ;
+- les signatures de préfinancement et les PDA frais ;
+- les neuf simulations et confirmations ;
+- les lectures stateful avant/après ;
+- les rapports de postcondition ;
+- les snapshots matérialisés, sauf pour `Close` qui exige l’absence du compte.
+
+La campagne s’arrête au premier échec. Elle ne reprend pas un parcours partiellement exécuté et ne réutilise pas les PDA d’une campagne précédente.