Base45-Encoder und -Decoder

Dieser Base45-Encoder wandelt Klartext in RFC-9285-Base45 um und dekodiert Base45-Zeichenketten zurück in UTF-8-Text, mit dem fünfundvierzig Zeichen umfassenden QR-Code-alphanumerischen Alphabet. Base45 packt zwei Bytes in drei Zeichen und ein übrig bleibendes Byte in zwei Zeichen, was für QR-Nutzlasten kompakter ist als Base64 und dabei innerhalb des alphanumerischen Modus bleibt, den Scanner bereits erwarten. Die Engine ist vollständig deterministisch: Dieselbe Eingabe und derselbe Modus liefern immer dasselbe Ergebnis, ohne Netzwerkaufrufe, ohne zufällige Salts und ohne datumsabhängige Abkürzungen. Klassische Kontrollwerte umfassen die Kodierung von AB zu BB8, Hello!! zu einer Zeichenkette mit einem Leerzeichen, und base-45 zu UJCLQE7W581.

Was Base45 ist und was dieses Werkzeug liefert

Base45 ist die in RFC 9285 definierte Binär-zu-Text-Kodierung für Daten, die im alphanumerischen Modus in QR-Codes reisen. Das Alphabet ist der feste Satz aus fünfundvierzig Zeichen: null bis neun, A bis Z, Leerzeichen, Dollarzeichen, Prozentzeichen, Sternchen, Plus, Minus, Punkt, Schrägstrich und Doppelpunkt. Die Kodierung interpretiert jedes Paar Eingabebytes als sechzehn-Bit-vorzeichenlose Ganzzahl n gleich a mal zweihundertsechsundfünfzig plus b, und schreibt n dann als drei Base-45-Ziffern mit der niedrigstwertigen Ziffer links.

Ein übrig bleibendes letztes Byte wird nur zu zwei Ziffern. Dieses Design passt besser zur QR-alphanumerischen Packung als Base64, das Plus, Schrägstrich und Auffüllung benötigt, die im QR-alphanumerischen Modus unpraktisch sind. Diese Seite folgt immer diesem Vertrag: Der Kodiermodus wandelt Ihren Text in UTF-8 um, packt die Bytes und liefert nur Alphabetzeichen; der Dekodiermodus kehrt den Vorgang um und weist Zeichen außerhalb des Alphabets, unvollständige Gruppen, deren Länge modulo drei eins ergibt, sowie jedes Drei-Zeichen-Triplet zurück, dessen numerischer Wert fünfundsechzigtausendfünfhundertfünfunddreißig übersteigt.

Wenn Sie stattdessen standardmäßiges Base64url für JWTs benötigen, nutzen Sie einen dedizierten Base64url-Endpunkt; diese Landingpage ist nur für das RFC-9285-Alphabet, das QR-basierte verifizierbare Nachweise verwenden.

Wie Text und Modus gelesen werden und wie Ergebnisse reproduzierbar bleiben

Mode ist standardmäßig encode und akzeptiert decode explizit; die Aliase op, direction und action bilden auf denselben Schalter ab, für Skripte, die diese Namen bereits verwenden. Encode akzeptiert jede Unicode-Zeichenkette, wandelt sie mit dem plattformeigenen TextEncoder in UTF-8-Bytes um und gibt dann wie oben beschrieben Base45-Gruppen aus. Decode verlangt eine reine Base45-Zeichenkette: Eine Länge modulo drei gleich eins wird zurückgewiesen, da sie keine ganze Anzahl von Bytes darstellen kann, und jedes Zeichen außerhalb des Alphabets scheitert mit einer klaren Angabe von Index und Zeichen.

Nachdem die Ziffern wiederhergestellt sind, wird jedes Triplet gegen die Sechzehn-Bit-Obergrenze geprüft, sodass Zeichenketten wie GGW, die über fünfundsechzigtausendfünfhundertfünfunddreißig dekodieren würden, scheitern, statt zu überlaufen. Zwei-Zeichen-Enden müssen zu höchstens einem Byte mit dem Wert zweihundertfünfundfünfzig dekodieren. Eine fatale UTF-8-Dekodierung stellt anschließend sicher, dass binärer Datenmüll nicht zu unlesbarem Mojibake-Text wird.

Wo Base45 in QR-Codes zum Einsatz kommt

Frontend-Teams dekodieren gescannte Base45-Segmente bei der Integrationsfehlersuche, ohne Daten in Ad-hoc-Skripte einzufügen, die versehentlich das falsche Alphabet verwenden. Backend-Dienste kodieren kurze binäre Blobs, bevor sie diese in QR-Generatoren einfügen, die nur den alphanumerischen Modus akzeptieren. Qualitätsingenieure erzeugen deterministische Kodier- und Dekodierpaare für Vertragstests, damit eine Middleware, die Base45-Unterstützung behauptet, nicht stillschweigend Tabellen wechseln oder übergroße Tripel akzeptieren kann.

Lehrkräfte nutzen dasselbe Werkzeug beim Unterrichten des Zusammenspiels von QR-alphanumerischem Modus, Fünfzehn-Bit-Symbolpaaren und Base45, einschließlich der klassischen RFC-Beispiele AB zu BB8 und Hello!! mit seinem eingebetteten Leerzeichen. Kombinieren Sie es mit CBOR- oder Zertifikat-Helfern, wenn Sie verwandte Nachweis-Schritte benötigen, und mit weiteren Kodierungs-Endpunkten, wenn Sie ein kleines Labor freier, deterministischer Textwerkzeuge aufbauen.