Encodeur et décodeur Z85 (ZeroMQ)

Comment encoder et décoder du Z85

1. Collez les octets en hex dans Entrée · Hex. Les espaces, les deux-points et les préfixes 0x sont acceptés : un dump hex se colle tel quel.
2. Lisez le Z85 dans Sortie · Z85 (ZeroMQ).
3. Si le nombre d’octets n’est pas un multiple de 4, une erreur indique ce nombre. Ne cochez Autoriser un dernier bloc partiel (non standard) que si les deux côtés s’accordent sur cette extension.
4. Pour décoder, cliquez sur Z85 (ZeroMQ) → Hex dans le sélecteur de sens et collez la chaîne Z85. Réglez Vers sur Base64 ou Texte pour d’autres vues, ou utilisez Enregistrer les octets pour obtenir un fichier binaire.

Les vecteurs de test de la spécification

La spécification Z85 de ZeroMQ (RFC 32 de la série des RFC ZeroMQ) donne deux valeurs de test. Cet outil reproduit les deux :

La première montre la structure en blocs : 8 octets, deux blocs, dix caractères. La seconde est une clé de 32 octets et son encodage de 40 caractères, la taille que l’on voit dans les configurations CurveZMQ.

Quelques valeurs limites : quatre octets nuls donnent 00000, et quatre octets ff donnent %nSc0. Z85 n’a pas de raccourci pour les blocs nuls : une suite de zéros reste à cinq caractères par bloc.

Pourquoi ZeroMQ utilise Z85

Les clés CurveZMQ sont 32 octets aléatoires. ZeroMQ avait besoin de les mettre sous forme de chaînes simples dans des fichiers de configuration, des lignes de commande et du code source. Z85 a été conçu pour cela :

• Il est 25 % plus gros que les octets bruts, contre 33 % pour Base64 : une clé de 32 octets fait donc 40 caractères au lieu de 44.
• Son alphabet ne contient ni ", ni ', ni \, ni accent grave : une clé peut aller dans un littéral de chaîne C, Python ou shell sans échappement. Il évite aussi , et ;.
• Les chiffres et les lettres viennent en premier (0-9 a-z A-Z), suivis de 23 caractères de ponctuation : .-:+=^!/*?&<>()[]{}@%$#.

Il contient tout de même <, > et & : du Z85 dans du XML ou du HTML doit donc être échappé. En JSON, aucun échappement n’est nécessaire.

Z85 en Python

Z85 et b85encode de Python partagent la même arithmétique et ne diffèrent que par l’alphabet : une traduction de caractères convertit l’un en l’autre.

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 vous dépendez déjà de PyZMQ, zmq.utils.z85.encode et decode font la même chose. En C, libzmq propose zmq_z85_encode et zmq_z85_decode. D’autres manipulations d’octets en Python sur la page Python.

Problèmes courants

• « Z85 encode des blocs de 4 octets et les données font N octets ». L’entrée n’est pas alignée sur les blocs. Vérifiez que vous avez copié toute la clé ; une clé de 32 octets qui en affiche 31 a perdu une paire de chiffres hex.
• « Z85 attend des groupes de 5 caractères ; il en reste N ». La chaîne Z85 a été tronquée ou contient des caractères en trop. Une clé CurveZMQ doit faire exactement 40 caractères.
• La chaîne se décode, mais la clé ne fonctionne pas. Il s’agit peut-être d’Ascii85 ou du Base85 de Git, qui partagent les règles de longueur mais pas l’alphabet : les mêmes caractères se décodent alors en octets différents. Essayez sur la page Base85 en réglant De sur une autre variante.

FAQ