Перевести донаты на Stars и обновить Devnet

This commit is contained in:
AidarKC
2026-11-14 00:55:02 +03:00
parent c972a975fd
commit 97db033eb8
39 changed files with 1020 additions and 198 deletions
+34 -7
View File
@@ -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`; старые тестовые донаты игнорируются.
+2 -1
View File
@@ -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` | связи пользователя в профиле |