​

Solana Market WSOL Migration

​

Overview

​

What Changed

​

Environment Variables

GOLD_MINT=DK9nBUMfdu4XprPRWeh8f6KnQiGWD8Z4xz3yzs9gpump

MARKET_MINT=So11111111111111111111111111111111111111112  # WSOL

​

Default Behavior

• Markets now use native token by default (WSOL on Solana)
• GOLD_MINT variable removed - use MARKET_MINT instead
• Backward compatible - can still use custom tokens by setting MARKET_MINT

​

Configuration

​

Use WSOL (Default)

# packages/server/.env
# MARKET_MINT not set = uses WSOL

​

Use Custom Token

# packages/server/.env
MARKET_MINT=YourTokenMintAddress...

​

Token Program IDs

# packages/server/.env
SOLANA_GOLD_TOKEN_PROGRAM_ID=TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb
SOLANA_ASSOCIATED_TOKEN_PROGRAM_ID=ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL

​

Perps Oracle Changes

​

Configuration

# packages/server/.env

# Disable perps oracle (default)
ENABLE_PERPS_ORACLE=false

# Enable when program is deployed
# ENABLE_PERPS_ORACLE=true

​

Impact

• Devnet: Perps oracle disabled (program not available)
• Mainnet: Can be enabled when program is deployed
• No errors: Gracefully skips oracle updates when disabled

​

Migration Guide

​

From GOLD to WSOL

1. Update environment variables:
   # packages/server/.env
   
   # Remove old variable
   # GOLD_MINT=DK9nBUMfdu4XprPRWeh8f6KnQiGWD8Z4xz3yzs9gpump
   
   # Add new variable (or leave unset for WSOL default)
   MARKET_MINT=So11111111111111111111111111111111111111112
   
2. Update market maker configuration:
   # Ensure market maker wallet has WSOL
   # No GOLD token needed
   
3. Restart server:
   bunx pm2 restart hyperscape-duel
   

​

Existing Markets

# packages/server/.env
MARKET_MINT=DK9nBUMfdu4XprPRWeh8f6KnQiGWD8Z4xz3yzs9gpump

​

Benefits of WSOL

​

1. Simplified Deployment

• No custom token required - uses native SOL
• No token minting - WSOL is always available
• No liquidity bootstrapping - SOL is liquid on all DEXs

​

2. Better UX

• Familiar token - users already have SOL
• No wrapping needed - automatic SOL ↔ WSOL conversion
• Lower friction - no need to acquire custom token

​

3. Cross-Chain Compatibility

• Native token per chain - WSOL on Solana, WETH on Ethereum, etc.
• Consistent pattern - always use wrapped native token
• Easy bridging - native tokens have best bridge support

​

Technical Details

​

WSOL Address

So11111111111111111111111111111111111111112

​

Token Program

TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb

​

Associated Token Program

ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL

​

Code Changes

​

Keeper Bot

// Before
const goldMint = process.env.GOLD_MINT;

// After
const marketMint = process.env.MARKET_MINT || WSOL_MINT;

​

Market Creation

// Uses MARKET_MINT from environment
const marketMint = new PublicKey(
  process.env.MARKET_MINT || 'So11111111111111111111111111111111111111112'
);

​

Troubleshooting

​

Market creation fails

1. MARKET_MINT is valid Solana address
2. Token program ID is correct
3. Authority wallet has SOL for transaction fees

# Verify mint address
solana account $MARKET_MINT

# Check authority balance
solana balance ~/.config/solana/id.json

​

Perps oracle errors

1. ENABLE_PERPS_ORACLE is set correctly
2. Perps program is deployed on your network

# Disable perps oracle
ENABLE_PERPS_ORACLE=false

​

Token not found

1. Using correct network (devnet/mainnet)
2. WSOL mint address is correct
3. Token program ID matches network

# Verify on devnet
solana config set --url https://api.devnet.solana.com
solana account So11111111111111111111111111111111111111112

# Verify on mainnet
solana config set --url https://api.mainnet-beta.solana.com
solana account So11111111111111111111111111111111111111112

​

Related Documentation

• packages/server/.env.example - Configuration reference
• docs/duel-stack.md - Duel system architecture
• packages/gold-betting-demo/README.md - Betting demo

​

References

• Solana Token Program
• WSOL Documentation
• Associated Token Account Program