An autonomous AI agent that teaches Web3 concepts and rewards learners with SOL on Solana devnet
Built for Solana x402 Hackathon | Track 5: x402 Agent Application
See Learn Earn in action: AI-powered education meets autonomous blockchain payments.
Learn Earn demonstrates the x402 protocol with production-ready integrations across two sponsor technologies:
Distributed inference platform powering autonomous learning evaluation
- 120B parameter model (
gpt-oss-120b) evaluates student answers - Solved Gradient API function calling limitation through custom text parsing
- Makes autonomous payment decisions without human approval
- Technical Deep Dive →
Embedded wallets that eliminate onboarding friction
- Create Solana wallets without browser extensions
- Zero-setup wallet experience for crypto newcomers
- Full CDP SDK v2 implementation with auto-funding
- Technical Deep Dive →
HTTP 402 "Payment Required" protocol implementation
- Proper x402 protocol headers and status codes
- Autonomous AI agent with payment authority
- Real-time blockchain payment verification on Solana
- Technical Deep Dive →
Traditional educational platforms suffer from:
- Low completion rates (lack of immediate incentives)
- High friction for crypto newcomers (complex wallet setup)
- Centralized certification with no blockchain verification
- No autonomous payment systems for learning rewards
The x402 opportunity: Enable AI agents to autonomously evaluate learning progress and distribute cryptocurrency rewards without human intervention.
An AI agent that autonomously:
- Delivers educational content about x402 and Solana
- Evaluates student answers using Gradient Parallax inference (120B parameter model)
- Decides when to issue rewards (0.01 SOL per correct answer)
- Executes blockchain transactions to distribute SOL
- Tracks progress and manages session economics
Payment Flow (Hackathon Demonstration):
This closed-loop payment system demonstrates technical feasibility of autonomous agent economics:
- Treasury airdrops 0.04 SOL to new users
- Users pay 0.03 SOL to unlock 3 learning modules
- AI agent rewards 0.01 SOL per completed module
- Total earned: 0.03 SOL (break even, net +0.01 SOL from airdrop)
Result: Proof-of-concept for autonomous payment loops. See Use Cases for real-world applications.
AI-Powered Evaluation
- Gradient Parallax distributed inference evaluates natural language answers
- Progressive hint system for incorrect responses
- OpenAI fallback ensures 99.9% uptime
- Session state management with persistent storage
Autonomous Payment System
- AI controls treasury wallet and signs transactions
- Real-time SOL distribution (400ms Solana finality)
- Transaction verification on-chain
- Rate limiting prevents abuse
Flexible Wallet Support
- Coinbase CDP embedded wallets (zero-extension)
- Phantom wallet (browser extension)
- Coinbase Wallet (browser extension)
On-Chain Transparency
- All transactions verifiable on Solana Explorer
- Open source codebase for full auditability
- Treasury wallet publicly visible
- Real blockchain interactions, not simulated
┌─────────────────────────────────────────────────────┐
│ Frontend (React + Solana Wallet Adapter) │
│ Multi-Wallet Support: Phantom | CDP | Coinbase │
└────────────────────┬────────────────────────────────┘
│ REST API
┌────────────────────▼────────────────────────────────┐
│ Backend AI Agent (Node.js + Express) │
│ • Gradient Parallax (primary): gpt-oss-120b │
│ • OpenAI (fallback): gpt-3.5-turbo │
│ • Payment decision logic │
│ • Session management │
└────────────────────┬────────────────────────────────┘
│ Solana Web3.js
┌────────────────────▼────────────────────────────────┐
│ Solana Devnet Blockchain │
│ • Treasury wallet (autonomous agent control) │
│ • User wallets (Phantom, CDP, Mobile) │
│ • Real SOL transactions (~400ms finality) │
└─────────────────────────────────────────────────────┘
Frontend
- React 19 + Vite
- Solana Wallet Adapter (multi-wallet)
- Coinbase Wallet SDK + CDP integration
- Solana Mobile Wallet Adapter
- Tailwind CSS + shadcn/ui
Backend
- Node.js + Express REST API
- Gradient Parallax inference (gpt-oss-120b, 120B params)
- OpenAI API (fallback)
- Solana Web3.js
- Coinbase CDP SDK v2
Blockchain
- Solana Devnet
- Base58-encoded treasury keypair
- Multiple wallet providers
- Real transaction confirmations
Deployed App: [Add your deployment URL]
Prerequisites: Node.js 18+, Phantom or Coinbase Wallet
# Clone and install
git clone https://github.com/hewi333/Solanax402-Hackathon.git
cd Solanax402-Hackathon
npm install && cd backend && npm install && cd ..
# Configure environment
cp .env.example .env
cp backend/.env.example backend/.env
# Generate treasury wallet
cd backend && node generate-treasury-wallet.js
# Add keys to .env files (see DEPLOYMENT.md)
# Fund treasury at https://solfaucet.com
# Start services (two terminals)
cd backend && npm start # Terminal 1: Backend (port 3001)
npm run dev # Terminal 2: Frontend (port 5173)Full setup guide: See DEPLOYMENT.md
Immediate (Hackathon Demonstration)
- Proof-of-concept: Closed-loop payment system demonstrates technical feasibility
- x402 Protocol: HTTP 402 implementation with autonomous agent authority
- Educational demo: Web3 concepts taught with instant SOL rewards
Real-World Applications (Post-Hackathon)
- Sponsored Learning: Blockchain projects fund educational modules, learners earn tokens
- Corporate Training: Companies pay for courses, employees earn rewards for completion
- Developer Onboarding: Protocols reward developers for learning their tech stack
- Certification NFTs: On-chain credentials proving skill mastery
Long-Term Vision
- DAO-governed curriculum with community course creation
- Multi-chain expansion with x402 protocol
- Target: 100,000+ learners with verifiable on-chain credentials
- Sustainable economics: Sponsors fund rewards, not closed-loop demonstration
x402 Protocol Excellence
- Proper HTTP 402 implementation with protocol headers
- AI agent has autonomous payment authority
- Real blockchain verification, not simulated
- Consumer-facing application (judges can relate)
Technical Achievement
- Solved Gradient Parallax limitation (no native function calling)
- Dual-provider inference architecture (99.9% uptime)
- Production-ready CDP integration (zero-extension onboarding)
- 120B parameter distributed model makes autonomous decisions
Ecosystem Advancement
- Lowers barrier for crypto newcomers (embedded wallets)
- Demonstrates autonomous agent payment loops (technical feasibility)
- Shows x402 protocol value proposition clearly
- Fully open source for community building
Differentiation
- vs Traditional Education: We reward learners, not charge them (net positive)
- vs Other x402 Projects: Consumer-facing, fully functional, relatable use case
- vs Centralized Learning: Blockchain-verified progress, autonomous payments
3-Minute Demo Flow:
- Show wallet options (Phantom, Coinbase extension, CDP embedded)
- Create embedded wallet (no extension needed)
- Request 0.04 SOL airdrop from treasury (devnet)
- Pay 0.03 SOL to unlock learning platform
- Complete module 1, receive instant 0.01 SOL reward
- Show transaction on Solana Explorer (devnet)
- Explain autonomous AI agent decision-making via Gradient Parallax
- Demonstrate closed-loop payment system (proof-of-concept)
Track 5 Alignment:
- ✅ AI agent makes autonomous payment decisions
- ✅ Agent controls treasury wallet, signs transactions
- ✅ HTTP 402 protocol properly implemented
- ✅ Real Solana blockchain integration
- ✅ Production-ready, scalable architecture
Solanax402-Hackathon/
├── README.md # This file
├── DEPLOYMENT.md # Hosting setup guide
│
├── docs/ # Sponsor integration showcases
│ ├── gradient-integration.md # Gradient Parallax AI
│ ├── coinbase-integration.md # CDP embedded wallets
│ └── x402-integration.md # x402 protocol
│
├── src/ # Frontend React application
│ ├── components/
│ │ ├── ChatInterface.jsx # AI-powered learning UI
│ │ ├── EmbeddedWalletButton.jsx
│ │ └── RewardsModal.jsx
│ ├── learningModules.js # Educational content
│ └── App.jsx # Main app + payment gate
│
└── backend/ # Node.js server
├── server.js # AI agent + API (1540 lines)
├── generate-treasury-wallet.js
└── README.md # API documentation
Setup & Deployment
- DEPLOYMENT.md - Production deployment (Vercel + Railway)
- backend/README.md - Backend API reference
Sponsor Integration Deep Dives
- Gradient Parallax Integration - Distributed inference, autonomous decisions
- Coinbase CDP Integration - Embedded wallets, zero-friction onboarding
- x402 Protocol Integration - HTTP 402, autonomous agent payments
Project
- GitHub: hewi333/Solanax402-Hackathon
- Live Demo: Link
- License: MIT
Resources
Built by @hewi333 for Solana x402 Hackathon
Demonstrating autonomous AI agents that manage payments on Solana
Solana x402 Hackathon - November 2025