dubs-server 1.0.0

package/scripts/debug-cohort-counts.js

@@ -0,0 +1,248 @@
+/**
+ * Debug Cohort Count Discrepancy
+ * 
+ * This script investigates why cohort counts don't match total user counts
+ */
+
+require('dotenv').config();
+const { Pool } = require('pg');
+
+async function debugCohorts() {
+  const DATABASE_URL = process.env.DATABASE_URL;
+  
+  if (!DATABASE_URL) {
+    console.error('❌ DATABASE_URL not set');
+    process.exit(1);
+  }
+  
+  const isProduction = DATABASE_URL.includes('amazonaws') || DATABASE_URL.includes('heroku');
+  const pool = new Pool({
+    connectionString: DATABASE_URL,
+    ssl: isProduction ? { rejectUnauthorized: false } : false,
+    max: 2,
+  });
+
+  console.log('\n🔍 DEBUGGING COHORT COUNT DISCREPANCY\n');
+  console.log('=' .repeat(80));
+  
+  try {
+    // 1. Total unique users with registration_completed
+    console.log('\n1️⃣ TOTAL UNIQUE USERS');
+    console.log('-'.repeat(80));
+    
+    const totalUsers = await pool.query(`
+      SELECT 
+        COUNT(DISTINCT user_id) as unique_users,
+        COUNT(*) as total_events
+      FROM audit_logs
+      WHERE log_type = 'registration_completed'
+        AND user_id IS NOT NULL
+    `);
+    
+    console.log(`Total Unique Users: ${totalUsers.rows[0].unique_users}`);
+    console.log(`Total registration_completed Events: ${totalUsers.rows[0].total_events}`);
+    console.log(`Average Events per User: ${(totalUsers.rows[0].total_events / totalUsers.rows[0].unique_users).toFixed(2)}`);
+    
+    // 2. Users with multiple registration events
+    console.log('\n\n2️⃣ USERS WITH MULTIPLE REGISTRATIONS');
+    console.log('-'.repeat(80));
+    
+    const multipleRegs = await pool.query(`
+      SELECT 
+        user_id,
+        COUNT(*) as registration_count,
+        MIN(created_at) as first_registration,
+        MAX(created_at) as last_registration
+      FROM audit_logs
+      WHERE log_type = 'registration_completed'
+        AND user_id IS NOT NULL
+      GROUP BY user_id
+      HAVING COUNT(*) > 1
+      ORDER BY registration_count DESC
+    `);
+    
+    if (multipleRegs.rows.length > 0) {
+      console.log(`\n⚠️  Found ${multipleRegs.rows.length} users with multiple registration events:\n`);
+      multipleRegs.rows.forEach(row => {
+        console.log(`User: ${row.user_id.substring(0, 12)}...`);
+        console.log(`  Events: ${row.registration_count}`);
+        console.log(`  First: ${row.first_registration.toISOString()}`);
+        console.log(`  Last: ${row.last_registration.toISOString()}`);
+        console.log('');
+      });
+    } else {
+      console.log('✅ All users have exactly 1 registration event');
+    }
+    
+    // 3. Distribution by month
+    console.log('\n3️⃣ MONTHLY DISTRIBUTION (Using MIN per user)');
+    console.log('-'.repeat(80));
+    
+    const monthlyDist = await pool.query(`
+      WITH first_registration AS (
+        SELECT 
+          user_id,
+          MIN(DATE(created_at)) as signup_date
+        FROM audit_logs
+        WHERE log_type = 'registration_completed'
+          AND user_id IS NOT NULL
+        GROUP BY user_id
+      )
+      SELECT 
+        DATE_TRUNC('month', signup_date) as cohort_month,
+        COUNT(*) as unique_users,
+        MIN(signup_date) as first_signup,
+        MAX(signup_date) as last_signup
+      FROM first_registration
+      GROUP BY DATE_TRUNC('month', signup_date)
+      ORDER BY cohort_month DESC
+    `);
+    
+    console.log('\nMonth          | Users | First Signup  | Last Signup');
+    console.log('-'.repeat(60));
+    monthlyDist.rows.forEach(row => {
+      const month = new Date(row.cohort_month).toLocaleDateString('en-US', { month: 'long', year: 'numeric' });
+      const first = new Date(row.first_signup).toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+      const last = new Date(row.last_signup).toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+      console.log(`${month.padEnd(15)} | ${row.unique_users.toString().padStart(5)} | ${first.padEnd(13)} | ${last}`);
+    });
+    
+    // 4. What the API returns
+    console.log('\n\n4️⃣ API QUERY RESULT (Monthly Cohorts)');
+    console.log('-'.repeat(80));
+    
+    const apiResult = await pool.query(`
+      WITH signups AS (
+        SELECT 
+          user_id,
+          MIN(DATE(created_at)) as signup_date,
+          MIN(metadata->>'referralCode') as referral_code
+        FROM audit_logs
+        WHERE log_type = 'registration_completed'
+          AND user_id IS NOT NULL
+        GROUP BY user_id
+      ),
+      cohorts AS (
+        SELECT 
+          DATE_TRUNC('month', signup_date) as cohort_period,
+          user_id,
+          signup_date,
+          CASE 
+            WHEN referral_code IS NOT NULL AND referral_code != '' THEN 'referral'
+            ELSE 'organic'
+          END as user_source
+        FROM signups
+      ),
+      retention_calc AS (
+        SELECT 
+          cohort_period,
+          COUNT(DISTINCT user_id) as total_users
+        FROM cohorts
+        WHERE 'all' = 'all' OR user_source = 'all'
+        GROUP BY cohort_period
+      )
+      SELECT 
+        cohort_period,
+        total_users
+      FROM retention_calc
+      WHERE total_users > 0
+      ORDER BY cohort_period DESC
+      LIMIT 12
+    `);
+    
+    console.log('\nCohort Month   | Users (What API Returns)');
+    console.log('-'.repeat(50));
+    apiResult.rows.forEach(row => {
+      const month = new Date(row.cohort_period).toLocaleDateString('en-US', { month: 'long', year: 'numeric' });
+      console.log(`${month.padEnd(15)} | ${row.total_users}`);
+    });
+    
+    // 5. Date formatting test
+    console.log('\n\n5️⃣ DATE FORMATTING TEST');
+    console.log('-'.repeat(80));
+    
+    const dateTest = await pool.query(`
+      WITH test_dates AS (
+        SELECT DATE_TRUNC('month', DATE '2025-12-15') as cohort_period
+      )
+      SELECT 
+        cohort_period,
+        cohort_period + INTERVAL '1 month' - INTERVAL '1 day' as month_end,
+        TO_CHAR(cohort_period, 'Month YYYY') as formatted_month
+      FROM test_dates
+    `);
+    
+    console.log(`\nFor December 15, 2025 signup:`);
+    console.log(`  DATE_TRUNC result: ${dateTest.rows[0].cohort_period.toISOString()}`);
+    console.log(`  Month end: ${dateTest.rows[0].month_end.toISOString()}`);
+    console.log(`  Formatted: ${dateTest.rows[0].formatted_month}`);
+    
+    // 6. Check for the "Nov 30, 2025" issue
+    console.log('\n\n6️⃣ INVESTIGATING "Nov 30, 2025" LABEL');
+    console.log('-'.repeat(80));
+    
+    const novCheck = await pool.query(`
+      SELECT 
+        DATE(created_at) as signup_date,
+        COUNT(*) as count
+      FROM audit_logs
+      WHERE log_type = 'registration_completed'
+        AND user_id IS NOT NULL
+        AND DATE(created_at) >= '2025-11-01'
+        AND DATE(created_at) < '2025-12-01'
+      GROUP BY DATE(created_at)
+      ORDER BY signup_date
+    `);
+    
+    if (novCheck.rows.length > 0) {
+      console.log('\n⚠️  Found signups in November 2025:');
+      novCheck.rows.forEach(row => {
+        console.log(`  ${row.signup_date.toISOString().split('T')[0]}: ${row.count} signups`);
+      });
+    } else {
+      console.log('✅ No signups found in November 2025');
+      console.log('   The "Nov 30, 2025" label is likely a date formatting bug!');
+    }
+    
+    // 7. Summary
+    console.log('\n\n📋 SUMMARY');
+    console.log('=' .repeat(80));
+    
+    const summary = await pool.query(`
+      WITH first_registration AS (
+        SELECT 
+          user_id,
+          MIN(DATE(created_at)) as signup_date
+        FROM audit_logs
+        WHERE log_type = 'registration_completed'
+          AND user_id IS NOT NULL
+        GROUP BY user_id
+      )
+      SELECT 
+        COUNT(*) as total_unique_users,
+        MIN(signup_date) as earliest_signup,
+        MAX(signup_date) as latest_signup
+      FROM first_registration
+    `);
+    
+    console.log(`\n✅ Total Unique Users: ${summary.rows[0].total_unique_users}`);
+    console.log(`📅 Date Range: ${summary.rows[0].earliest_signup.toISOString().split('T')[0]} to ${summary.rows[0].latest_signup.toISOString().split('T')[0]}`);
+    console.log(`\n💡 EXPLANATION:`);
+    console.log(`   - ${summary.rows[0].total_unique_users} unique users are spread across multiple monthly cohorts`);
+    console.log(`   - Each cohort only shows users who signed up in that specific month`);
+    console.log(`   - "December 2025" cohort = users who signed up between Dec 1-31, 2025`);
+    console.log(`   - If you see 7 in December, the other ${summary.rows[0].total_unique_users - 7} are in other months`);
+    console.log(`\n🐛 BUG IDENTIFIED:`);
+    console.log(`   - "Nov 30, 2025" label is incorrect for December cohort`);
+    console.log(`   - Should display "December 2025" with date range`);
+    
+  } catch (error) {
+    console.error('\n❌ Error:', error.message);
+    console.error(error);
+  } finally {
+    await pool.end();
+  }
+}
+
+debugCohorts().catch(console.error);
+

