dubs-server 1.0.0

package/routes/whatsNewRoutes.js

@@ -0,0 +1,331 @@
+/**
+ * 📢 What's New API Routes
+ * 
+ * Public endpoints for viewing posts
+ * Admin-protected endpoints for creating/editing/deleting
+ * 
+ * Admin wallet: Hvv1ctqHLR5wonuuRguefS6EpGUe7tFRBX2YWHGr3mes
+ */
+
+const express = require('express');
+const router = express.Router();
+const multer = require('multer');
+const { authenticate, optionalAuth } = require('../middleware/authenticate');
+const whatsNewService = require('../services/whatsNewService');
+const S3Service = require('../services/s3Service');
+
+// Initialize S3 service for GIF uploads
+const s3Service = new S3Service();
+
+// Configure multer for memory storage (we'll upload to S3)
+const upload = multer({
+  storage: multer.memoryStorage(),
+  limits: {
+    fileSize: 10 * 1024 * 1024, // 10MB max
+  },
+  fileFilter: (req, file, cb) => {
+    const allowedTypes = ['image/gif', 'image/png', 'image/jpeg', 'image/webp'];
+    if (allowedTypes.includes(file.mimetype)) {
+      cb(null, true);
+    } else {
+      cb(new Error('Invalid file type. Only GIF, PNG, JPEG, and WebP are allowed.'));
+    }
+  },
+});
+
+/**
+ * Middleware: Require admin wallet
+ */
+function requireAdmin(req, res, next) {
+  if (!req.user || !whatsNewService.isAdmin(req.user.walletAddress)) {
+    return res.status(403).json({
+      success: false,
+      error: 'Admin access required',
+      code: 'ADMIN_REQUIRED',
+    });
+  }
+  next();
+}
+
+// ====================================
+// PUBLIC ENDPOINTS (optionally authenticated)
+// ====================================
+
+/**
+ * GET /whats-new/posts
+ * Get all published posts (with read status if authenticated)
+ */
+router.get('/posts', optionalAuth, async (req, res) => {
+  try {
+    const userId = req.user?.userId || null;
+    const posts = await whatsNewService.getPosts(userId);
+    
+    res.json({
+      success: true,
+      posts,
+      count: posts.length,
+    });
+  } catch (error) {
+    console.error('[WhatsNew] GET /posts error:', error);
+    res.status(500).json({
+      success: false,
+      error: error.message,
+    });
+  }
+});
+
+/**
+ * GET /whats-new/unread-count
+ * Get count of unread posts for authenticated user
+ */
+router.get('/unread-count', authenticate, async (req, res) => {
+  try {
+    const { userId } = req.user;
+    const count = await whatsNewService.getUnreadCount(userId);
+    
+    res.json({
+      success: true,
+      count,
+    });
+  } catch (error) {
+    console.error('[WhatsNew] GET /unread-count error:', error);
+    res.status(500).json({
+      success: false,
+      error: error.message,
+    });
+  }
+});
+
+// ====================================
+// USER ENDPOINTS (authenticated)
+// ====================================
+
+/**
+ * POST /whats-new/mark-read
+ * Mark specific posts as read
+ */
+router.post('/mark-read', authenticate, async (req, res) => {
+  try {
+    const { userId } = req.user;
+    const { postIds } = req.body;
+    
+    if (!Array.isArray(postIds)) {
+      return res.status(400).json({
+        success: false,
+        error: 'postIds must be an array',
+      });
+    }
+    
+    await whatsNewService.markAsRead(userId, postIds);
+    
+    res.json({
+      success: true,
+    });
+  } catch (error) {
+    console.error('[WhatsNew] POST /mark-read error:', error);
+    res.status(500).json({
+      success: false,
+      error: error.message,
+    });
+  }
+});
+
+/**
+ * POST /whats-new/mark-all-read
+ * Mark all posts as read for current user
+ */
+router.post('/mark-all-read', authenticate, async (req, res) => {
+  try {
+    const { userId } = req.user;
+    const count = await whatsNewService.markAllAsRead(userId);
+    
+    res.json({
+      success: true,
+      markedCount: count,
+    });
+  } catch (error) {
+    console.error('[WhatsNew] POST /mark-all-read error:', error);
+    res.status(500).json({
+      success: false,
+      error: error.message,
+    });
+  }
+});
+
+// ====================================
+// ADMIN ENDPOINTS
+// ====================================
+
+/**
+ * GET /whats-new/admin/posts
+ * Get all posts including unpublished (admin only)
+ */
+router.get('/admin/posts', authenticate, requireAdmin, async (req, res) => {
+  try {
+    const posts = await whatsNewService.getAllPostsAdmin();
+    
+    res.json({
+      success: true,
+      posts,
+      count: posts.length,
+    });
+  } catch (error) {
+    console.error('[WhatsNew] GET /admin/posts error:', error);
+    res.status(500).json({
+      success: false,
+      error: error.message,
+    });
+  }
+});
+
+/**
+ * GET /whats-new/admin/check
+ * Check if current user is admin
+ */
+router.get('/admin/check', authenticate, (req, res) => {
+  const isAdmin = whatsNewService.isAdmin(req.user.walletAddress);
+  
+  res.json({
+    success: true,
+    isAdmin,
+    walletAddress: req.user.walletAddress,
+  });
+});
+
+/**
+ * POST /whats-new/admin/posts
+ * Create a new post (admin only)
+ */
+router.post('/admin/posts', authenticate, requireAdmin, async (req, res) => {
+  try {
+    const { title, content, gifUrl, category, version, isPinned, isPublished } = req.body;
+    
+    if (!title || !content) {
+      return res.status(400).json({
+        success: false,
+        error: 'Title and content are required',
+      });
+    }
+    
+    const post = await whatsNewService.createPost({
+      title,
+      content,
+      gifUrl,
+      category,
+      version,
+      isPinned,
+      isPublished,
+      createdBy: req.user.walletAddress,
+    });
+    
+    res.json({
+      success: true,
+      post,
+    });
+  } catch (error) {
+    console.error('[WhatsNew] POST /admin/posts error:', error);
+    res.status(500).json({
+      success: false,
+      error: error.message,
+    });
+  }
+});
+
+/**
+ * PUT /whats-new/admin/posts/:id
+ * Update a post (admin only)
+ */
+router.put('/admin/posts/:id', authenticate, requireAdmin, async (req, res) => {
+  try {
+    const postId = parseInt(req.params.id, 10);
+    const { title, content, gifUrl, category, version, isPinned, isPublished } = req.body;
+    
+    const post = await whatsNewService.updatePost(postId, {
+      title,
+      content,
+      gifUrl,
+      category,
+      version,
+      isPinned,
+      isPublished,
+    });
+    
+    res.json({
+      success: true,
+      post,
+    });
+  } catch (error) {
+    console.error('[WhatsNew] PUT /admin/posts/:id error:', error);
+    res.status(500).json({
+      success: false,
+      error: error.message,
+    });
+  }
+});
+
+/**
+ * DELETE /whats-new/admin/posts/:id
+ * Delete a post (admin only)
+ */
+router.delete('/admin/posts/:id', authenticate, requireAdmin, async (req, res) => {
+  try {
+    const postId = parseInt(req.params.id, 10);
+    await whatsNewService.deletePost(postId);
+    
+    res.json({
+      success: true,
+    });
+  } catch (error) {
+    console.error('[WhatsNew] DELETE /admin/posts/:id error:', error);
+    res.status(500).json({
+      success: false,
+      error: error.message,
+    });
+  }
+});
+
+/**
+ * POST /whats-new/admin/upload-gif
+ * Upload a GIF to S3 (admin only)
+ * Returns the public URL to use in posts
+ */
+router.post('/admin/upload-gif', authenticate, requireAdmin, upload.single('gif'), async (req, res) => {
+  try {
+    if (!req.file) {
+      return res.status(400).json({
+        success: false,
+        error: 'No file uploaded',
+      });
+    }
+
+    if (!s3Service.isConfigured()) {
+      return res.status(500).json({
+        success: false,
+        error: 'S3 is not configured. Please set AWS credentials.',
+      });
+    }
+
+    console.log(`[WhatsNew] Uploading GIF: ${req.file.originalname} (${req.file.size} bytes)`);
+
+    const result = await s3Service.uploadWhatsNewGif(
+      req.file.buffer,
+      req.file.originalname,
+      req.file.mimetype
+    );
+
+    res.json({
+      success: true,
+      gifUrl: result.publicUrl,
+      key: result.key,
+    });
+  } catch (error) {
+    console.error('[WhatsNew] POST /admin/upload-gif error:', error);
+    res.status(500).json({
+      success: false,
+      error: error.message,
+    });
+  }
+});
+
+module.exports = router;
+

