# ENERGY UNION — DISTRICT PROTOCOL v1

DePIN • Energy Grid • Compute Grid • AI District of DAARION.city  
Version: 1.1  
Status: Active  
Lead Agent: Helion  
Energy Agent: Energia  

---

# 1. МЕТА ТА МІСІЯ

Energy Union — це інженерно-науковий District у DAARION.city, який об'єднує:

- децентралізовані енергетичні об'єкти (зелена генерація),
- децентралізовані обчислювальні модулі,
- автономні AI-лабораторії,
- climate-positive інфраструктуру.

Місія District:

- створення відновлюваної енергетично-обчислювальної мережі,
- підтримка наукових AI-комп'ютинг-процесів,
- формування DePIN-економіки участі,
- забезпечення міста DAARION багаторівневими ресурсами.

---

# 2. МОДЕЛЬ ПЛАТФОРМИ (DePIN + Energy + Compute)

## 2.1. Компоненти District

- **Energy Grid Layer**  
  Зелена генерація (BioMiner та інші установки), датчики, телеметрія.

- **Compute Layer**  
  Обчислювальні потужності різних учасників та AI-лабораторій.

- **DePIN Layer**  
  Фізичні ресурси, що належать учасникам і реєструються децентралізовано.

- **AI Compute Layer**  
  Три реальні лабораторії District:  
  - PhysMath1.0 — фізика/математика;  
  - Alatheia — аналіз знань;  
  - DAARQode — інженерія моделей.

- **Resource Sharing Layer**  
  Спільний доступ до енергетичних та обчислювальних ресурсів.

---

# 3. КЛЮЧОВІ СУБ'ЄКТИ

## 3.1 District Agents

### Helion (District Lead)

- маршрутизація запитів,
- реєстрація нод,
- контроль SLA та режимів.

### Energia (Energy Agent)

- обробка телеметрії від енергетичних вузлів,
- аналітика потужностей,
- координація енергетичних ресурсів.

## 3.2 Participants

- постачальники енергії (власники BioMiner або інших установок),
- оператори обчислювальних модулів,
- науково-дослідні групи,
- сервісні агенти District,
- користувачі AI-лабораторій.

---

# 4. ПРОДУКТИ ТА МОЖЛИВОСТІ DISTRICT

## 4.1 Energy Module

- облік енергії в одиницях **kWt**,
- енергопрофілі,
- telemetry stream від фізичних об'єктів.

## 4.2 Compute Module

- облік compute в одиницях **1T**,
- запуск AI-процесів у PhysMath1.0, Alatheia, DAARQode.

## 4.3 Climate Module

- **carbon+** — одиниця кліматичної ефективності.

## 4.4 Node Participation Module

- реєстрація фізичних енергетичних/compute-об'єктів,
- формування capability-профілю.

## 4.5 AI Operations Module

- планування обчислень,
- маршрутизація AI-лабораторій,
- аналіз навантаження.

---

# 5. DATA MODEL

| Entity | Опис |
|--------|-------|
| EnergyUnit | kWt одиниця енергії |
| ComputeUnit | 1T одиниця обчислень |
| CarbonUnit | climate-positive одиниця |
| Provider | учасник, що надає ресурс |
| Consumer | учасник, що отримує ресурс |
| Session | взаємодія учасника з сервісом |
| Allocation | виділення compute/energy |
| Job | AI/compute процес |
| ResourceProfile | потужності ноди |
| TelemetryRecord | телеметрія з пристрою |
| SLA | статус доступності |

---

# 6. НОДА У ENERGY UNION  

**(Загальний принцип — без вигаданих ID чи назв)**

Нода в Energy Union =  
**фізичний об'єкт (енергетичний або обчислювальний) + локальний комп'ютер ("мозок") + DAIS-агент + запис у таблиці `nodes`**.

## 6.1. Типи нод

- `energy` — енергетична установка з IoT-датчиками;  
- `compute` — обчислювальна станція;  
- `hybrid` — енергія + compute в одному місці;  
- `iot_gateway` — шлюз сенсорів.

## 6.2. Capability-профілі

- для energy: `{ max_kWt, sensors[], telemetry_mode }`
- для compute: `{ gpu_vram, cpu_cores, ram, storage }`

## 6.3. Правило реєстрації

> Нода з'являється в системі тільки після фактичного приєднання фізичного об'єкта через `/nodes/register`.

---

# 7. AI АГЕНТИ ENERGY UNION

## 7.1 AI Energy Scheduler

- оптимізація розподілу енергії,
- обробка kWt-профілів.

## 7.2 AI Compute Allocator

- розподіл compute-потужностей 1T,
- пріоритезація задач.

## 7.3 AI Load Balancer

- балансування навантажень,
- контроль SLA.

## 7.4 AI Monitoring Agent

- контроль телеметрії,
- anomaly detection.

## 7.5 AI Failure Recovery Agent

- реагування на інциденти,
- пропозиції сценаріїв перемикання.

## 7.6 AI Lab Router

- маршрутизація задач PhysMath1.0, Alatheia, DAARQode.

---

# 8. GOVERNANCE

## 8.1 Повноваження Helion

- управління всіма District-процесами,
- модерація Room Layer,
- участь у рішенні City Governance.

## 8.2 Права учасників

- членство через DAIS identity,
- доступ до District Rooms,
- можливість запускати compute/AI задачі.

## 8.3 Revocation

- ноди/агенти можуть бути відключені при порушенні протоколів.

---

# 9. ROOM SYSTEM

- `energyunion-lobby`
- `energyunion-news`
- `energyunion-help`
- `energyunion-telemetry`
- `energyunion-compute`
- `energyunion-labs`
- `energyunion-providers`
- `energyunion-governance`

---

# 10. DISTRICT MAP

Мапа містить **логічні зони** (без фізичних нод):

- Energy Zone  
- Compute Zone  
- Labs Zone  
- Providers Zone  
- Telemetry Zone  
- DAO Zone

Фізичні точки з'являються тільки після реальної реєстрації нод.

---

# 11. SECURITY & DAIS

- кожна нода має свій DAIS-агент,  
- всі операції підписуються DAIS-ключами,  
- повна історія в Audit Layer,  
- інциденти обробляються AI Recovery Agent.

---

# 12. CITY INTEGRATION

- портал у City Square,  
- публічні Rooms,  
- District-панель управління,  
- інтеграція з City Governance через Helion.

---

# 13. MVP SCOPE

## Входить до MVP:

- Реєстрація District ENERGYUNION
- Portal у City Square
- District Rooms (8 базових)
- Helion Agent (базова логіка)
- Energia Agent (телеметрія)
- Energy Module (kWt облік)
- Compute Module (1T облік)
- Node Participation (реєстрація)

## Не входить до MVP:

- Повна AI-оптимізація енергії
- ML-балансування навантажень
- Carbon+ токеноміка
- Автоматичний failover
- Multi-lab orchestration

---

# 14. Cross-References

- **DAARION_Ontology_Core_v1.md** — базова онтологія
- **District_Interface_Architecture_v1.md** — архітектура District UI
- **Agent_Governance_Protocol_v1.md** — права та ролі агентів
- **DAIS_Layer_Architecture_v1.md** — система ідентичності
- **Nodes_Interface_Architecture_UPDATE_v1.md** — модель нод

---

**Document Status:** ✅ Ready for Implementation