← Back to home

EVVM Telegram Bot

Access EVVM blockchain from Telegram via simple text commands

Problem Statement

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.

Solution

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:Frontend: Telegram Bot API handles all user commandsBackend: Python application with modular components:bot.py: Command handlers and user interaction logicevvm_handler.py: EVVM contract integration and transaction managementwallet_manager.py: Ethereum wallet creation using eth-accountdatabase.py: SQLite for user wallet and transaction storageconfig.py: Contract ABIs, addresses, and configurationTransaction Flow: When a user sends "/send 0xAddress 1.0", the bot:Retrieves user's private key from databasePrepares EVVM transaction with proper nonce via getNonce()Signs transaction using EIP-712 structured data hashingCalls EVVM contract's execute() function on SepoliaReturns transaction hash and Etherscan link to userTech Stack:Python 3.9+python-telegram-bot 20.7 (Telegram integration)web3.py 6.11.3 (Ethereum/EVVM interaction)SQLite (data persistence)Sepolia testnet

Hackathon

ETHOnline 2025

2025

Contributors