La phrase Electrum expliquée : seed Electrum vs BIP-39

Une phrase de récupération Electrum n’est pas une phrase BIP-39. Les versions actuelles d’Electrum puisent leurs mots dans la même liste anglaise de 2 048 mots que les portefeuilles BIP-39, mais chaque système vérifie les mots et en dérive les clés selon ses propres règles. Si vous avez essayé de restaurer un portefeuille Electrum dans une autre application, ou d’importer dans Electrum une phrase provenant d’un Ledger ou d’un autre portefeuille BIP-39, vous connaissez sans doute le résultat : le portefeuille déclare la phrase non valide. Cela ne signifie pas que les mots sont faux.

C’est le format qui détermine quels portefeuilles acceptent votre phrase de récupération, quelles options choisir pour la restaurer et comment se déroule une récupération lorsqu’un mot manque ou est erroné.

Ce qui distingue la phrase Electrum de BIP-39

BIP-39, la norme qu’utilisent Ledger, MetaMask et de nombreux autres portefeuilles, intègre une somme de contrôle dans les mots. Selon la spécification BIP-39, quelques bits issus d’un hachage SHA-256 des données aléatoires sont ajoutés avant le choix des mots : le dernier mot est donc en partie calculé à partir des autres, avec 4 bits de somme de contrôle dans une phrase de 12 mots et 8 dans une phrase de 24 mots. Ledger explique que c’est ainsi que ses appareils peuvent détecter une phrase mal saisie.

Electrum procède autrement. Depuis la version 2.0, il applique à la phrase entière un hachage à clé (HMAC-SHA512) et lit les premiers caractères hexadécimaux du résultat. Ces caractères constituent le numéro de version de la phrase, et une phrase n’est valide que s’ils correspondent à une version enregistrée. La documentation Electrum Seed Version System et le code source d’Electrum en définissent quatre :

Ainsi, une phrase BIP-39 valide n’est presque jamais une phrase Electrum valide, et l’inverse est rare aussi. Même une phrase qui passe les deux vérifications ouvre deux portefeuilles sans aucun lien entre eux, car, pour transformer les mots en seed, Electrum utilise le sel « electrum », alors que BIP-39 utilise « mnemonic ». Aucune des deux phrases n’est fausse ; elles suivent des règles différentes.

Pourquoi Electrum a choisi son propre format

Electrum a été créé par Thomas Voegtlin en novembre 2011, environ deux ans avant que BIP-39 ne soit proposé. Ses premières phrases, utilisées jusqu’à la version 2.0 en mars 2015, encodaient le nombre aléatoire directement en mots tirés d’une liste fixe, ce qui lie chaque version ultérieure du logiciel à cette liste précise.

La version 2.0 est passée à des phrases dont les clés et le numéro de version proviennent tous deux d’un hachage de la phrase. La documentation d’Electrum donne deux raisons de ne pas avoir adopté BIP-39 à la place : BIP-39 a toujours besoin de sa liste de mots pour calculer la somme de contrôle, et une phrase BIP-39 ne contient aucun numéro de version. Sans numéro de version, le portefeuille doit connaître, ou deviner, le type d’adresse et le chemin de dérivation que vous avez utilisés, et un mauvais choix se traduit par un portefeuille vide plutôt que par un message d’erreur. La spécification BIP-39 elle-même cite désormais l’absence de version parmi ses faiblesses.

Grâce au préfixe, la phrase se décrit elle-même : lorsque le hachage commence par 100, Electrum sait aussitôt qu’il s’agit d’un portefeuille SegWit et quelle dérivation suivre. Le prix à payer, c’est la compatibilité avec les portefeuilles qui ne comprennent que BIP-39. Electrum importe les phrases BIP-39 pour permettre d’accéder à des fonds conservés dans d’autres portefeuilles, mais n’en crée pas.

Phrase de récupération refusée par Electrum : les points à vérifier

Si Electrum refuse vos mots, passez en revue ces causes :

