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.