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
59
archive/project/foundation/architecture.md
Normal file
59
archive/project/foundation/architecture.md
Normal 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-форматы без исследования совместимости.
|
||||
36
archive/project/foundation/requirements.md
Normal file
36
archive/project/foundation/requirements.md
Normal 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).
|
||||
33
archive/project/foundation/vision.md
Normal file
33
archive/project/foundation/vision.md
Normal 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).
|
||||
Loading…
Add table
Add a link
Reference in a new issue