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

3.5 KiB
Raw Permalink Blame History

Первые контракты и определения

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