• La phrase est au format BIP-39. Elle provient d’un Ledger ou d’un autre portefeuille BIP-39. Sélectionnez Graine BIP39 dans Options, et Electrum l’accepte.
• La phrase est au format SLIP-39. Depuis juin 2024, les appareils Trezor Safe créent par défaut une sauvegarde Shamir (SLIP-39) de 20 mots. Electrum l’importe avec l’option SLIP39 seed.
• Un mot est mal orthographié, manquant ou mal placé. Un seul mot modifié suffit généralement à faire échouer l’une ou l’autre vérification.
• C’est une phrase Electrum antérieure à la version 2.0. Les anciennes phrases utilisent une autre liste de mots : un mot absent de la liste BIP-39 peut donc être correct.
• C’est une phrase 2FA. Elle se restaure en tant que Portefeuille avec authentification à deux facteurs ; voir notre article sur la récupération Electrum 2FA.

Une extension de seed manquante n’amène jamais Electrum à refuser les mots. Electrum accepte la phrase et ouvre un autre portefeuille, vide, comme l’explique plus bas la section sur les extensions de seed.

Comment savoir si votre phrase est au format Electrum ou BIP-39

Retrouver l’origine des mots

Identifiez l’application qui a généré la phrase à l’origine, et pas seulement le portefeuille dans lequel vous l’avez utilisée en dernier. Une phrase créée par un autre portefeuille puis importée dans Electrum conserve son format d’origine. Si vous avez créé le portefeuille dans Electrum sans jamais importer de mots venus d’ailleurs, vous avez une phrase Electrum. Des mots provenant d’un portefeuille matériel ou d’une autre application sont très probablement au format BIP-39, ou SLIP-39 pour un Trezor récent.

Une ancienne installation, le fichier de portefeuille et des notes sur l’appareil ou la version du logiciel peuvent aider à déterminer cette origine. Une adresse publique de réception connue permettra ensuite de comparer le résultat de la restauration, sans divulguer la phrase.

Tester la phrase dans Electrum

Utilisez une version d’Electrum téléchargée depuis electrum.org, sur un ordinateur de confiance. Dans l’application de bureau, créez un nouveau portefeuille, choisissez Portefeuille standard puis Je possède déjà une graine, et saisissez les mots sans modifier aucune option.

1. Si Electrum accepte les mots, il affiche le type détecté, par exemple le type de graine segwit, standard ou old. Vous avez alors une phrase créée par Electrum.
2. Sinon, cliquez sur Options et sélectionnez Graine BIP39. Une phrase BIP-39 est alors acceptée. Si le message BIP39 checksum failed s’affiche, Electrum vous laisse tout de même continuer, mais le portefeuille restauré sera presque à coup sûr vide.
3. Si aucune des deux méthodes ne fonctionne, la phrase contient très probablement un mot mal orthographié, interverti ou manquant. Vérifiez chaque mot dans la liste de mots BIP-39 et comparez tout mot qui n’y figure pas avec la liste qu’utilisait Electrum avant la version 2.0. Notre guide sur une phrase de récupération non valide présente d’autres vérifications.

Pendant vos essais, conservez le document original sans le modifier. Si les mots appartiennent à un portefeuille matériel que vous possédez encore, connectez l’appareil via l’option Utiliser un périphérique matériel au lieu de saisir sa phrase sur un ordinateur. Le rejet d’une phrase Electrum par un vérificateur BIP-39 ne prouve pas qu’elle est incorrecte. Ne collez jamais une vraie phrase dans un vérificateur en ligne.

La liste de mots d’Electrum

Electrum 2.0 et les versions suivantes utilisent la liste anglaise standard de BIP-39, soit 2 048 mots ; le fichier présent dans le code source d’Electrum est identique à celui publié avec BIP-39. Seules la validation et la dérivation des clés diffèrent.

Les versions d’Electrum antérieures à la 2.0 utilisaient une autre liste de 1 626 mots, dont environ la moitié seulement figure aussi dans la liste BIP-39. Des mots comme « actually » ou « anything » n’existent que dans l’ancienne liste : une phrase de 12 mots qui en contient n’est donc pas une phrase BIP-39, et il s’agit très probablement d’une ancienne phrase Electrum. Les versions actuelles d’Electrum reconnaissent toujours ces phrases automatiquement : saisissez les mots, et Electrum détecte l’ancien format.

Electrum-LTC et autres forks

Electrum lui-même ne prend en charge que Bitcoin. Sa FAQ explique que les portefeuilles pour d’autres cryptomonnaies construits à partir de son code sont des projets distincts, avec leurs propres mainteneurs.

