How dami904/celo_mind works
CeloMind is a Celo blockchain assistant exposed through a web dashboard/chat and an MCP interface. The main user workflow is to connect a wallet, ask in natural language, route the request to the relevant blockchain or information capability, and receive an explanation or unsigned transaction to review and sign locally. The graph preserves wallet, market, risk, whale, DeFi, docs, and analytics capabilities described in the README. Route-level wiring beyond the sampled chat handler is based on the documented product surface; those links are limited to explicit entry points.
Main entry points: chat.ts Chat handler · server.ts Fastify API · chat/page.jsx Web chat · dashboard/page.jsx Portfolio dashboard
Components 23
Web experience
- Web chat
frontend/src/app/chat/page.jsx - Portfolio dashboard
frontend/src/app/dashboard/page.jsx - API client
frontend/src/lib/api.ts
API and orchestration
- Fastify API
backend/apps/api/src/server.ts - Chat handler
backend/apps/api/src/routes/chat.ts - Intent routing
backend/apps/api/src/ai/intent-router.ts - AI providers
backend/apps/api/src/ai/providers.ts - MCP HTTP entry
backend/apps/api/src/routes/mcp-http.ts - Conversation history
backend/apps/api/src/db/sqlite.ts
Celo capabilities
- Wallet and transfers
backend/packages/mcp-server/src/celo-client.ts - Market intelligence
backend/packages/mcp-server/src/market.ts - Token risk
backend/packages/mcp-server/src/risk.ts - Whale tracking
backend/packages/mcp-server/src/whale.ts - DeFi operations
backend/packages/mcp-server/src/aave.ts
Knowledge and metrics
- Celo docs knowledge
backend/packages/docs-knowledge/src/index.ts - Live docs fetch
backend/packages/docs-knowledge/src/live-fetch.ts - Usage metrics
backend/dashboard/src/index.ts - Metrics store
backend/dashboard/src/store.ts
Other components
- User
- Connected wallet
- Celo network
- Market and explorer sources
- AI services
Connections 29
- User → Web chat: asks
- User → Portfolio dashboard: views
- Web chat → API client: sends chat
- Portfolio dashboard → API client: fetches data
- API client → Fastify API: HTTP requests
- Fastify API → Chat handler: dispatches
- Fastify API → MCP HTTP entry: dispatches
- Fastify API → Usage metrics: registers routes
- Chat handler → Intent routing: resolves intent
- Chat handler → AI providers: requests completion
- AI providers → AI services: calls
- Chat handler → Wallet and transfers: reads or prepares
- Chat handler → Market intelligence: queries
- Chat handler → Token risk: checks
- Chat handler → Whale tracking: queries
- Chat handler → DeFi operations: prepares actions
- MCP HTTP entry → Wallet and transfers: dispatches tools
- Wallet and transfers → Celo network: reads or writes
- Market intelligence → Market and explorer sources: queries
- Token risk → Market and explorer sources: queries
- Whale tracking → Market and explorer sources: queries
- DeFi operations → Celo network: reads or prepares
- Chat handler → Celo docs knowledge: answers doc queries
- Celo docs knowledge → Live docs fetch: fetches live docs
- Chat handler → Conversation history: reads and writes history
- Portfolio dashboard → Connected wallet: connects
- Web chat → Connected wallet: requests signature
- Connected wallet → Celo network: signs confirmed tx
- Usage metrics → Metrics store: records and reads