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,59 @@
# Архитектура ICE-NET
## Слои
```text
┌───────────────────────────────────────────────┐
│ APP: chat / images / files / service API │
├───────────────────────────────────────────────┤
│ SERVICE: 64-bit ID / ACL / end-to-end crypto │
├───────────────────────────────────────────────┤
│ DELIVERY: sessions / chunks / receipts / DTN │
├───────────────────────────────────────────────┤
│ NETWORK: Node ID / routing / rate limits │
├───────────────────────────────────────────────┤
│ ADAPTERS: UDP / LAN / Wi-Fi / serial / LoRa │
└───────────────────────────────────────────────┘
│
physical medium
```
Это логическая модель **проекта**; ни один слой не объявлен существующим стандартом.
## Control plane и data plane разделены логически
- **Control plane**: HELLO, объявление доступности сервиса, получение кратких метрик, route discovery и отзыв устаревшего маршрута. Он имеет бюджет *на каждом физическом интерфейсе*.
- **Data plane**: реальные сообщения/файлы; может использовать несколько быстрых каналов, не обязан следовать тем же маршрутами, что маленькие радиопакеты.
- **Переменная задержка**: если путь отсутствует, для отдельных сервисов применяется DTN/очередь; не притворяемся, что соединение постоянно.
## Типы узлов
| Тип | Обязанности | Доступные среды |
|---|---|---|
| Client | Отправка/приём, иногда транзит по согласию | телефон, ПК |
| Relay | Ограниченный forward по заданным политикам | дом, крыша, маршрутизатор |
| Gateway | Мост между физическими средами | LoRa ↔ Ethernet; Wi-Fi ↔ microwave |
| Store | Защищённая очередь отложенных данных | всегда включённый узел |
| Backbone | Быстрые устойчивые линии | оптика/кабель/направленное радио |
Могут сочетаться на одном устройстве. Никто не обязан хранить полную глобальную таблицу пользователей.
## Сценарий «отправить фото»
1. Телефон знает **Node ID** друга (например, из QR-кода/контактов), сервис `photo.inbox`.
2. Подключается к соседнему локальному узлу (Wi-Fi Aware, LAN, обычный интернет, когда есть).
3. Сеть оценивает наличие пути с достаточной пропускной способностью.
4. Медленный радиоканал может помочь объявить доступность или перенести небольшую управляющую запись, **но не файл**.
5. Файл разбивается на фрагменты, шифруется и уходит через быстрый путь. Посредники видят только необходимую им служебную информацию.
6. Если пути нет — приложение показывает `ожидает доставки` и TTL; пользователь сам решает, разрешить ли дорогой/медленный режим.
## Чего не делать
- Не flood'ить каждый поиск на всю планету.
- Не публиковать постоянный глобальный GPS узлов.
- Не разрешать любому пользователю загружать произвольные гигабайты в память чужого ретранслятора.
- Не считать «больше пути» автоматически «больше скорости». Нужно учитывать узкое место, перегрузку и стоимость передачи.
## Ближайшие родственные подходы
[Reticulum](../../sources/part1.md#s13) решает очень близкую задачу криптоидентичности и работы поверх разных сред. [Babel](../../sources/part1.md#s06) и [SCION](../../sources/part1.md#s20) дают другие ориентиры по маршрутам, [DTN/BPv7](../../sources/part1.md#s04) — по задержанной доставке. Не следует механически смешивать их wire-форматы без исследования совместимости.

View file

@ -0,0 +1,36 @@
# Требования и критерии готовности v0.1
> Все требования ниже — **предлагаемые**, ещё не согласованный стандарт. Их следует превратить в машинные тесты.
| ID | Требование | Проверка |
|---|---|---|
| R-01 | Логический Node ID не зависит от IP | Node ID одинаков после смены UDP-туннеля на локальный линк |
| R-02 | Нет обязательного сервера координации | Три изолированных Linux-узла могут обменяться сообщениями |
| R-03 | Транспорт сменный | Один API отправки поверх UDP, затем raw serial/test adapter |
| R-04 | Service ID шире 16 бит | Выбор идентификатора 77777, не попытка bind TCP:77777 |
| R-05 | Discovery не забивает канал | Верхний лимит доли пропускной способности на каждый интерфейс |
| R-06 | Фото не уходит через дальнее малоскоростное радио по умолчанию | Тест: запрет передачи payload > заданного размера на narrowband |
| R-07 | Неизвестный узел не получает доступ к приватному сервису | Тест deny-by-default |
| R-08 | Удаление ретранслятора не ломает идентичность | Повторный поиск маршрута и счётчик потерь |
| R-09 | У отсутствующего адресата допускается отложенная доставка | Пакет сохраняется до TTL и подтверждения |
| R-10 | Узел устойчив к флуду соседей | Rate limits, caps на память/CPU/очередь, timeout |
| R-11 | Ключи не передаются посредникам | Проверка протокола, threat review |
| R-12 | При отсутствии пути сообщаем правду | Состояния queued/no-route/expired, а не ложное «доставлено» |
| R-13 | Сбор данных о местоположении выключен по умолчанию | Проверка discovery-пакетов и конфигурации |
| R-14 | Протокол имеет версионирование | Неизвестные расширения корректно игнорируются/отклоняются |
| R-15 | Работа на ARM/x86 без GPU | Собираемый бинарник и бюджет ресурсов в тестах |
## Non-goals v0.1
- Глобальное покрытие на первом релизе.
- Безлимитная пропускная способность.
- Абсолютная анонимность по умолчанию.
- Модификация Linux kernel.
- Обход правовых ограничений радиоспектра.
- Массовый публичный запуск с непроверенной криптографией.
## Техническая проверка готовности
**Milestone M0:** детерминированная доставка текстового сообщения по 3 hops в симуляции, проверяемый trace. **M1:** две физически разные связи, автоматическое восстановление. **M2:** E2E-ключи и лимиты трафика. **M3:** тестирование третьими лицами.
См. [план испытаний](../../implementation/tests_metrics.md).

View file

@ -0,0 +1,33 @@
# Миссия и происхождение идеи
## Откуда взялась ICE-NET
Разговор начался с вопроса о 16-битных TCP/UDP-портах (0…65535) и возможности «порта 77777». Затем обсуждались собственный сетевой стек Linux/Arch, децентрализованная сеть из Cyberpunk, условная охранная система ICE, малые CPU-модели и независимость от глобального интернета.
Идея развивалась к двум связанным направлениям:
**1. Протокол без обязательной зависимости от IP:** свой адрес устройства, ID сервиса (хоть 64-битный), маршрутизация, доверие и обмен сообщениями поверх разных физических каналов. **2. Инфраструктура:** дальнее радио для малых объявлений/текста и быстрые маршруты через устройства, направленные антенны, локальную Wi-Fi mesh и, где есть, кабельные мосты.
Фантастика Cyberpunk вдохновила на название ICE и идею активного охранника соединений, но сюжетная механика Breach Protocol — не инженерная спецификация.
## Что проект должен приносить людям
- Локальные коммуникации, когда нет доступного интернета.
- Переписку и обмен файлами с возможностью задержанной доставки.
- Возможность самостоятельно развернуть узел и не зависеть от единого центрального сервера.
- Предсказуемое поведение на дешёвых маломощных машинах и возможность CPU-only защиты.
- Открытые интерфейсы, пригодные для проверки и независимой реализации.
## Правила проекта
**Открытость.** Протокол документируется независимо от конкретной реализации. **Интероперабельность.** Не зависит от одной ОС или бренда устройств. **Градация возможностей.** Медленный канал — не ошибка, а ограниченная опция. **Приватность.** Не публикуем глобальные карты людей. **Безопасность.** Защищаем свои ресурсы, не атакуем других. **Исследовательская честность.** Метрики доказываются экспериментом, а не красивой схемой.
## Небольшие точные цели вместо «всей планеты»
- P0: три узла в одной виртуальной сети, доставка сообщений и изменение маршрута.
- P1: два типа каналов с разной пропускной способностью, управление нагрузкой.
- P2: сквозное шифрование и разрешения для сервисов.
- P3: передача файла без использования медленного discovery-канала.
- P4: выход за пределы IP-переноса через физический последовательный/радиоинтерфейс.
Дальнейший путь см. [roadmap](../../implementation/roadmap.md).

View file

@ -0,0 +1,40 @@
# ADR: журнал архитектурных решений
Правило: изменение большого решения оформляем как новый ADR с мотивацией, альтернативами и критериями пересмотра.
## ADR-001: транспорт-независимые адреса (предложено)
**Решение:** Node ID = стабильный криптографический идентификатор, физический адрес = временный маршрут.
**Причина:** адрес должен работать при переходе с UDP на локальное радио.
**Риск:** метаданные и ротация ключей; см. [privacy](../../security/crypto_privacy.md).
## ADR-002: управление ≠ передача больших файлов (предложено)
**Решение:** discovery имеет минимальный общий интерфейс и строгие эфирные лимиты, а крупные payload допускаются только при наличии подходящего канала.
**Причина:** не забивать LoRa фотографиями.
**Исключение:** добровольная отложенная пересылка малых chunks при отсутствии альтернативы и явных квотах.
## ADR-003: CPU-only ICE Guard (предложено)
**Решение:** детерминированное ядро правил, FSM, счётчики, token bucket и маленькая классификация без обязательной нейросети.
**Причина:** работает на слабых процессорах и поддаётся аудиту.
**Риск:** ложные блокировки, data poisoning; см. [security](../../security/ice_engine.md).
## ADR-004: без форка ядра на MVP (принято для прототипа)
**Решение:** пользовательский процесс на Linux + сменные adapters.
**Причина:** меньшая цена эксперимента, легче тестировать и переносить.
## ADR-005: заимствуем принципы, а не копируем чужой протокол (принято для исследований)
**Решение:** сравнительный анализ Reticulum, DTN, Babel, libp2p и других; юридический аудит лицензий перед использованием кода.
**Причина:** безопасность и лицензионная чистота.
## ADR-006: нет активных атак «в ответ» (принято для модели безопасности)
**Решение:** ICE может локально прекратить обмен, уменьшить rate, потребовать повторную аутентификацию, изолировать ключ и сообщить владельцу, но не взламывает чужой узел.
## ADR-007: глобальное радио — цель, а не свойство MVP
**Решение:** первая версия гибридная, но каждый компонент может работать без центральной инфраструктуры там, где есть физическая связность.
## Открытые ADR
- Выбор длины Node ID: полный 256-битный ключевой hash vs сокращённые идентификаторы и риск коллизий.
- Дискавери: proactive annonces vs on-demand поиск, различная политика для LoRa/backhaul.
- Домашние relay по opt-in, лимиты энергии и доверия.
- Приватная адресная книга vs глобальный каталог сервисов.
- Фрагментация, окна подтверждений и разные TTL для разных типов данных.

View file

@ -0,0 +1,38 @@
# Риски и неприятные ограничения
## Физика / инфраструктура
| Риск | Почему важно | Защита от самообмана |
|---|---|---|
| Нет радиовидимости | Направленный мост не проходит через любые здания | Исследовать рельеф, высоту, зону Френеля и реальные измерения |
| Радиоэфир перегружен | Discovery не бесплатен: каждое объявление потребляет airtime | Жёсткий бюджет, периодичность, приоритеты |
| Узкое место | Один 1 кбит/с hop ограничивает всю передачу | Учитывать bottleneck; запрет больших payload |
| Нет электричества | Все ретрансляторы могут выключиться | Резерв питания там, где экономически оправданно |
| Разные частоты/нормы | Страны регулируют передатчики по-разному | Частотный план и консультация перед выходом в эфир |
| Неравномерная плотность | В городе пути есть, между городами — пустота | Backhaul, DTN и стратегические узлы |
## Протокол
- **Sybil/Eclipse**: ложные идентичности и поддельная «карта соседей» могут вытеснить честные маршруты.
- **Routing poisoning**: злоумышленник предлагает привлекательный путь, затем сбрасывает трафик.
- **Flooding**: каждый новый чужой Node ID вынуждает узлы тратить CPU/время эфира.
- **Metadata leakage**: повторяющийся стабильный идентификатор может позволить отслеживание даже при сильном шифровании.
- **Store-and-forward abuse**: чужие сообщения могут забить локальные диски.
- **Version fragmentation**: несовместимые версии провоцируют образование закрытых островов.
## Проект / команда
- Слишком рано писать своё всё (ядро, радиодрайвер, протокол, crypto, UI).
- Переоценка интереса сообщества без демонстрации кода или измерений.
- Сложная лицензия сторонних реализаций (особенно внимательно изучить предупреждения [Reticulum](../../sources/part1.md#s16)).
- Цена крыши/монтажа/страховки/электричества выше цены одного радиомодуля.
## Пять честных предпосылок
1. Глобальная география ≠ глобальная связность: сеть может быть набором островов.
2. Защищённая идентичность ≠ известное реальное имя и местонахождение.
3. «Сеть без IP» можно строить поверх IP при наличии интернета; это не противоречие.
4. Маршрутизаторы не обязаны понимать прикладное содержимое; политики доступа лучше проверять у конечного сервиса.
5. Новизна проекта — не в том, чтобы «открыть P2P», а в **проверяемом сочетании** низкоскоростного discovery, многосредной маршрутизации, ограничений ресурсов и UX при исчезновении связи.
Подробная [модель угроз](../../security/threat_model.md), [закон](../../radio/legal_spectrum.md), [метрики](../../implementation/tests_metrics.md).