🐛 Troubleshooting

Connection Issues

WebSocket Not Connecting

Symptom: No live trades showing

Solutions:

1. Check browser console for errors

2. Verify internet connection

3. Try different browser

4. Clear cache and reload

5. Check if PumpPortal is online

RPC Errors

Symptom: Balances not updating

Solutions:

1. Verify Helius API key in config.js

2. Check API rate limits

3. Try alternative RPC endpoint

4. Manually refresh balances

Trading Problems

Transaction Failures

Error: "Transaction failed"

Fixes:

• Increase slippage (try 95%+)

• Add more priority fee

• Check wallet balance

• Verify token is tradeable

Missing Positions

Symptom: Bought but not showing

Debug:

1. Check browser console

2. Verify transaction on Solscan

3. Manual balance refresh

4. Re-track token

UI Issues

Frozen Interface

Quick Fixes:

• Refresh page (F5)

• Clear browser cache

• Close excess browser tabs

• Restart browser

Windows Not Dragging

Solutions:

• Check if click is on header

• Disable browser extensions

• Try different browser

• Reset window positions

Data Problems

Lost Wallet Configuration

Recovery Steps:

1. Check browser localStorage

2. Use browser history

3. Import from backup

4. Re-enter manually

Incorrect Balances

Verification:

javascript

// Console command to check
console.log(walletBalances);
console.log(walletPositions);

Performance Issues

Slow Loading

• Reduce active wallets

• Close trade flow if not needed

• Disable unused features

• Use faster RPC endpoint

Memory Usage

• Clear old activity logs

• Limit trade history

• Restart browser periodically

• Close unused windows

Advanced Debugging

Enable Debug Mode

javascript

// In console
localStorage.setItem('debug', 'true');
location.reload();

Check WebSocket Status

javascript

// Console commands
console.log(ws.readyState);
// 0=CONNECTING, 1=OPEN, 2=CLOSING, 3=CLOSED

Export Debug Data

javascript

// Full state export
const debugData = {
  wallets: Array.from(walletPositions.entries()),
  balances: Array.from(walletBalances.entries()),
  config: autoTradeConfig,
  activity: recentActivity
};
console.log(JSON.stringify(debugData, null, 2));

Common Error Messages

Getting Help

If issues persist:

1. Document the error (screenshot console)

2. Note reproduction steps

3. Check official Telegram/Discord

4. Review recent updates

5. Try fresh browser profile