ForHosting KIT · Utilidades de desarrollo

Codificador y decodificador Base58

«Hello World» se convierte en JxF12TrwUP45BMd con Base58, el alfabeto de Bitcoin de 58 caracteres sin cero, O mayúscula, I mayúscula ni l minúscula, para que los códigos se lean bien en papel y en pantalla. También decodifica. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Texto
Hello World
Modo de cálculo
Encode
Obtiene
Resultado
JxF12TrwUP45BMd
Entrada
Hello World
Resultado Base58
JxF12TrwUP45BMd
Nombre del alfabeto
bitcoin

Un codificador Base58 convierte texto UTF-8 ordinario en una cadena compacta que usa solo cincuenta y ocho caracteres inequívocos, y un decodificador Base58 invierte esa correspondencia para que usted recupere el texto original. Esta herramienta utiliza el alfabeto Bitcoin: dígitos y letras sin el cero, la O mayúscula, la I mayúscula ni la L minúscula, los cuatro glifos que las personas confunden con más frecuencia al leer notas manuscritas, impresiones de códigos QR o direcciones de monederos. Los desarrolladores comprueban cadenas con formato de dirección, los docentes demuestran bases alternativas y los scripts necesitan idas y vueltas deterministas sin instalar una biblioteca criptográfica.

Qué es el Base58 de Bitcoin y por qué faltan esos cuatro caracteres

Base58 es una codificación de binario a texto que proyecta una secuencia arbitraria de bytes sobre un alfabeto de cincuenta y ocho símbolos. A diferencia de Base64, descarta los caracteres difíciles de distinguir en papel y en voz alta: el dígito cero, la letra O mayúscula, la letra I mayúscula y la letra L minúscula.

El proyecto Bitcoin popularizó un orden concreto de los símbolos restantes: del uno al nueve, después A–Z sin I ni O, y después a–z sin l, y ese orden es el que usan los monederos, muchos exploradores de cadena de bloques y esta capacidad.

La codificación recorre los bytes de entrada como un entero big-endian en base doscientos cincuenta y seis, divide repetidamente entre cincuenta y ocho y asigna cada resto al alfabeto; los bytes cero iniciales se convierten en unos iniciales en la salida, la misma convención que siguen las direcciones Bitcoin. La decodificación invierte la correspondencia: cada carácter se convierte en un dígito del cero al cincuenta y siete, el entero grande se reconstruye y la matriz de bytes se recupera con la misma regla de unos iniciales.

Como el alfabeto no tiene carácter de relleno, la longitud por sí sola no implica un tamaño de bloque fijo como en Base64; las idas y vueltas siguen funcionando mientras ambas partes coincidan en el alfabeto y la convención de ceros iniciales. Cuando aparece un carácter fuera del alfabeto (cero, O, I, l, puntuación o espacios), el decodificador debe fallar con claridad. Una sustitución silenciosa inventaría una carga distinta y es peor que un error rotundo para monederos, sumas de verificación y pruebas automatizadas.

Esta landing se dirige a quienes buscan un codificador Base58, un decodificador Base58 o un conversor del alfabeto Bitcoin en línea; no es Base64, no es Base32 y no es un validador completo de direcciones Bitcoin con bytes de versión y sumas de verificación.

Consejos prácticos, límites y diferencias frente a Base64

Prefiera encode cuando parta de texto legible o de cargas binarias cortas como texto que desee pegar sin glifos ambiguos; prefiera decode cuando ya disponga de una cadena Base58 procedente de un monedero, una etiqueta QR o un archivo de casos. Las comprobaciones de ida y vuelta son la prueba de humo más rápida: codifique una frase conocida como Hello World, confirme el resultado clásico JxF12TrwUP45BMd, decodifique esa cadena y confirme que recupera la frase original byte a byte.

Mantenga las cargas por debajo del límite de caracteres publicado; las cadenas extremadamente largas se expanden como enteros grandes y conviene dividirlas o tratarlas sin conexión. Esta herramienta no es un analizador de direcciones Bitcoin: no elimina prefijos de versión, no recalcula la suma de verificación doble SHA-256 ni clasifica mainnet frente a testnet. Tampoco es Base64 ni Base64URL: esos alfabetos incluyen el signo más, la barra y el relleno de igual, y conservan el cero y la O mayúscula.

Prefiera Base58 cuando la seguridad de la transcripción humana importe más que la densidad; prefiera Base64 cuando necesite el máximo de bits por carácter y transporte solo entre máquinas. Al enseñar, muestre la misma frase codificada en Base58 y Base64 una junto a otra para que los alumnos vean por qué el alfabeto Bitcoin tiene otro aspecto y por qué los errores de copiado y pegado se reducen cuando desaparecen los cuatro glifos ambiguos.

