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,44 @@
# Первые контракты и определения
## Какие ID какие
- `NodeId` **реальной сети** в `icenet-core` пока представлен `u64` исключительно для каркаса. Это НЕ криптографическая идентичность!
- `SimNodeId` по сути тот же тестовый ID. В будущем: стабильный fingerprint публичного ключа и отдельный DeviceID.
- `ServiceId(u64)` — логический номер сервиса, не ОС-порт и не гарантия уникальности без схемы namespace.
- `LinkKind::{SlowRadio, FastWireless, Wired, Internet}` — профили симуляции, не протоколы передачи по воздуху.
## Классы
- `Control`: объявления/короткие служебные данные, минимальный payload.
- `Text`: малый payload (≤ 4096 Б), в исключительных случаях допустима передача по slow radio.
- `Bulk`: файлы/фото, `SlowRadio` запрещён независимо от скорости маршрута.
- Класс **выводится из размера**: `effective_for(bytes)` повышает Control > 256 Б до Text, Text > 4096 Б до
Bulk; `Bulk` не уменьшается. Метка отправителя не даёт доступа к slow radio.
## Маршрут
- `choose_path` возвращает последовательность NodeId, индексы использованных линков и приблизительную
задержку сериализации **без очереди**.
- Каждый переход проверяется на `enabled`, разрешённый класс, throughput > 0.
- Для сравнимости первые измерения: dijkstra с deterministic tie-break, затем baseline shortest hops.
- Нельзя автоматически считать `route_found` равным `delivered`.
- Линк несёт одну передачу за раз: время прибытия включает ожидание слота. `Delivered` ставится
только если маршрут (узлы, линки, класс) ещё пригоден на момент `tick`.
- У сообщения есть `created_ms`/`expires_ms`; истёкшее сообщение переходит в `Expired`
и не оживает. Прибытие не позже `expires_ms` считается доставкой.
- CSV/JSON экспорт детерминирован и не использует системные часы.
## Сетевой пакет (черновик)
`magic | version | class | service_id | payload_len | bytes`.
- Пример без криптографии, без anti-replay, без fragmentation.
- Отдельный парсер ограничивает длину входящих байтов и возвращает `Result`.
- В продакшене формат нужно будет изменить после threat modeling и test vectors.
## Результат безопасности
- `Permit`, `Deny(reason)`; без "strike back".
- `Deny` не расходует replay/rate state; `sequence` фиксируется только после `Permit`.
- Входной `authenticated: bool` в scaffold — только тестовый флаг,
**не криптографическая проверка**.