tpub - Glossaire Bitcoin

Définition et origine

tpub est le préfixe Base58 d'une clé étendue publique (extended public key, xpub) sur les réseaux de test Bitcoin (testnet, signet, regtest). Spécifié par le BIP-32, il correspond à la version mainnet xpub. Son rôle : exposer une arborescence d'adresses publiques dérivables sans risque, pour permettre des intégrations watch-only en environnement de développement.

Comment ça fonctionne

Une tpub contient les mêmes champs qu'une xpub, à l'exception de la clé : 33 octets de clé publique compressée à la place de la clé privée.

| Champ | Taille | |---|---| | Version (0x043587CF) | 4 octets | | Depth | 1 octet | | Parent fingerprint | 4 octets | | Child number | 4 octets | | Chain code | 32 octets | | Public key | 33 octets |

Encodée en Base58Check, la chaîne commence par tpub... et fait environ 111 caractères. Elle permet de dériver toutes les adresses enfants publiques via la dérivation non-durcie (BIP-32 simple).

Cas d'usage

| Scénario | Bénéfice | |---|---| | Wallet watch-only de test | Voir les balances sans signer | | Intégration e-commerce | Générer des adresses de réception sans clé privée | | Block explorer custom | Suivre un wallet entier | | Multisig de test | Partager les xpubs entre cosignataires | | Audit comptable | Donner accès en lecture seule |

À titre d'exemple, BTCPay Server peut être configuré en mode test avec une tpub, générant alors des adresses de paiement testnet sans aucun accès aux fonds.

Préfixes alternatifs

| Préfixe | BIP | Adresses | |---|---|---| | tpub | BIP-32 | P2PKH testnet (m..., n...) | | upub | BIP-49 | P2SH-P2WPKH testnet | | vpub | BIP-84 | P2WPKH testnet (tb1q...) |

Les wallets modernes préfèrent les descriptors (tr(tpub...), wpkh(tpub...)) qui combinent la clé et son script.

Limites

Une tpub ne porte aucun montant et aucun risque direct, mais sa fuite révèle l'ensemble des adresses passées et futures du wallet — sérieux problème de confidentialité. Ne la publiez jamais sur un site ou un service tiers, même en testnet.

À retenir

tpub est l'outil clé pour tester des intégrations Bitcoin sans engagement financier. Avant tout déploiement en production, on remplace simplement le tpub par un xpub issu d'un wallet hardware mainnet.