Aller au contenu

API et SDK

L’URL de base est https://api.bricsfinance.fun. Le contrat complet est le document OpenAPI.

Lire la Ville

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 liste les adresses officielles sur Robinhood Chain, dont celle du token $BRICS. Vérifiez-y une adresse avant de lui faire confiance.

SDK

Le SDK se trouve dans sdk/ts du dépôt. Il n’est pas encore sur npm.

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

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

Se connecter

  1. POST /v1/auth/nonce avec { chain: "robinhood", address } vous donne le message à signer.
  2. Signez-le avec le portefeuille via personal_sign. Les comptes intelligents (smart accounts) signent via EIP-1271.
  3. POST /v1/auth/verify avec { nonce, signature } ouvre une session. Les clients SDK envoient l’en-tête x-brics-client: sdk pour obtenir un jeton bearer au lieu d’un cookie.

Un nonce ne sert qu’une fois et expire au bout de cinq minutes.

Alertes de risque

GET /v1/alerts liste toutes les alertes ouvertes et celles résolues au cours des 30 derniers jours, chacune avec une gravité (info, warn ou critical) et un message en clair. GET /v1/alerts/feed.xml donne la même liste sous forme de flux Atom, et GET /v1/status contient les alertes ouvertes. Une alerte s’ouvre une seule fois par condition et reste dans l’historique une fois levée. Les alertes ne nomment jamais un détenteur. Pour les recevoir en temps réel, voir la page de statut.

Limites

120 requêtes par minute et par IP, et des corps de requête jusqu’à 64 Ko. Les erreurs ont la forme { "error": "code", "message": "…" }.