Récupérer un wallet.dat Bitcoin Core : comment restaurer un ancien portefeuille

Vous avez retrouvé un fichier wallet.dat. Il se trouvait peut-être sur un ancien disque dur, dans un dossier de sauvegarde que vous aviez oublié, sur une clé USB à l’étiquette énigmatique ou dans une archive cloud vieille de plusieurs années. Il pourrait renfermer des bitcoins, mais vous ne savez ni comment l’ouvrir, ni s’il est chiffré, ni combien il contient. Ce guide vous accompagne du fichier jusqu’à un portefeuille de nouveau utilisable : comment l’ouvrir, vérifier s’il contient des fonds, gérer le chiffrement et retrouver l’accès lorsque le fichier a été supprimé ou endommagé, dans un ordre qui protège le fichier à chaque étape.

Retrouver un wallet.dat est un point de départ, pas la preuve que le fichier permette de dépenser des bitcoins. Un portefeuille peut contenir des clés privées, des clés chiffrées ou seulement des données publiques permettant de suivre des adresses.

Ce qu’est réellement un fichier wallet.dat

Bitcoin Core conserve chaque portefeuille dans un fichier de base de données nommé wallet.dat. Celui-ci contient les clés privées qui contrôlent vos adresses, ainsi que les adresses elles-mêmes, leurs étiquettes et l’historique des transactions (documentation de Bitcoin Core sur les fichiers). Le fichier est le portefeuille : s’il contient les clés et que vous pouvez le déverrouiller, vous contrôlez les bitcoins que ces adresses détiennent encore.

Il existe deux formats, et le nom du fichier ne suffit pas à les distinguer :

• Les portefeuilles legacy utilisent Berkeley DB. Tout portefeuille créé avant Bitcoin Core 0.21 est un portefeuille legacy, de même qu’un portefeuille créé avant la version 23.0, sauf si l’option de portefeuille à descripteurs a été choisie.
• Les portefeuilles à descripteurs utilisent SQLite. Ils sont apparus avec Bitcoin Core 0.21 et sont devenus le format par défaut des nouveaux portefeuilles avec la version 23.0, publiée en avril 2022.

Sous macOS ou Linux, la commande file, exécutée sur une copie, permet de les distinguer : elle identifie un portefeuille legacy comme un fichier Berkeley DB (Btree) et un portefeuille à descripteurs comme une base de données SQLite 3.x. Le format compte, car c’est lui qui détermine quelles versions de Bitcoin Core peuvent encore ouvrir le fichier.

Où Bitcoin Core stocke wallet.dat

Cherchez d’abord dans le dossier de données par défaut :

• Linux : ~/.bitcoin/
• macOS : ~/Library/Application Support/Bitcoin/
• Windows : %APPDATA%\Bitcoin\ pour les installations réalisées avant Bitcoin Core 28.0, et %LOCALAPPDATA%\Bitcoin\ pour les plus récentes. La version 28.0 a déplacé l’emplacement par défaut, mais continue d’utiliser l’ancien dossier s’il existe.

Les installations récentes rangent les portefeuilles dans un dossier wallets situé dans le dossier de données : le portefeuille par défaut sous wallets/wallet.dat, et chaque portefeuille nommé dans son propre sous-dossier. Les installations plus anciennes conservent wallet.dat directement dans le dossier de données. Un dossier de données ou un répertoire des portefeuilles personnalisé peut se trouver n’importe où : cherchez donc aussi les fichiers nommés wallet.dat sur l’ensemble du disque.

Bitcoin Core ne génère pas de phrase de récupération. Si vous avez 12 ou 24 mots, ils appartiennent à un autre portefeuille ; notre guide Bitcoin Core et les phrases de récupération explique pourquoi. Ne confondez pas la récupération d’un fichier avec les procédures prévues pour les portefeuilles BIP-39.

Étape 1 : faire des copies avant toute chose

