Présentation de Brickken API V2 : plus rapide, plus simple et prêt pour l'avenir

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

1. 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>';

‍

2. 
   Renommer le symbole → tokenSymbol dans les corps de préparation
   
   
3. Conserver l'ID de transaction dans les réponses de préparation
   
   
4. Utiliser un corps d'envoi unifié
   
   

await api.send({ signedTransactions: signed, txId });

‍

5. 
   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://api-sandbox.brickken.com

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

• 📖 Documentation API V2
• ✉️ E-mail : [email protected]

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. 🚀

‍