Добавить импорт архивов с доверенных серверов

2026-09-12 16:59:35 +03:00
parent 2df0a78eb2
commit 1be1d56599
34 changed files with 4942 additions and 114 deletions
@@ -96,3 +96,42 @@ bytes[32] archive_hash
 ## 7. Legacy TestFreeAvatar

 Старый временный `TestFreeAvatarArweaveService` больше не является частью активного WS-протокола. Registry/API документация убраны. При наложении changed-files ZIP поверх старого дерева старые исходники физически останутся, поэтому их список для удаления находится в `05_PATCH_CONTENTS_AND_REMOVALS.md`.
+
+
+## Trusted importer / location index / Viewer
+
+Server importer:
+
+```text
+shine-server-archive/src/main/java/server/archive/ArchiveImportConfig.java
+shine-server-archive/src/main/java/server/archive/ArchiveImportScheduler.java
+shine-server-archive/src/main/java/server/archive/ArchiveImportService.java
+shine-server-archive/src/main/java/server/archive/ShineArchiveReader.java
+```
+
+Database:
+
+```text
+shine-server-db/src/main/java/shine/db/dao/ArchiveImportDAO.java
+shine-server-db/src/main/java/shine/db/archive/ArchiveBlockchainLocation.java
+shine-server-db/src/main/java/shine/db/archive/ArchivePublisherHead.java
+shine-server-db/src/main/resources/postgres/migration_v23.sql
+shine-server-solana-users-sync/src/main/java/sync/storage/postgres/PostgresStorageRepository.java
+```
+
+`PostgresStorageRepository` сохраняет `archive_imported=true` при повторном sync того же head и автоматически сбрасывает флаг в `false`, если `archive_head_tx_id` или `archive_head_hash` изменились.
+
+WS API:
+
+```text
+GetArchiveBlockchainLocation
+```
+
+UI:
+
+```text
+shine-UI/js/pages/blockchain-archive-view.js
+shine-UI/Blockchain-Viewer.html
+```
+
+`Blockchain-Viewer.html` получает `tx + offset + size + blockchain`, идёт назад по `PreviousBlockchainChunkRef` и использует существующий parser каналов старого Viewer-а.