Files
pump-game-ops/docs/ECONOMY.md
T

34 lines
2.5 KiB
Markdown

# ECONOMY.md — экономика игрового токена (заполняется в Фазе 0)
**Статус:** частично заполнено, утверждённые решения зафиксированы (ADR-001..005). Сам токен ещё не эмитирован.
Цель — зафиксировать **все ключевые параметры токена и экономики**, чтобы дальше ссылаться на них, а не вспоминать в чате.
## Пользовательский флоу (утверждено, ADR-005)
1. Игрок подключает Phantom → баланс **0**.
2. Кнопка **«Пополнить»** (одна, без выбора) → наш бэкенд swap **SOL→фантики** → баланс появляется.
3. Игрок ставит **фантики** через контракт (честное списание/начисление по исходу).
4. Кнопка **«Вывести»** → swap **фантики→SOL** → баланс уменьшается, игрок забирает SOL.
## Токен
- **Название:** Binary Rocket (уточнить финальное имя/символ)
- **Тип:** свой мемкойн на pump.fun, Solid SPL / **Token-2022**
- **decimals:** `6` (по доке pump.fun `create_v2`)
- **Эмитент:** наш адрес (кошелёк/программа)
- **Mint-адрес:** *(заполнить после создания — в Фазе 4)*
- **Bonding curve:** *(заполнить после создания)*
- **URI метаданных:** *(IPFS)*
## Курс и балансы
- **Курс:** живой рыночный (ADR-002). Ввод/вывод через swap pump.fun; баланс игрока — в фантиках.
- **Фантик = 1 токен-единица/10^6.**
- **Баланс игрока:** в ATA (Associated Token Account) на mint; читается `getTokenAccountBalance`.
## Вход/выход денег
- **Пополнение:** `POST /agents/swap`, `inputMint=NATIVE_MINT(SOL)`, `outputMint=наш_mint`.
- **Вывод:** `POST /agents/swap`, `inputMint=наш_mint`, `outputMint=NATIVE_MINT(SOL)`.
- Комиссия pump.fun — *(решить, чей счёт)*.
- Ликвидность на старте — *(решить)*.
## Что стоит фиксированно
- mint-адрес, bonding-curve, decimals, эмитент — версионируются в конфиге бэкенда + в git.