> ## 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.

# Глосарій

> Визначення кожного специфічного для протоколу терміна в RWANFTFI: DA, NFTM, Ліміт Доходу, Спонсорський Бонус, Frozen Balance, Компресія, Накопичувальний Баланс та інші.

Єдине джерело істини для кожного терміна, що використовується в документації RWANFTFI. Кожна стаття написана так, щоб бути самодостатньою — скопіюйте визначення в будь-який контекст, і воно все одно матиме сенс.

## Токени та активи

**DA (Дефляційний Актив).** Економічний двигун екосистеми. BEP20-токен, жорстко обмежений **21 000 000 одиниць** і на 100% забезпечений пулом ліквідності USDT. Ціна визначається формулою `Ціна = Ліквідність ÷ Обігова Пропозиція`. DA не передається між однорангові; його можна лише продати (вручну або автоматично), використати як заставу для кредитування або погасити. 100% проданого DA назавжди спалюється. Див. [Механіка токена DA](/uk/da-token-mechanics).

**NFTM.** Внутрішній лічильник майнінгу, відстежуваний смартконтрактом, **не токен**. NFTM не має ринкової вартості, не може торгуватися або передаватися, і існує лише для стейкінгу у Фармінг, де конвертується в DA за поточною ціною. Див. [Майнінг та Фармінг](/uk/da-mining-farming).

**GovToken.** Токен управління. Стандарт ERC20Votes, постійно фіксована емісія **10 000 000**, без мінтингу після розгортання. Голосувальна сила автоматично делегується одержувачу при будь-якому переказі; ручний `delegate()` не передбачений. Див. [Управління](/uk/governance).

**NFT (рівень RWANFTFI).** Ключ доступу до протоколу на основі членства. Існує 10 рівнів — **Genesis, Advance, Ascend, Eclipse, Hydro, Quantum, Pulse, Aurora, Flame, Infinity** — ціни від 28 до 24 000 USDT. Один активний NFT на акаунт; апгрейд замінює попередній. Див. [Екосистема NFT](/uk/nft-ecosystem).

**Подарунковий NFT (Gift NFT).** Непродаваний промо-NFT, що нагороджується через акції або досягнення Career Rank. Не можна купити. До 100 на адресу (регулюється DAO). Мінтується з парними ідентифікаторами токенів, щоб уникнути конфліктів із Regular NFT (непарні ID).

**Ambassador NFT.** Обмежено 100 одиницями (Q4 2026). Без лімітів доходу, власна виділена система винагород, не передається при Продажу бізнесу.

**VIP Edition NFT.** Обмежено 100 одиницями (Q4 2026). Доступ надається за досягнення Career Rank рівня **Leader** або вище.

**USDT.** Стейблкоїн, що використовується як основна одиниця обліку і 100% забезпечення токена DA. RWANFTFI використовує USDT за стандартом BEP20.

## Доходи та ліміти

**Ліміт Доходу.** Максимальний сукупний дохід, який активний NFT може згенерувати до поновлення. Витрачається як маркетинговими винагородами, так і продажами DA. Коли досягає нуля, власник перестає отримувати всі маркетингові винагороди та втрачає можливість продавати DA вручну. Поновлюється через Autobuy, ручну повторну купівлю того ж рівня або апгрейд.

**Спонсорський Бонус (Sponsor Bonus).** Пряма комісія, що сплачується запрошувачу при купівлі NFT партнером. **30%** від ціни NFT при новому продажу (Фаза 1) або **20%** при повторній купівлі / Autobuy. У Фазі 2 Спонсорський Бонус при новому продажу змінюється до 20%.

**Розподіл по дереву (Tree Distribution).** Винагороди за рівнями, що виплачуються учасникам вгору по лінії від купівлі NFT учасником структури. Відсотки варіюються від 0% (Рівень 1) до 5% (Рівень 15). Рівні 16–22 відкриваються у Фазі 2. Максимальна досяжна глибина залежить від рівня NFT власника.

**Matching Bonus.** Вторинний потік, що виплачує **5% + 5% + 5%** по трьох рівнях маркетингового доходу прямих партнерів власника. Рівень 1 відкривається на Eclipse (L4); Рівень 2 — при 1 000 USDT сукупних особистих продажів; Рівень 3 — при 3 000 USDT сукупних особистих продажів.

**Компресія (Compression).** Коли учасник вгору по лінії не відповідає умовам для отримання винагороди (Ліміт Доходу вичерпано або рівень NFT занадто низький), винагорода передається вище наступному кваліфікованому учаснику. Пропущена винагорода позначається як **Lost Income** для обійденого користувача.

