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

Servicios Backend

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