En Brickken, nos comprometemos a capacitar a las empresas y desarrolladores para que integren sin problemas la tokenización en sus plataformas. Hoy, nos complace anunciar el lanzamiento de Brickken API V2, un gran avance que simplifica, hace más consistentes y potentes las integraciones.
Esta actualización optimiza la forma en que trabajas con nuestra API, prepara el terreno para las próximas funciones y garantiza que tus proyectos puedan escalar con facilidad.
Bienvenido a API V2: La Próxima Generación
Agenda de hoy:
- Resumen de las mejoras de V2
- Cambios importantes que debes conocer
- Nuevas funciones potentes
- Guía de migración paso a paso
¿Por qué migrar?
- Integración simplificada
- Nueva STO capacidades
- Rendimiento mejorado
Novedades de la API V2
Característica
V1
V2
Beneficio
Nombres de puntos finales
/prepare-api-transactions
/prepare-transactions
URL más limpias y cortas
Flujo de transacciones
Parámetros complejos
Sistema txId simple
Complejidad reducida
Compatibilidad con STO
No disponible
Flujo de trabajo completo
Plataforma de inversión completa
Operaciones en nombre de
No disponible
En progreso (3 puntos finales)
Administrar operaciones de usuario
1. Transacciones de envío unificadas
Hemos simplificado la gestión de transacciones con un único punto final unificado:
POST /send-transactions
Esto funciona con todos los métodos preparados: newTokenization, mintToken, whitelist, burnToken, transferFrom, transferTo, approved, dividendDistribution y los nuevos métodos STO.
Cuerpo de la solicitud (ahora unificado):
{
"signedTransactions": ["0x..."],
"txId": ""
}
2. Preparar respuesta ahora incluye txId
Al preparar transacciones, ahora obtendrás:
{
"txId": "tx_abc123def456",
"transactions": [{
"value": "0",
"gasLimit": "500000",
"maxFeePerGas": "2000000000"
}]
}
Beneficios clave:
- Se agregó txId para seguimiento
- Estructura más limpia y simple
- No más objetos BigNumber
3. Limpieza de nombres de puntos finales
Hemos simplificado los nombres de los puntos finales eliminando el sufijo -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. Cambio de nombre de campo: symbol → tokenSymbol
En todos los cuerpos de preparación (incluido newTokenization y otros), ahora use tokenSymbol en lugar de symbol.
Ejemplo:
{ "tokenSymbol": "EXMPL" }
5. Simplificación de envío de transacciones
V1 (Complejo – Muchos parámetros):
{
"signedTransactions": ["0x123..."],
"chainId": "aa36a7",
"method": "newTokenization",
"tokenSymbol": "ABC",
"tokenizerEmail": "[email protected]"
// ... muchos más parámetros
}
V2 (Simple: ¡solo 2 parámetros!):
{
"signedTransactions": ["0x123..."],
"txId": "tx_abc123def456"
}
6. Nuevas funciones
🔹 Flujo de trabajo completo de STO
La API V2 presenta compatibilidad total con las Ofertas de Tokens de Seguridad (STO).
Crear 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"
}
Invertir en STO:
{
"method": "newInvest",
"tokenSymbol": "EXMPL",
"investorEmail": "[email protected]",
"amount": "1000"
}
Tokens de reclamación:
{
"method": "claimTokens",
"tokenSymbol": "EXMPL",
"investorEmail": "[email protected]"
}
🔹 Puntos finales en nombre de (en desarrollo)
Estamos presentando operaciones en nombre de para permitirle actuar directamente para sus usuarios:
- POST /create-token-on-behalf
- POST /invest-on-behalf
- POST /sto-claim-on-behalf
Los casos de uso incluyen:
- Inversiones administradas por la plataforma
- Distribución automatizada de tokens
- Experiencia de usuario simplificada
⚠️ Estos puntos finales aún están en desarrollo; La disponibilidad y los parámetros pueden evolucionar.
🔹 Acceso mejorado a datos
Nuevos puntos finales GET para una mejor visibilidad:
Punto final
Propósito
Ejemplo de respuesta
/get-allowance
Comprobar las asignaciones de tokens
{ "allowance": "1000000" }
/get-balancewhitelist
Saldo + estado de la lista blanca
{ "balance": "500", "isWhitelisted": true }
/get-network-info
Red Información
{ "chainId": "0x89", "name": "Polygon" }
/get-token-info
Detalles del token
{ "name": "Token", "totalSupply": "1000000" }
/get-tokenizer-info
Datos del tokenizador
{ "email": "...", "tokens": [...] }
Pasos de migración: su plan de 5 pasos
- Actualizar URL (eliminar API)
// Anterior
const url = '';
// Nuevo
const url = '';
Renombrar símbolo → tokenSymbol en los cuerpos de preparación
- Conservar txId de las respuestas de preparación
- Usar cuerpo de envío unificado
await api.send({ signedTransactions: signed, txId });
Asegúrese de que los valores de chainId sean hexadecimales con el prefijo 0x
- Anterior: "aa36a7"
- Nuevo: "0xaa36a7"
✅ Siempre pruebe primero en Sandbox: https://dapp.sandbox.brickken.com/en/
Resumen de beneficios
- 90 % menos de parámetros en las solicitudes de envío
- Flujo unificado en todos los métodos
- Nombres de endpoints más limpios (tokenSymbol, URL más cortas)
- STO completo funcionalidad
- Operaciones en nombre de la administración de la plataforma
- Nuevos puntos finales GET enriquecidos para una mejor comprensión
- Arquitectura preparada para el futuro
Cronograma de migración
Recomendamos migrar dentro de las próximas 1 a 2 semanas.
V1 permanecerá disponible durante este período para respaldar una transición sin problemas, después de lo cual V2 se convertirá en el estándar.
Recursos y Soporte
Estamos aquí para ayudarte en cada paso del proceso, desde las pruebas en Sandbox hasta la migración a producción.
La API V2 de Brickken está diseñada para que las integraciones de tokenización sean más fáciles, rápidas y estén preparadas para el futuro. ¡Estamos deseando ver lo que creas con ella! 🚀