Добавить систему поддержки SHiNE

This commit is contained in:
AidarKC
2026-11-12 11:01:31 +03:00
parent 6b120731a3
commit c97df82538
34 changed files with 1323 additions and 52 deletions
+11
View File
@@ -648,3 +648,14 @@ Changing `account_role` or `shine` does not alter the raw reaction. The two qual
## 2026-10-28 — Официальный регистр логинов при чтении
В ответах `GetChannelMessages`, `GetMessageThread`, `ListSubscriptionsFeed` поля `authorLogin` и `ownerLogin` показывают **регистрационное написание** из `user_identity_current`, например `AlexSmith@shine`. В БД блока и в `blockchainName` по-прежнему возможен lowercase, используемый как нормализованный идентификатор. Это не меняет имена JSON-полей или типы значений, а уточняет их семантику. Для поиска и переходов разные варианты регистра по-прежнему ссылаются на одну идентичность; байты уже подписанных блоков не переписываются.
## GetSupportTotals — проверенная поддержка канала
Запрос: `{"op":"GetSupportTotals", "channelRootBlockNumber":12, "channelRootBlockHash":"<64 hex>"}`.
Ответ (при `status=200`): `channelReceivedLamports` — десятичная строка суммы реально полученных авторами средств (90% донатов); `messages` — массив `{blockNumber,blockHash,receivedLamports}`. Все значения в lamports представлены **строками**, не JavaScript Number. В результате возвращаются не более 2000 сообщений с максимальными суммами, агрегат канала включает все проверенные операции.
API считает только `support_user` из таблицы `solana_support_transfers`. Для CHANNEL проверяет, что адресат равен владельцу существующего канала. Для MESSAGE проверяет наличие блока с точным номером/хешем, авторство получателя и принадлежность блока цепочке владельца канала. Не соответствующие этим условиям донаты остаются в истории, но не включаются в публичные суммы. Поддержка ответов в других пользовательских цепочках не попадает в агрегат до добавления полной проверки принадлежности обсуждению.
Таблицы истории автоматически создаются финансовым индексатором. Пока он не синхронизирован, операция может возвращать `support_totals_unavailable` — клиент не должен подменять отсутствие данных нулями.
+1
View File
@@ -68,6 +68,7 @@
| `GetChannelMessages` | `06_Channels_Read_API.md` | сообщения канала |
| `GetMessageThread` | `06_Channels_Read_API.md` | тред сообщения |
| `GetMessageLikes` | `06_Channels_Read_API.md` | списки пользователей, поставивших лайк сообщению |
| `GetSupportTotals` | `06_Channels_Read_API.md` | подтверждённые суммы поддержки канала и публикаций |
| `GetPersonalDiary` | `06_Channels_Read_API.md` | виртуальный канал `Личный дневник` из STATUS_ACTION |
| `ListUserProfileChannels` | `06_Channels_Read_API.md` | публичные каналы профиля |
| `ListUserProfileRelations` | `11_Connections_API.md` | связи пользователя в профиле |
@@ -638,3 +638,21 @@ Arweave/Turbo publisher обрабатывает candidate-блоки приор
Instruction `shine_users` opcode 8 (`update_namespace_price`) передаёт economy PDA в метах (read-only). Исторический скан этого PDA обнаруживает транзакцию и загружает актуальный снимок затронутого namespace PDA через getMultipleAccounts. Декодер принимает namespace v1.0 (`currency_code=1` по умолчанию) и v1.1 (добавлен один байт currency code после u64 fee), только код 1. Postgres v40: `shine_namespace_current.currency_code SMALLINT DEFAULT 1`; `UPSERT` обновляет `registration_fee_lamports` и `currency_code` при slot не старее существующего. `GetNamespaces` и `CheckRegistrationLogin` получают цену из БД после sync.
Важное условие: history sync запускается по economy PDA. Поскольку она read-only, subscription по изменению данных economy PDA не сработает; нужен регулярный history polling, а перед фактической оплатой клиент читает namespace напрямую из сети.
# Операции поддержки
Синхронизатор распознаёт инструкции `shine_users` 9 (`SUPPORT_USER`) и 10
(`SUPPORT_DAO`) в истории подтверждённых транзакций. Их параметры остаются
бинарными данными инструкции; окончательные пользовательские счётчики всегда
считываются из PDA Solana, а не пересчитываются из PostgreSQL.
## Финансовый журнал поддержки (12.11.2026)
`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`.
Таблицы: `solana_support_sync_state`, `solana_support_transfers`; представления: `solana_support_channel_totals`, `solana_support_message_totals`. В SQL-представлениях суммы **без проверки авторства**: нельзя публично показывать их напрямую! Для API `GetSupportTotals` добавлена проверка через таблицы `channel_names_state` и `blocks`. Пользовательский профиль продолжает читать ончейн-счётчики из PDA.
Checkpoint обновляется в той же PostgreSQL-транзакции, что и запись всех донатов из Solana-транзакции. Повторный запуск продолжает с последней успешно обработанной подписи. При недоступной исторической транзакции или исчезнувшей checkpoint-подписи синхронизация **останавливается с ошибкой**, а не перескакивает вперёд; требуется RPC с полной историей. Наличие `getSignaturesForAddress` само по себе НЕ гарантирует архивную полноту Helius/RPC. Начальные транзакции должны быть доступны провайдеру.
Индексатор включается вместе с `solana.users.sync.enabled=true`, использует те же PostgreSQL credentials и RPC URL. Реальный прогон полной архивной истории, тестирование с живым Helius и публичный API проверенных агрегатов требуют отдельной интеграционной проверки перед production.