aqil-claude-code

jarvismaxxing

Voice-authorized agentic payments. One biometric voice auth opens a bounded spending session — the agent transacts autonomously via x402 with no per-transaction wallet popups.

---

User Flow

1. Open http://localhost:3000
   → Jarvis HUD loads (dark arc-reactor UI, boot chime plays on first tap)

2. Tap the arc-reactor mic — enroll your voice (3 samples)
   → "Enroll voice (1/3)… (2/3)… (3/3)"
   → Voiceprint stored in the voice sidecar

3. Tap the mic — speak a purchase command
   → "Speak to Jarvis"  e.g. "buy some water" / "get me a coffee" / "bus ticket"

4. Jarvis executes in one shot — no popups, no wallet approval:
   a. Voice verified against enrolled voiceprint  (Resemblyzer cosine match ≥ 0.75)
   b. Session mandate minted  ($5 budget · 10 min · water + bus + coffee + parking)
   c. Intent parsed by Claude  → { item: "coffee", qty: 1, maxPriceUsd: 2 }
   d. Cheapest seller found across multi-city catalog  (geolocation price arbitrage)
   e. x402 payment via pay --sandbox curl  → on-chain tx sig in payment-receipt header
   f. Audit log updated immediately (no "pending" state ever)

5. UI shows immediately:
   ✅ Bought BeanHub for $1.00 — confirmed (5uKw9VMp…)
   Session panel shows budget bar: $5.00 · Spent $1.00

6. Speak again — no re-auth (session is still open)
   → Second purchase executes instantly, demonstrating zero friction within session

Sound cues (Web Audio API, no files):

• Boot chime on first mic tap (arc-reactor startup, plays once)
• High tone when listening starts
• Low tone when recording stops
• Confirm flourish on successful payment
• Error tone on rejection/mandate exceeded

---

What gets purchased (geolocation price arbitrage)

Say…	Item	Seller chosen	Price	Why
"buy some water"	water	AquaVend (KL)	$0.50	cheapest
"get a coffee"	coffee	BeanHub (KL)	$1.00	cheapest
"bus ticket"	bus	CityBus (KL)	$1.20	cheapest
"parking"	parking	ParkEasy (KL)	$0.80	cheapest

Other sellers at higher prices exist (Bangkok, Singapore) — resolveMerchant picks the cheapest and exposes alternatives[] for display/arbitrage UI.

---

Setup

Prerequisites

• Node.js + pnpm
• Python 3.11 + pip
• npm install -g @solana/pay (installs the pay x402 CLI binary)

1. Voice sidecar (Python)

cd services/voice
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn app:app --port 8000

2. Web app

cd apps/web
cp .env.local.example .env.local   # fill in ANTHROPIC_API_KEY
pnpm install
pnpm dev
# predev hook auto-starts: pay --sandbox server start services/payments/provider.yml (:1402)
# then starts Next.js on :3000

3. Browser

open http://localhost:3000

.env.local required

ANTHROPIC_API_KEY=sk-ant-...
VOICE_URL=http://localhost:8000

Optional: switch LLM provider

API_PROVIDER=anthropic       # default — direct Anthropic API (claude-opus-4-8)
API_PROVIDER=litellm-remote  # remote LiteLLM proxy
API_PROVIDER=litellm-local   # local OpenCode/LiteLLM on :4000

---

Architecture

Browser (Next.js — Jarvis HUD, Orbitron font, arc-reactor mic)
  └─ mic → /api/enroll → voice sidecar → voiceprint stored
  └─ mic → /api/verify → voice match → mandate minted
         → /api/transcribe → Whisper STT → transcript
         → /api/purchase → orchestrator

/api/purchase (Next.js App Router)
  └─ checkMandate (budget · category · expiry)
  └─ resolveMerchant (pickCheapest — haversine geo arbitrage)
  └─ pay-gateway: shells out → pay --sandbox curl -X POST :1402/v1/{item}
       └─ services/payments/provider.yml  (x402 sandbox, routing: respond)
            └─ payment-receipt header → reference (tx sig) → AuditLog

services/voice/  (Python FastAPI)
  POST /enroll      — Resemblyzer voiceprint embedding stored
  POST /verify      — cosine similarity ≥ 0.75 → mandate issued
  POST /transcribe  — Whisper STT → transcript text

No browser wallet. The pay CLI owns a sandbox wallet (auto-funded, 402.surfnet.dev:8899).

---

Merchant Catalog

Multi-seller catalog with real city coordinates for price arbitrage:

water   AquaVend $0.50 KL  ·  SpringWell $0.65 Bangkok  ·  HydroMart $0.75 Singapore
bus     CityBus  $1.20 KL  ·  MetroLink  $1.50 Singapore
coffee  BeanHub  $1.00 KL  ·  CafeNow   $1.35 Bangkok   ·  Roastery  $1.80 Singapore
parking ParkEasy $0.80 KL  ·  QuickPark  $1.10 Singapore

resolveMerchant(item, { userLocation: {lat, lng} }) picks cheapest, tiebreaks by distance, returns alternatives[].

---

x402 Payment Gateway

services/payments/provider.yml — runs as pay --sandbox server start:

• POST v1/water → $0.50
• POST v1/bus → $1.20
• POST v1/coffee → $1.00
• POST v1/parking → $0.80

Uses routing.type: respond (demo mode, no real upstream API).

---

Tests