Encodeur et décodeur Base58 Ripple

Choisissez encode pour convertir du texte brut en Base58 Ripple, ou decode pour retrouver l'UTF-8 à partir d'une charge utile Base58 Ripple ; les caractères hors alphabet renvoient une erreur invalid_input claire au lieu d'une corruption silencieuse. Le chemin est une arithmétique purement déterministe sur des octets UTF-8 — sans réseau, sans graines aléatoires, sans dépendance à l'horloge — de sorte que l'exécuteur gratuit du navigateur et l'API prépayée renvoient le même JSON à chaque fois.

Comment appeler l'API et ce que contient la réponse

Le mode par défaut est encode : les octets UTF-8 de text deviennent une chaîne Base58 sous l'alphabet Ripple. Le mode decode traite text comme une charge utile Base58 Ripple et renvoie la chaîne UTF-8 récupérée. Envoyez un corps JSON avec un champ chaîne obligatoire text (alias input, value et data) et un mode optionnel valant encode ou decode. La longueur d'entrée est plafonnée à cent mille caractères afin qu'une seule requête ne puisse épuiser la mémoire du Worker sur une expansion pathologique de grands entiers. En cas de succès pour encode, la réponse inclut mode, input, result et base58 avec la même chaîne encodée, alphabet avec la constante complète de cinquante-huit caractères Ripple, alphabet_name égal à ripple, input_bytes comme nombre d'octets UTF-8, output_length comme nombre de caractères encodés, et un court message en anglais. En cas de succès pour decode, la réponse inclut mode, input, result et text avec la chaîne UTF-8 décodée, les mêmes champs d'alphabet, input_length, output_bytes et un message correspondant. Une validation échouée — text manquant, text non chaîne, entrée trop grande, mode inconnu, caractère Base58 invalide, ou octets décodés non UTF-8 valides — renvoie invalid_input et n'est jamais facturée. Le tarif est un forfait de $0.002 par requête réussie avec unité item et prix unitaire marginal nul.

Conseils pratiques, limites et différences avec Bitcoin et Flickr Base58

Gardez les charges sous la limite de caractères publiée ; les chaînes extrêmement longues s'étendent comme de grands entiers et se traitent mieux en les scindant ou hors ligne. En enseignement, encodez la même phrase sous les alphabets Ripple, Bitcoin et Flickr côte à côte afin que les apprenants voient pourquoi les chaînes diffèrent alors que les trois écartent les quatre mêmes glyphes ambigus. Incluez délibérément un caractère interdit — chiffre zéro, O majuscule, I majuscule ou L minuscule — dans une requête de décodage pour vérifier que votre client gère invalid_input et le message d'erreur qui nomme l'index et les glyphes exclus. Les tâches en échec qui renvoient invalid_input ne consomment pas le solde prépayé, ce qui maintient les scripts d'exploration peu coûteux lorsque vous testez des caractères hors alphabet.