HoodEx 🦊

The first DEX native to Robinhood Chain — Tokenized US equity spot swaps + perpetual futures, in one interface.

Trade TSLA, AMZN, PLTR, NFLX, AMD 24/7. Non-custodial. Powered by Chainlink.

---

What is HoodEx?

HoodEx combines Uniswap-style spot swaps and GMX-style perpetual futures for tokenized US equities on Robinhood Chain Testnet.

Feature	Description
Spot Swap	Swap stock tokens ↔ USDC via constant product AMM (x·y=k)
Perp Trading	1×–10× leveraged long/short positions on stock tokens
HLP Vault	Unified liquidity pool — earn fees from swaps + perps
24/7 Trading	Trade outside market hours with Chainlink oracle pricing

---

Screenshots

Markets Overview

Trade Interface

HLP Vault (Pool)

Portfolio

Leaderboard

---

Supported Markets

Token	Spot Swap	Perpetuals
TSLA (Tesla)	✅	✅
AMZN (Amazon)	✅	✅
PLTR (Palantir)	✅	✅
NFLX (Netflix)	✅	✅
AMD	✅	✅

---

Network

Parameter	Value
Network	Robinhood Chain Testnet
Chain ID	46630
RPC	https://rpc.testnet.chain.robinhood.com
Explorer	https://explorer.testnet.chain.robinhood.com
Block Time	~100ms

---

Tech Stack

Layer	Stack
Contracts	Solidity ^0.8.24, Hardhat, OpenZeppelin, Chainlink
Frontend	Next.js 16, TypeScript, Tailwind CSS, wagmi v2, RainbowKit
Backend	Node.js keeper bot, ethers.js v6, PostgreSQL
Infra	Vercel, Railway.app, Supabase, Alchemy

---

Documentation

Document	Description
📋 PRD	Product requirements, functional specs, success metrics
🏗️ Architecture	System design, contract graphs, data flows, security
🔧 Tech Stack	All technologies, versions, dependencies
🎨 Frontend	UI components, pages, layout, wallet integration
⚙️ Backend	Keeper bot, data indexer, database schema
📝 Smart Contracts	Contract specs, structs, functions, formulas
🔄 App Flow	User journeys, sequence diagrams, error handling

---

Quick Start

# Clone
git clone https://github.com/your-org/hoodex.git
cd hoodex

# Contracts
cd contracts && npm install
cp .env.example .env
npx hardhat compile
npx hardhat test

# Frontend
cd ../frontend && npm install
cp .env.example .env.local
npm run dev

# Keeper Bot
cd ../keeper && npm install
cp .env.example .env
npx tsx src/index.ts

---

Project Structure

hoodex/
├── contracts/          # Solidity smart contracts
│   ├── contracts/      # .sol files
│   ├── test/           # Unit & integration tests
│   └── ignition/       # Deployment scripts
├── frontend/           # Next.js 16 app
│   └── src/
│       ├── app/        # Pages (App Router)
│       ├── components/ # UI components
│       ├── hooks/      # Contract interaction hooks
│       └── lib/        # Config, ABIs, utils
├── keeper/             # Node.js keeper bot
│   └── src/            # Liquidator, funding rate cron
├── docs/               # Documentation
└── README.md

---

Architecture Overview

Frontend (Next.js) → wagmi/viem → PositionRouter.sol
                                      ↓
                    ┌─────────────────┼─────────────────┐
                    ↓                 ↓                 ↓
              SpotAMM.sol      PerpEngine.sol   HoodLiquidityPool.sol
                    ↓                 ↓                 ↓
                    └─────────────────┼─────────────────┘
                                      ↓
                              OracleRouter.sol
                                      ↓
                         Chainlink Price Feeds

---

License

MIT