stadium-proto/KLDR RESERVED KEYS.md

58 lines
2.9 KiB
Markdown
Raw Normal View History

2023-07-08 04:39:56 +03:00
# Список зарезервированных ключей ячеек
<!-- TODO: сделать папку и там разместить подробное описание некоторых ключей -->
Перечисленные здесь значения являются либо совсем базовыми, либо предназначены для использования сервером. Все данные транзитных пакетов (т.е. тех, которые предназначены для кого-то кроме подключённого напрямую серверу), для которых критична подлинность, должны передаваться в ячейке `Data` и быть подписанными с помощью ячейки `SignedDataHash`.
2023-07-08 04:39:56 +03:00
2023-07-08 04:39:56 +03:00
## Базовые примитивы
- Data
- _Значение:_ `0x01`
- _Тип:_ не имеет значения
2023-07-08 04:39:56 +03:00
- Основные передаваемые данные.
- ObjectID
- _Значение:_ `0x02`
- _Тип:_ `LocID || GlobID`
2023-07-08 04:39:56 +03:00
- ID объекта в локальном контексте. Например, ID канала для отправки сообщения.
- SrcEventAuthor
2023-07-08 04:39:56 +03:00
- _Значение:_ `0x03`
- _Тип:_ `GlobID`
- Источник (автор) оригинального события.
2023-07-08 04:39:56 +03:00
- PrevEvent
- _Значение:_ `0x04`
- _Тип:_ `LocID`
2023-07-08 04:39:56 +03:00
- Предыдущее событие, логически связанное с текущим.
- NextEvent
- _Значение:_ `0x05`
- _Тип:_ `LocID`
2023-07-08 04:39:56 +03:00
- Следующее событие, логически связанное с текущим.
- BatchNumber
- _Значение:_ `0x06`
- _Тип:_ `uint32_t`
- Последовательный номер события в цепочке.
- Path
- _Значение:_ `0x07`
- _Тип:_ `char[]`
- Название загружаемого/запрашиваемого файла или URL.
- Power
- _Значение:_ `0x08`
- _Тип:_ `Power`
- Права доступа к конкретному объекту.
2023-07-08 04:39:56 +03:00
## Криптография
- CryptoAlgos
2023-07-08 04:39:56 +03:00
- _Значение:_ `0x11`
- _Тип:_ `CryptoAlgo[3]`
- Используемые криптографические алгоритмы. Первый элемент выделен под хэш-функцию; второй элемент для ассиметричной функции; третий элемент для симметричной функции.
2023-07-08 04:39:56 +03:00
- CryptoKeyID
- _Значение:_ `0x12`
- _Тип:_ `uint32_t`
- Идентификатор используемого криптографического ключа для шифрования данных.
- SignedDataHash
- _Значение:_ `0x13`
- _Тип:_ не имеет значения
- Хэш основных передаваемых данных, зашифрованный закрытым ключом отправителя.