Аввив 2.0 - работает, заливка!!

docs/Blockchain/README.md

@@ -1,47 +1,40 @@
-# Документация блокчейна SHiNE (MVP)
+# SHiNE Blockchain
 
-Этот каталог описывает только текущий рабочий формат протокола для MVP.
+Актуальная версия пользовательского blockchain использует **SHiNE Frame v1 внутри подписанного ANS-104 DataItem**. Старый Frame v0 и файловое хранение `.bch` не поддерживаются.
 
 ## Основные документы
-1. [01_Common_Block_Format.md](./01_Common_Block_Format.md)
-   Единый бинарный формат блока (Frame v0), подпись, базовые проверки.
-2. [02_Blockchain_Kinds_and_Lines.md](./02_Blockchain_Kinds_and_Lines.md)
-   Виды цепочек и правила line-полей.
-3. [10_TECH_Blocks.md](./10_TECH_Blocks.md)
-   Системные блоки (`msg_type=0`).
-4. [11_TEXT_Blocks.md](./11_TEXT_Blocks.md)
-   Текстовые блоки (`msg_type=1`).
-5. [12_REACTION_Blocks.md](./12_REACTION_Blocks.md)
-   Реакции (`msg_type=2`).
-6. [13_CONNECTION_Blocks.md](./13_CONNECTION_Blocks.md)
-   Социальные связи (`msg_type=3`).
-7. [14_USER_PARAM_Blocks.md](./14_USER_PARAM_Blocks.md)
-   Параметры пользователя (`msg_type=4`).
-8. [15_STATUS_ACTION_Blocks.md](./15_STATUS_ACTION_Blocks.md)
-   Статусные действия пользователя (`msg_type=5`).
-9. [16_TEXT_Attachments.md](./16_TEXT_Attachments.md)
-   Вложения в TEXT-сообщениях через `S:att v=1`, включая опциональные `preAr/preSha256` для видео и крупных изображений.
-10. [16_TEXT_Channel_Meta.md](./16_TEXT_Channel_Meta.md)
-   Скрытый `TEXT_CHANNEL_META` для профиля канала.
-11. [01_Channel_Types_and_CreateChannel.md](./01_Channel_Types_and_CreateChannel.md)
-   Типы каналов и формат `CreateChannelBody`.
-12. [02_Channel_Commands.md](./02_Channel_Commands.md)
-   Команды в текстовых сообщениях каналов.
-13. [CHANGELOG.md](./CHANGELOG.md)
-    Журнал изменений документации.
 
-## Смежная документация
-- [../ИТХ/README.md](../ИТХ/README.md) — ежедневное закрытие блокчейна (ИТХ): краткий обзор.
-- [../ИТХ/Спецификация_ИТХ_v1.md](../ИТХ/Спецификация_ИТХ_v1.md) — точная спецификация чекпоинтов (Arweave/Solana/канал закрытий).
-- [sync-between-servers.md](./sync-between-servers.md) — живая межсерверная синхронизация блокчейна и доставка DM на единственный сервер получателя.
+- [`01_Common_Block_Format.md`](01_Common_Block_Format.md) — точный Frame v1, ANS-104, подпись, хэши и теги.
+- [`17_ANS104_Arweave_Transport.md`](17_ANS104_Arweave_Transport.md) — публикация блоков в Arweave и обратный импорт между серверами.
+- [`sync-between-servers.md`](sync-between-servers.md) — межсерверная синхронизация и full-resync без файловой копии blockchain.
+- [`CHANGELOG.md`](CHANGELOG.md) — история изменений протокола.
 
-## Важные ограничения MVP
-- Каналы `type=100` и `type=200` присутствуют в формате, но сейчас не используются в UI.
-- Поддерживаемый рабочий сценарий UI на текущем этапе: `stories (type=0)` и `public (type=1)`.
+## Короткая схема
 
-## Обязательное сопровождение
-- При любом изменении формата/правил блокчейна в коде документы этого каталога обновляются в том же наборе изменений.
-- Обычный `AddBlock` сейчас пишет через `<blockchainName>.tmp_bch`, `<blockchainName>.write_check` и `<blockchainName>.write_pending`; эта схема и `BlockchainTmpRecoveryOnStartup` должны быть описаны в актуальной документации по синхронизации и recovery.
-- Для runtime-агрегатов статистики `user_stats_state` и `channel_stats_state` действует тот же принцип derived state: они обновляются вместе с `AddBlock` и полностью пересобираются при full resync.
-- Если в старых данных есть канал владельца, которого ещё нет в `solana_user_pda_current`, сервер не падает: `channel_stats_state` всё равно обновляется, а `user_stats_state` создаётся только после появления пользователя в Solana PDA.
-- Каждое обновление документов фиксируется в `CHANGELOG.md` с датой/временем и хэшем коммита-основания.
+```text
+User
+  -> создаёт Frame v1
+  -> tags: App=test5590, при канале c=<slug>
+  -> Ed25519 подписывает ANS-104 deep-hash
+  -> готовый DataItem
+  -> AddBlock
+
+Server
+  -> verify DataItem + SHiNE chain
+  -> PostgreSQL
+  -> каждые ~15 минут ANS-104 bundle
+  -> Arweave L1
+
+Other servers
+  -> GraphQL App=test5590
+  -> скачивают/извлекают DataItem
+  -> verify
+  -> PostgreSQL без повторной публикации
+```
+
+## Важные свойства
+
+- SHiNE `prevHash` остаётся SHA-256 предыдущего Frame v1 и не зависит от Arweave.
+- `data_item_id` нужен для Arweave, поиска и дедупликации.
+- PostgreSQL — единственное локальное хранилище пользовательских блоков.
+- Тестовый namespace `App=test5590` специально отделён от будущего production namespace.