Un fichier de portefeuille Stellar endommagé peut bloquer l'accès à vos XLM. Bonne nouvelle : les fonds sont sur la blockchain Stellar, pas dans le fichier. Si vous possédez la phrase mnémonique BIP39, la clé secrète S... ou une sauvegarde, la récupération est souvent possible. Ce guide vous explique les étapes, les outils et les précautions.

Pourquoi un fichier Stellar se corrompt-il ?

  • Arrêt brutal, coupure d'alimentation.
  • Disque dur défaillant, secteur défectueux.
  • Mise à jour interrompue de l'application.
  • Fichier JSON ou keystore mal synchronisé.
  • Malware, ransomware, nettoyage agressif.
  • Ancienne version de portefeuille devenue incompatible.
  • Erreur de mot de passe ou corruption de l'en-tête de chiffrement.

Symptômes : application qui ne s'ouvre plus, erreur de parsing JSON, clé invalide, fichier de 0 octet, message « unable to decrypt », portefeuille vide alors que vous aviez des XLM.

Comprendre ce que contient un portefeuille Stellar

Un portefeuille Stellar stocke généralement :

  • une clé publique commençant par G... ;
  • une clé secrète commençant par S... ;
  • éventuellement une phrase mnémonique de 12 ou 24 mots (souvent BIP39) ;
  • un fichier chiffré, un keystore JSON, une base SQLite ou un fichier propriétaire.

Stellar utilise des paires de clés Ed25519. Les portefeuilles HD suivent souvent le standard SEP-0005, avec un chemin de dérivation comme m/44'/148'/0'. La phrase mnémonique n'est pas stockée sur la blockchain : elle reconstruit votre clé privée. Sans elle, un fichier corrompu peut être définitif.

Règle d'or : sécurité avant tout

  1. Travaillez hors ligne si possible, sur un ordinateur propre.
  2. Ne partagez jamais votre clé secrète ou votre phrase mnémonique.
  3. Ne envoyez jamais vos fichiers à un service en ligne inconnu.
  4. Clonez le disque avant toute tentative de réparation.
  5. Utilisez uniquement des outils open source vérifiés.
  6. Testez d'abord avec un petit compte ou sur le testnet Stellar.

Un vrai service de récupération ne demandera jamais votre clé privée complète par email ou chat.

Étape 1 : identifier le type de portefeuille et le fichier concerné

Cherchez dans :

  • ~/Library/Application Support sur macOS ;
  • %APPDATA% ou %LOCALAPPDATA% sur Windows ;
  • ~/.config, ~/.stellar, ~/.local/share sur Linux ;
  • les sauvegardes iCloud, Google Drive, disques externes, anciens téléphones.

Extensions possibles : .json, .key, .dat, .sqlite, .db, .wallet, .keystore. Notez le logiciel utilisé : Stellar Desktop Client, Lobstr, Solar, StellarTerm, Ledger Live, portefeuille mobile, extension navigateur.

restaurer portefeuille XLM

Étape 2 : chercher toutes les sauvegardes et indices

Avant de réparer, cherchez :

  • la phrase mnémonique de 12/24 mots ;
  • la clé secrète S... ;
  • une capture papier, un coffre, un gestionnaire de mots de passe ;
  • un export de portefeuille, un fichier de sauvegarde ancien ;
  • des emails ou notes personnelles.

Si vous avez une partie de la phrase, ne désespérez pas. Des outils comme btcrecover/seedrecover ou des scripts basés sur BIP39 peuvent tester des combinaisons, à condition de rester hors ligne. Vérifiez que l'outil gère le chemin Stellar m/44'/148'.

Étape 3 : réparer une copie du fichier corrompu

Ne travaillez jamais sur l'original. Faites une copie et gardez l'original intact.

Fichier JSON ou keystore

cp wallet.json wallet.json.copie
jq . wallet.json.copie

Si jq signale une erreur, ouvrez la copie dans un éditeur de texte. Vérifiez les accolades, virgules, guillemets. Si le fichier est chiffré, la corruption du bloc ciphertext est souvent irréversible sans sauvegarde. Si seul le conteneur JSON est abîmé, une réparation manuelle peut suffire.

Base SQLite

sqlite3 wallet.db '.recover' > wallet_recovered.sql

Utilisez ensuite DB Browser for SQLite pour explorer les tables. Cherchez des champs comme secret, seed, key, encrypted, public.

Fichier binaire ou disque endommagé

  • Clonez le disque avec ddrescue.
  • Analysez l'image avec testdisk et photorec.
  • Utilisez strings pour extraire les chaînes lisibles : clés S..., G..., morceaux JSON.
  • Inspectez avec un éditeur hexadécimal.

Exemple :

strings -a image.dd | grep -E 'S[A-Z0-9]{55}|G[A-Z0-9]{55}'

