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

36
docs/research/gaps.md Normal file
View file

@ -0,0 +1,36 @@
# ICE-NET vs существующие стеки — гипотеза уникальной ценности
## Что НЕ уникально
- Не-IP идентификаторы, криптография, announce routing, transport-agnostic mesh;
всё это уже реализовано в Reticulum и смежных проектах.
- Узкополосная LoRa discovery и next-hop маршрутизация представлены в Meshtastic.
- Статические радио-мосты, Wi-Fi mesh, store-and-forward и DTN не новые технологии.
## Предлагаемая *исследовательская* функция
**Constrained Path Policy Engine (CPPE)** — единая проверяемая политика,
которая запрещает большой полезный трафик на slow-control интерфейсах,
сопоставляет классы сообщений с возможностями канала, допускает очереди при
partition и измеряет цену служебного discovery в airtime.
Это **не заявка на новизну**: ближайшие системы уже обладают частью этих функций;
эффект или удобство реализации должны быть доказаны экспериментами.
## Проверяемые гипотезы
- H1: bulk traffic не занимает slow-radio airtime при любом графе.
- H2: короткий текст достигает адресата, когда slow radio — единственный маршрут,
при условии допустимой загрузки канала.
- H3: смена link профилей/падение узла не создаёт ложного `DELIVERED`.
- H4: контрольный airtime и время поиска не растут неприемлемо при 100→1000 узлах.
## Baselines
1. Наивный shortest-hop.
2. Dijkstra по длине передачи/требуемому bitrate.
3. Reticulum с включёнными встроенными ограничениями/настройкой интерфейсов.
4. Meshtastic (узкая полоса, отдельный кейс, без попытки bulk).
Если не обнаружено измеримого преимущества или недостающего рабочего сценария:
не писать весь свой протокол, а сделать policy adapter / contribution.

View file

@ -0,0 +1,20 @@
# Правила лицензий и заимствований
- Нельзя копировать исходники Reticulum, считая их MIT или Apache: его лицензия
содержит специфические ограничения. См. [полный текст](https://github.com/markqvist/Reticulum/blob/master/LICENSE).
- Reticulum является полезным независимым проектом; это исследование **не** заявляет его несовместимым с любой иной лицензией без юридической проверки.
- Meshtastic firmware официально GPL-3.0: проверять условия распространения производных работ.
- Slint и другие Rust зависимости сверять по версиям, NOTICE и SPDX;
нельзя механически приписывать всем crates одну лицензию.
- Наша документация написана заново, исходники сторонних проектов в ZIP **не вложены**.
- Лицензия собственного кода: **LGPL-3.0-or-later** (решение автора, ADR-010). Код с несовместимой
лицензией (в том числе нестандартной лицензии Reticulum) в ICE-NET не копировать.
- LGPL и статическая линковка Rust: получатель бинарника должен иметь возможность пересобрать его с
изменённой библиотекой. Юридически не проверялось.
- Не использовать чужие эмблемы/названия так, будто проект официально поддержан.
## Рекомендация
На старте: изучение документации, самостоятельная реализация демонстрационного
графового алгоритма, инструментальные сравнительные тесты. Кодовые зависимости
выбирать после review лицензий и security advisories.

View file

@ -0,0 +1,29 @@
# Meshtastic: как устроена дальняя текстовая mesh-сеть
**Источник:** [официальный mesh algorithm](https://meshtastic.org/docs/overview/mesh-algo/).
- Фокус: LoRa, текст, телеметрия и локальные сообщения без сотовой инфраструктуры.
- В `2.6+` broadcast использует управляемое flooding; direct-message после
обнаружения направления может использовать next-hop, затем откатиться к flooding.
- Используется Protocol Buffers (`MeshPacket`).
- У Meshtastic есть реальные ограничения bandwidth, airtime и батареи.
- **Он не является транспортом больших фото и не совместим с Reticulum по пакету.**
## Что перенять
1. Безусловный лимит на размер/частоту широковещательных объявлений.
2. Разделение broadcast и directed routing.
3. Корректный ACK/дедуп и hop limit.
4. Реальные правила эфира региона до включения радиоплаты.
## Статус релизов
GitHub Releases в ноябре 2026 показывает **2.7.x Beta и 2.8.x Alpha**, часть
alpha помечена `Revoked`. Не устанавливать «latest» вслепую; выбирать
стабильный релиз, проверять совместимость и регион. [Список релизов](https://github.com/meshtastic/firmware/releases).
## Лицензии
Meshtastic — группа репозиториев с разными лицензиями; официальный firmware
указан как **GPL-3.0**. Перед переносом кода проверять конкретный репозиторий,
а не название экосистемы целиком: https://github.com/meshtastic

View file

@ -0,0 +1,31 @@
# Reticulum: что уже готово и чему учиться
**Источник:** [официальный manual](https://reticulum.network/manual/) (на 12.11.2026 отображается 1.6.0).
| Функция | Состояние у Reticulum | Вывод для ICE-NET |
|---|---|---|
| Не-IP идентичности | Есть, cryptographic addressing | не заявлять новизну |
| Multi-hop через разные среды | Есть | копировать идею, НЕ исходный код |
| Announce/path discovery | Есть | проверить baseline и стоимость пакетов |
| Interface discovery | Есть, включая private/encrypted announcements | большой пробел прежнего досье |
| QoS обычного трафика | В manual: обычные данные FIFO, без классов приоритета | возможная область исследований, не доказанное преимущество |
| Announce throttling / queue tuning | Есть | нельзя утверждать «нет контроля радиоэфира» |
| Передача файлов | Есть (`rncp`, Resources) | не изобретать ради галочки |
## Что тестировать руками
1. Две изолированные инстанции на localhost/UDP и transport node.
2. Смена интерфейса во время доступного маршрута.
3. Нагрузка на slow link: объявление + большой файл; измерить фактическое поведение.
4. Сверить с ограничениями Reticulum на rate, announce priority и interface modes.
5. Зафиксировать объективный пробел, а не предполагать его по обзору.
## Осторожно с лицензией!
[Reticulum License](https://github.com/markqvist/Reticulum/blob/master/LICENSE) — **нестандартная**;
включает дополнительные ограничения, включая запрет некоторых вредоносных
применений и использования кода для AI/ML training dataset. Её нельзя
автоматически считать MIT/Apache-2.0 или стандартной OSI-лицензией.
Изучать по документации можно; переносить код в ICE-NET без юридического
анализа нельзя. Официальный GitHub предупреждает о сторонних недостоверных
«совместимых» реализациях. Не объявлять wire-совместимость без тестов.