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