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).