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)
40 lines
3.6 KiB
Markdown
40 lines
3.6 KiB
Markdown
# Черновой 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).
|