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

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
@@ -92,6 +92,7 @@ import server.logic.ws_protocol.JSON.handlers.channels.Net_GetChannelMessages_Ha
import server.logic.ws_protocol.JSON.handlers.channels.Net_GetMessageThread_Handler;
import server.logic.ws_protocol.JSON.handlers.channels.Net_GetMessageLikes_Handler;
import server.logic.ws_protocol.JSON.handlers.channels.Net_GetSupportTotals_Handler;
import server.logic.ws_protocol.JSON.handlers.channels.Net_GetSupportStats_Handler;
import server.logic.ws_protocol.JSON.handlers.channels.Net_GetPersonalDiary_Handler;
import server.logic.ws_protocol.JSON.handlers.channels.Net_GetGroupDialog_Handler;
import server.logic.ws_protocol.JSON.handlers.channels.Net_GetChannelsCounters_Handler;
@@ -106,6 +107,7 @@ import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetGroupDial
import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetMessageThread_Request;
import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetMessageLikes_Request;
import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetSupportTotals_Request;
import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetSupportStats_Request;
import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetPersonalDiary_Request;
import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_ListGroupChats200_Request;
import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_ListSubscriptionsFeed_Request;
@@ -257,6 +259,7 @@ public final class JsonHandlerRegistry {
Map.entry("GetMessageThread", new Net_GetMessageThread_Handler()),
Map.entry("GetMessageLikes", new Net_GetMessageLikes_Handler()),
Map.entry("GetSupportTotals", new Net_GetSupportTotals_Handler()),
Map.entry("GetSupportStats", new Net_GetSupportStats_Handler()),
Map.entry("GetGroupDialog", new Net_GetGroupDialog_Handler()),
Map.entry("ListGroupChats200", new Net_ListGroupChats200_Handler()),
Map.entry("GetChannelsCounters", new Net_GetChannelsCounters_Handler()),
@@ -371,6 +374,7 @@ public final class JsonHandlerRegistry {
Map.entry("GetMessageThread", Net_GetMessageThread_Request.class),
Map.entry("GetMessageLikes", Net_GetMessageLikes_Request.class),
Map.entry("GetSupportTotals", Net_GetSupportTotals_Request.class),
Map.entry("GetSupportStats", Net_GetSupportStats_Request.class),
Map.entry("GetGroupDialog", Net_GetGroupDialog_Request.class),
Map.entry("ListGroupChats200", Net_ListGroupChats200_Request.class),
Map.entry("GetChannelsCounters", Net_GetChannelsCounters_Request.class),
@@ -0,0 +1,83 @@
package server.logic.ws_protocol.JSON.handlers.channels;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import server.logic.ws_protocol.JSON.ConnectionContext;
import server.logic.ws_protocol.JSON.entyties.Net_Request;
import server.logic.ws_protocol.JSON.entyties.Net_Response;
import server.logic.ws_protocol.JSON.handlers.JsonMessageHandler;
import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetSupportStats_Request;
import server.logic.ws_protocol.JSON.handlers.channels.entyties.Net_GetSupportStats_Response;
import server.logic.ws_protocol.JSON.utils.NetExceptionResponseFactory;
import server.logic.ws_protocol.WireCodes;
import shine.db.DbController;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.util.Locale;
/**
* Публичные три суммы из локальной PostgreSQL без RPC на каждый профиль.
* Индексатор формирует кеш только из финализированных on-chain донатов.
*/
public final class Net_GetSupportStats_Handler implements JsonMessageHandler {
private static final Logger log = LoggerFactory.getLogger(Net_GetSupportStats_Handler.class);
@Override
public Net_Response handle(Net_Request baseRequest, ConnectionContext ctx) {
var req = (Net_GetSupportStats_Request) baseRequest;
String login = req.getLogin() == null ? "" : req.getLogin().trim();
if (login.isEmpty() || login.length() > 255 || login.chars().anyMatch(c -> Character.isISOControl(c))) {
return NetExceptionResponseFactory.error(req, WireCodes.Status.BAD_REQUEST,
"bad_login", "Некорректный логин");
}
var result = new Net_GetSupportStats_Response();
result.setOp(req.getOp());
result.setRequestId(req.getRequestId());
result.setStatus(WireCodes.Status.OK);
result.setLogin(login);
result.setAvailable(false);
result.setReady(false);
result.setSupportSentLamports("0");
result.setSupportReceivedLamports("0");
result.setDaoDirectLamports("0");
try (Connection c = DbController.getInstance().getConnection()) {
try (PreparedStatement ps = c.prepareStatement(
"SELECT history_complete FROM solana_support_sync_state WHERE id=1")) {
try (ResultSet rs = ps.executeQuery()) {
if (!rs.next() || !rs.getBoolean(1)) return result;
}
}
result.setReady(true);
try (PreparedStatement ps = c.prepareStatement(
"SELECT 1 FROM solana_user_pda_current WHERE normalized_login=? LIMIT 1")) {
ps.setString(1, login.toLowerCase(Locale.ROOT));
try (ResultSet rs = ps.executeQuery()) {
if (!rs.next()) return result; // Free-пользователю не придумываем статистику
}
}
result.setAvailable(true);
try (PreparedStatement ps = c.prepareStatement("""
SELECT support_sent, support_received, dao_direct
FROM solana_support_user_stats WHERE normalized_login=?
""")) {
ps.setString(1, login.toLowerCase(Locale.ROOT));
try (ResultSet rs = ps.executeQuery()) {
if (rs.next()) {
result.setSupportSentLamports(rs.getBigDecimal(1).toBigIntegerExact().toString());
result.setSupportReceivedLamports(rs.getBigDecimal(2).toBigIntegerExact().toString());
result.setDaoDirectLamports(rs.getBigDecimal(3).toBigIntegerExact().toString());
}
}
}
result.setReady(true);
return result;
} catch (SQLException failure) {
log.error("GetSupportStats failed for {}", login, failure);
return NetExceptionResponseFactory.error(req, WireCodes.Status.INTERNAL_ERROR,
"support_stats_unavailable", "Статистика поддержки недоступна");
}
}
}
@@ -0,0 +1,10 @@
package server.logic.ws_protocol.JSON.handlers.channels.entyties;
import server.logic.ws_protocol.JSON.entyties.Net_Request;
/** Публичная статистика поддержки Paid-пользователя, логин SHiNE. */
public final class Net_GetSupportStats_Request extends Net_Request {
private String login;
public String getLogin() { return login; }
public void setLogin(String value) { login = value; }
}
@@ -0,0 +1,26 @@
package server.logic.ws_protocol.JSON.handlers.channels.entyties;
import server.logic.ws_protocol.JSON.entyties.Net_Response;
/** Суммы передаются строками в lamports: JS Number теряет точность u64. */
public final class Net_GetSupportStats_Response extends Net_Response {
private String login;
private boolean available;
private boolean ready;
private String supportSentLamports;
private String supportReceivedLamports;
private String daoDirectLamports;
public String getLogin() { return login; }
public void setLogin(String value) { login = value; }
public boolean isAvailable() { return available; }
public void setAvailable(boolean value) { available = value; }
public boolean isReady() { return ready; }
public void setReady(boolean value) { ready = value; }
public String getSupportSentLamports() { return supportSentLamports; }
public void setSupportSentLamports(String value) { supportSentLamports = value; }
public String getSupportReceivedLamports() { return supportReceivedLamports; }
public void setSupportReceivedLamports(String value) { supportReceivedLamports = value; }
public String getDaoDirectLamports() { return daoDirectLamports; }
public void setDaoDirectLamports(String value) { daoDirectLamports = value; }
}
@@ -57,8 +57,12 @@ public final class SupportHistoryIndexer {
connection.setAutoCommit(false);
try {
for (SupportEvent event : events) {
insert(connection, signature, event);
indexed++;
// Счётчики изменяются только при действительно новой записи журнала.
// Повторная обработка одной инструкции не может удвоить суммы.
if (insert(connection, signature, event)) {
incrementUserStats(connection, event);
indexed++;
}
}
try (PreparedStatement stmt = connection.prepareStatement(
"UPDATE solana_support_sync_state SET last_signature=?, last_slot=?, updated_at=now() WHERE id=1")) {
@@ -74,6 +78,12 @@ public final class SupportHistoryIndexer {
connection.setAutoCommit(true);
}
}
// Признак готовности устанавливается только после полного успешного прохода.
// После аварии на середине истории публичные нули не показываем.
try (PreparedStatement ready = connection.prepareStatement(
"UPDATE solana_support_sync_state SET history_complete=TRUE WHERE id=1")) {
ready.executeUpdate();
}
log.info("Support history synchronized: scanned={} newEvents={} checkpoint={}",
signatures.size(), indexed, signatures.isEmpty() ? checkpoint : signatures.get(signatures.size()-1).signature());
}
@@ -92,6 +102,13 @@ public final class SupportHistoryIndexer {
s.executeUpdate("CREATE TABLE IF NOT EXISTS solana_support_sync_state (" +
"id INT PRIMARY KEY CHECK(id=1), last_signature TEXT, last_slot BIGINT, updated_at TIMESTAMPTZ NOT NULL DEFAULT now())");
s.executeUpdate("INSERT INTO solana_support_sync_state(id) VALUES(1) ON CONFLICT DO NOTHING");
s.executeUpdate("ALTER TABLE solana_support_sync_state ADD COLUMN IF NOT EXISTS stats_cache_ready BOOLEAN NOT NULL DEFAULT FALSE");
s.executeUpdate("ALTER TABLE solana_support_sync_state ADD COLUMN IF NOT EXISTS history_complete BOOLEAN NOT NULL DEFAULT FALSE");
s.executeUpdate("CREATE TABLE IF NOT EXISTS solana_support_user_stats (" +
"normalized_login TEXT PRIMARY KEY, " +
"support_sent NUMERIC(20,0) NOT NULL DEFAULT 0, " +
"support_received NUMERIC(20,0) NOT NULL DEFAULT 0, " +
"dao_direct NUMERIC(20,0) NOT NULL DEFAULT 0)");
s.executeUpdate("CREATE TABLE IF NOT EXISTS solana_support_transfers (" +
"signature TEXT NOT NULL, instruction_index INT NOT NULL, slot BIGINT NOT NULL, " +
"block_time BIGINT, kind TEXT NOT NULL, sender_login TEXT NOT NULL, recipient_login TEXT, " +
@@ -112,9 +129,94 @@ public final class SupportHistoryIndexer {
"FROM solana_support_transfers WHERE kind='USER' AND target_type=2 " +
"GROUP BY channel_block_number, channel_block_hash, message_block_number, message_block_hash");
}
backfillUserStats(c);
}
private static void insert(Connection c, SolanaRpcClient.SignatureRecord signature, SupportEvent event) throws SQLException {
/** Однократная миграция прежнего журнала. Исторические записи уже могли быть
* синхронизированы до появления кеша; перестраиваем его транзакционно. */
private static void backfillUserStats(Connection c) throws SQLException {
boolean previousAutocommit = c.getAutoCommit();
c.setAutoCommit(false);
try {
boolean ready;
try (Statement s = c.createStatement(); ResultSet r = s.executeQuery(
"SELECT stats_cache_ready FROM solana_support_sync_state WHERE id=1 FOR UPDATE")) {
if (!r.next()) throw new SQLException("Support sync state missing");
ready = r.getBoolean(1);
}
if (!ready) {
try (Statement s = c.createStatement()) {
s.executeUpdate("DELETE FROM solana_support_user_stats");
s.executeUpdate("""
INSERT INTO solana_support_user_stats(normalized_login, support_sent, support_received, dao_direct)
SELECT lower(btrim(login)), SUM(sent), SUM(received), SUM(direct)
FROM (
SELECT sender_login AS login,
CASE WHEN kind='USER' THEN amount_lamports ELSE 0 END AS sent,
0::NUMERIC AS received,
CASE WHEN kind='DAO' THEN amount_lamports ELSE 0 END AS direct
FROM solana_support_transfers
UNION ALL
SELECT recipient_login AS login, 0::NUMERIC AS sent,
recipient_lamports AS received, 0::NUMERIC AS direct
FROM solana_support_transfers WHERE kind='USER'
) history
GROUP BY lower(btrim(login))
""");
s.executeUpdate("UPDATE solana_support_sync_state SET stats_cache_ready=TRUE WHERE id=1");
}
log.info("Support user statistics cache initialized from transaction history");
}
c.commit();
} catch (SQLException failure) {
c.rollback();
throw failure;
} finally {
c.setAutoCommit(previousAutocommit);
}
}
/** Чистая функция: одинаковая раскладка используется в SQL-агрегаторе и тестах. */
public static List<UserStatsIncrement> userStatsIncrements(SupportEvent event) {
if ("USER".equals(event.kind())) {
return List.of(
new UserStatsIncrement(event.sender(), event.amount(), BigInteger.ZERO, BigInteger.ZERO),
new UserStatsIncrement(event.recipient(), BigInteger.ZERO, event.recipientAmount(), BigInteger.ZERO));
}
if ("DAO".equals(event.kind())) {
return List.of(new UserStatsIncrement(event.sender(), BigInteger.ZERO, BigInteger.ZERO, event.amount()));
}
throw new IllegalArgumentException("Unknown support event kind");
}
public record UserStatsIncrement(String login, BigInteger sent, BigInteger received, BigInteger direct) {}
/** Atomically update both participants after inserting the unique event. */
private static void incrementUserStats(Connection c, SupportEvent event) throws SQLException {
for (UserStatsIncrement delta : userStatsIncrements(event)) {
addUserStats(c, delta.login(), delta.sent(), delta.received(), delta.direct());
}
}
private static void addUserStats(Connection c, String login, BigInteger sent, BigInteger received, BigInteger direct)
throws SQLException {
try (PreparedStatement s = c.prepareStatement("""
INSERT INTO solana_support_user_stats(normalized_login, support_sent, support_received, dao_direct)
VALUES (lower(btrim(?)), ?, ?, ?)
ON CONFLICT (normalized_login) DO UPDATE SET
support_sent=solana_support_user_stats.support_sent+EXCLUDED.support_sent,
support_received=solana_support_user_stats.support_received+EXCLUDED.support_received,
dao_direct=solana_support_user_stats.dao_direct+EXCLUDED.dao_direct
""")) {
s.setString(1, login);
s.setBigDecimal(2, new java.math.BigDecimal(sent));
s.setBigDecimal(3, new java.math.BigDecimal(received));
s.setBigDecimal(4, new java.math.BigDecimal(direct));
s.executeUpdate();
}
}
private static boolean insert(Connection c, SolanaRpcClient.SignatureRecord signature, SupportEvent event) throws SQLException {
try (PreparedStatement s = c.prepareStatement("INSERT INTO solana_support_transfers (" +
"signature,instruction_index,slot,block_time,kind,sender_login,recipient_login,amount_lamports," +
"recipient_lamports,inflow_lamports,target_type,channel_block_number,channel_block_hash," +
@@ -134,7 +236,7 @@ public final class SupportHistoryIndexer {
s.setString(13, event.channelHash());
if (event.messageNumber() == null) s.setNull(14, Types.NUMERIC); else s.setBigDecimal(14, new java.math.BigDecimal(event.messageNumber()));
s.setString(15, event.messageHash());
s.executeUpdate();
return s.executeUpdate() == 1;
}
}
@@ -45,4 +45,28 @@ class SupportHistoryIndexerTest {
var out = new ByteArrayOutputStream();out.write(10);str(out,"alice@ns");u64(out,-1L);
assertEquals("18446744073709551615", SupportHistoryIndexer.decodeInstruction(out.toByteArray(),0).amount().toString());
}
@Test void userStatsIncrementsUseFullSentAndNetReceived() {
var out = new ByteArrayOutputStream();
out.write(9); str(out, "Alice@NS"); str(out, "Bob@NS"); u64(out, 1000); out.write(0);
var event = SupportHistoryIndexer.decodeInstruction(out.toByteArray(), 1);
var deltas = SupportHistoryIndexer.userStatsIncrements(event);
assertEquals(2, deltas.size());
assertEquals("Alice@NS", deltas.get(0).login());
assertEquals(BigInteger.valueOf(1000), deltas.get(0).sent());
assertEquals(BigInteger.ZERO, deltas.get(0).received());
assertEquals("Bob@NS", deltas.get(1).login());
assertEquals(BigInteger.valueOf(900), deltas.get(1).received());
assertEquals(BigInteger.ZERO, deltas.get(1).direct());
}
@Test void daoIncrementsOnlyDirectCounter() {
var out = new ByteArrayOutputStream();
out.write(10); str(out, "Alice@NS"); u64(out, 500);
var deltas = SupportHistoryIndexer.userStatsIncrements(
SupportHistoryIndexer.decodeInstruction(out.toByteArray(), 0));
assertEquals(1, deltas.size());
assertEquals(BigInteger.ZERO, deltas.get(0).sent());
assertEquals(BigInteger.ZERO, deltas.get(0).received());
assertEquals(BigInteger.valueOf(500), deltas.get(0).direct());
}
}
+2 -2
View File
@@ -1,2 +1,2 @@
client.version=1.20.35
server.version=1.16.20
client.version=1.20.36
server.version=1.16.21
+25
View File
@@ -170,3 +170,28 @@ SELECT schema_version FROM db_schema_version WHERE id=1;
### Обновление namespace registration_fee / currency_code
Серверная БД мигрирует v39→v40 (колонка `shine_namespace_current.currency_code`). Перед активацией нового контракта следует установить совместимый сервер-sync: новый opcode 8 индексируется через историю economy PDA, namespace 1.0/1.1 читаются совместимо, `UPSERT` обновляет цену вместо прежней ошибочной проверки `raw_data_base64 = EXCLUDED.raw_data_base64`. Проверить `GetNamespaces` и `CheckRegistrationLogin` после подтверждения транзакции; при задержке history polling информация может обновиться не мгновенно.
## Кеш статистики поддержки профилей (12.11.2026)
Новых настроек и отдельных сервисов нет. При `solana.users.sync.enabled=true`
существующий `SupportHistoryIndexer` использует прежнее Solana RPC/Helius и
PostgreSQL подключение. При первом запуске обновлённой версии автоматически
создаёт таблицу `solana_support_user_stats` и пересчитывает прошлые донаты из
`solana_support_transfers`. После этого новые финализированные переводы
увеличивают готовые счётчики инкрементально. При первом восстановлении
с нуля `GetSupportStats` возвращает `ready=false` до конца сканирования.
Для диагностики (вручную выполнять при установке **не требуется**):
```sql
SELECT history_complete, stats_cache_ready, last_signature, updated_at
FROM solana_support_sync_state WHERE id=1;
SELECT normalized_login, support_sent, support_received, dao_direct
FROM solana_support_user_stats ORDER BY support_received DESC LIMIT 20;
```
В случае подозрения на рассогласование кеша остановить синхронизатор,
выполнить `UPDATE solana_support_sync_state SET stats_cache_ready=FALSE WHERE id=1`
и вновь запустить. Журнал финансовых операций при этом сохраняется.
+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`.
+1
View File
@@ -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` | связи пользователя в профиле |
+33 -2
View File
@@ -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 без специальной
процедуры повторной полной индексации.
+27 -4
View File
@@ -1,5 +1,5 @@
import { t } from '../i18n/index.js';
import { readShineUserPda } from '../services/shine-user-pda-service.js';
import { authService } from '../state.js';
import { formatLamportsSol } from '../services/shine-support-amount.js';
export function supportStatsValues(stats = {}) {
@@ -10,7 +10,7 @@ export function supportStatsValues(stats = {}) {
}
/** Adds an independent asynchronous block; failure/Free accounts do not get fictitious statistics. */
export function attachSupportStats(parent, { login, solanaEndpoint, isActive = () => true }) {
export function attachSupportStats(parent, { login, isActive = () => true }) {
const section = document.createElement('section');
section.className = 'card stack profile-support-stats';
section.style.cssText = 'margin-top:12px;gap:8px;';
@@ -21,11 +21,34 @@ export function attachSupportStats(parent, { login, solanaEndpoint, isActive = (
content.textContent = t('screens.support_phase2.loading');
section.append(title, content);
parent.append(section);
let pendingRefresh = null;
const scheduleRetry = () => {
if (pendingRefresh !== null) return;
pendingRefresh = window.setTimeout(() => {
pendingRefresh = null;
if (isActive() && section.isConnected) void refresh();
}, 10_000);
};
const refresh = async () => {
try {
const pda = await readShineUserPda({ login, solanaEndpoint });
const stats = await authService.getSupportStats(login);
if (!isActive() || !section.isConnected) return;
const values = supportStatsValues(pda.supportStats ?? {});
if (!stats.ready) {
// Первичная индексация ещё идёт. Повторим запрос к кешу без RPC Solana.
content.textContent = t('screens.support_phase2.loading');
scheduleRetry();
return;
}
if (!stats.available) {
// Free-аккаунты не имеют Paid PDA, поэтому блок статистики не показываем.
section.remove();
return;
}
const values = supportStatsValues({
supportSent: stats.supportSentLamports,
supportReceived: stats.supportReceivedLamports,
daoDirect: stats.daoDirectLamports,
});
content.replaceChildren();
content.className = 'stack';
[t('screens.support_phase2.sent'), t('screens.support_phase2.received'), t('screens.support_phase2.shine')].forEach((label, idx) => {
+1 -1
View File
@@ -67,7 +67,7 @@ export function render({ navigate, chrome }) {
<button class="nav-row" type="button" data-self-profile-action="profiles"><span class="nav-row__label">${th('screens.profile_view.text_015')}</span><span class="nav-row__hint">${th('screens.profile_view.text_016')}</span></button>
</div>`;
attachSupportStats(body, { login: card.login || login, solanaEndpoint: state.entrySettings.solanaServer, isActive: () => !disposed });
attachSupportStats(body, { login: card.login || login, isActive: () => !disposed });
avatarPreview = attachProfileAvatarPreview(body.querySelector('.user-profile-avatar-slot'), card);
status.replaceChildren();
+1 -1
View File
@@ -67,7 +67,7 @@ export function render({ navigate, route, chrome }) {
].join(''),
});
attachSupportStats(body, { login: card.login, solanaEndpoint: state.entrySettings.solanaServer, isActive: () => !disposed });
attachSupportStats(body, { login: card.login, isActive: () => !disposed });
syncRelationTile();
avatarPreview = attachProfileAvatarPreview(body.querySelector('.user-profile-avatar-slot'), card);
+6
View File
@@ -1598,6 +1598,12 @@ export class AuthService {
return response.payload || {};
}
async getSupportStats(login) {
const response = await this.ws.request('GetSupportStats', { login: String(login || '').trim() });
if (response.status !== 200) throw opError('GetSupportStats', response);
return response.payload || {};
}
async getSupportTotals(channel) {
const payload = {
channelRootBlockNumber: Number(channel?.channelRootBlockNumber),
+11 -1
View File
@@ -8,9 +8,10 @@ function file(path) { return readFileSync(new URL(path, import.meta.url), 'utf8'
test('three displayed counters: full sent, net received, sent/10 + direct', () => {
assert.deepEqual(supportStatsValues({ supportSent: 1_000_000_000n, supportReceived: 900_000_000n, daoDirect: 200_000_000n }), [1_000_000_000n, 900_000_000n, 300_000_000n]);
assert.deepEqual(supportStatsValues({}), [0n, 0n, 0n]);
assert.deepEqual(supportStatsValues({ supportSent: '10000000000000000000', supportReceived: '9000000000000000000', daoDirect: '250000000000000000' }), [10000000000000000000n, 9000000000000000000n, 1250000000000000000n]);
});
test('profile views attach counters from Solana PDA and support user action', () => {
test('profile views attach counters from server cache and support user action', () => {
assert.match(file('../js/pages/profile-view.js'), /attachSupportStats\(body/);
const other = file('../js/pages/user-profile-view.js');
assert.match(other, /attachSupportStats\(body/);
@@ -41,3 +42,12 @@ test('shared modal protects direct and tracked workflows', () => {
assert.match(src, /window\.confirm\(t\('screens\.support_phase2\.direct_warning'\)\)/);
assert.match(src, /amount % 10n/);
});
test('profile statistics use server API without Solana RPC', () => {
const component = file('../js/components/support-stats.js');
const auth = file('../js/services/auth-service.js');
assert.match(component, /authService\.getSupportStats\(login\)/);
assert.doesNotMatch(component, /readShineUserPda/);
assert.match(component, /if \(!stats\.ready\)/);
assert.match(auth, /this\.ws\.request\('GetSupportStats'/);
});