tprv

Définition et origine

tprv est le préfixe Base58 d'une clé étendue privée (extended private key, xprv) définie par le BIP-32 pour les réseaux de test de Bitcoin. Il s'oppose à xprv qui désigne la version mainnet. La distinction est codée dans les 4 premiers octets du blob versionné avant encodage Base58Check : 0x04358394 (testnet) vs 0x0488ADE4 (mainnet).

Comment ça fonctionne

Une clé tprv contient :

| Champ | Taille | Rôle | |---|---|---| | Version | 4 octets | Identifie testnet privé (tprv) | | Depth | 1 octet | Profondeur dans l'arbre BIP-32 | | Parent fingerprint | 4 octets | Hash de la clé parente | | Child number | 4 octets | Index de dérivation | | Chain code | 32 octets | Pour la dérivation HMAC | | Private key | 33 octets | 0x00 + scalar secret |

L'ensemble est encodé en Base58Check et donne une chaîne d'environ 111 caractères commençant invariablement par tprv8.... La clé permet de dériver toutes les clés enfants privées via les chemins BIP-32 (m/84'/1'/0'/0/0 par exemple, où 1' désigne testnet).

Cas d'usage

| Contexte | Pourquoi tprv | |---|---| | Développement | Tester un wallet sans risque | | Intégration CI | E2E tests automatisés | | Formation | Enseigner BIP-32 | | Demo Lightning | Channels testnet/signet |

Sur signet, le préfixe est généralement tprv également, bien que certains projets utilisent des préfixes dérivés. Le réseau Regtest local utilise lui aussi tprv.

Limites

Le format tprv ne porte pas d'information sur le type d'adresses dérivées (P2PKH, P2WPKH, P2TR). Pour cela, il faut compléter par un descriptor (tr(...), wpkh(...)) ou un préfixe alternatif (tpub, upub, vpub pour les variantes BIP-49/84).

À retenir

Jamais aucun bitcoin réel ne doit être envoyé à une adresse dérivée d'un tprv. Si vous le voyez exporté par un wallet, c'est que vous êtes en mode test : vérifiez votre configuration avant toute opération avec de vrais fonds. Voir aussi tpub pour la version publique.