dubs-server 1.0.0

package/routes/referralEarningsRoutes.js

@@ -0,0 +1,392 @@
+/**
+ * 💰 Referral Earnings API Routes
+ * 
+ * Endpoints for viewing and managing referral commissions.
+ * Referrers earn 1% of their referees' buy-ins.
+ */
+
+const express = require('express');
+const router = express.Router();
+const { authenticate } = require('../middleware/authenticate');
+const referralEarningsService = require('../services/referralEarningsService');
+
+module.exports = () => {
+  
+  /**
+   * GET /api/referral-earnings/me
+   * Get authenticated user's referral earnings
+   * Requires authentication
+   */
+  router.get('/me', authenticate, async (req, res) => {
+    try {
+      const walletAddress = req.user.walletAddress;
+      const { limit = 50, offset = 0, status } = req.query;
+
+      console.log(`[ReferralEarnings API] Getting earnings for ${walletAddress.slice(0, 8)}...`);
+
+      const result = await referralEarningsService.getEarningsForWallet(walletAddress, {
+        limit: parseInt(limit),
+        offset: parseInt(offset),
+        status: status || null
+      });
+
+      res.json({
+        success: true,
+        ...result
+      });
+
+    } catch (error) {
+      console.error('[ReferralEarnings API] Error getting earnings:', error.message);
+      res.status(500).json({
+        success: false,
+        error: error.message
+      });
+    }
+  });
+
+  /**
+   * GET /api/referral-earnings/me/summary
+   * Get quick summary for authenticated user (for dashboard widgets)
+   * Requires authentication
+   */
+  router.get('/me/summary', authenticate, async (req, res) => {
+    try {
+      const walletAddress = req.user.walletAddress;
+
+      const result = await referralEarningsService.getEarningsForWallet(walletAddress, {
+        limit: 1,
+        offset: 0
+      });
+
+      res.json({
+        success: true,
+        summary: result.summary
+      });
+
+    } catch (error) {
+      console.error('[ReferralEarnings API] Error getting summary:', error.message);
+      res.status(500).json({
+        success: false,
+        error: error.message
+      });
+    }
+  });
+
+  /**
+   * GET /api/referral-earnings/me/recent
+   * Get recent earnings for authenticated user (last 10)
+   * Requires authentication
+   */
+  router.get('/me/recent', authenticate, async (req, res) => {
+    try {
+      const walletAddress = req.user.walletAddress;
+
+      const result = await referralEarningsService.getEarningsForWallet(walletAddress, {
+        limit: 10,
+        offset: 0
+      });
+
+      res.json({
+        success: true,
+        recentEarnings: result.earnings
+      });
+
+    } catch (error) {
+      console.error('[ReferralEarnings API] Error getting recent earnings:', error.message);
+      res.status(500).json({
+        success: false,
+        error: error.message
+      });
+    }
+  });
+
+  /**
+   * GET /api/referral-earnings/leaderboard
+   * Get referral earnings leaderboard (public)
+   */
+  router.get('/leaderboard', async (req, res) => {
+    try {
+      const { limit = 20 } = req.query;
+
+      const leaderboard = await referralEarningsService.getLeaderboard(parseInt(limit));
+
+      res.json({
+        success: true,
+        leaderboard
+      });
+
+    } catch (error) {
+      console.error('[ReferralEarnings API] Error getting leaderboard:', error.message);
+      res.status(500).json({
+        success: false,
+        error: error.message
+      });
+    }
+  });
+
+  /**
+   * GET /api/referral-earnings/stats
+   * Get platform-wide referral stats (public)
+   */
+  router.get('/stats', async (req, res) => {
+    try {
+      const stats = await referralEarningsService.getPlatformStats();
+
+      res.json({
+        success: true,
+        stats
+      });
+
+    } catch (error) {
+      console.error('[ReferralEarnings API] Error getting platform stats:', error.message);
+      res.status(500).json({
+        success: false,
+        error: error.message
+      });
+    }
+  });
+
+  /**
+   * GET /api/referral-earnings/user/:walletAddress
+   * Get public referral stats for any user
+   * Returns only summary (no detailed earnings)
+   */
+  router.get('/user/:walletAddress', async (req, res) => {
+    try {
+      const { walletAddress } = req.params;
+
+      const result = await referralEarningsService.getEarningsForWallet(walletAddress, {
+        limit: 0, // Don't fetch individual earnings
+        offset: 0
+      });
+
+      res.json({
+        success: true,
+        walletAddress,
+        summary: {
+          totalEarnedSOL: result.summary.totalEarnedSOL,
+          uniqueReferees: result.summary.uniqueReferees,
+          gamesCount: result.summary.gamesCount
+        }
+      });
+
+    } catch (error) {
+      console.error('[ReferralEarnings API] Error getting user stats:', error.message);
+      res.status(500).json({
+        success: false,
+        error: error.message
+      });
+    }
+  });
+
+  /**
+   * GET /api/referral-earnings/wallet/:walletAddress
+   * Get referral earnings with transaction signatures for transaction history linking
+   * Used by frontend GameLinkingService
+   */
+  router.get('/wallet/:walletAddress', async (req, res) => {
+    try {
+      const { walletAddress } = req.params;
+
+      const result = await referralEarningsService.getEarningsForWallet(walletAddress, {
+        limit: 100, // Get recent earnings for transaction matching
+        offset: 0
+      });
+
+      res.json({
+        success: true,
+        earnings: result.earnings
+      });
+
+    } catch (error) {
+      console.error('[ReferralEarnings API] Error getting wallet earnings:', error.message);
+      res.status(500).json({
+        success: false,
+        error: error.message
+      });
+    }
+  });
+
+  /**
+   * POST /api/referral-earnings/process-game
+   * Process referral commissions for a resolved game
+   * Called by the oracle after game resolution
+   *
+   * Note: This can be secured with API key or made internal-only
+   */
+  router.post('/process-game', async (req, res) => {
+    try {
+      const { gameId, gameType, potSizeLamports } = req.body;
+
+      // Validate required fields
+      if (!gameId || !gameType || !potSizeLamports) {
+        return res.status(400).json({
+          success: false,
+          error: 'Missing required fields: gameId, gameType, potSizeLamports'
+        });
+      }
+
+      console.log(`[ReferralEarnings API] Processing commissions for game ${gameId}`);
+
+      const result = await referralEarningsService.processGameCommissions(
+        gameId,
+        gameType,
+        parseInt(potSizeLamports)
+      );
+
+      res.json({
+        success: true,
+        message: `Processed ${result.commissions.length} referral commissions`,
+        summary: result
+      });
+
+    } catch (error) {
+      console.error('[ReferralEarnings API] Error processing game:', error.message);
+      res.status(500).json({
+        success: false,
+        error: error.message
+      });
+    }
+  });
+
+  /**
+   * GET /api/referral-earnings/pending-payouts
+   * Get all pending payouts grouped by referrer (admin/operator only)
+   * For batch payout processing
+   */
+  router.get('/pending-payouts', async (req, res) => {
+    try {
+      const { minAmount = 0 } = req.query;
+
+      const pendingPayouts = await referralEarningsService.getPendingPayouts(parseInt(minAmount));
+
+      // Calculate totals
+      const totalPending = pendingPayouts.reduce((sum, p) => sum + p.totalPendingLamports, 0);
+
+      res.json({
+        success: true,
+        totalReferrers: pendingPayouts.length,
+        totalPendingLamports: totalPending,
+        totalPendingSOL: totalPending / referralEarningsService.LAMPORTS_PER_SOL,
+        payouts: pendingPayouts
+      });
+
+    } catch (error) {
+      console.error('[ReferralEarnings API] Error getting pending payouts:', error.message);
+      res.status(500).json({
+        success: false,
+        error: error.message
+      });
+    }
+  });
+
+  /**
+   * POST /api/referral-earnings/mark-paid
+   * Mark earnings as paid after successful payout transaction
+   * Called by the payout script/cron
+   */
+  router.post('/mark-paid', async (req, res) => {
+    try {
+      const { referrerWallet, txSignature, batchId } = req.body;
+
+      if (!referrerWallet || !txSignature) {
+        return res.status(400).json({
+          success: false,
+          error: 'Missing required fields: referrerWallet, txSignature'
+        });
+      }
+
+      const count = await referralEarningsService.markEarningsAsPaid(
+        referrerWallet,
+        txSignature,
+        batchId || null
+      );
+
+      res.json({
+        success: true,
+        message: `Marked ${count} earnings as paid`,
+        recordsUpdated: count
+      });
+
+    } catch (error) {
+      console.error('[ReferralEarnings API] Error marking as paid:', error.message);
+      res.status(500).json({
+        success: false,
+        error: error.message
+      });
+    }
+  });
+
+  /**
+   * POST /api/referral-earnings/record
+   * Record an on-chain referral commission payment
+   * Called by the oracle after game resolution with referrer
+   *
+   * This is for tracking/display purposes - the actual SOL transfer
+   * happens on-chain during game resolution.
+   */
+  router.post('/record', async (req, res) => {
+    const { gameId, referrerWallet, commissionLamports, paidOnChain, txSignature, gameType } = req.body;
+    const logPrefix = `[RECORD-COMMISSION:${gameId?.slice(-8) || 'unknown'}]`;
+
+    console.log(`${logPrefix} 📝 Incoming request to record on-chain commission`);
+    console.log(`${logPrefix}    Request body: ${JSON.stringify(req.body)}`);
+
+    try {
+      if (!gameId || !referrerWallet || commissionLamports === undefined) {
+        console.log(`${logPrefix} ❌ Missing required fields`);
+        console.log(`${logPrefix}    gameId: ${gameId || 'MISSING'}`);
+        console.log(`${logPrefix}    referrerWallet: ${referrerWallet || 'MISSING'}`);
+        console.log(`${logPrefix}    commissionLamports: ${commissionLamports === undefined ? 'MISSING' : commissionLamports}`);
+        return res.status(400).json({
+          success: false,
+          error: 'Missing required fields: gameId, referrerWallet, commissionLamports'
+        });
+      }
+
+      console.log(`${logPrefix} ✅ All required fields present`);
+      console.log(`${logPrefix}    Game ID: ${gameId}`);
+      console.log(`${logPrefix}    Referrer: ${referrerWallet}`);
+      console.log(`${logPrefix}    Commission: ${commissionLamports} lamports (${commissionLamports / 1_000_000_000} SOL)`);
+      console.log(`${logPrefix}    Paid on-chain: ${paidOnChain}`);
+      console.log(`${logPrefix}    TX Signature: ${txSignature || 'NOT PROVIDED'}`);
+      console.log(`${logPrefix}    Game type: ${gameType || 'sports (default)'}`);
+
+      if (!txSignature) {
+        console.log(`${logPrefix} ⚠️ WARNING: No transaction signature provided - this record cannot be verified on-chain!`);
+      }
+
+      // Record in database for tracking
+      console.log(`${logPrefix}    Calling recordOnChainCommission service...`);
+      const result = await referralEarningsService.recordOnChainCommission(
+        gameId,
+        referrerWallet,
+        parseInt(commissionLamports),
+        paidOnChain === true,
+        txSignature || null,
+        gameType || 'sports' // Default to sports for backwards compatibility
+      );
+
+      console.log(`${logPrefix} ✅ Service call completed`);
+      console.log(`${logPrefix}    Result: ${JSON.stringify(result)}`);
+
+      res.json({
+        success: true,
+        message: `Recorded ${commissionLamports / 1_000_000_000} SOL commission`,
+        ...result
+      });
+
+    } catch (error) {
+      console.error(`${logPrefix} ❌ ERROR recording commission:`);
+      console.error(`${logPrefix}    Message: ${error.message}`);
+      console.error(`${logPrefix}    Stack: ${error.stack}`);
+      res.status(500).json({
+        success: false,
+        error: error.message
+      });
+    }
+  });
+
+  return router;
+};
+