**Lost Income (Втрачений Дохід).** Винагорода, яку користувач міг би отримати, але не отримав, бо його Ліміт Доходу дорівнював нулю або глибина NFT була недостатньою. Відстежується для прозорості; самі кошти передаються вгору через компресію.

## Баланси

**Звичайний Баланс (`balance`).** Основний USDT-гаманець користувача всередині смартконтракту. Виводиться в будь-який час; може використовуватися для купівлі NFT або генерації Ваучерів.

**Накопичувальний Баланс (`accumulativeBalance`).** Обов'язковий ощадний рахунок, на який автоматично зараховується **20%** кожної маркетингової винагороди. Може використовуватися лише для купівлі NFT того ж рівня або апгрейду до вищого. Використання передбачає комісію **20%**, що спрямовується до Пулу Ліквідності DA; переказ передбачає таку ж комісію 20%. Якщо не використовується протягом **120 днів**, стає придатним для перерозподілу (Regular NFT: 70% до пулу / 30% вгору по лінії; Gift NFT: 80% / 20%).

**Frozen Balance.** 72-годинний стан утримання маркетингової комісії, що перевищує залишковий Ліміт Доходу власника, але лише коли джерелом є перша купівля прямого запрошеного або його Autobuy. Вивільняється при апгрейді NFT; після закінчення терміну 70% спрямовується до Пулу Ліквідності DA і 30% — прямому спонсору вгору по лінії. Див. [Frozen Balance](/uk/frozen-balance).

**Ліміт (`limit`).** Поле он-чейн, що відображає максимальний залишковий дохід, який NFT може згенерувати. Еквівалент «залишкового Ліміту Доходу».

**Баланс Резерву Токенів (`tokenReserveBalance`).** Системний USDT-пул, що на 100% забезпечує токен DA. Фінансується з 14+ джерел доходу по всій екосистемі.

**Dev Balance (`devBalance`).** Накопичує комісії платформи для операційного фінансування. Недоступний окремим користувачам або адміністраторам поза процедурами управління.

**Баланс цінового впливу (`priceImpactBalance`).** Резерв для управління стабільністю ціни DA під час певних подій екосистеми (наприклад, подія Price Impact, ініційована DAO).

## Життєвий цикл та автоматизація

**Autobuy (система 3/3).** Механізм автоматичного поновлення NFT. Для рівнів 1–8 дозволено до **3 автоматичних поновлень** після початкової ручної купівлі, тож той самий рівень NFT може бути активним максимум 4 рази (1 ручна + 3 авто). Для Elite-рівнів (L9–L10) Autobuy є **необмеженим**. Лічильник 3/3 скидається до 0/3 при купівлі NFT вищого рівня.

**Продаж бізнесу (Business Sale).** Авторизований DAO процес передачі всієї партнерської деревоподібної структури іншому користувачу. Обмежений фіксованою **комісією за передачу, що сплачується продавцем** (наразі 500 USDT, регулюється DAO у діапазоні 0–500). Покупець не сплачує жодної он-чейн комісії та отримує структуру при виконанні. Базовий параметр: `businessTransferFee`.

**Ваучер (Подарунковий ваучер).** Згенерований користувачем купон, дійсний **365 днів**, із закріпленим у смартконтракті мінімумом **5 USDT**. Покриває до 100% купівлі NFT. Передається з 0% комісією, крім **останніх 24 годин** перед закінченням терміну. Не можна поєднувати з Накопичувальним Балансом. Невикористаний через 365 днів → 100% до Пулу Ліквідності DA.

**Career Rank.** Показник прогресу, що використовується для розблокування переваг, таких як Ambassador або VIP NFT, та спеціальних винагород. Досягається через сукупну активність в екосистемі.

## Механіка протоколу

**Майнінг.** Перший крок отримання DA. Користувач активує майнінг на Premium або Elite NFT (L5+). Цикл генерує NFTM протягом фіксованого періоду (45 днів на Hydro до 40 днів на Infinity). Рівні 5–7 мають 1 цикл майнінгу, що виробляє 10% від ціни NFT у NFTM. Рівні 8–10 мають 2 цикли, що виробляють спочатку 10%, потім 15%.

