Initial import: ICE-NET research docs and Rust workspace (v0.4)
Some checks failed
rust-ci / checks (push) Has been cancelled
Some checks failed
rust-ci / checks (push) Has been cancelled
- Rust workspace: 7 library crates, icenetd CLI, icenet-city (Slint GUI) - Sim: fix false Delivered after a route cut, derive traffic class from payload size, per-link airtime slots (link capacity, queueing) - Docs: single docs/STATUS.md for all figures, remove v0.2/egui leftovers, drop unimplemented seed claims, uncheck store-and-forward - License: LGPL-3.0-or-later (LICENSE, LICENSES/GPL-3.0.txt)
This commit is contained in:
commit
2e61688eb3
141 changed files with 13993 additions and 0 deletions
46
archive/implementation/mvp_zero_budget.md
Normal file
46
archive/implementation/mvp_zero_budget.md
Normal file
|
|
@ -0,0 +1,46 @@
|
|||
# MVP без бюджета — Arch Linux, один ПК
|
||||
|
||||
## Цель первой версии
|
||||
|
||||
Сделать **один демон ICE-NET**, который запускает виртуальные NodeID, умеет передать зашифрованное маленькое сообщение по двум-трём hop и отказывается отправлять большой файл через slow-only маршрут. Не нужно модифицировать ядро Linux, создавать дистрибутив или покупать антенны.
|
||||
|
||||
## Приоритетные компоненты
|
||||
|
||||
```text
|
||||
icenetd
|
||||
identity/ generation, fingerprints, key storage
|
||||
protocols/ messages, versioning, serialization, parser tests
|
||||
routing/ neighbor table, weighted path, TTL, expiry
|
||||
transports/ loopback + UDP; later: serial/LoRa + LAN
|
||||
storage/ bounded queue / TTL / receipts
|
||||
ice_guard/ ACL, rate limit, replay, audit
|
||||
cli/ node, neighbors, send, routes, trace
|
||||
simulator/ topology, delay, loss, throughput, churn
|
||||
```
|
||||
|
||||
Предложение языка: **Rust** для mainline (типобезопасность и ARM/x86), с использованием существующих криптографических библиотек. C также возможен, но требует особенно строгой работы с памятью. Не привязываться к одному runtime на время проектирования спецификации.
|
||||
|
||||
## План на четыре небольшие вехи (без обещания дат)
|
||||
|
||||
### M0 — логическая пересылка
|
||||
Три виртуальных узла `A-B-C`. Узел A знает только B, но доставляет текст C. Проверить ACK конечного получателя, ограничение TTL и dedup.
|
||||
|
||||
### M1 — две среды
|
||||
`A-B` быстрый, `B-C` очень медленный. Симулировать 1 кбит/с; проверка, что короткий текст допускается, а фото не идёт автоматически.
|
||||
|
||||
### M2 — смена пути
|
||||
Добавить `A-D-C`. Отключить B, повторить. Проверить route invalidation, loss и очередь.
|
||||
|
||||
### M3 — E2E + ICE Guard
|
||||
Включить шифрование сообщений на endpoints, ACL сервисов, лимиты ресурсов, тест на поддельный пакет и spam flood.
|
||||
|
||||
## На чём испытывать
|
||||
|
||||
- Unix process + UDP loopback (для начала достаточно).
|
||||
- Linux network namespaces и veth для более реалистичного поведения ([S40](../sources/part2.md#s40)).
|
||||
- `tc netem` для задержки/потерь/скорости ([S41](../sources/part2.md#s41)).
|
||||
- CORE/ns-3, если нужен более точный сетевой/RF симулятор ([S43](../sources/part2.md#s43), [S42](../sources/part2.md#s42)).
|
||||
|
||||
## Готовность для первой публичной демонстрации
|
||||
|
||||
В README должны быть шаги запуска на чистой машине, ожидаемое поведение, команда теста, один trace с 3 hops, негативный тест с большим payload, чётко отмеченные несделанные функции и security disclaimer.
|
||||
37
archive/implementation/roadmap.md
Normal file
37
archive/implementation/roadmap.md
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
# Roadmap: от идеи до сообщества (без придуманных сроков)
|
||||
|
||||
## Фаза A — требования / prior art
|
||||
|
||||
**Выход:** 1-страничная архитектура, сравнительная таблица альтернатив, модель угроз, список критериев невозможности. **Проверка:** другой разработчик понимает границу control/data и может назвать главный риск.
|
||||
|
||||
## Фаза B — симулятор на одном ПК
|
||||
|
||||
**Выход:** 10–1000 виртуальных узлов, фиксированные сценарии, профили медленного/быстрого канала, трассировка. **Проверка:** воспроизводимый тест после обрыва связи и запрет фото по slow link.
|
||||
|
||||
## Фаза C — overlay MVP
|
||||
|
||||
**Выход:** userland daemon, NodeID+ServiceID, encrypted text, UDP/LAN adapters, ICE Core, краткий API. **Проверка:** три реальных процесса по разным сетевым namespace.
|
||||
|
||||
## Фаза D — интеграция и сравнение
|
||||
|
||||
**Выход:** интеграционные испытания с Reticulum/Meshtastic/AREDN как *сравниваемыми эталонами*, а не выдача их кода за собственный. **Проверка:** публичные CSV, графики и честные ограничения.
|
||||
|
||||
## Фаза E — физический low-cost pilot
|
||||
|
||||
**Выход:** два радиоустройства/стационарных relay, законная работа в разрешённом диапазоне, реальная оценка airtime и packet loss. **Проверка:** измеренный бюджет канала и работа текстовых сценариев.
|
||||
|
||||
## Фаза F — локальная mesh-инфраструктура
|
||||
|
||||
**Выход:** несколько независимых реле и минимум два пути; приложение на компьютере/телефоне; безопасное обновление ПО. **Проверка:** восстановление связи после отключения одного реле.
|
||||
|
||||
## Фаза G — магистральные мосты
|
||||
|
||||
**Выход:** разрешённые размещения на крышах, направленная линия, учёт бюджета оборудования, локальная кооперация. **Проверка:** многодневные реальные измерения качества и отказов, законность.
|
||||
|
||||
## Фаза H — федерация и стандарт
|
||||
|
||||
**Выход:** независимые реализации или хотя бы независимая проверка, документированный wire format, управление версиями, governance и security disclosure. **Проверка:** две команды могут реализовать совместимые узлы без доступа к внутренним данным друг друга.
|
||||
|
||||
## Не перескакивать
|
||||
|
||||
Ни публичные сборы на мачты, ни форк дистрибутива Linux, ни заявление о новой безопасной глобальной сети до успешных фаз B–D. В любой фазе можно закрыть риск или поменять архитектуру, не «сжигать» годы на предположениях.
|
||||
43
archive/implementation/simulation.md
Normal file
43
archive/implementation/simulation.md
Normal file
|
|
@ -0,0 +1,43 @@
|
|||
# Симуляция до покупки железа
|
||||
|
||||
## Зачем
|
||||
|
||||
На одном компьютере можно сравнить маршрутизацию, перегрузку и отказоустойчивость на сотнях узлов. Это не заменит физическое радио, но спасёт от нескольких месяцев разработки неверной идеи.
|
||||
|
||||
## Сценарии
|
||||
|
||||
| Сценарий | Топология | Что проверяем |
|
||||
|---|---|---|
|
||||
| A | 3 узла в цепочке | TTL, dedup, end-to-end ACK |
|
||||
| B | 15 узлов, несколько путей | выбор next hop и восстановление после потери relay |
|
||||
| C | 50 узлов, 1 кбит/с discovery | airtime, overhead, rate limits |
|
||||
| D | 100 узлов, mobile churn | stale routes, reconnect, path search p95 |
|
||||
| E | 1000 виртуальных узлов | RAM, CPU, таблицы, поток анонсов |
|
||||
| F | 2 disconnected islands | store-carry-forward и честный статус без пути |
|
||||
| G | 20% malicious peers | Sybil/flood/path poisoning, ложные блокировки |
|
||||
| H | fast/slow mixed | 5MiB photo не забивает control plane |
|
||||
|
||||
## Модель физического канала
|
||||
|
||||
Для каждого edge хранить `available`, `capacity_bps`, `loss_rate`, `latency_ms`, `jitter_ms`, `energy_cost` и `airtime_budget`. Измеренные параметры отделить от придуманной симуляции. Начать с условных параметров и честно обозначать их как **сценарные**, а не реальные свойства LoRa/5GHz.
|
||||
|
||||
## Бесплатные инструменты
|
||||
|
||||
- **Свой дискретно-событийный симулятор**: самый дешёвый старт; логика событий, узлов, queues, TTL.
|
||||
- **Linux namespaces**: настоящее сетевое ПО в изолированных сетевых окружениях ([S40](../sources/part2.md#s40)).
|
||||
- **tc-netem**: имитация потерь, задержек, reorder ([S41](../sources/part2.md#s41)).
|
||||
- **CORE**: графический и программный эмулятор сетей ([S43](../sources/part2.md#s43)).
|
||||
- **ns-3**: более детальное моделирование среды и радио ([S42](../sources/part2.md#s42)).
|
||||
- **Mininet**: простой быстрый стенд для логики сети ([S44](../sources/part2.md#s44)).
|
||||
- **GNU Radio**: физические waveform/модуляции в симуляции, без разрешений на передачу, если нет реального излучения ([S33](../sources/part2.md#s33)).
|
||||
|
||||
## Минимальный эксперимент без shell-команд root
|
||||
|
||||
Собрать приложение из процессов/задач с `VirtualLink` и фиксированным `random_seed`. При каждом тесте записывать CSV: `time,node,event,from,to,bytes,channel,reason`. Затем вычислять [метрики](tests_metrics.md). Публичный результат должен включать topologies и seed, иначе benchmark нельзя повторить.
|
||||
|
||||
## Два почти наверняка важных отрицательных результата
|
||||
|
||||
1. Глобальный broadcast новых IDs перегрузит общий LoRa-канал при росте сети.
|
||||
2. Aggressive learning ICE на нестационарных сетях будет ошибочно блокировать честных мобильных клиентов.
|
||||
|
||||
Оба тезиса — **гипотезы для проверки**, не измеренные результаты.
|
||||
47
archive/implementation/tests_metrics.md
Normal file
47
archive/implementation/tests_metrics.md
Normal file
|
|
@ -0,0 +1,47 @@
|
|||
# Метрики, протоколы испытаний и критерии фальсификации
|
||||
|
||||
## Что мерить
|
||||
|
||||
| Метрика | Единица | Зачем |
|
||||
|---|---|---|
|
||||
| Delivery ratio | % сообщений, дошедших до адресата | основная функция сети |
|
||||
| Time-to-first-route | p50/p95 секунд | discovery и routing |
|
||||
| Time-to-recover | p95 секунд | self-healing после отказа |
|
||||
| Control-plane airtime | % физического канала | предотвращение засорения LoRa |
|
||||
| Goodput | полезных бит/с | отличие от линковой скорости |
|
||||
| Bottleneck throughput | бит/с | видимость узкого hop |
|
||||
| Tail latency | p99 мс/с | редкие тяжёлые задержки |
|
||||
| CPU usage | % ядра / пакетов в секунду | слабые устройства |
|
||||
| RAM per 1000 peers | MiB | масштабируемость |
|
||||
| Storage per relay | MiB / TTL | злоупотребление DTN |
|
||||
| False positive blocking | % нормального трафика | ICE качество |
|
||||
| Metadata exposed | список полей / hop | приватность |
|
||||
| Energy budget | mWh / переданный MiB | мобильные узлы |
|
||||
|
||||
## Первые гипотезы
|
||||
|
||||
- **H1:** адаптивные объявления с rate cap сохраняют более низкий control-plane airtime, чем регулярный flood в тех же условиях.
|
||||
- **H2:** отделение пути DATA от discovery предотвращает переполнение медленного радио при передаче фото.
|
||||
- **H3:** path cache снижает число route queries, но увеличивает stale route errors.
|
||||
- **H4:** предельные политики ICE сохраняют RAM/CPU bounded при злонамеренном флуде.
|
||||
|
||||
Каждую проверять на одинаковом графе, seed, traffic pattern, времени работы и уровне потерь. Результаты должны включать отрицательные сценарии.
|
||||
|
||||
## Тестовые пакеты и fuzz
|
||||
|
||||
1. Неправильная длина пакета и неизвестные поля.
|
||||
2. Повторный MessageID.
|
||||
3. TTL=0, TTL переполнение, поддельные ACK.
|
||||
4. Большие фрагменты и неограниченная reassembly.
|
||||
5. Быстро меняющийся next hop.
|
||||
6. 1000 случайных NodeID от одного радиоисточника.
|
||||
7. Восстановление после отключения половины узлов.
|
||||
8. Локальный сервис закрыт для чужих ключей.
|
||||
|
||||
## Что означало бы провал концепции
|
||||
|
||||
Если после разумной оптимизации control traffic растёт быстрее полезной пропускной способности медленных каналов; если нет возможности валидировать доставку без массового слежения; если цена хранения/перенаправления не ограничивается; если реальная радиофизика не позволяет полезные маршруты для целевого сценария без неприемлемой инфраструктуры. Тогда надо изменить архитектуру, а не скрывать результаты.
|
||||
|
||||
## Как оформлять бенчмарк
|
||||
|
||||
Один Markdown-отчёт, таблица CSV/JSON (будущий репозиторий), дата и hardware, commit hash, конфигурация, seed, график, выводы, ограничения. Не публиковать заявления «в 100 раз лучше Reticulum» без честных сравнимых измерений.
|
||||
Loading…
Add table
Add a link
Reference in a new issue