Testing Guide

December 16, 2025 · View on GitHub

Overview

This document outlines the testing procedures for the GXQ Studio platform, including both existing and new features.

Prerequisites

Node.js 18+ installed
Solana wallet with devnet SOL
Web browser (Chrome/Firefox/Safari)
RPC endpoint access

Setup

Backend Setup

# Install dependencies
npm install

# Copy environment file
cp .env.example .env

# Edit .env with your configuration
# Required: SOLANA_RPC_URL, WALLET_PRIVATE_KEY

# Build
npm run build

# Test commands
npm start providers    # List flash loan providers
npm start scan         # Test arbitrage scanning
npm start airdrops     # Check airdrops

Frontend Setup

# Navigate to webapp
cd webapp

# Install dependencies
npm install

# Set environment variables
echo "NEXT_PUBLIC_RPC_URL=https://api.mainnet-beta.solana.com" > .env.local

# Run development server
npm run dev

# Open http://localhost:3000

Testing Checklist

✅ Existing Features

1. Home Page (/)

2. Jupiter Swap (/swap)

3. Arbitrage (/arbitrage)

Flash loan providers display
Settings controls work
Scan button functions
Opportunities list populates
Execute button shows for each opportunity
MEV protection status indicators

4. Sniper Bot (/sniper)

5. Token Launchpad (/launchpad)

6. Airdrop Checker (/airdrop)

7. Staking (/staking)

8. Wallet Analysis (/wallet-analysis)

✅ New Features

9. Settings (/settings)

Test Cases:

Add new RPC provider
Add Pyth feed provider
Add DEX provider
Toggle API rotation on/off
Adjust rotation interval
Save settings locally
Connect wallet and save on-chain
Verify transaction cost (0.000022 SOL)
Reload page and check persistence

10. Admin Panel (/admin)

Test Cases:

Connect wallet
Start bot and verify status
Check uptime counter
Stop bot
Scan for opportunities
Execute an opportunity
Score a wallet address
Analyze portfolio
Verify price data from Pyth
Check transaction history integration

🔧 Integration Testing

Pyth Price Service

# Test in browser console on any page
import { getPythService } from '@/lib/pythPriceService';
const service = getPythService();
const price = await service.getPrice('SOL/USD');
console.log('SOL Price:', price);

Test Cases:

Service initializes correctly
Fetches SOL/USD price
Fetches multiple prices in batch
Handles invalid symbols gracefully
Returns proper data structure

API Rotation Service

# Test in browser console
import { loadSettings } from '@/lib/apiRotation';
const settings = loadSettings();
console.log('Loaded settings:', settings);

Test Cases:

Loads settings from localStorage
Returns null when no settings exist
Handles corrupted localStorage data
Updates settings correctly
Rotation interval works

🛡️ Security Testing

Wallet Connection

Wallet adapter loads correctly
Multiple wallet types supported
Connection/disconnection works
No private key exposure in logs
Proper transaction signing flow

Transaction Validation

All transactions show before signing
Transaction costs display correctly
Slippage protection works
Failed transactions handled gracefully
Success confirmations display

API Security

No API keys in frontend code
RPC endpoints configurable
Rate limiting considerations
Error messages don't leak sensitive info

📱 Responsive Testing

Test on multiple screen sizes:

Desktop (1920x1080)
Laptop (1366x768)
Tablet (768x1024)
Mobile (375x667)

Check:

🎨 UI/UX Testing

⚡ Performance Testing

🐛 Known Issues

Document any issues found during testing:

Minor lint warnings (non-blocking):
- React Hook useEffect dependencies
- Unused imports in swap page
Backend build errors (pre-existing):
- Missing node_modules
- TypeScript lib configuration
Potential improvements:
- Add loading spinners for async operations
- Implement error boundaries
- Add retry logic for failed API calls

Automated Testing

Build Test

cd webapp
npm run build

Expected: No errors, all pages render

Lint Test

cd webapp
npm run lint

Expected: 0 errors (warnings acceptable)

Type Check

cd webapp
npx tsc --noEmit

Expected: No type errors

Manual Testing Scripts

Test All Routes

// Run in browser console
const routes = [
  '/',
  '/swap',
  '/arbitrage',
  '/sniper',
  '/launchpad',
  '/airdrop',
  '/staking',
  '/wallet-analysis',
  '/settings',
  '/admin'
];

routes.forEach(route => {
  console.log(`Testing ${route}...`);
  window.location.href = route;
});

Test Wallet Connection

// Run on any page
const wallet = window.solana;
if (wallet) {
  await wallet.connect();
  console.log('Connected:', wallet.publicKey.toString());
} else {
  console.log('No wallet detected');
}

Test localStorage

// Check settings storage
const settings = localStorage.getItem('gxq-settings');
console.log('Settings:', JSON.parse(settings));

Deployment Testing

Vercel Deployment

Ensure webapp is set as root directory
Add environment variables in Vercel
Deploy and test all routes
Check build logs for errors
Test on production URL

Environment Variables

Required for production:

NEXT_PUBLIC_RPC_URL: Solana RPC endpoint

Optional:

Custom Pyth endpoints
Custom DEX APIs

Reporting Issues

When reporting bugs, include:

Browser and version
Wallet type (if applicable)
Steps to reproduce
Expected vs actual behavior
Console errors (if any)
Screenshots

Success Criteria

All features pass testing when:

✅ No build errors
✅ All pages load successfully
✅ Wallet connection works
✅ Transactions execute properly
✅ Settings persist correctly
✅ Admin panel functions as expected
✅ No console errors during normal use
✅ Responsive design works on all devices
✅ Performance is acceptable

Last Updated: 2025-12-16

Tested By: Development Team

Next Review: Before production deployment