package/scripts/debug-winner-calc.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+
+/**
+ * 🔍 Debug Winner Calculation
+ * Shows VRF result and winner calculation step-by-step
+ */
+
+const { Connection, PublicKey } = require('@solana/web3.js');
+const axios = require('axios');
+
+const RPC_URL = 'https://api.devnet.solana.com';
+const API_BASE = 'http://localhost:3001';
+const PROGRAM_ID = new PublicKey('BHidyz25KWkNPdTHgeANzMg25MM2KEiNnG4yE5F46XUz');
+
+async function debugWinner() {
+  console.log('🔍 Debug Winner Calculation\n');
+  
+  const connection = new Connection(RPC_URL, 'confirmed');
+  
+  // Get entries
+  const { data: entriesData } = await axios.get(`${API_BASE}/jackpot/round/50/entries`);
+  const entries = entriesData.entries;
+  
+  console.log('📊 Entries:');
+  entries.forEach((entry, i) => {
+    console.log(`  [${i}] ${entry.player.slice(0, 8)}... weight: ${entry.weight}, cumulative: ${entry.cumulativeTo}`);
+  });
+  console.log();
+  
+  // Get round account
+  const [roundPda] = PublicKey.findProgramAddressSync(
+    [Buffer.from('round'), Buffer.from([1,0,0,0,0,0,0,0])],
+    PROGRAM_ID
+  );
+  
+  console.log('Round PDA:', roundPda.toString());
+  
+  const roundAccount = await connection.getAccountInfo(roundPda);
+  if (!roundAccount) {
+    console.log('❌ Round account not found!');
+    return;
+  }
+  
+  // Parse VRF result (at offset 51)
+  const hasVrfResult = roundAccount.data[51];
+  console.log('\nVRF Result exists:', hasVrfResult === 1);
+  
+  if (hasVrfResult !== 1) {
+    console.log('❌ No VRF result available!');
+    return;
+  }
+  
+  // Read u128 VRF result (16 bytes starting at offset 52)
+  const vrfBytes = roundAccount.data.slice(52, 68);
+  console.log('VRF bytes (hex):', vrfBytes.toString('hex'));
+  
+  const vrfResult = BigInt('0x' + Buffer.from(vrfBytes).reverse().toString('hex'));
+  console.log('VRF result (as bigint):', vrfResult.toString());
+  console.log();
+  
+  // Calculate winner
+  const totalWeight = BigInt(entries[entries.length - 1].cumulativeTo);
+  console.log('Total weight:', totalWeight.toString());
+  
+  const winnerPoint = vrfResult % totalWeight;
+  console.log('Winner point:', winnerPoint.toString());
+  console.log();
+  
+  // Find winner
+  console.log('Finding winner:');
+  for (const entry of entries) {
+    const cumulative = BigInt(entry.cumulativeTo);
+    const matches = cumulative > winnerPoint;
+    console.log(`  ${entry.player.slice(0, 8)}... cumulative: ${cumulative}, matches: ${matches ? '✅ WINNER' : '❌'}`);
+    if (matches) {
+      console.log();
+      console.log('🏆 Winner:', entry.player);
+      break;
+    }
+  }
+}
+
+debugWinner().catch(console.error);
+

