​
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

Propósito: Implanta novos tokens de bond de forma eficienteFunções Principais:
  • deployBondkitToken() - Cria novo clone de token
  • getImplementationAddress() - Retorna endereço do modelo
  • setAllowedQuoteAsset() - Função de admin para listar ativos
Otimização de Gas:
  • Usa o padrão de proxy mínimo EIP-1167
  • Compartilha lógica entre todos os tokens
  • ~90% de economia de gas vs implantações individuais
Propósito: Modelo para todos os tokens de bondCaracterísticas Principais:
  • Conformidade com o padrão ERC20
  • Matemática da curva de bonding
  • Lógica de migração para Uniswap v4
  • Sistema de distribuição de taxas
Transições de Estado:
  1. Não inicializado → Fase de Bonding
  2. Fase de Bonding → Pronto para Migração
  3. Pronto para Migração → Fase DEX
Propósito: Instâncias individuais de tokenCiclo de Vida:
  • Criado via factory
  • Inicializado com parâmetros únicos
  • Gerencia sua própria curva de bonding
  • Auto-migra para Uniswap v4
Armazenamento:
  • Metadados do token (nome, símbolo)
  • Suprimento e distribuição
  • Estado da curva de bonding
  • Parâmetros de migração

​
Serviços Backend

Propósito: Captura toda atividade on-chainMonitora:
  • Criações de token
  • Transações de compra/venda
  • Eventos de migração
  • Atividades de transferência
Tecnologia:
  • Varredura blockchain em tempo real
  • Processamento de logs de eventos
  • Sincronização com banco de dados
Propósito: Processa dados brutos em insightsGera:
  • Dados de candlestick OHLCV
  • Métricas de volume
  • Rastreamento de liquidez
  • Histórico de preços
  • Estatísticas de usuários
Atualizações: A cada bloco (~2 segundos)
Propósito: Fornece dados para frontendsEndpoints:
  • /tokens - Lista todos os tokens
  • /tokens/{address} - Detalhes do token
  • /tokens/{address}/transactions - Histórico de transações
  • /tokens/{address}/ohlcv - Dados para gráfico
  • /users/{address}/portfolio - Posse do usuário
Formato: JSON com paginação

​
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

Mecânica de Preços

Entenda a matemática da curva de bonding

Guia de Migração

Aprenda o processo de migração