Fase de Vinculación

Cómo funciona la compra y venta durante la fase de vinculación, tarifas y umbrales.

​

¿Qué es la Fase de Vinculación?

La fase de vinculación es el período inicial de comercio donde los tokens se compran y venden directamente de un contrato inteligente usando una curva de precios algorítmica. Piénsalo como una preventa descentralizada con creación de mercado automática.

​

Cómo Funciona la Vinculación

​

El Mecanismo de la Curva de Vinculación

Durante la vinculación, el contrato actúa como el único creador de mercado:

1. Sin Libro de Órdenes: Precios determinados algorítmicamente
2. Liquidez Instantánea: Siempre se puede comprar o vender
3. Independencia de Trayectoria: El precio depende solo de la oferta, no de la historia
4. Precios Automáticos: No se necesita configuración manual de precios

​

Operaciones de Comercio

​

Comprar Tokens

Cómo Funciona

Flujo de Proceso:

1. El usuario envía token de comercio (B3/ETH) al contrato
2. El contrato calcula los tokens basados en la curva
3. Se deduce una comisión del 5% y se envía al destinatario
4. Se acuñan tokens y se envían al comprador
5. Se actualiza el estado de la curva

Ejemplo de Código:

// Obtener una cotización primero
const quote = await token.getAmountOfTokensToBuy(
  parseEther("100") // 100 tokens de comercio
);
console.log(`Recibirá: ${formatEther(quote)} tokens`);

// Ejecutar compra con protección de deslizamiento  
const minTokens = quote * 0.95n; // 5% de deslizamiento
await token.buy(parseEther("100"), minTokens);

Parámetros

Parámetro	Tipo	Descripción
minTokensOut	uint256	Tokens mínimos a recibir (protección contra deslizamiento)
tradingTokenAmount	string/uint256	Cantidad de token de comercio a gastar

Notas Importantes:

• Establecer minTokensOut para protegerse contra el front-running
• Usar 0 para minTokensOut solo en períodos de baja actividad
• La transacción se revierte si el deslizamiento supera la tolerancia

Casos Límite

Desbordamiento del Objetivo:

• Si la compra excediera el objetivo, el exceso se reembolsa
• Ejemplo: El objetivo es 10 tokens de comercio, se han recaudado 9.5 tokens
• El usuario envía 1 token → se usan 0.5 tokens, se reembolsan 0.5 tokens

Gas Insuficiente:

• Límite de gas recomendado: 200,000
• Cálculos complejos pueden requerir más

Cantidad Cero:

• Las transacciones con 0 tokens de comercio se revertirán

​

Vender Tokens

Cómo Funciona

Flujo de Proceso:

1. El usuario aprueba el gasto de tokens
2. El usuario llama a vender con la cantidad de tokens
3. El contrato calcula la cantidad de token de comercio basado en la curva
4. Se deduce una comisión del 5% de los ingresos
5. El token de comercio se envía al vendedor, los tokens se queman
6. Se actualiza el estado de la curva (el precio disminuye)

Ejemplo de Código:

// Verificar saldo y obtener cotización
const balance = await token.balanceOf(userAddress);
const sellAmount = balance / 2n; // Vender la mitad

const quote = await token.getAmountOfTradingTokensToSell(
  sellAmount
);
console.log(`Recibirá: ${formatEther(quote)} tokens de comercio`);

// Ejecutar venta con protección de deslizamiento
const minTradingTokenOut = quote * 0.95n; // 5% de deslizamiento
await token.sell(sellAmount, minTradingTokenOut);

Parámetros

Parámetro	Tipo	Descripción
tokenAmount	uint256	Cantidad de tokens a vender
minTradingTokenOut	uint256	Token de comercio mínimo a recibir (protección contra deslizamiento)

Notas Importantes:

• Requiere aprobación de tokens antes de vender
• El impacto en el precio puede ser significativo para ventas grandes
• No se pueden vender más de la oferta circulante

Impacto del Precio