**Фармінг.** Другий крок отримання DA. NFTM стейкується на той самий термін, що й цикл майнінгу. Після завершення NFTM конвертується в DA за поточною ціною і зараховується на TokenStack користувача. Необхідно застейкати протягом **72 годин** після завершення майнінгу, інакше цикл буде втрачено.

**Цикл автопродажу (Auto-Sell Cycle).** Чотирьохперіодний прогресивний продаж балансу DA користувача, якщо той не продає вручну. Наразі: 25% після 120 днів → 40% залишку після ще 90 → 50% залишку після ще 90 → 100% залишку після фінальних 65 днів. Всього: 365 днів. Користувач отримує 70% вартості в USDT; 100% токенів спалюється.

**Ручний продаж (Manual Sell).** Ініційований користувачем продаж DA. 100% проданих токенів спалюється; користувач отримує **75%** вартості в USDT (проти 70% при автопродажу). Решта 25% — комісія протоколу, що залишається в пулі як забезпечення.

**Multi-Batch Lending.** Кожна партія DA з кожного циклу майнінгу служить **незалежною заставою**. Кредити видаються з **фіксованим LTV 70%** на всю партію — часткова застава частини партії не підтримується — і передбачають одноразову комісію 5% при видачі. Конкретна партія може бути закладена **лише один раз за весь строк існування**: після відкриття кредиту ця партія не може використовуватися як застава знову, навіть після повного погашення. Кілька одночасних кредитів тому можливі лише на **різних партіях**, але не на одній і тій самій. Часткове погашення підтримується — позичальник може вивільнити частину застави в будь-який час до входу партії в цикл автопродажу, погасивши пропорційну частку боргу, деномінованого в `loan.price`. У разі дефолту по одному кредиту прогресивно спалюється лише застава цієї партії; інші партії та баланси не зачіпаються.

**Дефолт за кредитом (Lending Default).** Непогашення кредиту до входу заставленої партії в цикл автопродажу. Заставлені DA тоді проходять через стандартний чотирьохперіодний графік (120 / 90 / 90 / 65 днів, 365 днів загалом), спалюючи 25%, потім 40%, потім 50%, потім 100% **залишкових** заставлених DA за кожен період. 100% спаленого DA назавжди знищується, а вартість у USDT за ціною `loan.price` для кожної спаленої частини надходить до Пулу Ліквідності DA. Позичальник зберігає USDT, отримані при видачі, і пропорційно до тривалості дефолту втрачає спалену частину застави. Дефолт — не все або нічого: між будь-якими двома періодами автопродажу позичальник може викликати `repay()` та повернути **залишкові** заставлені DA, сплативши лише за те, що ще в заставі. Інші партії DA та баланси не зачіпаються.

**Поріг прийнятності для кредиту (Loan Eligibility Threshold).** **Ковзна он-чейн перевірка, що виконується перед кожним новим викликом `loan()`** (`_getTimeToNextAutosale(stack) >= 30 days`): партія DA, що застав'яється, повинна мати щонайменше **30 днів** до наступного запланованого тригера автопродажу, інакше виклик відхиляється. Це **умова прийнятності**, що контролює доступ до кредитування, а не **термін кредиту** — відкритий кредит не має фіксованого строку погашення і може бути погашений повністю або частково в будь-який час до входу партії в цикл автопродажу.

**Комісія за кредит (`loanFee`).** Одноразова комісія **5%**, що стягується при видачі кредиту і спрямовується безпосередньо до Пулу Ліквідності DA. Погашення — повне чи часткове — комісію не стягує повторно. Зберігається он-чейн як окремий параметр `loanFee` (а не як частина будь-якої загальної комісії), що дозволяє DAO незалежно регулювати економіку кредитування. Поточний діапазон DAO: 0% – 5%.

**Ціна кредиту (`loan.price`).** Ціна DA, зафіксована `getPrice()` при видачі кредиту і збережена на стеку як `ts.loan.price`. Вся подальша математика кредиту — повне погашення, часткове погашення та врегулювання дефолту — деномінована відносно цієї ціни, а не поточної ринкової ціни. Якщо ринкова ціна DA подвоїться або потроїться під час дії кредиту, зобов'язання в USDT не збільшується — воно прив'язане до `loan.price`. Саме це дозволяє позичальникам вивільняти ліквідність USDT за сьогоднішньою вартістю DA, зберігаючи потенціал майбутнього зростання.

