mh1301/mimo-nl-blockchain-explorer

# MiMo Natural Language Blockchain Explorer Query blockchain data using natural language — powered by 6 AI agents and MiMO v2.5 Pro. ## What It Does Instead of navigating block explorers, typing hex addresses, or understanding ABI encoding — just ask in plain English: - "Show whale movements on Ethereum in last 24h" - "Gas price on Polygon" - "What's the balance of vitalik.eth?" - "Recent blocks on Arbitrum" The system parses your query, routes it to the right chain, fetches data via Alchemy RPC, analyzes patterns, generates visualizations, and explains findings in natural language. ## Architecture Natural Language Input | v +-------------------+ | Query Parser | NL -> structured query (chain, entity, action, filters) +-------------------+ | v +-------------------+ | Chain Router | Resolve ENS, select RPC, validate chain +-------------------+ | v +-------------------+ | Data Fetcher | Fetch blocks, txs, balances via Alchemy RPC +-------------------+ | v +-------------------+ | Data Analyzer | Aggregate, compute metrics, detect patterns +-------------------+ | v +-------------------+ | Visualization | Generate charts (bar, line, gauge, table) +-------------------+ | v +-------------------+ | AI Explainer | MiMo LLM: natural language summary + insights +-------------------+ ## 6 Agents | Agent | Role | Input | Output | |-------|------|-------|--------| | Query Parser | NL understanding | Natural language text | Structured query JSON | | Chain Router | Chain selection | Query + address | Chain info + resolved address | | Data Fetcher | Blockchain data | Chain + filters | Raw blockchain data | | Data Analyzer | Pattern detection | Raw data | Metrics + patterns | | Visualization | Chart generation | Data + analysis | Chart configs | | AI Explainer | NL summary | All context | Human-readable explanation | ## Supported Chains Ethereum, BSC, Polygon, Arbitrum, Optimism, Avalanche, Base, zkSync, Linea, Scroll ## API | Endpoint | Method | Description | |----------|--------|-------------| | `/` | GET | Dashboard | | `/api/query` | POST | Natural language query | | `/api/chains` | GET | Supported chains | | `/api/history` | GET | Query history | | `/api/agents` | GET | Agent status | | `/health` | GET | Health check | ## Tech Stack - **Backend:** FastAPI + Uvicorn - **LLM:** MiMO v2.5 Pro (OpenAI-compatible endpoint) - **RPC:** Alchemy (multi-chain) - **Frontend:** Vanilla HTML/CSS/JS with animated particle background - **Agents:** 6 specialized agents with shared kernel ## Demo Live: http://43.153.206.68 ## License MIT