package/scripts/deploy-payment-system.sh

@@ -0,0 +1,118 @@
+#!/bin/bash
+
+# Dubs Payment System Deployment Script
+# Deploys server with payment functionality to Heroku
+
+set -e  # Exit on error
+
+echo "🚀 Starting Dubs Payment System Deployment..."
+echo ""
+
+# Colors for output
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+# Check if we're in the right directory
+if [ ! -f "server.js" ]; then
+    echo -e "${RED}❌ Error: Must run from dubs-server directory${NC}"
+    exit 1
+fi
+
+# Check if heroku CLI is installed
+if ! command -v heroku &> /dev/null; then
+    echo -e "${RED}❌ Error: Heroku CLI not installed${NC}"
+    echo "Install from: https://devcenter.heroku.com/articles/heroku-cli"
+    exit 1
+fi
+
+# Get Heroku app name
+echo -e "${YELLOW}📝 Enter your Heroku app name:${NC}"
+read -p "App name: " APP_NAME
+
+if [ -z "$APP_NAME" ]; then
+    echo -e "${RED}❌ Error: App name is required${NC}"
+    exit 1
+fi
+
+echo ""
+echo -e "${GREEN}✅ Deploying to: $APP_NAME${NC}"
+echo ""
+
+# Check git status
+echo "📋 Checking git status..."
+if [[ -n $(git status -s) ]]; then
+    echo -e "${YELLOW}⚠️  You have uncommitted changes${NC}"
+    echo ""
+    git status -s
+    echo ""
+    read -p "Commit these changes? (y/n): " -n 1 -r
+    echo
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        git add .
+        read -p "Commit message: " COMMIT_MSG
+        git commit -m "$COMMIT_MSG"
+        echo -e "${GREEN}✅ Changes committed${NC}"
+    else
+        echo -e "${RED}❌ Deployment cancelled${NC}"
+        exit 1
+    fi
+fi
+
+# Show what will be deployed
+echo ""
+echo "📦 Deployment summary:"
+echo "  - Payment system with SOL transfers"
+echo "  - Payment notifications (payment_received, payment_sent)"
+echo "  - Database constraint update (auto-runs on startup)"
+echo "  - Real-time WebSocket payment alerts"
+echo ""
+
+read -p "Continue with deployment? (y/n): " -n 1 -r
+echo
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    echo -e "${RED}❌ Deployment cancelled${NC}"
+    exit 1
+fi
+
+# Deploy to Heroku
+echo ""
+echo "🚀 Deploying to Heroku..."
+git push heroku main
+
+# Wait a moment for deployment to settle
+echo ""
+echo "⏳ Waiting for deployment to complete..."
+sleep 5
+
+# Check if migration ran
+echo ""
+echo "🔍 Checking database migration..."
+heroku logs --tail --app "$APP_NAME" | grep -i "notification types updated" | head -1 || echo -e "${YELLOW}⚠️  Migration log not found yet (might still be running)${NC}"
+
+# Show recent logs
+echo ""
+echo "📊 Recent logs:"
+heroku logs --tail --num 50 --app "$APP_NAME"
+
+echo ""
+echo -e "${GREEN}✅ Deployment complete!${NC}"
+echo ""
+echo "🧪 Next steps:"
+echo "  1. Test payment: @username \$0.01"
+echo "  2. Check logs: heroku logs --tail --app $APP_NAME"
+echo "  3. Monitor database: heroku pg:psql --app $APP_NAME"
+echo ""
+echo "📚 See PAYMENT_DEPLOYMENT.md for full testing guide"
+echo ""
+
+
+
+
+
+
+
+
+
+

