microdao-daarion/docs/tokenomics/city-tokenomics.md

title, version, status, last_updated

title	version	status	last_updated
City Tokenomics	1.0.0	canonical	2024-11-14

Цей документ є актуальною версією токеноміки міста.
Усі попередні документи з токеноміки вважаються застарілими.

City Tokenomics — DAARION.city (Integration-Ready)

Цей документ є обов'язковим для додавання у репозиторій під час інтеграції MicroDAO у DAARION.city.

DAARION.city — це перше MicroDAO у мережі (A1-рівень), що очолюється системним агентом DAARWIZZ. Усі інші компоненти міської екосистеми — це наступні рівні MicroDAO-структури.

---

1. Загальний огляд токеноміки міста

Місто працює на двоєдиній моделі токенів:

• DAAR — утиліті-токен (оплата сервісів, платформи, транзакції)
• DAARION — civic / identity токен (громадянство, доступ, статус)

Ця пара створює повноцінну економіку доступів та взаємодій.

---

2. DAAR — Utility Token

Використання

• оплата товарів та послуг
• взаємодія з міськими платформами (GreenFood, EnergyUnion, WaterUnion тощо)
• оплата агентів
• оплата створення та роботи microDAO
• внутрішні транзакції між користувачами та DAO

DAAR — енергія міської економіки.

Tokenomics

• динамічний випуск
• джерело: DAARsales (USDT/POL → DAAR)
• комісія на транзакції DAAR: 0.5% → DAO Share Pool
• APR: 20% (в стейкінгу)

---

3. DAARION — Civic Token / Identity Token

Використання

• підтвердження статусу громадянина міста
• доступ до глибинних рівнів інфраструктури
• ліцензійний ключ для створення платформ
• доступ до advanced API та інтеграцій

DAARION — статус, права і розширені можливості.

Tokenomics

• стартова емісія: 500 DAARION
• дефляція: 5% burn при продажу
• APR: 4% + частка від комісій DAAR
• джерело: DAARIONsales (100 DAAR → 1 DAARION)

---

4. Рівні доступу за DAAR та DAARION

4.1 Звичайні користувачі / Покупці

• доступ до платформ: лише наявність DAAR
• DAARION не потрібен

4.2 Постачальники / Вендори

• доступ до роботи на платформах: 0.01 DAARION у стейкінгу

4.3 Створення платформ

• право створити платформу: 1 DAARION у стейкінгу

4.4 Створення MicroDAO

• доступ: 1 DAAR або 0.01 DAARION

---

4.5 MicroDAO Tokens (Local Layer)

Кожне microDAO має власні три токени, емітовані DAOFactory:

Token	Function	Activation
GOV	governance / voting key inside DAO	cost: 1 DAAR
UTIL	внутрішня економіка DAO (операції, винагороди)	cost: 1 DAAR
REP	репутаційний токен (невзаємозамінний)	cost: 1 DAAR

Emission model:

• DAO може емітувати будь-яку кількість, згідно з власною політикою
• DAOFactory перевіряє баланс користувача (1 DAAR або 0.01 DAARION)
• Емісія gas-free (off-chain), періодична синхронізація on-chain

Economic Flow Inside MicroDAO:

DAAR → eMINT GOV/UTIL/REP → DAO Operations → UTIL Rewards → TokenBridge → DAAR

---

5. Ієрархія MicroDAO у DAARION.city

ДАЖЕСТВА МІСТА — ЦЕ ДЕРЕВО MICRODAO.

A1 — DAARION.city (перше MicroDAO)

• кореневе DAO міста
• очолюється агентом DAARWIZZ
• керує реєстрами, платформами, правами доступу

A2 — Міські платформи (другий рівень)

Платформи є MicroDAO другого порядку.

Поточний список:

• Helion — енергетика
• GreenFood ERP — агро/харчові продукти
• Soul — соціальна система
• Dario — міські сервіси
• Nutra — здоровʼя і нутриція
• WaterAGI — вода та очищення

Кожна платформа має власних агентів.

A3 — Публічні MicroDAO (третій рівень)

• не підпорядковуються платформам
• доступні для всіх резидентів
• можуть взаємодіяти з A1 та A2 через DAAR

A4/F4 — Приватні MicroDAO (четвертий рівень)

• повна автономія
• не мають підлеглості іншим DAO
• доступні лише за запрошенням

---

6. Логіка доступів на основі DAARION (Framework)

Більше DAARION = більше можливостей, зокрема:

• доступ до інституційних функцій
• доступ до створення платформ
• доступ до глибоких API
• доступ до керування DAO високого рівня
• більший пріоритет у DAGI

Це ядро формує модель: Civic Token → Access Tier → City Expansion.

---

7. Патерн розвитку токеноміки

Система спроектована так, що нові рівні доступу та права можуть додаватися з розвитком:

• запуск нових платформ
• нові типи агентів
• DAO-функції наступних фаз
• нові MetaDAO рівні

Токен DAARION — універсальний ключ для майбутньої інфраструктурної експансії.

---

8. Використання DAAR і DAARION у інтеграції MicroDAO

При підключенні MicroDAO до DAARION.city ця сторінка повинна бути додана у розділ:

docs/tokenomics/city-tokenomics.md

MicroDAO використовує ці правила для:

• валідації доступу користувачів
• роботи DAOFactory
• роботи агентів DAARWIZZ
• контролю доступу до платформ
• ліцензування сервісів

DAARION.city — це кореневе MicroDAO (A1), а вся міська екосистема — це дерево MicroDAO.

---

9. Інтеграція з іншими документами

Цей документ доповнює:

