Avertissement légal et sécurité : ce guide est destiné uniquement à la récupération de votre propre portefeuille ou d’un portefeuille pour lequel vous disposez d’une autorisation écrite explicite. Ne tentez jamais de déchiffrer un fichier qui ne vous appartient pas. Travaillez hors ligne, sur une copie, dans une machine virtuelle isolée, et ne partagez jamais vos clés privées ou votre phrase de récupération.

Pywallet est un outil open source historique utilisé pour analyser les fichiers wallet.dat de Bitcoin Core. Il permet notamment de lister les adresses, d’extraire des clés privées et, lorsque le mot de passe est connu, de déchiffrer les données d’un portefeuille protégé. Attention : Pywallet ne devine pas votre mot de passe. Il applique le déchiffrement si vous fournissez la bonne phrase secrète. Pour retrouver un mot de passe oublié, il faut d’abord passer par une phase de récupération hors ligne avec des outils comme btcrecover ou HashCat, puis utiliser Pywallet pour finaliser l’extraction.

Sur Récupération de Portefeuille Crypto, nous consacrons des guides détaillés à la récupération de portefeuilles Bitcoin, Ethereum et autres crypto-actifs : mots de passe oubliés, phrases BIP39 partielles, fichiers endommagés, sauvegardes perdues et bonnes pratiques de sécurité. Cet article se concentre sur le cas précis de wallet.dat et de Pywallet.

1. Comprendre ce que Pywallet peut vraiment faire

Un fichier wallet.dat Bitcoin Core est généralement une base de données Berkeley DB contenant des paires de clés, des adresses, des métadonnées et parfois une clé maîtresse chiffrée. Lorsque le portefeuille est chiffré, Bitcoin Core protège les clés privées avec un chiffrement symétrique de type AES-256-CBC, la clé maîtresse étant elle-même chiffrée à partir de votre phrase secrète via une fonction de dérivation. Pywallet sait lire cette structure et peut :

  • afficher les adresses et les clés publiques ;
  • extraire les clés privées non chiffrées ou déchiffrées ;
  • produire un export JSON exploitable ;
  • faciliter la migration vers un autre portefeuille.

Pywallet ne remplace pas une solution de récupération de mot de passe. Si vous avez oublié votre phrase secrète, le déchiffrement direct échouera. Il faut d’abord retrouver le mot de passe par dictionnaire, masque ou règles de mutation, dans un environnement hors ligne, puis revenir à Pywallet avec le mot de passe correct.

2. Prérequis et précautions indispensables

Avant toute manipulation :

  1. Sauvegardez le fichier original et travaillez uniquement sur une copie.
  2. Isodez la machine : réseau coupé, machine virtuelle dédiée, snapshot avant exécution.
  3. Vérifiez la source de Pywallet : téléchargez depuis un dépôt reconnu, comparez le commit et évitez les binaires non vérifiés.

récupération portefeuille Bitcoin

  1. Contrôlez l’intégrité de la copie avec une empreinte SHA-256.
  2. Ne saisissez jamais votre phrase secrète dans un terminal connecté à Internet si vous pouvez l’éviter.

Pywallet est un outil ancien, souvent basé sur Python 2.7 et Berkeley DB. Selon votre système, il peut être nécessaire d’utiliser une version maintenue, un conteneur dédié ou une machine virtuelle Linux. Les dépendances typiques sont bsddb3, pycrypto ou pycryptodome, et ecdsa.

Exemple de préparation d’une copie de travail :

mkdir -p ~/recuperation-wallet
cp /chemin/vers/wallet.dat ~/recuperation-wallet/wallet.dat
sha256sum ~/recuperation-wallet/wallet.dat > ~/recuperation-wallet/empreinte.txt

3. Analyser le portefeuille avec Pywallet

Placez-vous dans le dossier contenant Pywallet et la copie de wallet.dat. Une première analyse peut être lancée sans mot de passe pour observer la structure et vérifier que le fichier est lisible :

python2 pywallet.py --wallet=wallet.dat --dumpwallet > analyse_initiale.json

Si le portefeuille est chiffré, les clés privées apparaîtront protégées ou inutilisables. C’est normal. L’étape suivante consiste à fournir la phrase secrète. Selon la version de Pywallet, l’option peut être --passphrase ou une invite interactive. Évitez de laisser le mot de passe dans l’historique du shell :


![base de données Bitcoin](/media/upload/13/ad39c15e164e2039814676feecd5deb3_800_600.jpg)

read -s PASSPHRASE
export PASSPHRASE
python2 pywallet.py --wallet=wallet.dat --dumpwallet --passphrase="$PASSPHRASE" > wallet_dechiffre.json
unset PASSPHRASE

