Перевести донаты на 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
+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; история тех
переводов не импортируется.