AgentStart.-.From.zero.crypto.to.your.first.AI.agent.-.13.August.2026.mp4
From zero crypto to your first useful AI agent.
AgentStart onboards ordinary users into the Agent Economy. No wallets, no gas, no seed phrases. Users pick a useful AI agent, set a weekly budget, and get results — while every payment is a real on-chain transaction executed by KeeperHub on Base Sepolia.
🏆 Built for the KeeperHub — Agents Onchain Hackathon
AI agents are powerful, but inaccessible to ordinary people:
- ❌ No crypto wallet
- ❌ Don't understand gas fees
- ❌ Can't verify what agents actually did
- ❌ No control over spending
AgentStart hides all blockchain complexity behind a simple flow:
User: "I want today's crypto market summary"
↓
AgentStart: shows agents with clear prices
↓
User: picks Research Agent ($0.05) → sets $1/week budget
↓
AgentStart: charges via KeeperHub (real on-chain tx)
↓
Agent: executes with real-time data (CoinGecko)
↓
User: gets result + on-chain receipt (BaseScan link)
The user never sees: wallets, gas, RPC endpoints, approvals. The user always sees: prices, results, receipts, remaining budget.
| Agent | Price | What it does |
|---|---|---|
| 🔍 Research Agent | $0.05 | Crypto market summary: top coins, global market cap, Fear & Greed, trending |
| 📰 News Agent | $0.03 | Market-moving analysis: top gainer/loser, trending coins, sentiment |
| 🔔 Price Alert Agent | $0.02 | Price alerts with live CoinGecko prices and parsed targets |
All agents use real-time data (CoinGecko + Alternative.me). No mocks.
Users don't need wallets or crypto. KeeperHub manages a Turnkey EOA wallet. Users just pick an agent and pay per request.
Every request is charged via KeeperHub POST /execute/transfer on Base Sepolia (84532).
Users get the transaction hash and a BaseScan link — full proof of payment.
- Simulation first:
simulate: truedry-run before every broadcast - Idempotency-Key on all POSTs (no double charges)
- Polling with
X-Poll-Interval-Hintrespect - Rate limiting on the execute endpoint
- Zod validation on all API inputs
- Weekly budget (default $1/week), enforced before every execution (HTTP 402)
- Spending dashboard: spent / remaining / progress bar
- Analytics: spending by agent (pie) + timeline (bar) via Recharts
- Transaction history with on-chain receipts (shareable pages)
- CSV export of all transactions
- 100% TypeScript, Next.js 14 App Router
- Unit tests (Vitest) + GitHub Actions CI (typecheck, lint, format, test, build)
- Structured logging (Pino), HTTP client with retry (ky)
- React Query caching, Framer Motion live price ticker
- Accessibility (skip link, focus rings), Inter font, OG image
- 404 / error pages, skeletons, toasts, step-by-step payment indicator
┌──────────────────────────────────────────────────────────┐
│ AgentStart UI │
│ Next.js 14 + Tailwind + Recharts + Framer │
├──────────────────────────────────────────────────────────┤
│ API Routes │
│ /api/agents /api/execute /api/budget /api/prices │
│ /api/health │
├──────────────────────────────────────────────────────────┤
│ AgentStart Core │
│ Agent Registry → Budget Check → KeeperHub Charge → Exec │
├──────────────────────────────────────────────────────────┤
│ KeeperHub API │
│ POST /execute/transfer (simulate first) │
│ GET /execute/{id}/status (X-Poll-Interval-Hint) │
│ GET /user/wallet (Turnkey EOA) │
├──────────────────────────────────────────────────────────┤
│ Base Sepolia (chainId: 84532) │
└──────────────────────────────────────────────────────────┘
External data: CoinGecko API + Alternative.me Fear & Greed Index
Client persistence: localStorage (budget + receipts)
| Layer | Technology |
|---|---|
| Frontend | Next.js 14 (App Router), React 18, Tailwind CSS |
| Charts / Motion | Recharts, Framer Motion |
| State / Data | @tanstack/react-query, sonner |
| Backend | Next.js API Routes (TypeScript) |
| On-chain | KeeperHub Direct Execution API → Base Sepolia |
| Wallet | Turnkey EOA (managed by KeeperHub) |
| Validation | Zod |
| HTTP | ky (retry + timeout) |
| Logging | Pino |
| Tests | Vitest |
| Quality | ESLint + Prettier (+ tailwind plugin), GitHub Actions |
| Deploy | Vercel |
- Node.js 18+
- KeeperHub account + organization API key (
kh_...)
git clone https://github.com/YOUR_USERNAME/agentstart.git
cd agentstart
npm install
cp .env.example .env
# add your KEEPERHUB_API_KEY to .env
npm run devnpm run dev # development server
npm run build # production build
npm run start # production server
npm run test # unit tests (Vitest)
npm run check # typecheck + lint + format check
npm run m0 # M0 proof: KeeperHub transfer (simulation + broadcast)
npm run m0:simulate # M0 proof: simulation only
npm run m1 # M1 proof: Research Agent + payment E2E| Variable | Description | Default |
|---|---|---|
KEEPERHUB_API_KEY |
KeeperHub organization API key | required |
KEEPERHUB_BASE_URL |
KeeperHub API base | https://app.keeperhub.com/api |
CHAIN_ID |
Target chain | 84532 (Base Sepolia) |
agentstart/
├── app/ # Next.js App Router
│ ├── page.tsx # homepage (hero + how it works)
│ ├── agents/ # catalog + agent detail (pay & run)
│ ├── budget/ # spending dashboard + analytics
│ ├── receipt/[id]/ # shareable on-chain receipts
│ └── api/ # agents / execute / budget / prices / health
├── components/ # providers, PriceTicker, SpendingChart, ShareButton
├── src/
│ ├── agents/ # Research / News / PriceAlert agents + registry
│ ├── budget/ # server budget store + tests
│ ├── payments/ # KeeperHub payment module
│ ├── core/ # AgentStart orchestration
│ └── lib/ # utils, errors, logger, schemas, crypto-api,
│ # rate-limit, csv, budget-client (localStorage)
├── scripts/ # m0.ts / m1.ts proof scripts
├── docs/ # demo-script.md, submission.md
├── context/ + tasks/ # project docs & milestone tracking
└── .github/workflows/ci.yml # CI: typecheck, lint, format, test, build
AgentStart uses KeeperHub as its onchain execution layer:
GET /user/wallet— resolve the org's Turnkey EOA addressPOST /execute/transfer— charge the user per request- always simulate first (
simulate: true), then broadcast the same body Idempotency-Keyheader prevents double execution
- always simulate first (
GET /execute/{executionId}/status— poll untilcompleted- respects
X-Poll-Interval-Hint
- respects
- All transactions on Base Sepolia (chainId
84532), verifiable on BaseScan
| # | Milestone | Status |
|---|---|---|
| M0 | KeeperHub on-chain proof (zero-value self-transfer) | ✅ Closed |
| M1 | Research Agent + payment flow | ✅ Closed |
| M2 | AgentStart onboarding UI (Next.js) | ✅ Closed |
| M3 | Spending budget + transparency | ✅ Closed |
| M4 | Production polish / demo / submission | ✅ Closed |
npm run test # unit tests: budget store, utils, csv
npm run check # typecheck + lint + formatCI runs the full quality gate on every push (see .github/workflows/ci.yml).
Deployed on Vercel. Required env var: KEEPERHUB_API_KEY.
The budget & receipts persist in the browser (localStorage), so the demo works without a database. The on-chain source of truth is Base Sepolia via KeeperHub.
- More agents (trading, portfolio, news digests via LLM)
- KeeperHub spending caps integration (on-chain budget enforcement)
- Multi-chain support
- User accounts + persistent database
- Mobile app
MIT