Skip to main content

System Architecture

Predinex is built as a modular, scalable platform that combines multiple technologies to deliver a seamless prediction market experience. This page provides a high-level overview of our system components and data flow.

🏗️ Architecture Overview​

🎯 Core Components​

🌐 Frontend Layer​

Progressive Web App built for optimal user experience:

  • React/Next.js for responsive UI
  • Web3 wallet integration (MetaMask, WalletConnect)
  • Real-time updates via WebSocket connections
  • Mobile-optimized design for prediction on the go

⛓️ Blockchain Layer (BSC Network)​

Smart contracts that handle all core logic:

📊 PredinexPool Contract​

  • Pool creation and management
  • Bet placement and liquidity provision
  • Settlement and payout distribution
  • Reputation tracking and access control

🔮 Guided Oracle Contract​

  • Automated outcome resolution
  • Integration with external data sources
  • Fraud protection and validation

🗳️ Optimistic Oracle Contract​

  • Community-driven outcome proposals
  • Dispute resolution mechanism
  • Bonding and challenge system

🎮 Oddyssey Contract​

  • Daily game creation and management
  • Slip submission and scoring
  • Leaderboard and prize distribution

🔗 Backend Infrastructure​

Scalable services that support the frontend and contracts:

📡 API Server​

  • RESTful endpoints for pool data
  • Real-time analytics and statistics
  • User management and reputation tracking
  • Rate limiting and caching

⚡ Event Indexer​

  • Real-time blockchain event processing
  • Database synchronization
  • Analytics data aggregation
  • Notification triggers

🤖 Oracle Bot​

  • Automated outcome submission
  • Data verification and validation
  • Transaction scheduling and retry logic
  • Error handling and alerting

📊 Data Fetcher​

  • Scheduled API calls to external sources
  • Data transformation and normalization
  • Database storage and caching
  • API rate limit management

💾 Data Layer​

PostgreSQL database with optimized schemas:

  • Core: User accounts and reputation
  • Oracle: External data from APIs
  • Prediction: Pool and bet tracking
  • Analytics: Aggregated statistics and metrics

🔄 Data Flow​

📈 Pool Creation Flow​

  1. User creates pool via frontend
  2. Frontend calls smart contract
  3. PredinexPool emits PoolCreated event
  4. Indexer captures event and stores in database
  5. API serves updated pool data to frontend

🎯 Bet Placement Flow​

  1. User places bet via frontend
  2. Frontend validates bet constraints
  3. Smart contract processes bet and transfers tokens
  4. Indexer updates database with bet data
  5. API provides real-time updates to all users

🔮 Oracle Resolution Flow​

  1. Data Fetcher retrieves outcome from external API
  2. Database stores validated outcome data
  3. Oracle Bot submits outcome to smart contract
  4. Guided Oracle processes and validates outcome
  5. PredinexPool settles affected pools
  6. Indexer updates settlement data
  7. Users can claim winnings via frontend

🛡️ Security Architecture​

🔐 Smart Contract Security​

  • Multi-signature deployment and upgrades
  • Timelock for critical parameter changes
  • Access control with role-based permissions
  • Reentrancy guards on all external calls
  • Overflow protection with SafeMath

🛡️ Oracle Security​

  • Multiple data sources for cross-verification
  • Economic incentives for honest behavior
  • Dispute mechanisms for challenge periods
  • Slashing conditions for malicious actors

🔒 Infrastructure Security​

  • API rate limiting to prevent abuse
  • Input validation on all endpoints
  • Database encryption at rest and in transit
  • Regular security audits and penetration testing

📊 Scalability Design​

⚡ Performance Optimizations​

  • BSC Network: 400,000+ TPS capacity
  • Database indexing for fast queries
  • API caching with Redis
  • CDN integration for static assets

📈 Growth Handling​

  • Horizontal scaling of API servers
  • Database sharding for large datasets
  • Event processing with message queues
  • Microservices architecture for modularity

🔧 Monitoring & Analytics​

  • Real-time metrics via Prometheus
  • Error tracking with Sentry
  • Performance monitoring with DataDog
  • User analytics with custom dashboards

🌐 Integration Points​

📡 External APIs​

  • SportMonks: Live sports data and results
  • CoinGecko: Cryptocurrency prices and market data
  • Custom APIs: Additional data sources as needed

🔗 Blockchain Integrations​

  • BSC RPC: Primary blockchain connection
  • IPFS: Decentralized storage for metadata
  • The Graph: Optional subgraph for complex queries

📱 Frontend Integrations​

  • Wallet providers: MetaMask, WalletConnect, Coinbase
  • Analytics: Google Analytics, Mixpanel
  • Social features: Twitter, Discord integrations

🚀 Deployment Strategy​

🧪 Development Environment​

  • Local blockchain with Hardhat
  • Test databases with sample data
  • Mock APIs for development testing

🔧 Staging Environment​

  • BSC testnet for contract testing
  • Staging database with production-like data
  • Integration testing with real APIs

🌟 Production Environment​

  • BSC mainnet for live contracts
  • Production database with high availability
  • Load balancers and CDN for global access
  • Automated deployments with CI/CD

This architecture is designed to be modular, scalable, and secure while providing the best possible user experience for prediction markets.