Architecture des 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 Principaux

​

Contrats NFT & Espaces d’IDs de Jetons

• NFT Régulier — IDs de jeton impairs (1, 3, 5, 7, …).
• NFT Cadeau — IDs de jeton pairs (2, 4, 6, 8, …).

​

Matrice d’Évolutivité

• Contrat Diamond (EIP-2535) : Évolutif via des coupes de Facet — permet d’ajouter, remplacer ou retirer des modules individuels sans redéployer l’ensemble du système.
• TokenReserve (DA) : Évolutif via Transparent Proxy — les mises à jour de logique sont possibles sans changer l’adresse du contrat.
• NFT (Régulier, Cadeau, Ambassadeur), GovToken, AdminContract : Non évolutifs — garantissant l’immuabilité des actifs centraux et des règles de gouvernance.

​

Gestion des Rôles

• ADMIN_ROLE : Peut accorder/révoquer d’autres rôles et modifier les paramètres système critiques.
• SERVICE_ROLE : Exécuté par des scripts backend pour des tâches automatisées (par exemple, résolution des piles expirées, traitement des dépôts inter-chaînes).
• SIGNER_ROLE : Utilisé pour la vérification des signatures cryptographiques afin d’autoriser des actions spécifiques comme les transferts de Vouchers.
• MINTER_ROLE : Autorisé à créer (mint) des jetons ou NFT spécifiques.

​

Schéma des Soldes & Priorité des Paiements

1. Solde Régulier (balance) : Le wallet principal pour l’USDT disponible. Les fonds ici peuvent être retirés à tout moment, utilisés pour acheter des NFT ou pour générer des Vouchers.
2. Solde Cumulatif (accumulativeBalance) : Un compte d’épargne obligatoire où 20 % de chaque récompense marketing sont crédités immédiatement à l’accrual.
   • Utilisation : Peut uniquement être utilisé pour acheter un NFT du même niveau ou un NFT de niveau supérieur.
   • Frais : L’utilisation de ce solde pour des achats de NFT entraîne des frais de 20 % dirigés vers le Pool de Liquidité du DA. Le transfert vers un autre utilisateur entraîne également des frais de 20 % dirigés vers le Pool de Liquidité du DA. Chaque mouvement du Solde Cumulatif génère un afflux vers le Pool et crée la base pour de nouveaux DA.
   • Redistribution à 120 jours : Si l’utilisateur n’utilise pas son Solde Cumulatif dans les 120 jours, le solde inutilisé devient éligible à la redistribution. La répartition dépend du type de NFT de l’utilisateur :
     • Détenteurs de NFT Régulier : 70 % sont dirigés vers le Pool de Liquidité du DA pour le minage de nouveaux jetons DA ; 30 % sont transférés au sponsor amont direct de l’utilisateur.
     • Détenteurs de NFT Cadeau : 80 % sont dirigés vers le Pool de Liquidité du DA ; 20 % sont transférés au sponsor amont direct (régi par le paramètre distinct accumulativeClaimDistributeGift).
     • Règle de cascade (les deux types) : Si la Limite de Revenus du sponsor amont est épuisée (égale à zéro), la part du sponsor remonte au prochain participant éligible dans la structure. Si aucun participant dans la chaîne n’a de Limite de Revenus active, le montant entier est dirigé vers le Pool de Liquidité du DA.
   120 Jours = Fenêtre Minimale Garantie, Non une Expiration Automatique : Le paramètre accumulativeDecayTime est vérifié uniquement à l’intérieur de withdrawAccumulative() — le chemin de redistribution déclenché par admin/service. Il n’est pas évalué sur les chemins de dépense ou de transfert. En pratique cela signifie :

   • Pendant les 120 premiers jours après un crédit, l’intégrité du Solde Cumulatif est garantie — il ne peut être redistribué par personne.
   • Après le jour 120, le solde devient éligible à la redistribution, mais celle-ci ne s’effectue pas automatiquement à l’expiration du minuteur. Elle ne se produit que lorsque withdrawAccumulative() est invoqué pour cet utilisateur spécifique par le SERVICE_ROLE ou ADMIN_ROLE.
   • Jusqu’à ce que cet appel ait lieu, un Solde Cumulatif « expiré » reste utilisable pour des achats et mises à niveau de NFT, et transférable à d’autres utilisateurs selon les règles et frais standard.

   L’intention déclarée de l’équipe, consignée dans la réponse à l’audit : « Notre objectif est de garantir l’intégrité des fonds de l’utilisateur pendant une certaine période, et non de leur donner un cycle de vie. » Considérez les 120 jours comme la fenêtre minimale garantie avant une éventuelle redistribution, et non comme un timestamp d’expiration on-chain strict.
3. Limite (limit) : Représente le revenu maximal restant qu’un NFT peut générer.

​

Soldes Système

• Solde Dev (devBalance) : Accumule les frais de la plateforme et les commissions pour le financement opérationnel.
• Solde de Réserve de Jetons (tokenReserveBalance) : Le pool de liquidité USDT qui adosse à 100 % le jeton DA. Chaque source de revenu de l’écosystème alimente ce pool.
• Solde d’Impact sur le Prix (priceImpactBalance) : Une réserve spéciale utilisée pour gérer la stabilité du prix du jeton DA lors d’événements spécifiques de l’écosystème.

​

Priorité des Paiements