Présentation : ColdCard et le standard BIP39
Le ColdCard est un portefeuille matériel (hardware wallet) spécialisé dans la sécurité des bitcoins, réputé pour son fonctionnement en déconnexion totale (air-gapped) et son respect strict des standards cryptographiques. Parmi ces standards, le BIP39 (Bitcoin Improvement Proposal 39) définit la génération de mots mnémoniques : une séquence de mots faciles à retenir et à sauvegarder, qui permet de retrouver l’ensemble des clés privées d’un portefeuille.
Un point essentiel du BIP39 est la présence de bits de contrôle (checksum) intégrés à la séquence de mots. Ces bits permettent de vérifier l’intégrité de la séquence : si un mot est mal orthographié, mal placé ou erroné, la validation des bits de contrôle échoue immédiatement. Pour les utilisateurs de ColdCard, maîtriser le calcul de ces bits est indispensable pour vérifier de manière autonome la validité de leurs mnémoniques, conformément au principe « ne faites pas confiance, vérifiez ».
Principe fondamental des bits de contrôle BIP39
Avant de passer au calcul concret, il est important de comprendre la structure d’une séquence mnémonique BIP39 :
- Entropie initiale : c’est une séquence de bits aléatoires générée de manière cryptographiquement sûre. Sa longueur est obligatoirement un multiple de 32 bits : 128, 160, 192, 224 ou 256 bits.
- Bits de contrôle : on calcule le hachage SHA256 de l’entropie initiale, puis on récupère les
npremiers bits de ce hachage, oùn = longueur de l’entropie / 32. - Séquence totale : on concatène l’entropie initiale et les bits de contrôle pour obtenir une séquence de bits dont la longueur est un multiple de 11.
- Conversion en mots : on découpe la séquence totale en paquets de 11 bits, chaque paquet correspondant à un index (de 0 à 2047) dans la liste officielle de 2048 mots du BIP39.
Par exemple :
- Pour une séquence de 12 mots : 128 bits d’entropie + 4 bits de contrôle = 132 bits, soit 12 paquets de 11 bits.
- Pour une séquence de 24 mots (la plus utilisée sur ColdCard) : 256 bits d’entropie + 8 bits de contrôle = 264 bits, soit 24 paquets de 11 bits.
Étapes de calcul des bits de contrôle pour ColdCard
Que vous souhaitiez vérifier une séquence générée par votre ColdCard ou créer votre propre séquence à partir d’entropie générée manuellement (par exemple avec des dés), les étapes de calcul sont identiques.

Prérequis
- La liste officielle des mots BIP39 dans la langue utilisée par votre ColdCard (français, anglais, etc.)
- Un outil de conversion binaire/décimal et de calcul de hachage SHA256 (de préférence utilisé sur un appareil hors connexion pour éviter tout vol de données)
- La séquence de mots mnémoniques dans le bon ordre
Étape 1 : Convertir chaque mot en son index binaire de 11 bits
Pour chaque mot de la séquence, retrouvez son index dans la liste BIP39 (de 0 à 2047), puis convertissez cet index en une valeur binaire de 11 bits, en complétant par des zéros à gauche si nécessaire.
Par exemple, si le mot est « abandon » (premier mot de la liste anglaise), son index est 0, soit la valeur binaire 00000000000. Si le mot est « zèbre » (dernier mot de la liste française), son index est 2047, soit 11111111111.
Étape 2 : Concaténer les valeurs binaires
Rassemblez toutes les valeurs binaires de 11 bits dans l’ordre des mots de la séquence, pour former une seule longue chaîne de bits.
Pour une séquence de 24 mots, vous obtiendrez une chaîne de 264 bits.
Étape 3 : Séparer l’entropie et les bits de contrôle

Découpez la chaîne de bits en deux parties :
- La partie la plus longue correspond à l’entropie initiale : sa longueur est
(nombre de mots * 11) * 32 / 33bits. - La partie la plus courte correspond aux bits de contrôle : sa longueur est
(nombre de mots * 11) / 33bits, soitnombre de mots / 3bits (car 11/33 = 1/3).
Par exemple, pour 24 mots :
- Entropie : 24 * 11 * 32 / 33 = 256 bits
- Bits de contrôle : 24 / 3 = 8 bits
Étape 4 : Calculer le hachage SHA256 de l’entropie
Convertissez la chaîne de bits de l’entropie en une séquence d’octets (8 bits par octet, en ordre gros boutiste (big-endian)), puis calculez son hachage SHA256.
Récupérez ensuite les n premiers bits de ce hachage, où n est la longueur des bits de contrôle calculée à l’étape précédente.
Étape 5 : Comparer les bits calculés et les bits de la séquence
Si les n premiers bits du hachage SHA256 sont identiques aux bits de contrôle extraits de la séquence de mots, alors votre séquence mnémonique est valide. Si ce n’est pas le cas, il y a une erreur dans la séquence (mot erroné, mauvais ordre, etc.).
Cas d’usage pratiques pour les utilisateurs de ColdCard

Vérification d’une séquence générée par ColdCard
Lorsque vous configurez votre ColdCard pour la première fois, l’appareil génère une séquence de 24 mots mnémoniques. Vous pouvez appliquer la méthode de calcul des bits de contrôle pour vérifier de manière autonome que la séquence est conforme au standard BIP39, et que l’appareil n’a pas été compromis.
Important : effectuez toujours cette vérification sur un appareil hors connexion, et ne saisissez jamais vos mots mnémoniques sur un outil en ligne.
Génération d’une séquence personnalisée
ColdCard permet d’importer votre propre entropie (générée par exemple avec des dés, pour une source de hasard entièrement contrôlée). Dans ce cas, vous devez calculer vous-même les bits de contrôle pour former une séquence BIP39 valide, que vous pourrez ensuite importer sur votre ColdCard.
Erreurs courantes à éviter
- Mauvaise orthographe des mots : même une petite erreur d’orthographe change l’index du mot et invalide le calcul. Vérifiez chaque mot dans la liste officielle BIP39.
- Mauvais ordre des mots : la séquence doit être respectée exactement comme elle a été générée.
- Utilisation d’une mauvaise liste de mots : les listes BIP39 varient selon la langue ; assurez-vous d’utiliser la même langue que celle configurée sur votre ColdCard.
- Erreur de conversion binaire : n’oubliez pas de compléter les valeurs binaires à 11 bits avec des zéros à gauche, et de respecter l’ordre gros boutiste (big-endian) pour la conversion en octets.
- Calcul sur appareil connecté : ne jamais saisir vos mots mnémoniques sur un ordinateur ou un téléphone connecté à Internet, au risque de les exposer à des pirates.
Conclusion
La maîtrise du calcul des bits de contrôle BIP39 est un atout essentiel pour les utilisateurs de ColdCard qui souhaitent renforcer la sécurité de leurs portefeuilles. Elle permet de vérifier de manière autonome l’intégrité de vos séquences mnémoniques, sans dépendre de la confiance accordée à l’appareil. En respectant les étapes décrites et les bonnes pratiques de sécurité, vous pourrez valider vos mnémoniques en toute sérénité.