Aller au contenu principal
Cryptographie

Clé maîtresse

La clé maîtresse est la racine d'un wallet HD, dérivée directement de la seed via HMAC-SHA512. Toutes les clés filles sont obtenues par dérivation à partir d'elle. La compromettre revient à perdre tout le wallet. Elle n'apparaît jamais dans les transactions.

Définition

La clé maîtresse est la clé privée racine d'un wallet HD (Hierarchical Deterministic). Elle est dérivée de la seed via une fonction HMAC-SHA512 standardisée par le BIP-32. À partir d'elle, toute la descendance de clés (filles, petites-filles, etc.) est calculée de manière déterministe. Elle n'est jamais utilisée directement pour signer une transaction, mais elle est la racine logique du wallet.

Calcul à partir de la seed

I = HMAC-SHA512(key = "Bitcoin seed", data = seed)
master_private_key = I[0:32]
master_chain_code  = I[32:64]

Les 64 octets de sortie sont divisés en deux : 32 octets pour la clé maîtresse privée, 32 octets pour le code de chaîne maître. La combinaison forme la xprv racine. Cette construction garantit que la même seed produit toujours le même arbre, permettant de restaurer un wallet n'importe où.

Hiérarchie qui en découle

| Niveau | Notation BIP-32 | Exemple BIP-84 | |--------|----------------|----------------| | Racine | m | Clé maîtresse | | Purpose | m/84' | Témoignage des adresses bech32 | | Coin type | m/84'/0' | Bitcoin mainnet | | Account | m/84'/0'/0' | Compte principal | | Change | m/84'/0'/0'/0 | Adresses externes | | Index | m/84'/0'/0'/0/0 | Première adresse |

Chaque niveau passe par une dérivation HMAC-SHA512, soit en mode « hardened » (utilise la clé privée parente) soit en mode normal (utilise la clé publique).

Sensibilité extrême

Compromettre la clé maîtresse = compromettre l'intégralité du wallet, présent et futur, sur tous les comptes et toutes les chaînes dérivées. C'est pire que de perdre une seule clé enfant. C'est pourquoi :

  • La clé maîtresse n'est jamais utilisée directement
  • Elle est dérivée mémoire-seulement par les wallets, jamais persistée chiffrée à part la seed
  • Sa signature directe est interdite par les wallets sérieux
  • Les hardware wallets ne l'exposent jamais brute

Différence entre seed et clé maîtresse

| Élément | Format | Quantité d'entropie | Utilité | |---------|--------|---------------------|---------| | Seed (BIP-39) | 12-24 mots mnémoniques | 128-256 bits | Sauvegarde humaine | | Master key (BIP-32) | 32 octets binaires | 256 bits | Racine cryptographique |

La seed sert à l'humain (mémoriser, copier sur métal), la master key sert à la machine. La transformation seed → master key passe par PBKDF2-SHA512 + HMAC-SHA512 et est déterministe.

À retenir

La clé maîtresse est invisible mais omniprésente : c'est elle qui garantit la cohérence et la portabilité d'un wallet HD. Vous ne la verrez jamais en clair, mais sa protection (via la seed) est la pierre angulaire de votre self-custody.

Termes lies

← Retour au glossaire complet

Glossaire inspire du dictionnaire de Loic Morel sur Pandul.fr.