docs(api): контракт API для клиента — HTTP + WS-события

API.md: полное описание ручек, трёх WS-событий (price/bet_open/bet_closed),
полей с масштабами, ошибок (409 = уже есть открытая ставка), авто-закрытия.
Все значения сверены с живым стендом.

README: убрано устаревшее 'поллинг до SETTLED' — поллинга нет, события идут по WS.

Отдельно задокументирован SEC-9: ~33.6% ставок (замер на 580 мин) зависают
из-за exit==entry и вечного ретрая.
This commit is contained in:
assistant
2026-09-14 00:20:12 +03:00
parent f9daee67bf
commit d9b1cc1ed8
2 changed files with 179 additions and 1 deletions
+3 -1
View File
@@ -17,7 +17,9 @@ Unity-фронт (`fun-game-front2`) хорош для продакшена, н
- **Пополнить** — swap SOL→фантики через `POST /api/pump/swap` (подпись в Phantom).
- **Вывести** — swap фантики→SOL.
- **Ставка** (вверх/вниз) в фантиках через контракт: `GET /api/state` →
подпись create_bet → `POST /api/bet` → поллинг до SETTLED → показ выигрыша.
`POST /api/bet` → **события по WebSocket** (`bet_open` при постановке, `bet_closed` при
расчёте). Поллинг не нужен: шлюз закрывает ставку сам по таймеру.
Полный контракт API (HTTP + WS, поля событий, ошибки) — **[API.md](API.md)**.
- Лог всех действий + кнопки «Копировать» / «Очистить».
## Как пользоваться