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

2026-09-21 12:49:33 +03:00
parent 23969121e5
commit be696d116b
90 changed files with 2411 additions and 14938 deletions
@@ -0,0 +1,97 @@
+# ANS-104 / Arweave transport для пользовательских блоков SHiNE
+
+## Цель
+
+Каждый пользовательский блок уже на клиенте является самостоятельным подписанным ANS-104 DataItem. Сервер не переподписывает пользовательский контент: он проверяет его, хранит в PostgreSQL и объединяет готовые DataItems в стандартный ANS-104 bundle.
+
+## Child DataItem tags
+
+Обязательно для тестового контура:
+
+```text
+App=test5590
+```
+
+Дополнительно для блоков конкретного канала:
+
+```text
+c=<canonical_channel_slug>
+```
+
+Теги входят в ANS-104 подпись пользователя.
+
+## Publisher
+
+По умолчанию цикл — раз в 15 минут.
+
+```text
+blocks.arweave_publish_pending=true
+        ↓
+готовые serialized DataItems
+        ↓
+ANS-104 binary bundle
+        ↓
+обычная Arweave L1 transaction
+```
+
+Если pending-блоков нет, транзакция не создаётся.
+
+Root transaction содержит стандартные bundle tags:
+
+```text
+Bundle-Format=binary
+Bundle-Version=2.0.0
+Content-Type=application/octet-stream
+App=test5590-batch
+```
+
+`App=test5590-batch` намеренно отличается от child `App=test5590`, чтобы discovery-запрос находил пользовательские блоки, а не root bundles.
+
+После успешной L1-загрузки сервер ставит child-блокам:
+
+- `arweave_publish_pending=false`;
+- `arweave_published_at_ms`;
+- `arweave_root_tx_id`.
+
+## Importer
+
+Каждый сервер может независимо искать:
+
+```text
+App=test5590
+```
+
+через GraphQL gateway с cursor pagination.
+
+Для каждого нового DataItem:
+
+1. взять `id` и `bundledIn.id`;
+2. получить root bundle;
+3. извлечь точные serialized bytes child DataItem по bundle index;
+4. проверить `dataItemId == SHA256(signature)`;
+5. проверить ANS-104 Ed25519 подпись;
+6. определить пользователя по `owner`;
+7. применить обычные проверки `AddBlock`;
+8. записать в PostgreSQL с `arweave_publish_pending=false`.
+
+### Блоки могут прийти не по порядку
+
+Discovery/import использует persistent queue `arweave_block_import_queue`. Если, например, block 102 увиден раньше block 101, block 102 остаётся `PENDING`; после появления 101 очередь повторно проигрывается.
+
+## Дедупликация и несколько серверов
+
+Один и тот же готовый DataItem имеет один `data_item_id = SHA256(signature)`. Если несколько серверов включили его в разные root bundles, локально это всё равно один логический блок: `blocks.data_item_id` уникален.
+
+Импортированный из Arweave блок **не ставится обратно в publish queue**. Это предотвращает бесконечное переархивирование между серверами.
+
+## Локальное хранение
+
+Пользовательские blockchain-файлы на диске больше не используются. Полный serialized DataItem находится в `blocks.block_bytes` PostgreSQL.
+
+## Настройки
+
+См. `application.properties` и `CODEX_APPLY_ANS104_TEST5590_PATCH.md`.
+
+## Что намеренно не входит в этот патч
+
+Remote/homeserver signing path, связанный с внешним homeserver/ESP32 signer, не мигрируется этим патчем. Каталог `ESP32/` не изменяется. До отдельной миграции новый Frame v1/ANS-104 production path рассчитан на клиент, у которого локально доступен blockchain Ed25519 key.