API de Brickken v1.0.1: Desglose de la actualización principal

En Brickken, nos comprometemos a ayudar a las empresas a tokenizar activos del mundo real (RWA) a través de una infraestructura fluida y fácil de usar para los desarrolladores. Con el lanzamiento de la versión 1.0.1 de la API, presentamos nuevas funciones que permiten gestionar mejor los ciclos de vida de la tokenización, incluyendo la creación de STO, la incorporación de inversores y la gestión de documentos, a la vez que reforzamos la coherencia y la claridad en toda la API.

‍

Analicemos las novedades, las mejoras y cómo estos cambios pueden potenciar su experiencia de tokenización.

‍

🚀 Nuevos puntos finales

‍

✅ PATCH /patch-api-token-docs

Este punto final proporciona una solución muy necesaria para que los administradores de tokens puedan actualizar los documentos clave relacionados con los tokens mediante programación. Es perfecto para proyectos que buscan cargar o actualizar:

• Logotipo del token: Archivo JPEG o PNG cargado a S3.
• Acuerdo de suscripción: PDF legal cargado a IPFS.
• Documentación legal: Materiales PDF complementarios (términos, descargos de responsabilidad, etc.), también cargados a IPFS.

‍

Al gestionar tanto los materiales de marca como los de cumplimiento, este punto final cierra el círculo en las necesidades de documentación posteriores a la tokenización.

🔐 Requiere una clave x-api válida.

📝 Tipo de formulario: multipart/form-data.

‍

📊 GET /get-api-stos

Recupera todas las ofertas de tokens de seguridad (STO) asociadas con un token determinado a través de su tokenSymbol. Este punto final permite paneles de STO, análisis de inversiones y resúmenes de cartera.

Retornos:

• Límites de tokens
• Límites de inversión
• Estado de STO (PRÓXIMAMENTE, ACTIVO, COMPLETADO)
• Moneda de pago aceptada (p. ej., USDC)
• Fechas de inicio y finalización

Ideal para seguimiento de proyectos en tiempo real o paneles de relaciones con inversores.

‍

🔍 GET /get-api-sto-by-id/{id}

¿Necesita detalles sobre una oferta específica? Este punto final le permite consultar cualquier STO por UUID y devolver información completa, que incluye:

• Nombre de la oferta
• Precio del token
• Capitalización máxima/máxima
• Límites mínimos/máximos por inversor
• Fechas y métodos de pago

Perfecto para flujos de incorporación, comprobaciones de cumplimiento o informes de progreso.

‍

🔄 Mejoras en los puntos finales existentes

‍

🔧 POST /prepare-api-transactions

Este punto final genera transacciones sin firmar para acciones relacionadas con la tokenización. En la v1.0.1, ampliamos sus capacidades con:

‍

🆕 Nuevo método compatible: newSto

Una importante incorporación de funciones, este método permite a los desarrolladores preparar transacciones para lanzar Ofertas de Tokens de Seguridad directamente desde el backend.

‍

Parámetros ahora aceptados para newSto:

• tokenizerEmail: Quién creó el token
• tokenAmount: Cuántos tokens se ofrecen
• offeringName: Nombre interno o de cara al inversor
• startDate / endDate: Ventana de inversión con límite de tiempo
• acceptedCoin: Moneda aceptada para la inversión (USDT, USDC, etc.)
• minRaiseUSD / maxRaiseUSD: Límite suave y límite duro
• minInvestment / maxInvestment: Límites por inversor
• signerAddress: Monedero del propietario del token

Estos campos permiten construir una STO totalmente personalizable e independiente de la cadena fuera de la cadena y firmarla de forma segura antes del envío.

‍

📤 POST /send-api-transactions

Este punto final se utiliza para enviar transacciones firmadas a la cadena de bloques y al backend de Brickken. En la v1.0.1, la hicimos más inteligente y robusta:

• ✅ Soporte completo para el método newSto
• ✅ Validación mejorada al trabajar con tokens como BKN, USDT, USDC — ahora requiere una tokenizerAddress válida para aprobaciones
• ✅ Envío sensible al orden para flujos compuestos (p. ej., lista blanca antes de acuñar)

💡 Consejo: Si estás enviando un lote como [whitelistUser1, mintUser1], [whitelistUser2, mintUser2]... asegúrate de que tu matriz de transacciones esté ordenada como corresponde.

‍

🧼 Otras mejoras y Refinamientos

También hemos revisado a fondo para que la API sea más fácil de usar:

✍️ Documentación y claridad

• Introdujimos secciones plegables específicas del método en la interfaz de usuario de Swagger
• Ampliamos toda la documentación del método para aclarar la intención, el contexto y las condiciones previas
• Ejemplos mejorados en los cuerpos de las solicitudes y las respuestas

🔐 Seguridad y Coherencia

• Estructuras de esquema estandarizadas en todos los cuerpos de solicitud
• Se agregó la validación faltante y verificaciones más estrictas en los flujos de trabajo de aprobación

🧪 Mejor experiencia para desarrolladores

• Todos los valores de ejemplo ahora coinciden con escenarios de uso realistas
• Descripciones más precisas para casos extremos y campos opcionales

‍

🔗 Dónde acceder

La API de Brickken está disponible en dos entornos:

• 🧪 Sandbox:
  https://api.sandbox.brickken.com
  Ideal para pruebas y simulación.
  
  
• 🚀 Producción:
  https://api.brickken.com
  Implementación en vivo para tokenizaciones en producción.

‍

📨 Notas finales

Esta versión es un paso adelante hacia funciones aún más avanzadas en torno a la automatización del ciclo de vida de los tokens, los flujos de inversores y la emisión de STO conforme a las normas. Estamos increíblemente agradecidos con la comunidad de desarrolladores por los comentarios que dieron lugar a este lanzamiento, y ya estamos trabajando en lo que viene después.
‍

¿Tienes preguntas o necesitas ayuda para integrar las nuevas funciones?

📩 Contáctanos en [email protected]
‍

Mantente tokenizado, El equipo técnico de Brickken

‍