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» hace muchas cosas. Esta entrada no es un desglose de todas esas funcionalidades. Es solo un registro de cómo he estado probando cosas, principalmente por diversión y, en parte, para entender cómo otros podrían abordarlo al usarlo 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 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 probar hipótesis en tiempo real.

Sigo prefiriendo usar Postman para explorar las API, pero quería ver qué tal era 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 client_id y un client_secret para obtener un token de portador. Nada del otro mundo. Lo justo para demostrar que las credenciales funcionaban y tenían el alcance adecuado.

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

Segunda prueba: saldos

Esto resultó ser un poco más complicado. 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 así:

  • Obtener el account_id asociado a tus credenciales
  • Utiliza 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

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

Buscando los tipos compatibles

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

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 está 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 uso en producción. Eso 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 lo rápido que 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 acorte el camino. Si no es así, aún 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.