Avant d’ouvrir, de déplacer ou de tester quoi que ce soit, faites au moins deux copies du fichier et conservez-les à des endroits distincts. Considérez l’original comme l’exemplaire de référence : n’y appliquez aucun outil de récupération, ne l’ouvrez pas dans un logiciel de portefeuille et ne le renommez pas. Gardez intacts le fichier original et les sauvegardes existantes, ne travaillez désormais que sur des copies, et ne copiez jamais le fichier par-dessus le wallet.dat d’un autre portefeuille.

Certaines opérations écrivent dans le fichier qu’elles ouvrent : la migration convertit un portefeuille vers un nouveau format et, dans de rares circonstances, une migration échouée sous Bitcoin Core 30.0 et 30.1 pouvait supprimer les fichiers du répertoire des portefeuilles. Un dommage causé au seul original est irréversible. Quiconque possède une copie d’un wallet.dat non chiffré peut dépenser ce que ce fichier contrôle : conservez donc les copies sur des supports hors ligne que vous maîtrisez, et non dans des e-mails ou des dossiers cloud partagés.

Si Bitcoin Core ouvre encore le portefeuille, privilégiez sa fonction de sauvegarde (Fichier > Sauvegarder le portefeuille…) plutôt qu’une copie de la base de données pendant que l’application écrit dedans. Notez l’appareil et la version dont provient le fichier.

Notez la date de chaque copie et celle de votre dernière utilisation du portefeuille. Une date de fichier plus récente ne prouve pas qu’une sauvegarde soit plus complète. Gardez les anciennes copies tant que vous ne savez pas quelles adresses et quelles clés chacune contient. Si le fichier a été supprimé ou si le disque est défaillant, n’y installez pas de logiciel de récupération : de nouvelles écritures peuvent écraser des données encore utiles. Notre guide sur la manipulation sûre des vieux portefeuilles et disques détaille le hachage et la création d’images disque.

Étape 2 : vérifier si le portefeuille contient des adresses approvisionnées

Avant de consacrer des jours à la récupération d’un mot de passe ou à la réparation d’un fichier, vérifiez qu’il y a bien des bitcoins à récupérer. Le mot de passe n’est pas nécessaire pour cela : Bitcoin Core ne chiffre que les clés privées, et les adresses comme les transactions restent lisibles. Il en est ainsi depuis l’arrivée du chiffrement des portefeuilles avec Bitcoin 0.4.0, en 2011, et la documentation actuelle sur les portefeuilles le confirme.

• Si le portefeuille se charge (voir l’étape 3), Fenêtre > Adresses de réception affiche ses adresses de réception et leurs étiquettes, et le solde est exact une fois le nœud synchronisé.
• S’il ne se charge pas encore, recherchez sur un explorateur de blocs comme mempool.space une adresse que vous savez avoir utilisée, par exemple d’après vos propres traces d’un ancien paiement. Si vous n’avez aucune adresse, celles-ci peuvent malgré tout être lues dans le fichier lui-même, puisqu’elles ne sont pas chiffrées ; c’est un travail technique, à effectuer hors ligne et sur une copie.

Si les adresses affichent un solde, le fichier vaut la peine qu’on s’y attelle. Si toutes les adresses affichent zéro, ou seulement d’anciennes transactions dont les bitcoins ont été dépensés par la suite, aucune récupération de mot de passe n’y changera rien.

Deux mises en garde s’imposent. La monnaie rendue lors de paiements passés arrive sur des adresses absentes de la liste de réception : quelques adresses de réception vides ne prouvent donc pas que le portefeuille soit vide, et seul le solde obtenu après une synchronisation complète fait foi. Ensuite, un solde ne vaut pas accès. Un portefeuille en lecture seule affiche des soldes sans détenir la moindre clé privée. Dans ce cas, le solde affiché ne fournit pas les clés manquantes : retrouvez le portefeuille ou la sauvegarde qui les contient, car réparer cette copie de données publiques ne les y ajoute pas.

Étape 3 : charger le portefeuille dans Bitcoin Core

D’anciens guides conseillent de placer wallet.dat dans le dossier de données et de lancer Bitcoin Core. Cela peut écraser un autre portefeuille, et Bitcoin Core 30.0 a supprimé le chargement direct des portefeuilles legacy : « installer la dernière version et l’ouvrir » n’est donc pas une procédure universelle. La bonne marche à suivre dépend du format :

