Files
SHiNE-server/docs/Blockchain/10_TECH_Blocks.md
T

115 lines
7.8 KiB
Markdown
Raw 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.
# TECH блоки (`type=0`, `version=1`)
TECH-тип покрывает системные записи пользовательской цепочки. Все TECH DataItem имеют подписанный индексный тег:
```text
t=tech
```
`HEADER` является root TECH-линии. Следующие line-based TECH-события (`TECH_CREATE_CHANNEL`, `TECH_FORK`) образуют одну последовательность с `lineCode=0`, ссылкой на предыдущий TECH-событийный блок и sequence `1..N`.
## Подтипы
### `subType=0` — `HEADER_COMPAT`
Стартовый блок цепочки (`block #0`). Payload содержит tag `SHiNE`, login владельца и `initialBlockchainKey32`.
Поле `login` хранит **точное неизменяемое написание идентичности при регистрации**: для новой регистрации `login@namespace` соответствует `[A-Za-z0-9_]+@[a-z0-9_]+`, длина не более 30 байт. Регистр локальной части сохраняется побайтно из Solana PDA или сертификата Arweave; `@namespace` остаётся строчным. `AlexSmith@shine` и `alexsmith@shine` идентифицируют одного человека (по lower-case), но только первый вариант допустим в его HEADER, если именно так он зарегистрирован. `@` не меняет бинарную структуру HEADER: `[loginLength:uint8][login UTF-8 bytes]`. При копировании префикса для следующих fork первый HEADER не меняется. Исторические legacy `[A-Za-z0-9_]+` по-прежнему декодируются, но в новую регистрацию не допускаются.
AddBlock сверяет HEADER #0 с точным именем в `user_identity_current` и не принимает отличия в регистре. Другие блоки со ссылками на пользователей разрешается адресовать независимо от регистра. Новые UI-блоки (ответы, реакции, оценки, статусы, связи, подписки, репосты) должны записывать официальный регистр, полученный через `GetUser`, **перед** подписью. Нормализация используется в поиске/сопоставлении и при построении имени цепочки, но не для изменения подписанного текста.
`initialBlockchainKey32` — public blockchain-signing key, которым был создан fork №1; это историческая точка происхождения. При последующих fork значение не меняется.
HEADER сам не хранит line-prefix, но является root TECH-линии.
После успешной регистрации и автоматического входа клиент вызывает `ensureBlockchainHeader(login, storagePwd)` один раз в общем завершении регистрации (как Solana, так и Arweave). При отсутствии блока №0 клиент создаёт и подписывает HEADER и отправляет его через обычный `AddBlock`. Неудачная отправка **не отменяет** уже подтверждённую регистрацию: существующая логика создания первого пользовательского блока проверит и при необходимости создаст HEADER перед ним. Дополнительной проверки при каждом входе нет. Формат блоков и серверный API не изменены.
### `subType=1` — `TECH_CREATE_CHANNEL`
Создание нового канала. Блок одновременно:
- является очередным шагом TECH-линии;
- является root нового канала;
- имеет `t=tech`;
- имеет `c=<canonical_channel_slug>`.
Начало body:
```text
[4] lineCode = 0
[4] prevTechBlockNumber
[32] prevTechBlockHash32
[4] techSequence
```
Далее идут `channelName`, `channelDescription`, `channelType`, `channelTypeVersion` согласно формату CREATE_CHANNEL.
Для **новых** блоков `channelName` должен содержать **4–32** символа;
`channelNameLen` по-прежнему является `uint8` и хранит UTF-8 длину в байтах.
Исторические блоки с более коротким именем продолжают декодироваться.
См. [правила имён](01_Channel_Types_and_CreateChannel.md#4-правила-имени-канала-при-создании).
### `subType=2` — `TECH_FORK`
`TECH_FORK` фиксирует создание нового fork и является обычным следующим шагом TECH-линии.
#### `TECH_FORK` body (`version=1`)
Big-endian:
```text
[4] lineCode = 0
[4] prevTechBlockNumber
[32] prevTechBlockHash32
[4] techSequence
[32] parentBlockchainKey
[4] forkPointBlockNumber
[32] forkPointBlockHash32
[8] forkPointTimestampMs
[4] parentTipBlockNumber
[32] parentTipBlockHash32
[8] parentTipTimestampMs
[4] discardedBlocksCount
[1] reasonCode
[2] commentUtf8Length
[N] comment UTF-8
```
- `prevTechBlockNumber` — глобальный blockNumber предыдущего TECH-события; если до fork не было CREATE_CHANNEL/FORK, это `HEADER #0`;
- `prevTechBlockHash32` — hash этого блока;
- `techSequence` — предыдущий TECH sequence + 1; первый TECH-событийный блок после HEADER имеет `1`.
Остальная fork-часть:
- `parentBlockchainKey[32]` — public key предыдущего fork;
- `forkPointBlockNumber[4]` — последний блок старой цепочки, сохранённый в новом fork;
- `forkPointBlockHash32[32]`;
- `forkPointTimestampMs[8]`;
- `parentTipBlockNumber[4]` — tip старой цепочки на момент начала ротации;
- `parentTipBlockHash32[32]`;
- `parentTipTimestampMs[8]`;
- `discardedBlocksCount[4] = parentTipBlockNumber - forkPointBlockNumber`;
- `reasonCode[1]`;
- `commentUtf8Length[2]`;
- `comment[N]` — максимум 1024 UTF-8 байт.
`reasonCode`:
- `1` — `ROUTINE_ROTATION`;
- `2` — `POSSIBLE_COMPROMISE`;
- `3` — `CONFIRMED_COMPROMISE_ROLLBACK`;
- `4` — `RECOVERY`.
Текущая схема ротации перепубликует выбранный префикс `0..forkPointBlockNumber` новым blockchain key и затем добавляет `TECH_FORK`. Перепубликованные Frame сохраняются байт-в-байт; внешняя ANS-104 owner/signature меняется. Новый blockchain key в body не дублируется: он определяется owner/signature нового DataItem.
## Серверная проверка TECH-линии
Для `TECH_CREATE_CHANNEL` и `TECH_FORK` сервер требует:
1. `lineCode=0`;
2. первый TECH-событийный блок ссылается на HEADER и имеет sequence `1`;
3. каждый следующий ссылается на фактический текущий хвост TECH-линии;
4. номер предыдущего блока, его hash и sequence должны совпадать точно.
Таким образом CREATE_CHANNEL и FORK образуют единый проверяемый технический позвоночник пользователя.