# Introduction

![Version](https://img.shields.io/badge/Version-2.2.0-blue) ![Network](https://img.shields.io/badge/Network-Base%20Mainnet-0052FF) ![Framework](https://img.shields.io/badge/Framework-Base%20MiniApp%20Kit-0052FF)

> **Turning Complex DeFi Options into an Arcade Experience**

Alphabit is a Web3 Mini-App built with **Base MiniApp Kit** that gamifies DeFi options trading. Instead of understanding Greeks and option chains, users simply predict "ETH UP" or "BTC DOWN" — we handle the rest.

***

## The Problem

| Challenge         | Traditional DeFi                    | Alphabit                          |
| ----------------- | ----------------------------------- | --------------------------------- |
| **Complexity**    | Delta, Theta, Gamma, Strike Prices  | Simple UP/DOWN predictions        |
| **UX**            | Confusing interfaces, slow feedback | Arcade-style UI, instant feedback |
| **Engagement**    | No retention mechanics              | XP, Levels, Streaks, Achievements |
| **Accessibility** | Deep financial knowledge required   | "I think ETH goes UP" → Done      |

***

## Key Features

### 🕹️ Dual Mode Experience

**ARCADE MODE** - For Everyone

* One-tap directional predictions
* Gamified UI with XP and Levels
* Visual planet-based timeframe selection
* Interactive mini-games during trades

**PRO MODE** - For Power Users

* Full trading terminal
* Direct option parameter control
* AI-powered "Tactical Droid" assistant
* Complete position and PnL tracking

### 🧠 Intelligent Order Matching

```
User Intent: "ETH UP, 6 hours"
         ↓
   [Execution Matcher]
         ↓
Best Option: Strike $3,200, Exp 6H, +50% ROI
```

### 🏆 Gamification

* **Levels** - Cadet → Scout → Ranger → Ace → Legend
* **Daily Missions** - Access Terminal, Market Recon, Deploy Trade
* **Achievements** - First Blood, Diamond Hands
* **Streaks** - Login & Win streaks

***

## Tech Stack

| Layer          | Technology                                            |
| -------------- | ----------------------------------------------------- |
| **Frontend**   | Base MiniApp Kit, Next.js 16, OnchainKit, wagmi, viem |
| **Backend**    | Express 5, Prisma, PostgreSQL                         |
| **Blockchain** | Base Mainnet, Thetanuts Protocol                      |
| **Social**     | Farcaster MiniApp SDK, Neynar                         |
| **Oracles**    | Chainlink Price Feeds                                 |

***

## Quick Start

### Frontend

```bash
cd alphabit
npm install
cp .env.example .env
npm run dev
```

### Backend

```bash
cd alphabit-be
npm install
cp .env.example .env
npm run db:push
npm run dev
```

***

## Links

* [Setup Guide](https://alphabit-mancer.gitbook.io/alphabit-mancer-docs/getting-started/setup-guide)
* [Architecture](https://alphabit-mancer.gitbook.io/alphabit-mancer-docs/technical/architecture)
* [API Reference](https://alphabit-mancer.gitbook.io/alphabit-mancer-docs/technical/api-reference)
* [Gamification](https://alphabit-mancer.gitbook.io/alphabit-mancer-docs/features/gamification)
* [Arcade Mode](https://alphabit-mancer.gitbook.io/alphabit-mancer-docs/features/arcade-mode)