My Guarding Angel

Celo Telegram Analytics Bot This is a Telegram bot that helps you track and analyze activities on the Celo blockchain. It's built to work on the Alfajores testnet and can help you understand what's happening with addresses, smart contracts, and transactions. What it Actually Does Connects to Telegram so you can chat with it about blockchain data Uses DeepSeek's AI (through their API) to understand your questions in plain English Pulls data from the Celo blockchain using viem and the BlockScout API Can track CELO and cUSD balances Analyzes smart contracts to tell you what they do Lets you save addresses as "friends" so you can track them easily Technical Bits Uses the official Celo ABIs for token interactions Connects to: Telegram Bot API for the interface DeepSeek API for AI processing BlockScout API for blockchain data Celo's RPC endpoints via viem Has a caching system that refreshes every 5 minutes to avoid hammering the APIs It's basically a friendly way to interact with Celo blockchain data without having to dig through block explorers or write code yourself. You just ask it questions in Telegram, and it figures out what blockchain data to pull and how to explain it to you. The cool part is that it combines AI with blockchain data, so you can ask things like "what's happening with this address?" and get a human-readable response rather than just raw numbers.

The Build Process I have built this bot using Node.js and pieced together a few key technologies: Main Components Used viem to talk to the Celo blockchain - it's newer and works better than the older Web3 libraries Built the bot interface with node-telegram-bot-api - pretty straightforward Telegram bot stuff Connected to DeepSeek's AI API instead of ChatGPT (saved some money there!) Used BlockScout's API to get detailed blockchain data quickly Cool Stuff We Figured Out Made a smart caching system that keeps data for 5 minutes - helps avoid hitting API limits and keeps things fast Got creative with how the AI understands blockchain data - it can pull real data when someone asks about addresses or transactions Built a simple "friends" system so users can save addresses with nicknames instead of dealing with those long hex strings Tricky Parts Solved Made the AI responses work with real blockchain data instead of making stuff up Nothing too hacky, but we did have to get creative with how we combined the AI responses with real blockchain data. The whole thing runs on Node.js and talks to Celo's testnet (Alfajores) for now. Most of the magic happens in how we combined these different pieces - getting an AI to understand blockchain data and explain it in plain English through Telegram!