• Portefeuille à descripteurs : dans une version actuelle, choisissez Fichier > Restaurer le portefeuille…, sélectionnez votre copie et donnez un nom au portefeuille. Bitcoin Core copie le fichier dans son dossier des portefeuilles et le charge.
• Portefeuille legacy : une version actuelle refuse de le charger et vous invite à le migrer. À partir de la version 31.0, choisissez Fichier > Migrer le portefeuille > Restaurer et migrer le fichier du portefeuille…, sélectionnez votre copie et nommez le portefeuille. Bitcoin Core copie le fichier dans son dossier des portefeuilles sans modifier l’original, le convertit en portefeuille à descripteurs et conserve une sauvegarde dont le nom se termine par .legacy.bak. Les scripts en lecture seule et les autres scripts sans clé peuvent être transférés vers des portefeuilles supplémentaires dont le nom se termine par _watchonly ou _solvables. La commande de console migratewallet n’effectue que la migration : elle prend le nom d’un portefeuille, pas un fichier de sauvegarde à restaurer.

Trois points comptent lors d’une migration :

1. Utilisez la version 30.2 ou une version ultérieure. N’utilisez pas les versions 30.0 ou 30.1 pour migrer : Bitcoin Core a publié un avertissement concernant un défaut pouvant supprimer des fichiers de portefeuille, et la version 30.2 l’a corrigé en janvier 2026.
2. Un portefeuille legacy chiffré ne peut être migré qu’avec son mot de passe, que Bitcoin Core demande avant la conversion. Sans le mot de passe, une version actuelle ne peut pas ouvrir le portefeuille du tout. Les versions antérieures à la 30.0 chargent encore directement les portefeuilles legacy ; n’en utilisez une que sur une copie, par exemple pour consulter les adresses et le solde tant que le mot de passe reste introuvable.
3. Après la migration, faites une nouvelle sauvegarde, comme le recommande la documentation de Bitcoin Core. Conservez toujours des sauvegardes indépendantes avant toute migration ou réparation.

Une fois le portefeuille chargé, Bitcoin Core parcourt la blockchain à la recherche de ses transactions. Un nouveau nœud doit d’abord télécharger et vérifier toute la chaîne, que Bitcoin Core évalue désormais à plus de 850 Go. L’élagage (pruning) ramène l’espace de stockage à environ 10 Go seulement, mais un nœud élagué ne peut pas réanalyser les blocs qu’il a déjà supprimés : un portefeuille chargé après l’élagage peut donc imposer un nouveau téléchargement complet. Si vous voulez seulement vérifier le solde et déplacer les bitcoins, un nœud complet n’est pas nécessaire ; voir plus bas la section sur l’extraction des clés privées.

Étape 4 : gérer le chiffrement

Si Bitcoin Core demande un mot de passe lorsque vous essayez d’envoyer des bitcoins ou d’exporter des clés, le portefeuille est chiffré. Dans ses boîtes de dialogue, Bitcoin Core appelle ce mot de passe la phrase de passe du portefeuille (wallet passphrase dans l’interface en anglais) ; elle protège le fichier et n’est pas une passphrase BIP-39. Sur un ancien portefeuille, elle a pu être définie il y a des années, puis oubliée.

Une fois le portefeuille chargé, vous pouvez voir ses adresses et son solde même sans le mot de passe, car seules les clés privées sont chiffrées. Pour dépenser des fonds ou exporter des clés, il faut le mot de passe, et aucune réinitialisation n’est possible. Si le portefeuille s’ouvre mais demande un mot de passe pour signer une transaction, il s’agit d’une question de mot de passe, pas d’un signe de fichier endommagé.

Pour la démarche complète, consultez notre guide sur la récupération du mot de passe Bitcoin Core. Le guide du mot de passe wallet.dat traite de l’aspect technique d’une recherche par force brute : quels éléments permettent d’évaluer une recherche de mot de passe, et pourquoi elle s’exécute sur une copie. Décrivez le problème sans envoyer le fichier ni le mot de passe dans un formulaire de contact.

