CLOB Market Program Migration

Overview

The betting system has been migrated from a binary market program to a CLOB (Central Limit Order Book) market program for Solana mainnet deployment (commits dba3e03, 35c14f9).

Changes

Program Addresses (Mainnet)

Fight Oracle:

Program ID: Fg6PaFpoGXkYsidMpWxTWqkY8B4sT2u7hN8sV5kP6h1
Location: packages/gold-betting-demo/anchor/programs/fight_oracle/src/lib.rs

GOLD CLOB Market:

Program ID: Updated to mainnet address
Location: packages/gold-betting-demo/anchor/programs/gold_clob_market/src/lib.rs
Replaces: gold_binary_market program (deprecated)

GOLD Token:

Mint: DK9nBUMfdu4XprPRWeh8f6KnQiGWD8Z4xz3yzs9gpump
Token Program: TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
Associated Token Program: ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL

IDL Updates

Updated Files:

packages/gold-betting-demo/keeper/src/idl/fight_oracle.json - Mainnet program ID
packages/gold-betting-demo/app/src/idl/fight_oracle.json - Mainnet program ID
packages/gold-betting-demo/app/src/idl/gold_clob_market.json - New CLOB market IDL
Removed: gold_binary_market.json (deprecated)

Bot Rewrite

Location: packages/gold-betting-demo/keeper/src/bot.ts Old Instructions (Binary Market):

initializeMarket
seedMarket
createVault
placeBet
resolveMarket

New Instructions (CLOB Market):

initializeConfig - Initialize global market configuration
initializeMatch - Create a new duel match
initializeOrderBook - Create order book for a match
placeBuyOrder - Place buy order (bet on fighter A)
placeSellOrder - Place sell order (bet on fighter B)
resolveMatch - Resolve match outcome and settle orders

Key Differences:

CLOB uses order book matching instead of binary yes/no pools
Supports limit orders with price discovery
More complex settlement logic (match buyers/sellers)
No vault seeding required (liquidity provided by market makers)

Server Configuration

Location: packages/server/src/arena/config.ts Fallback Program IDs:

// Updated to mainnet fight oracle
export const DEFAULT_FIGHT_ORACLE_PROGRAM_ID = 
  "Fg6PaFpoGXkYsidMpWxTWqkY8B4sT2u7hN8sV5kP6h1";

Keeper Common

Location: packages/gold-betting-demo/keeper/src/common.ts Fallback Program IDs:

// Updated to mainnet program IDs
export const FIGHT_ORACLE_PROGRAM_ID = 
  process.env.SOLANA_FIGHT_ORACLE_PROGRAM_ID || 
  "Fg6PaFpoGXkYsidMpWxTWqkY8B4sT2u7hN8sV5kP6h1";

export const GOLD_CLOB_MARKET_PROGRAM_ID = 
  process.env.SOLANA_ARENA_MARKET_PROGRAM_ID || 
  "GCLoBfbkz8Z4xz3yzs9gpump"; // Example mainnet address

Frontend Configuration

Location: packages/gold-betting-demo/app/.env.mainnet Updated Variables:

VITE_SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
VITE_SOLANA_WS_URL=wss://api.mainnet-beta.solana.com
VITE_FIGHT_ORACLE_PROGRAM_ID=Fg6PaFpoGXkYsidMpWxTWqkY8B4sT2u7hN8sV5kP6h1
VITE_GOLD_CLOB_MARKET_PROGRAM_ID=<mainnet-clob-program-id>
VITE_GOLD_MINT=DK9nBUMfdu4XprPRWeh8f6KnQiGWD8Z4xz3yzs9gpump

Migration Guide

For Developers

1. Update Environment Variables:

# packages/server/.env
SOLANA_ARENA_MARKET_PROGRAM_ID=<mainnet-clob-program-id>
SOLANA_GOLD_MINT=DK9nBUMfdu4XprPRWeh8f6KnQiGWD8Z4xz3yzs9gpump
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
SOLANA_WS_URL=wss://api.mainnet-beta.solana.com

2. Update Keeper Bot: The keeper bot now uses CLOB instructions:

// Old (binary market)
await program.methods.seedMarket(amount).rpc();

// New (CLOB market)
await program.methods.initializeConfig(feeConfig).rpc();
await program.methods.initializeMatch(matchId).rpc();
await program.methods.initializeOrderBook(matchId).rpc();

3. Update Frontend: Replace binary market IDL imports:

// Old
import binaryMarketIdl from "./idl/gold_binary_market.json";

// New
import clobMarketIdl from "./idl/gold_clob_market.json";

4. Remove Binary Market Code:

Delete gold_binary_market program references
Remove vault seeding logic
Update PDA derivations for CLOB accounts

For Operators

1. Deploy CLOB Program:

cd packages/gold-betting-demo/anchor
anchor build
anchor deploy --provider.cluster mainnet

2. Initialize Configuration:

