Codificador e decodificador Base45

Este codificador Base45 converte texto simples em Base45 conforme a RFC 9285 e decodifica strings Base45 de volta para texto UTF-8, usando o alfabeto alfanumérico de quarenta e cinco caracteres do QR Code. O esquema alimenta os Certificados Digitais COVID da UE e outras credenciais verificáveis em QR que precisam carregar dados binários sem sair do conjunto de caracteres seguro para QR. O mecanismo é totalmente determinístico: a mesma entrada e o mesmo modo sempre produzem o mesmo resultado, sem chamadas de rede, sem sais aleatórios e sem atalhos dependentes de data. Verificações clássicas incluem a codificação de AB para BB8, Hello!! para uma string que inclui um espaço, e base-45 para UJCLQE7W581.

O que é Base45 e o que esta ferramenta retorna

Base45 é a codificação binário-para-texto definida na RFC 9285 para dados que viajarão dentro de códigos QR no modo Alfanumérico. O alfabeto é o conjunto fixo de quarenta e cinco caracteres: zero a nove, A a Z, espaço, cifrão, porcentagem, asterisco, mais, menos, ponto, barra e dois-pontos.

A codificação interpreta cada par de bytes de entrada como um inteiro sem sinal de dezesseis bits, n igual a a vezes duzentos e cinquenta e seis mais b, então escreve n como três dígitos de base quarenta e cinco, com o dígito menos significativo à esquerda. Um byte final restante vira apenas dois dígitos. Esse design combina melhor com o empacotamento alfanumérico de QR do que o Base64, que precisa de mais, barra e preenchimento, que são incômodos no modo alfanumérico de QR.

Esta página sempre segue esse contrato: o modo encode codifica seu texto em UTF-8, empacota os bytes, e retorna apenas caracteres do alfabeto; o modo decode reverte o processo e rejeita caracteres fora do alfabeto, grupos incompletos cujo comprimento módulo três é um, e qualquer trinca de três caracteres cujo valor numérico exceda sessenta e cinco mil quinhentos e trinta e cinco.

Como texto e modo são interpretados e como os resultados permanecem reproduzíveis

O encode aceita qualquer string Unicode, converte com o TextEncoder da plataforma para bytes UTF-8, e então emite grupos Base45 conforme especificado acima. O decode exige uma string Base45 pura: comprimento módulo três igual a um é rejeitado, porque não pode representar um número inteiro de bytes, e qualquer caractere fora do alfabeto falha com um índice e caractere claros.

Depois que os dígitos são recuperados, cada trinca é verificada contra o teto de dezesseis bits, então strings como GGW, que decodificariam acima de sessenta e cinco mil quinhentos e trinta e cinco, falham em vez de estourar. Caudas de dois caracteres devem decodificar para um único byte de no máximo duzentos e cinquenta e cinco. Uma decodificação UTF-8 fatal garante então que lixo binário não vire texto ilegível (mojibake).

Onde o Base45 é usado em códigos QR

Equipes de frontend decodificam segmentos Base45 escaneados durante depuração de integração, sem colar dados em scripts improvisados que acidentalmente usam o alfabeto errado. Serviços de backend codificam pequenos blobs binários antes de colocá-los em geradores de QR que só aceitam o modo alfanumérico. Engenheiros de qualidade geram pares determinísticos de codificação e decodificação para testes de contrato, para que um middleware que afirma suportar Base45 não possa trocar tabelas silenciosamente ou aceitar trincas com valor acima do permitido.

Educadores usam a mesma ferramenta ao ensinar como o modo alfanumérico de QR, pares de símbolos de quinze bits, e o Base45 interagem, incluindo os exemplos clássicos da RFC AB para BB8 e Hello!! com seu espaço embutido.