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)
44 lines
3.5 KiB
Markdown
44 lines
3.5 KiB
Markdown
# Первые контракты и определения
|
||
|
||
## Какие 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 — только тестовый флаг,
|
||
**не криптографическая проверка**.
|