# Run keeper bot to initialize config
cd packages/gold-betting-demo/keeper
bun run src/bot.ts

3. Update Environment: Set mainnet program IDs in production environment variables. 4. Verify Deployment:

# Check program deployment
solana program show <program-id> --url mainnet-beta

# Verify config account
solana account <config-pda> --url mainnet-beta

CLOB Market Architecture

Account Structure

Config Account (PDA)
├── authority: Pubkey
├── fee_bps: u16
└── paused: bool

Match Account (PDA)
├── match_id: String
├── fighter_a: Pubkey
├── fighter_b: Pubkey
├── start_time: i64
├── end_time: i64
├── winner: Option<u8>
└── resolved: bool

OrderBook Account (PDA)
├── match_id: String
├── buy_orders: Vec<Order>
├── sell_orders: Vec<Order>
└── total_volume: u64

Order
├── user: Pubkey
├── amount: u64
├── price: u64
├── filled: u64
└── timestamp: i64

Instruction Flow

1. Initialize Config (one-time setup):

pub fn initialize_config(
  ctx: Context<InitializeConfig>,
  fee_bps: u16,
) -> Result<()>

2. Initialize Match (per duel):

pub fn initialize_match(
  ctx: Context<InitializeMatch>,
  match_id: String,
  fighter_a: Pubkey,
  fighter_b: Pubkey,
  start_time: i64,
  end_time: i64,
) -> Result<()>

3. Initialize Order Book (per match):

pub fn initialize_order_book(
  ctx: Context<InitializeOrderBook>,
  match_id: String,
) -> Result<()>

4. Place Orders (users):

pub fn place_buy_order(
  ctx: Context<PlaceBuyOrder>,
  match_id: String,
  amount: u64,
  price: u64,
) -> Result<()>

pub fn place_sell_order(
  ctx: Context<PlaceSellOrder>,
  match_id: String,
  amount: u64,
  price: u64,
) -> Result<()>

5. Resolve Match (keeper):

pub fn resolve_match(
  ctx: Context<ResolveMatch>,
  match_id: String,
  winner: u8, // 0 = fighter_a, 1 = fighter_b
) -> Result<()>

Testing

Local Testing:

# Start local validator
solana-test-validator

# Deploy programs
cd packages/gold-betting-demo/anchor
anchor build
anchor deploy --provider.cluster localnet

# Run tests
anchor test --skip-local-validator

Integration Tests:

cd packages/gold-betting-demo/anchor
bun test

E2E Tests:

cd packages/gold-betting-demo/app
bun run test:e2e:local   # Local validator
bun run test:e2e:public  # Devnet/mainnet

Troubleshooting

Program deployment fails:

Ensure you have enough SOL for deployment (~5 SOL)
Check program size: ls -lh target/deploy/*.so
Verify keypair: solana address --keypair <keypair-path>

Order matching fails:

Check order book account exists
Verify match is not resolved
Ensure sufficient token balance
Check price/amount validity

Keeper bot errors:

Verify authority keypair is set: SOLANA_ARENA_AUTHORITY_SECRET
Check RPC endpoint is responsive
Ensure program accounts are initialized

References

Commits: dba3e03, 35c14f9
Author: lalalune (Shaw)
Date: Feb 22, 2026
Files Changed:
- packages/gold-betting-demo/anchor/programs/fight_oracle/src/lib.rs
- packages/gold-betting-demo/anchor/programs/gold_clob_market/src/lib.rs
- packages/gold-betting-demo/keeper/src/bot.ts
- packages/gold-betting-demo/keeper/src/common.ts
- packages/gold-betting-demo/app/src/idl/fight_oracle.json
- packages/gold-betting-demo/app/src/idl/gold_clob_market.json
- packages/server/src/arena/config.ts
- packages/gold-betting-demo/app/.env.mainnet

Configuration

Operations

Clob market migration

CLOB Market Program Migration

Overview

Changes

Program Addresses (Mainnet)

IDL Updates

Bot Rewrite

Server Configuration

Keeper Common

Frontend Configuration

Migration Guide

For Developers

For Operators

CLOB Market Architecture

Account Structure

Instruction Flow

Testing

Troubleshooting

References

​CLOB Market Program Migration

​Overview

​Changes

​Program Addresses (Mainnet)

​IDL Updates

​Bot Rewrite

​Server Configuration

​Keeper Common

​Frontend Configuration

​Migration Guide

​For Developers

​For Operators

​CLOB Market Architecture

​Account Structure

​Instruction Flow

​Testing

​Troubleshooting

​References

CLOB Market Program Migration

Overview

Changes

Program Addresses (Mainnet)

IDL Updates

Bot Rewrite

Server Configuration

Keeper Common

Frontend Configuration

Migration Guide

For Developers

For Operators

CLOB Market Architecture

Account Structure

Instruction Flow

Testing

Troubleshooting

References