Codificador y decodificador Z85 (ZeroMQ)

Cómo codificar y decodificar Z85

1. Pega los bytes en hex en Entrada · Hex. Se aceptan espacios, dos puntos y prefijos 0x, así que un volcado hex se pega tal cual.
2. Lee el Z85 en Salida · Z85 (ZeroMQ).
3. Si el número de bytes no es múltiplo de 4, obtienes un error que indica cuántos hay. Marca Permitir último bloque parcial (no estándar) solo si ambas partes están de acuerdo en usar esa extensión.
4. Para decodificar, haz clic en Z85 (ZeroMQ) → Hex en el selector de dirección y pega la cadena Z85. Pon A en Base64 o Texto para otras vistas, o usa Guardar bytes para obtener un archivo binario.

Los vectores de prueba de la especificación

La especificación Z85 de ZeroMQ (RFC 32 de la serie de RFC de ZeroMQ) da dos valores de prueba. Esta herramienta reproduce ambos:

El primero muestra la estructura de bloques: 8 bytes, dos bloques, diez caracteres. El segundo es una clave de 32 bytes y su codificación de 40 caracteres, el tamaño que ves en la configuración de CurveZMQ.

Algunos valores límite: cuatro bytes a cero son 00000, y cuatro bytes ff son %nSc0. Z85 no tiene atajo para los bloques de ceros, así que una secuencia de ceros sigue ocupando cinco caracteres por bloque.

Por qué ZeroMQ usa Z85

Las claves CurveZMQ son 32 bytes aleatorios. ZeroMQ necesitaba una forma de ponerlas en archivos de configuración, líneas de comandos y código fuente como cadenas simples. Z85 se diseñó para eso:

• Ocupa un 25 % más que los bytes en bruto, frente al 33 % de Base64, así que una clave de 32 bytes son 40 caracteres en lugar de 44.
• Su alfabeto no tiene ", ', \ ni backtick, así que una clave puede ir en un literal de cadena de C, Python o shell sin escapes. También evita , y ;.
• Primero van los dígitos y las letras (0-9 a-z A-Z), seguidos de 23 signos de puntuación: .-:+=^!/*?&<>()[]{}@%$#.

Aun así contiene <, > y &, así que Z85 dentro de XML o HTML necesita escapes. En JSON no necesita ninguno.

Z85 en Python

Z85 y b85encode de Python comparten la aritmética y solo se diferencian en el alfabeto, así que una traducción de caracteres convierte uno en otro:

import base64

B85 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz!#$%&()*+-;<=>?@^_`{|}~"
Z85 = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ.-:+=^!/*?&<>()[]{}@%$#"
TO_Z85 = str.maketrans(B85, Z85)
FROM_Z85 = str.maketrans(Z85, B85)

def z85encode(data: bytes) -> str:
    if len(data) % 4:
        raise ValueError("Z85 needs a multiple of 4 bytes")
    return base64.b85encode(data).decode().translate(TO_Z85)

def z85decode(text: str) -> bytes:
    return base64.b85decode(text.translate(FROM_Z85))

z85encode(bytes.fromhex("864FD26FB559F75B"))   # 'HelloWorld'

Si ya dependes de PyZMQ, zmq.utils.z85.encode y decode hacen lo mismo. En C, libzmq tiene zmq_z85_encode y zmq_z85_decode. Hay más sobre el manejo de bytes en Python en la página de Python.

Problemas habituales

• «Z85 codifica bloques de 4 bytes y los datos tienen N bytes». La entrada no está alineada a bloques. Comprueba que copiaste la clave entera; una clave de 32 bytes que muestra 31 ha perdido un par de dígitos hex.
• «Z85 necesita grupos de 5 caracteres; sobran N». La cadena Z85 está cortada o tiene caracteres de más. Una clave CurveZMQ debe tener exactamente 40 caracteres.
• La cadena se decodifica pero la clave no funciona. Puede ser Ascii85 o Base85 de Git, que comparten las reglas de longitud pero no el alfabeto, así que los mismos caracteres se decodifican en bytes distintos. Pruébala en la página de Base85 con De en otra variante.

Preguntas frecuentes