Arkitektura ng 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)

​

Mga Pangunahing Facet

​

Mga NFT Contract at Token ID Spaces

• Regular NFT — odd token IDs (1, 3, 5, 7, …).
• Gift NFT — even token IDs (2, 4, 6, 8, …).

​

Upgradability Matrix

• Diamond Contract (EIP-2535): Maaaring i-upgrade sa pamamagitan ng Facet cuts — nagpapahintulot ng pagdaragdag, pagpapalit, o pag-aalis ng mga indibidwal na module nang hindi muling ide-deploy ang buong system.
• TokenReserve (DA): Maaaring i-upgrade sa pamamagitan ng Transparent Proxy — ang logic updates ay posible nang hindi binabago ang contract address.
• NFTs (Regular, Gift, Ambassador), GovToken, AdminContract: Hindi maaaring i-upgrade — tinitiyak ang immutability ng mga pangunahing asset at governance rules.

​

Pamamahala ng Role

• ADMIN_ROLE: Maaaring magbigay/magbawi ng iba pang role at baguhin ang mga kritikal na system parameter.
• SERVICE_ROLE: Isinasagawa ng backend scripts para sa mga automated task (hal., paglutas ng expired stacks, pagproseso ng cross-chain deposits).
• SIGNER_ROLE: Ginagamit para sa cryptographic signature verification upang pahintulutan ang mga partikular na aksyon tulad ng Voucher transfers.
• MINTER_ROLE: Pinahihintulutang mag-mint ng mga partikular na token o NFT.

​

Balance Schema at Payment Priority

1. Regular Balance (balance): Ang pangunahing wallet para sa magagamit na USDT. Ang mga pondo dito ay maaaring i-withdraw anumang oras, gamitin para bumili ng NFTs, o gamitin para gumawa ng Vouchers.
2. Accumulative Balance (accumulativeBalance): Isang sapilitang savings account kung saan ang 20% ng bawat marketing reward ay agad na na-credit pagkatapos ng accrual.
   • Paggamit: Maaari lamang gamitin upang bumili ng same level NFT o upang bumili ng higher-level NFT.
   • Mga Bayarin: Ang paggamit ng balanseng ito para sa NFT purchases ay nagdudulot ng 20% fee na iniruruta sa DA Liquidity Pool. Ang paglilipat nito sa ibang user ay nagdudulot din ng 20% fee na iniruruta sa DA Liquidity Pool. Bawat paggalaw ng Accumulative Balance ay bumubuo ng inflow sa Pool at lumilikha ng batayan para sa bagong DA.
   • 120-Araw na Redistribution: Kung hindi ginagamit ng user ang kanilang Accumulative Balance sa loob ng 120 araw, ang hindi nagamit na balance ay nagiging eligible para sa redistribution. Ang split ay depende sa uri ng NFT ng user:
     • Regular NFT holders: 70% ay idinidirekta sa DA Liquidity Pool para sa minting ng bagong DA tokens; 30% ay inililipat sa direct upline sponsor ng user.
     • Gift NFT holders: 80% ay idinidirekta sa DA Liquidity Pool; 20% ay inililipat sa direct upline sponsor (pinamamahalaan ng hiwalay na accumulativeClaimDistributeGift parameter).
     • Cascade rule (parehong types): Kung naubos ang Income Limit ng upline sponsor (katumbas ng zero), ang sponsor share ay dumadaan pa pataas sa susunod na eligible na kalahok sa istraktura. Kung walang kalahok sa chain ang may aktibong Income Limit, ang buong halaga ay iniruruta sa DA Liquidity Pool.
   120 Araw = Garantisadong Minimum Window, Hindi Awtomatikong Pag-expire: Ang accumulativeDecayTime parameter ay sinusuri lamang sa loob ng withdrawAccumulative() — ang admin/service-triggered redistribution path. Hindi ito sinusuri sa spend o transfer paths. Sa pagsasagawa, ito ay nangangahulugan:

   • Para sa unang 120 araw pagkatapos ng credit, ang Accumulative Balance ay garantisadong integrity — hindi ito maaaring i-redistribute ng sinuman.
   • Pagkatapos ng araw 120, ang balance ay nagiging eligible para sa redistribution, ngunit hindi awtomatikong nagpapaputok ang redistribution kapag lumipas ang timer. Nangyayari lamang ito kapag ang withdrawAccumulative() ay tinawag para sa partikular na user na iyon ng SERVICE_ROLE o ADMIN_ROLE.
   • Hanggang dumating ang tawag na iyon, ang isang “expired” Accumulative Balance ay nananatiling magagastos sa NFT purchases at upgrades at maaaring ilipat sa ibang users sa ilalim ng standard rules at fees.

   Ang nakasulat na intensiyon ng team, naitala sa audit response: “Our goal is to guarantee the user’s funds’ integrity for a certain period of time, not to give them a lifecycle.” Ituring ang 120 araw bilang minimum garantisadong window bago ang potensyal na redistribution, hindi bilang isang mahigpit na on-chain expiry timestamp.
3. Limit (limit): Kumakatawan sa maximum na natitirang kita na maaaring mabuo ng isang NFT.

​

Mga System Balance

• Dev Balance (devBalance): Nag-iipon ng platform fees at commissions para sa operational funding.
• Token Reserve Balance (tokenReserveBalance): Ang USDT liquidity pool na 100% sumusuporta sa DA token. Bawat pinagmumulan ng kita sa ekosistema ay dumadaloy sa pool na ito.
• Price Impact Balance (priceImpactBalance): Isang espesyal na reserve na ginagamit upang pamahalaan ang DA token price stability sa panahon ng mga partikular na ecosystem events.

​

Payment Priority