SHA256
Перевести донаты на Stars и обновить Devnet
This commit is contained in:
@@ -654,7 +654,7 @@ Changing `account_role` or `shine` does not alter the raw reaction. The two qual
|
||||
|
||||
Запрос: `{"op":"GetSupportTotals", "channelRootBlockNumber":12, "channelRootBlockHash":"<64 hex>"}`.
|
||||
|
||||
Ответ (при `status=200`): `channelReceivedLamports` — десятичная строка суммы реально полученных авторами средств (90% донатов); `messages` — массив `{blockNumber,blockHash,receivedLamports}`. Все значения в lamports представлены **строками**, не JavaScript Number. В результате возвращаются не более 2000 сообщений с максимальными суммами, агрегат канала включает все проверенные операции.
|
||||
Ответ (при `status=200`): `channelReceivedStarCents` — десятичная строка стоимости поддержки, полученной авторами в сотых долях ⭐ после комиссии DAO; `messages` — массив `{blockNumber,blockHash,receivedStarCents}`. Все денежные значения представлены **строками**, не JavaScript Number. В результате возвращаются не более 2000 сообщений с максимальными суммами, агрегат канала включает все проверенные операции.
|
||||
|
||||
API считает только `support_user` из таблицы `solana_support_transfers`. Для CHANNEL проверяет, что адресат равен владельцу существующего канала. Для MESSAGE проверяет наличие блока с точным номером/хешем, авторство получателя и принадлежность блока цепочке владельца канала. Не соответствующие этим условиям донаты остаются в истории, но не включаются в публичные суммы. Поддержка ответов в других пользовательских цепочках не попадает в агрегат до добавления полной проверки принадлежности обсуждению.
|
||||
|
||||
@@ -681,9 +681,9 @@ API считает только `support_user` из таблицы `solana_suppo
|
||||
"op":"GetSupportStats", "requestId":"support-1", "status":200, "ok":true,
|
||||
"payload":{
|
||||
"login":"Alice@namespace", "available":true, "ready":true,
|
||||
"supportSentLamports":"1000000000",
|
||||
"supportReceivedLamports":"900000000",
|
||||
"daoDirectLamports":"100000000"
|
||||
"supportSentStarCents":"1000",
|
||||
"supportReceivedStarCents":"900",
|
||||
"daoDirectStarCents":"100"
|
||||
}
|
||||
}
|
||||
```
|
||||
@@ -694,10 +694,37 @@ API считает только `support_user` из таблицы `solana_suppo
|
||||
суммы **нельзя** показывать как окончательные (даже если возвращены нули).
|
||||
- `available=true, ready=true`, а строки сумм равны `"0"` — корректная нулевая
|
||||
статистика зарегистрированного Paid-пользователя без донатов.
|
||||
- Все значения lamports передаются **строками** (без преобразования в JS Number).
|
||||
Показатель «Поддержал SHiNE» вычисляется как `supportSentLamports / 10 +
|
||||
daoDirectLamports`. Регистрация и изменение PDA сюда не входят.
|
||||
- Все значения Stars — **целые сотые доли**, сериализованные строками.
|
||||
`supportSentStarCents` — пожертвования авторам до доли DAO;
|
||||
`supportReceivedStarCents` — полученная авторами сумма после доли DAO;
|
||||
`daoDirectStarCents` — прямые пожертвования проекту. Доля DAO от поддержки
|
||||
авторам учитывается в каждой транзакции, но не суммируется в `daoDirect`.
|
||||
Регистрация и изменение PDA сюда не входят.
|
||||
|
||||
При отсутствии таблиц/соединения БД сервер возвращает ошибку, а не фиктивные нули.
|
||||
API не запускает RPC-вызовы; для свежих значений сразу после оплаты необходимо
|
||||
дождаться следующего прохода `SupportHistoryIndexer`.
|
||||
|
||||
|
||||
## Stars / Pyth — расчёт непосредственно в браузере
|
||||
|
||||
Серверная операция `GetStarsQuote` удалена в Stars v1.2.
|
||||
Клиент использует `getStarsQuoteFromRpc` и свой Solana RPC `state.entrySettings.solanaServer`.
|
||||
Из PDA Pyth Core (shard 0) читаются цены SOL/USD и USDT/USD одним запросом
|
||||
`getMultipleAccountsInfo`; на клиенте проверяются owner, discriminator,
|
||||
Full verification, feed ID, свежесть до 120 сек. и confidence <=1%.
|
||||
Платёж отправляется только после получения свежей котировки.
|
||||
Смарт-контракт выполняет свою независимую проверку.
|
||||
|
||||
|
||||
## GetSupportHistory — история пожертвований Stars
|
||||
|
||||
Публичный запрос: `{"op":"GetSupportHistory","requestId":"h-1","payload":{"login":"Alice@namespace","limit":20,"offset":0}}`.
|
||||
`limit=1..50`, `offset=0..10000`. Ответ: `ready`, `hasMore`, массив `transfers`.
|
||||
Каждый элемент включает `signature`, `instructionIndex`, `slot`, `blockTime`,
|
||||
`senderLogin`, `recipientLogin`, `kind`, `amountLamports`, `amountStarCents`,
|
||||
`recipientStarCents`, `daoStarCents`, `targetType`, идентификаторы канала/публикации.
|
||||
Денежные суммы — десятичные **строки целых единиц**, без float. При
|
||||
`ready=false` история ещё индексируется и не должна считаться полной.
|
||||
Данные берутся только из успешных финализированных транзакций с событиями
|
||||
`SHINE_STARS_V1`; старые тестовые донаты игнорируются.
|
||||
|
||||
@@ -69,7 +69,8 @@
|
||||
| `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-пользователя |
|
||||
| `GetSupportStats` | `06_Channels_Read_API.md` | три кешированных счётчика поддержки Paid-пользователя в Stars |
|
||||
| `GetSupportHistory` | `06_Channels_Read_API.md` | постраничная история финализированных донатов (Stars и SOL) |
|
||||
| `GetPersonalDiary` | `06_Channels_Read_API.md` | виртуальный канал `Личный дневник` из STATUS_ACTION |
|
||||
| `ListUserProfileChannels` | `06_Channels_Read_API.md` | публичные каналы профиля |
|
||||
| `ListUserProfileRelations` | `11_Connections_API.md` | связи пользователя в профиле |
|
||||
|
||||
@@ -0,0 +1,7 @@
|
||||
-- ONLY FOR TEST SERVER. Discard OLD support history, no backfill.
|
||||
DROP VIEW IF EXISTS solana_support_message_totals CASCADE;
|
||||
DROP VIEW IF EXISTS solana_support_channel_totals CASCADE;
|
||||
DROP TABLE IF EXISTS solana_support_transfers CASCADE;
|
||||
DROP TABLE IF EXISTS solana_support_user_stats CASCADE;
|
||||
DROP TABLE IF EXISTS solana_support_sync_state CASCADE;
|
||||
-- restart shine-server-solana-users-sync to recreate Stars-only schema.
|
||||
@@ -649,30 +649,29 @@ Instruction `shine_users` opcode 8 (`update_namespace_price`) передаёт e
|
||||
|
||||
`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`.
|
||||
Индексатор опрашивает `getSignaturesForAddress(shine_users_economy_config)` на **finalized** RPC (рекомендуется архивный Helius endpoint), при первом запуске читает все доступные подписи до начала истории, затем обрабатывает от старых к новым. Для успешных транзакций считывает `getTransaction(jsonParsed)` и инструкции `shine_users.support_user` (tag 9) и `shine_users.support_dao` (tag 10) версии Stars с обязательным `amount_star_cents`; события `SHINE_STARS_V1` сверяются по полям и количеству. Старые тестовые инструкции без Stars пропускаются (без миграции). Учитывает несколько инструкций в одной транзакции. Суммы сохраняются в PostgreSQL `NUMERIC(20,0)`, поскольку Solana `u64` может превышать Java `long`.
|
||||
|
||||
Таблицы: `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.
|
||||
Индексатор включается вместе с `solana.users.sync.enabled=true`, использует те же PostgreSQL credentials и RPC URL. Новый `GetSupportHistory` показывает финализированные переводы из этой таблицы с пагинацией и `ready`-состоянием. Реальный прогон полной архивной истории, тестирование с живым 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`
|
||||
При чистом запуске тестового сервера существующая история SOL не импортируется.
|
||||
В новый кеш агрегируются исключительно транзакции со стоимостью Stars в центах. Флаг `stats_cache_ready` в `solana_support_sync_state`
|
||||
предотвращает повторный полный подсчёт при каждом запуске.
|
||||
|
||||
Далее каждая новая уникальная инструкция записывается в журнал и увеличивает
|
||||
счётчики соответствующих пользователей **в одной PostgreSQL-транзакции с
|
||||
checkpoint**. Повторная инструкция с теми же `(signature, instruction_index)`
|
||||
не увеличивает кеш. Для `support_user`: отправителю прибавляется вся сумма,
|
||||
получателю — 90%. Для `support_dao`: отправителю прибавляется вся сумма в
|
||||
получателю — сумма Stars после округления 10% DAO вверх до сотой. Для `support_dao`: отправителю прибавляется вся сумма в
|
||||
`dao_direct`. Первая история может занимать время; флаг `history_complete`
|
||||
становится TRUE только после успешного полного прохода. API `GetSupportStats`
|
||||
при FALSE возвращает `ready=false`, чтобы не показывать неполные суммы.
|
||||
|
||||
Reference in New Issue
Block a user