> For the complete documentation index, see [llms.txt](https://amber-metaverse.gitbook.io/trend-arena/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://amber-metaverse.gitbook.io/trend-arena/produkt/gdd.md).

# Game Design Document

| Параметр        | Значение                                     |
| --------------- | -------------------------------------------- |
| Стадия          | Тестнет                                      |
| Платформа       | Telegram Mini App (Mobile-first WebView)     |
| Блокчейн        | Собственный EVM-совместимый, стандарт ERC-20 |
| Жанр            | SocialFi / Gamified Prediction Market        |
| Дата обновления | 2026-03-26                                   |

***

## 1. Концепция

Trend Arena — геймифицированная торговая площадка внутри Telegram. Пользователи создают и торгуют мем-токенами, привязанными к реальным трендам из X (Twitter), участвуют в лигах, выполняют квесты и зарабатывают внутриигровую валюту.

**One-liner:** «Превращаем тренды X в торгуемые активы с гарантированной защитой от потерь и геймифицированной экономикой».

***

## 2. Целевая аудитория

**Крипто-дегены (Degen Traders):**

* Мотивация: быстрые "иксы", азарт, FOMO
* Поведение: импульсивные торги, высокая толерантность к риску, привычка к TG-ботам
* Боли: rug pull, боты съедают ликвидность, потеря 100% депозита

**Наше УТП:**

* Refund — pro-rata возврат USDT при падении цены (защита депозита)
* Bonding Curve — безопасная фаза для ранних инвесторов
* Геймификация — King of the Swap, квесты, лиги, лутбоксы

***

## 3. Бизнес-модель

Платформа зарабатывает на торговых комиссиях:

| Стадия                  | Buy | Sell |
| ----------------------- | --- | ---- |
| Bonding Curve           | 0%  | 2%   |
| Constant Product (Live) | 1%  | 1%   |
| Refund                  | 0%  | 0%   |

**Реферальная программа (revenue sharing):**

* L1 (прямой реферал): 50% от комиссии свопа → реферер (USDT)
* L2 (реферал реферала): 10% от комиссии → реферер L1 (USDT)

***

## 4. Активы

### USDT

Базовый стейблкоин для покупок, фиксации прибыли и оценки портфеля.

### Trend Coins (мем-токены)

ERC-20 токены. Названия из трендовых фраз X (например, $Airdrop, $MainCharacter).

| Параметр                 | Значение                   |
| ------------------------ | -------------------------- |
| Общий саплай             | 500,000                    |
| Bonding Curve            | 400,000                    |
| Constant Product пул     | 100,000                    |
| Стартовая цена           | \~$0.0105                  |
| Цена при выходе на Live  | \~$0.10 (при $10,000 USDT) |
| Порог перехода на Live   | $10,000 USDT               |
| Цена срабатывания Refund | < $0.01                    |

Создание: пользователи создают токены через `createTrendCoin(phrase, url)` — UGC-модель.

### Arena Coin (AC)

Внутриигровая хард-валюта. Не торгуется на биржах. Покупается за USDT внутри платформы.

**Заработок:** King of the Swap (энергия), квесты (разовые + daily/weekly), реферальные бонусы (AC), Daily Streak (5 AC/день + 20 AC за 7-дневную серию).

**Утилити:** лутбоксы, входные билеты на турниры, скидки на комиссии, голосование в Фабрике Трендов.

> Цена, пакеты, дефляционная модель → **Tokenomics.md**

***

## 5. Жизненный цикл токена (Core Loop)

### Стадия 1: Bonding Curve (синий)

* Стартовая цена \~$0.0105, 400,000 токенов выкупаются по кривой
* Buy 0%, Sell 2%
* Цель: собрать $10,000 USDT

### Стадия 2: Constant Product / Live (зелёный)

* AMM-пул: 100,000 токенов + 10,000 USDT, формула x × y = k
* Buy 1%, Sell 1%

**X Oracle:**

* 20 слотов мониторинга, интервал 3 мин, полный цикл 60 мин
* Топ-10 по капитализации — постоянный мониторинг
* Ротация-10 — остальные слоты для токенов с давним `lastMentionTime`
* Данные: Twitter API `tweets/counts/recent`, гранулярность hourly, окно \~7 дней

**Динамическое сжигание (Burn):**

| Температура | Скорость     | Описание                     |
| ----------- | ------------ | ---------------------------- |
| Cold        | 0% / час     | Низкая активность упоминаний |
| Hot         | \~0.1% / час | Умеренный хайп               |
| Extreme     | \~1% / час   | Пиковый тренд                |

### Стадия 3: Refund (череп)

* Цена < $0.01 → торги останавливаются (Flash Crash Detection)
* Холдеры получают pro-rata возврат USDT
* Buy 0%, Sell 0%

***

## 6. Геймификация

### King of the Swap (Hot Seat)

* Любой своп ≥ $10 ставит пользователя на Трон
* Следующий своп от другого сбрасывает текущего короля
* Энергия = сумма\_свопа × время\_удержания\_минут
* Цикл: недельный (сброс понедельник 00:00 UTC)
* Лидерборд по накопленной энергии

### Квесты

Три секции + daily/weekly. Бонус за завершение секции.

| Секция                               | Итого AC | Итого USDT |
| ------------------------------------ | -------- | ---------- |
| 1. Онбординг (6 заданий)             | 95       | 95         |
| 2. Активный пользователь (8 заданий) | 205      | 20         |
| 3. Профессионал (6 заданий)          | 500      | —          |
| **Всего one-time**                   | **800**  | **115**    |

> Подробный таймлайн первого дня → **Onboarding.md**

### Daily Streak

* День регистрации = День 1 (AAA-подход)
* Ежедневный вход: 5 AC (timezone-aware)
* 7 дней подряд: +20 AC бонус
* Визуализация: 7-дневный календарь

### Лиги и лидерборды

* Любой может создать лигу, вступление по ссылке
* 4 типа лидербордов: Total Value, Arena Coin, Weekly Growth (Total), Weekly Growth (Arena)
* Глобальные и внутри лиг

### Статусы престижа

По процентилю AC: Bronze (≤50%) → Silver (50-75%) → Gold (75-90%) → Platinum (90-99%) → Diamond (≥99%).

### Реферальная программа

* USDT: L1 50% + L2 10% от комиссий свопов реферала
* AC: квестовые бонусы (40 AC за первый своп друга, до 250 AC за 20 друзей)

***

## 7. Планируемые фичи

> Полная спецификация лутбоксов → **boxes.md** Экономика AC → **Tokenomics.md** Все идеи с приоритетами → **Ideas.md** Детальный roadmap → **Roadmap.md**

### Лутбоксы (Gacha)

Двухступенчатая рулетка: 1) какой токен, 2) сколько. Резерв 3% саплая (15,000) при прохождении BC. 5 тиров: MOON (0.1%) → PUMP → BULL → NORMIE → REKT (50%). 3 категории: Degen (Energy), Hype (25 AC), Whale (100 AC). Светящиеся боксы пока джекпот не выбит.

