Architecture
How the main parts of Alt Bot work together.
Main components
| Component | Role |
|---|---|
| Telegram bot | Receives commands and renders the chat UI |
| Database | Stores users, wallets, trades, positions, and referrals |
| Redis/BullMQ | Runs trade and notification queues |
| Signing service | Derives wallets, encrypts imported keys, and signs transactions |
| HyperEVM provider | Reads balances, simulates, and broadcasts transactions |
| AltBotRouter | Routes buys and sells through the alt.fun DEX |
Trade flow
- The user chooses buy or sell in Telegram.
- The bot checks amount, balance, and active wallet.
- The bot adds a job to the
tradequeue. - A worker prepares the approval, swap, or trade transaction.
- The signing service signs the raw transaction.
- The provider broadcasts it to HyperEVM.
- The notify worker sends the result back to Telegram.