Перевести донаты на Stars и обновить Devnet

This commit is contained in:
AidarKC
2026-11-14 00:55:02 +03:00
parent c972a975fd
commit 97db033eb8
39 changed files with 1020 additions and 198 deletions
@@ -649,30 +649,29 @@ Instruction `shine_users` opcode 8 (`update_namespace_price`) передаёт e
`SupportHistoryIndexer` работает внутри цикла `SolanaUsersSyncService` и имеет **отдельный checkpoint** `solana_support_sync_state`. Это важно: основной user-PDA синхронизатор при первом запуске использует snapshot и может не воспроизводить старые транзакции.
Индексатор опрашивает `getSignaturesForAddress(shine_users_economy_config)` на **finalized** RPC (рекомендуется архивный Helius endpoint), при первом запуске читает все доступные подписи до начала истории, затем обрабатывает от старых к новым. Для успешных транзакций считывает `getTransaction(jsonParsed)` и все инструкции `shine_users.support_user` (tag 9) и `shine_users.support_dao` (tag 10). Учитывает несколько инструкций в одной транзакции. Суммы сохраняются в PostgreSQL `NUMERIC(20,0)`, поскольку Solana `u64` может превышать Java `long`.
Индексатор опрашивает `getSignaturesForAddress(shine_users_economy_config)` на **finalized** RPC (рекомендуется архивный Helius endpoint), при первом запуске читает все доступные подписи до начала истории, затем обрабатывает от старых к новым. Для успешных транзакций считывает `getTransaction(jsonParsed)` и инструкции `shine_users.support_user` (tag 9) и `shine_users.support_dao` (tag 10) версии Stars с обязательным `amount_star_cents`; события `SHINE_STARS_V1` сверяются по полям и количеству. Старые тестовые инструкции без Stars пропускаются (без миграции). Учитывает несколько инструкций в одной транзакции. Суммы сохраняются в PostgreSQL `NUMERIC(20,0)`, поскольку Solana `u64` может превышать Java `long`.
Таблицы: `solana_support_sync_state`, `solana_support_transfers`, `solana_support_user_stats`; представления: `solana_support_channel_totals`, `solana_support_message_totals`. В SQL-представлениях суммы **без проверки авторства**: нельзя публично показывать их напрямую! Для API `GetSupportTotals` добавлена проверка через таблицы `channel_names_state` и `blocks`. Профили получают три кешированных счётчика через `GetSupportStats` (PostgreSQL),
не делая Solana RPC при каждом просмотре.
Checkpoint обновляется в той же PostgreSQL-транзакции, что и запись всех донатов из Solana-транзакции. Повторный запуск продолжает с последней успешно обработанной подписи. При недоступной исторической транзакции или исчезнувшей checkpoint-подписи синхронизация **останавливается с ошибкой**, а не перескакивает вперёд; требуется RPC с полной историей. Наличие `getSignaturesForAddress` само по себе НЕ гарантирует архивную полноту Helius/RPC. Начальные транзакции должны быть доступны провайдеру.
Индексатор включается вместе с `solana.users.sync.enabled=true`, использует те же PostgreSQL credentials и RPC URL. Реальный прогон полной архивной истории, тестирование с живым Helius и публичный API проверенных агрегатов требуют отдельной интеграционной проверки перед production.
Индексатор включается вместе с `solana.users.sync.enabled=true`, использует те же PostgreSQL credentials и RPC URL. Новый `GetSupportHistory` показывает финализированные переводы из этой таблицы с пагинацией и `ready`-состоянием. Реальный прогон полной архивной истории, тестирование с живым Helius и публичный API проверенных агрегатов требуют отдельной интеграционной проверки перед production.
### Кеш пользовательских счётчиков поддержки (12.11.2026)
`solana_support_user_stats` хранит `normalized_login` и три поля
`NUMERIC(20,0)`: `support_sent`, `support_received`, `dao_direct`.
При первом запуске обновлённого индексатора существующий `solana_support_transfers`
**однократно** агрегируется в кеш: это позволяет обновить сервер без сброса
накопленной истории. Флаг `stats_cache_ready` в `solana_support_sync_state`
При чистом запуске тестового сервера существующая история SOL не импортируется.
В новый кеш агрегируются исключительно транзакции со стоимостью Stars в центах. Флаг `stats_cache_ready` в `solana_support_sync_state`
предотвращает повторный полный подсчёт при каждом запуске.
Далее каждая новая уникальная инструкция записывается в журнал и увеличивает
счётчики соответствующих пользователей **в одной PostgreSQL-транзакции с
checkpoint**. Повторная инструкция с теми же `(signature, instruction_index)`
не увеличивает кеш. Для `support_user`: отправителю прибавляется вся сумма,
получателю — 90%. Для `support_dao`: отправителю прибавляется вся сумма в
получателю — сумма Stars после округления 10% DAO вверх до сотой. Для `support_dao`: отправителю прибавляется вся сумма в
`dao_direct`. Первая история может занимать время; флаг `history_complete`
становится TRUE только после успешного полного прохода. API `GetSupportStats`
при FALSE возвращает `ready=false`, чтобы не показывать неполные суммы.