BlockBuddy

Description

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.

Why Gemini AI is the Core Component

Gemini AI is the most critical component that transforms BlockBuddy from a simple command-based bot into an intelligent, conversational Web3 interface. Traditional crypto wallets require users to learn specific commands and syntax, creating a steep learning curve. Gemini's advanced natural language understanding allows users to interact naturally, asking questions like "What's my balance?" or "Send 0.1 ETH to vitalik.eth" without needing to memorize commands or formats. The AI performs sophisticated intent classification, parsing ambiguous user inputs and extracting critical parameters (amounts, addresses, network preferences) while handling context, synonyms, and conversational nuances. This makes blockchain technology accessible to non-technical users who can simply chat in their own words. Gemini's reasoning capabilities also enable the bot to ask clarifying questions, validate user inputs intelligently, and provide contextual help, essentially acting as a knowledgeable assistant that bridges the complexity gap between Web3 technology and everyday users. Without Gemini, BlockBuddy would be just another rigid command-line interface; with it, it becomes a truly conversational and user-friendly gateway to decentralized finance.

How It's Made

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.

Built With

• ether
• node.js