Brale Nous avons récemment mis en ligne une version mise à jour des API de l’stablecoin. Le projet a débuté par une phase de conception au premier trimestre, est passé en phase de développement au deuxième trimestre, puis a été mis en production auprès de clients réels peu après.
L’API offre de nombreuses fonctionnalités. Cet article ne vise pas à passer en revue l’ensemble de ces fonctionnalités. Il s’agit simplement d’un compte rendu de la manière dont j’ai testé ces fonctionnalités, principalement pour le plaisir, mais aussi en partie pour comprendre comment d’autres pourraient s’y prendre pour l’utiliser pour la première fois.
Utiliser les grands modèles de langage (LLM) pour explorer l’API
La dernière fois que j’ai travaillé sur un projet de ce type, les grands modèles linguistiques ne faisaient pas vraiment partie du flux de travail. Cela a changé. Avec Cursor et des invites bien formulées, il est désormais facile de mettre au point des prototypes fonctionnels et de tester des hypothèses en temps réel.
J’apprécie toujours autant utiliser Postman pour explorer les API, mais je voulais découvrir ce que cela faisait d’utiliser l’Brale API dans un environnement un peu plus proche d’une véritable interface.
Premier test : l’authentification
J’ai commencé par un flux d’authentification basique : utiliser un client_id et un client_secret pour obtenir un jeton « bearer ». Rien d’extraordinaire. Juste assez pour vérifier que les identifiants fonctionnaient et que leur portée était correctement définie.
Ce petit test est disponible ici : github.com/superduperdot/auth-app
Deuxième test : soldes
Cela s’est avéré un peu plus complexe. L’API Brale API prend en charge plusieurs types de valeurs (chacune représentant un actif distinct) et plusieurs types de transferts (chacun représentant une chaîne ou un réseau). Le processus de récupération des soldes s’est donc déroulé comme suit :
Récupérer l’ associé à vos identifiants
Utiliser cet identifiant pour extraire la liste des adresses
Filtrer les résultats par type : « internal » pour isoler les portefeuilles de garde
Parcourir toutes les combinaisons connues de types de valeur et de types de transfert
Interroger les soldes et enregistrer les résultats
Cette application est disponible ici : github.com/superduperdot/balance-app
À la recherche des types pris en charge
Les TransferTypes sont bien documentés. Les ValueTypes ne sont pas encore directement mentionnés dans la documentation ; je les ai donc extraits de l’application en production et j’ai publié les deux listes sur GitHub pour référence future :
Liste des TransferTypes d'Brale
Liste des ValueTypes d'Brale
L'obtention des tarifs via le point de terminaison de données a également bien fonctionné.
Autres remarques
Si vous effectuez des tests en local, attendez-vous à rencontrer des problèmes liés au CORS ; utilisez un proxy.
L'authentification s'effectue sur auth.brale.xyz ; tout le reste se trouve sur api.brale.xyz.
La distinction entre et me pose encore quelques petits problèmes si je ne fais pas attention.
Ces applications de test stockent les identifiants localement et ne sont pas adaptées à une utilisation en production. C’est intentionnel
Rien ici n’est définitif. Ces tests portaient principalement sur la rapidité et la facilité d’utilisation. L’objectif était de voir à quelle vitesse on peut passer des identifiants à un résultat concret, sans s’appuyer sur des outils internes ni sur une connaissance approfondie de la plateforme.
Si vous explorez l’Brale API, cela vous permettra peut-être de raccourcir le chemin. Sinon, cela valait tout de même la peine de consacrer du temps à observer le comportement de cette nouvelle couche en conditions réelles. L’interface en ligne de commande (CLI) peut également s’avérer utile pour tester le système.