package/scripts/.claude/settings.local.json

@@ -0,0 +1,15 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(chmod:*)",
+      "Bash(SOLANA_RPC_URL=\"https://solana-mainnet.g.alchemy.com/v2/M7pyy3QL4xYOndpcYukNhf-yq2IG6eyl\" node:*)",
+      "Bash(heroku pg:psql:*)",
+      "Bash(curl:*)",
+      "Bash(node scripts/authority-resolve-game.js:*)",
+      "Bash(solana balance:*)",
+      "Bash(heroku addons:info:*)",
+      "Bash(heroku addons:plans:*)",
+      "Bash(heroku addons:upgrade:*)"
+    ]
+  }
+}

package/scripts/README.md

@@ -0,0 +1,170 @@
+# 🔧 DUBS Server - Database Scripts
+
+Quick reference for database setup and maintenance scripts.
+
+## 🚀 Main Setup Scripts
+
+### `setup-database-fresh.sh` ⭐ **RECOMMENDED**
+
+**Complete automated database setup - everything in one command!**
+
+```bash
+./scripts/setup-database-fresh.sh
+```
+
+**What it does:**
+- ✅ Checks if PostgreSQL is installed and running
+- ✅ Starts PostgreSQL automatically if needed
+- ✅ Creates the `dubs_db` database (with confirmation if exists)
+- ✅ Runs complete schema setup (all 18 tables)
+- ✅ Creates `.env` file if missing
+- ✅ Verifies everything works
+
+**Safe to run multiple times!** It won't break existing data.
+
+### `setup-complete-database.sql`
+
+**Complete SQL schema - all tables, indexes, and views**
+
+```bash
+psql -d dubs_db -f scripts/setup-complete-database.sql
+```
+
+Creates all 18 tables:
+- 4 Authentication & User tables
+- 4 Chat system tables  
+- 4 Social feature tables
+- 2 Player stats tables
+- 4 Jackpot system tables
+
+## 📋 Legacy Scripts
+
+These scripts are kept for specific use cases but `setup-database-fresh.sh` handles everything.
+
+### `setup-auth-tables.js`
+Creates authentication-related tables (users, auth_nonces, etc.)
+```bash
+node scripts/setup-auth-tables.js
+```
+
+### `setup-keeper-database.js`
+Creates jackpot keeper tables (keeper_rounds, keeper_actions, etc.)
+```bash
+node scripts/setup-keeper-database.js
+```
+
+### `setup-pnl-tracking.js`
+Creates player stats tracking tables
+```bash
+node scripts/setup-pnl-tracking.js
+```
+
+## 🗑️ Data Management Scripts
+
+### `purge-all-data.sh` ⚠️ **DESTRUCTIVE**
+
+**Removes ALL data from ALL tables (keeps structure)**
+
+```bash
+./scripts/purge-all-data.sh
+```
+
+**Features:**
+- ⚠️ Double confirmation required (type 'yes' + database name)
+- 🗑️ Deletes all data from all tables
+- ✅ Preserves table structure and schema
+- 🔄 Resets ID sequences to 1
+- 📊 Shows before/after counts
+- 🔒 Cannot be undone!
+
+**When to use:**
+- Reset development environment
+- Clear test data before demos
+- Start fresh after testing
+- Remove sensitive data
+
+**Alternative SQL version:**
+```bash
+psql -d dubs_db -f scripts/purge-all-data.sql
+```
+
+## 🔍 Utility Scripts
+
+### `status.js`
+Check keeper and jackpot status
+```bash
+node scripts/status.js
+```
+
+### `check-chat-schema.js`
+Verify chat database schema
+```bash
+node scripts/check-chat-schema.js
+```
+
+### `cleanup-database.js`
+Clean up old/expired data
+```bash
+node scripts/cleanup-database.js
+```
+
+## 🎯 Quick Commands
+
+### Fresh Start
+```bash
+./scripts/setup-database-fresh.sh
+```
+
+### Reset Existing Database
+```bash
+dropdb dubs_db
+createdb dubs_db
+psql -d dubs_db -f scripts/setup-complete-database.sql
+```
+
+### Update Schema Only (Keep Data)
+```bash
+psql -d dubs_db -f scripts/setup-complete-database.sql
+```
+
+### Check What's Installed
+```bash
+psql -d dubs_db -c "\dt"  # List tables
+psql -d dubs_db -c "\dv"  # List views
+```
+
+## 📖 Full Documentation
+
+See [DATABASE_SETUP_GUIDE.md](../documentation/DATABASE_SETUP_GUIDE.md) for:
+- Complete troubleshooting guide
+- Database management commands
+- Backup/restore procedures
+- Common error solutions
+- Security best practices
+
+## 🆘 Quick Troubleshooting
+
+**PostgreSQL not running?**
+```bash
+brew services start postgresql@14
+```
+
+**Database doesn't exist?**
+```bash
+createdb dubs_db
+```
+
+**Tables missing?**
+```bash
+psql -d dubs_db -f scripts/setup-complete-database.sql
+```
+
+**Start over?**
+```bash
+./scripts/setup-database-fresh.sh
+```
+
+---
+
+💡 **Pro tip:** Bookmark this file and the setup script - they'll save you time on every new environment!
+

