Initial import: ICE-NET research docs and Rust workspace (v0.4)
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:
Loki 2026-11-13 12:28:48 +01:00
commit 2e61688eb3
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
141 changed files with 13993 additions and 0 deletions

View file

@ -0,0 +1,40 @@
# Обнаружение узлов: экономный control plane
## Исходное предложение
Дальнобойное радио распространяет **не файл**, а короткие данные: «сосед доступен», «у меня есть путь», «этот ID видел недавно», «сервис возможен через меня». Стабильные ключи, полные списки контактов и GPS-позиции не должны публиковаться по умолчанию.
## Процедура
1. Узел слушает несколько каналов/адаптеров и строит таблицу **непосредственных соседей**.
2. Периодически с jitter отправляет редкое HELLO согласно airtime budget.
3. Транспортный узел анонсирует **ограниченный** набор направлений, а не всех клиентов мира.
4. При необходимости узел задаёт rate-limited запрос PATH_QUERY; ответы записываются в кеш со сроком годности.
5. При переполнении медленного канала служебные обновления сокращаются, объединяются или откладываются.
## Не путать «хеши» с маршрутизацией
Хеш ID подходит для ключа записи. Bloom filter может сказать «возможно есть такой ID в области», но:
- false positive -> ошибочный поиск;
- хеш не даёт права читать содержимое;
- глобальный индекс ID может компрометировать приватность;
- фильтры имеют параметры размера и ошибки; их распространение тоже стоит airtime.
Поэтому Bloom filters — **исследуемая опция** для агрегированного presence, не базовая истина проекта.
## Масштабирование
| Масштаб | Стратегия |
|---|---|
| Несколько узлов | прямая таблица соседей |
| Район | локальные агрегаты + route queries |
| Город | границы зон, ретрансляторы, приоритизация и кеш |
| Города | высокоскоростные backbone переходы или DTN |
| Глобально | разделённые домены управления и проверка стоимости служебного трафика |
У Reticulum есть подробная схема announces и ограничения полосы под них ([S14](../../sources/part1.md#s14)); Meshtastic управляет floods и использует next-hop для direct messages ([S17](../../sources/part1.md#s17)). Сначала сравнить их airtime и поведение при перемещении узлов.
## Измерения, без которых архитектура не обоснована
Control overhead (% полезной/доступной полосы), среднее число анонсов/узел/час, время поиска (p50/p95), отношение false-positive, степень устаревания маршрутов и раскрытие идентичности.

View file

@ -0,0 +1,52 @@
# Маршрутизация: как найти друга через тысячи устройств
## Требования
Маршрутизатор знает **своих соседей** и следующий переход для части адресов. Ему не нужен полный граф всей сети или «все люди в радиусе каждой вышки».
## Пример
```text
Дом A ─── Wi-Fi ─── R1 ══ радиомост ══ R2 ─── Wi-Fi ─── Дом B
│ │
LoRa LoRa
discovery discovery
```
Когда A отправляет фото B, LoRa может помочь обнаружению. Большой файл идёт A→R1→R2→B, **только если** есть реальные быстрые физические участки и они разрешены политиками.
## Метрики маршрута
Нельзя выбирать только по числу hops. Учитывать:
- оценку задержки и потерь;
- *минимальную* пропускную способность вдоль пути;
- airtime и фактическую занятость радио;
- стоимость энергии на мобильном устройстве;
- разрешение владельца relay, квоту/платный канал;
- надёжность/время последнего контакта;
- безопасность маршрута и историю отказов.
## Возможные направления реализации
**A. Проактивная маршрутизация (Babel/батманоподобная)** — хорошо для сравнительно связной локальной сети, есть регулярные обновления. [Babel RFC 8966](../../sources/part1.md#s06), [batman-adv](../../sources/part1.md#s23).
**B. On-demand / announce-based** — меньше постоянных сообщений при редких запросах. Изучать [Reticulum](../../sources/part1.md#s14).
**C. Content/destination discovery** — DHT через стабильные быстрые узлы (см. [libp2p](../../sources/part1.md#s21)); DHT не переносится бесплатно на узкополосное радио.
**D. DTN** — доставка при отсутствии одновременного пути ([RFC 9171](../../sources/part1.md#s04)).
## Гибридная гипотеза
- В пределах высокоскоростного района — поддерживаем соседские маршруты и метрики.
- Между районами — отдельные backbone-переходы и границы анонсирования.
- При отсутствии пути — store-carry-forward с TTL и квотами.
Это **пока не доказано**. Особая проблема — единая корректность при изменении путей между разными классами link'ов. Тестировать петли, route storms, malicious metrics и голодание медленных узлов.
## Failure behavior
- После смерти соседнего узла — route invalidation, backoff на перестроение.
- Для дублирующихся путей — осторожная multipath политика, не перемножать дубликаты бесконтрольно.
- `NO_ROUTE` — обычный статус.
- `QUEUED` ≠ `DELIVERED`. Только конечное подтверждение даёт `DELIVERED`.
Полезное новое: [RFC 10069 (2026)](../../sources/part1.md#s03) добавил управление несколькими путями **в QUIC**, но он не заменяет маршрутизатор ICE-NET.

View file

@ -0,0 +1,41 @@
# Транспорт и QoS: от нескольких байтов до фотографии
## Почему классификация трафика обязательна
Представим 5 MiB фото (≈41.9 млн бит). Даже идеальный канал **1 кбит/с** теоретически потребовал бы **≈11.7 часа**, без сетевых заголовков, повторов, пауз и правовых ограничений. Поэтому «через LoRa пойдёт, просто медленно» — опасная продуктовая установка; она забьёт общий эфир.
## Классы трафика (предложение)
| Класс | Пример | Политика |
|---|---|---|
| C0 | HELLO, route hints, ошибки | очень короткий payload, rate limit, высокий приоритет только в пределах квоты |
| C1 | SOS, короткое текстовое сообщение | допускается slow link по согласию, отдельная fair queue |
| C2 | обычный чат и подтверждения | высокий приоритет среди приложений, encryption |
| C3 | фото, файлы, обновления | **fast-links-only** по умолчанию, chunks + resume |
| C4 | потоковое видео/аудио | best-effort, без гарантий, только при подходящем непрерывном пути |
## Доставка файла
- Разбивать на ограниченные chunks, иметь идентификаторы фрагментов, integrity hash всего файла, окно выдачи и возобновление.
- Сжимать там, где экономия реальна (не предполагать, что JPEG сжимается ещё на порядок).
- Уважать лимиты памяти и диска каждого транзитного узла.
- Использовать congestion/flow control для каждой доступной среды, а не одну «скорость сети».
- Не делать многопутевую передачу доступной по умолчанию без контроля порядка и устойчивости.
## Предварительный scheduler
```text
if no_path: queue_or_fail()
elif file_size > MAX_SLOW_PAYLOAD and path.bottleneck < FAST_THRESHOLD:
offer_deferred_delivery()
else:
send_chunks_with_rate_limit()
```
Порог выбирается экспериментом. Идентичность узла/сервиса и разрешения проверяются **до** доступа к ресурсоёмкому приложению.
## Сравнить с реальными технологиями
- [QUIC RFC 9000](../../sources/part1.md#s02): streams, смена пути, congestion control.
- [Multipath QUIC RFC 10069](../../sources/part1.md#s03): несколько путей при одном соединении, новый стандарт 2026; не автоматически пригоден для каждого LoRa линка.
- [LoRaWAN ограничения](../../sources/part2.md#s31): хороший пример, почему канал малых пакетов нельзя продавать как видеосеть.