Files
SHiNE-server/shine-solana/shine/doc/FUNDS_FLOW.md
T

56 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Движение Средств (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`.