Chez Brickken, nous nous engageons à permettre aux entreprises et aux développeurs d'intégrer de manière transparente la tokenisation dans leurs plateformes. Aujourd'hui, nous sommes ravis d'annoncer le déploiement de Brickken API V2, une avancée majeure qui simplifie, optimise et renforce les intégrations.
Cette mise à jour simplifie votre utilisation de notre API, prépare le terrain pour les fonctionnalités à venir et garantit une évolutivité aisée de vos projets.
Bienvenue dans API V2 – La nouvelle génération
Ordre du jour :
- Aperçu des améliorations de la V2
- Changements importants à connaître
- Nouvelles fonctionnalités performantes
- Guide de migration étape par étape
Pourquoi migrer ?
- Intégration simplifiée
- Nouvelles fonctionnalités STO
- Amélioration Performances
Nouveautés de l'API V2
Fonctionnalité
V1
V2
Avantage
Noms des points de terminaison
/prepare-api-transactions
/prepare-transactions
URL plus claires et plus courtes
Flux de transaction
Paramètres complexes
Système txId simple
Complexité réduite
Prise en charge STO
Non disponible
Flux de travail complet
Plateforme d'investissement complète
Opérations pour le compte
Non disponible
En cours (3 points de terminaison)
Gérer les opérations des utilisateurs
1. Transactions d'envoi unifiées
Nous avons simplifié la gestion des transactions grâce à un point de terminaison unifié unique :
POST /send-transactions
Cela fonctionne avec toutes les méthodes préparées : newTokenization, mintToken, whitelist, burnToken, transferFrom, transferTo, approve, dividendDistribution et les nouvelles méthodes STO.
Corps de la requête (désormais unifié) :
{
"signedTransactions": ["0x..."],
"txId": "<txId de prepare-transactions>"
}
2. La préparation de la réponse inclut désormais txId
Lorsque vous préparez des transactions, vous obtenez désormais les deux éléments :
{
"txId": "tx_abc123def456",
"transactions": [{
"value": "0",
"gasLimit": "500000",
"maxFeePerGas": "20000000000"
}]
}
Avantages clés :
- Ajout de txId pour le suivi
- Structure plus claire et plus simple
- Plus d'objets BigNumber
3. Nettoyage de la dénomination des points de terminaison
Nous avons simplifié la dénomination des points de terminaison en supprimant le suffixe -api :
- POST /prepare-api-transactions → POST /prepare-transactions
- POST /send-api-transaction → POST /send-transactions
- GET /get-api-transaction-status → GET /get-transaction-status
4. Renommer le champ : symbole → tokenSymbol
Dans tous les corps de préparation (y compris newTokenization et autres), veuillez désormais utiliser tokenSymbol au lieu de symbol.
Exemple :
{ "tokenSymbol": "EXMPL" }
5. Simplification des transactions d'envoi
V1 (Complexe – Nombreux paramètres) :
{
"signedTransactions": ["0x123..."],
"chainId": "aa36a7",
"method": "newTokenization",
"tokenSymbol": "ABC",
"tokenizerEmail": "[email protected]"
// ... et bien d'autres paramètres
}
V2 (Simple – Juste 2 paramètres !) :
{
"signedTransactions": ["0x123..."],
"txId": "tx_abc123def456"
}
6. Nouvelles fonctionnalités
🔹 Flux de travail STO complet
L'API V2 introduit la prise en charge complète des offres de jetons de sécurité (STO).
Créer une STO :
{
"method": "newSto",
"tokenSymbol": "EXMPL",
"price": "100",
"minInvestment": "10",
"maxInvestment": "10000",
"startDate": "2024-01-01T00:00:00Z",
"endDate": "2024-12-31T23:59:59Z",
"softCap": "50000",
"hardCap": "500000"
}
Investissez dans STO :
{
"method": "newInvest",
"tokenSymbol": "EXMPL",
"investorEmail": "[email protected]",
"amount": "1000"
}
Réclamer des jetons :
{
"method": "claimTokens",
"tokenSymbol": "EXMPL",
"investorEmail": "[email protected]"
}
🔹 Points de terminaison pour le compte (en développement)
Nous introduisons des opérations pour le compte pour vous permettre d'agir directement pour vos utilisateurs :
- POST /create-token-on-behalf
- POST /invest-on-behalf
- POST /sto-claim-on-behalf
Les cas d'utilisation incluent :
- Investissements gérés par la plateforme
- Distribution automatisée de jetons
- Expérience utilisateur simplifiée
⚠️ Ces points de terminaison sont encore en développement ; La disponibilité et les paramètres peuvent évoluer.
🔹 Accès aux données amélioré
Nouveaux points de terminaison GET pour une meilleure visibilité :
Point de terminaison
Objectif
Exemple de réponse
/get-allowance
Vérifier les allocations de jetons
{ "allowance": "1000000" }
/get-balancewhitelist
Solde + état de la liste blanche
{ "balance": "500", "isWhitelisted": true }
/get-network-info
Réseau info
{ "chainId": "0x89", "name": "Polygon" }
/get-token-info
Détails du jeton
{ "name": "Token", "totalSupply": "1000000" }
/get-tokenizer-info
Données du tokenizer
{ "email": "...", "tokens": [...] }
Étapes de migration – Votre plan en 5 étapes
- Mettre à jour les URL (supprimer l'API)
// Ancien
const url = '<https://api.sandbox.brickken.com/prepare-api-transactions>';
// Nouveau
const url = '<https://api-sandbox.brickken.com/prepare-transactions>';
Renommer le symbole → tokenSymbol dans les corps de préparation
- Conserver l'ID de transaction dans les réponses de préparation
- Utiliser un corps d'envoi unifié
await api.send({ signedTransactions: signed, txId });
Assurez-vous que les valeurs chainId sont hexadécimales avec le préfixe 0x
- Ancien : « aa36a7 »
- Nouveau : « 0xaa36a7 »
✅ Toujours tester d'abord dans Sandbox : https://dapp.sandbox.brickken.com/en/
Résumé des avantages
- 90 % de paramètres en moins dans les requêtes d'envoi
- Flux unifié pour toutes les méthodes
- Noms de points de terminaison plus clairs (tokenSymbol, URL plus courtes)
- STO complet fonctionnalité
- Opérations pour le compte de la gestion de la plateforme
- Nouveaux points de terminaison GET enrichis pour de meilleures informations
- Architecture prête pour l'avenir
Calendrier de migration
Nous recommandons de migrer dans les 1 à 2 semaines à venir.
La V1 restera disponible pendant cette période pour permettre une transition en douceur, après quoi la V2 deviendra la norme.
Ressources et Assistance
Nous sommes là pour vous accompagner à chaque étape, des tests en sandbox à la migration en production.
L'API Brickken V2 est conçue pour simplifier, accélérer et préparer l'avenir des intégrations de tokenisation. Nous avons hâte de voir ce que vous allez créer avec. 🚀