Idas y vueltas de monederos y casos en pruebas

Genere cadenas Base58 conocidas a partir de textos de prueba y verifique en CI que la decodificación recupera los mismos bytes UTF-8 sin dependencias criptográficas.

Códigos cortos seguros para imprimir y QR

Codifique etiquetas cortas para que los códigos impresos eviten la confusión 0/O/I/l cuando el personal los escribe desde papel o cámaras de teléfono.

Enseñanza de bases alternativas y del alfabeto Bitcoin

En aulas y talleres se codifica Hello World, se inspecciona el alfabeto y después se fuerzan caracteres no válidos para mostrar la validación estricta.

¿Qué alfabeto utiliza este codificador Base58?

El alfabeto Bitcoin: 123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz. Excluye 0, O, I y l.

¿Base58 es lo mismo que Base64?

No. Base64 usa sesenta y cuatro símbolos, incluidos +, / y el relleno =, y conserva 0 y O. Base58 es más corto en glifos ambiguos y es habitual en cadenas de estilo Bitcoin.

¿Esta herramienta valida direcciones Bitcoin completas?

No. Solo codifica y decodifica texto UTF-8 en bruto bajo el alfabeto Base58 de Bitcoin. No comprueba bytes de versión ni sumas de verificación doble SHA-256.

¿El codificador Base58 es gratuito?

La herramienta del navegador es gratuita y se ejecuta localmente.

¿Por qué se rechaza mi cadena Base58 al decodificarla?

Porque contiene un carácter que no está en el alfabeto de Bitcoin, como el cero, la O o la I mayúsculas, la l minúscula, un signo de puntuación o un espacio. El decodificador se detiene con un aviso claro en lugar de convertirla en otro texto sin avisar.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/enc/base58

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/enc/base58 \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello World"}'
{
  "text": "Hello World"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.base58",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_chars100000
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Elija encode para convertir texto plano en Base58, o decode para recuperar UTF-8 a partir de una carga Base58; los caracteres ajenos al alfabeto devuelven un error invalid_input claro en lugar de una corrupción silenciosa. El recorrido es aritmética determinista pura sobre bytes UTF-8, sin red, sin semillas aleatorias y sin dependencia del reloj, por lo que el ejecutor gratuito del navegador y la API prepagada devuelven el mismo JSON en todo momento.

Cómo llamar a la API y qué contiene la respuesta

El modo predeterminado es encode: los bytes UTF-8 de text se convierten en una cadena Base58 bajo el alfabeto Bitcoin. El modo decode trata text como una carga Base58 y devuelve la cadena UTF-8 recuperada. Envíe un cuerpo JSON con un campo de cadena obligatorio text (alias input, value y data) y un mode opcional que puede ser encode o decode. La longitud de entrada está limitada a cien mil caracteres para que una sola solicitud no pueda agotar la memoria del Worker con una expansión patológica de enteros grandes. En caso de éxito en encode, la respuesta incluye mode, input, result y base58 con la misma cadena codificada, alphabet con la constante completa de cincuenta y ocho caracteres, alphabet_name con el valor bitcoin, input_bytes como recuento de bytes UTF-8, output_length como recuento de caracteres codificados y un breve mensaje en inglés. En caso de éxito en decode, la respuesta incluye mode, input, result y text con la cadena UTF-8 decodificada, los mismos campos de alfabeto, input_length, output_bytes y un mensaje equivalente. Una validación fallida (text ausente, text que no es cadena, entrada demasiado grande, un mode desconocido, un carácter Base58 no válido o bytes decodificados que no son UTF-8 válido) devuelve invalid_input y nunca se cobra. El precio es una tarifa plana de $0.002 por solicitud correcta con unidad item y precio unitario marginal cero.

Consejos prácticos, límites y diferencias frente a Base64

Incluya deliberadamente un carácter prohibido (el dígito cero, la O mayúscula, la I mayúscula o la L minúscula) en una solicitud de decodificación para comprobar que su cliente gestiona invalid_input y el mensaje de error que indica el índice y los glifos excluidos. Las tareas fallidas que devuelven invalid_input no consumen saldo prepagado, lo que mantiene baratos los scripts exploratorios cuando prueba caracteres ajenos al alfabeto.

¿Qué ocurre si decodifico una cadena que contiene 0, O, I o l?

La API devuelve invalid_input, indica el carácter incorrecto y su índice, y recuerda que el Base58 de Bitcoin excluye esos cuatro glifos. Las tareas fallidas no se cobran.

Ver la documentación completa del KIT →