Перевести донаты на 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
@@ -202,12 +202,14 @@ Legacy migration в 1.2 отсутствует. После удаления те
| Смещение | Поле | Формат |
| --- | --- | --- |
| 0 | version | `u8` (`1`) |
| 0 | version | `u8` (`2` — Stars cents) |
| 1 | support_sent | `u64 LE` |
| 9 | support_received | `u64 LE` |
| 17 | dao_direct | `u64 LE` |
Полный размер v1 — 25 байт. Если за `record_len` нет байтов либо первый байт
равен `0`, это v0 и все значения равны нулю. Неизвестная версия или неполный
v1 являются повреждённым форматом. Программа вправе обновлять этот блок без
пользовательской подписи; при update старой записи v0 он создаётся автоматически.
Полный размер v2 — 25 байт. Все три `u64` — **сотые доли Stars**, не lamports.
Если блока нет или версия `0`, счётчики равны нулю. В чистой тестовой сети
блок v1 со старыми lamports намеренно игнорируется (значения = 0) и при
следующей записи PDA заменяется v2 без переноса сумм. Неизвестные версии
отклоняются. Программа обновляет блок без отдельной пользовательской подписи,
атомарно с переводом SOL при успешном донате.
+36 -11
View File
@@ -190,15 +190,40 @@ Accounts: signer/current upgrade authority writable, namespace PDA writable, sys
`20_000` lamports в существующий `shine_payments_inflow_vault`, дополнительно к
оплате увеличения лимита и rent. Ошибка инструкции откатывает и запись, и перевод.
Инструкция `9` (`support_user`) принимает sender/recipient login, `u64 LE`
сумму, target (`USER=0`, `CHANNEL=1`, `MESSAGE=2`) и соответствующие бинарные
идентификаторы блоков/хешей. Сумма положительна и кратна 10; 90% переводится
актуальному blockchain-key получателя, 10% — только в inflow vault. Отправитель
и получатель обязаны быть разными paid PDA с актуальными ключами. В транзакции
read-only присутствует economy PDA для индексирования. Обновляются
`support_sent` и `support_received`.
### Stars v1 (Devnet, без истории legacy)
Инструкция `10` (`support_dao`) принимает login и положительную сумму, переводит
100% в тот же inflow vault и увеличивает `dao_direct`. Она также требует paid PDA,
актуальный blockchain key и read-only economy PDA. Ни одна из инструкций не
переводит средства непосредственно в `dao_wallet`.
Все инструкции поддержки передают `amount_lamports:u64 LE` и
`amount_star_cents:u64 LE` (1 ⭐ = 100 cents, минимум 10 cents = 0,10 ⭐).
Курс Stars = 1 USDT; на входе SOL/USD и USDT/USD как readonly
`PriceUpdateV2` Pyth (после `system_program`). Программа проверяет owner
Pyth Receiver, точный feed id, полную верификацию, возраст ≤ 3600 сек (1 час для Devnet),
относительную погрешность цены ≤ 1% и совпадение стоимости в Stars
с погрешностью ≤ 0,5%. Нарушение любого ограничения откатывает перевод.
**Важно перед Mainnet:** часовой лимит установлен только для нестабильного Devnet.
Перед публикацией Stars в Mainnet нужно отдельно выбрать и задеплоить более строгий
лимит свежести Pyth; значение `3600` нельзя переносить в Mainnet автоматически.
Инструкция `9` (`support_user`) сериализуется как:
`tag=9; sender_login:string_u8; recipient_login:string_u8; amount_lamports:u64LE;
amount_star_cents:u64LE; target:u8; [channel_number:u64LE;channel_hash:bytes32];
[message_number:u64LE;message_hash:bytes32]`.
Счётчик `support_sent` увеличивается на полную сумму Stars; `support_received`
получателя — на `amount_star_cents - ceil(amount_star_cents/10)`.
Фактические SOL распределяются 90/10 с округлением доли vault вверх до
одного lamport. Получатель должен быть отдельным Paid PDA с актуальным ключом.
Инструкция `10` (`support_dao`):
`tag=10; sender_login:string_u8; amount_lamports:u64LE; amount_star_cents:u64LE`.
Все SOL идут в `shine_payments_inflow_vault`, счётчик `dao_direct` увеличивается
на Stars. Оба вида донатов используют readonly economy PDA для индексации.
В конце каждой успешной инструкции выводится транзакционный лог
`SHINE_STARS_V1|USER|sender|recipient|lamports|star_cents|author_cents|dao_cents`
либо `SHINE_STARS_V1|DAO|sender|-|lamports|star_cents|0|star_cents`.
Это доказательство успешной операции для индексатора вместе с meta.err=null.
Stars не имеют токена/баланса: это только неизменяемые суммы поддержки.
В чистом тестовом запуске исторические счётчики lamports v1 принимаются за нуль
и при следующем обновлении PDA заменяются форматом Stars v2; история тех
переводов не импортируется.