Доделать донаты и статистику поддержки

This commit is contained in:
AidarKC
2026-11-12 12:15:35 +03:00
parent c97df82538
commit 2a72842a7a
16 changed files with 402 additions and 15 deletions
+42
View File
@@ -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`.