Codificador y decodificador z-base-32

z-base-32 es la variante de Base32 orientada a personas de Zooko Wilcox-O'Hearn: un alfabeto de treinta y dos símbolos cuidadosamente reordenado que favorece la lectura, la escritura y la transcripción oral, y empaqueta cinco bits por carácter. A diferencia del Base32 del RFC 4648, elimina pares confusos, reordena los símbolos para que los sonidos habituales aparezcan con más frecuencia y omite el relleno con signos de igual, de modo que los tokens se mantienen cortos. Esta capacidad convierte texto UTF-8 en z-base-32 en minúsculas o recupera el texto original a partir de una cadena z-base-32.

Cómo z-base-32 empaqueta bits con el alfabeto de Zooko

z-base-32 parte de la misma idea de cinco bits por carácter que el Base32 clásico, pero la tabla de símbolos es completamente distinta. Los treinta y dos caracteres son y b n d r f g 8 e j k m c p q x o t 1 u w i s z a 3 4 5 h 7 6 9 en ese orden.

Se excluyen el dígito cero, el dos, la letra ele y la letra uve porque se confunden con facilidad con otros glifos cuando alguien lee un código en voz alta o lo copia a mano. Los símbolos restantes se ordenan de forma que las vocales y las consonantes frecuentes tiendan a aparecer antes en el espacio de valores, lo que hace las cadenas aleatorias un poco más pronunciables.

La codificación trata su entrada como bytes UTF-8, los lee como un flujo continuo de bits y emite un carácter del alfabeto por cada cinco bits. Los bits sobrantes al final se rellenan con ceros a la derecha para completar un quinteto final; no se añaden signos de igual. La decodificación invierte el mapa: cada símbolo aporta cinco bits, los bytes completos se emiten en cuanto se acumulan ocho bits y se descartan los bits residuales de relleno que no forman un byte completo.

Se ignoran los espacios en blanco para que los pegados de varias líneas sigan funcionando, y las mayúsculas se convierten a minúsculas antes de la búsqueda. Esta página no es deliberadamente el Base32 del RFC 4648 ni Crockford Base32; esos alfabetos y reglas de relleno son intenciones de búsqueda distintas con otros objetivos de interoperabilidad.

Qué se envía y qué se recibe

Envíe un campo de cadena obligatorio llamado text y un campo mode opcional con encode o decode. Si se omite mode, encode es el valor predeterminado, de modo que una carga mínima sigue siendo útil. El modo encode trata text como contenido UTF-8 plano y devuelve una cadena result en minúsculas del alfabeto de Zooko sin relleno.

El modo decode trata text como z-base-32, normaliza mayúsculas y espacios, valida cada símbolo y devuelve la cadena UTF-8 recuperada en result. Ambas direcciones devuelven mode, el text original, result, un campo length de la salida principal, etiquetas alphabet y charset, un indicador padding en false y una breve referencia al estándar para que los clientes comprueben el perfil.

Las comprobaciones habituales incluyen codificar una palabra corta como Hello, decodificar el resultado de ida y vuelta al mismo texto y forzar un error pegando un símbolo que z-base-32 excluye a propósito, como el cero o la letra ele. Use el formulario gratuito del navegador para comprobaciones rápidas y demos, y después invoque el mismo contrato desde scripts cuando necesite tokens en masa o casos de regresión.

Dónde aparece z-base-32 en el trabajo real

Los identificadores orientados a personas que deben leerse por teléfono, escribirse en papel o teclearse desde una captura se benefician de un alfabeto que evita glifos ambiguos. z-base-32 se diseñó exactamente para eso: sistemas de código abierto como Mnet y Tahoe-LAFS, y protocolos como ZRTP, lo adoptaron para intercambiar códigos compactos sin las trampas del cero frente a la O y del uno frente a la I de alfabetos más densos.

Los equipos de producto que crean frases de recuperación sin conexión, códigos de autenticación cortos en air-gap o tokens de un solo uso para soporte suelen preferir la tabla de Zooko cuando la cadena se dictará o transcribirá en lugar de solo escanearse. Los grupos de ingeniería que escriben pruebas de interoperabilidad necesitan una única verdad de referencia para codificar y decodificar que coincida con sus bibliotecas y nunca sustituya en silencio caracteres ilegales.

Quienes enseñan esquemas de codificación quieren una landing dedicada a z-base-32 en lugar de enterrarlo bajo el Base32 del RFC 4648, porque se busca Zooko, Base32 humano y tokens sin relleno como intenciones separadas. El personal de soporte que pega códigos de varias líneas desde el chat necesita tolerancia a espacios sin aceptar símbolos basura que producirían una clave incorrecta.

Si necesita el Base32 clásico del RFC 4648 con A-Z y del dos al siete, Base64 o Crockford Base32, trátelos como landings distintas en lugar de sobrecargar esta página del codificador z-base-32.