BlockBuddy

BlockBuddy is a WhatsApp-based Web3 wallet that brings blockchain technology to the familiar messaging platform. It enables users to create Ethereum wallets, check balances, transfer ETH, look up ENS (Ethereum Name Service) records, and manage their crypto assets directly through WhatsApp conversations. The bot features intelligent intent recognition powered by Google's Gemini AI, which interprets natural language commands and routes them to appropriate blockchain operations. Users can interact with both Ethereum mainnet and Sepolia testnet, perform ENS lookups with comprehensive record fetching (including social profiles, crypto addresses, and content hashes), and execute secure transactions with encrypted private key storage. The system stores user data and wallet information in a Hasura GraphQL database, providing a seamless bridge between Web2 communication and Web3 functionality.

BlockBuddy is built using Node.js with ES6 modules and leverages several key technologies: whatsapp-web.js for WhatsApp integration, ethers.js v6 for Ethereum blockchain interactions, and Google Gemini AI (via @google/genai) for natural language processing and intent classification. The backend uses Hasura GraphQL for database operations, storing encrypted wallet credentials using AES-256-GCM encryption with crypto module. Network connectivity is handled through Alchemy RPC providers for both Ethereum mainnet and Sepolia testnet. The intent routing system processes user messages through Gemini to classify requests into specific actions (wallet creation, balance checks, ETH transfers, ENS lookups, etc.), then executes the corresponding handler functions. Wallet private keys and mnemonics are encrypted before storage, and the system supports ENS resolution for human-readable addresses, fetching comprehensive records including text records, multi-chain addresses, and content hashes. The modular architecture separates concerns with dedicated files for messaging, Gemini processing, Hasura operations, and individual intent handlers.