Codificador y decodificador Base45

Este codificador Base45 convierte texto plano en Base45 según RFC 9285 y decodifica cadenas Base45 de vuelta a texto UTF-8, usando el alfabeto alfanumérico de cuarenta y cinco caracteres del código QR. Base45 empaqueta dos bytes en tres caracteres, y un byte sobrante en dos caracteres, lo que resulta más compacto para cargas útiles de QR que Base64, a la vez que se mantiene dentro del modo alfanumérico que los escáneres ya esperan. Este esquema impulsa los Certificados COVID Digitales de la UE y otras credenciales verificables por QR que deben transportar afirmaciones binarias sin salir del conjunto de caracteres seguro para QR. El motor es totalmente determinista: la misma entrada y el mismo modo siempre producen el mismo resultado, sin llamadas de red, sin sales aleatorias y sin atajos que dependan de la fecha. Las comprobaciones clásicas incluyen codificar AB en BB8, Hello!! en una cadena que incluye un espacio, y base-45 en UJCLQE7W581.

Qué es Base45 y qué devuelve esta herramienta

Base45 es la codificación de binario a texto definida en RFC 9285 para datos que viajarán dentro de códigos QR en modo alfanumérico. El alfabeto es el conjunto fijo de cuarenta y cinco caracteres: del cero al nueve, de la A a la Z, espacio, signo de dólar, porcentaje, asterisco, más, menos, punto, barra, y dos puntos.

La codificación interpreta cada par de bytes de entrada como un entero sin signo de dieciséis bits n igual a a por doscientos cincuenta y seis más b, y luego escribe n como tres dígitos base cuarenta y cinco, con el dígito menos significativo a la izquierda. Un último byte sobrante se convierte en solo dos dígitos. Este diseño encaja mejor con el empaquetado alfanumérico de QR que Base64, que necesita más, barra, y relleno, incómodos en el modo alfanumérico de QR.

Esta página siempre sigue ese contrato: el modo de codificación codifica su texto en UTF-8, empaqueta los bytes, y devuelve solo caracteres del alfabeto; el modo de decodificación invierte el proceso y rechaza caracteres fuera del alfabeto, grupos incompletos cuya longitud módulo tres sea uno, y cualquier tripleta de tres caracteres cuyo valor numérico supere sesenta y cinco mil quinientos treinta y cinco.

Cómo se interpretan el texto y el modo, y cómo los resultados se mantienen reproducibles

Encode acepta cualquier cadena Unicode, la convierte con el TextEncoder de la plataforma en bytes UTF-8, y luego emite grupos Base45 como se especificó anteriormente. Decode exige una cadena Base45 pura: una longitud módulo tres igual a uno se rechaza porque no puede representar un número entero de bytes, y cualquier carácter fuera del alfabeto falla con un mensaje claro que indica el índice y el carácter.

Después de recuperar los dígitos, cada tripleta se verifica contra el techo de dieciséis bits, así que cadenas como GGW, que decodificarían por encima de sesenta y cinco mil quinientos treinta y cinco, fallan en lugar de desbordarse. Las colas de dos caracteres deben decodificar a un único byte de como máximo doscientos cincuenta y cinco. Una decodificación UTF-8 estricta garantiza entonces que la basura binaria no se convierta en texto ininteligible.

Dónde se usa Base45 en los códigos QR

Los equipos de frontend decodifican segmentos Base45 escaneados durante la depuración de integración, sin pegar datos en scripts improvisados que usan por error el alfabeto equivocado. Los servicios de backend codifican pequeños blobs binarios antes de colocarlos en generadores de QR que solo aceptan modo alfanumérico. Los ingenieros de calidad generan pares de codificación y decodificación deterministas para pruebas de contrato, de modo que un middleware que dice admitir Base45 no pueda cambiar tablas en silencio ni aceptar tripletas de tamaño excesivo.

Los educadores usan la misma herramienta al enseñar cómo interactúan el modo alfanumérico de QR, los pares de quince bits de símbolos, y Base45, incluidos los ejemplos clásicos del RFC, AB a BB8 y Hello!! con su espacio incrustado.