Телеграм Бот

Описание Работ

Проект предполагает обновление существующего Telegram-бота Swaptain с SwapKit v1 до SwapKit v4, обеспечение полного сохранения функциональности, улучшение производительности и внедрение новых возможностей — системы реферальных вознаграждений («Refer & Earn») и поддержки всех новых сетей, совместимых с SwapKit v4.
Работы охватывают техническое рефакторинг-обновление, исправление ошибок, оптимизацию производительности и комплексное тестирование на всех поддерживаемых сетях.

1. Миграция и рефакторинг на SwapKit v4

• Заменить все устаревшие модули swapkit/* версии v1 на их аналоги в v4.

• Обновить логику keystore, конфигурации сетей и переменные окружения (.env).

• Централизовать создание клиента SwapKit через middleware для повышения эффективности и устранения дублированных инициализаций.

• Удалить все устаревшие вызовы swapkit/helpers и ненужные вспомогательные функции.

• Нормализовать типы цепочек (chains) и активов в соответствии со спецификациями v4.

• Выполнить чистку кода и исправление логики обработчиков сцен (.always().do()), callback-маршрутизации и навигации пользователя.

• Обеспечить стабильную совместимость с окружением развертывания Fly.io, включая обновление Docker-конфигурации и оптимизацию процесса сборки.

2. Оптимизация Производительности и Надежности

• Реализовать кэширование часто используемых API-запросов (балансы, цены) с TTL 20–60 секунд.

• Оптимизировать обновление сообщений в Telegram для снижения задержек API.

• Отложить импорт тяжелых модулей для ускорения запуска бота.

• Добавить обработку таймаутов, резервные сценарии (fallback) и улучшенный логгинг ошибок.

• Проверить согласованность i18n-ключей и правильность всех текстовых переводов.

3. Система «Refer & Earn» (Реферальная программа)

• Разработать механизм генерации уникальной реферальной ссылки для каждого пользователя Telegram.

• Отслеживать новых пользователей, привлеченных через рефералов, а также объем их транзакций.

• Реализовать логику начисления 0.3% от объема транзакций приглашенных пользователей в пользу реферера.

• Сохранять данные о реферальных связях и объемах транзакций в базе данных (через Prisma).

• Добавить кнопку «Request Payout», которая ведет на Google-форму клиента для запроса выплаты.

• Создать базовую панель административного контроля для проверки рефералов и предотвращения злоупотреблений.

4. Интеграция Новых Сетей SwapKit v4

• Расширить конфигурацию бота для поддержки всех новых блокчейнов, доступных в SwapKit v4.

• Инициализировать клиентов, провайдеров и механизмы комиссий для каждой новой сети.

• Обновить логику обработки активов и валидации транзакций с учетом особенностей различных цепочек.

• Проверить корректность работы депозитов, свопов и отображения балансов во всех новых сетях.

Запрос к исполнителям: пожалуйста, внимательно ознакомьтесь с описанием и укажите в своем предложении смету и срок выполнения.

Код текущей версии проекта ниже закреплен.