Arquitetura do Smart Contract

Documentation Index

Fetch the complete documentation index at: https://whitepaper.rwanftfi.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Diamond Pattern (EIP-2535)

​

Facets Principais

​

Contratos NFT e Espaços de Token ID

• NFT Regular — IDs de token ímpares (1, 3, 5, 7, …).
• Gift NFT — IDs de token pares (2, 4, 6, 8, …).

​

Matriz de Atualização

• Diamond Contract (EIP-2535): Atualizável via Facet cuts — permite adicionar, substituir ou remover módulos individuais sem reimplantar todo o sistema.
• TokenReserve (DA): Atualizável via Transparent Proxy — atualizações de lógica são possíveis sem alterar o endereço do contrato.
• NFTs (Regular, Gift, Ambassador), GovToken, AdminContract: Não atualizáveis — garantindo a imutabilidade dos ativos centrais e das regras de governança.

​

Gerenciamento de Papéis

• ADMIN_ROLE: Pode conceder/revogar outros papéis e alterar parâmetros críticos do sistema.
• SERVICE_ROLE: Executado por scripts de backend para tarefas automatizadas (ex.: resolver stacks expirados, processar depósitos cross-chain).
• SIGNER_ROLE: Usado para verificação criptográfica de assinaturas para autorizar ações específicas, como transferências de Voucher.
• MINTER_ROLE: Autorizado a cunhar tokens ou NFTs específicos.

​

Esquema de Saldos e Prioridade de Pagamento

1. Saldo Regular (balance): A carteira principal para USDT disponível. Os fundos aqui podem ser retirados a qualquer momento, usados para comprar NFTs ou para gerar Vouchers.
2. Saldo Acumulativo (accumulativeBalance): Uma conta de poupança obrigatória onde 20% de cada recompensa de marketing são creditados imediatamente após o acúmulo.
   • Uso: Só pode ser usado para comprar um NFT do mesmo nível ou um NFT de nível superior.
   • Taxas: O uso desse saldo para compras de NFT incorre em uma taxa de 20% roteada para o Pool de Liquidez do DA. Transferi-lo para outro usuário também incorre em uma taxa de 20% roteada para o Pool de Liquidez do DA. Cada movimentação do Saldo Acumulativo gera um aporte ao Pool e cria a base para novo DA.
   • Redistribuição em 120 dias: Se o usuário não utilizar seu Saldo Acumulativo dentro de 120 dias, o saldo não utilizado torna-se elegível para redistribuição. A divisão depende do tipo de NFT do usuário:
     • Detentores de NFT Regular: 70% são direcionados ao Pool de Liquidez do DA para a cunhagem de novos tokens DA; 30% são transferidos para o patrocinador upline direto do usuário.
     • Detentores de Gift NFT: 80% são direcionados ao Pool de Liquidez do DA; 20% são transferidos para o patrocinador upline direto (governado pelo parâmetro separado accumulativeClaimDistributeGift).
     • Regra de cascata (ambos os tipos): Se o Limite de Rendimento do patrocinador upline estiver esgotado (igual a zero), a parcela do patrocinador sobe para o próximo participante elegível na estrutura. Se nenhum participante na cadeia tiver um Limite de Rendimento ativo, o valor inteiro é roteado para o Pool de Liquidez do DA.
   120 Dias = Janela Mínima Garantida, Não Uma Expiração Automática: O parâmetro accumulativeDecayTime é verificado apenas dentro de withdrawAccumulative() — o caminho de redistribuição acionado por admin/serviço. Ele não é avaliado nos caminhos de gasto ou de transferência. Na prática, isso significa:

   • Pelos primeiros 120 dias após um crédito, o Saldo Acumulativo tem integridade garantida — não pode ser redistribuído por ninguém.
   • Após o dia 120, o saldo torna-se elegível para redistribuição, mas a redistribuição não dispara automaticamente quando o temporizador expira. Ela acontece apenas quando withdrawAccumulative() é invocado para aquele usuário específico pelo SERVICE_ROLE ou ADMIN_ROLE.
   • Até essa chamada ocorrer, um Saldo Acumulativo “expirado” permanece utilizável em compras e upgrades de NFT e transferível para outros usuários sob as regras e taxas padrão.

   A intenção declarada da equipe, registrada na resposta da auditoria: “Our goal is to guarantee the user’s funds’ integrity for a certain period of time, not to give them a lifecycle.” Trate os 120 dias como a janela mínima garantida antes de uma possível redistribuição, não como um carimbo de hora rígido de expiração on-chain.
3. Limite (limit): Representa a renda restante máxima que um NFT pode gerar.

​

Saldos do Sistema

• Dev Balance (devBalance): Acumula taxas e comissões da plataforma para o financiamento operacional.
• Token Reserve Balance (tokenReserveBalance): O pool de liquidez em USDT que lastreia 100% o token DA. Cada fonte de renda no ecossistema flui para esse pool.
• Price Impact Balance (priceImpactBalance): Uma reserva especial usada para gerenciar a estabilidade do preço do token DA durante eventos específicos do ecossistema.

​

Prioridade de Pagamento