package/scripts/deploy-to-heroku.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+
+# 🚀 Quick Heroku Deployment Script
+
+set -e
+
+echo "🚀 Deploying Dubs Server to Heroku"
+echo "==================================="
+echo ""
+
+# Check if we're in the right directory
+if [ ! -f "server.js" ]; then
+  echo "❌ Error: Must run from dubs-server directory"
+  exit 1
+fi
+
+# Check for uncommitted changes
+if ! git diff-index --quiet HEAD --; then
+  echo "⚠️  You have uncommitted changes"
+  echo ""
+  read -p "Commit them now? (y/n) " -n 1 -r
+  echo ""
+  if [[ $REPLY =~ ^[Yy]$ ]]; then
+    git add .
+    read -p "Commit message: " commit_msg
+    git commit -m "$commit_msg"
+  fi
+fi
+
+# Deploy to Heroku
+echo "📤 Pushing to Heroku..."
+git push heroku-dev main
+
+echo ""
+echo "⚙️  Setting environment variables..."
+heroku config:set SOLANA_NETWORK=https://api.devnet.solana.com -a dubs-server-dev
+heroku config:set JACKPOT_PROGRAM_ID=bqoSjTSPLweMuqNG6jy39jmzGyZvZdWjsr4csGfD8F6 -a dubs-server-dev
+
+echo ""
+echo "🔄 Scaling processes..."
+heroku ps:scale web=1 jackpot-keeper=1 oracle=1 -a dubs-server-dev
+
+echo ""
+echo "⏳ Waiting for services to start..."
+sleep 10
+
+echo ""
+echo "🏥 Health check..."
+curl -s https://dubs-server-dev.herokuapp.com/jackpot/health | python3 -m json.tool
+
+echo ""
+echo "📊 Process status:"
+heroku ps -a dubs-server-dev
+
+echo ""
+echo "✅ Deployment complete!"
+echo ""
+echo "📋 Next steps:"
+echo "   - View logs: heroku logs --tail -a dubs-server-dev"
+echo "   - Check round: curl https://dubs-server-dev.herokuapp.com/jackpot/round/current | jq ."
+echo "   - Monitor keeper: heroku logs --tail --ps jackpot-keeper -a dubs-server-dev"
+echo ""
+