Le fichier s’ouvre, mais le solde attendu n’apparaît pas

Vérifiez d’abord le nom du portefeuille chargé et le répertoire depuis lequel il a été chargé. Bitcoin Core peut gérer plusieurs portefeuilles : ouvrir un autre portefeuille, ou un portefeuille vide nouvellement créé, ne restaure pas le fichier que vous avez retrouvé.

Prenez une adresse de réception que vous savez avoir utilisée. Comparez-la avec le portefeuille chargé, puis vérifiez que Bitcoin Core s’est synchronisé et a analysé l’historique des transactions concerné. Une réanalyse peut retrouver les transactions des clés déjà présentes ; elle ne peut pas recréer des clés privées manquantes.

La sauvegarde d’un ancien portefeuille non HD peut ne pas contenir les clés générées après sa réalisation. C’est l’une des raisons de comparer plusieurs copies conservées plutôt que de les écarter dès que l’une d’elles s’ouvre.

Récupérer un wallet.dat supprimé

Vérifiez les sauvegardes existantes et le répertoire des portefeuilles configuré avant de conclure à une suppression. Sous Windows, cherchez à la fois dans l’ancien et dans le nouveau dossier de données indiqués plus haut.

Si le fichier a bel et bien été supprimé, tout n’est pas forcément perdu. Supprimer un fichier efface l’entrée qui le référence dans le système de fichiers, pas les données elles-mêmes. Le contenu reste sur le disque jusqu’à ce que l’espace qu’il occupait soit réutilisé pour de nouveaux fichiers.

Sur un disque dur classique (HDD), un wallet.dat supprimé peut subsister tant que rien ne l’écrase : un disque à peine utilisé depuis offre donc les meilleures chances. Il en va autrement des SSD. Lorsqu’un fichier est supprimé, le système d’exploitation indique au SSD quels blocs sont désormais libres, au moyen d’une notification appelée TRIM, et le SSD peut effacer ces blocs en arrière-plan. Windows active TRIM par défaut sur les volumes NTFS (documentation Microsoft) : sur un SSD, le délai pour récupérer le fichier est donc beaucoup plus court.

Si vous pensez qu’un wallet.dat a été supprimé :

1. Cessez immédiatement d’utiliser le disque. N’y installez aucun logiciel, n’y enregistrez aucun fichier et, idéalement, ne démarrez pas l’ordinateur sur ce disque.
2. Créez une image du disque avant toute autre chose, afin que toute la suite du travail porte sur l’image et que rien ne soit jamais écrit sur l’original.
3. Des outils de file carving recherchent ensuite dans l’image la structure d’un fichier de portefeuille et tentent de le reconstituer à partir de fragments.
4. Enregistrez tout ce qui a été récupéré sur un autre disque.

C’est un travail de spécialiste, et les chances dépendent fortement de l’usage qui a été fait du disque après la suppression. Notre étude de cas sur un wallet.dat Bitcoin Core supprimé montre le processus sur un disque resté en grande partie intact.

Traiter un wallet.dat corrompu

Un fichier de portefeuille peut être endommagé par une défaillance du support de stockage, comme des secteurs défectueux ou une clé USB qui ne termine pas ses écritures, ou par une écriture interrompue. Bitcoin Core refuse alors de le charger en affichant l’erreur « le portefeuille est corrompu », ou le charge avec un avertissement indiquant que des données de transaction ou des métadonnées d’adresse sont peut-être manquantes ou incorrectes.

Avant de considérer le fichier comme endommagé, relevez le message d’erreur exact et la version de Bitcoin Core, et vérifiez d’abord la compatibilité. Une version actuelle rejette tout portefeuille legacy avec une erreur indiquant que la version du portefeuille est ancienne et qu’il faut le migrer, et une version plus ancienne peut signaler que le portefeuille exige une version plus récente de Bitcoin Core. Aucun de ces deux messages ne signifie que le fichier soit endommagé.

