Z85-koder og -dekoder

Hva er Z85?

Z85 er spesifisert i ZeroMQ RFC 32 (en spesifikasjon fra ZeroMQ-fellesskapet, ikke en RFC fra IETF). Som andre Base85-kodinger gjør den hver gruppe på 4 byte om til 5 tegn: Hver gruppe leses som et 32-biters big-endian-tall og skrives som 5 base-85-sifre, med det mest signifikante sifferet først. Utdataene er 25 % større enn inndataene.

Det som skiller Z85 fra de andre, er alfabetet: 0-9, a-z, A-Z og de 23 symbolene .-:+=^!/*?&<>()[]{}@%$#. Det utelater begge typer anførselstegn, omvendt skråstrek, backtick, komma, semikolon, loddrett strek, tilde og understrek. Alfabetet ble utformet for å være trygt i strenger i kildekode, så en Z85-verdi kan limes inn mellom anførselstegn i C, Python eller JSON uten noen form for escaping.

Hvor Z85 brukes

ZeroMQ bruker Z85 til å skrive ut CurveZMQ-nøkler. En offentlig eller hemmelig nøkkel på 32 byte blir en Z85-streng på 40 tegn. Det er denne formen zmq_curve_keypair() returnerer, og som socket-valgene for CURVE-sikkerhet godtar. Biblioteket har også zmq_z85_encode() og zmq_z85_decode(), og bindinger som pyzmq tilbyr de samme funksjonene.

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

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

Den siste linjen er testvektoren fra spesifikasjonen.

Inndatalengde: en merknad om dette verktøyet

RFC 32 krever at de binære inndataene er et multiplum av 4 byte, og at den kodede strengen er et multiplum av 5 tegn. Den definerer ingen utfylling, og strenge implementasjoner som zmq_z85_encode() avviser andre lengder.

Dette verktøyet godtar også andre lengder og bruker samme regel som Ascii85 og Base85: En siste gruppe på n byte blir n + 1 tegn. Dette er en utvidelse som ikke følger standarden. Utdata som lages på denne måten, kan bli avvist av andre Z85-dekodere, så fyll ut dataene til et multiplum av 4 byte når du trenger kompatibilitet. CurveZMQ-nøkler er på 32 byte og passer alltid.