ICE-NET/archive/protocol/foundation/packet_wire_format.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.6 KiB
Raw Permalink Blame History

Черновой 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.