Codificador e decodificador Base58 Ripple

Escolha encode para converter texto simples em Base58 Ripple, ou decode para recuperar UTF-8 a partir de uma carga Base58 Ripple; caracteres fora do alfabeto devolvem um erro invalid_input claro em vez de corrupção silenciosa. O caminho é aritmética determinística pura sobre bytes UTF-8 — sem rede, sem sementes aleatórias e sem dependência do relógio —, de forma que o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON sempre.

Como chamar a API e o que a resposta contém

O modo padrão é encode: os bytes UTF-8 de text tornam-se uma string Base58 sob o alfabeto Ripple. O modo decode trata text como uma carga Base58 Ripple e devolve a string UTF-8 recuperada. Envie um corpo JSON com um campo de string obrigatório text (aliases input, value e data) e um mode opcional que seja encode ou decode. O comprimento de entrada é limitado a cem mil caracteres para que um único pedido não esgote a memória do Worker em expansões patológicas de inteiros grandes. Em sucesso de encode, a resposta inclui mode, input, result e base58 com a mesma string codificada, alphabet com a constante completa de cinquenta e oito caracteres Ripple, alphabet_name com o valor ripple, input_bytes como contagem de bytes UTF-8, output_length como contagem de caracteres codificados e uma mensagem curta em inglês. Em sucesso de decode, a resposta inclui mode, input, result e text com a string UTF-8 decodificada, os mesmos campos de alfabeto, input_length, output_bytes e uma mensagem correspondente. Validação falhada — text ausente, text que não é string, entrada grande demais, mode desconhecido, caractere Base58 inválido ou bytes decodificados que não são UTF-8 válido — devolve invalid_input e nunca é cobrada. O preço é uma tarifa fixa de US$ 0,002 por solicitação bem-sucedida com unidade item e preço unitário marginal zero.

Dicas práticas, limites e diferenças em relação ao Bitcoin e ao Flickr Base58

Mantenha as cargas abaixo do limite de caracteres publicado; strings extremamente longas expandem como inteiros grandes e é melhor dividi-las ou tratá-las offline. Ao ensinar, codifique a mesma frase sob os alfabetos Ripple, Bitcoin e Flickr lado a lado para que os alunos vejam por que as strings diferem embora os três removam os mesmos quatro glifos ambíguos. Inclua deliberadamente um caractere proibido — o dígito zero, o O maiúsculo, o I maiúsculo ou o L minúsculo — em um pedido de decode para afirmar que o cliente trata invalid_input e a mensagem de erro que nomeia o índice e os glifos excluídos. Tarefas falhas que devolvem invalid_input não consomem saldo pré-pago, o que mantém baratos os scripts exploratórios quando voce testa caracteres fora do alfabeto.