Entendiendo el Impacto de la Venta:

Vender reduce la cantidad recaudada de la curva, causando que el precio baje:

Tamaño de Venta	Impacto en el Precio	Recuperación Necesaria
1% de la oferta	~1-2%	Pequeña
5% de la oferta	~5-10%	Moderada
10% de la oferta	~15-25%	Significativa
20% de la oferta	~30-50%	Mayor

El impacto real depende del factor de agresividad

​

Estructura de Comisiones

​

Cómo Funcionan las Comisiones

Comisiones de Compra

En una compra de 1 token de comercio:

• 0.95 tokens de comercio van a la curva de vinculación
• 0.05 tokens de comercio van al destinatario de la comisión
• Tokens calculados sobre el valor de 0.95 token de comercio

Ejemplo:

// El usuario envía 1 token de comercio
// Comisión: 0.05 token de comercio
// La curva recibe: 0.95 token de comercio
// Tokens acuñados basados en 0.95 token de comercio

Comisiones de Venta

Al vender por valor de 1 token de comercio:

• El usuario recibe 0.95 tokens de comercio
• 0.05 tokens de comercio van al destinatario de la comisión
• La curva se reduce por el total de 1 token de comercio

Ejemplo:

// Tokens valorados en 1 token de comercio en la curva
// Comisión: 0.05 token de comercio
// El usuario recibe: 0.95 tokens de comercio
// La curva baja por 1 token de comercio

Distribución de Comisiones

A dónde van las comisiones:

• 100% a la dirección de feeRecipient designada
• Puede ser tesorería del proyecto, desarrollador, o DAO
• Establecido en la creación del token, no se puede cambiar

Reclamando comisiones:

• Automático - no se necesita reclamar
• Enviado directamente en cada comercio
• Sin acumulación en el contrato

​

Economía de Comisiones

Volumen Diario	Ingresos por Comisiones	Ingresos Mensuales
10 tokens de comercio	0.5 tokens de comercio	~15 tokens de comercio
50 tokens de comercio	2.5 tokens de comercio	~75 tokens de comercio
100 tokens de comercio	5 tokens de comercio	~150 tokens de comercio
500 tokens de comercio	25 tokens de comercio	~750 tokens de comercio

​

Mecánica del Objetivo

​

Entendiendo el Objetivo

El objetivo es la cantidad de token de comercio que debe acumularse antes de la migración:

Propósito del Objetivo:

• Asegura suficiente liquidez para Uniswap v4
• Crea un objetivo claro para la comunidad
• Previene la migración prematura
• Construye momento durante la vinculación

​

Acercándose al Objetivo

// Monitorear el progreso hacia el objetivo
async function trackProgress(token: BondkitToken) {
  const progress = await token.getBondingProgress();
  
  if (progress.progress < 0.5) {
    console.log("🌱 Etapa inicial - mejores precios disponibles");
  } else if (progress.progress < 0.8) {
    console.log("🚀 Construyendo momento - considera comprar");
  } else if (progress.progress < 1.0) {
    console.log("🔥 Casi allí - migración inminente");
  } else {
    console.log("✅ Objetivo alcanzado - listo para migrar!");
  }
  
  const remaining = progress.threshold - progress.raised;
  console.log(`Necesita ${formatEther(remaining)} más token de comercio`);
}

​

Manejo de Desbordamiento

Cuando una compra excedería el objetivo:

1. Relleno Parcial: Solo se acepta la cantidad necesaria
2. Reembolso Automático: El exceso se devuelve en la misma transacción
3. Finalización Justa: Nadie puede pagar de más al final

Escenario de Ejemplo:

Objetivo: 100 tokens de comercio
Actual: 99.5 tokens de comercio
Usuario envía: 2 tokens de comercio

Resultado:
- 0.5 tokens de comercio aceptados (alcanza exactamente 100)
- 1.5 tokens de comercio reembolsados
- El usuario obtiene tokens por 0.5 tokens de comercio
- Migración ahora disponible

