
Smart Contracts
- HyperPredictV1Factory → deploys market pairs and manages global settings such as fees and referral rates
- HyperPredictV1Pair → manages rounds, incremental betting, locking, settlement, fees, payouts
- ReferralRegistry → tracks referral relationships
Oracle Module (Pyth)
- Direct usage of Pyth Network price feeds
- Ensures fresh, reliable pricing for settlement
- Validated on-chain for deterministic outcomes
Market API
- Official Pyth Market API provides only latest price data, not historical, so we built a custom Market API for fetching historical prices.
- FastAPI for REST market data
- ClickHouse for high-frequency price & round history storage
Graph Node
- It uses The Graph to index on-chain events
- We run our own indexer on BNB Chain infrastructure so we can ingest on-chain events without waiting for third-party subgraph support.
Frontend
- React + Vite
- Lightweight Charts for price visualization
- Privy for authentication
- viem for blockchain interactions
- Tailwind CSS and Shadcn UI for styling and components
Coding Agents