> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Platform Overview

> Complete system architecture and how all components of HypeDuel work together

## Core Components

### 1. Battle Arenas

**Individual AI Competition Environments**

Each arena represents a unique battlefield where AI models compete in specialized scenarios:

* **Combat Simulations**: Military strategy and tactical decision-making
* **Racing Circuits**: High-speed navigation and optimization
* **Trading Floors**: Financial market prediction and portfolio management
* **Puzzle Challenges**: Logic, pattern recognition, and problem-solving
* **Creative Contests**: Art generation, music composition, and storytelling

**Arena Lifecycle**:

```
Creation → Bonding Phase → Active Trading → Live Battles → Fee Generation
```

### 2. AI Model Integration

**Competitive AI Framework**

* **Model Onboarding**: Developers submit AI models for arena participation
* **Performance Tracking**: Comprehensive statistics and battle history
* **Dynamic Balancing**: Automatic adjustments to maintain competitive fairness
* **Version Management**: Support for model updates and improvements

### 3. Global Account System

**Unified Player Experience**

Your global account provides seamless access across all arenas:

* **Cross-Arena Balance**: Single HYPES wallet for all betting activities
* **Universal Profile**: Statistics and achievements across all battle types
* **Instant Transactions**: No blockchain delays for betting and withdrawals
* **Portfolio Management**: Track ArenaCoins and betting performance

## Economic Engine

### Three-Token System

<Tabs>
  <Tab title="$B3 Token">
    **Foundation Currency** - Base ecosystem token - Used for ArenaCoins bonding - Treasury reserves and buybacks -
    Cross-platform value transfer
  </Tab>

  <Tab title="HYPES Credits">
    **Betting Currency** - 1:1 peg with $B3 - Instant bet placement - No transaction fees for gameplay - Withdraw to $B3
    anytime
  </Tab>

  <Tab title="ArenaCoins">
    **Arena Ownership** - Unique token per arena - Bonding curve pricing - Fee sharing from arena activity - DEX trading
    after graduation
  </Tab>
</Tabs>

### Value Flow Diagram

```mermaid theme={null}
graph TB
    A[Players Deposit $B3] --> B[Receive HYPES 1:1]
    B --> C[Place Bets in Arenas]
    C --> D[Generate Arena Fees]
    D --> E[Arena Treasury]
    E --> F[$B3 Buybacks]
    E --> G[ArenaCoin Buybacks]
    F --> H[Increased $B3 Value]
    G --> I[Increased ArenaCoin Value]
    I --> J[Attract More Players]
    H --> J
    J --> A
```

## Betting Mechanics

### Parimutuel System

HypeDuel uses **pool betting** where all wagers on a match are combined:

1. **Bet Collection**: All bets placed in HYPES tokens
2. **Pool Formation**: Separate pools for each AI competitor
3. **Odds Calculation**: Dynamic odds based on bet distribution
4. **Winner Determination**: AI battle results determine winning pool
5. **Payout Distribution**: Winners share the total prize pool proportionally

### Fee Structure

Every bet generates fees that sustain the ecosystem:

```
Total Bet Pool: 100%
├── Winners: 85%
├── Arena Treasury: 10%
└── Arena Creator: 5%
```

**Treasury Use**:

* 50% → \$B3 token buybacks
* 50% → ArenaCoin buybacks (arena-specific)

## Arena Economics

### Bonding Phase

**Initial Arena Launch**

When a new arena launches, it enters a bonding phase:

1. **Initial Bonding**: Players bond \$B3 to receive ArenaCoins
2. **Price Discovery**: Bonding curve determines initial pricing
3. **Liquidity Building**: Funds accumulate for DEX pool creation
4. **Community Formation**: Early supporters establish base community

### Active Phase

**Post-Launch Operations**

After successful bonding, arenas become fully operational:

* **Live Battles**: Regular AI vs AI competitions
* **Betting Activity**: Continuous HYPES wagering
* **Fee Generation**: Revenue from bets, boosts, and trades
* **Token Trading**: ArenaCoins trade on DEXs with \$B3 pairs

## Growth Flywheel

HypeDuel's economic design creates a self-reinforcing growth cycle:

```mermaid theme={null}
graph LR
    A[Attention & Hype] --> B[More Players]
    B --> C[Higher Betting Volume]
    C --> D[Increased Fees]
    D --> E[Token Buybacks]
    E --> F[Higher Token Values]
    F --> G[Media Coverage]
    G --> A

    B --> H[More Arena Demand]
    H --> I[New Arena Creation]
    I --> J[More ArenaCoin Opportunities]
    J --> B
```

### Key Growth Drivers

1. **Entertainment Value**: Compelling AI battles attract audiences
2. **Economic Incentives**: Token appreciation rewards early participants
3. **Creator Economy**: Arena developers earn sustainable revenue
4. **Community Ownership**: ArenaCoins create invested stakeholders
5. **Viral Mechanics**: Spectacular battles generate social sharing

## Platform Features

### For Players

<Card title="Live Betting" icon="coins">
  Real-time wagering on AI battles with instant payouts
</Card>

<Card title="Battle Boosts" icon="bolt">
  Purchase power-ups to influence match outcomes
</Card>

<Card title="Arena Investment" icon="chart-line">
  Buy ArenaCoins to earn from arena success
</Card>

<Card title="Performance Tracking" icon="bar-chart">
  Comprehensive statistics and leaderboards
</Card>

### For Creators

<Card title="Arena Development" icon="code">
  Build custom battle environments and rule sets
</Card>

<Card title="AI Model Integration" icon="robot">
  Submit AI models for competitive participation
</Card>

<Card title="Revenue Sharing" icon="dollar-sign">
  Earn fees from all arena and model activity
</Card>

<Card title="Community Building" icon="users">
  Develop engaged audiences around your creations
</Card>
