Files
SHiNE-server/docs/Blockchain/README.md
T

59 lines
4.5 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.
# SHiNE Blockchain
Актуальная версия пользовательского blockchain использует **SHiNE Frame v1 внутри подписанного ANS-104 DataItem**. Старый Frame v0 и файловое хранение `.bch` не поддерживаются.
## Карта раздела
| Что нужно понять | Документ |
| --- | --- |
| Frame v1, ANS-104, подписи, хэши, теги | [Общий формат блока](01_Common_Block_Format.md) |
| Виды блоков и логические линии | [Индекс типов](00_Blockchain_Formats_and_Block_Types.md), [линии](02_Blockchain_Kinds_and_Lines.md) |
| TECH, TEXT, реакции, связи, профиль, статусы | [TECH](10_TECH_Blocks.md), [TEXT](11_TEXT_Blocks.md), [REACTION](12_REACTION_Blocks.md), [CONNECTION](13_CONNECTION_Blocks.md), [USER_PROFILE](14_USER_PROFILE_Blocks.md), [STATUS_ACTION](15_STATUS_ACTION_Blocks.md) |
| Каналы, метаданные и удаление | [Создание канала](01_Channel_Types_and_CreateChannel.md), [команды](02_Channel_Commands.md), [метаданные](16_TEXT_Channel_Meta.md), [soft-delete](17_TEXT_Channel_Delete.md) |
| Вложения в TEXT | [Формат вложений](15_TEXT_Attachments.md) |
| Публикация и импорт | [Arweave транспорт](17_ANS104_Arweave_Transport.md), [синхронизация серверов](sync-between-servers.md) |
| Ротация и fork | [Ротация ключей](18_KEY_ROTATION_AND_FORK_TARGETS.md), [логические цели](19_STAGE2_LOGICAL_TARGETS_AND_FORK_STORAGE.md) |
| История изменений | [CHANGELOG.md](CHANGELOG.md) |
Файлы с `TODO`, `CODEX_APPLY` и старые отчёты относятся к планам или истории выполнения; для текущего формата начинайте с таблицы выше.
## Короткая схема
```text
User
-> создаёт Frame v1
-> tags: App=test5592; t=tech/conn/prof для фиксированных потоков; при канале c=<slug>
-> Ed25519 подписывает ANS-104 deep-hash
-> готовый DataItem
-> AddBlock
Server
-> verify DataItem + SHiNE chain
-> PostgreSQL
-> publish.mode=turbo: каждый signed DataItem через Turbo
ИЛИ publish.mode=arweave: большой standard ANS-104 bundle -> Arweave L1
ИЛИ publish.mode=none: наружу не публиковать
Other servers
-> GraphQL App=test5592
-> скачивают/извлекают DataItem
-> verify
-> PostgreSQL без повторной публикации
```
## Важные свойства
- SHiNE `prevHash` остаётся SHA-256 предыдущего Frame v1 и не зависит от Arweave.
- `data_item_id` нужен для Arweave, поиска и дедупликации.
- PostgreSQL — единственное локальное хранилище пользовательских блоков.
- Тестовый namespace `App=test5592` специально отделён от будущего production namespace.
## Отдельные регистрационные DataItem V1 (test only; импорт реализован в коде, E2E не пройден)
Новая платформа регистрации `t=reg` использует ANS-104 Ed25519 и независимый payload, **не являющийся пользовательским AddBlock**. Формат определён в [регистрационном протоколе](../Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md). Обычный формат пользовательских блоков не меняется. Новая регистрация отправляет `t=reg` через Turbo и отдельный импортёр, код включён только в тестовом патче; фактический Turbo/GraphQL E2E ещё не пройден.
- Регистрационные Arweave ANS-104 DataItem `t=reg` (вне пользовательских блокчейнов): [формат сертификата](../Протоколы/SHINE_FREE_REGISTRATION_CERTIFICATE_V1.md), [регистрация v2](../registration-v2/README.md).
- [Единая идентичность логина без учёта регистра](CASE_INSENSITIVE_LOGIN.md) — правила логинов, PDA и социальных ссылок (2026-10-28).