stadium-proto/KLDR RESERVED KEYS.md

# Список зарезервированных ключей ячеек

<!-- TODO: сделать папку и там разместить подробное описание некоторых ключей -->
Перечисленные здесь значения являются либо совсем базовыми, либо предназначены для использования сервером. Все данные транзитных пакетов (т.е. тех, которые предназначены для кого-то кроме подключённого напрямую серверу), для которых критична подлинность, должны передаваться в ячейке `Data` и быть подписанными с помощью ячейки `SignedDataHash`.


## Базовые примитивы

- Data
	- _Значение:_ `0x01`
	- _Тип:_ не имеет значения
	- Основные передаваемые данные.
- ObjectID
	- _Значение:_ `0x02`
	- _Тип:_ `LocID || GlobID`
	- ID объекта в локальном контексте. Например, ID канала для отправки сообщения.
- SrcEventAuthor
	- _Значение:_ `0x03`
	- _Тип:_ `GlobID`
	- Источник (автор) оригинального события.
- PrevEvent
	- _Значение:_ `0x04`
	- _Тип:_ `LocID`
	- Предыдущее событие, логически связанное с текущим.
- NextEvent
	- _Значение:_ `0x05`
	- _Тип:_ `LocID`
	- Следующее событие, логически связанное с текущим.
- BatchNumber
	- _Значение:_ `0x06`
	- _Тип:_ `uint32_t`
	- Последовательный номер события в цепочке.
- Path
	- _Значение:_ `0x07`
	- _Тип:_ `char[]`
	- Название загружаемого/запрашиваемого файла или URL.
- Power
	- _Значение:_ `0x08`
	- _Тип:_ `Power`
	- Права доступа к конкретному объекту.
- ServerSession
	- _Значение:_ `0x09`
	- _Тип:_ `uint32_t`
	- Идентификатор серверной сессии. В случае с аутентифицированным соединением, его присутствие обязательно.


## Криптография

- CryptoAlgos
	- _Значение:_ `0x11`
	- _Тип:_ `CryptoAlgo[3]`
	- Используемые криптографические алгоритмы. Первый элемент выделен под хэш-функцию; второй элемент для ассиметричной функции; третий элемент для симметричной функции.
- CryptoKeyID
	- _Значение:_ `0x12`
	- _Тип:_ `uint32_t`
	- Идентификатор используемого криптографического ключа для шифрования данных.
- SignedDataHash
	- _Значение:_ `0x13`
	- _Тип:_ не имеет значения
	- Хэш основных передаваемых данных, зашифрованный закрытым ключом отправителя.
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
+								# Список зарезервированных ключей ячеек
 								<!-- TODO: сделать папку и там разместить подробное описание некоторых ключей -->
-												Множественные правки и добавления

											
										
										
											2023-09-06 08:31:23 +05:30
+								Перечисленные здесь значения являются либо совсем базовыми, либо предназначены для использования сервером. Все данные транзитных пакетов (т.е. тех, которые предназначены для кого-то кроме подключённого напрямую серверу), для которых критична подлинность, должны передаваться в ячейке `Data` и быть подписанными с помощью ячейки `SignedDataHash`.
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
-												Забыл, что именно, но типа чото добавил

											
										
										
											2023-07-17 07:59:20 +05:30
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
+								## Базовые примитивы
 								- Data
 									- _Значение:_ `0x01`
-												Сессии, ID, аутентификация и прочее

											
										
										
											2023-07-11 07:13:24 +05:30
+									- _Тип:_ не имеет значения
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
+									- Основные передаваемые данные.
 								- ObjectID
 									- _Значение:_ `0x02`
-												Забыл, что именно, но типа чото добавил

											
										
										
											2023-07-17 07:59:20 +05:30
+									- _Тип:_ `LocID || GlobID`
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
+									- ID объекта в локальном контексте. Например, ID канала для отправки сообщения.
-												Забыл, что именно, но типа чото добавил

											
										
										
											2023-07-17 07:59:20 +05:30
+								- SrcEventAuthor
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
+									- _Значение:_ `0x03`
-												Забыл, что именно, но типа чото добавил

											
										
										
											2023-07-17 07:59:20 +05:30
+									- _Тип:_ `GlobID`
 									- Источник (автор) оригинального события.
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
+								- PrevEvent
 									- _Значение:_ `0x04`
-												Забыл, что именно, но типа чото добавил

											
										
										
											2023-07-17 07:59:20 +05:30
+									- _Тип:_ `LocID`
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
+									- Предыдущее событие, логически связанное с текущим.
 								- NextEvent
 									- _Значение:_ `0x05`
-												Забыл, что именно, но типа чото добавил

											
										
										
											2023-07-17 07:59:20 +05:30
+									- _Тип:_ `LocID`
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
+									- Следующее событие, логически связанное с текущим.
 								- BatchNumber
 									- _Значение:_ `0x06`
 									- _Тип:_ `uint32_t`
 									- Последовательный номер события в цепочке.
 								- Path
 									- _Значение:_ `0x07`
 									- _Тип:_ `char[]`
 									- Название загружаемого/запрашиваемого файла или URL.
 								- Power
 									- _Значение:_ `0x08`
 									- _Тип:_ `Power`
 									- Права доступа к конкретному объекту.
-												Изменения касательно серверных сессий и пр. правки

											
										
										
											2023-09-08 05:55:47 +05:30
+								- ServerSession
 									- _Значение:_ `0x09`
 									- _Тип:_ `uint32_t`
 									- Идентификатор серверной сессии. В случае с аутентифицированным соединением, его присутствие обязательно.
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
-												Забыл, что именно, но типа чото добавил

											
										
										
											2023-07-17 07:59:20 +05:30
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
+								## Криптография
-												Забыл, что именно, но типа чото добавил

											
										
										
											2023-07-17 07:59:20 +05:30
+								- CryptoAlgos
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
+									- _Значение:_ `0x11`
-												Забыл, что именно, но типа чото добавил

											
										
										
											2023-07-17 07:59:20 +05:30
+									- _Тип:_ `CryptoAlgo[3]`
-												Множественные правки и добавления

											
										
										
											2023-09-06 08:31:23 +05:30
+									- Используемые криптографические алгоритмы. Первый элемент выделен под хэш-функцию; второй элемент для ассиметричной функции; третий элемент для симметричной функции.
-												Do i rly need to comment this sheat?

											
										
										
											2023-07-08 07:09:56 +05:30
+								- CryptoKeyID
 									- _Значение:_ `0x12`
 									- _Тип:_ `uint32_t`
-												Сессии, ID, аутентификация и прочее

											
										
										
											2023-07-11 07:13:24 +05:30
+									- Идентификатор используемого криптографического ключа для шифрования данных.
-												Забыл, что именно, но типа чото добавил

											
										
										
											2023-07-17 07:59:20 +05:30
+								- SignedDataHash
-												Сессии, ID, аутентификация и прочее

											
										
										
											2023-07-11 07:13:24 +05:30
+									- _Значение:_ `0x13`
 									- _Тип:_ не имеет значения
 									- Хэш основных передаваемых данных, зашифрованный закрытым ключом отправителя.