Codificador/descodificador de Base58

O que Base58 Bitcoin faz

Base58 representa bytes com cinquenta e oito símbolos alfanuméricos e remove 0, O, I e l para reduzir a confusão visual. Também evita pontuação incómoda em identificadores copiados por pessoas.

Ao contrário de Base32 e Base64, não usa grupos de bits fixos. Os bytes são tratados como um inteiro grande e divididos repetidamente por 58. Como os zeros à esquerda desapareceriam nesse processo, cada byte zero inicial passa a ser representado pelo símbolo 1.

O texto é convertido para UTF-8 antes da codificação. Na descodificação, os bytes precisam formar UTF-8 válido para esta interface exibi-los como texto.

Como usar Base58

1. Escolha Codificar para texto ou Descodificar para uma cadeia Base58.
2. Cole o valor exatamente; não há preenchimento, espaços nem equivalência entre maiúsculas e minúsculas.
3. Corrija qualquer caráter ilegal indicado pela ferramenta.
4. Use o vetor Hello World e o exemplo Unicode para comparar implementações.
5. Para cargas binárias, use as funções de bytes em código em vez de forçar uma representação textual.

Exemplos Base58 com alfabeto Bitcoin

Os casos mostram texto, Unicode, zeros iniciais e carateres excluídos. Base58 não usa preenchimento.

Alfabeto e zeros iniciais

A ferramenta não adiciona versão nem soma de verificação. O descodificador aceita apenas o alfabeto Bitcoin exato.

Os carateres 1 no início são dados: cada um acrescenta um byte zero antes do inteiro descodificado.

• 0, O, I e l são inválidos.
• Maiúsculas e minúsculas são significativas.
• Não existe preenchimento =.
• Cada zero inicial transforma-se num 1.
• A interface de texto exige UTF-8 válido.

Como Base58 preserva bytes

O codificador conta zeros iniciais, constrói um BigInt em base 256 e extrai restos de divisões por 58. Depois antepõe a quantidade correspondente de 1.

O descodificador multiplica o acumulador por 58, soma cada dígito, decompõe o inteiro em bytes base 256 e restaura os zeros iniciais.

BigInt mantém a aritmética exata, mas Base58 puro não deteta erros. Base58Check adiciona estrutura e checksum que esta ferramenta não inventa.

Usos comuns de Base58

Base58 é usado em identificadores binários destinados a pessoas. Não fornece segurança.

Erros importantes de Base58

Alterar maiúsculas ou minúsculas, ou perder um 1 inicial, muda o valor, mesmo quando a cadeia restante continua sintaticamente válida.

Uma cadeia Base58 válida não garante que seja um endereço, uma chave ou um conteúdo válido para determinado protocolo.

• Não substitua carateres parecidos.
• Remova quebras de linha apenas se o formato de origem permitir.
• Eliminar um 1 remove um byte zero.
• Trocar maiúsculas muda o número.
• Base58Check requer validação específica.

Base58 comparado a Base58Check e Base64

Base58 puro é apenas uma representação de bytes. Base58Check acrescenta prefixo, checksum e regras de protocolo.

Base64 é mais compacto e rápido em blocos de bits, mas inclui pontuação. Base32 tem alfabeto menor e preenchimento definido pela RFC 4648.