Récupérer un portefeuille Mist : keystore Ethereum et mot de passe

Vous avez un vieil ordinateur, un dossier de sauvegarde ou un vague souvenir d’avoir utilisé le portefeuille officiel d’Ethereum il y a des années. Quelque part là-dedans se trouve de l’ETH auquel vous ne pouvez plus accéder. Mist a été abandonné en 2019, le logiciel fonctionne à peine aujourd’hui, et le mot de passe n’est au mieux qu’une supposition. Avant d’installer quoi que ce soit ou de commencer à deviner, prenez deux minutes pour comprendre ce qu’il faut réellement pour retrouver l’accès à un ancien portefeuille Ethereum.

Vous n’avez pas besoin de Mist pour récupérer un portefeuille Mist

Cette idée reçue fait perdre beaucoup de temps. Certains cherchent d’anciens programmes d’installation, luttent pendant des jours contre des erreurs de synchronisation, puis concluent que leur ETH a disparu lorsque l’application plante. Rien de tout cela n’est nécessaire.

Mist n’était qu’une fenêtre sur la blockchain. Votre ETH ne s’y est jamais trouvé. Ce que Mist enregistrait sur votre ordinateur, c’est un fichier keystore : un petit fichier chiffré contenant votre clé privée, le secret qui contrôle votre adresse. Ce fichier, avec son mot de passe, ouvre le portefeuille dans un portefeuille Ethereum moderne capable d’importer des fichiers keystore. Que le logiciel ne fonctionne plus n’a aucune importance. Votre ETH est toujours sur la blockchain, intact. Ce que vous reconstruisez, c’est uniquement l’accès.

Un avertissement d’abord. Si les fichiers de Mist se trouvent sur un ancien disque, cessez d’utiliser ce disque. Copiez tout sur deux supports distincts avant de faire quoi que ce soit d’autre. Les vieux disques tombent en panne, et un disque en panne peut transformer un cas soluble en cas insoluble.

Où se trouve le fichier keystore

Le fichier se trouve dans le dossier de données d’Ethereum, et non dans le dossier propre à Mist :

• Windows : %APPDATA%\Ethereum\keystore
• macOS : ~/Library/Ethereum/keystore
• Linux : ~/.ethereum/keystore

Un nom de fichier keystore standard commence par UTC--, suivi d’un horodatage et de votre adresse, par exemple UTC--2017-06-08T08-33-59.135699700Z--d728e1873ed53618c467ce06b6f20163eb39eaf5. Un fichier renommé ou copié peut avoir un autre aspect : vérifiez donc aussi les petits fichiers .json. Ce schéma standard est utile à deux titres :

• Vous pouvez rechercher « UTC-- » sur tout un disque. On retrouve des fichiers keystore dans des pièces jointes d’e-mails, sur des clés USB et dans des sauvegardes cloud que l’on ne consultait plus depuis des années.
• Si le fichier a été supprimé, des outils comme PhotoRec ou Recuva peuvent souvent le retrouver sur un disque peu utilisé depuis. Ne travaillez que sur une copie du disque.

Dans ce nom de fichier standard, la partie qui suit le deuxième double tiret est votre adresse Ethereum. Avant toute chose, recherchez-la sur etherscan.io. Vous saurez ainsi si le portefeuille contient quelque chose qui vaille la peine d’être récupéré, sans même toucher au mot de passe.

Deux fichiers que vous pourriez trouver à côté ne sont pas des keystores Mist. Un fichier ethereum_wallet_backup.json isolé datant de 2014 est un portefeuille de presale, un format différent qui a sa propre voie de récupération. Et une phrase de 12 ou 24 mots appartient à un autre portefeuille, ce qui nous amène au point suivant.

Les comptes Mist n’ont pas de phrase de récupération

Si vous avez cherché une phrase de récupération dans vos notes, inutile de continuer. Les comptes Mist n’utilisaient pas de phrase de récupération comme sauvegarde. Le standard de 12 ou 24 mots adopté plus tard par les portefeuilles Ethereum (appelé BIP-39) n’a jamais fait partie du format de compte de Mist. Pour un compte Mist, le fichier keystore et son mot de passe constituent la sauvegarde complète ; il n’y a jamais rien eu d’autre à noter.

Cela joue dans les deux sens. Vous n’avez pas perdu de phrase, puisqu’il n’en a jamais existé. Mais cela signifie aussi que tout repose sur le fichier keystore : sans lui, ou sans une copie de la clé privée brute, connaître le mot de passe ne sert à rien.

Ce que vous avez détermine ce qui est possible

Vous avez le fichier et vous vous souvenez du mot de passe

C’est la situation la plus favorable. La récupération prend quelques minutes.