**Часткове погашення (Partial Repayment).** Можливість погасити лише частину кредиту під заставу DA, а не закривати його повністю. Позичальник викликає `repay()` на обрану кількість заставлених DA (не більше поточного загального обсягу в заставі) і сплачує `released_DA × loan.price × 0.70` USDT. Вивільнені DA повертаються в активну частину тієї ж партії; решта DA залишається в заставі при пропорційно зменшеному боргу. Додаткова комісія не стягується — 5% комісія вже сплачена при видачі. Часткове погашення можна викликати на будь-якому етапі строку кредиту, зокрема після тригерів автопродажу (в цьому випадку спочатку виконується `_processExpiredStacks()`, спалюючи відповідну частку застави, а потім погашення здійснюється відносно залишку після спалювання).

**Дефляційний цикл (Deflationary Cycle).** Запланована подія, що запускається двічі на рік і тривасть до 30 днів, яка призупиняє **запуск нових** циклів майнінгу NFTM, стейкінгу та генерації DA. Цикли, що вже тривають до початку Дефляційного Циклу, продовжуються та завершуються за графіком. Під час Циклу щоденне спалювання DA посилює дефіцит.

**Seed Supply.** Невеликий постійний резерв DA, попередньо депонований при запуску. Постійний і непродаваний, виключений з обігової пропозиції, існує виключно для гарантії ненульового знаменника в `Ціна = Ліквідність ÷ Обігова Пропозиція` — запобігаючи діленню на нуль у крайньому випадку, коли всі інші токени спалено.

## Управління та ролі

**DAO (Децентралізована Автономна Організація).** Он-чейн орган управління RWANFTFI. Підкріплений 10 000 000 GovToken. Поріг подання пропозиції: **30%** від загальної емісії. Поріг прийняття: більшість **50%**.

**Гардіани (Guardians).** Основні учасники управління в поточному розподілі. **20 гаманців**, кожен утримує 350 000 GovToken (3,5%). Майбутній перерозподіл зменшує це до 1,5% на Гардіана в міру додавання Лідерів.

**Лідери (Leaders).** Майбутній клас учасників управління (заплановано **80 гаманців** по 0,5% кожен), визначені як активні учасники екосистеми, будівельники спільноти, стратегічні партнери та оператори з вимірюваним впливом.

**Подія Price Impact.** Ініційована DAO подія, під час якої дохід користувачів спрямовується до Пулу Ліквідності DA для зміцнення забезпечення та стабільності ціни DA.

**Заморозка акаунту (Account Freeze).** Схвалена голосуванням DAO дія модерації, що відключає функціональність NFT на платформі. Сам NFT залишається в гаманці користувача — платформа не може вилучати NFT. Розморозка потребує окремого голосування DAO.

## Ролі смартконтракту

**ADMIN\_ROLE.** Може надавати/скасовувати інші ролі та змінювати критичні системні параметри в діапазонах, зафіксованих при розгортанні.

**SERVICE\_ROLE.** Виконується бекенд-скриптами для автоматизованих завдань: розв'язання прострочених стеків, обробка крос-чейн депозитів, ініціювання перерозподілу накопичувальних балансів.

**SIGNER\_ROLE.** Використовується для криптографічної верифікації підписів для авторизації певних дій (наприклад, передача Ваучерів).

**MINTER\_ROLE.** Авторизований для мінтингу певних токенів або NFT.

## Архітектура

**Diamond Pattern (EIP-2535).** Архітектура смартконтракту, що використовується RWANFTFI. Розподіляє функціональність по кількох модулях («Facets»), доступних через єдиний проксі-контракт — обходячи ліміт розміру контракту в 24 КБ та забезпечуючи оновлюваність на рівні модулів через Facet cuts. Специфікація: [EIP-2535](https://eips.ethereum.org/EIPS/eip-2535).

**Facet.** Незалежний модуль смартконтракту, доступний через Diamond-проксі. RWANFTFI використовує **7 Facets**: AdminFacet, MarketingFacet, FarmingFacet, PaymentFacet, TreeFacet, ResolverFacet, ViewFacet.

**TokenReserve.** Контракт, що управляє токеном DA. Оновлюваний через Transparent Proxy (оновлення логіки без зміни адреси).

**TAN-код (Номер автентифікації транзакції).** Одноразовий код, необхідний для авторизації кожної фінансової транзакції на рівні додатку. Незалежний від он-чейн сфери аудиту.

**Розподіл 75/20/5.** Стандартний кредитний розподіл маркетингових винагород у межах Ліміту Доходу власника: **75%** на Звичайний Баланс, **20%** на Накопичувальний Баланс, **5%** до Пулу Ліквідності DA.
