Telegram Bot

Work Description

The project involves updating the existing Telegram bot Swaptain from SwapKit v1 to SwapKit v4, ensuring full functionality preservation, performance improvement, and the implementation of new features — a referral rewards system (“Refer & Earn”) and support for all new networks compatible with SwapKit v4.
The work includes technical refactoring updates, bug fixes, performance optimization, and comprehensive testing on all supported networks.

1. Migration and Refactoring to SwapKit v4

• Replace all outdated modules swapkit/* version v1 with their counterparts in v4.

• Update keystore logic, network configurations, and environment variables (.env).

• Centralize the creation of the SwapKit client through middleware to enhance efficiency and eliminate duplicate initializations.

• Remove all outdated calls to swapkit/helpers and unnecessary helper functions.

• Normalize chain types and assets according to v4 specifications.

• Perform code cleanup and fix the logic of scene handlers (.always().do()), callback routing, and user navigation.

• Ensure stable compatibility with the deployment environment Fly.io, including updating Docker configuration and optimizing the build process.

2. Performance and Reliability Optimization

• Implement caching for frequently used API requests (balances, prices) with a TTL of 20–60 seconds.

• Optimize message updates in Telegram to reduce API latency.

• Defer the import of heavy modules to speed up bot startup.

• Add timeout handling, fallback scenarios, and improved error logging.

• Check the consistency of i18n keys and the accuracy of all text translations.

3. “Refer & Earn” System (Referral Program)

• Develop a mechanism for generating a unique referral link for each Telegram user.

• Track new users brought in through referrals, as well as the volume of their transactions.

• Implement logic for awarding 0.3% of the transaction volume of referred users to the referrer.

• Store data on referral relationships and transaction volumes in the database (via Prisma).

• Add a “Request Payout” button that leads to the client's Google form for payout requests.

• Create a basic administrative control panel for checking referrals and preventing abuse.

4. Integration of New Networks in SwapKit v4

• Expand the bot configuration to support all new blockchains available in SwapKit v4.

• Initialize clients, providers, and fee mechanisms for each new network.

• Update asset handling and transaction validation logic considering the specifics of different chains.

• Verify the correctness of deposits, swaps, and balance displays across all new networks.

Request to Contractors: please carefully review the description and include in your proposal the estimate and completion timeline.

The code of the current version of the project is attached below.