Une clé avec des dés
Un portefeuille papier (paper wallet) mérite autant de confiance que celui qui l'a fait. Si vous le faites vous-même, la confiance reste à la maison. Voici comment, avec des dés à la place du hasard de l'ordinateur.
Le programme est paperwallet-tools, de Marco Amadori. C'est un logiciel libre, sous licence GNU GPL version 3 ou ultérieure, et ce guide suit la version 0.1.1. Il tourne en ligne de commande, il est testé sur Debian, et il fait deux choses :
paperwallet.pycrée une adressebc1q…avec sa clé privée, et les imprime sur une carte grande comme une carte bancaire. À l'extérieur, il y a l'adresse, pour recevoir et vérifier le solde. À l'intérieur, pliée et couverte par un motif qui la cache à contre-jour, la clé qui dépense.paperseed.pycrée les mots de récupération, 12 ou 24, et les imprime sur une carte plus grande.
Les deux écrivent un PDF à imprimer en recto verso et un fichier .md avec les mêmes données.
Pourquoi des dés
Sans dés, la clé naît de 32 octets aléatoires de /dev/random, et c'est le choix recommandé. Les dés servent à ceux qui ne veulent pas confier le hasard à l'ordinateur : le hasard, c'est vous qui l'apportez, un lancer à la fois. La clé est le SHA-256 de ce que vous écrivez.
Il en faut beaucoup. Pour une clé de 256 bits :
| Ce que vous lancez | Chaque lancer | Lancers pour 256 bits |
|---|---|---|
| Dé à 16 faces, de 0 à F | un chiffre hexadécimal, 4 bits | 64 |
| Dé à 6 faces | environ 2,6 bits | 100 |
| Pièce, 1 pour face et 0 pour pile | 1 bit | 256 |
Un dé à 16 faces porte les chiffres de 0 à 9 et les lettres de A à F : chaque lancer est un chiffre hexadécimal. Ils sont rares, et la boutique de la Valley en vendait. Avec le dé à 6 faces, vous écrivez les numéros comme ils sortent, de 1 à 6. Les espaces et les retours à la ligne ne comptent pas, ni les majuscules et les minuscules.
→
Trois règles :
- Chaque chiffre vient d'un vrai lancer. Ne les écrivez pas au jugé et ne les corrigez pas : les gens ne savent pas être aléatoires.
- Pas de phrases inventées. Une phrase ou un mot de passe imaginés par une personne, c'est un brain wallet : tôt ou tard, quelqu'un les devine et vide le portefeuille.
- Les lancers valent autant que la clé. Les mêmes lancers donnent toujours la même clé. Si vous les notez sur une feuille, cette feuille doit être détruite.
Le programme estime combien de hasard il y a dans ce que vous écrivez. Si c'est sous les 256 bits, il vous prévient avant de demander autre chose, et vous vous arrêtez avec Ctrl-C. L'estimation est optimiste : elle signale les cas sûrement trop faibles, mais ne garantit pas les autres. Plus de lancers ne font pas de mal.
L'ordinateur et l'imprimante
- Une machine débranchée du réseau. De préférence un système live comme Tails, avec les fichiers en mémoire (tmpfs) et la machine éteinte à la fin.
- Une imprimante USB sans mémoire. Une imprimante réseau, ou avec une mémoire interne, peut garder une copie de ce qu'elle imprime.
- Ne photographiez jamais la carte ouverte, les lancers ou l'écran.
Le programme aussi fait sa part : au démarrage, il bloque les sockets de Python, ainsi ni lui ni ses bibliothèques ne peuvent ouvrir de connexions. Cela protège d'une connexion involontaire, mais ne remplace pas le débranchement.
Installer
On installe d'abord, sur une machine que vous débrancherez ensuite, ou sur le système live. Il faut Python 3 et cinq bibliothèques. Sur Debian :
sudo apt install libsecp256k1-6 python3-mnemonic python3-pycryptodome python3-reportlab python3-qrcode fonts-open-sans
Sur Debian 13 trixie, la bibliothèque s'appelle libsecp256k1-2 : mettez-la à la place de libsecp256k1-6. On peut aussi installer avec pip, dans un environnement virtuel, ou construire le paquet Debian : les instructions sont dans le README du projet.
Téléchargez le code depuis la page du projet, puis débranchez le réseau. Les programmes se lancent depuis le dossier du projet, comme ./paperwallet.py et ./paperseed.py. S'il manque une bibliothèque, ils s'arrêtent et disent laquelle.
Le portefeuille papier, pas à pas
1. Un essai d'impression
On essaie d'abord avec un portefeuille jetable, sur signet, un réseau de test dont les satoshis ne valent rien : chaque panneau l'écrit en diagonale.
./paperwallet.py --network signet -o prova
Imprimez prova.pdf en A4, à l'échelle 100 % (pas « ajuster à la page »), en recto verso, en retournant sur le bord long. Regardez la feuille à contre-jour : les repères au centre des marges doivent coïncider. Ensuite, effacez les fichiers d'essai.
2. Le portefeuille, avec vos lancers
./paperwallet.py --entropy-prompt -o wallet
Le programme demande les lancers et ne les affiche pas pendant que vous écrivez. Il en sort wallet.pdf et wallet.md. À l'écran n'apparaissent que des données publiques, comme l'adresse : jamais la clé.
Vous pouvez aussi lire les lancers depuis un fichier, avec --entropy-file dadi.txt : ce fichier est un secret au même titre que la clé, et il doit rester en mémoire puis être effacé. Il existe aussi --entropy-string, mais le texte finirait dans l'historique du shell.
Si vous voulez la clé protégée par un mot de passe, ajoutez --bip38 : le mot de passe est demandé deux fois et ne s'affiche jamais. Avec les deux copies prévues par défaut, l'une est en clair et l'autre chiffrée.
3. Imprimer, couper, plier
Chaque feuille porte deux bandes : par défaut, deux copies du même portefeuille, à garder dans des endroits différents. Coupez le long des repères et pliez en suivant les étapes imprimées au verso : côté de la clé vers le haut, puis les lignes 1, 2 et 3 dans l'ordre. À l'extérieur restent l'adresse et la couverture, à l'intérieur la clé, sous au moins deux couches de papier de chaque côté.
Fermez le bord ouvert avec du ruban adhésif sur les deux bandes SEAL, et signez par-dessus le ruban : si quelqu'un ouvre la carte, ça se voit.
4. La vérification de l'adresse
Avant d'y envoyer de l'argent, importez la clé depuis le fichier .md dans un portefeuille hors ligne et vérifiez qu'elle donne l'adresse imprimée. Avec Electrum, on démarre ainsi :
electrum --offline
Ensuite, vous créez un nouveau portefeuille avec « Import Bitcoin addresses or private keys » et vous collez le texte du QR code de la clé, celui qui commence par p2wpkh:.
5. Effacer, et éteindre
Effacez wallet.pdf et wallet.md, ou mettez-les dans une archive chiffrée. Puis éteignez la machine.
Les mots de récupération avec des dés
C'est la même chose pour les mots de récupération :
./paperseed.py --entropy-prompt -o parole
Il en sort 24 mots, ou 12 avec --words 12, sur une carte par feuille A4 qui, pliée, mesure 148 × 60 mm.
À l'intérieur, il y a les mots numérotés et un SeedQR, que lisent SeedSigner, Blockstream Jade et BlueWallet, entre autres, plus un second QR code avec les mots en clair pour les portefeuilles qui ne lisent pas le SeedQR, comme Electrum. À l'extérieur, il y a la clé publique étendue du compte, la xpub : elle suffit à un portefeuille en lecture seule pour suivre le solde, et elle ne dépense pas.
Avec --passphrase, vous ajoutez une passphrase : demandée deux fois, jamais imprimée. La carte dit seulement qu'elle est nécessaire.
Essai d'impression, découpe, pliage et scellé sont les mêmes. Ensuite, comme pour les mots dans le métal de la leçon 6, avant de faire confiance, essayez de restaurer le portefeuille à partir de la carte, avec quelques satoshis. À la fin, effacez parole.pdf et parole.md, ou chiffrez-les.
Pour qui reçoit la carte
Un portefeuille papier, c'est un beau cadeau. Les instructions pour celui qui le reçoit sont imprimées à l'intérieur ; en bref :
- Vérifiez le solde avec l'adresse seulement, dans un portefeuille en lecture seule (watch-only). Comment le faire en privé est expliqué dans la leçon 3. Pour un coup d'œil rapide, il y a ericonto : vous scannez l'adresse et vous voyez le solde.
- Quand vous voulez dépenser, faites le sweep : ouvrez la carte et, depuis un appareil de confiance, déplacez tout le solde vers un portefeuille à vous. Dans Electrum, c'est Wallet › Private keys › Sweep, et vous scannez le QR code de la clé. Dans Sparrow, c'est Tools › Sweep Private Key : choisissez Native SegWit et saisissez la clé sans
p2wpkh:. - Tout en une fois. Après le sweep, la clé ne sert plus, et on n'y reçoit plus d'argent.
- Détruisez chaque copie de la carte.
Pour vérifier l'adresse et pour le sweep, nous conseillons volontiers deux logiciels libres et non custodial : Electrum et Sparrow.
Ce que fait le programme, et ce qui vous reste
Le programme :
- bloque les sockets de Python au démarrage ;
- n'utilise pas de fichiers temporaires, et écrit le PDF et le
.mdune seule fois, lisibles par vous seul ; - avant d'écrire, vérifie son propre travail : de la clé à l'adresse, des mots à la graine ;
- à l'écran, n'affiche que des données publiques.
Il vous reste ce que le programme ne peut pas contrôler : la file d'impression du système, qui écrit sur disque, les imprimantes réseau ou avec mémoire, le swap. Et la mémoire de l'ordinateur : Python ne garantit pas d'en effacer les secrets. C'est pour cela que l'idéal reste un système live débranché, une imprimante USB sans mémoire et la machine éteinte à la fin.
Retour à la leçon 6 : conserver, et transmettre Toutes les leçons