Pular para o conteúdo

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

  1. POST /v1/auth/nonce com { chain: "robinhood", address } devolve a mensagem a assinar.
  2. Assine com a carteira usando personal_sign. Contas inteligentes assinam via EIP-1271.
  3. POST /v1/auth/verify com { nonce, signature } inicia uma sessão. Clientes do SDK enviam o cabeçalho x-brics-client: sdk para 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": "…" }.