• Importez le fichier keystore dans un portefeuille moderne. L’extension de navigateur MetaMask accepte un fichier keystore JSON avec son mot de passe (ce que l’application mobile ne permet pas), comme l’explique le guide d’importation de MetaMask ; Enkrypt permet d’importer une clé privée Ethereum.
• Ne téléversez jamais le keystore sur un site web, et ne collez jamais une clé privée dans un site. Un keystore sur une page web est un keystore entre les mains de quelqu’un d’autre.
• Une fois l’accès rétabli, balayez tout : transférez la totalité du solde vers un portefeuille fraîchement créé plutôt que de continuer à utiliser une clé qui a passé des années sur du vieux matériel. Les éventuels jetons ERC-20 présents à l’adresse dépendent de la même clé : vous pouvez les transférer aussi, chaque jeton par une transaction distincte. Dans MetaMask, le keystore devient un compte importé, que la phrase secrète de récupération de MetaMask ne sauvegarde pas.

Si votre démarche passe par MyEtherWallet et que l’application elle-même vous pose problème, ce cas est traité dans notre guide de récupération MEW.

Le mot de passe dont vous vous souvenez est rejeté

Deux causes produisent ici le même symptôme, et il importe de les distinguer.

Cause 1 : le mot de passe est presque le bon, mais pas tout à fait. Une ancienne majuscule, une année ajoutée, une substitution abandonnée avec le temps. Avant de tester des hypothèses, notez tout ce dont vous vous souvenez au sujet du mot de passe : sa longueur probable, les mots ou les dates à partir desquels vous construisiez vos mots de passe à l’époque. Ces souvenirs constituent la matière première. Le format keystore est délibérément lent à vérifier ; selon la machine et les réglages du fichier, une seule tentative peut prendre environ une seconde sur un ordinateur ordinaire, et c’est précisément pourquoi une approche méthodique l’emporte sur les essais manuels. Des outils comme BTCRecover, et des logiciels GPU qui testent systématiquement de grands ensembles de candidats, transforment un bon souvenir de la structure du mot de passe en une liste de candidats à tester. Une recherche bien délimitée est souvent réalisable. Une recherche sans limites ne l’est pas, quoi qu’on vous promette. Notre guide sur la récupération du mot de passe d’un fichier keystore explique comment une telle recherche se met en place.

Cause 2 : un bug de Mist. Certaines versions de Mist géraient mal les mots de passe contenant des caractères accentués ou d’autres caractères non standard : le mot de passe écrit dans le fichier n’était pas celui que vous aviez tapé. Si vous avez la certitude que votre mot de passe est le bon, qu’il est pourtant rejeté et qu’il contenait de tels caractères, écartez ce bug avant de douter de votre mémoire. La solution consiste à tester des variantes d’encodage du bon mot de passe, et non à en deviner de nouveaux. C’est une affaire de spécialiste, mais l’un des cas les plus favorables, car le mot de passe lui-même est connu.

Une remarque de sécurité sur l’aide professionnelle : rien ne contourne le chiffrement, et ce sont toujours les données chiffrées et la stratégie de choix des candidats qui définissent la recherche. Mais lorsque c’est techniquement possible, nous travaillons à partir du hash du mot de passe extrait du fichier plutôt que de vous demander le mot de passe lui-même, de sorte que les tentatives de récupération s’exécutent sans que personne ne voie ce que vous tapez réellement.

Le portefeuille s’ouvre mais affiche 0 ETH

Vérifiez d’abord l’adresse sur etherscan.io. C’est la blockchain, et non une application, qui fait foi pour votre solde.

Si Etherscan affiche aussi zéro alors que vous avez la certitude d’avoir détenu de l’ETH, vérifiez un piège propre à Mist : les contrats de portefeuille. Mist permettait de créer, à côté des comptes normaux, des portefeuilles sous forme de contrat (« contract wallets »), et beaucoup d’utilisateurs les ont approvisionnés. L’ETH se trouve alors à l’adresse propre du contrat, une adresse différente de celle du compte de votre fichier keystore. Importer votre clé dans MetaMask affiche le compte, pas le contrat : le solde indique donc zéro alors que rien ne manque en réalité.

• Cherchez une création de contrat dans votre ancien historique de transactions sur Etherscan.
• Trouvez l’adresse de ce contrat et consultez son solde.
• Pour sortir l’ETH, il faut appeler la fonction de retrait propre au contrat, en signant avec votre compte keystore en tant que propriétaire. La façon de procéder dépend du code et des règles de propriété du contrat concerné. Pour le contrat de portefeuille standard créé par Mist, c’est souvent encore faisable ; c’est plus complexe qu’un transfert normal, et mieux vaut faire évaluer le cas avant de vous y essayer par vos propres moyens.

Vous n’avez ni fichier keystore ni clé privée

Ici, l’honnêteté compte plus que l’espoir. Cherchez d’abord : vieux disques, clés USB, e-mails, sauvegardes cloud, impressions. Le nom de fichier en UTC-- offre une piste de recherche concrète, et la récupération de fichiers supprimés sur le disque d’origine vaut la peine d’être tentée si celui-ci existe encore.

