Kiến Trúc Hợp Đồng Thông Minh

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)

​

Các Facets Cốt Lõi

​

Hợp Đồng NFT & Không Gian Token ID

• NFT Thông Thường — token ID lẻ (1, 3, 5, 7, …).
• NFT Quà Tặng — token ID chẵn (2, 4, 6, 8, …).

​

Ma Trận Khả Năng Nâng Cấp

• Hợp Đồng Diamond (EIP-2535): Có thể nâng cấp qua Facet cuts — cho phép thêm, thay thế, hoặc xóa các mô-đun riêng lẻ mà không cần triển khai lại toàn bộ hệ thống.
• TokenReserve (DA): Có thể nâng cấp qua Transparent Proxy — có thể cập nhật logic mà không thay đổi địa chỉ hợp đồng.
• NFT (Regular, Gift, Ambassador), GovToken, AdminContract: Không thể nâng cấp — đảm bảo tính bất biến của các tài sản cốt lõi và quy tắc quản trị.

​

Quản Lý Vai Trò

• ADMIN_ROLE: Có thể cấp/thu hồi các vai trò khác và thay đổi các tham số hệ thống quan trọng.
• SERVICE_ROLE: Được thực thi bởi các script backend cho các tác vụ tự động (ví dụ: giải quyết các stack hết hạn, xử lý các giao dịch nạp liên chuỗi).
• SIGNER_ROLE: Được sử dụng để xác minh chữ ký mật mã để ủy quyền các hành động cụ thể như chuyển Voucher.
• MINTER_ROLE: Được ủy quyền đúc các token hoặc NFT cụ thể.

​

Lược Đồ Số Dư & Ưu Tiên Thanh Toán

1. Số Dư Thông Thường (balance): Ví chính cho USDT có sẵn. Tiền ở đây có thể được rút bất cứ lúc nào, được sử dụng để mua NFT, hoặc được sử dụng để tạo Voucher.
2. Số Dư Tích Lũy (accumulativeBalance): Một tài khoản tiết kiệm bắt buộc nơi 20% của mỗi phần thưởng marketing được ghi có ngay khi tích lũy.
   • Sử dụng: Chỉ có thể được sử dụng để mua cùng cấp NFT hoặc mua NFT cấp cao hơn.
   • Phí: Sử dụng số dư này cho các giao dịch mua NFT phát sinh phí 20% được chuyển vào Pool Thanh khoản DA. Chuyển nó cho người dùng khác cũng phát sinh phí 20% được chuyển vào Pool Thanh khoản DA. Mỗi chuyển động của Số Dư Tích Lũy tạo ra dòng vào cho Pool và tạo cơ sở cho DA mới.
   • Phân Phối Lại Sau 120 Ngày: Nếu người dùng không sử dụng Số Dư Tích Lũy của họ trong vòng 120 ngày, số dư không sử dụng trở nên đủ điều kiện để phân phối lại. Sự phân chia phụ thuộc vào loại NFT của người dùng:
     • Người sở hữu NFT Thông Thường: 70% được chuyển vào Pool Thanh khoản DA để đúc token DA mới; 30% được chuyển cho người tài trợ tuyến trên trực tiếp của người dùng.
     • Người sở hữu NFT Quà Tặng: 80% được chuyển vào Pool Thanh khoản DA; 20% được chuyển cho người tài trợ tuyến trên trực tiếp (do tham số accumulativeClaimDistributeGift riêng biệt quản lý).
     • Quy tắc cascade (cả hai loại): Nếu Giới Hạn Thu Nhập của người tài trợ tuyến trên đã cạn kiệt (bằng 0), phần của người tài trợ chuyển tiếp lên người tham gia đủ điều kiện tiếp theo trong cấu trúc. Nếu không có người tham gia nào trong chuỗi có Giới Hạn Thu Nhập đang hoạt động, toàn bộ số tiền được chuyển vào Pool Thanh khoản DA.
   120 Ngày = Cửa Sổ Tối Thiểu Đảm Bảo, Không Phải Hết Hạn Tự Động: Tham số accumulativeDecayTime được kiểm tra chỉ bên trong withdrawAccumulative() — đường dẫn phân phối lại do quản trị viên/dịch vụ kích hoạt. Nó không được đánh giá trên các đường dẫn chi tiêu hoặc chuyển nhượng. Trên thực tế điều này có nghĩa:

   • Trong 120 ngày đầu tiên sau khi ghi có, Số Dư Tích Lũy được đảm bảo tính toàn vẹn — nó không thể bị phân phối lại bởi bất kỳ ai.
   • Sau ngày 120, số dư trở nên đủ điều kiện để phân phối lại, nhưng phân phối lại không tự động kích hoạt khi bộ đếm thời gian trôi qua. Nó chỉ xảy ra khi withdrawAccumulative() được gọi cho người dùng cụ thể đó bởi SERVICE_ROLE hoặc ADMIN_ROLE.
   • Cho đến khi cuộc gọi đó được thực hiện, Số Dư Tích Lũy “hết hạn” vẫn có thể chi tiêu cho các giao dịch mua và nâng cấp NFT và có thể chuyển cho người dùng khác theo các quy tắc và phí tiêu chuẩn.

   Ý định đã nêu của nhóm, được ghi lại trong phản hồi kiểm toán: “Mục tiêu của chúng tôi là đảm bảo tính toàn vẹn của tiền của người dùng trong một khoảng thời gian nhất định, không phải để cung cấp cho họ một vòng đời.” Hãy coi 120 ngày là cửa sổ đảm bảo tối thiểu trước khi có khả năng phân phối lại, không phải là dấu thời gian hết hạn on-chain cứng.
3. Giới Hạn (limit): Đại diện cho thu nhập còn lại tối đa mà NFT có thể tạo ra.

​

Số Dư Hệ Thống

• Dev Balance (devBalance): Tích lũy phí và hoa hồng nền tảng cho tài trợ vận hành.
• Token Reserve Balance (tokenReserveBalance): Pool thanh khoản USDT bảo chứng 100% cho token DA. Mỗi nguồn thu nhập trong hệ sinh thái đều cấp vào pool này.
• Price Impact Balance (priceImpactBalance): Một dự trữ đặc biệt được sử dụng để quản lý tính ổn định giá token DA trong các sự kiện hệ sinh thái cụ thể.

​

Ưu Tiên Thanh Toán