package/scripts/RESTART_EVERYTHING.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+
+# 🔄 Complete Restart Script
+# Use this to restart everything with the latest code
+
+set -e
+
+echo "🔄 Restarting Dubs Jackpot System"
+echo "=================================="
+echo ""
+
+# Kill all existing processes
+echo "1️⃣  Stopping all processes..."
+pkill -f "jackpot/keeper.js" || true
+pkill -f "server.js.*dubs-server" || true
+sleep 2
+
+# Create logs directory if needed
+mkdir -p logs
+
+# Start with PM2 if available
+if command -v pm2 &> /dev/null; then
+  echo "2️⃣  Starting with PM2..."
+  
+  # Stop existing PM2 processes
+  pm2 delete dubs-api 2>/dev/null || true
+  pm2 delete jackpot-keeper 2>/dev/null || true
+  
+  # Start using ecosystem config
+  pm2 start ecosystem.config.js
+  
+  # Save PM2 configuration
+  pm2 save
+  
+  echo ""
+  echo "✅ Started with PM2!"
+  echo ""
+  echo "📊 View status:"
+  echo "   pm2 status"
+  echo ""
+  echo "📋 View logs:"
+  echo "   pm2 logs dubs-api"
+  echo "   pm2 logs jackpot-keeper"
+  echo ""
+  echo "🔄 Restart individual service:"
+  echo "   pm2 restart dubs-api"
+  echo "   pm2 restart jackpot-keeper"
+  
+else
+  echo "⚠️  PM2 not installed. Starting manually..."
+  echo ""
+  echo "Install PM2 for better process management:"
+  echo "   npm install -g pm2"
+  echo ""
+  
+  # Start manually in background
+  echo "Starting API server..."
+  SOLANA_NETWORK=https://api.devnet.solana.com nohup node server.js > logs/api.log 2>&1 &
+  echo "API Server PID: $!"
+  
+  sleep 2
+  
+  echo "Starting keeper bot..."
+  nohup node scripts/jackpot/keeper.js > logs/keeper.log 2>&1 &
+  echo "Keeper Bot PID: $!"
+  
+  echo ""
+  echo "✅ Started manually!"
+  echo ""
+  echo "📋 View logs:"
+  echo "   tail -f logs/api.log"
+  echo "   tail -f logs/keeper.log"
+fi
+
+# Wait for services to start
+sleep 3
+
+# Health check
+echo ""
+echo "3️⃣  Health check..."
+
+if curl -s http://localhost:3001/jackpot/health > /dev/null 2>&1; then
+  echo "✅ API server is responding"
+else
+  echo "❌ API server is NOT responding!"
+  echo "   Check logs for errors"
+  exit 1
+fi
+
+# Check current round
+ROUND=$(curl -s http://localhost:3001/jackpot/round/current 2>/dev/null)
+if echo "$ROUND" | grep -q "roundId"; then
+  ROUND_ID=$(echo "$ROUND" | grep -o '"roundId":"[^"]*"' | cut -d'"' -f4)
+  ROUND_STATUS=$(echo "$ROUND" | grep -o '"status":"[^"]*"' | cut -d'"' -f4)
+  echo "✅ Round $ROUND_ID is $ROUND_STATUS"
+else
+  echo "⚠️  No active round"
+fi
+
+echo ""
+echo "=================================="
+echo "🎉 System restarted successfully!"
+echo "=================================="
+

package/scripts/add-claim-columns.sql

@@ -0,0 +1,48 @@
+-- Add claim tracking columns to user_game_refs table
+
+DO $$ 
+BEGIN
+  -- Add claimed_at column
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns 
+    WHERE table_name = 'user_game_refs' AND column_name = 'claimed_at'
+  ) THEN
+    ALTER TABLE user_game_refs ADD COLUMN claimed_at TIMESTAMP;
+    RAISE NOTICE 'Added claimed_at column';
+  END IF;
+
+  -- Add claim_signature column
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns 
+    WHERE table_name = 'user_game_refs' AND column_name = 'claim_signature'
+  ) THEN
+    ALTER TABLE user_game_refs ADD COLUMN claim_signature TEXT;
+    RAISE NOTICE 'Added claim_signature column';
+  END IF;
+
+  -- Add claim_explorer_url column
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns 
+    WHERE table_name = 'user_game_refs' AND column_name = 'claim_explorer_url'
+  ) THEN
+    ALTER TABLE user_game_refs ADD COLUMN claim_explorer_url TEXT;
+    RAISE NOTICE 'Added claim_explorer_url column';
+  END IF;
+
+  -- Add amount_claimed column
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns 
+    WHERE table_name = 'user_game_refs' AND column_name = 'amount_claimed'
+  ) THEN
+    ALTER TABLE user_game_refs ADD COLUMN amount_claimed DECIMAL(20, 9);
+    RAISE NOTICE 'Added amount_claimed column';
+  END IF;
+END $$;
+
+-- Verify columns were added
+SELECT column_name, data_type 
+FROM information_schema.columns 
+WHERE table_name = 'user_game_refs' 
+  AND column_name IN ('claimed_at', 'claim_signature', 'claim_explorer_url', 'amount_claimed')
+ORDER BY column_name;
+

