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
40
archive/protocol/control/discovery_control_plane.md
Normal file
40
archive/protocol/control/discovery_control_plane.md
Normal 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, степень устаревания маршрутов и раскрытие идентичности.
|
||||
52
archive/protocol/control/routing.md
Normal file
52
archive/protocol/control/routing.md
Normal 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.
|
||||
41
archive/protocol/control/transport_qos.md
Normal file
41
archive/protocol/control/transport_qos.md
Normal 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): хороший пример, почему канал малых пакетов нельзя продавать как видеосеть.
|
||||
37
archive/protocol/foundation/identities_addresses.md
Normal file
37
archive/protocol/foundation/identities_addresses.md
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
# Криптографическая идентичность и адресация
|
||||
|
||||
## Исходная проблема
|
||||
|
||||
IP — адрес интерфейса в сети с определённой моделью маршрутизации. В ICE-NET нужен логический ID, который переживает смену транспорта. **Это не «IP плохой»**: IPv6 уже имеет огромный адресный диапазон, а польза новой адресации — независимость от IP-плоскости, поддержка радиосвязи и идентичность по ключу, а не число портов.
|
||||
|
||||
## Предложенная модель
|
||||
|
||||
```text
|
||||
node-id: ice1:Q7HW... (краткое человекочитаемое представление)
|
||||
service: 77777 (логический ServiceID, uint64)
|
||||
locator: local-wifi / serial-radio / udp-gateway / relay-next-hop
|
||||
```
|
||||
|
||||
- Генерировать приватный ключ локально и хранить его защищённо.
|
||||
- `NodeID` вычислять из открытого ключа стандартной функцией криптографического хеширования и схемой однозначного кодирования.
|
||||
- `ServiceID` определять независимо от физического адреса; **приложение** решает, разрешён ли сервис на этом узле.
|
||||
- Human readable alias (`friend@...`) — отдельно, с локальной книгой контактов и проверкой отпечатка.
|
||||
|
||||
## Запрос «кто ты?» и «где ты?» — разные вещи
|
||||
|
||||
Подпись challenge доказывает **владение ключом**, но не доказывает, что человек действительно друг и что устройство находится в заявленном городе. Для привязки к человеку нужен обмен отпечатками (QR-код, личное подтверждение) или модель доверия. Для расстояния нужны измерения RTT/RTT-радио, а не чтение NodeID. Подробнее: [Wi-Fi Aware RTT](../../sources/part1.md#s27).
|
||||
|
||||
## Приватность
|
||||
|
||||
Долгоживущий идентификатор в публичном beacon можно использовать для трекинга. Рассмотреть ротируемые announcement ID, псевдонимы локальных сервисов, короткий TTL, разделение идентичности и сетевого локатора. Нельзя назвать сеть «анонимной», пока не оценена утечка метаданных.
|
||||
|
||||
## Важные операции
|
||||
|
||||
- **Key rotation:** при замене ключа узел подписывает безопасное переназначение до компрометации; при компрометации нужна политика отзывов.
|
||||
- **Lost keys:** восстановление ключей — отдельная пользовательская задача, централизованная «проверка паспорта» не требуется протоколу.
|
||||
- **Collisions:** сокращённые адреса экономят эфир, но повышают риск совпадения; нужно хранить полный ID при аутентификации.
|
||||
- **Key separation:** отдельные ключи аутентификации, шифрования и подписи сообщений в соответствии с выбранным криптографическим протоколом.
|
||||
|
||||
## Что читать
|
||||
|
||||
[HPKE RFC 9180](../../sources/part1.md#s08), [Noise](../../sources/part1.md#s26), [Reticulum ID](../../sources/part1.md#s14), [MLS](../../sources/part1.md#s07). Выбор конкретных алгоритмов — результат отдельного security review.
|
||||
40
archive/protocol/foundation/overview.md
Normal file
40
archive/protocol/foundation/overview.md
Normal file
|
|
@ -0,0 +1,40 @@
|
|||
# Протокол: границы и жизненный цикл v0.1
|
||||
|
||||
> **Proposal:** ниже не RFC, а исходный скелет. Цель — удобство инженерного обсуждения, а не немедленная реализация совместимого стандарта.
|
||||
|
||||
## Что в сети считается адресом
|
||||
|
||||
- `NodeID` обозначает **идентичность конечного устройства**, а не физический радиоканал.
|
||||
- `ServiceID` (пока предложено 64 бита) обозначает конкретное приложение/доступную функцию.
|
||||
- `Locator` — локальные сведения о пути: Wi-Fi MAC, последовательный порт, UDP endpoint, следующий ретранслятор. Он может изменяться без изменения идентичности.
|
||||
|
||||
Невозможно создать реальный TCP/UDP порт 77777 без изменения wire format TCP/UDP; возможен **виртуальный сервис** с ID `77777` в собственном протоколе ([RFC 9293](../../sources/part1.md#s01)).
|
||||
|
||||
## Обязательные элементы протокола
|
||||
|
||||
1. `HELLO`: обнаружение соседа и его способностей (ограниченная локальная область).
|
||||
2. `ANNOUNCE`: сообщение о достижимости NodeID/сервиса с ограниченным сроком действия.
|
||||
3. `PATH_QUERY / PATH_REPLY`: поиск маршрута по запросу; rate limited.
|
||||
4. `DATA`: зашифрованный пользовательский payload; metadata минимальна.
|
||||
5. `ACK / STATUS`: доставка до получателя (не путать с подтверждением от одного ретранслятора).
|
||||
6. `ERROR / QUOTA`: явный отказ, нет пути, закончился бюджет или TTL.
|
||||
|
||||
## Фазы отправки
|
||||
|
||||
```text
|
||||
UNKNOWN → DISCOVERY → PATH CANDIDATE → POLICY CHECK
|
||||
↘ NO PATH → QUEUED (if allowed)
|
||||
POLICY CHECK → SEND CHUNKS → VERIFY → DELIVERED
|
||||
↘ EXPIRED / FAILED
|
||||
```
|
||||
|
||||
## Чего не стоит стандартизировать сразу
|
||||
|
||||
- Человекочитаемые имена: они удобны, но могут потребовать сложного распределённого резолвера.
|
||||
- «Полную» унифицированную таблицу топологии.
|
||||
- Самостоятельные новые криптографические операции.
|
||||
- Одновременную поддержку всех радиопротоколов.
|
||||
|
||||
## Референсы
|
||||
|
||||
[Reticulum](../../sources/part1.md#s13), [Babel](../../sources/part1.md#s06), [DTN](../../sources/part1.md#s04), [libp2p](../../sources/part1.md#s21). См. детальную [адресацию](identities_addresses.md), [маршруты](../control/routing.md), [wire format](packet_wire_format.md).
|
||||
40
archive/protocol/foundation/packet_wire_format.md
Normal file
40
archive/protocol/foundation/packet_wire_format.md
Normal file
|
|
@ -0,0 +1,40 @@
|
|||
# Черновой wire format (proposal; не для production)
|
||||
|
||||
Формат нужен, чтобы обсудить стоимость каждого байта. **Ниже иллюстративный формат без окончательно выбранных размеров и криптографических параметров.** Он намеренно не является готовой реализацией.
|
||||
|
||||
## Пример полей
|
||||
|
||||
| Поле | Предварительно | Назначение |
|
||||
|---|---:|---|
|
||||
| Version | 1 байт | Обратная совместимость |
|
||||
| Type | 1 байт | HELLO / ANNOUNCE / DATA / ACK |
|
||||
| Flags | 1 байт | Опциональные признаки |
|
||||
| HopLimit | 1 байт | Снижение риска бесконечных петель |
|
||||
| MessageID | 8–16 байт | Dedup; нужен анти-replay анализ |
|
||||
| Src/Dst hint | переменно | Указатели без раскрытия полных ключей всегда |
|
||||
| ServiceID | varint или 8 байт | Логический сервис, например 77777 |
|
||||
| TTL / Expiry | переменно | Завершение жизни пакета |
|
||||
| Payload | переменно | Зашифрованные данные/служебная нагрузка |
|
||||
| Auth tag | по выбранному AEAD | Контроль целостности/подлинности |
|
||||
|
||||
## Приоритетная проблема — не экономия одного байта
|
||||
|
||||
Радиоканалу дорого стоит **каждая передача**, а особенно широковещательная. Сначала измерить частоту объявлений, длины пакетов, ограничения времени эфира и повторов, потом оптимизировать кодирование.
|
||||
|
||||
## Дополнения
|
||||
|
||||
- `HELLO` должен укладываться в бюджет discovery-адаптера; не раскрывать лишние имена и координаты.
|
||||
- `DATA` не обязательно помещается в один пакет физического канала; нужна фрагментация, контроль памяти и защита от повторов.
|
||||
- Уменьшение HopLimit на каждом переходе, проверка явных возрастных/TTL полей.
|
||||
- Список расширений по TLV или другому парсибельному схематическому кодированию, обработка неизвестных обязательных полей.
|
||||
- Все входные длины, смещения, переменные числа проверять до выделения памяти.
|
||||
|
||||
## Невыполненные задачи перед реализацией
|
||||
|
||||
1. Угрозы подделки/повторного воспроизведения сообщений.
|
||||
2. Формат подписи и каноническое кодирование при нескольких языках программирования.
|
||||
3. MTU по каждому адаптеру, фрагментация и сохранение replay-window при DTN.
|
||||
4. Стратегия версии + downgrade protection.
|
||||
5. Закреплённые test vectors и fuzzing сериализатора.
|
||||
|
||||
Протоколу нельзя давать обещания безопасности, пока он не прошёл независимый аудит. См. [threat model](../../security/threat_model.md).
|
||||
29
archive/protocol/store/storage_dtn.md
Normal file
29
archive/protocol/store/storage_dtn.md
Normal file
|
|
@ -0,0 +1,29 @@
|
|||
# Когда связь прерывается: DTN / store-carry-forward
|
||||
|
||||
## Сценарий
|
||||
|
||||
Деревня без постоянного радио-моста. Сообщение для друга помещается в зашифрованную локальную очередь, а когда появляется доступный узел (машина/рюкзак/вышка/временный gateway), копия переправляется. Получатель может получить данные через часы. Это **задержанная доставка**, не live-соединение.
|
||||
|
||||
## Очередь должна иметь правила
|
||||
|
||||
- Storage quota по пользователю/узлу/сервису.
|
||||
- TTL/expiry для каждого сообщения.
|
||||
- Отдельно квитанция о приёме relay и о доставке адресату.
|
||||
- Content ciphertext + минимум метаданных.
|
||||
- Удаление старых сообщений по прозрачной политике, а не бесконечный диск.
|
||||
- Предотвращение replay, копирования одних и тех же bundle и намеренного засорения памяти.
|
||||
- Не обещать доставку, если пути не возникает ни разу.
|
||||
|
||||
## Три модели
|
||||
|
||||
1. **Store-and-forward при активном пути** — краткая очередь между соседними hops.
|
||||
2. **Store-carry-forward (DTN)** — нет end-to-end пути, relay переносит зашифрованный пакет физически или ждёт появления линка.
|
||||
3. **Scheduled contacts** — известные окна доступности, например периодический мост; требует календаря доступности и реального измерения.
|
||||
|
||||
## Инженерные источники
|
||||
|
||||
[BPv7 RFC 9171](../../sources/part1.md#s04) уже формализует передачу через проблемные сети. [BPSec RFC 9172](../../sources/part1.md#s05) прямо обсуждает защиту хранения, ограниченность ресурсов и отсутствие непрерывного доступа к авторитетному серверу. В 2026 IETF продолжает работу над [обнаружением и управлением в DTN](../../sources/part1.md#s12), но эти новые документы — **drafts**, пока не стандарт.
|
||||
|
||||
## UX
|
||||
|
||||
Показывать пользователю `отправлено с моего устройства`, `передано следующему узлу`, `доставлено конечному`, `истекло`. Никогда не называть первую стадию финальной доставкой.
|
||||
Loading…
Add table
Add a link
Reference in a new issue