​

Eventos y Monitoreo

​

Eventos del Contrato

Evento de Compra

event BondingCurveBuy(
    address indexed payer,
    address indexed recipient,
    uint256 tradingTokenIn,
    uint256 tokensOut,
    uint256 fee,
    uint256 totalRaisedBonding
);

Escuchando en SDK:

token.onBuy((event) => {
  console.log({
    comprador: event.payer,
    ethGastado: formatEther(event.tradingTokenIn),
    tokensRecibidos: formatEther(event.tokensOut),
    comisiónPagada: formatEther(event.fee),
    totalRecaudado: formatEther(event.totalRaisedBonding)
  });
});

Evento de Venta

event BondingCurveSell(
    address indexed seller,
    uint256 tokensIn,
    uint256 tradingTokenOut,
    uint256 fee,
    uint256 totalRaisedBonding
);

Escuchando en SDK:

token.onSell((event) => {
  console.log({
    vendedor: event.seller,
    tokensVendidos: formatEther(event.tokensIn),
    ethRecibido: formatEther(event.tradingTokenOut),
    comisiónPagada: formatEther(event.fee),
    totalRecaudado: formatEther(event.totalRaisedBonding)
  });
});

​

Monitoreo en Tiempo Real

// Configuración completa de monitoreo
class BondingMonitor {
  constructor(private token: BondkitToken) {}
  
  async start() {
    // Estado inicial
    const progress = await this.token.getBondingProgress();
    console.log(`Comenzando en ${(progress.progress * 100).toFixed(2)}%`);
    
    // Monitorear compras
    this.token.onBuy(async (event) => {
      const newProgress = await this.token.getBondingProgress();
      console.log(`COMPRA: ${formatEther(event.tokensOut)} tokens`);
      console.log(`Progreso: ${(newProgress.progress * 100).toFixed(2)}%`);
      
      if (newProgress.progress >= 1.0) {
        console.log("🎆 ¡OBJETIVO ALCANZADO! Migración disponible.");
      }
    });
    
    // Monitorear ventas
    this.token.onSell(async (event) => {
      const newProgress = await this.token.getBondingProgress();
      console.log(`VENTA: ${formatEther(event.tokensIn)} tokens`);
      console.log(`Progreso: ${(newProgress.progress * 100).toFixed(2)}%`);
    });
  }
}

// Uso
const monitor = new BondingMonitor(token);
await monitor.start();

​

Estrategias de la Fase de Vinculación

​

Para Creadores de Tokens

Construir Momento

• Comenzar con menor agresividad (30-50)
• Establecer objetivos alcanzables
• Involucrar a la comunidad temprano
• Proporcionar una hoja de ruta clara

Maximizar el Éxito

• Sembrar liquidez inicial tú mismo
• Crear incentivos de compra
• Temporizar anuncios adecuadamente
• Planificar para después de la migración

​

Para Comerciantes

Estrategia de Entrada

• Comprar temprano para los mejores precios
• Usar DCA para grandes cantidades
• Monitorear el factor de agresividad
• Verificar el progreso del objetivo

Gestión de Riesgos

• Siempre usar protección contra deslizamiento
• Entender el impacto en el precio
• No entrar en pánico cerca del objetivo
• Planificar estrategia de salida

​

Transición Post-Vinculación

Crítico: Después de la Migración

Una vez se llama a migrateToDex():

• ❌ Comercio de curva de vinculación permanentemente deshabilitado
• ❌ No más funciones de buy() o sell()
• ✅ Todo el comercio se traslada a Uniswap v4
• ✅ Se aplican mecánicas AMM estándar
• ✅ Cualquiera puede proporcionar liquidez
• ✅ Comercio completamente descentralizado

​

Próximos Pasos

Guía de Precios

Entender la mecánica de precios

Establecimiento de Objetivos

Elegir el objetivo correcto

Ciclo de Vida del Token

Aprender sobre la transición a DEX