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

3.8 KiB
Raw Blame History

Движение Средств (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.