ICE-NET/docs/architecture/contracts.md
loki5512344 2e61688eb3
Some checks failed
rust-ci / checks (push) Has been cancelled
Initial import: ICE-NET research docs and Rust workspace (v0.4)
- 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)
2026-11-13 12:28:48 +01:00

44 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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