Общий формат пользовательского блока SHiNE — Frame v1 / ANS-104

Актуальный формат не поддерживает старый Frame v0. Новый пользовательский блок сразу создаётся как готовый подписанный ANS-104 DataItem.

1. Два уровня формата

Полный объект, который клиент отправляет в AddBlock, хранится в PostgreSQL и затем архивируется в Arweave:

ANS-104 DataItem
  signature_type = 2 (generic Ed25519)
  signature      = 64 bytes
  owner          = 32-byte blockchain public key
  target         = absent
  anchor         = absent
  tags
  data           = SHiNE Frame v1

Цепочка SHiNE не зависит от Arweave. Arweave DataItem ID хранится отдельно и используется для дедупликации/поиска, но не является prevHash.

2. SHiNE Frame v1

Все целые поля Frame v1 — BigEndian.

Поле	Размер	Описание
`frameCode`	2	`0x0001`
`prevHash32`	32	SHA-256 полного Frame v1 предыдущего SHiNE-блока; для блока 0 — нули
`blockSize`	4	точный размер Frame v1, включая header и body
`blockNumber`	4	номер блока, начиная с 0
`timestamp`	8	Unix time seconds
`type`	2	тип сообщения
`subType`	2	подтип
`version`	2	версия body
`body`	N	данные конкретного типа

FRAME_HEADER_SIZE = 56 bytes.

blockHash32 = SHA256(FrameV1Bytes)
next.prevHash32 = blockHash32

Подписи внутри Frame v1 нет. Единственная подпись пользователя — подпись окружающего ANS-104 DataItem.

3. ANS-104 DataItem

Для тестового контура используется generic Ed25519 signature type 2: подпись 64 bytes, owner 32 bytes. Это отдельный generic Ed25519 signer type; Solana-specific signer в текущем Turbo/arbundles имеет другой type.

Подписывается стандартный ANS-104 deep-hash:

[
  "dataitem",
  "1",
  "2",
  owner,
  target(empty),
  anchor(empty),
  rawAvroTags,
  FrameV1Bytes
]

rawAvroTags — ровно те Avro-serialized bytes тегов, которые лежат внутри DataItem.

dataItemId32 = SHA256(signature64).

Обязательный тестовый тег

Каждый блок:

App = test5590

Это временное namespace-значение для разработки. Перед реальным запуском оно будет заменено отдельным изменением протокола/кода.

Канальный тег

Если блок относится к конкретному каналу, он дополнительно содержит:

c = <canonical_channel_slug>

Slug входит в подпись DataItem и не может быть изменён сервером после подписи.

4. Что хранится в PostgreSQL

blocks.block_bytes содержит полный serialized ANS-104 DataItem, а не только Frame.

Отдельно индексируются:

block_hash — SHA-256(Frame v1);
block_signature — 64-byte Ed25519 signature из DataItem;
data_item_id — SHA-256(signature), UNIQUE;
block_number, bch_name, message fields;
состояние публикации в Arweave.

Локальные .bch, .tmp_bch и marker-файлы для пользовательских blockchain больше не используются.

5. Проверка AddBlock

Сервер обязан:

распарсить полный ANS-104 DataItem;
проверить App=test5590;
проверить c, если тип блока требует канал;
проверить ANS-104 Ed25519 подпись;
проверить, что owner равен текущему blockchain public key пользователя;
распарсить Frame v1 и body;
проверить blockNumber == last + 1;
проверить prevHash32 == lastBlockHash;
записать DataItem и новое состояние атомарно в PostgreSQL.

4.4 KiB Raw Blame History