Codificador e descodificador Bech32 / Bech32m
Detalhes técnicos
Como funciona a ferramenta Bech32 / Bech32m
O que faz a ferramenta Bech32
Bech32 e Bech32m são codificações com soma de verificação que transformam dados binários numa cadeia curta de letras minúsculas e dígitos. São usadas em endereços Bitcoin SegWit e Taproot, chaves Nostr (npub, nsec, note), contas Cosmos, endereços Cardano e faturas Lightning. Cada cadeia 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 carateres são uma soma de verificação. Esta ferramenta descodifica qualquer cadeia Bech32 ou Bech32m, deteta qual das duas variantes corresponde à soma de verificação e mostra o HRP, os dados em hex, Base64 e palavras de 5 bits em bruto, e uma indicação de rede para prefixos conhecidos. Também pode codificar o seu próprio HRP e dados, e valida endereços SegWit pela versão witness e pelo comprimento do programa. Tudo é executado localmente no seu navegador.
Casos de utilização comuns
Os programadores descodificam endereços bc1 e tb1 para inspecionar a versão witness e o programa de 20 ou 32 bytes, verificam se um endereço é Taproot (versão 1, Bech32m) ou SegWit nativo (versão 0, Bech32) e criam dados de teste para carteiras e nós. Os programadores Nostr convertem um npub na chave pública hex usada nos eventos, e vice-versa. Os integradores de Cosmos e Cardano verificam que HRP um endereço contém e recuperam os bytes em bruto. Quando uma cadeia falha a validação, a ferramenta indica o motivo e, no caso de um único caráter mal escrito, a posição provável do erro, o que ajuda ao copiar um endereço à mão.
Variantes, entradas e limites
O Bech32 (BIP-173) usa a constante de soma de verificação 1 e é obrigatório para SegWit versão 0 e para o Nostr. O Bech32m (BIP-350) usa a constante 0x2bc830a3, corrige uma fragilidade da soma de verificação original e é obrigatório para SegWit versão 1 e superiores, incluindo Taproot. As cadeias estão limitadas a 90 carateres, a menos que ative a opção de cadeias longas usada pelos dados do tipo Lightning. A entrada tem de estar toda em minúsculas ou toda em maiúsculas. No modo de codificação, os dados podem ser indicados em hex, texto UTF-8 ou Base64, e o modo SegWit recebe uma versão witness e um programa em hex. Os HRP conhecidos incluem bc, tb e bcrt para Bitcoin, ltc, cosmos, osmo, npub, nsec, note, addr e lnbc.
Armadilhas e limites
Uma soma de verificação válida apenas prova que a cadeia não foi mal escrita; não prova que um endereço pertence a alguém nem que é seguro receber fundos, e esta ferramenta não comunica com nenhuma rede. Usar a variante errada, por exemplo Bech32 num 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, pelo que o separador é o último 1. Cadeias como nsec contêm chaves privadas: a descodificação ocorre apenas no seu navegador, mas trate qualquer chave secreta como comprometida depois de a colar em qualquer site e prefira valores fictícios nos testes.