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é à la 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 à détailler 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 aborder leur utilisation pour la première fois.

Utiliser les 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 quelques invites bien pensées, il est désormais facile de mettre au point des prototypes fonctionnels et de tester des hypothèses en temps réel.

J'aime toujours utiliser Postman pour explorer les API, mais je voulais voir ce que cela faisait d'utiliser l'API 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 prouver que les identifiants fonctionnaient et étaient correctement définis.

Ce petit test se trouve ici : github.com/superduperdot/auth-app

Deuxième test : soldes

Cela s'est avéré un peu plus complexe. L'API Brale prend en charge plusieurs types de valeurs (chacune représentant un actif distinct) et plusieurs types de transfert (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'account_id associé à vos identifiants
  • Utilisez cet ID 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 exposés dans la documentation, je les ai donc extraits de l'application en production et j'ai déposé les deux listes sur GitHub pour référence future :

L'obtention des tarifs à partir du point de terminaison de données a également bien fonctionné.

Autres observations

  • Si vous effectuez une exécution locale, attendez-vous à des problèmes de CORS ; utilisez un proxy.
  • L'authentification s'effectue sur auth.brale.xyz ; tout le reste se trouve sur api.brale.xyz.
  • La distinction entre account_id et address_id 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 sûres pour une utilisation en production. C'est intentionnel

Rien ici n'est définitif. Ces tests portaient principalement sur la vitesse et la facilité d'utilisation. L'objectif était de voir à quelle vitesse on peut passer des identifiants à quelque chose de concret, sans s'appuyer sur des outils internes ou 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 voir comment la nouvelle couche se comporte en conditions réelles. La CLI peut également être utile pour tester le système.