Visión General de la Arquitectura

Flujo del Producto en Detalle

1

Fase 1: Creación de Token

Qué sucede:
  • El usuario llama a deployBondkitToken() en el contrato de Fábrica
  • La Fábrica clona el contrato de Implementación usando el patrón de proxy mínimo
  • El nuevo token se inicializa con parámetros personalizados
  • El token entra automáticamente en la fase de bonding
Costo de Gas: ~200,000 gas (90% más barato que el despliegue completo) Tiempo: ~15 segundos
2

Fase 2: Trading en la Curva de Bonding

Qué sucede:
  • Los usuarios compran/venden tokens directamente del contrato
  • El precio sigue una curva de bonding algorítmica: S = S_final × (R/R_objetivo)^exponente
  • Comisión del 5% en todos los trades va al destinatario de la comisión
  • El contrato acumula activos de cotización (ETH/B3) hacia el objetivo
  • El backend indexa todas las transacciones para análisis
Mecánica de Trading:
  • Comprar: Enviar ETH/B3, recibir tokens al precio actual de la curva
  • Vender: Enviar tokens, recibir ETH/B3 menos comisiones
  • Reembolsos automáticos si la compra excediera el objetivo
Duración: Hasta que se alcance el objetivo (horas a semanas)
3

Fase 3: Migración a DEX

Qué sucede:
  • El administrador llama a migrateToDex() cuando se alcanza el objetivo
  • El contrato calcula el precio justo de mercado como sqrtPriceX96
  • Crea e inicializa el pool de Uniswap v4
  • Transfiere la liquidez acumulada al pool
  • Renuncia a la propiedad a la dirección cero
  • El token se convierte en un ERC20 estándar con trading en DEX
Post-migración:
  • Curva de bonding permanentemente deshabilitada
  • Todo el trading a través de Uniswap v4
  • No quedan controles de administrador
  • Se logra la descentralización completa
Costo de Gas: ~500,000 gas Tiempo: ~30 segundos

Componentes del Sistema

Contratos Inteligentes

Propósito: Despliega nuevos tokens de bono de manera eficienteFunciones Clave:
  • deployBondkitToken() - Crea un nuevo clon de token
  • getImplementationAddress() - Devuelve la dirección de la plantilla
  • setAllowedQuoteAsset() - Función de administrador para listar activos
Optimización de Gas:
  • Utiliza el patrón de proxy mínimo EIP-1167
  • Comparte lógica a través de todos los tokens
  • ~90% de ahorro de gas vs despliegues individuales
Propósito: Plantilla para todos los tokens de bonoCaracterísticas Principales:
  • Cumplimiento del estándar ERC20
  • Matemáticas de la curva de bonding
  • Lógica de migración a Uniswap v4
  • Sistema de distribución de comisiones
Transiciones de Estado:
  1. No inicializado → Fase de Bonding
  2. Fase de Bonding → Listo para Migración
  3. Listo para Migración → Fase DEX
Propósito: Instancias individuales de tokenCiclo de Vida:
  • Creado vía fábrica
  • Inicializado con parámetros únicos
  • Gestiona su propia curva de bonding
  • Se auto-migra a Uniswap v4
Almacenamiento:
  • Metadatos del token (nombre, símbolo)
  • Suministro y distribución
  • Estado de la curva de bonding
  • Parámetros de migración

Servicios Backend

Propósito: Captura toda la actividad en cadenaMonitorea:
  • Creaciones de token
  • Transacciones de compra/venta
  • Eventos de migración
  • Actividades de transferencia
Tecnología:
  • Escaneo de blockchain en tiempo real
  • Procesamiento de logs de eventos
  • Sincronización con la base de datos
Propósito: Procesa datos crudos en insightsGenera:
  • Datos de velas OHLCV
  • Métricas de volumen
  • Seguimiento de liquidez
  • Historial de precios
  • Estadísticas de usuarios
Actualizaciones: Cada bloque (~2 segundos)
Propósito: Sirve datos a los frontendsEndpoints:
  • /tokens - Lista todos los tokens
  • /tokens/{address} - Detalles del token
  • /tokens/{address}/transactions - Historial de trades
  • /tokens/{address}/ohlcv - Datos para gráficos
  • /users/{address}/portfolio - Tenencias del usuario
