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
POST /v1/auth/noncecon{ chain: "robinhood", address }te da el mensaje que debes firmar.- Fírmalo con la billetera usando
personal_sign. Las cuentas inteligentes firman mediante EIP-1271. POST /v1/auth/verifycon{ nonce, signature }inicia una sesión. Los clientes del SDK envían el encabezadox-brics-client: sdkpara 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": "…" }.