Brale Recientemente hemos lanzado una versión actualizada de las API de stablecoin. El proyecto comenzó con una fase de diseño en el primer trimestre, pasó a la fase de desarrollo en el segundo trimestre y entró en producción con clientes reales poco después.

El «API» ofrece muchas posibilidades. Esta entrada no pretende ser un desglose de todas sus funcionalidades. Se trata simplemente de un relato de cómo he estado probando algunas cosas, sobre todo por diversión y, en parte, para entender cómo podrían abordarlo otros usuarios que lo utilicen por primera vez.

Uso de modelos de lenguaje grandes (LLM) para trabajar con el «API»

La última vez que trabajé en algo así, los grandes modelos de lenguaje (LLM) no formaban realmente parte del flujo de trabajo. Eso ha cambiado. Con Cursor y unas indicaciones adecuadas, ahora es fácil crear prototipos funcionales y comprobar hipótesis en tiempo real.

Sigo prefiriendo usar Postman para explorar las API, pero quería ver qué tal resultaba utilizar el «Brale» API dentro de algo un poco más parecido a una interfaz real.

Primera prueba: autenticación

Empecé con un flujo de autenticación básico: usar un y un para obtener un token «bearer». Nada del otro mundo. Lo justo para comprobar que las credenciales funcionaban y tenían el ámbito adecuado.

Esa pequeña prueba está aquí: github.com/superduperdot/auth-app

Segunda prueba: saldos

Esto resultó ser un poco más complejo. El Brale API admite múltiples tipos de valores (cada uno de los cuales representa un activo distinto) y múltiples tipos de transferencia (cada uno de los cuales representa una cadena o red). Así que el proceso para recuperar los saldos fue el siguiente:

  • Obtener el «account_id» asociado a tus credenciales

  • Utilizar ese ID para obtener la lista de direcciones

  • Filtrar los resultados por tipo: «internal» para aislar las carteras de custodia

  • Recorrer todas las combinaciones conocidas de tipos de valor y tipos de transferencia

  • Consultar los saldos y registrar los resultados

La aplicación está aquí: github.com/superduperdot/balance-app

En busca de los tipos compatibles

Los TransferTypes están bien documentados. Los ValueTypes aún no aparecen directamente en la documentación, así que los he extraído de la aplicación en producción y he subido ambas listas a GitHub para futuras consultas:

  • Lista de tipos de transferencia de Brale

  • Lista de ValueTypes de Brale

La obtención de precios desde el punto final de datos también funcionó bien.

Otras observaciones

  • Si estás ejecutando la aplicación localmente, es probable que surjan problemas de CORS; utiliza un proxy.

  • La autenticación se realiza en auth.brale.xyz; todo lo demás se encuentra en api.brale.xyz.

  • La distinción entre account_id y address_id todavía me genera pequeños errores si no tengo cuidado.

  • Estas aplicaciones de prueba almacenan las credenciales localmente y no son seguras para su uso en producción. Es intencionado.

Nada de lo que aquí se muestra es definitivo. Estas pruebas se centraron principalmente en la velocidad y la usabilidad. El objetivo era ver con qué rapidez se puede pasar de las credenciales a algo real, sin depender de herramientas internas ni de un conocimiento profundo de la plataforma.

Si estás explorando el Brale API, quizá esto te acorte el camino. Si no es así, aun así ha merecido la pena dedicar tiempo a ver cómo se comporta la nueva capa en la práctica. La CLI también puede ser útil para probarla a fondo.