Mais si aucune copie du fichier ou de la clé brute ne subsiste nulle part, il n’existe aucune voie de récupération. La clé ne peut pas être reconstituée à partir de l’adresse, et aucun service ne peut y changer quoi que ce soit : les mathématiques qui protègent votre ETH contre tout le monde le protègent aussi contre vous. Nous préférons le dire clairement plutôt que de vous laisser passer des mois sur quelque chose qui ne peut pas fonctionner. Quiconque promet le contraire dans ce cas décrit quelque chose qui n’existe pas. Il en va de même pour quiconque prétend annuler ou rediriger des transactions blockchain.

Ne faites pas confiance aux « téléchargements de Mist » ni aux vérificateurs en ligne

Il n’y a aucune raison légitime d’exécuter Mist aujourd’hui, et toutes les raisons de ne pas le faire : un logiciel abandonné, aux vulnérabilités connues, et des résultats de recherche pour « télécharger le portefeuille Mist » qui mènent à des sites imitant l’original, conçus pour voler les fichiers keystore et les mots de passe. Il en va de même pour les outils web qui vous demandent de téléverser votre fichier ou de saisir votre clé. Une adresse est publique. Votre fichier keystore et votre mot de passe ne le sont jamais. Vérifiez les soldes sur etherscan.io uniquement à partir de l’adresse.

Une fois l’accès retrouvé et les fonds transférés vers un nouveau portefeuille que vous avez créé, traitez la phrase de récupération de ce portefeuille avec plus de soin que Mist n’en a eu pour votre keystore : sur papier ou sur métal, en deux endroits, jamais photographiée, jamais saisie sur un site web.

Quand confier votre cas à un spécialiste

Si votre situation concerne le mot de passe rejeté, le bug d’encodage, un disque endommagé ou un contrat de portefeuille auquel vous n’arrivez pas à accéder, commencez par une évaluation gratuite : une réponse honnête sur la faisabilité de la récupération, avant tout engagement. Le travail ne commence qu’après la signature d’un contrat. Il s’effectue sur des machines isolées (air-gapped), selon le principe pas de récupération, pas de frais, et comme nous ne manipulons jamais votre ETH et n’y avons aucun accès, c’est vous qui le transférez une fois le keystore déverrouillé. Nous avons mené à bien plus de 200 récupérations depuis 2019.

Ce transfert se fait vers un nouveau portefeuille que vous avez créé vous-même, et les honoraires convenus sont réglés séparément, conformément au contrat. À aucun moment l’ETH ne transite par nous.

FAQ sur la récupération d’un portefeuille Mist

Où se trouve le fichier de sauvegarde du portefeuille Mist ?

Le fichier de sauvegarde du portefeuille Mist est stocké dans le dossier keystore d’Ethereum, et non dans le dossier de l’application Mist. Son nom commence par UTC--, suivi d’un horodatage et de l’adresse de votre portefeuille.

Le portefeuille Mist a-t-il une phrase de récupération ?

Non. Le portefeuille Mist est sorti avant que les phrases de récupération ne deviennent la norme dans les portefeuilles Ethereum. Votre fichier keystore chiffré et son mot de passe constituent la sauvegarde complète du portefeuille : il n’existe donc pas de phrase de récupération de 12 ou 24 mots.

Puis-je récupérer mon portefeuille Mist avec seulement mon adresse publique ?

Non. Une adresse Ethereum publique permet seulement d’afficher le solde de votre portefeuille et son historique de transactions. Pour récupérer l’accès, il vous faut le fichier keystore ou la clé privée.

Puis-je récupérer mon portefeuille Mist si le dossier keystore a été supprimé ?

C’est possible. Si une autre copie du fichier keystore existe sur une sauvegarde, une clé USB ou un autre appareil, le portefeuille peut encore être restauré. Si le fichier a été supprimé, cessez immédiatement d’utiliser le disque et tentez une récupération de fichiers avant que de nouvelles données ne l’écrasent.

Dois-je télécharger la blockchain Ethereum pour récupérer mon portefeuille Mist ?

Non. Les portefeuilles Ethereum modernes peuvent importer votre fichier keystore ou votre clé privée sans télécharger toute la blockchain, ce qui vous permet d’accéder à votre portefeuille beaucoup plus rapidement.

Pourquoi mon portefeuille Mist importé affiche-t-il 0 ETH ?

Un solde nul ne signifie pas toujours que vos fonds ont disparu. Vérifiez d’abord l’adresse de votre portefeuille sur un explorateur de blocs. Si votre ETH est détenu par un contrat de portefeuille, des étapes supplémentaires peuvent être nécessaires pour y accéder.

Puis-je récupérer mon portefeuille Mist sans le mot de passe ?

C’est possible : la recherche du mot de passe s’effectue sur le fichier keystore chiffré, et tout ce dont vous vous souvenez au sujet du mot de passe (sa longueur, les mots ou les dates sur lesquels il repose) restreint cette recherche. C’est une évaluation complète du fichier et de vos souvenirs qui nous permet de vous dire si c’est réaliste. Sans aucune information sur le mot de passe, la récupération n’est généralement pas possible.