SHA256
Перевести донаты на Stars и обновить Devnet
This commit is contained in:
@@ -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 при успешном донате.
|
||||
|
||||
@@ -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; история тех
|
||||
переводов не импортируется.
|
||||
|
||||
Reference in New Issue
Block a user