package/scripts/add-crypto-prices-cache.sql

@@ -0,0 +1,27 @@
+-- Migration: Add crypto_prices_cache table
+-- Purpose: Store cached crypto prices from CoinGecko API to reduce API calls
+-- Date: 2025-12-06
+
+-- Create crypto prices cache table
+CREATE TABLE IF NOT EXISTS crypto_prices_cache (
+  id SERIAL PRIMARY KEY,
+  crypto_id VARCHAR(50) NOT NULL UNIQUE,
+  prices JSONB NOT NULL,
+  last_updated TIMESTAMP NOT NULL DEFAULT NOW(),
+  expires_at TIMESTAMP NOT NULL,
+  created_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Create indexes for performance
+CREATE INDEX IF NOT EXISTS idx_crypto_prices_id ON crypto_prices_cache(crypto_id);
+CREATE INDEX IF NOT EXISTS idx_crypto_prices_expires ON crypto_prices_cache(expires_at);
+
+-- Add comments for documentation
+COMMENT ON TABLE crypto_prices_cache IS 'Caches crypto prices from CoinGecko API (5-minute TTL)';
+COMMENT ON COLUMN crypto_prices_cache.crypto_id IS 'CoinGecko crypto ID (e.g., solana, bitcoin)';
+COMMENT ON COLUMN crypto_prices_cache.prices IS 'JSON object containing prices in multiple fiat currencies';
+COMMENT ON COLUMN crypto_prices_cache.last_updated IS 'Timestamp when prices were last fetched from API';
+COMMENT ON COLUMN crypto_prices_cache.expires_at IS 'Timestamp when cache entry expires';
+
+COMMIT;
+