Добавить периодический sync блокчейнов каждые 12 часов

2026-06-25 17:58:07 +04:00
parent 1f8b20a7d1
commit 84e0f039cb
11 changed files with 690 additions and 4 deletions
@@ -0,0 +1,23 @@
+# Периодическая межсерверная синхронизация блокчейнов
+
+- Краткое описание:
+  - Добавлен публичный `GetBlockchainBlock` для чтения одного блока.
+  - Добавлен плановый sync блокчейнов при старте сервера и затем каждые `12` часов.
+  - Синхронизация пока умеет только докачивать отсутствующий хвост цепочки.
+  - Случай рассинхрона цепочек пока не исправляется автоматически: он только логируется как не реализованный сценарий.
+
+- Что именно проверять:
+  - После старта сервера в логах появляется запуск периодического sync.
+  - Сервер может запросить у партнёра `ListBlockchainHeads`.
+  - Сервер может запросить у партнёра `GetBlockchainBlock` и локально применить блок через существующий `AddBlock`.
+  - На чистом тестовом сервере после удаления БД и файлов блокчейнов сервер сам подтягивает блоки при старте.
+  - После первичного старта новые блоки продолжают догоняться без ручного вмешательства.
+  - При рассинхроне цепочек в логах появляется явное сообщение, что reconciliation пока не реализован.
+
+- Ожидаемый результат:
+  - Чистый сервер после старта сам восстанавливает локальные цепочки от партнёра синхронизации.
+  - Периодический sync не мешает обычной работе сервера и не ломает локальный `AddBlock`.
+  - Нереализованный случай рассинхрона не приводит к падению сервера и явно отражается в логах.
+
+- Статус:
+  - `pending`