Common Issues

This comprehensive troubleshooting guide covers the most frequently encountered issues in TokenLab and provides step-by-step solutions.

🔗 Connection Issues

Wallet Connection Problems

Issue: "Wallet Won't Connect"

Symptoms:
- "Connect Wallet" button doesn't respond
- Wallet popup doesn't appear
- Connection fails repeatedly

Solutions:

1. Check Wallet Extension:

   • Ensure wallet extension is installed and enabled

   • Unlock your wallet (enter password)

   • Try refreshing the wallet extension

2. Browser Issues:

   • Clear browser cache and cookies

   • Disable ad blockers temporarily

   • Try incognito/private browsing mode

   • Switch to different browser (Chrome/Firefox)

3. Network Settings:

   • Check internet connection

   • Disable VPN if active

   • Try different network/WiFi

Issue: "Wallet Disconnects Frequently"

Symptoms:
- Wallet disconnects after few minutes
- Need to reconnect repeatedly
- Session expires quickly

Solutions:

1. Wallet Settings:

   • Check wallet auto-lock settings

   • Extend session timeout in wallet

   • Ensure wallet stays unlocked

2. Browser Configuration:

   • Allow pop-ups for TokenLab domain

   • Add TokenLab to browser favorites

   • Keep TokenLab tab active

Platform Connection Issues

Issue: "TokenLab Won't Load"

Symptoms:
- White screen or loading indefinitely
- Error messages about connection
- Features not responding

Solutions:

1. Basic Troubleshooting:

   # Clear browser data
   1. Press Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac)
   2. Select "All time" 
   3. Check "Cookies" and "Cached images"
   4. Click "Clear data"

2. Network Diagnostics:

   • Test internet speed (>1 Mbps required)

   • Try mobile hotspot if WiFi issues

   • Check firewall settings

3. Advanced Solutions:

   • Disable browser extensions one by one

   • Reset browser to default settings

   • Try different device/computer

💰 Transaction Issues

Failed Transactions

Issue: "Transaction Failed" or "Insufficient Balance"

Error Messages:
- "Transaction simulation failed"
- "Insufficient funds for transaction"
- "Slippage tolerance exceeded"

Solutions:

1. Check SOL Balance:

   • Ensure wallet has >0.01 SOL for fees

   • Add more SOL if balance low

   • Account for transaction fees

2. Adjust Settings:

   Trading Settings Fixes:
   - Increase Max Slippage to 10-15%
   - Reduce transaction amounts
   - Wait for network congestion to clear

3. Network Issues:

   • Wait 30 seconds and retry

   • Check Solana network status

   • Try during off-peak hours

Issue: "Transaction Pending Forever"

Symptoms:
- Transaction shows "pending" for >5 minutes
- No confirmation or failure message
- Wallet balance unchanged

Solutions:

1. Check Transaction Status:

   • Copy transaction hash

   • Visit solscan.io

   • Paste hash to check status

2. Resolution Steps:

   • Wait up to 10 minutes for confirmation

   • Refresh browser page

   • Check wallet transaction history

   • Contact support with transaction hash

Slippage and Pricing Issues

Issue: "Price Impact Too High"

Symptoms:
- Transactions fail with slippage errors
- Getting much fewer tokens than expected
- High price impact warnings

Solutions:

1. Adjust Slippage Settings:

   Conservative: 1-5%
   Moderate: 5-10%
   Aggressive: 10-25%
   Emergency: 25-50%

2. Reduce Transaction Size:

   • Use smaller SOL amounts

   • Split large trades into multiple transactions

   • Wait for better liquidity

3. Timing Optimization:

   • Avoid trading during high volatility

   • Check market depth before large trades

   • Use "Sell All" for emergency exits

👛 Wallet Management Issues

Wallet Import Problems

Issue: "Invalid Private Key"

Symptoms:
- Error when importing wallet
- Private key format rejected
- Wallet address doesn't match expected

Solutions:

1. Verify Private Key Format:

   • Ensure it's base58 encoded

   • Check for extra spaces or characters

   • Try copying from different source

2. Alternative Import Methods:

   • Use seed phrase instead of private key

   • Try importing into different wallet first

   • Generate new wallet if import fails

Issue: "Wallet Balance Not Updating"

Symptoms:
- SOL balance shows as 0.0000
- Token balance not reflecting transfers
- Balances stuck on old values

Solutions:

1. Manual Refresh:

   • Click "Update Balances" button

   • Wait 30 seconds for blockchain sync

   • Refresh entire browser page

2. Verification Steps:

   • Check balance on solscan.io

   • Verify wallet address is correct

   • Confirm transactions completed on blockchain

3. Network Sync Issues:

   • Wait for blockchain confirmation (1-2 minutes)

   • Check Solana network status

   • Try again during off-peak hours

Selection and Management Issues

Issue: "Can't Select/Deselect Wallets"

