Technical Architecture

This document provides an overview of the technical architecture behind the Bettors platform for developers and technically-oriented users.

Technology Stack

Bettors is built using the following technologies:

• Frontend:

  • Next.js - React framework for server-rendered applications

  • React - UI component library

  • Tailwind CSS - Utility-first CSS framework

  • TypeScript - Typed JavaScript

• Blockchain Integration:

  • Solana Web3.js - Solana JavaScript API

  • Wallet Adapter - Solana wallet connection library

• Build Tools:

  • Bun - JavaScript runtime and package manager

Application Architecture

Bettors follows a modern web application architecture:

├── app/                 # Next.js app directory structure
│   ├── api/             # API endpoints
│   ├── live/            # Live betting page
│   ├── mybets/          # User bets history page
│   └── leaderboard/     # Leaderboard page
├── components/          # Reusable React components
├── public/              # Static assets
└── lib/                 # Utility functions and helpers

Key Components

The application is built around several key components:

1. Betting Cards: Display information about each prediction and betting options

2. Bet Popup: Modal interface for placing bets with amount input and multiplier display

3. Wallet Connection: Integration with Solana wallets for authentication and transactions

4. Notification System: UI elements to display transaction status and results

Data Flow

Data flows through the application as follows:

1. Bet Data Retrieval:

   • API fetches available predictions from the database

   • Live page displays predictions with current pool information

2. User Interaction:

   • User connects wallet and initiates a bet

   • Bet information (amount, position) is prepared for transaction

3. Transaction Processing:

   • Transaction is created with pool transfer and fee instructions

   • User approves transaction in their wallet

   • Transaction is sent to the Solana blockchain

4. Post-Transaction Updates:

   • UI immediately updates to show bet impact

   • Database records the user's bet for history tracking

   • Pool multipliers are recalculated based on new distribution

Smart Contract Integration

Bettors uses direct Solana transfers rather than complex smart contracts:

• Bets are recorded as standard SOL transfers to the pool address

• A designated fee wallet receives platform fees

• Payouts are processed as transfers from the pool to winner wallets

This approach provides several benefits:

• Simplified architecture with fewer potential points of failure

• Lower transaction fees for users

• Faster transaction confirmation times

Security Considerations

The platform implements several security measures:

1. Client-Side Security:

   • No private keys are ever stored or processed by the application

   • All transactions require explicit user approval

   • Wallet connection is secured using standard Wallet Adapter protocols

2. Transaction Security:

   • All transactions include a recent blockhash to prevent replay attacks

   • Fixed transaction structure with predictable fee calculation

   • Error handling for failed or declined transactions

3. Data Integrity:

   • Bet records are maintained both on-chain (as transactions) and off-chain

   • Pool calculations are verified against on-chain data

   • Result determination follows a transparent validation process

Performance Optimization

The application is optimized for performance in several ways:

1. Next.js Optimizations:

   • Server-side rendering for faster initial page loads

   • Static generation where possible

   • Dynamic imports for code splitting

2. UI Optimizations:

   • Minimal re-renders through proper state management

   • Progressive loading of bet information

   • Responsive design for different screen sizes

3. Network Optimization:

   • Batched API requests

   • Connection pooling for database queries

   • CDN distribution of static assets