v0.4.7-pre.013

kb-app-demo-desktop/USAGE.md

@@ -1,5 +1,5 @@
 <!-- file: kb-app-demo-desktop/USAGE.md -->
-<!-- version: 2 -->
+<!-- version: 4 -->
 
 # Utilisation de kb-app-demo-desktop
 
@@ -194,6 +194,36 @@ console.log(scenarios);
 
 La simulation et l’envoi doivent rester explicitement distingués dans les requêtes.
 
+### 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`.
+
+```typescript
+const operationJson = await invoke(
+  "demo_execution_metadata_operation_template",
+  { operation: "verify" }
+);
+
+const summary = await invoke(
+  "demo_execution_metadata_execute",
+  {
+    request: {
+      profileName: "devnet",
+      intentId: `desktop-metaplex-${Date.now()}`,
+      operationJson,
+      preflightReadsJson: "[]",
+      postconditionReadsJson: "[]",
+      submit: false,
+      operatorConfirmed: false
+    }
+  }
+);
+
+console.log(summary);
+```
+
+Les valeurs `<...>` d’un modèle doivent être remplacées par des comptes réels avant exécution. `submit: true` exige simultanément `operatorConfirmed: true`. Le résultat distingue le plan, le préflight stateful, la simulation RPC, la signature éventuelle, la confirmation et les états avant/après.
+
 ### Diagnostics PostgreSQL
 
 ```typescript
@@ -258,3 +288,7 @@ Depuis la fenêtre principale, choisir **Exécution Devnet → Exécution Metada
 Un contrat marqué Devnet n’est pas, à lui seul, une exécution réseau. Les champs `networkExecutionPerformed` et `networkEvidenceCollected` doivent rester faux tant qu’aucun appel RPC réel et aucune preuve correspondante n’ont été produits.
 
 Les commandes de simulation et de soumission Metaplex seront documentées ici après leur raccordement effectif pendant `0.4.7-pre.013`.
+
+### 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.