SHA256
Доделать донаты и статистику поддержки
This commit is contained in:
@@ -659,3 +659,45 @@ Changing `account_role` or `shine` does not alter the raw reaction. The two qual
|
||||
API считает только `support_user` из таблицы `solana_support_transfers`. Для CHANNEL проверяет, что адресат равен владельцу существующего канала. Для MESSAGE проверяет наличие блока с точным номером/хешем, авторство получателя и принадлежность блока цепочке владельца канала. Не соответствующие этим условиям донаты остаются в истории, но не включаются в публичные суммы. Поддержка ответов в других пользовательских цепочках не попадает в агрегат до добавления полной проверки принадлежности обсуждению.
|
||||
|
||||
Таблицы истории автоматически создаются финансовым индексатором. Пока он не синхронизирован, операция может возвращать `support_totals_unavailable` — клиент не должен подменять отсутствие данных нулями.
|
||||
|
||||
|
||||
## GetSupportStats — публичные счётчики поддержки Paid-пользователя
|
||||
|
||||
Счётчики загружаются из PostgreSQL, а не через отдельный RPC Solana при каждом
|
||||
открытии профиля. Серверный `SupportHistoryIndexer` собирает кеш из успешных
|
||||
финализированных транзакций `shine_users` (opcodes 9 и 10). Исходная проверяемая
|
||||
финансовая статистика хранится в Solana PDA; кеш может отставать до следующего sync.
|
||||
|
||||
**Запрос:**
|
||||
|
||||
```json
|
||||
{"op":"GetSupportStats","requestId":"support-1","payload":{"login":"Alice@namespace"}}
|
||||
```
|
||||
|
||||
**Ответ:**
|
||||
|
||||
```json
|
||||
{
|
||||
"op":"GetSupportStats", "requestId":"support-1", "status":200, "ok":true,
|
||||
"payload":{
|
||||
"login":"Alice@namespace", "available":true, "ready":true,
|
||||
"supportSentLamports":"1000000000",
|
||||
"supportReceivedLamports":"900000000",
|
||||
"daoDirectLamports":"100000000"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
- `available=false` — локальный Solana sync не содержит Paid PDA (например,
|
||||
Free-аккаунт). Поля сумм в этом случае не показывать.
|
||||
- `ready=false` — сервер ещё не закончил первичную индексацию всей доступной истории;
|
||||
суммы **нельзя** показывать как окончательные (даже если возвращены нули).
|
||||
- `available=true, ready=true`, а строки сумм равны `"0"` — корректная нулевая
|
||||
статистика зарегистрированного Paid-пользователя без донатов.
|
||||
- Все значения lamports передаются **строками** (без преобразования в JS Number).
|
||||
Показатель «Поддержал SHiNE» вычисляется как `supportSentLamports / 10 +
|
||||
daoDirectLamports`. Регистрация и изменение PDA сюда не входят.
|
||||
|
||||
При отсутствии таблиц/соединения БД сервер возвращает ошибку, а не фиктивные нули.
|
||||
API не запускает RPC-вызовы; для свежих значений сразу после оплаты необходимо
|
||||
дождаться следующего прохода `SupportHistoryIndexer`.
|
||||
|
||||
@@ -69,6 +69,7 @@
|
||||
| `GetMessageThread` | `06_Channels_Read_API.md` | тред сообщения |
|
||||
| `GetMessageLikes` | `06_Channels_Read_API.md` | списки пользователей, поставивших лайк сообщению |
|
||||
| `GetSupportTotals` | `06_Channels_Read_API.md` | подтверждённые суммы поддержки канала и публикаций |
|
||||
| `GetSupportStats` | `06_Channels_Read_API.md` | три кешированных счётчика поддержки Paid-пользователя |
|
||||
| `GetPersonalDiary` | `06_Channels_Read_API.md` | виртуальный канал `Личный дневник` из STATUS_ACTION |
|
||||
| `ListUserProfileChannels` | `06_Channels_Read_API.md` | публичные каналы профиля |
|
||||
| `ListUserProfileRelations` | `11_Connections_API.md` | связи пользователя в профиле |
|
||||
|
||||
@@ -643,7 +643,7 @@ Instruction `shine_users` opcode 8 (`update_namespace_price`) передаёт e
|
||||
Синхронизатор распознаёт инструкции `shine_users` 9 (`SUPPORT_USER`) и 10
|
||||
(`SUPPORT_DAO`) в истории подтверждённых транзакций. Их параметры остаются
|
||||
бинарными данными инструкции; окончательные пользовательские счётчики всегда
|
||||
считываются из PDA Solana, а не пересчитываются из PostgreSQL.
|
||||
достоверны в PDA Solana; сервер хранит отдельный индекс для быстрого отображения.
|
||||
|
||||
## Финансовый журнал поддержки (12.11.2026)
|
||||
|
||||
@@ -651,8 +651,39 @@ Instruction `shine_users` opcode 8 (`update_namespace_price`) передаёт e
|
||||
|
||||
Индексатор опрашивает `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.
|
||||
Таблицы: `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.
|
||||
|
||||
|
||||
### Кеш пользовательских счётчиков поддержки (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`
|
||||
предотвращает повторный полный подсчёт при каждом запуске.
|
||||
|
||||
Далее каждая новая уникальная инструкция записывается в журнал и увеличивает
|
||||
счётчики соответствующих пользователей **в одной PostgreSQL-транзакции с
|
||||
checkpoint**. Повторная инструкция с теми же `(signature, instruction_index)`
|
||||
не увеличивает кеш. Для `support_user`: отправителю прибавляется вся сумма,
|
||||
получателю — 90%. Для `support_dao`: отправителю прибавляется вся сумма в
|
||||
`dao_direct`. Первая история может занимать время; флаг `history_complete`
|
||||
становится TRUE только после успешного полного прохода. API `GetSupportStats`
|
||||
при FALSE возвращает `ready=false`, чтобы не показывать неполные суммы.
|
||||
|
||||
Free-аккаунты не имеют Paid PDA; API использует `solana_user_pda_current`
|
||||
и возвращает `available=false` без демонстрации фиктивной статистики.
|
||||
Текущая статистика может отставать от Solana до следующего poll. Для аудита
|
||||
возможна отдельная сверка с полями `SupportStats` ончейн PDA.
|
||||
|
||||
**Восстановление кеша:** при необходимости полного пересчёта из сохранённого
|
||||
журнала транзакций на остановленном синхронизаторе выполнить
|
||||
`UPDATE solana_support_sync_state SET stats_cache_ready=FALSE WHERE id=1`,
|
||||
после чего запустить синхронизатор. Не удалять journal/checkpoint без специальной
|
||||
процедуры повторной полной индексации.
|
||||
|
||||
Reference in New Issue
Block a user