Codificador e Decodificador Bech32 / Bech32m
Detalhes técnicos
Como funciona a ferramenta Bech32 / Bech32m
O que a ferramenta Bech32 faz
Bech32 e Bech32m são codificações com checksum que transformam dados binários em uma string curta de letras minúsculas e dígitos. São usadas em endereços SegWit e Taproot do Bitcoin, chaves do Nostr (npub, nsec, note), contas Cosmos, endereços Cardano e invoices Lightning. Toda string tem três partes: uma parte legível por humanos (HRP), como bc ou npub, o separador 1 e uma parte de dados cujos últimos seis caracteres são um checksum. Esta ferramenta decodifica qualquer string Bech32 ou Bech32m, detecta qual das duas variantes corresponde ao checksum e mostra o HRP, os dados em hex, Base64 e palavras brutas de 5 bits, além de uma dica de rede para prefixos conhecidos. Ela também pode codificar seu próprio HRP e seus dados, e valida endereços SegWit pela versão do witness e pelo tamanho do programa. Tudo é executado localmente no seu navegador.
Casos de uso comuns
Desenvolvedores decodificam endereços bc1 e tb1 para inspecionar a versão do witness e o programa de 20 ou 32 bytes, verificar se um endereço é Taproot (versão 1, Bech32m) ou SegWit nativo (versão 0, Bech32) e montar fixtures de teste para carteiras e nós. Desenvolvedores do Nostr convertem um npub na chave pública em hex usada dentro dos eventos, e vice-versa. Integradores de Cosmos e Cardano verificam qual HRP um endereço carrega e recuperam seus bytes brutos. Quando uma string falha na validação, a ferramenta informa o motivo e, no caso de um único caractere digitado errado, a posição provável do erro, o que ajuda ao copiar um endereço manualmente.
Variantes, entradas e limites
Bech32 (BIP-173) usa a constante de checksum 1 e é exigido para SegWit versão 0 e para o Nostr. Bech32m (BIP-350) usa a constante 0x2bc830a3, corrige uma fraqueza do checksum original e é exigido para SegWit versão 1 e superiores, incluindo Taproot. As strings são limitadas a 90 caracteres, a menos que você ative a opção de strings longas usada por dados no estilo Lightning. A entrada deve estar toda em minúsculas ou toda em maiúsculas. No modo de codificação, os dados podem ser informados em hex, texto UTF-8 ou Base64, e o modo SegWit recebe uma versão do witness e um programa em hex. HRPs conhecidos incluem bc, tb e bcrt para Bitcoin, ltc, cosmos, osmo, npub, nsec, note, addr e lnbc.
Armadilhas e limites
Um checksum válido apenas prova que a string não foi digitada errado; não prova que um endereço pertence a alguém nem que é possível receber fundos com segurança, e esta ferramenta não se comunica com nenhuma rede. Usar a variante errada, por exemplo Bech32 para um endereço Taproot, produz um endereço que as carteiras rejeitam. Maiúsculas e minúsculas misturadas são sempre inválidas, e o dígito 1 pode aparecer no HRP, então o separador é o último 1. Strings como nsec guardam chaves privadas: a decodificação acontece apenas no seu navegador, mas trate qualquer chave secreta como comprometida depois de colada em qualquer site e prefira valores fictícios nos testes.