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
36
docs/research/gaps.md
Normal file
36
docs/research/gaps.md
Normal 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.
|
||||
20
docs/research/licensing.md
Normal file
20
docs/research/licensing.md
Normal 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.
|
||||
29
docs/research/meshtastic.md
Normal file
29
docs/research/meshtastic.md
Normal 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
|
||||
31
docs/research/reticulum.md
Normal file
31
docs/research/reticulum.md
Normal 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-совместимость без тестов.
|
||||
Loading…
Add table
Add a link
Reference in a new issue