Architettura degli 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)

​

Faceti Principali

​

Contratti NFT e Spazi degli ID Token

• NFT Regular — ID token dispari (1, 3, 5, 7, …).
• NFT Gift — ID token pari (2, 4, 6, 8, …).

​

Matrice di Aggiornabilità

• Diamond Contract (EIP-2535): Aggiornabile tramite Facet cuts — consente di aggiungere, sostituire o rimuovere singoli moduli senza ridistribuire l’intero sistema.
• TokenReserve (DA): Aggiornabile tramite Transparent Proxy — gli aggiornamenti della logica sono possibili senza cambiare l’indirizzo del contratto.
• NFT (Regular, Gift, Ambassador), GovToken, AdminContract: Non aggiornabili — garantendo l’immutabilità degli asset principali e delle regole di governance.

​

Gestione dei Ruoli

• ADMIN_ROLE: Può concedere/revocare altri ruoli e modificare parametri critici di sistema.
• SERVICE_ROLE: Eseguito da script di backend per attività automatizzate (ad es., risoluzione di stack scaduti, elaborazione di depositi cross-chain).
• SIGNER_ROLE: Utilizzato per la verifica di firme crittografiche per autorizzare azioni specifiche come i trasferimenti di Voucher.
• MINTER_ROLE: Autorizzato a mintare token o NFT specifici.

​

Schema dei Saldi e Priorità di Pagamento

1. Saldo Regolare (balance): Il wallet principale per l’USDT disponibile. I fondi qui possono essere prelevati in qualsiasi momento, utilizzati per acquistare NFT o utilizzati per generare Voucher.
2. Saldo Cumulativo (accumulativeBalance): Un conto di risparmio obbligatorio in cui il 20% di ciascuna ricompensa di marketing viene accreditato immediatamente al maturare.
   • Utilizzo: Può essere utilizzato solo per acquistare un NFT dello stesso livello o per acquistare un NFT di livello superiore.
   • Commissioni: Utilizzare questo saldo per acquisti NFT comporta una commissione del 20% indirizzata al Pool di Liquidità DA. Anche trasferirlo a un altro utente comporta una commissione del 20% indirizzata al Pool di Liquidità DA. Ogni movimento del Saldo Cumulativo genera un flusso nel Pool e crea la base per nuovo DA.
   • Ridistribuzione a 120 Giorni: Se l’utente non utilizza il proprio Saldo Cumulativo entro 120 giorni, il saldo non utilizzato diventa idoneo per la ridistribuzione. La suddivisione dipende dal tipo di NFT dell’utente:
     • Detentori di NFT Regular: Il 70% viene indirizzato al Pool di Liquidità DA per il minting di nuovi token DA; il 30% viene trasferito allo sponsor diretto in upline dell’utente.
     • Detentori di NFT Gift: L’80% viene indirizzato al Pool di Liquidità DA; il 20% viene trasferito allo sponsor diretto in upline (governato dal parametro separato accumulativeClaimDistributeGift).
     • Regola della cascata (entrambi i tipi): Se l’Income Limit dello sponsor in upline è esaurito (uguale a zero), la quota dello sponsor passa più in alto al successivo partecipante idoneo nella struttura. Se nessun partecipante nella catena ha un Income Limit attivo, l’intero importo viene indirizzato al Pool di Liquidità DA.
   120 Giorni = Finestra Minima Garantita, Non una Scadenza Automatica: Il parametro accumulativeDecayTime viene controllato solo all’interno di withdrawAccumulative() — il percorso di ridistribuzione attivato da admin/service. Non viene valutato nei percorsi di spesa o trasferimento. In pratica questo significa:

   • Per i primi 120 giorni dopo un accredito, il Saldo Cumulativo ha integrità garantita — non può essere ridistribuito da nessuno.
   • Dopo il giorno 120, il saldo diventa idoneo per la ridistribuzione, ma la ridistribuzione non si attiva automaticamente quando il timer scade. Avviene solo quando withdrawAccumulative() viene invocato per quello specifico utente da SERVICE_ROLE o ADMIN_ROLE.
   • Fino a quando quella chiamata non avviene, un Saldo Cumulativo “scaduto” rimane spendibile per acquisti e upgrade NFT e trasferibile ad altri utenti secondo le regole e commissioni standard.

   L’intento dichiarato del team, registrato nella risposta all’audit: “Our goal is to guarantee the user’s funds’ integrity for a certain period of time, not to give them a lifecycle.” Considera 120 giorni come la finestra minima garantita prima di una potenziale ridistribuzione, non come un timestamp di scadenza on-chain rigido.
3. Limit (limit): Rappresenta il reddito massimo residuo che un NFT può generare.

​

Saldi di Sistema

• Dev Balance (devBalance): Accumula commissioni della piattaforma e tasse per il finanziamento operativo.
• Token Reserve Balance (tokenReserveBalance): Il pool di liquidità in USDT che garantisce al 100% il token DA. Ogni fonte di reddito nell’ecosistema confluisce in questo pool.
• Price Impact Balance (priceImpactBalance): Una riserva speciale utilizzata per gestire la stabilità del prezzo del token DA durante eventi specifici dell’ecosistema.

​

Priorità di Pagamento