Symptoms:
- Checkboxes don't respond
- "Select All" button not working
- Selected count incorrect

Solutions:

1. Interface Reset:

   • Refresh the page

   • Clear browser cache

   • Try different browser

2. Manual Selection:

   • Click individual checkboxes

   • Use "Clear" button to reset

   • Verify selection count matches expectation

📊 Data Display Issues

Chart Loading Problems

Issue: "Chart Won't Load" or "Chart Shows Error"

Symptoms:
- Black screen instead of chart
- "Chart unavailable" message
- Chart loads but shows no data

Solutions:

1. Token Verification:

   • Ensure valid token address entered

   • Check token exists on GMGN

   • Verify token has trading history

2. Browser Fixes:

   • Allow iframes in browser settings

   • Disable strict privacy settings temporarily

   • Try different browser

3. Network Solutions:

   • Check firewall allows external content

   • Disable ad blockers

   • Try different internet connection

Transaction History Issues

Issue: "No Transactions Showing"

Symptoms:
- Transaction panel empty
- Transactions not updating
- History shows old data only

Solutions:

1. Data Refresh:

   • Wait for auto-refresh (10 seconds)

   • Click anywhere in transaction panel

   • Refresh browser page

2. Token Selection:

   • Ensure token is selected and active

   • Check token address is correct

   • Verify transactions exist for this token

3. Time and Filtering:

   • Transactions may be filtered by time

   • Check for active filters

   • Look for recent trading activity

⚙️ Trading System Issues

Trading Controls Not Working

Issue: "Start/Stop Buttons Not Responding"

Symptoms:
- Clicking Start/Stop has no effect
- Trading status doesn't change
- No transactions being executed

Solutions:

1. Prerequisites Check:

   • Ensure wallets are selected

   • Verify SOL balances are sufficient

   • Check trading settings are configured

2. System Reset:

   • Click "Stop" then wait 10 seconds

   • Click "Start" again

   • Refresh page if buttons remain unresponsive

3. Configuration Verification:

   Required Settings:
   ✓ At least 1 wallet selected
   ✓ Valid SOL amount range
   ✓ Valid slippage range
   ✓ Active token selected

Mode Switching Issues

Issue: "Can't Switch Between Buy/Sell Mode"

Symptoms:
- Mode buttons don't highlight
- Mode doesn't change when clicked
- Wrong mode executing

Solutions:

1. Stop Trading First:

   • Always stop trading before switching modes

   • Wait for "INACTIVE" status

   • Then switch modes

2. Interface Reset:

   • Refresh page

   • Reconfigure settings

   • Test with small amounts

🚨 Emergency Procedures

Rapid Exit Strategies

Issue: "Need to Exit Positions Quickly"

Scenarios:
- Market crashing rapidly
- Large sell orders appearing
- Need immediate liquidation

Emergency Solutions:

1. Use "Sell All" Feature:

   • Located in Holdings Summary section

   • Liquidates all positions immediately

   • Uses high slippage for guaranteed execution

2. Manual Emergency Settings:

   Emergency Configuration:
   Mode: Sell Mode
   Min/Max Slippage: 15-50%
   All wallets selected
   Maximum transaction amounts

3. Last Resort Actions:

   • Use wallet directly for transactions

   • Contact support for assistance

   • Document transaction hashes for recovery

Data Recovery

Issue: "Lost Trading History/Settings"

Symptoms:
- All settings reset to default
- Transaction history missing
- Wallet connections lost

Recovery Steps:

1. Immediate Actions:

   • Don't refresh page immediately

   • Screenshot current state

   • Note any error messages

2. Data Reconstruction:

   • Re-import wallets using private keys

   • Reconfigure trading settings

   • Verify balances against blockchain

3. Support Contact:

   • Email support with details

   • Provide wallet addresses

   • Include transaction hashes if available

📞 Getting Additional Help

When to Contact Support

Immediate Support Needed:

• Funds appear to be lost

• Transactions missing from blockchain

• Security concerns or suspicious activity

• Platform errors preventing trading

General Support:

• Configuration questions

• Strategy optimization

• Feature requests

• Account management

Information to Provide

When contacting support, include:

Support Request Template:
1. Issue Description: [Brief summary]
2. Steps to Reproduce: [What you were doing]
3. Expected Result: [What should happen]
4. Actual Result: [What actually happened]
5. Browser/Device: [Chrome/Windows/Mobile]
6. Wallet Address: [For balance/transaction issues]
7. Transaction Hash: [If applicable]
8. Screenshots: [Error messages/interface issues]

Support Channels

• 📧 Email: [email protected]

• 📲 Telegram: @tokenlab_support

• 📖 Documentation: This knowledge base

• 🔧 Platform Status: Check for known issues

Response Times

• Critical Issues: 1-4 hours

• General Support: 24-48 hours

• Feature Requests: 1-2 weeks

---

Still experiencing issues? Don't hesitate to contact our support team at [email protected] with detailed information about your problem.