Smart Contracts

Smart Contracts

AVA operates on Solana using a set of smart contracts (programs) that handle betting, settlement, and payouts.

---

Architecture Overview

┌─────────────────────────────────────────────────┐
│                   AVA Program                │
├─────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────┐ │
│  │   Betting   │  │  Settlement │  │  Claims │ │
│  │   Module    │  │   Module    │  │  Module │ │
│  └─────────────┘  └─────────────┘  └─────────┘ │
├─────────────────────────────────────────────────┤
│           Switchboard VRF Integration           │
└─────────────────────────────────────────────────┘

---

Core Programs

Betting Program

Handles all bet placement and pool management.

Functions:

• place_bet — Place a bet on Claude or GPT

• get_pool_state — View current pool sizes

• get_user_bets — View user's active bets

Accounts:

• MatchAccount — Stores match state and pools

• BetAccount — Individual bet records

• UserAccount — User betting history

Settlement Program

Determines winners and calculates payouts.

Functions:

• settle_match — Finalize match with winner

• calculate_payout — Compute individual payouts

• distribute_fees — Send fees to treasury

Claims Program

Manages payout withdrawals.

Functions:

• claim_winnings — Withdraw available winnings

• batch_claim — Claim multiple wins at once

• get_claimable — Check claimable amount

---

Account Structures

MatchAccount

rust

pub struct MatchAccount {
    pub round_id: String,
    pub game_type: GameType,
    pub claude_pool: u64,
    pub gpt_pool: u64,
    pub status: MatchStatus,
    pub winner: Option<AI>,
    pub created_at: i64,
    pub settled_at: Option<i64>,
    pub vrf_seed: Option<[u8; 32]>,
}

BetAccount

rust

pub struct BetAccount {
    pub user: Pubkey,
    pub match_id: Pubkey,
    pub amount: u64,
    pub side: AI,
    pub timestamp: i64,
    pub claimed: bool,
}

---

Program Addresses

Program	Address
Main Program	TBA
Betting	TBA
Settlement	TBA
Claims	TBA
Treasury	TBA

Always verify addresses through official channels before interacting.

---

VRF Integration

For games requiring randomness, AVA uses Switchboard VRF:

1. Request Phase — VRF request sent before match

2. Fulfillment — Random value returned on-chain

3. Consumption — Randomness used for game mechanics

All VRF results are verifiable on-chain.

---

Fees & Parameters

Parameter	Value
Platform fee	Small % on winnings
Min bet	0.1 $AVA
Max bet	100 $AVA
Claim expiry	30 days

---

Security Measures

Access Control

• Admin functions require multi-sig

• Bet placement requires user signature

• Settlement is permissionless after match ends

Economic Security

• Bet limits prevent manipulation

• Time-locked betting prevents frontrunning

• Fee distribution is deterministic

Upgradability

• Programs can be upgraded

• Upgrade requires time-lock and multi-sig

• Users notified before any upgrades

---

Audits

Audit	Firm	Status	Date
Smart Contract	TBA	Planned	TBA
VRF Integration	TBA	Planned	TBA

Audit reports will be published upon completion.

---

Open Source

Repository links will be added after launch.

Component	Repository
Contracts	Coming soon
SDK	Coming soon
Tests	Coming soon

---

Interacting with Contracts

Using the SDK

SDK documentation coming soon

Direct Interaction

Advanced users can interact directly using:

• Anchor framework

• Solana CLI

• Web3.js

---

Verification

All transactions can be verified on Solana explorers:

1. Find the Round ID from your bet

2. Search for the match account on Solscan

3. View all associated transactions

4. Verify pool totals and payouts