Electrum-LTC, la version pour Litecoin, utilise le même format de phrase, la même liste de mots et la même dérivation des clés qu’Electrum. Une même phrase produit donc les mêmes clés privées dans les deux applications, mais chacune affiche son propre format d’adresse et ne consulte que sa propre blockchain. Une phrase Electrum-LTC restaurée dans Electrum pour Bitcoin ouvre un portefeuille valide mais vide ; restaurez-la dans Electrum-LTC pour voir vos litecoins.

Electron Cash, le portefeuille Bitcoin Cash issu d’un fork d’Electrum, restaure toujours les phrases Electrum, mais crée désormais des phrases BIP-39 par défaut. Restaurez la phrase d’un fork dans l’application qui l’a créée.

Extensions de seed (le 13e mot)

Electrum vous permet d’ajouter des mots personnalisés à votre phrase et appelle cela une extension de seed : c’est l’option Étendre la graine avec des mots personnalisés, dans Options, lorsque vous créez ou restaurez un portefeuille. On parle souvent du 13e mot, même s’il peut s’agir de n’importe quel texte. D’autres portefeuilles parlent de passphrase, et pour une phrase BIP-39 importée, c’est cette option qui permet d’en saisir une.

L’extension modifie chaque clé : la même phrase avec une autre extension, ou sans extension, produit un portefeuille complètement différent. Sans la bonne extension, la bonne phrase restaure un portefeuille valide mais vide, et Electrum n’affiche aucune erreur. L’assistant d’Electrum avertit que l’extension doit être conservée avec la phrase. Les phrases antérieures à Electrum 2.0 ne peuvent pas en avoir.

Une extension de seed est distincte du mot de passe qui chiffre le fichier de portefeuille local. Lors d’une restauration à partir de toutes les informations de la phrase, vous pouvez définir un nouveau mot de passe pour le nouveau fichier de portefeuille. Cela ne remplace pas une extension de seed inconnue : changer l’extension change les clés dérivées de la phrase.

Si vous ne vous souvenez plus de votre extension de seed, la récupération devient une recherche de passphrase : des candidats sont testés avec la phrase complète jusqu’à ce que l’un d’eux produise les adresses attendues, un peu comme pour la récupération d’un mot de passe. Consultez notre guide pour retrouver une passphrase de portefeuille oubliée.

Ce que cela implique pour la récupération

Restaurer une phrase créée par Electrum

Une phrase créée par Electrum se restaure dans Electrum, ou dans le fork qui l’a créée. Un portefeuille qui ne prend en charge que BIP-39, y compris un appareil Ledger, la refusera ou en dérivera d’autres adresses, vides. Pour transférer vos bitcoins vers un autre portefeuille, restaurez-la d’abord dans Electrum, puis envoyez les fonds vers une adresse de réception du nouveau portefeuille.

Restaurer une phrase BIP-39 dans Electrum

Une fois Graine BIP39 sélectionnée, Electrum demande le type de script et le chemin de dérivation. Il propose legacy (p2pkh), p2sh-segwit (p2wpkh-p2sh) et native segwit (p2wpkh), chacun avec un chemin suggéré que vous pouvez modifier. Choisissez le type qu’utilisait le portefeuille d’origine. Le bouton Détecter les comptes existants examine les chemins de dérivation connus à la recherche d’un historique et vous laisse choisir celui qui contient vos fonds. Si le portefeuille d’origine utilisait un autre chemin, la restauration affiche un solde nul, alors même que les mots sont corrects.

Si le portefeuille restauré est vide

Si le portefeuille restauré semble vide, comparez une adresse de réception connue avant de modifier quoi que ce soit. Vérifiez d’abord le format de la phrase, l’extension et le type de portefeuille. Pour un portefeuille BIP-39 importé, le type d’adresse et le chemin de dérivation d’origine comptent aussi. Conservez le fichier de portefeuille original pendant ces vérifications.

Si les adresses attendues correspondent, mais que des transactions manquent, vérifiez la synchronisation avant d’essayer une autre phrase. La recherche d’adresses peut aussi jouer un rôle lorsque des adresses inutilisées séparent celles que vous avez utilisées. Electrum cesse en effet de chercher après 20 adresses inutilisées consécutives ; c’est le gap limit décrit dans la FAQ d’Electrum. Suivez la documentation d’Electrum plutôt que d’exécuter des commandes de console inconnues ou de modifier à plusieurs reprises le fichier original. Notre page sur un solde nul après restauration passe en revue les mêmes vérifications.

