SHA256
Доделать донаты и статистику поддержки
This commit is contained in:
+4
@@ -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),
|
||||
|
||||
+83
@@ -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", "Статистика поддержки недоступна");
|
||||
}
|
||||
}
|
||||
}
|
||||
+10
@@ -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; }
|
||||
}
|
||||
+26
@@ -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; }
|
||||
}
|
||||
+106
-4
@@ -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;
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
+24
@@ -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
@@ -1,2 +1,2 @@
|
||||
client.version=1.20.35
|
||||
server.version=1.16.20
|
||||
client.version=1.20.36
|
||||
server.version=1.16.21
|
||||
|
||||
@@ -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`
|
||||
и вновь запустить. Журнал финансовых операций при этом сохраняется.
|
||||
|
||||
@@ -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 без специальной
|
||||
процедуры повторной полной индексации.
|
||||
|
||||
@@ -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) => {
|
||||
|
||||
@@ -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();
|
||||
|
||||
@@ -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);
|
||||
|
||||
@@ -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),
|
||||
|
||||
@@ -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'/);
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user