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

9.0 KiB
Raw Blame History

TECH блоки (type=0; версия 1, а для HEADER также 2)

TECH-тип покрывает системные записи пользовательской цепочки. Все TECH DataItem имеют подписанный индексный тег:

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). Новый клиент создаёт HEADER v2, а старые HEADER v1 продолжают читаться.

Формат HEADER v1:

[5]  ASCII "SHiNE"
[1]  loginLength (uint8)
[N]  login UTF-8
[32] initialBlockchainKey32

Формат HEADER v2, строго в указанном порядке:

[5]  ASCII "SHiNE"
[1]  loginLength (uint8)
[N]  login UTF-8
[15] ASCII "license:CC0-1.0"
[32] initialBlockchainKey32

В v2 строка license:CC0-1.0 записывается буквально, без отдельного поля длины, и должна полностью совпадать. Наличие префикса license: обязательно. Запись является частью подписанного блока. Любые другие строки лицензии и дополнительные байты запрещены.

HEADER v1 остаётся исторически допустимым и не означает автоматически принятую CC0. Существующие блоки #0 не переписываются. Все новые цепочки создаются с HEADER v2.

Поле 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 перед ним. Дополнительной проверки при каждом входе нет. Схема HEADER v2 расширена константой лицензии; сетевой API AddBlock не меняется.

subType=1 — TECH_CREATE_CHANNEL

Создание нового канала. Блок одновременно:

  • является очередным шагом TECH-линии;
  • является root нового канала;
  • имеет t=tech;
  • имеет c=<canonical_channel_slug>.

Начало body:

[4]  lineCode = 0
[4]  prevTechBlockNumber
[32] prevTechBlockHash32
[4]  techSequence

Далее идут channelName, channelDescription, channelType, channelTypeVersion согласно формату CREATE_CHANNEL. Для новых блоков channelName должен содержать 4–32 символа; channelNameLen по-прежнему является uint8 и хранит UTF-8 длину в байтах. Исторические блоки с более коротким именем продолжают декодироваться. См. правила имён.

subType=2 — TECH_FORK

TECH_FORK фиксирует создание нового fork и является обычным следующим шагом TECH-линии.

TECH_FORK body (version=1)

Big-endian:

[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 образуют единый проверяемый технический позвоночник пользователя.