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

40 lines
3.6 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.

# Черновой 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](../../security/threat_model.md).