Jumpa is a premium, high-performance wallet built for the PL_Genesis: Frontiers of Collaboration hackathon. It combines the power of Claude 4.5 Sonnet with the high-speed Flow EVM to create a seamless, agent-native financial ecosystem.
Jumpa is engineered to push the boundaries of high-performance consumer coordination across three core frontiers:
- AI & Robotics: Features a deeply integrated 3rike AI assistant powered by Claude 4.5 Sonnet. The interface parses complex natural language intent (e.g., "Send 5 FLOW to @Ola", "Swap all my USDC for FLOW") into precise on-chain execution payloads.
- Crypto & Economic Systems: Native, first-class support for Flow EVM. Includes a bespoke Smart Trade engine integrated with PunchSwap V2 for real-time liquidity probing and high-efficiency token swaps with minimal slippage.
- Infrastructure & Digital Rights: Implements a Sovereign Security model. Users maintain total control over their encrypted mnemonic phrases and private keys, secured by a local-first AES-256-GCM encryption layer locked with a 6-digit PIN.
| Layer | Technology | Highlights |
|---|---|---|
| Framework | Next.js 16 (App Router) | Server-side rendering & optimized API route handlers |
| Frontend | React 19 | Concurrent rendering & ultra-fast state synchronization |
| Styling | Tailwind CSS v4 | Next-generation utility-first CSS engine |
| Logic/AI | Claude 4.5 Sonnet | Advanced multi-turn intent parsing and autonomous coordination |
| Web3 | Flow EVM | Reliable, high-speed on-chain settlement layer |
| Database | MongoDB | High-performance document storage for sessions & histories |
| Auth | Better-Auth | Secure, modern authentication with social & passkey support |
jumpa-website/
├── app/ # Next.js App Router (Next.js 16)
│ ├── api/ # API Endpoints
│ │ ├── ai/ # AI intent & multi-turn history
│ │ ├── auth/ # Session & authentication management
│ │ ├── wallet/ # Flow EVM operations & balances
│ │ └── pin/ # PIN-secured cryptographic verification
│ ├── (auth)/ # Authentication Pages (Login, Recovery)
│ ├── (home)/ # Protected Dashboard & Feature Routes
│ │ ├── dashboard/ # Multi-chain wallet overview
│ │ ├── 3rike-ai/ # Dedicated AI assistant interface
│ │ ├── airtime/ # Airtime top-up flow
│ │ ├── savings/ # Target-based savings & goal tracking
│ │ └── ... # Loans, Investments, Group Splits, Verification
│ └── layout.tsx # Root layout with global context providers
├── components/ # High-fidelity React components
│ ├── common/ # Global UI (TopBar, Nav, Themes)
│ ├── modal/ # Seamless overlays, sheets, and drawers
│ └── ui/ # Atomic primitives (shadcn/ui style)
├── lib/ # Application logic layers
│ ├── api.ts # Type-safe frontend API client
│ ├── wallet.ts # Flow EVM derivation & transaction signing
│ ├── crypto.ts # AES-256-GCM sovereign encryption
│ └── withAuth.ts # Authenticated route middleware
├── models/ # Mongoose data schemas (Wallet, Transaction, Log)
└── public/ # Static assets (Iconography, Locales, Brand)
Jumpa is built on the principle of User Sovereignty:
- BIP39 Seed Phrases: Users generate their own standard 12-word mnemonic phrases.
- PIN-Secured Encryption: Phrases are never stored in plain text. They are encrypted using AES-256-GCM on the client-side, using a secret derived from the user's 6-digit PIN.
- Decryption on Demand: Sensitive operations (e.g., signing a transaction, revealing private keys) happen in a temporary, PIN-verified context.
- Natural Language Parsing: Direct conversion of text or voice intent into structured JSON payloads for Flow EVM operations.
- Focus Blur Interaction: Implements a premium UI pattern where the background blurs during AI interaction to focus user attention on the decision layer.
- Persistent Context: Uses MongoDB to maintain multi-turn chat memory, allowing for complex follow-up commands like "now swaphalf of that for USDC".
- Real-time Settlement: Low-latency transaction finality on the Flow blockchain.
- Liquidity Probing: Automated quotes from PunchSwap V2, ensuring the best rates across multiple token variants.
- Unified Assets: One interface for manageable assets across FLOW, USDC, and ETH ecosystems.
- Savings & Goals: Full CRUD support for personal financial targets with real-time progress tracking.
- Group Finance: Smart coordination for splitting bills and shared expenses.
- Loan & Investments: Streamlined interfaces for non-custodial lending and asset growth.
npm installCreate a .env.local file in the root directory:
# MongoDB Connection
MONGO_URI=your_mongodb_uri
# LLM Intelligence (Claude 4.5 Sonnet)
ANTHROPIC_API_KEY=your_key
# Unified Authentication (Better-Auth)
GOOGLE_CLIENT_ID=your_google_id
GOOGLE_CLIENT_SECRET=your_google_secret
AUTH_SECRET=your_auth_secret
AUTH_URL=http://localhost:3000
# Blockchain
NEXT_PUBLIC_FLOW_NETWORK=mainnetnpm run devThe application will launch on http://localhost:3000.