Si vous soupçonnez toujours une corruption, envisagez une réparation sur une copie distincte. L’ancienne option de démarrage -salvagewallet de Bitcoin Core a été supprimée dans la version 0.21 et remplacée par la commande salvage de l’outil bitcoin-wallet, qui tente de récupérer les clés privées d’un portefeuille corrompu et porte la mention expérimentale. Cette commande n’existe que dans les versions antérieures à la 30.0. Elle renomme le fichier endommagé en copie .bak et écrit dans un nouveau fichier de portefeuille les enregistrements de clés privées qu’elle parvient encore à lire : ne l’exécutez donc que sur une copie.

Si la commande salvage échoue, les enregistrements de clés peuvent rester intacts alors même que la structure de la base de données est endommagée. Extraire les clés privées directement des données brutes, en contournant la couche de base de données, exige des outils spécialisés et une bonne connaissance du format de fichier. Évitez de multiplier les changements de version ou les réparations sur le seul original. Notre page sur les fichiers de portefeuille corrompus explique comment distinguer un fichier endommagé d’un disque défaillant.

Extraire les clés privées sans nœud complet

Si vous ne voulez pas télécharger toute la blockchain, vous pouvez exporter les clés privées et déplacer les bitcoins avec un portefeuille plus léger, qui consulte les soldes via ses propres serveurs.

• Portefeuille legacy dans une version antérieure à la 30.0 : la commande de console dumpwallet écrit toutes les clés du portefeuille dans un fichier texte, sous une forme lisible. Bitcoin Core 30.0 l’a supprimée, de même que dumpprivkey.
• Portefeuille à descripteurs ou migré : listdescriptors true affiche les descripteurs privés du portefeuille au lieu d’une simple liste de clés : seuls les logiciels de portefeuille capables d’importer des descripteurs peuvent donc les utiliser.

Electrum peut exploiter des clés privées exportées de deux manières. Il peut les balayer (Portefeuille > Clés privées > Balayer), ce qui envoie les bitcoins vers une adresse d’un portefeuille Electrum que vous avez créé, ou les importer dans un nouveau portefeuille sans phrase de récupération, qu’il faut alors sauvegarder séparément, car il ne peut pas être restauré à partir d’une phrase de récupération. Balayer les clés vers un nouveau portefeuille qui vous appartient reste la solution la plus simple.

Un fichier d’export contient toutes les clés en clair, et quiconque le lit peut s’emparer des bitcoins. Ne le faites transiter ni par e-mail ni par un stockage cloud, et supprimez-le une fois les bitcoins déplacés.

Si le portefeuille est chiffré, il vous faut le mot de passe avant de pouvoir exporter quoi que ce soit. Il n’existe aucun raccourci : le chiffrement porte précisément sur les clés privées, et aucune commande d’export ne fonctionne tant qu’elles ne sont pas déchiffrées.

Aide pour un fichier wallet.dat que vous ne parvenez pas à ouvrir

Si le fichier est chiffré avec un mot de passe oublié, s’il a été supprimé ou endommagé, ou s’il refuse tout simplement de s’ouvrir, Crypto Recovers peut l’évaluer. Nous avons mené à bien plus de 200 récupérations depuis 2019, la première évaluation est gratuite et nous appliquons le principe « pas de récupération, pas de frais ». Pour en savoir plus, consultez notre service de récupération Bitcoin Core.

Si vous confiez l’examen du fichier à Crypto Recovers, nous ne détenons jamais vos bitcoins et n’en déduisons jamais nos honoraires. Une fois l’accès rétabli, vous ouvrez vous-même le portefeuille, transférez les bitcoins vers un nouveau portefeuille que vous avez créé et payez séparément les honoraires convenus, conformément au contrat.

Documentation officielle

• Bitcoin Core : gestion des portefeuilles (sauvegarde, restauration, migration)
• Bitcoin Core 30.0 : compatibilité des portefeuilles
• Bitcoin Core : avertissement sur la migration des portefeuilles
• Bitcoin Core : backupwallet
• Bitcoin Core : rescanblockchain
• Bitcoin Core : newkeypool
• Bitcoin Core : vérifier le portefeuille chargé avec getwalletinfo
• Bitcoin Core : répertoires de portefeuilles et loadwallet

