Codificador e decodificador Base58 online

Como codificar em Base58

1. Digite ou cole o texto em Entrada · Texto. A string Base58 aparece em Saída · Base58 enquanto você digita.
2. Escolha o Alfabeto abaixo da saída: Bitcoin (o padrão, usado também pelo IPFS e pela Solana), Flickr ou Ripple.
3. Para codificar bytes brutos em vez de texto, ajuste De em Hex ou Base64 e cole os bytes nesse formato. Uma chave pública ou um hash quase sempre são bytes, não texto.
4. Clique em Base58 → Texto no seletor de direção para decodificar, ou abra o decodificador Base58, que mostra os bytes em hex.

Como a codificação Base58 funciona

O Base58 não corta a entrada em grupos fixos de bits como o Base64. Ele lê todos os bytes como um único número big-endian e escreve esse número em base 58, depois acrescenta um 1 para cada byte zero inicial. É por isso que um único byte alterado pode mudar a string inteira, e por isso o comprimento depende do valor, não só da quantidade de bytes.

O custo de tratar os dados como um único número cresce rápido com o tamanho, então esta ferramenta limita a entrada Base58 a 64 KB. Isso é muito mais do que qualquer chave, hash ou endereço precisa.

Os três alfabetos Base58

Os três usam os mesmos 58 caracteres (dígitos e letras sem 0, O, I, l), em ordens diferentes:

O Flickr inverte maiúsculas e minúsculas, e era usado pelo Flickr em URLs curtas de fotos. O alfabeto do Ripple começa com r, então os endereços do XRP Ledger, que têm byte de versão zero, começam com r, do mesmo jeito que os endereços Bitcoin começam com 1. Decodificar com o alfabeto errado geralmente funciona sem erro e dá bytes diferentes, então confira o alfabeto primeiro quando um valor não bater.

Zeros à esquerda e o prefixo 1

Como o Base58 trata os dados como um número, os bytes zero no início sumiriam. O formato os preserva escrevendo um 1 por byte zero:

A última linha é um endereço real: trinta e dois 1s é o System Program da Solana, cuja chave pública são 32 bytes zero. Os zeros à esquerda são onde o código Base58 escrito à mão mais erra, e um codificador que os descarta produz strings que decodificam para menos bytes.

Onde o Base58 é usado

• Endereços Bitcoin e chaves WIF. Endereços legados (1…, 3…) e chaves privadas WIF (5…, K…, L…) são Base58Check: Base58 com um byte de versão e um checksum. Endereços Bech32 (bc1…) são outra codificação.
• IPFS CIDv0. Os identificadores Qm… são Base58 simples de um multihash de 34 bytes: 12 (SHA-256), 20 (32 bytes de comprimento) e o digest. O cabeçalho 12 20 é o que faz todo CIDv0 começar com Qm.
• Solana. Endereços e chaves públicas são Base58 de 32 bytes (de 32 a 44 caracteres); assinaturas de transações são Base58 de 64 bytes (até 88 caracteres).

Base58 em Python

O Python não tem Base58 na biblioteca padrão. O algoritmo é curto o bastante para escrever à mão, e esta versão trata os zeros à esquerda:

ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"

def b58encode(data: bytes) -> str:
    n = int.from_bytes(data, "big")
    out = ""
    while n:
        n, r = divmod(n, 58)
        out = ALPHABET[r] + out
    zeros = len(data) - len(data.lstrip(b"\0"))
    return "1" * zeros + out

b58encode(b"Hello")           # '9Ajdvzr'
b58encode(bytes(32))          # '11111111111111111111111111111111'

Para código de produção, um pacote mantido, como o base58 do PyPI, também cobre o Base58Check. Padrões gerais de codificação em Python estão na página de Python.

Perguntas frequentes