Encodeur et décodeur z-base-32

z-base-32 est la variante de Base32 orientée usage humain de Zooko Wilcox-O'Hearn : un alphabet de trente-deux symboles soigneusement permuté qui favorise la lecture, l'écriture et la transcription orale, tout en compactant cinq bits par caractère. Contrairement au Base32 du RFC 4648, il écarte les paires confondantes, réordonne les symboles pour que les sons courants apparaissent plus souvent, et omet le remplissage par signes égal afin de garder des jetons courts. Cette capacité transforme du texte UTF-8 en z-base-32 minuscule ou retrouve le texte d'origine à partir d'une chaîne z-base-32.

Comment z-base-32 empaquette les bits avec l'alphabet de Zooko

z-base-32 part de la même idée de cinq bits par caractère que le Base32 classique, mais la table de symboles est entièrement différente. Les trente-deux caractères sont 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 dans cet ordre.

Les chiffres zéro et deux, la lettre elle et la lettre vé sont exclus car ils se confondent facilement avec d'autres glyphes lorsqu'on lit un code à voix haute ou qu'on le recopie à la main. Les symboles restants sont ordonnés pour que les voyelles et les consonnes fréquentes tendent à apparaître plus tôt dans l'espace de valeurs, ce qui rend les chaînes aléatoires un peu plus prononçables.

L'encodage traite votre entrée comme des octets UTF-8, les lit comme un flux de bits continu et émet un caractère d'alphabet pour chaque cinq bits. Les bits restants en fin de flux sont complétés à droite par des zéros pour former un quintet final ; aucun signe égal n'est ajouté. Le décodage inverse la carte : chaque symbole apporte cinq bits, les octets complets sont émis dès que huit bits s'accumulent, et les bits de remplissage résiduels qui ne forment pas un octet complet sont ignorés.

Les espaces sont ignorés pour que les collages multi-lignes fonctionnent encore, et les majuscules sont ramenées en minuscules avant la recherche. Cette page n'est volontairement ni le Base32 du RFC 4648 ni Crockford Base32 ; ces alphabets et règles de remplissage sont des intentions de recherche distinctes avec d'autres cibles d'interopérabilité.

Ce que vous envoyez et ce que vous recevez

Envoyez un champ chaîne obligatoire nommé text et un champ mode optionnel valant encode ou decode. Lorsque mode est omis, encode est la valeur par défaut, de sorte qu'une charge minimale reste utile. Le mode encode traite text comme du contenu UTF-8 brut et renvoie une chaîne result en minuscules dans l'alphabet de Zooko sans remplissage.

Le mode decode traite text comme du z-base-32, normalise la casse et les espaces, valide chaque symbole et renvoie la chaîne UTF-8 récupérée dans result. Les deux sens renvoient mode, le text d'origine, result, un champ length de la sortie principale, les libellés alphabet et charset, un indicateur padding à false et une courte référence de norme pour que les clients affirment le profil atteint. Les échecs de validation ne consomment pas de solde prépayé.

Les contrôles typiques incluent l'encodage d'un mot court comme Hello, le décodage du trajet aller-retour vers le même texte, et le forçage d'une erreur en collant un symbole que z-base-32 exclut volontairement, comme le zéro ou la lettre elle. Utilisez le formulaire gratuit du navigateur pour des vérifications rapides et des démos, puis appelez le même contrat depuis des scripts lorsque vous avez besoin de jetons en masse ou de jeux de régression.

Où z-base-32 apparaît dans le travail réel

Les identifiants destinés aux personnes qui doivent être lus au téléphone, écrits sur papier ou saisis depuis une capture bénéficient d'un alphabet qui évite les glyphes ambigus. z-base-32 a été conçu pour cela : des systèmes open source comme Mnet et Tahoe-LAFS, et des protocoles comme ZRTP, l'ont adopté pour échanger des codes compacts sans les pièges du zéro contre O et du un contre I des alphabets plus denses.

Les équipes produit qui construisent des phrases de récupération hors ligne, de courts codes d'authentification air-gapped ou des jetons à usage unique pour le support préfèrent souvent la table de Zooko lorsque la chaîne sera dictée ou transcrite plutôt que seulement scannée. Les groupes d'ingénierie qui écrivent des tests d'interopérabilité ont besoin d'une seule vérité de référence pour l'encodage et le décodage, alignée sur leurs bibliothèques et sans substitution silencieuse de caractères illégaux.

Les auteurs de cours qui enseignent les schémas d'encodage veulent une page dédiée à z-base-32 plutôt que de l'enfouir sous le Base32 du RFC 4648, car on cherche Zooko, le Base32 humain et les jetons sans remplissage comme intentions séparées. Le support qui colle des codes multi-lignes depuis le chat a besoin de tolérer les espaces sans accepter des symboles pourris qui produiraient une mauvaise clé.

Si vous avez besoin du Base32 classique du RFC 4648 avec A-Z et deux à sept, de Base64 ou de Crockford Base32, traitez-les comme des pages distinctes plutôt que de surcharger cette page du codeur z-base-32.