pump-game-ops/docs/ECONOMY.md

# 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)*

## Курс и балансы
- **Валюта ставки:** наши фантики (токен Binary Rocket).
- **Предмет ставки:** направление цены SOL (вверх/вниз) — ADR-006. Сейчас цена SOL — случайная заглушка, позже — реальная.
- **Курс:** живой рыночный (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.