• DAARION_city_integration.md — архітектура інтеграції
• 50_daarion_city_website_integration.md — інтеграція з сайтом
• 32_policy_service_PDP_design.md — PDP token-gating
• 49_wallet_rwa_payouts_claims.md — Wallet Service

Примітка: Попередній документ tokenomics/README.md перенесено в docs/_archive/tokenomics_legacy_v0.md. Вся актуальна інформація об'єднана в цьому канонічному документі.

---

10. Завдання для Cursor

You are a senior blockchain/full-stack engineer. Implement City Tokenomics using:
- docs/tokenomics/city-tokenomics.md (⭐ CANONICAL)
- 32_policy_service_PDP_design.md
- 49_wallet_rwa_payouts_claims.md

Tasks:
1) Implement access tier validation (DAAR ≥ 1.00 or DAARION ≥ 0.01 for MicroDAO creation).
2) Implement platform creation access (DAARION ≥ 1.00 staked).
3) Implement vendor access (DAARION ≥ 0.01 staked).
4) Implement DAARION.city as A1-level MicroDAO (root DAO).
5) Implement platform hierarchy (A2-level: Helion, GreenFood, Soul, Dario, Nutra, WaterAGI).
6) Implement public MicroDAO (A3-level) and private MicroDAO (A4-level) access rules.
7) Integrate DAARWIZZ agent as system agent for A1-level.
8) Add DAAR/DAARION balance checks in PDP for all access levels.
9) Implement tier-based access logic (more DAARION = more capabilities).
10) Add platform licensing system (1 DAARION staked = platform creation right).

Output:
- list of modified files
- diff
- summary

---

11. Підсумок

• DAAR = універсальна енергія економіки
• DAARION = статус, рівні доступу, громадянство
• платформи належать рівню A2
• публічні MicroDAO — A3
• приватні MicroDAO — A4
• DAARION.city — перше, головне DAO (A1), центр усієї мережі

Це формує стійку багаторівневу архітектуру міста та екосистеми MicroDAO.

---

12. Fees & Costs (MicroDAO Economics)

City Fees (denominated in DAAR)

Action	Cost
Створення microDAO	1 DAAR
Емісія GOV	1 DAAR
Емісія UTIL	1 DAAR
Емісія REP	1 DAAR
Підключення агента DAGI	0.25 DAAR
Реєстрація DAO у каталозі міста	0.05 DAAR

90% DAO / 10% City Rule: Діє для DePIN-DAO та DAO, що працюють з постійною DAGI-активністю.

---

13. Staking & Rewards

DAAR Staking (APR: 20%)

• Rewards → DAAR
• Смартконтракт: APRStaking

DAARION Staking (APR: 4% + revenue share)

• Rewards → DAAR
• Частка від DAAR-комісій (0.5%) розподіляється пропорційно до стейку DAARION
• Смартконтракт: DAARDistributor

---

14. Token Bridges & Onboarding

Flow

USDT/POL → DAAR → DAARION → DAO → DAGI → Rewards in DAAR

Components

Component	Function
DAARsales	Купівля DAAR за USDT/POL
DAARIONsales	100 DAAR → 1 DAARION
DAOFactory	Створення MicroDAO
TokenBridge	UTIL ↔ DAAR обмін
DAGI Registry	Реєстрація DAO, агентів, знань

Primary Access Flow (Onboarding)

1. Balance Check — Wallet Agent перевіряє: ≥ 1 DAAR або ≥ 0.01 DAARION
2. Eligibility — eligible_for_MicroDAO = true
3. DAO Creation (DAOFactory) — списується 1 DAAR, DAO отримує унікальний dao_id
4. Token Activation — користувач може емітувати GOV / UTIL / REP (1 DAAR за кожен тип)
5. DAGI Sync — DAO реєструється у DAGI Registry

---

15. Integration Points (Architecture)

Wallet Service

• баланси DAAR / DAARION
• fee accounting (0.5%)
• DAOFactory calls
• staking
• token exchange

PDP (Access Control)

• наявність токенів
• права доступу до DAO
• gas-free стани
• DAO governance rules

Agents

Можуть:

• працювати з UTIL
• виконувати дії DAO
• розподіляти REP
• взаємодіяти з DAGI Registry

Не можуть:

• змінювати баланси DAAR/DAARION
• створювати DAO без користувача
• змінювати тарифні плани

DAGI Registry

• DAO metadata
• Agent slots
• Knowledge mining rewards
• Off-chain/on-chain settlement

---

16. Security Rules

• тільки Owner може виконувати DAOFactory
• DAAR/DAARION операції виконуються он-чейн
• UTIL/GOV/REP — off-chain з періодичною валідацією
• burn 5% DAARION при продажі — обов'язковий
• reentrancy guard
• мінімальна кількість GOV для голосування встановлюється DAO

---

17. MVP Scope (Required for Launch)

Must-have

• DAAR / DAARION баланс-чек
• DAOFactory (1 DAAR → create)
• eMINT GOV / UTIL / REP
• TokenBridge (UTIL ↔ DAAR)
• DAARsales, DAARIONsales
• Basic staking (DAAR, DAARION)
• PDP token-gating
• Wallet v1

Optional MVP+

• Knowledge Mining Rewards
• REP reputation logic
• Multi-DAO bridges

---

18. Changelog

v1.0.0 — 2024-11-14

• Початкова версія токеноміки міста
• Додано DAAR та DAARION токени
• Додано ієрархію MicroDAO (A1-A4)
• Додано рівні доступу
• Додано GOV/UTIL/REP токени для microDAO
• Додано DAOFactory та TokenBridge
• Додано staking та rewards
• Додано security rules

---

Версія: 1.0.0
Останнє оновлення: 2024-11-14
Документ готовий до інтеграції у Cursor, GitHub або будь-який інший проект.