Si des mots manquent ou sont erronés

Si la phrase est incomplète ou contient des erreurs, c’est le format qui détermine comment la reconstituer. Les candidats pour les positions incertaines sont filtrés par la vérification propre au format, puis confirmés à l’aide d’une adresse connue. Pour une phrase Electrum, ce filtre est la vérification de version, qui écarte un mauvais candidat avant même qu’une clé soit dérivée ; BIP-39 utilise sa somme de contrôle, et une phrase antérieure à la version 2.0 n’en possède aucune. Identifier le type de seed est donc la première étape de tout dossier de récupération.

Crypto Recovers travaille sur des phrases auxquelles il manque jusqu’à quatre mots ; notre guide pour retrouver des mots manquants dans une phrase explique la méthode. Personne ne peut reconstituer une phrase entièrement perdue, sans fichier de portefeuille ni aucun autre élément.

Les problèmes de phrase impossibles à résoudre par vous-même

Plusieurs mots incertains, un ordre des mots erroné, une extension oubliée ou une phrase dont l’origine reste floue peuvent exiger davantage qu’une nouvelle tentative de restauration. Crypto Recovers réalise des récupérations depuis 2019 et traite tous les formats de phrase Electrum, des phrases antérieures à la version 2.0 aux phrases SegWit actuelles : nous identifions le format, puis testons hors ligne des candidats à l’aide d’une adresse connue, dans le cadre d’un accord écrit. Le premier contact ne nécessite aucun de vos secrets : ne transmettez donc jamais les mots de votre phrase, un mot de passe ou un fichier de portefeuille via un formulaire, un e-mail ou un site web. La première évaluation est gratuite, le travail suit le principe « Pas de récupération, pas de frais », et notre service de récupération Electrum explique comment un dossier est évalué.

Documentation officielle

• Electrum Seed Version System
• Electrum: Frequently Asked Questions
• Electrum: Two Factor Authentication
• BIP-39: Mnemonic code for generating deterministic keys

FAQ sur la phrase de récupération Electrum

Puis-je convertir une phrase Electrum en phrase BIP-39 ?

Non. Les deux formats ne valident pas les mots de la même manière et ne dérivent pas les clés de la même façon, et il n’existe aucune conversion de l’un à l’autre. Pour changer de format, créez un nouveau portefeuille BIP-39, sauvegardez sa phrase et envoyez-y vos fonds depuis Electrum.

Electrum prend-il en charge les phrases de récupération de 24 mots ?

Oui, pour la restauration. L’assistant d’Electrum crée des phrases de 12 mots, mais il restaure des phrases BIP-39 de 24 mots provenant d’autres portefeuilles : cliquez sur « Options » et sélectionnez « Graine BIP39 ». Des phrases Electrum plus longues peuvent aussi être créées avec make_seed, en ligne de commande, et Electrum les reconnaît sans l’option BIP-39.

Qu’est-ce que la somme de contrôle d’une phrase Electrum ?

Electrum n’a pas de mot de somme de contrôle distinct. Il calcule un hachage de la phrase entière et vérifie que le résultat commence par un numéro de version enregistré, par exemple 01 pour un portefeuille standard ou 100 pour SegWit, ce qui confirme en un seul test les mots et le type de portefeuille. Une phrase aléatoire passe la vérification du type standard environ une fois sur 256, contre environ une fois sur 16 pour la somme de contrôle d’une phrase BIP-39 de 12 mots.

Ma phrase Electrum fonctionne, mais le solde affiché est faux. Pourquoi ?

Une phrase créée par Electrum fixe elle-même le type de portefeuille : vérifiez donc d’abord l’extension de seed, car sans celle utilisée à la création, la phrase ouvre un autre portefeuille, vide. Laissez ensuite Electrum terminer la synchronisation et pensez au gap limit de 20 adresses inutilisées. Pour une phrase BIP-39 importée, la cause probable est un type de script ou un chemin de dérivation différent de celui du portefeuille d’origine ; « Détecter les comptes existants » peut retrouver le bon.