ваше сообщение коммита

This commit is contained in:
2025-08-08 23:40:13 +03:00
parent badb8b9557
commit a10810df55
19 changed files with 2599 additions and 898 deletions

View File

@@ -10,6 +10,18 @@
GitHub: https://github.com/HB3-ACCELERATOR
-->
# DLE v2 — краткие обновления
- SingleChain Governance: голосование фиксируется в одной сети, исполнение в целевых сетях по EIP712 подписям без внешних мостов.
- Снапшоты голосующей силы: `ERC20Votes` (`getPastVotes`, `getPastTotalSupply`) исключают перелив голосов.
- Делегирование «только на себя»: 1 токен = 1 голос, запрет делегирования третьим лицам.
- Модульность: казна, таймлок, деактивация, коммуникации выделены в отдельные модули, операции выполняются через ядро DLE.
- «100% или ничего»: много-сетевые операции исполняются только при готовности всех целевых сетей.
- Детерминированный деплой: `FactoryDeployer` + CREATE2 для одинаковых адресов во всех выбранных сетях; INIT_CODE_HASH рассчитывается автоматически из актуального initCode.
- Аналитика: добавлены viewфункции для сводок, пагинации и агрегирования по предложениям.
---
# DLE - Единый Смарт-Контракт с Модульной Архитектурой
## 🎯 ПОЛНОЕ ПОНИМАНИЕ ЗАДАЧИ DLE
@@ -51,12 +63,12 @@ DLE (Digital Legal Entity) = Универсальная цифровая юри
### **3. СИСТЕМА УПРАВЛЕНИЯ:**
#### **Голосование и мультиподпись:**
#### **Голосование токен‑холдеров:**
```
- Только токен-холдеры участвуют в управлении
- Каждый токен = одна голосующая сила
- Кворум настраиваемый (например, 60% от общего количества токенов)
- Мультиподпись через токен-холдеров (проверка баланса при каждой операции)
- Коллективное голосование токенхолдеров (ERC20Votes снапшоты)
```
#### **Создание предложений:**
@@ -101,7 +113,6 @@ DLE (Digital Legal Entity) = Универсальная цифровая юри
```
- ERC-20 токены
- Система голосования
- Мультиподпись
- Мультичейн синхронизация
- Управление модулями
- DLEInfo (юридическая информация)
@@ -141,7 +152,7 @@ DLE (Digital Legal Entity) = Универсальная цифровая юри
```
- Только токен-холдеры управляют
- Проверка баланса при каждой операции
- Кворум мультиподписей
- Кворум голосов - все решения через коллективное голосование
- Синхронизация между цепочками
```
@@ -174,7 +185,7 @@ DLE.sol (Основной контракт) + Модули (добавляемы
1. **Один основной контракт** - управление токенами, голосованием, мультиподписью
2. **Модули** - специализированные функции (казначейство, иерархическое голосование, коммуникации)
3. **Только токен-холдеры** - никаких админских ролей
4. **Кворум мультиподписей** - все решения через коллективное голосование
4. **Кворум голосов** - все решения через коллективное голосование
5. **Проверка баланса** - при каждой операции
---
@@ -190,7 +201,7 @@ DLE.sol
├── Выбор цепочки для кворума (governanceChainId)
├── Синхронизация голосов между цепочками
├── Поддержка множественных цепочек
├── Мультиподпись (через токен-холдеров)
├── Голосование токенхолдеров
├── Мультичейн синхронизация
└── Система модулей (добавление/управление)
```
@@ -216,7 +227,7 @@ DLE.sol
- **Выбор цепочки для кворума** - токен-холдер может выбрать любую поддерживаемую цепочку
- **Синхронизация голосов** - после голосования результаты синхронизируются между цепочками
- **Поддержка множественных цепочек** - Ethereum, Polygon, BSC и др.
- **Мультиподпись** - через токен-холдеров с проверкой баланса
- **Голосование** - через токенхолдеров с проверкой баланса
- **Мультичейн синхронизация** - одинаковый адрес во всех цепочках
- **Управление модулями** - добавление/удаление через голосование
@@ -241,14 +252,14 @@ DLE.sol
### 5. ExternalDLEModule.sol ✅
- **Меж-DLE взаимодействие** - управление DLE B через приложение DLE A
- **Встраивание интерфейсов** - безопасное управление
- **Проверка прав** - через мультиподпись
- **Проверка прав** - через голосование токен‑холдеров
- **Аудит действий** - отслеживание операций
### 6. Мульти-чейн архитектура ✅
- **CREATE2 деплой** - одинаковый адрес во всех цепочках
- **Синхронизация состояния** - токены, предложения, голосования
- **Создание предложений** - в любой цепочке
- **Голосование** - в любой цепочке с синхронизацией
- **Голосование** - через токен‑холдеров с проверкой баланса
---
@@ -257,7 +268,7 @@ DLE.sol
### Основные принципы безопасности:
1. **Только токен-холдеры** - никаких админских ролей
2. **Проверка баланса** - при каждой операции
3. **Кворум мультиподписей** - все решения коллективные
3. **Кворум голосов** - все решения коллективные
4. **Простая логика** - минимум уязвимостей
### Защита от атак:
@@ -503,13 +514,10 @@ function createProposal(
uint256 _governanceChainId
) external returns (uint256);
// Синхронизация голосов между цепочками
function syncVoteFromChain(
uint256 _proposalId,
uint256 _fromChainId,
uint256 _forVotes,
uint256 _againstVotes,
bytes memory _proof
// Исполнение в целевых сетях по EIP-712 подписям (без мостов)
function executeProposalBySignatures(
uint256 proposalId,
bytes[] calldata signatures
) external;
// Проверка поддерживаемых цепочек
@@ -517,29 +525,8 @@ function isChainSupported(uint256 _chainId) external view returns (bool);
```
### Синхронизация между цепочками
```solidity
// Синхронизация токенов
function syncTokenBalance(
address holder,
uint256 balance,
uint256 fromChainId
) external;
// Синхронизация предложений
function syncProposal(
uint256 proposalId,
Proposal memory proposal,
uint256 fromChainId
) external;
// Синхронизация голосов
function syncVote(
uint256 proposalId,
address voter,
bool support,
uint256 fromChainId
) external;
```
- Результаты голосования фиксируются снапшотами ERC20Votes в governanceсети.
- Целевые сети принимают исполнение при верификации EIP712 подписей холдеров и кворума на зафиксированном timepoint.
---
@@ -940,7 +927,7 @@ contract DLE is ERC20, ReentrancyGuard {
### ✅ Безопасность
- Никаких админских ролей
- Простая логика мультиподписи
- Простая логика коллективного голосования
- Защита от основных атак
- Прозрачность всех операций
@@ -962,7 +949,7 @@ contract DLE is ERC20, ReentrancyGuard {
**DLE - это единый смарт-контракт с модульной архитектурой, который:**
1. **Управляется только токен-холдерами** через кворум мультиподписей
1. **Управляется только токенхолдерами** через кворум голосов
2. **Проверяет баланс токенов** при каждой операции
3. **Использует модули** для специализированных функций
4. **Синхронизируется между цепочками** с одинаковым адресом