Codificatore e decodificatore Base58

Scelga encode per convertire testo in chiaro in Base58, oppure decode per recuperare l'UTF-8 da un payload Base58; i caratteri fuori alfabeto restituiscono un chiaro errore invalid_input invece di una corruzione silenziosa.

Cos'è il Base58 Bitcoin e perché mancano quei quattro caratteri

Una sostituzione silenziosa inventerebbe un payload diverso ed è peggiore di un errore netto per wallet, checksum e test automatici.

Come chiamare l'API e cosa contiene la risposta

La modalità predefinita è encode: i byte UTF-8 di text diventano una stringa Base58 nell'alfabeto Bitcoin. Invii un corpo JSON con un campo stringa obbligatorio text (alias input, value e data) e un mode opzionale che può essere encode o decode. La modalità decode tratta text come payload Base58 e restituisce la stringa UTF-8 recuperata. La lunghezza dell'input è limitata a centomila caratteri, così una singola richiesta non può esaurire la memoria del Worker con un'espansione patologica di interi grandi. In caso di successo per encode, la risposta include mode, input, result e base58 con la stessa stringa codificata, alphabet con la costante completa di cinquantotto caratteri, alphabet_name impostato su bitcoin, input_bytes come conteggio dei byte UTF-8, output_length come conteggio dei caratteri codificati e un breve messaggio in inglese. In caso di successo per decode, la risposta include mode, input, result e text con la stringa UTF-8 decodificata, gli stessi campi dell'alfabeto, input_length, output_bytes e un messaggio corrispondente. La convalida fallita (text mancante, text non stringa, input troppo grande, mode sconosciuto, carattere Base58 non valido o byte decodificati non validi in UTF-8) restituisce invalid_input e non viene mai addebitata. Il prezzo è un fisso di $0.002 per richiesta riuscita con unità item e prezzo unitario marginale pari a zero.

Consigli pratici, limiti e differenze rispetto a Base64

I controlli di round-trip sono lo smoke test più veloce: codifichi una frase nota come Hello World, confermi il risultato classico JxF12TrwUP45BMd, poi decodifichi quella stringa e confermi di recuperare la frase originale byte per byte. Non è nemmeno Base64 o Base64URL: quegli alfabeti includono più, barra e padding con uguale, e mantengono zero e O maiuscola. Preferisca Base58 quando la sicurezza della trascrizione umana conta più della densità; preferisca Base64 quando le servono il massimo di bit per carattere e un trasporto solo macchina. In didattica, mostri la stessa frase codificata in Base58 e Base64 una accanto all'altra, così chi impara vede perché l'alfabeto Bitcoin ha un aspetto diverso e perché gli errori di copia-incolla calano quando i quattro glifi ambigui scompaiono. Includa deliberatamente un carattere proibito (cifra zero, O maiuscola, I maiuscola o L minuscola) in una richiesta di decodifica per verificare che il suo client gestisca invalid_input e il messaggio di errore che indica l'indice e i glifi esclusi. Mantenga i payload sotto il limite di caratteri pubblicato; le stringhe estremamente lunghe si espandono come interi grandi ed è meglio dividerle o gestirle offline. Questo strumento non è un parser di indirizzi Bitcoin: non elimina un prefisso di versione, non ricalcola un checksum double-SHA256 e non distingue mainnet da testnet. I compiti falliti che restituiscono invalid_input non consumano saldo prepagato, il che mantiene economici gli script esplorativi quando testa caratteri fuori alfabeto.