Visão Geral da Arquitetura

Fluxo do Produto em Detalhes

1

Fase 1: Criação de Token

O que acontece:
  • Usuário chama deployBondkitToken() no contrato Factory
  • Factory clona o contrato de Implementação usando o padrão de proxy mínimo
  • Novo token é inicializado com parâmetros personalizados
  • Token entra automaticamente na fase de bonding
Custo de Gas: ~200.000 gas (90% mais barato que uma implantação completa) Tempo: ~15 segundos
2

Fase 2: Trading na Curva de Bonding

O que acontece:
  • Usuários compram/vendem tokens diretamente do contrato
  • Preço segue a curva de bonding algorítmica: S = S_final × (R/R_target)^exponente
  • Taxa de 5% em todas as transações vai para o destinatário da taxa
  • Contrato acumula ativos de cotação (ETH/B3) em direção ao alvo
  • Backend indexa todas as transações para análise
Mecânica de Trading:
  • Compra: Envie ETH/B3, receba tokens pelo preço atual da curva
  • Venda: Envie tokens, receba ETH/B3 menos taxas
  • Reembolsos automáticos se a compra exceder o alvo
Duração: Até o alvo ser alcançado (horas a semanas)
3

Fase 3: Migração para DEX

O que acontece:
  • Admin chama migrateToDex() quando o alvo é alcançado
  • Contrato calcula o preço justo de mercado como sqrtPriceX96
  • Cria e inicializa o pool Uniswap v4
  • Transfere a liquidez acumulada para o pool
  • Renuncia à propriedade para o endereço zero
  • Token se torna um ERC20 padrão com trading na DEX
Pós-migração:
  • Curva de bonding permanentemente desabilitada
  • Todo trading via Uniswap v4
  • Sem controles de administração restantes
  • Descentralização completa alcançada
Custo de Gas: ~500.000 gas Tempo: ~30 segundos

Componentes do Sistema

Smart Contracts

Serviços Backend

Papéis dos Usuários

PapelResponsabilidadesPermissões
CriadorImplanta token, define parâmetros, inicia migraçãoControle total até a migração
TradersCompra/venda durante o bonding, trade na DEXDireitos padrão de trading
Destinatário da TaxaRecebe taxas de tradingRenda passiva apenas
Admin de MigraçãoExecuta migração quando prontoDireito de migração único
Provedores de LP(Pós-migração) Adiciona liquidez ao UniswapDireitos padrão de LP

Mergulho Técnico

Matemática da Curva de Bonding

A curva de bonding determina o preço do token baseado no suprimento:
Fórmula de Preço:
S = S_final × (R / R_target)^exponente

Onde:
- S = Suprimento atual do token
- S_final = Suprimento final do token
- R = Quantia arrecadada (ETH/B3)
- R_target = Quantia alvo
- exponente = 1 / (1 + fatorDeAgressividade/100)
Exemplos de Cálculos:
AgressividadeExponenteComportamento do Preço
01.00Linear (preço constante)
250.80Curva suave
500.67Curva moderada
750.57Curva acentuada
1000.50Muito acentuada (raiz quadrada)

Cálculo do Preço de Migração

Ao migrar para Uniswap v4, o contrato:
  1. Calcula o preço de saída da curva de bonding
  2. Converte para o formato sqrtPriceX96:
    sqrtPriceX96 = sqrt(preço) × 2^96
    
  3. Inicializa o pool com esse preço
  4. Adiciona liquidez usando os fundos acumulados

Técnicas de Otimização de Gas

Padrão de Proxy Mínimo (EIP-1167)Em vez de implantar o código completo do contrato para cada token:
  • Implanta um contrato de implementação (600KB)
  • Implanta contratos proxy minúsculos (45 bytes cada)
  • Proxies delegam todas as chamadas para a implementação
  • Resultado: 90% de economia de gas por implantação

Parâmetros de Configuração

Parâmetros de Criação de Token

ParâmetroTipoFaixa/FormatoImpacto
namestring1-50 charsNome de exibição do token
symbolstring2-10 charsSímbolo de trading
finalTokenSupplyuint256> 0Total de tokens que podem ser cunhados
aggressivenessFactoruint80-100Inclinação da curva
targetEthuint256> 0Limiar para migração
feeRecipientaddressEndereço válidoRecebe taxas
lpSplitRatioFeeRecipientBpsuint2560-10000Participação da taxa de LP (pontos base)
migrationAdminAddressaddressEndereço válidoPode acionar migração

Parâmetros de Execução

AçãoParâmetrosValidação
CompraminTokensOut, ethAmountProteção contra slippage
VendatokenAmount, minEthOutVerificação de saldo, slippage
MigraçãoNenhumAlvo alcançado, apenas admin

Constantes do Sistema

ConstanteValorDescrição
Taxa de Trading5%Aplicada a todas as transações
Decimais18Decimais padrão ERC20
Min Alvo0.1 ETHAlvo mínimo viável
Máx Agressividade100Fator máximo da curva

Considerações de Segurança

Características de Segurança Importantes:
  1. Renúncia de Propriedade: Automática após migração
  2. Sem Função de Cunhagem: Suprimento fixo na criação
  3. Parâmetros Imutáveis: Não podem ser alterados após implantação
  4. Contratos Auditados: Código revisado profissionalmente
  5. Sem Backdoors de Admin: Verdadeira descentralização
  6. Proteção contra Slippage: Incorporada nas funções de compra/venda
  7. Proteção contra Overflow: Matemática segura em todo o lugar

Cenários de Falha e Tratamento

CenárioResposta do Sistema
Compra excede o alvoPreenchimento parcial, reembolso do excesso
Liquidez insuficiente para vendaTransação reverte
Migração antes do alvoTransação reverte
Tentativa de migração por não-adminTransação reverte
Tentativa de dupla migraçãoTransação reverte
Operações com endereço zeroTransação reverte

Próximos Passos