Talk to the blockchain. Pay only for what you use.
Demo Video β’ Features β’ Architecture β’ Quick Start
Vox402 is a voice-first AI assistant that makes DeFi accessible through natural language. Instead of navigating complex UIs, just tell Ava what you want:
"Swap 0.1 USDC to AVAX"
"Invest $5 in stable yield"
"Show me the AVAX chart for the last 30 days"
Built for the Hack2Build: Payments x402 Edition hackathon, Vox402 demonstrates how AI agents can be monetized with micropayments using the x402 protocol.
- Natural language input via voice or text
- AI-powered intent understanding with Google Gemini 2.0
- Text-to-speech responses from Ava, your DeFi assistant
- Pay-per-use: Only pay for premium services you actually use
- Gasless payments: USDC payments via EIP-3009
transferWithAuthorization - No subscriptions: 0.01 USDC per premium agent call
| Agent | Type | What it does |
|---|---|---|
| ChartAgent | FREE | Fetch crypto price charts (AVAX, BTC, ETH) |
| PortfolioAgent | FREE | Analyze wallet balances and holdings |
| TxAnalyzerAgent | FREE | Review transaction history |
| ContractInspectorAgent | FREE | Smart contract analysis & risk assessment |
| SwapAgent | PAID | Execute token swaps (USDC β WAVAX) |
| BridgeAgent | PAID | Cross-chain bridging quotes |
| YieldAgent | PAID | Multi-step yield investments (~8.5% APY) |
- Seamless connection with Core browser extension
- Automatic network switching to Avalanche Fuji
- Transaction signing for swaps and deposits
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Frontend (Next.js) β
β βββββββββββββββ ββββββββββββββββ ββββββββββββββββββββββββββ β
β β Voice Input β β Chat UI β β Execution Panels β β
β β (Web Speech)β β (Messages) β β (Swap, Yield Steps) β β
β βββββββββββββββ ββββββββββββββββ ββββββββββββββββββββββββββ β
ββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββ
β
βΌ
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Orchestrator (Express) β
β βββββββββββββββββββ βββββββββββββββββββββββββββββββββββββββ β
β β Gemini 2.0 API β β Agent Router β β
β β (Intent + Tools)β β (x402 payment passthrough) β β
β βββββββββββββββββββ βββββββββββββββββββββββββββββββββββββββ β
ββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββ
β
βββββββββββββββββββββΌββββββββββββββββββββ
βΌ βΌ βΌ
βββββββββββββββ βββββββββββββββ βββββββββββββββ
β ChartAgent β β SwapAgent β β YieldAgent β
β (FREE) β β (x402) β β (x402) β
β CoinGecko β β Pangolin β β ERC4626 β
βββββββββββββββ βββββββββββββββ βββββββββββββββ
- Frontend: Next.js 15, React 19, TailwindCSS, Viem
- AI: Google Gemini 2.0 Flash with function calling
- Payments: x402 protocol, EIP-3009 gasless USDC transfers
- Blockchain: Avalanche Fuji testnet
- DEX: Pangolin Router for swaps
- Yield: Custom ERC4626 vault
- Node.js 18+
- pnpm
- Core Wallet browser extension
- Avalanche Fuji testnet USDC (Faucet)
git clone https://github.com/KaranSinghBisht/Vox402.git
cd Vox402
pnpm installcp .env.example .envEdit .env:
# Required
GEMINI_API_KEY=your_gemini_api_key
CHART_AGENT_PAYTO=0xYourPaymentAddress
CHART_AGENT_GAS_PAYER_PK=0xYourPrivateKey
# Optional
GEMINI_MODEL_ID=gemini-2.0-flash# Terminal 1: All agents + orchestrator + web
pnpm -r devOr run individually:
# Agents (each in a terminal)
cd services/agents/chart-agent && pnpm dev # :4101
cd services/agents/swap-agent && pnpm dev # :4103
cd services/agents/portfolio-agent && pnpm dev # :4104
cd services/agents/tx-analyzer-agent && pnpm dev # :4105
cd services/agents/bridge-agent && pnpm dev # :4106
cd services/agents/contract-inspector-agent && pnpm dev # :4107
cd services/agents/yield-agent && pnpm dev # :4108
# Orchestrator
cd apps/orchestrator && pnpm dev # :4100
# Web
cd apps/web && pnpm dev # :3000Visit http://localhost:3000
- Connect your Core wallet
- Say "Show AVAX 30 day chart" (free)
- Say "Swap 0.1 USDC to AVAX" (paid - 0.01 USDC)
- Say "Invest 0.1 USDC in stable yield" (paid - 0.01 USDC)
Vox402/
βββ apps/
β βββ web/ # Next.js frontend
β β βββ src/components/ # React components
β βββ orchestrator/ # Express AI router
β βββ src/gemini.ts # Gemini integration
βββ services/agents/
β βββ chart-agent/ # FREE - Price charts
β βββ swap-agent/ # PAID - Token swaps
β βββ portfolio-agent/ # FREE - Wallet analysis
β βββ tx-analyzer-agent/ # FREE - Tx history
β βββ bridge-agent/ # PAID - Bridge quotes
β βββ contract-inspector-agent/ # FREE - Contract analysis
β βββ yield-agent/ # PAID - Yield strategies
βββ contracts/
β βββ src/SimpleYieldVault.sol # ERC4626 vault
βββ packages/ # Shared utilities
| Contract | Address | Network |
|---|---|---|
| SimpleYieldVault | 0xd2A081B94871FFE6653273ceC967f9dFbD7F8764 |
Avalanche Fuji |
| USDC | 0x5425890298aed601595a70AB815c96711a31Bc65 |
Avalanche Fuji |
| WAVAX | 0xd00ae08403b9bbb9124bb305c09058e32c39a48c |
Avalanche Fuji |
| Pangolin Router | 0x688d21b0B8Dc35971AF58cFF1F7Bf65639937860 |
Avalanche Fuji |
Coming soon
This project addresses:
- x402 Integration - Micropayments for AI agent services
- AI + DeFi - Natural language interface for blockchain
- Multi-step Transactions - Complex DeFi flows via voice
Built with β€οΈ for Hack2Build: Payments x402 Edition
MIT