package/scripts/diagnose-locked-round.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+/**
+ * 🔍 Diagnose Locked Round
+ * 
+ * Checks why a jackpot round is stuck in "Locked" state
+ */
+
+const { Connection, PublicKey } = require('@solana/web3.js');
+const axios = require('axios');
+
+const RPC_URL = 'https://api.devnet.solana.com';
+const API_BASE = 'http://localhost:3001';
+const PROGRAM_ID = new PublicKey('BHidyz25KWkNPdTHgeANzMg25MM2KEiNnG4yE5F46XUz');
+
+async function diagnoseRound() {
+  console.log('🔍 Diagnosing Jackpot Round State\n');
+  
+  const connection = new Connection(RPC_URL, 'confirmed');
+  
+  try {
+    // 1. Get current round from API
+    console.log('📡 Fetching current round from API...');
+    const { data } = await axios.get(`${API_BASE}/jackpot/round/current`);
+    
+    if (!data.round) {
+      console.log('❌ No active round found!');
+      console.log('💡 Solution: Run the keeper bot to open a new round');
+      return;
+    }
+    
+    const round = data.round;
+    console.log('✅ Round found:', round.roundId);
+    console.log('   Status:', round.status);
+    console.log('   Pot:', Number(round.totalPotLamports) / 1e9, 'SOL');
+    console.log('   Entry Count:', round.entryCount || 0);
+    console.log();
+    
+    // 2. Check if round is locked
+    if (round.status !== 'Locked') {
+      console.log(`✅ Round is not locked (status: ${round.status})`);
+      if (round.status === 'Open') {
+        const slotsRemaining = round.timeRemainingSlots;
+        const secsRemaining = Math.floor(slotsRemaining * 0.4);
+        console.log(`⏳ Round ends in ~${secsRemaining} seconds (${slotsRemaining} slots)`);
+      }
+      return;
+    }
+    
+    console.log('🔒 Round IS LOCKED - investigating...\n');
+    
+    // 3. Fetch raw account data to check VRF result
+    console.log('📊 Checking on-chain state...');
+    const [roundPda] = PublicKey.findProgramAddressSync(
+      [Buffer.from('round'), Buffer.from([1, 0, 0, 0, 0, 0, 0, 0])],
+      PROGRAM_ID
+    );
+    
+    const accountInfo = await connection.getAccountInfo(roundPda);
+    if (!accountInfo) {
+      console.log('❌ Round account not found on-chain!');
+      return;
+    }
+    
+    const accountData = accountInfo.data;
+    
+    // Parse critical fields
+    const status = accountData[16]; // 0=Open, 1=Locked, 2=Resolved
+    const entryCount = accountData.readUInt32LE(68);
+    const serverSeedHash = accountData.slice(108, 140); // 32 bytes
+    
+    // Check VRF result (Option<u128>)
+    const hasVrfResult = accountData[49]; // Option discriminant (0=None, 1=Some)
+    
+    console.log('   On-chain status:', ['Open', 'Locked', 'Resolved'][status]);
+    console.log('   Entry count:', entryCount);
+    console.log('   Server seed hash:', serverSeedHash.toString('hex').slice(0, 16) + '...');
+    console.log('   Has VRF result:', hasVrfResult === 1 ? 'YES ✅' : 'NO ❌');
+    console.log();
+    
+    // 4. Diagnose the issue
+    if (hasVrfResult === 0) {
+      console.log('🎯 DIAGNOSIS: Oracle randomness not consumed yet\n');
+      console.log('Why this happens:');
+      console.log('  • The keeper bot locked the round (commit phase)');
+      console.log('  • But oracle randomness was never revealed (reveal phase)');
+      console.log('  • Without VRF result, the round cannot be resolved\n');
+      
+      console.log('💡 SOLUTIONS:\n');
+      console.log('1. Make sure the keeper bot is running:');
+      console.log('   cd /Users/adamdahan/Developer/iheartsolana/solana-programs/dubs-server');
+      console.log('   node scripts/jackpot-keeper.js\n');
+      
+      console.log('2. Or manually reveal randomness:');
+      console.log('   curl -X POST http://localhost:3001/jackpot/oracle/reveal \\');
+      console.log(`     -H "Content-Type: application/json" \\`);
+      console.log(`     -d '{"roundId": "${round.roundId}", "oracleSeed": "0000000000000000000000000000000000000000000000000000000000000001"}'\n`);
+      
+      console.log('3. Check oracle wallet exists:');
+      console.log('   ls -la /Users/adamdahan/Developer/iheartsolana/solana-programs/dubs-server/wallets/jackpot_oracle.json\n');
+      
+    } else {
+      console.log('🎯 DIAGNOSIS: VRF result exists but round not resolved yet\n');
+      console.log('Why this happens:');
+      console.log('  • Oracle randomness was consumed successfully');
+      console.log('  • But resolve_round was never called');
+      console.log('  • The keeper bot may have crashed or stopped\n');
+      
+      console.log('💡 SOLUTIONS:\n');
+      console.log('1. Restart the keeper bot:');
+      console.log('   cd /Users/adamdahan/Developer/iheartsolana/solana-programs/dubs-server');
+      console.log('   node scripts/jackpot-keeper.js\n');
+      
+      console.log('2. Or manually resolve:');
+      console.log('   # First, calculate winner off-chain, then:');
+      console.log('   # This requires knowing the winner address beforehand\n');
+    }
+    
+    // 5. Check keeper bot process
+    console.log('🤖 Checking keeper bot status...');
+    const { exec } = require('child_process');
+    exec('ps aux | grep jackpot-keeper', (error, stdout) => {
+      if (stdout.includes('node') && stdout.includes('jackpot-keeper')) {
+        console.log('✅ Keeper bot appears to be running');
+        console.log('💡 Check its logs for errors');
+      } else {
+        console.log('❌ Keeper bot is NOT running!');
+        console.log('💡 This is likely why the round is stuck');
+      }
+      console.log();
+    });
+    
+  } catch (error) {
+    console.error('❌ Error:', error.message);
+    console.log('\n💡 Make sure:');
+    console.log('  1. The server is running (node server.js)');
+    console.log('  2. You\'re connected to devnet');
+    console.log('  3. The program is deployed');
+  }
+}
+
+diagnoseRound().catch(console.error);
+