API e SDK
A URL base é https://api.bricsfinance.fun. O contrato completo é o documento OpenAPI.
Leia a Cidade
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 os endereços oficiais na Robinhood Chain, entre eles o do token $BRICS. Confira um endereço ali antes de confiar nele.
SDK
O SDK fica em sdk/ts no repositório. Ele ainda não está no npm.
import { Brics } from './sdk/ts/src/index';
const brics = new Brics();
const tower = await brics.tower('0xYourWalletAddress');
Entrar
POST /v1/auth/noncecom{ chain: "robinhood", address }devolve a mensagem a assinar.- Assine com a carteira usando
personal_sign. Contas inteligentes assinam via EIP-1271. POST /v1/auth/verifycom{ nonce, signature }inicia uma sessão. Clientes do SDK enviam o cabeçalhox-brics-client: sdkpara receber um bearer token em vez de um cookie.
Um nonce funciona uma única vez e expira após cinco minutos.
Alertas de risco
GET /v1/alerts lista todos os alertas abertos e os resolvidos nos últimos 30 dias, cada um com uma gravidade (info, warn ou critical) e uma mensagem simples. GET /v1/alerts/feed.xml é a mesma lista como feed Atom, e GET /v1/status traz os abertos. Um alerta abre uma vez por condição e continua no registro depois de resolvido. Os alertas nunca citam um holder. Para recebê-los na hora, veja a página de status.
Limites
120 requisições por minuto por IP, e corpos de requisição de até 64 KB. Os erros têm este formato: { "error": "code", "message": "…" }.