FinBuddy

FinBuddy is an AI-powered Web3 assistant designed to help users understand their wallet activity and stay informed about market trends. It connects to any crypto wallet in read-only mode and uses data from Blockscout to analyze transactions, detect risks, and summarize token performance. FinBuddy explains every action on-chain in clear, human language, helping users know where their money goes, what each transaction means, and whether something looks suspicious. It also highlights trending tokens, active protocols, and shifts in portfolio value. By combining blockchain analytics with natural language reasoning, FinBuddy aims to make crypto management simple, transparent, and insightful for everyone.

FinBuddy was built as an AI-powered Web3 analytics tool that helps users understand their on-chain activity. It uses Blockscout to fetch wallet transactions, token balances, and contract metadata from multiple EVM networks. The backend is developed with FastAPI (Python) to handle API calls, data normalization, and logic for detecting swaps, approvals, and risks. Smart contract testing and interaction are managed through Hardhat 3, which allows quick deployment of mock contracts and integration testing on local and test networks. The frontend is made with React and TailwindCSS to deliver a clean, modern interface.

Blockscout was chosen for its accessible API and ability to decode verified contracts, making it ideal for building reliable analytics. Some hacky parts include reconstructing internal transaction traces, caching ABIs locally, and fine-tuning LLM prompts to explain complex DeFi actions. Together, these technologies make FinBuddy a smooth and intelligent tool that turns raw blockchain data into simple, meaningful insights.