Toute clé trouvée doit être vérifiée hors ligne avec le SDK Stellar.

récupération portefeuille Stellar

Étape 4 : restaurer avec la phrase mnémonique ou la clé secrète

Avec une phrase mnémonique

  1. Installez un portefeuille Stellar réputé ou utilisez Stellar Laboratory sur un appareil hors ligne.
  2. Choisissez « Importer / Restaurer ».
  3. Entrez les 12 ou 24 mots dans le bon ordre.
  4. Vérifiez que l'adresse publique G... correspond à votre ancien compte.
  5. Si le solde n'apparaît pas, vérifiez le chemin de dérivation m/44'/148'/0'.

Avec une clé secrète

Importez la clé S... dans StellarTerm, Lobstr, Solar ou un autre portefeuille compatible. Vérifiez immédiatement l'adresse publique.

Validation avec le SDK Python :

from stellar_sdk import Keypair
kp = Keypair.from_secret('S...')
print(kp.public_key)

Ne collez jamais cette commande sur une machine connectée si vous utilisez une vraie clé.

Étape 5 : outils avancés de récupération

  • Stellar SDK : pour valider, dériver et reconstruire des clés.
  • btcrecover / seedrecover : utile pour des phrases BIP39 partielles, selon prise en charge de Stellar.
  • Hashcat : pour tester des mots de passe sur un fichier chiffré, si le format de hachage est identifié.
  • jq, sqlite3, ddrescue, testdisk, photorec : pour la réparation et l'extraction.
  • Éditeur hexadécimal : pour repérer des structures ou des clés non chiffrées.

Attention : Pywallet et de nombreux outils Bitcoin/Ethereum ne sont pas conçus pour Stellar. Utilisez-les seulement si vous comprenez le format traité.

Cas particuliers

Ledger

Si votre Ledger est endommagé, restaurez votre phrase de récupération de 24 mots sur un autre appareil compatible. Le compte Stellar sera recréé via le chemin de dérivation standard.

Lobstr / portefeuille mobile

Cherchez la phrase de récupération dans l'application, un export, une sauvegarde iCloud/Google ou une ancienne version de l'app. Si l'app ne s'ouvre plus, récupérez les données du téléphone avec un outil forensic.

Stellar Desktop Client

restaurer portefeuille XLM

Localisez le fichier de portefeuille, copiez-le, puis tentez une restauration à partir de la clé secrète ou de la phrase mnémonique. Si le fichier est chiffré et corrompu, un mot de passe oublié peut être testé hors ligne.

Disque mort ou ransomware

Clonez le disque avant toute action. Ne payez pas de rançon. Si vous avez une sauvegarde hors ligne, restaurez-la sur une machine saine.

Prévention : éviter la perte définitive

  • Sauvegardez la phrase mnémonique sur papier et métal.
  • Utilisez plusieurs emplacements physiques séparés.
  • Chiffrez les sauvegardes numériques.
  • Testez régulièrement la restauration.
  • Ne stockez pas votre seule copie sur un seul disque.
  • Préférez un hardware wallet pour les montants importants.
  • Notez le chemin de dérivation et le type de portefeuille.

La règle 3-2-1 : 3 copies, 2 supports différents, 1 hors site.

Quand faire appel à un professionnel ?

Si vous n'avez ni phrase mnémonique, ni clé secrète, ni sauvegarde exploitable, et que le fichier chiffré est gravement corrompu, les chances diminuent fortement. Consultez un expert réputé, exigez un processus hors ligne, un devis clair et aucune communication de votre clé privée.

Pour aller plus loin, découvrez nos guides détaillés sur Récupération de Portefeuille Crypto. Vous y trouverez des méthodes vérifiées pour les phrases BIP39, les portefeuilles Bitcoin, Ethereum, Ledger, Electrum, MetaMask et bien d'autres.

FAQ rapide

Un fichier Stellar corrompu signifie-t-il que mes XLM sont perdus ?
Non, si vous pouvez reconstruire la clé privée via une phrase mnémonique, une clé secrète ou une sauvegarde.

Puis-je récupérer une clé secrète à partir d'une adresse publique ?
Non. L'adresse G... ne permet pas de retrouver la clé S....

Puis-je utiliser Hashcat sur un fichier Stellar ?
Seulement si vous identifiez précisément le format de chiffrement et le mode de hachage compatible.

Combien de mots contient une phrase Stellar ?
Souvent 12 ou 24 mots BIP39, selon le portefeuille.

Que faire en premier ?
Arrêtez d'écrire sur le disque, faites une copie, puis cherchez toute sauvegarde ou phrase mnémonique.


Ce guide est fourni à titre éducatif. Manipulez toujours vos clés dans un environnement sécurisé et hors ligne.