Questions fréquentes sur la récupération d’un wallet.dat Bitcoin Core

Puis-je ouvrir un fichier wallet.dat sans Bitcoin Core ?

En partie. L’utilitaire bitcoin-wallet, fourni avec Bitcoin Core, est un outil hors ligne : il lit les fichiers de portefeuille sans faire tourner le nœud ni télécharger la blockchain. D’anciens outils open source comme pywallet savent lire les fichiers Berkeley DB legacy et en exporter les clés, mais pywallet indique toujours Python 2 parmi ses prérequis : il faut donc être à l’aise avec la ligne de commande et disposer d’un environnement ancien, hors ligne. Pour un portefeuille chiffré, il vous faut de toute façon le mot de passe, quel que soit l’outil. N’envoyez jamais le fichier à un site web qui propose de l’ouvrir.

J’ai un wallet.dat de 2010. Fonctionnera-t-il avec la dernière version de Bitcoin Core ?

Pas directement. Un portefeuille de 2010 est un portefeuille Berkeley DB legacy, et Bitcoin Core 30.0 et les versions ultérieures ne chargent plus ce type de portefeuille. Une version actuelle peut le migrer : sur une copie, utilisez Fichier > Migrer le portefeuille > Restaurer et migrer le fichier du portefeuille… dans la version 31.0 ou une version ultérieure. Le chiffrement des portefeuilles n’est apparu qu’avec la version 0.4.0, en septembre 2011 : un portefeuille de 2010 n’est donc chiffré que si un mot de passe y a été ajouté plus tard, avec une version plus récente. Dans ce cas, la migration demande ce mot de passe. Les versions antérieures à la 30.0 peuvent encore charger le fichier sans le migrer.

Comment savoir si mon wallet.dat est chiffré ?

Chargez-le dans Bitcoin Core et essayez d’envoyer un petit montant ou d’exporter une clé privée : si Bitcoin Core demande la phrase de passe du portefeuille, celui-ci est chiffré. Vous pouvez aussi vérifier sans rien tenter. Pour un portefeuille chiffré, le menu Paramètres affiche Chiffrer le portefeuille… coché et grisé, tandis que Changer la phrase de passe… est disponible, et une icône de cadenas apparaît dans la barre d’état. Dans la console, getwalletinfo ne renvoie un champ unlocked_until que pour les portefeuilles chiffrés. Pour un fichier legacy dans une version actuelle, la migration demande le mot de passe avant de convertir un portefeuille chiffré.

Quelqu’un vend un wallet.dat contenant des bitcoins. Faut-il l’acheter ?

Non. C’est une arnaque bien connue. Soit le vendeur garde une copie des clés et vide le portefeuille une fois que vous avez payé, soit le solde annoncé n’a jamais été contrôlé par ce fichier. Un solde visible sur un explorateur de blocs prouve seulement qu’une adresse détient des bitcoins, pas que le fichier mis en vente en contienne les clés. Les vrais portefeuilles approvisionnés ne se vendent pas, car quiconque a gardé une copie des clés peut dépenser les fonds avant l’acheteur. Crypto Recovers ne traite pas les fichiers de portefeuille achetés ; notre article sur les arnaques aux portefeuilles à vendre décrit le mécanisme.

J’ai un ancien wallet.dat mais pas le mot de passe. Que faire ?

Ne commencez pas à essayer des mots de passe sur l’original. Faites deux copies, vérifiez si les adresses du portefeuille contiennent des fonds, et notez tout ce dont vous vous souvenez au sujet du mot de passe : mots, dates, schémas, ainsi que le clavier que vous utilisiez à l’époque. Si le portefeuille contient des fonds, les guides sur le mot de passe cités plus haut expliquent le fonctionnement d’une recherche, et une évaluation gratuite vous indique si une recherche est réaliste avant tout engagement de votre part.