Arquitectura de Smart Contracts

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 Principales

​

Contratos NFT y Espacios de Token ID

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

​

Matriz de Actualizabilidad

• Diamond Contract (EIP-2535): Actualizable mediante Facet cuts — permite añadir, reemplazar o eliminar módulos individuales sin redeployar todo el sistema.
• TokenReserve (DA): Actualizable mediante Transparent Proxy — las actualizaciones de lógica son posibles sin cambiar la dirección del contrato.
• NFTs (Regular, Gift, Ambassador), GovToken, AdminContract: No actualizables — asegurando la inmutabilidad de los activos centrales y las reglas de gobernanza.

​

Gestión de Roles

• ADMIN_ROLE: Puede otorgar/revocar otros roles y cambiar parámetros críticos del sistema.
• SERVICE_ROLE: Ejecutado por scripts de backend para tareas automatizadas (por ejemplo, resolver stacks expirados, procesar depósitos cross-chain).
• SIGNER_ROLE: Utilizado para la verificación de firmas criptográficas para autorizar acciones específicas como las transferencias de Vouchers.
• MINTER_ROLE: Autorizado para mintear tokens o NFT específicos.

​

Esquema de Saldos y Prioridad de Pagos

1. Saldo Regular (balance): La wallet principal para USDT disponible. Los fondos aquí pueden retirarse en cualquier momento, usarse para comprar NFTs o usarse para generar Vouchers.
2. Saldo Acumulativo (accumulativeBalance): Una cuenta de ahorro obligatoria donde el 20% de cada recompensa de marketing se acredita inmediatamente al producirse el devengo.
   • Uso: Solo puede usarse para comprar el NFT del mismo nivel o un NFT de nivel superior.
   • Tarifas: Usar este saldo para comprar NFTs incurre en una comisión del 20% enrutada al Pool de Liquidez del DA. Transferirlo a otro usuario también incurre en una comisión del 20% enrutada al Pool de Liquidez del DA. Cada movimiento del Saldo Acumulativo genera una entrada al Pool y crea la base para nuevo DA.
   • Redistribución a 120 Días: Si el usuario no usa su Saldo Acumulativo en 120 días, el saldo no utilizado se vuelve elegible para la redistribución. La división depende del tipo de NFT del usuario:
     • Poseedores de NFT Regular: El 70% se dirige al Pool de Liquidez del DA para acuñar nuevos tokens DA; el 30% se transfiere al patrocinador upline directo del usuario.
     • Poseedores de NFT de Regalo: El 80% se dirige al Pool de Liquidez del DA; el 20% se transfiere al patrocinador upline directo (regulado por el parámetro independiente accumulativeClaimDistributeGift).
     • Regla de cascada (ambos tipos): Si el Límite de Ingresos del patrocinador upline está agotado (igual a cero), la cuota del patrocinador pasa más arriba al siguiente participante elegible en la estructura. Si ningún participante en la cadena tiene un Límite de Ingresos activo, todo el monto se enruta al Pool de Liquidez del DA.
   120 Días = Ventana Mínima Garantizada, No una Expiración Automática: El parámetro accumulativeDecayTime se comprueba únicamente dentro de withdrawAccumulative() — la vía de redistribución activada por admin/service. No se evalúa en las vías de gasto o transferencia. En la práctica, esto significa:

   • Durante los primeros 120 días tras un crédito, el Saldo Acumulativo tiene integridad garantizada — no puede ser redistribuido por nadie.
   • Tras el día 120, el saldo se vuelve elegible para redistribución, pero la redistribución no se dispara automáticamente cuando expira el temporizador. Solo ocurre cuando se invoca withdrawAccumulative() para ese usuario específico por el SERVICE_ROLE o ADMIN_ROLE.
   • Hasta que esa llamada se ejecute, un Saldo Acumulativo “expirado” sigue siendo gastable en compras y actualizaciones de NFT y transferible a otros usuarios bajo las reglas y comisiones estándar.

   La intención declarada del equipo, registrada en la respuesta a la auditoría: “Nuestro objetivo es garantizar la integridad de los fondos del usuario durante un cierto período de tiempo, no darles un ciclo de vida.” Trata los 120 días como la ventana mínima garantizada antes de la posible redistribución, no como una marca de expiración on-chain estricta.
3. Límite (limit): Representa el ingreso máximo restante que un NFT puede generar.

​

Saldos del Sistema

• Saldo Dev (devBalance): Acumula tarifas y comisiones de la plataforma para financiación operativa.
• Saldo de Reserva de Tokens (tokenReserveBalance): El pool de liquidez en USDT que respalda al 100% el token DA. Cada fuente de ingresos del ecosistema fluye a este pool.
• Saldo de Impacto de Precio (priceImpactBalance): Una reserva especial utilizada para gestionar la estabilidad del precio del token DA durante eventos específicos del ecosistema.

​

Prioridad de Pagos