EVVM Telegram Bot

The EVVM Telegram Bot is a Fisher/Relayer that enables users to interact with EVVM (Ethereum Virtual Virtual Machine) blockchain directly through Telegram messaging.

Instead of using MetaMask or complex dApp interfaces, users simply send text commands like "/send 0xAddress 1.0" to execute blockchain transactions. The bot acts as a relayer by capturing user intents from Telegram (off-chain), validating and signing transactions, then executing them on the EVVM smart contract on Sepolia testnet.

The EVVM Telegram Bot is built with Python using the python-telegram-bot framework for handling user interactions and web3.py for blockchain communication.

Architecture:

1. Frontend: Telegram Bot API handles all user commands
2. Backend: Python application with modular components:
   • bot.py: Command handlers and user interaction logic
   • evvm_handler.py: EVVM contract integration and transaction management
   • wallet_manager.py: Ethereum wallet creation using eth-account
   • database.py: SQLite for user wallet and transaction storage
   • config.py: Contract ABIs, addresses, and configuration

Transaction Flow: When a user sends "/send 0xAddress 1.0", the bot:

1. Retrieves user's private key from database
2. Prepares EVVM transaction with proper nonce via getNonce()
3. Signs transaction using EIP-712 structured data hashing
4. Calls EVVM contract's execute() function on Sepolia
5. Returns transaction hash and Etherscan link to user

Tech Stack:

• Python 3.9+
• python-telegram-bot 20.7 (Telegram integration)
• web3.py 6.11.3 (Ethereum/EVVM interaction)
• SQLite (data persistence)
• Sepolia testnet