v0.5.2-pre.006-fix-004

ks-wallet/USAGE.md

@@ -1,5 +1,5 @@
 <!-- file: ks-wallet/USAGE.md -->
-<!-- version: 11 -->
+<!-- version: 12 -->
 
 # Utilisation de ks-wallet
 
@@ -317,6 +317,27 @@ println!("pubkey={}", handle.public_key());
 
 La matrice des formats vérifiés et reportés est maintenue dans [`../docs/WALLET_FORMAT_COMPATIBILITY.md`](../docs/WALLET_FORMAT_COMPATIBILITY.md).
 
+### Inspecter un keypair externe sans l'importer
+
+```rust
+let inspection = match ks_wallet::inspect_transfer_file(
+    source_path,
+    ks_wallet::WalletTransferFormat::SolanaCliJson,
+)
+.await
+{
+    std::result::Result::Ok(value) => value,
+    std::result::Result::Err(error) => {
+        return std::result::Result::Err(error);
+    },
+};
+println!("pubkey={}", inspection.public_key());
+```
+
+`inspect_transfer_file()` applique les mêmes validations bornées que l'import mais ne crée aucun `.kswallet`. Le résultat ne contient que la pubkey dérivée et le format explicitement sélectionné. `WalletTransferFormat::supported()` fournit la liste compilée des formats afin qu'un consommateur n'ait pas à maintenir une seconde matrice.
+
+Cette inspection confirme uniquement qu'un fichier contient un keypair Solana valide dans le format choisi. Le wire secret ne permet pas de déduire de manière fiable le rôle historique de la clé (`wallet`, `mint`, `authority`, `recipient`, etc.).
+
 ### Migrer un legacy `<alias>.json`
 
 ```rust