Formato: JSON con paginación

Roles de Usuario

RolResponsabilidadesPermisos
CreadorDesplegar token, establecer parámetros, iniciar migraciónControl total hasta la migración
TradersComprar/vender durante el bonding, comerciar en DEXDerechos de trading estándar
Destinatario de ComisionesRecibir comisiones de tradingSolo ingresos pasivos
Admin de MigraciónEjecutar migración cuando esté listoDerecho de migración única
Proveedores de LP(Post-migración) Agregar liquidez a UniswapDerechos estándar de LP

Inmersión Técnica

Matemáticas de la Curva de Bonding

La curva de bonding determina el precio del token basado en la oferta:
Fórmula de Precio:
S = S_final × (R / R_objetivo)^exponente

Donde:
- S = Oferta actual de token
- S_final = Oferta final de token
- R = Monto recaudado (ETH/B3)
- R_objetivo = Monto objetivo
- exponente = 1 / (1 + factorDeAgresividad/100)
Cálculos de Ejemplo:
AgresividadExponenteComportamiento del Precio
01.00Lineal (precio constante)
250.80Curva suave
500.67Curva moderada
750.57Curva pronunciada
1000.50Muy pronunciada (raíz cuadrada)

Cálculo del Precio de Migración

Al migrar a Uniswap v4, el contrato:
  1. Calcula el precio de salida de la curva de bonding
  2. Convierte a formato sqrtPriceX96:
    sqrtPriceX96 = sqrt(precio) × 2^96
    
  3. Inicializa el pool con este precio
  4. Agrega liquidez usando los fondos acumulados

Técnicas de Optimización de Gas

Patrón de Proxy Mínimo (EIP-1167)En lugar de desplegar el código completo del contrato para cada token:
  • Desplegar un contrato de implementación (600KB)
  • Desplegar contratos proxy diminutos (45 bytes cada uno)
  • Los proxies delegan todas las llamadas a la implementación
  • Resultado: 90% de ahorro de gas por despliegue

Parámetros de Configuración

Parámetros de Creación de Token

ParámetroTipoRango/FormatoImpacto
namestring1-50 caracteresNombre de visualización del token
symbolstring2-10 caracteresSímbolo de trading
finalTokenSupplyuint256> 0Total de tokens acuñables
aggressivenessFactoruint80-100Inclinación de la curva
targetEthuint256> 0Umbral de migración
feeRecipientaddressDirección válidaRecibe comisiones
lpSplitRatioFeeRecipientBpsuint2560-10000Participación de comisión de LP (puntos básicos)
migrationAdminAddressaddressDirección válidaPuede activar la migración

Parámetros de Ejecución

AcciónParámetrosValidación
ComprarminTokensOut, ethAmountProtección contra deslizamiento
VendertokenAmount, minEthOutVerificación de saldo, deslizamiento
MigrarNingunoObjetivo alcanzado, solo admin

Constantes del Sistema

ConstanteValorDescripción
Comisión de Trading5%Aplicada a todos los trades
Decimales18Decimales estándar ERC20
Mínimo Objetivo0.1 ETHObjetivo viable mínimo
Máxima Agresividad100Factor máximo de la curva

Consideraciones de Seguridad

Características de Seguridad Importantes:
  1. Renuncia de Propiedad: Automática después de la migración
  2. Sin Función de Acuñación: Suministro fijo en la creación
  3. Parámetros Inmutables: No se pueden cambiar después del despliegue
  4. Contratos Auditados: Código revisado profesionalmente
  5. Sin Puertas Traseras de Admin: Verdadera descentralización
  6. Protección contra Deslizamiento: Incorporada en funciones de compra/venta
  7. Protección contra Desbordamiento: Matemáticas seguras en todo

Escenarios de Fallo y Manejo

EscenarioRespuesta del Sistema
Compra excede el objetivoRelleno parcial, reembolso del exceso
Liquidez insuficiente para venderTransacción revertida
Migración antes del objetivoTransacción revertida
Intento de migración por no-adminTransacción revertida
Intento de doble migraciónTransacción revertida
Operaciones con dirección ceroTransacción revertida

Próximos Pasos