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).
|
||||
40
archive/project/governance/decisions.md
Normal file
40
archive/project/governance/decisions.md
Normal 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 для разных типов данных.
|
||||
38
archive/project/governance/risks.md
Normal file
38
archive/project/governance/risks.md
Normal 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).
|
||||
Loading…
Add table
Add a link
Reference in a new issue