SHA256
56 lines
3.8 KiB
Markdown
56 lines
3.8 KiB
Markdown
# Движение Средств (Shine)
|
||
|
||
Документ описывает, как перемещаются средства между счетами в текущей схеме.
|
||
|
||
## 1) Регистрация и увеличение лимита (`shine_users`)
|
||
|
||
### Регистрация пользователя (`create_user_pda`)
|
||
|
||
1. Плательщик: кошелёк `signer` (плательщик транзакции).
|
||
2. Цена регистрации берётся из **`namespace.registration_fee`**, а не из старой стоимости economy-конфига.
|
||
3. Из цены namespace оплачивается фактическое пополнение депозита для нового PDA до `Rent::minimum_balance(USER_PDA_SPACE)`. Если PDA уже пополнена, требуется только недостающая часть.
|
||
4. В `inflow_vault` (PDA программы `shine_payments`) переводится `namespace.registration_fee - фактически оплаченный депозит PDA` плюс стоимость `additional_limit` (если он есть). Если цена namespace меньше полной минимальной стоимости rent PDA, создание отклоняется даже для заранее пополненной PDA; отрицательный остаток невозможен.
|
||
5. Сеть Solana отдельно списывает фактическую транзакционную комиссию с кошелька-плательщика. Она **не входит** в цену namespace и не является доходом проекта. Базовая комиссия за одну подпись обычно составляет 5 000 lamports, но итоговая цена транзакции определяется сетью.
|
||
|
||
### Увеличение лимита (`update_user_pda`)
|
||
|
||
1. Плательщик: кошелек `signer`.
|
||
2. Получатель комиссии: `inflow_vault` (тот же PDA `shine_payments`).
|
||
3. Сумма перевода:
|
||
- только комиссия за `additional_limit` (без регистрационной части).
|
||
|
||
## 2) Покупка билета (`shine_payments`)
|
||
|
||
### Покупка (`buy_ticket`, `buy_ticket_usd`, `buy_ticket_sol`)
|
||
|
||
1. Плательщик: кошелек покупателя (`signer`).
|
||
2. Получатель: `dao_wallet` (казна DAO из `ConfigState`).
|
||
3. В `inflow_vault` на этом шаге средства не зачисляются.
|
||
|
||
## 3) Шаг выплат (`shine_payments::step_payout`)
|
||
|
||
Источник выплат: `inflow_vault` (`ConfigState.inflow_vault`).
|
||
|
||
Порядок очередей:
|
||
1. сначала `Q1`;
|
||
2. потом `Q2`;
|
||
3. потом `Q3`.
|
||
|
||
При шаге выплаты:
|
||
1. Из `inflow_vault` переводится `ticket` получателю тикета.
|
||
2. Из `inflow_vault` переводится DAO-часть в `dao_wallet`.
|
||
- для `Q1` это `1x payout_usd`;
|
||
- для `Q2` это `2x payout_usd`;
|
||
- для `Q3` это `3x payout_usd`;
|
||
3. Из `inflow_vault` переводится `call_reward_lamports` вызывающему шаг.
|
||
|
||
Если очереди пусты:
|
||
1. Весь доступный остаток `inflow_vault` переводится в `dao_wallet`.
|
||
|
||
## 4) Какие адреса задаются настройками
|
||
|
||
1. `dao_wallet` — хранится в `ConfigState` (`shine_payments`), задается при `init`.
|
||
2. `inflow_vault` — PDA `shine_payments`, вычисляется по seed и program id.
|
||
3. Для `shine_users` получатель комиссии не настраивается отдельно:
|
||
- всегда используется PDA `inflow_vault` программы `shine_payments`.
|