Codificador y decodificador Bech32 / Bech32m
Detalles técnicos
Cómo funciona la herramienta Bech32 / Bech32m
Qué hace la herramienta Bech32
Bech32 y Bech32m son codificaciones con checksum que convierten datos binarios en una cadena corta de letras minúsculas y dígitos. Se usan en las direcciones SegWit y Taproot de Bitcoin, en las claves de Nostr (npub, nsec, note), en las cuentas de Cosmos, en las direcciones de Cardano y en las facturas de Lightning. Toda cadena tiene tres partes: una parte legible por humanos (HRP), como bc o npub, el separador 1 y una parte de datos cuyos últimos seis caracteres son un checksum. Esta herramienta decodifica cualquier cadena Bech32 o Bech32m, detecta con cuál de las dos variantes coincide el checksum y muestra el HRP, los datos en hex, Base64 y palabras de 5 bits sin procesar, además de una pista de red para los prefijos conocidos. También puede codificar tu propio HRP y tus datos, y valida las direcciones SegWit por versión de witness y longitud del programa. Todo se ejecuta localmente en tu navegador.
Casos de uso habituales
Los desarrolladores decodifican direcciones bc1 y tb1 para inspeccionar la versión de witness y el programa de 20 o 32 bytes, comprobar si una dirección es Taproot (versión 1, Bech32m) o SegWit nativa (versión 0, Bech32) y crear datos de prueba para billeteras y nodos. Los desarrolladores de Nostr convierten un npub en la clave pública hex que se usa dentro de los eventos, y viceversa. Quienes integran Cosmos y Cardano comprueban qué HRP lleva una dirección y recuperan sus bytes sin procesar. Cuando una cadena no supera la validación, la herramienta indica el motivo y, si hay un único carácter mal escrito, la posición probable del error, lo que ayuda al copiar una dirección a mano.
Variantes, entradas y límites
Bech32 (BIP-173) usa la constante de checksum 1 y es obligatorio para SegWit versión 0 y para Nostr. Bech32m (BIP-350) usa la constante 0x2bc830a3, corrige una debilidad del checksum original y es obligatorio para SegWit versión 1 y superiores, incluido Taproot. Las cadenas están limitadas a 90 caracteres, salvo que actives la opción de cadenas largas que usan los datos al estilo Lightning. La entrada debe estar toda en minúsculas o toda en mayúsculas. En el modo de codificación los datos pueden darse como hex, texto UTF-8 o Base64, y el modo SegWit admite una versión de witness y un programa hex. Entre los HRP conocidos están bc, tb y bcrt para Bitcoin, ltc, cosmos, osmo, npub, nsec, note, addr y lnbc.
Errores frecuentes y límites
Un checksum válido solo demuestra que la cadena no se escribió mal; no demuestra que una dirección pertenezca a alguien ni que se puedan recibir fondos de forma segura, y esta herramienta no se comunica con ninguna red. Usar la variante equivocada, por ejemplo Bech32 para una dirección Taproot, produce una dirección que los billeteras rechazan. Mezclar mayúsculas y minúsculas nunca es válido, y el dígito 1 puede aparecer en el HRP, por lo que el separador es el último 1. Las cadenas como nsec contienen claves privadas: la decodificación ocurre solo en tu navegador, pero considera comprometida cualquier clave secreta que hayas pegado en un sitio web y usa valores ficticios para las pruebas.