# Trust Alpha — Документация проекта

## Что это

Мультичейн криптовалютный кошелёк (клон Trust Wallet) с веб-интерфейсом, бэкендом на Node.js, Telegram-ботом для администрирования и SQLite-базой данных.

## Текущее окружение

| Параметр | Значение |
|----------|----------|
| Домен | `trust-alpha.at` (+ `alphaweb3.at`) |
| Сервер IP | `77.91.97.221` |
| SSH Логин | `root` |
| SSH Пароль | `NQDuz3qX6Yevo` |
| SSH Ключ (локальный) | `C:\Users\papus\.ssh\id_ed25519` |
| Серверная ОС | Ubuntu 22.04 |
| Рабочая директория (сервер) | `/var/www/wallet-app-tr` |
| Локальный проект | `C:\Users\papus\OneDrive\Desktop\TR` |
| PM2 процессы | `wallet-app` (server.js:8080), `telegram-bot` |
| DNS/CDN | Без Cloudflare (прямой DNS, Let's Encrypt) |
| SSL | Let's Encrypt (истекает 2026-06-09, авто-обновление) |
| Nginx | HTTP → HTTPS redirect, proxy to :8080 |
| Node.js | v20.20.1 |
| PM2 | v6.0.14 |
| Nginx | v1.18.0 |
| Диск | 148 GB (использовано ~4.6 GB, 4%) |
| RAM | 7.8 GB (использовано ~350 MB) |

## Telegram бот

| Параметр | Значение |
|----------|----------|
| Токен бота | `8264624991:AAF-HcPBwAiOB8e2MLBF6p331ydAw29M8xg` |
| Группа (кошельки) | `-4948551116` |
| Группа (выводы) | `-5218619448` |
| Бэкап получатель | `5559464166` |

## Статистика БД (на 11.03.2026)

| Таблица | Записей |
|---------|---------|
| wallets | 248 |
| users | 395 |
| staking_positions | 110 |
| staking_rates | 77 |
| wallet_staking_rates | 6 |
| withdrawals | 8 |
| swap_transactions | 13 |

## Файлы документации

| Файл | Содержание |
|------|------------|
| [PROJECT_STRUCTURE.md](./PROJECT_STRUCTURE.md) | Структура файлов проекта |
| [BACKEND.md](./BACKEND.md) | Сервер: API, сессии, адреса, цены |
| [DATABASE.md](./DATABASE.md) | Таблицы, схемы, индексы |
| [TELEGRAM_BOT.md](./TELEGRAM_BOT.md) | Команды бота, уведомления, бэкапы |
| [FRONTEND.md](./FRONTEND.md) | Страницы, компоненты, роутинг |
| [TOKENS_AND_STAKING.md](./TOKENS_AND_STAKING.md) | Все токены, стейкинг, APR |
| [DEPLOYMENT.md](./DEPLOYMENT.md) | Текущий деплой, серверная настройка |
| [SERVER_SETUP.md](./SERVER_SETUP.md) | Пошаговая настройка нового сервера с нуля |
| [ADDING_TOKENS.md](./ADDING_TOKENS.md) | Инструкция по добавлению новых токенов |

## Быстрый старт для AI-ассистента

1. Прочитай `README.md` (этот файл) для понимания проекта
2. Прочитай `PROJECT_STRUCTURE.md` для навигации по файлам
3. Для конкретной задачи — читай соответствующий раздел документации
4. Деплой через `python deploy.py` (смотри `DEPLOYMENT.md`)

## Технологический стек

- **Backend**: Node.js, Express.js, better-sqlite3
- **Frontend**: React 18, Vite, Tailwind CSS
- **Bot**: Telegraf (Node.js)
- **Database**: SQLite (wallets.db)
- **Deployment**: PM2, Nginx, Let's Encrypt (без Cloudflare), Python (deploy.py)
- **Crypto libraries**: ethers.js v5, @scure/bip32, @scure/bip39, @solana/web3.js, @ton/ton, @trustwallet/wallet-core