Web3 Integration

export type SolanaNetwork = 'devnet' | 'mainnet-beta';

const RPC_ENDPOINTS: Record<SolanaNetwork, string> = {
  'devnet': 'https://api.devnet.solana.com',
  'mainnet-beta': 'https://api.mainnet-beta.solana.com',
};

interface Web3State {
  walletConnected: boolean;
  walletAddress: string | null;
  solBalance: number;
  network: SolanaNetwork;
  rpcEndpoint: string;
}

// From web3Store.ts:122-126
setWalletConnected: (connected, address) => set({
  walletConnected: connected,
  walletAddress: address ?? null,
  solBalance: connected ? undefined as any : 0, // reset on disconnect
}),

interface TokenInfo {
  mint: string;           // Token mint address
  name: string;           // Token name
  symbol: string;         // Ticker symbol (e.g., "USDC")
  balance: number;        // User's balance
  decimals: number;       // Decimal places
  imageUri?: string;      // Token logo
  
  // Pump.fun specific
  isPumpToken?: boolean;        // Launched on Pump.fun
  bondingCurveComplete?: boolean; // Graduated to Raydium
  priceInSol?: number;          // Current price
}

// Token launch parameters
{
  name: string;        // Token name ("My Game Coin")
  symbol: string;      // Ticker ("GAME")
  description: string; // Token description
  imageUri: string;    // Token logo (IPFS or HTTP)
  twitter?: string;    // Social links
  telegram?: string;
  website?: string;
}

// Buy tokens
{
  tokenMint: string;   // Target token address
  solAmount: number;   // SOL to spend
  slippage: number;    // Slippage tolerance % (e.g., 5 = 5%)
}

// Sell tokens  
{
  tokenMint: string;   // Target token address
  tokenAmount: number; // Tokens to sell
  slippage: number;    // Slippage tolerance %
}

// Query token price
interface PriceData {
  priceInSol: number;     // Current price in SOL
  marketCap: number;      // Total market cap in SOL
  bondingCurveProgress: number; // % to Raydium graduation
}

interface NFTInfo {
  mint: string;          // NFT mint address
  name: string;          // NFT name
  imageUri: string;      // Image URL (IPFS recommended)
  collection?: string;   // Collection address
  attributes?: {         // Metadata attributes
    trait_type: string;
    value: string;
  }[];
}

{
  "name": "Legendary Sword #123",
  "symbol": "SWORD",
  "description": "A powerful blade forged in the fires of Mount Doom",
  "image": "https://ipfs.io/ipfs/Qm...",
  "attributes": [
    { "trait_type": "Rarity", "value": "Legendary" },
    { "trait_type": "Damage", "value": "150" },
    { "trait_type": "Element", "value": "Fire" },
    { "trait_type": "Level", "value": "50" }
  ],
  "properties": {
    "files": [
      { "uri": "https://ipfs.io/ipfs/Qm...", "type": "image/png" }
    ],
    "category": "image"
  }
}

interface GameEconomyConfig {
  rewardTokenMint: string | null;  // Token used for rewards
  rewardPerLevel: number;          // Tokens earned per level
  tipJarEnabled: boolean;          // Allow players to tip developer
  itemPrices: {                    // In-game shop prices
    itemId: string;
    priceToken: string;  // Token mint address
    amount: number;      // Price in tokens
  }[];
}

// Configure economy
updateEconomy({
  rewardTokenMint: '9vMJfxuKxXBoEa7rM12mYLMwTacLMLDJqHozw96WQL8i',
  rewardPerLevel: 10,
  tipJarEnabled: true
});

// In-game: Award tokens when player completes level
if (levelComplete) {
  const reward = economy.rewardPerLevel;
  // Transfer tokens to player wallet
  airdropTokens(playerWallet, economy.rewardTokenMint, reward);
}

// Check if player holds minimum tokens
const hasAccess = await checkTokenBalance(
  walletAddress,
  requiredTokenMint,
  minimumBalance  // e.g., 100 tokens
);

if (hasAccess) {
  // Grant access to VIP area
  unlockPremiumContent();
} else {
  // Show "Insufficient tokens" message
  showTokenGateModal();
}

interface Web3Transaction {
  id: string;
  type: 'token_launch' | 'buy' | 'sell' | 'mint_nft' | 'transfer' | 'airdrop';
  signature: string;    // Solana transaction signature
  status: 'pending' | 'confirmed' | 'failed';
  description: string;  // Human-readable description
  timestamp: number;    // Unix timestamp
}

// When initiating a transaction
const txId = uuidv4();
addTransaction({
  id: txId,
  type: 'buy',
  signature: '', // populated after wallet signs
  status: 'pending',
  description: 'Buy 1000 GAME tokens',
  timestamp: Date.now()
});

// After wallet confirmation
updateTransaction(txId, {
  signature: '3Xz7Kj2...actual_signature',
  status: 'pending'
});

// After blockchain confirmation
updateTransaction(txId, {
  status: 'confirmed'
});