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,37 @@
# Криптографическая идентичность и адресация
## Исходная проблема
IP — адрес интерфейса в сети с определённой моделью маршрутизации. В ICE-NET нужен логический ID, который переживает смену транспорта. **Это не «IP плохой»**: IPv6 уже имеет огромный адресный диапазон, а польза новой адресации — независимость от IP-плоскости, поддержка радиосвязи и идентичность по ключу, а не число портов.
## Предложенная модель
```text
node-id: ice1:Q7HW... (краткое человекочитаемое представление)
service: 77777 (логический ServiceID, uint64)
locator: local-wifi / serial-radio / udp-gateway / relay-next-hop
```
- Генерировать приватный ключ локально и хранить его защищённо.
- `NodeID` вычислять из открытого ключа стандартной функцией криптографического хеширования и схемой однозначного кодирования.
- `ServiceID` определять независимо от физического адреса; **приложение** решает, разрешён ли сервис на этом узле.
- Human readable alias (`friend@...`) — отдельно, с локальной книгой контактов и проверкой отпечатка.
## Запрос «кто ты?» и «где ты?» — разные вещи
Подпись challenge доказывает **владение ключом**, но не доказывает, что человек действительно друг и что устройство находится в заявленном городе. Для привязки к человеку нужен обмен отпечатками (QR-код, личное подтверждение) или модель доверия. Для расстояния нужны измерения RTT/RTT-радио, а не чтение NodeID. Подробнее: [Wi-Fi Aware RTT](../../sources/part1.md#s27).
## Приватность
Долгоживущий идентификатор в публичном beacon можно использовать для трекинга. Рассмотреть ротируемые announcement ID, псевдонимы локальных сервисов, короткий TTL, разделение идентичности и сетевого локатора. Нельзя назвать сеть «анонимной», пока не оценена утечка метаданных.
## Важные операции
- **Key rotation:** при замене ключа узел подписывает безопасное переназначение до компрометации; при компрометации нужна политика отзывов.
- **Lost keys:** восстановление ключей — отдельная пользовательская задача, централизованная «проверка паспорта» не требуется протоколу.
- **Collisions:** сокращённые адреса экономят эфир, но повышают риск совпадения; нужно хранить полный ID при аутентификации.
- **Key separation:** отдельные ключи аутентификации, шифрования и подписи сообщений в соответствии с выбранным криптографическим протоколом.
## Что читать
[HPKE RFC 9180](../../sources/part1.md#s08), [Noise](../../sources/part1.md#s26), [Reticulum ID](../../sources/part1.md#s14), [MLS](../../sources/part1.md#s07). Выбор конкретных алгоритмов — результат отдельного security review.

View file

@ -0,0 +1,40 @@
# Протокол: границы и жизненный цикл v0.1
> **Proposal:** ниже не RFC, а исходный скелет. Цель — удобство инженерного обсуждения, а не немедленная реализация совместимого стандарта.
## Что в сети считается адресом
- `NodeID` обозначает **идентичность конечного устройства**, а не физический радиоканал.
- `ServiceID` (пока предложено 64 бита) обозначает конкретное приложение/доступную функцию.
- `Locator` — локальные сведения о пути: Wi-Fi MAC, последовательный порт, UDP endpoint, следующий ретранслятор. Он может изменяться без изменения идентичности.
Невозможно создать реальный TCP/UDP порт 77777 без изменения wire format TCP/UDP; возможен **виртуальный сервис** с ID `77777` в собственном протоколе ([RFC 9293](../../sources/part1.md#s01)).
## Обязательные элементы протокола
1. `HELLO`: обнаружение соседа и его способностей (ограниченная локальная область).
2. `ANNOUNCE`: сообщение о достижимости NodeID/сервиса с ограниченным сроком действия.
3. `PATH_QUERY / PATH_REPLY`: поиск маршрута по запросу; rate limited.
4. `DATA`: зашифрованный пользовательский payload; metadata минимальна.
5. `ACK / STATUS`: доставка до получателя (не путать с подтверждением от одного ретранслятора).
6. `ERROR / QUOTA`: явный отказ, нет пути, закончился бюджет или TTL.
## Фазы отправки
```text
UNKNOWN → DISCOVERY → PATH CANDIDATE → POLICY CHECK
↘ NO PATH → QUEUED (if allowed)
POLICY CHECK → SEND CHUNKS → VERIFY → DELIVERED
↘ EXPIRED / FAILED
```
## Чего не стоит стандартизировать сразу
- Человекочитаемые имена: они удобны, но могут потребовать сложного распределённого резолвера.
- «Полную» унифицированную таблицу топологии.
- Самостоятельные новые криптографические операции.
- Одновременную поддержку всех радиопротоколов.
## Референсы
[Reticulum](../../sources/part1.md#s13), [Babel](../../sources/part1.md#s06), [DTN](../../sources/part1.md#s04), [libp2p](../../sources/part1.md#s21). См. детальную [адресацию](identities_addresses.md), [маршруты](../control/routing.md), [wire format](packet_wire_format.md).

View file

@ -0,0 +1,40 @@
# Черновой wire format (proposal; не для production)
Формат нужен, чтобы обсудить стоимость каждого байта. **Ниже иллюстративный формат без окончательно выбранных размеров и криптографических параметров.** Он намеренно не является готовой реализацией.
## Пример полей
| Поле | Предварительно | Назначение |
|---|---:|---|
| Version | 1 байт | Обратная совместимость |
| Type | 1 байт | HELLO / ANNOUNCE / DATA / ACK |
| Flags | 1 байт | Опциональные признаки |
| HopLimit | 1 байт | Снижение риска бесконечных петель |
| MessageID | 8–16 байт | Dedup; нужен анти-replay анализ |
| Src/Dst hint | переменно | Указатели без раскрытия полных ключей всегда |
| ServiceID | varint или 8 байт | Логический сервис, например 77777 |
| TTL / Expiry | переменно | Завершение жизни пакета |
| Payload | переменно | Зашифрованные данные/служебная нагрузка |
| Auth tag | по выбранному AEAD | Контроль целостности/подлинности |
## Приоритетная проблема — не экономия одного байта
Радиоканалу дорого стоит **каждая передача**, а особенно широковещательная. Сначала измерить частоту объявлений, длины пакетов, ограничения времени эфира и повторов, потом оптимизировать кодирование.
## Дополнения
- `HELLO` должен укладываться в бюджет discovery-адаптера; не раскрывать лишние имена и координаты.
- `DATA` не обязательно помещается в один пакет физического канала; нужна фрагментация, контроль памяти и защита от повторов.
- Уменьшение HopLimit на каждом переходе, проверка явных возрастных/TTL полей.
- Список расширений по TLV или другому парсибельному схематическому кодированию, обработка неизвестных обязательных полей.
- Все входные длины, смещения, переменные числа проверять до выделения памяти.
## Невыполненные задачи перед реализацией
1. Угрозы подделки/повторного воспроизведения сообщений.
2. Формат подписи и каноническое кодирование при нескольких языках программирования.
3. MTU по каждому адаптеру, фрагментация и сохранение replay-window при DTN.
4. Стратегия версии + downgrade protection.
5. Закреплённые test vectors и fuzzing сериализатора.
Протоколу нельзя давать обещания безопасности, пока он не прошёл независимый аудит. См. [threat model](../../security/threat_model.md).