Si la commande échoue avec un message du type Invalid passphrase, ne multipliez pas les tentatives au hasard : vérifiez d’abord la casse, les espaces, les caractères spéciaux et la langue du clavier. Une phrase secrète mal saisie peut aussi provenir d’une sauvegarde ancienne ou d’un portefeuille différent.

4. Lire et sécuriser l’export JSON

Le fichier wallet_dechiffre.json peut contenir des adresses, des clés privées au format WIF et des métadonnées sensibles. Considérez-le comme un secret absolu :

  • ne le copiez pas sur un cloud ;
  • ne l’envoyez pas par messagerie ;
  • supprimez les exports intermédiaires après vérification ;
  • chiffrez le support de sauvegarde ;
  • testez la restauration sur une machine hors ligne.

Pour vérifier une adresse ou une clé, utilisez un portefeuille de test ou un environnement isolé. Si vous devez importer une clé privée dans Bitcoin Core, faites-le uniquement après avoir compris les risques : une clé importée peut rendre le portefeuille plus difficile à sauvegarder correctement. Dans la plupart des cas, il est préférable de transférer les fonds vers un nouveau portefeuille généré proprement, puis de vérifier la transaction avant de considérer la récupération comme terminée.

5. Mot de passe oublié : quelle démarche adopter ?

Pywallet ne casse pas le chiffrement. Si vous ne connaissez plus la phrase secrète, la démarche réaliste est la suivante :

récupération portefeuille Bitcoin

  1. Extraire les données nécessaires à la vérification du mot de passe depuis wallet.dat avec un script compatible, par exemple bitcoin2john.py ou les utilitaires associés à btcrecover.
  2. Lancer une récupération hors ligne avec btcrecover, HashCat ou John the Ripper, à partir d’un dictionnaire ciblé, de règles de mutation et de vos souvenirs partiels.
  3. Tester les candidats dans un environnement isolé.
  4. Une fois la phrase secrète retrouvée, revenir à Pywallet pour déchiffrer et exporter les clés.

Cette phase peut être longue. Elle dépend de la complexité du mot de passe et de la qualité de vos indices. Évitez les attaques massives non réfléchies : un dictionnaire pertinent et des règles adaptées à vos habitudes de mot de passe sont souvent plus efficaces qu’une force brute coûteuse.

6. Erreurs fréquentes avec Pywallet

  • Erreur Berkeley DB : version de base de données incompatible. Essayez une machine virtuelle avec les bibliothèques adaptées.
  • Module Python manquant : installez les dépendances dans un environnement isolé, sans exposer le portefeuille.
  • Portefeuille corrompu : restaurez une autre sauvegarde avant toute tentative. Ne modifiez jamais l’original.
  • Mauvais mot de passe : vérifiez les variantes, la casse et les caractères invisibles.
  • Export incomplet : certaines versions de Pywallet ne prennent pas en charge les portefeuilles récents ou les fonctionnalités avancées. Dans ce cas, utilisez un fork maintenu ou une méthode alternative.
  • Faux sentiment de sécurité : un déchiffrement réussi ne signifie pas que le portefeuille est sain. Vérifiez toujours les adresses et les soldes sur un explorateur de blocs public, sans jamais exposer vos clés.

7. Après la récupération : sécuriser durablement

Une fois les fonds récupérés, créez un nouveau portefeuille avec une nouvelle phrase de récupération, puis transférez les actifs. Conservez plusieurs sauvegardes chiffrées, sur des supports distincts et hors ligne. Testez régulièrement la restauration. Pour les montants importants, envisagez une sauvegarde métallique de la phrase BIP39, éventuellement fragmentée, et une organisation claire pour vos héritiers ou votre coffre-fort.

Les guides de Récupération de Portefeuille Crypto couvrent également les portefeuilles Ethereum comme MetaMask et MyEtherWallet, les portefeuilles Bitcoin comme Electrum et Ledger, ainsi que les stratégies de récupération BIP39/BIP32. Notre objectif est de vous aider à retrouver l’accès à vos actifs lorsque cela est légitime et techniquement possible, tout en réduisant au maximum les risques de perte définitive.

Conclusion

Pywallet reste un outil utile pour analyser et déchiffrer une base de données wallet.dat lorsque la phrase secrète est connue. Il ne faut cependant jamais le considérer comme une baguette magique : la sécurité repose sur une copie de sauvegarde, un environnement hors ligne, une source vérifiée et une compréhension claire du chiffrement Bitcoin Core. Si le mot de passe est perdu, combinez Pywallet avec une démarche méthodique de récupération hors ligne. En cas de doute, privilégiez la prudence et faites appel à un professionnel spécialisé en récupération de portefeuilles crypto.