Encodeur et décodeur Bech32 / Bech32m
Détails techniques
Comment fonctionne l’outil Bech32 / Bech32m
Ce que fait l’outil Bech32
Bech32 et Bech32m sont des encodages avec somme de contrôle qui transforment des données binaires en une courte chaîne de lettres minuscules et de chiffres. Ils servent pour les adresses SegWit et Taproot de Bitcoin, les clés Nostr (npub, nsec, note), les comptes Cosmos, les adresses Cardano et les factures Lightning. Chaque chaîne comporte trois parties : une partie lisible par l’humain (HRP), comme bc ou npub, le séparateur 1, et une partie données dont les six derniers caractères forment une somme de contrôle. Cet outil décode n’importe quelle chaîne Bech32 ou Bech32m, détecte laquelle des deux variantes correspond à la somme de contrôle, et affiche le HRP, les données en hex, en Base64 et en mots de 5 bits bruts, ainsi qu’une indication de réseau pour les préfixes connus. Il peut aussi encoder votre propre HRP et vos propres données, et valide les adresses SegWit selon la version witness et la longueur du programme. Tout s’exécute localement dans votre navigateur.
Cas d’usage courants
Les développeurs décodent des adresses bc1 et tb1 pour inspecter la version witness et le programme de 20 ou 32 octets, vérifier si une adresse est Taproot (version 1, Bech32m) ou SegWit native (version 0, Bech32), et construire des jeux de test pour les portefeuilles et les nœuds. Les développeurs Nostr convertissent un npub en clé publique hex utilisée dans les événements, et inversement. Les intégrateurs Cosmos et Cardano vérifient quel HRP porte une adresse et récupèrent ses octets bruts. Lorsqu’une chaîne échoue à la validation, l’outil indique la raison et, pour un seul caractère mal saisi, la position probable de l’erreur, ce qui aide lorsqu’on recopie une adresse à la main.
Variantes, entrées et limites
Bech32 (BIP-173) utilise la constante de somme de contrôle 1 et est requis pour SegWit version 0 et pour Nostr. Bech32m (BIP-350) utilise la constante 0x2bc830a3, corrige une faiblesse de la somme de contrôle d’origine et est requis pour SegWit version 1 et supérieures, y compris Taproot. Les chaînes sont limitées à 90 caractères, sauf si vous activez l’option de chaînes longues utilisée par les données de type Lightning. L’entrée doit être entièrement en minuscules ou entièrement en majuscules. En mode encodage, les données peuvent être fournies en hex, en texte UTF-8 ou en Base64, et le mode SegWit prend une version witness et un programme hex. Parmi les HRP connus : bc, tb et bcrt pour Bitcoin, ltc, cosmos, osmo, npub, nsec, note, addr et lnbc.
Pièges et limites
Une somme de contrôle valide prouve seulement que la chaîne n’a pas été mal saisie ; elle ne prouve pas qu’une adresse appartient à quelqu’un ni que des fonds peuvent être reçus en toute sécurité, et cet outil ne communique avec aucun réseau. Utiliser la mauvaise variante, par exemple Bech32 pour une adresse Taproot, produit une adresse que les portefeuilles rejettent. Le mélange de majuscules et de minuscules est toujours invalide, et le chiffre 1 peut apparaître dans le HRP : le séparateur est donc le dernier 1. Des chaînes comme nsec contiennent des clés privées : le décodage n’a lieu que dans votre navigateur, mais considérez toute clé secrète collée dans un site web comme compromise, et préférez des valeurs factices pour vos tests.