v0.4.7-pre.011

kb-pipeline-demo-scenarios/USAGE.md

@@ -1,5 +1,5 @@
 <!-- file: kb-pipeline-demo-scenarios/USAGE.md -->
-<!-- version: 4 -->
+<!-- version: 6 -->
 
 # Utilisation de kb-pipeline-demo-scenarios
 
@@ -234,3 +234,47 @@ fn load_metaplex_cross_validation() -> kb_core::Result<usize> {
 ```
 
 Les cas marqués `requiresNetworkEvidence` ne peuvent pas être déclarés validés à partir de preuves synthétiques. Une simulation, une soumission ou une confirmation exige les preuves RPC déclarées par le cas.
+
+
+## Simuler une opération Metaplex réelle sur Devnet
+
+L’API réseau prend un intent Metaplex typé déjà lié aux comptes et autorités de la fixture. Le wallet persistant du profil doit être l’unique signer requis.
+
+```rust
+async fn simulate_metaplex_operation<O>(
+    pool: &kb_onchain_transport::HttpEndpointPool,
+    profile: &kb_config::ProfileConfig,
+    workspace_root: &std::path::Path,
+    operation: kb_lib::ExMetaplexTokenMetadataOperation,
+    observer: &O,
+) -> kb_core::Result<kb_pipeline_demo_scenarios::DevnetMetaplexTokenMetadataExecutionSummary>
+where
+    O: kb_pipeline_demo_scenarios::SolanaExecutionObserver,
+{
+    let request = kb_pipeline_demo_scenarios::DevnetMetaplexTokenMetadataExecutionRequest::new(
+        "metaplex-devnet-simulation",
+        operation,
+    );
+    return kb_pipeline_demo_scenarios::simulate_devnet_metaplex_token_metadata(
+        pool,
+        profile,
+        workspace_root,
+        &request,
+        observer,
+    )
+    .await;
+}
+```
+
+Pour une soumission, l’appelant doit définir `submit = true` et `operator_confirmed = true`. Les opérations dépréciées sont refusées par cette API automatique. Les lectures `preflight_reads` et `postcondition_reads` doivent décrire les comptes Metadata, Edition, Token Record ou Collection nécessaires au scénario.
+
+## Charger la matrice des 20 opérations courantes
+
+```rust
+fn load_metaplex_devnet_contract(
+) -> kb_core::Result<kb_pipeline_demo_scenarios::MetaplexTokenMetadataDevnetExecutionMatrix> {
+    return kb_pipeline_demo_scenarios::load_metaplex_token_metadata_devnet_execution_matrix();
+}
+```
+
+La matrice ne transforme jamais une implémentation disponible en validation réseau. Les valeurs restent `not_run` jusqu’à l’observation d’une simulation ou d’une confirmation réelle.