pump-game-ops/docs/DECISIONS.md

DECISIONS.md — журнал решений (ADR)

Каждое решение — короткая запись, чтобы потом не гадать, почему всё устроено так. Формат: дата, статус (принято/рассмотрение/заменено), суть, аргументы за/против, результат.

---

ADR-001 — Используем свой токен на pump.fun (мемкойн Binary Rocket)

• Дата: 2026-09-09
• Статус: принято
• Суть: выпускаем СВОЙ токен на pump.fun, а не пользуемся чужим.
• За: бренд/маркетинг, контроль экономики, стимул игрокам, единая валюта ставок.
• Против: надо эмитировать и следить за курсом; чужой токен дал бы меньше работы.
• Решение: свой токен. decimals = 6, Token-2022, создание через create_v2 (по доке pump.fun).

ADR-002 — Курс живой рыночный (Способ 1)

• Дата: 2026-09-09
• Статус: принято
• Суть: вне игры баланс — в фантиках, курс берётся с рынка (bonding curve/AMM pump.fun). Ввод = swap SOL→фантики, вывод = swap фантики→SOL. Никакой фикс-привязки/стейблока.
• За: нативно pump.fun, привычно игроку-трейдеру, технически проще, маркетинг (рост/падение токена).
• Против: баланс «гуляет» с рынком; определённым аудиториям неудобно.
• Решение: Способ 1. (Это и диктует, что ставки идут фантиками через контракт.)

ADR-003 — Ставки идут фантиками через контракт

• Дата: 2026-09-09
• Статус: принято (вытекает из ADR-002)
• Суть: игрок ставит токен, контракт держит фантики в своём ATA-ваулте и платит фантиками.
• Следствие: контракт переводится с нативного SOL (lamports) на SPL-токен — это ядро Фазы 1.
• Против: трогаем хорошо работающий контракт; но без этого сценарий ввода-игры-вывода не работает.

ADR-004 — Ввод/вывод через pump.fun swap (POST /agents/swap)

• Дата: 2026-09-09
• Статус: принято
• Суть: пополнение = inputMint: NATIVE_MINT(SOL), outputMint: наш_mint; вывод = наоборот. Клиент на бэкенде (Ktor PumpApiClient) уже готов в smart-updown-server.
• За: возвращает готовую подписанную swap-транзакцию, бэкенд не держит ликвидность.
• Против: весь ввод/вывод завязан на доступность pump.fun API.

ADR-05 (идея) — мета-репозиторий для документации и трекинга

• Дата: 2026-09-09
• Статус: принято
• Суть: создать pump-game-ops, где живут карта репозиториев, решения, экономика и список задач.
• За: единая точка оркестрации, не плаваем по чату. Против: риск превратиться во второй трекер.

---

ADR-005 — Флоу входа/вывода подтверждён (как описал юзер)

• Дата: 2026-09-09
• Статус: принято
• Суть: человек заходит в игру → видит баланс 0 → кнопка «Пополнить» (одна, без выбора) → swap SOL→фантики → баланс появляется → ставит фантики через контракт (честное списание/начисление по исходу) → при выходе нажимает «Вывести» → swap фантики→SOL, баланс уменьшается.
• За: точный пользовательский сценарий, подтверждённый владельцем; простая UX-модель.
• Решение: именно так и работаем — это источник требований для Фазы 1 (контракт на токене) и Фазы 5 (UI).

---

Развилки, которые ещё предстоит решить (не закрыты) — ТРЕБУЮТ решения до старта Фазы 1

• Цена «вверх/вниз»: контракт сравнивает entry/exit_price — что это: цена нашего фантика, цена SOL или отдельный бенчмарк? (единственное реальное белое пятно перед контрактной работой).
• Эмиссия: разовая (скрипт для основного коина) или постоянная (рабочий процесс эмиссии в бэкенде).
• Кто держит ликвидность swap на старте и межторговая комиссия pump.fun — чей счёт.
• Финальное имя/символ токена и URI метаданных (для create_v2).

Открытые пункты помечены в TASKS.md как BLOCKED/pivotable — не замечать походу.