WIF (Wallet Import Format) - Glossaire Bitcoin

Définition

WIF (Wallet Import Format) est un encodage standard permettant de représenter une clé privée Bitcoin de 32 octets sous forme de chaîne lisible et copiable. Conçu pour faciliter l'import/export entre wallets, il a été popularisé par Bitcoin Core dès les premières versions et reste le format de référence pour les clés privées isolées (non dérivées d'une seed).

Comment c'est construit

L'algorithme WIF est une variante de Base58Check :

Prendre la clé privée brute (32 bytes).
Préfixer avec un byte de version : 0x80 pour mainnet, 0xef pour testnet.
Ajouter (optionnellement) un suffixe 0x01 si la clé est destinée à dériver une pubkey compressée.
Calculer SHA256(SHA256(payload)) et prendre les 4 premiers bytes comme checksum.
Concaténer payload + checksum et encoder en Base58.

| Forme | Premier caractère mainnet | Pubkey associée | |---|---|---| | WIF non-compressé | 5 | Pubkey 65 bytes | | WIF compressé | K ou L | Pubkey 33 bytes |

Exemple

Une clé WIF compressée mainnet : L1aW4aubDFB7yfras2S1mN3bqg9nwySY8nkoLmJebSLD5BWv3ENZ. C'est la même valeur cryptographique qu'une seed BIP-39 dériverait pour un seul chemin, mais sous forme autonome.

Cas d'usage

Paper wallets historiques (avant les seed mnemonics BIP-39).
Brain wallets (déconseillés, sujets à attaques par dictionnaire).
Sweep : importer temporairement une clé WIF dans un wallet pour vider ses fonds vers une nouvelle adresse.
Outils comme bitcoin-cli importprivkey ou Electrum acceptent le format WIF.

Dangers

Une clé WIF en clair = vos bitcoins. Toute personne qui la lit (capture d'écran, presse-papiers, cloud sync, photo) peut vider vos fonds. À l'ère des seed phrases BIP-39 et des hardware wallets, l'usage du WIF se limite aux cas de récupération ponctuelle. Ne jamais réutiliser une adresse après en avoir sweepé la clé WIF : on présume qu'elle est compromise.

À retenir

Le WIF reste utile pour des opérations de niveau bas (debugging, sweep), mais il a été largement supplanté par les seeds BIP-39 et les xprv hiérarchiques pour la gestion quotidienne.