How hash066/ai-agent-wallet-project works
Project type and purpose
• This is a full-stack, blockchain-centric application that provides secure cross-chain intent execution for AI agents.
• It combines on-chain smart contracts (Sepolia + Polygon Amoy), off-chain microservices (relayer, watchdog, agent runtime, REST API), a React dashboard frontend, and monitoring/deployment infrastructure.
File structure
• Top-level directories:
• backend – REST API service, relayer, watchdog, agent runtime, local SQLite
• frontend – React/Vite dashboard
• load-tests – k6 scripts for performance
• monitoring – Prometheus + Alertmanager configs
• nginx – reverse-proxy ingress
• scripts – deploy.sh, Docker orchestration
• Deployment files: docker-compose.prod.yml, DEPLOYMENT.md
• Environment templates: .env.prod.example
README insights
• Off-chain flow: Agent Runtime → CrossChainExecutor (Sepolia) → Relayer → CrossChainExecutor (Amoy) → Watchdog → Token execution
• AuditLog and PolicyEngine enforce immutability and circuit breakers
• Frontend interacts with REST API for agent management, intents, audit trail, health & metrics
Elements
• Frontend/API – blue
• Infra (monitoring, ingress) – gray