Codificatore e decodificatore Z85

Che cos’è Z85?

Z85 è definito nella RFC 32 di ZeroMQ (una specifica della comunità ZeroMQ, non una RFC dell’IETF). Come le altre codifiche Base85, trasforma ogni gruppo di 4 byte in 5 caratteri: legge ciascun gruppo come un numero a 32 bit big-endian e lo scrive come 5 cifre in base 85, partendo dalla più significativa. L’output è il 25% più grande dell’input.

Ciò che distingue Z85 è il suo alfabeto: 0-9, a-z, A-Z e i 23 simboli .-:+=^!/*?&<>()[]{}@%$#. Esclude entrambi i tipi di virgolette, la barra rovesciata, l’accento grave, la virgola, il punto e virgola, la barra verticale, la tilde e il trattino basso. L’alfabeto è stato progettato per essere sicuro nelle stringhe del codice sorgente, quindi un valore Z85 si può incollare tra virgolette in C, Python o JSON senza alcun escape.

Dove si usa Z85

ZeroMQ usa Z85 per rappresentare in forma testuale le chiavi CurveZMQ. Una chiave pubblica o segreta di 32 byte diventa una stringa Z85 di 40 caratteri, che è la forma restituita da zmq_curve_keypair() e accettata dalle opzioni dei socket per la sicurezza CURVE. La libreria espone anche zmq_z85_encode() e zmq_z85_decode(), e binding come pyzmq offrono le stesse funzioni.

// C (libzmq)
char text[41];                       // 32 byte -> 40 caratteri + NUL
zmq_z85_encode(text, key, 32);

# Python (pyzmq)
from zmq.utils import z85
z85.encode(bytes.fromhex('864fd26fb559f75b'))   # b'HelloWorld'

L’ultima riga è il vettore di test della specifica.

Lunghezza dell’input: una nota su questo strumento

La RFC 32 richiede che l’input binario sia un multiplo di 4 byte e la stringa codificata un multiplo di 5 caratteri. Non definisce alcun padding, e le implementazioni rigorose come zmq_z85_encode() rifiutano le altre lunghezze.

Questo strumento accetta anche altre lunghezze, con la stessa regola di Ascii85 e Base85: un gruppo finale di n byte diventa n + 1 caratteri. Si tratta di un’estensione non standard. L’output prodotto in questo modo potrebbe essere rifiutato da altri decodificatori Z85, quindi, se ti serve la compatibilità, porta i dati a un multiplo di 4 byte. Le chiavi CurveZMQ sono di 32 byte e rientrano sempre nella regola.