Codificatore e decodificatore z-base-32

z-base-32 è la variante di Base32 orientata alle persone di Zooko Wilcox-O'Hearn: un alfabeto di trentadue simboli accuratamente permutato che favorisce lettura, scrittura e trascrizione orale, comprimendo comunque cinque bit per carattere. A differenza del Base32 del RFC 4648, elimina le coppie confondibili, riordina i simboli così che i suoni comuni compaiano più spesso e omette il padding con segni di uguale, mantenendo i token corti. Questa capacità trasforma testo UTF-8 in z-base-32 minuscolo oppure recupera il testo originale da una stringa z-base-32.

Come z-base-32 impacchetta i bit con l'alfabeto di Zooko

z-base-32 parte dalla stessa idea di cinque bit per carattere del Base32 classico, ma la tabella dei simboli è del tutto diversa. I trentadue caratteri sono 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 in quest'ordine.

Sono esclusi la cifra zero, il due, la lettera elle e la lettera vu perché si confondono facilmente con altri glifi quando qualcuno legge un codice ad alta voce o lo copia a mano. I simboli restanti sono ordinati così che vocali e consonanti frequenti tendano a comparire prima nello spazio dei valori, rendendo le stringhe casuali un po' più pronunciabili. La codifica tratta l'ingresso come byte UTF-8, li legge come flusso continuo di bit ed emette un carattere dell'alfabeto ogni cinque bit.

Gli eventuali bit residui alla fine sono completati a destra con zeri per formare un quintetto finale; non si aggiungono segni di uguale. La decodifica inverte la mappa: ogni simbolo contribuisce con cinque bit, i byte completi vengono emessi non appena si accumulano otto bit e i bit di padding residui che non formano un byte completo vengono scartati. Gli spazi bianchi sono ignorati così i collages multilinea funzionano ancora, e le maiuscole sono portate in minuscolo prima della ricerca.

Questa pagina non è di proposito il Base32 del RFC 4648 né Crockford Base32; quegli alfabeti e regole di padding sono intenzioni di ricerca distinte con altri obiettivi di interoperabilità.

Cosa invia e cosa riceve indietro

Invii un campo stringa obbligatorio chiamato text e un campo mode opzionale impostato a encode o decode. La modalità encode tratta text come contenuto UTF-8 semplice e restituisce una stringa result in minuscolo nell'alfabeto di Zooko senza padding. La modalità decode tratta text come z-base-32, normalizza maiuscole e spazi, valida ogni simbolo e restituisce la stringa UTF-8 recuperata in result.

Entrambe le direzioni riportano mode, il text originale, result, un campo length dell'uscita principale, etichette alphabet e charset, un flag padding impostato a false e un breve riferimento allo standard così i client possono verificare il profilo. I fallimenti di validazione non consumano saldo prepagato. Controlli tipici includono la codifica di una parola breve come Hello, la decodifica del viaggio di andata e ritorno allo stesso testo e il forzare un errore incollando un simbolo che z-base-32 esclude di proposito, come lo zero o la lettera elle.

Dove compare z-base-32 nel lavoro reale

Gli identificatori rivolti alle persone che devono essere letti al telefono, scritti su carta o digitati da uno screenshot traggono vantaggio da un alfabeto che evita glifi ambigui. z-base-32 è stato progettato proprio per questo: sistemi open source come Mnet e Tahoe-LAFS, e protocolli come ZRTP, lo hanno adottato per scambiare codici compatti senza le trappole dello zero contro O e dell'uno contro I degli alfabeti più densi.

I team di prodotto che costruiscono frasi di recupero offline, codici brevi di autenticazione air-gapped o token monouso per il supporto spesso preferiscono la tabella di Zooko quando la stringa sarà dettata o trascritta anziché solo scansionata. I gruppi di ingegneria che scrivono test di interoperabilità necessitano di un'unica verità di riferimento per codifica e decodifica allineata alle proprie librerie e senza sostituzioni silenziose di caratteri illegali.

Chi insegna schemi di codifica vuole una landing dedicata a z-base-32 invece di seppellirlo sotto il Base32 del RFC 4648, perché si cerca Zooko, Base32 umano e token senza padding come intenzioni separate. Il supporto che incolla codici multilinea dalla chat ha bisogno di tollerare gli spazi senza accettare simboli spazzatura che produrrebbero una chiave sbagliata. Se Le serve il Base32 classico del RFC 4648 con A-Z e dal due al sette, Base64 o Crockford Base32, li tratti come landing distinte invece di sovraccaricare questa pagina del codificatore z-base-32.