Смарт-контракт архитектурасы

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)

​

Негізгі Facet-тер

​

NFT контракттары және токен ID кеңістіктері

• Кәдімгі NFT — тақ токен ID-лері (1, 3, 5, 7, …).
• Сыйлық NFT — жұп токен ID-лері (2, 4, 6, 8, …).

​

Жаңарту матрицасы

• Diamond Контракты (EIP-2535): Facet кесулері арқылы жаңартылатын — бүкіл жүйені қайта орналастырмай жеке модульдерді қосуға, ауыстыруға немесе жоюға мүмкіндік береді.
• TokenReserve (DA): Transparent Proxy арқылы жаңартылатын — контракт мекен-жайын өзгертпей логиканы жаңартуға болады.
• NFT-тер (Кәдімгі, Сыйлық, Елші), GovToken, AdminContract: Жаңартылмайтын — негізгі активтер мен басқару ережелерінің өзгермейтінін қамтамасыз етеді.

​

Рөлдерді басқару

• ADMIN_ROLE: Басқа рөлдерді беруге/қайтарып алуға және сыни жүйелік параметрлерді өзгертуге болады.
• SERVICE_ROLE: Автоматтандырылған тапсырмалар үшін бэкенд скрипттерімен орындалады (мысалы, мерзімі біткен стектерді шешу, кросс-чейн депозиттерді өңдеу).
• SIGNER_ROLE: Ваучер аударымдары сияқты нақты әрекеттерді авторизациялау үшін криптографиялық қолтаңбаны тексеру үшін қолданылады.
• MINTER_ROLE: Нақты токендерді немесе NFT-терді шығаруға өкілетті.

​

Баланс схемасы және төлем басымдығы

1. Негізгі баланс (balance): Қол жетімді USDT үшін негізгі әмиян. Мұндағы қаражатты кез келген уақытта шығаруға, NFT сатып алуға немесе Ваучерлер жасауға болады.
2. Жинақтаушы баланс (accumulativeBalance): Әрбір маркетинг сыйақысының 20%-ы есептеу кезінде бірден аударылатын міндетті жинақтаушы шот.
   • Қолдану: Тек сол деңгейлі NFT-ті сатып алу немесе жоғарырақ деңгейлі NFT-ті сатып алу үшін қолданылады.
   • Алымдар: NFT сатып алуларда бұл балансты қолдану DA Өтімділік Пулына бағытталған 20% алым тудырады. Оны басқа пайдаланушыға аудару да DA Өтімділік Пулына бағытталған 20% алым тудырады. Жинақтаушы Балансты қандай да бір қозғалту Пулға кіріс жасайды және жаңа DA үшін негіз жасайды.
   • 120 күндік қайта тарату: Пайдаланушы Жинақтаушы Балансын 120 күн ішінде қолданбаса, пайдаланылмаған баланс қайта таратуға жарамды болады. Бөлу пайдаланушының NFT түріне байланысты:
     • Кәдімгі NFT иелері: 70% жаңа DA токендерін шығару үшін DA Өтімділік Пулына бағытталады; 30% пайдаланушының тікелей жоғары демеушісіне аударылады.
     • Сыйлық NFT иелері: 80% DA Өтімділік Пулына бағытталады; 20% тікелей жоғары демеушіге аударылады (бөлек accumulativeClaimDistributeGift параметрімен реттеледі).
     • Каскад ережесі (екі түр үшін де): Жоғары демеушінің Кіріс Лимиті сарқылса (нөлге тең), демеуші үлесі құрылымдағы келесі жарамды қатысушыға дейін одан әрі өтеді. Тізбекте белсенді Кіріс Лимиті бар қатысушы болмаса, бүкіл сома DA Өтімділік Пулына бағытталады.
   120 күн = кепілдендірілген минималды терезе, автоматты мерзімі біту емес: accumulativeDecayTime параметрі тек withdrawAccumulative() ішінде тексеріледі — әкімші/қызмет арқылы іске қосылатын қайта тарату жолы. Ол жұмсау немесе аудару жолдарында бағаланбайды. Іс жүзінде бұл мынаны білдіреді:

   • Есептеудің алғашқы 120 күнінде Жинақтаушы Баланс тұтастық кепілдемесімен қамтамасыз етіледі — оны ешкім қайта тарата алмайды.
   • 120-күннен кейін баланс қайта таратуға жарамды болады, бірақ таймер біткенде қайта тарату автоматты түрде басталмайды. Ол сол нақты пайдаланушы үшін withdrawAccumulative() SERVICE_ROLE немесе ADMIN_ROLE арқылы шақырылғанда ғана болады.
   • Сол шақыру келгенше, “мерзімі біткен” Жинақтаушы Баланс стандартты ережелер мен алымдар бойынша NFT сатып алуларда және жаңартуларда жұмсалатын және басқа пайдаланушыларға аударылатын болып қалады.

   Команданың аудит жауабында жазылған көрсетілген ниеті: “Біздің мақсатымыз — пайдаланушының қаражатының тұтастығын белгілі бір уақыт бойы кепілдендіру, оларға өмірлік цикл беру емес.” 120 күнді ықтимал қайта таратуға дейінгі минималды кепілдендірілген терезе ретінде қарастырыңыз, чейндегі қатаң мерзімі біту уақыт белгісі ретінде емес.
3. Лимит (limit): NFT жасай алатын максималды қалған кірісті білдіреді.

​

Жүйелік баланстар

• Әзірлеуші балансы (devBalance): Платформа алымдары мен комиссиялар операциялық қаржыландыру үшін жинақталады.
• Токен резерв балансы (tokenReserveBalance): DA токенін 100% қамтамасыз ететін USDT өтімділік пулы. Экожүйедегі әр кіріс көзі бұл пулға түседі.
• Бағаға әсер балансы (priceImpactBalance): Нақты экожүйелік оқиғалар кезінде DA токен бағасының тұрақтылығын басқару үшін қолданылатын арнайы резерв.

​

Төлем басымдығы