Saltar al contenido

API y SDK

La URL base es https://api.bricsfinance.fun. El contrato completo es el documento OpenAPI.

Leer la Ciudad

curl https://api.bricsfinance.fun/v1/city
curl https://api.bricsfinance.fun/v1/towers/0xYourWalletAddress
curl https://api.bricsfinance.fun/v1/addresses
curl https://api.bricsfinance.fun/v1/status

/v1/addresses lista las direcciones oficiales en Robinhood Chain, entre ellas la del token $BRICS. Revisa ahí una dirección antes de confiar en ella.

SDK

El SDK está en sdk/ts dentro del repositorio. Todavía no está en npm.

import { Brics } from './sdk/ts/src/index';

const brics = new Brics();
const tower = await brics.tower('0xYourWalletAddress');

Iniciar sesión

  1. POST /v1/auth/nonce con { chain: "robinhood", address } te da el mensaje que debes firmar.
  2. Fírmalo con la billetera usando personal_sign. Las cuentas inteligentes firman mediante EIP-1271.
  3. POST /v1/auth/verify con { nonce, signature } inicia una sesión. Los clientes del SDK envían el encabezado x-brics-client: sdk para recibir un token bearer en lugar de una cookie.

Un nonce sirve una sola vez y caduca a los cinco minutos.

Alertas de riesgo

GET /v1/alerts lista todas las alertas abiertas y las resueltas en los últimos 30 días, cada una con una gravedad (info, warn o critical) y un mensaje claro. GET /v1/alerts/feed.xml es la misma lista como feed Atom, y GET /v1/status incluye las abiertas. Una alerta se abre una sola vez por condición y queda en el registro después de resolverse. Las alertas nunca nombran a un titular. Para recibirlas en el momento, consulta la página de estado.

Límites

120 solicitudes por minuto por IP, y cuerpos de solicitud de hasta 64 KB. Los errores tienen la forma { "error": "code", "message": "…" }.