Skip to main content

System Architecture

HyperPredict System Architecture

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

  • OpenAI GPT-5 and Codex