### Магазин AC

Прямая покупка AC за USDT: от $2.50 (25 AC) до $105 (1,500 AC). Инженерный дефицит: рулетки сжигают AC быстрее чем можно заработать. Замкнутый цикл: торговля → прибыль → покупка AC → рулетка → выигрыш токенов → торговля.

### Фабрика Трендов (UGC)

Пользователи создают тренды и голосуют ставками в AC. Победитель запускается каждые 12-24ч. Creator Royalties: автор получает % от комиссий. Airdrop 1% пула угадавшим тренд.

***

## 8. UI/UX

Тёмная тема, неоновые акценты. 5 вкладок:

| Вкладка       | Описание                                               |
| ------------- | ------------------------------------------------------ |
| **Arena**     | Лента токенов, карусель Trending, фильтры по статусам  |
| **Portfolio** | Эквити (график), кошельки USDT/ARENA, список позиций   |
| **Hot Seat**  | King of the Swap: текущий король, карусель, лидерборд  |
| **Swap**      | DEX-интерфейс, Slippage (10%), Price Impact            |
| **Profile**   | Streak, достижения, квесты, лидерборды, лиги, рефералы |

**Карточка токена:** свечной график + график температуры (упоминания X). Quick Trade: Buy $5/$10/$25, Sell 10%/20%/30%.

***

## 9. Фирменный стиль

| Цвет                | HEX     | Использование                    |
| ------------------- | ------- | -------------------------------- |
| Primary (оранжевый) | #D4930A | Кнопки, CTA, акценты             |
| Profit (зелёный)    | #00C951 | Рост цены, положительные метрики |
| Loss (красный)      | #FB2C36 | Падение цены, ошибки             |
| Gold                | #D0B772 | Трофеи, ранги, лидерборд         |

***

## 10. Метрики (KPIs)

* Daily Trading Volume, Average Order Value
* DAU, CAC
* D1 / D7 / D30 Retention Rate
* Screen Visit Tracking для построения воронок

***

## 11. Локализация

* Языки: English (en), Russian (ru)
* Определение: автоматически из Telegram → ручной override в Settings
* Формат строк: `{key}` интерполяция


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://amber-metaverse.gitbook.io/trend-arena/produkt/gdd.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.