Skip to content

Troubleshooting

Common issues and solutions for GoonPad platform.

Wallet Connection

Wallet Won't Connect

Symptoms:

  • "Connect Wallet" button doesn't work
  • Wallet popup doesn't appear
  • Connection fails silently

Solutions:

  1. Refresh the page

    Press Ctrl+R (Windows) or Cmd+R (Mac)
  2. Unlock your wallet

    • Open wallet extension
    • Enter password to unlock
    • Try connecting again
  3. Check wallet extension

    • Is it installed?
    • Is it enabled?
    • Is it up to date?
  4. Disable other wallets

    • Multiple wallet extensions can conflict
    • Temporarily disable unused ones
  5. Clear browser cache

    • Browser settings → Clear cache
    • Restart browser
  6. Try different browser

    • Chrome/Brave usually work best
    • Firefox and Edge also supported

Wrong Network

Symptoms:

  • Wallet shows wrong balance
  • Transactions fail
  • Tokens not showing

Solution: Switch to correct network in wallet settings:

  • Devnet for testing
  • Mainnet for production

Trading Issues

Transaction Failed

Symptoms:

  • "Transaction failed" error
  • Transaction never confirms
  • Wallet rejects transaction

Solutions:

  1. Check SOL balance

    Need SOL for:
    - Platform fee (1.75% of trade)
    - Network fee (~0.00001 SOL)
    - Buffer for price movement
  2. Increase slippage

    • Default 1% might be too low
    • Try 2-3% for volatile tokens
    • Max 5% for very volatile
  3. Wait and retry

    • Network might be congested
    • Wait 30-60 seconds
    • Try transaction again
  4. Reduce trade size

    • Large trades = more slippage
    • Try smaller amount
    • Can always buy more after
  5. Check token isn't graduated

    • Graduated tokens trade on Raydium
    • Can't buy/sell on bonding curve anymore

Insufficient Balance Error

Cause: Not enough SOL to cover trade + fees

Solution:

Required SOL = Trade amount + 1.75% fee + 0.001 buffer

Example for 1 SOL trade:
1 SOL (trade) + 0.0175 (fee) + 0.001 (buffer) = 1.0185 SOL needed

Add more SOL to wallet or reduce trade amount.

Slippage Tolerance Exceeded

Cause: Price moved more than your slippage setting

Solutions:

  1. Increase slippage (try 2-3%)
  2. Trade smaller amount
  3. Wait for less volatility
  4. Accept higher slippage for immediate execution

Transaction Stuck "Pending"

Cause: Network congestion or RPC issues

Solutions:

  1. Wait 2-3 minutes

    • Most transactions confirm within minutes
    • Check Solana Explorer for status
  2. Check network status

  3. Don't retry immediately

    • Might create duplicate transaction
    • Wait for first one to complete or fail
  4. Check transaction on Explorer

    • Copy transaction signature
    • View on Solscan
    • See actual status

Token Issues

Token Not Showing

Symptoms:

  • Created token doesn't appear
  • Token not in wallet
  • Can't find token on platform

Solutions:

  1. Refresh page

    • Hard refresh: Ctrl+Shift+R
  2. Check correct network

    • Devnet vs Mainnet
    • Token only exists on one
  3. Check transaction confirmed

    • View on Solana Explorer
    • Token creation takes ~30 seconds
  4. Add token manually to wallet

    • Copy mint address
    • Add custom token in wallet
    • Paste address

Can't Upload Image

Symptoms:

  • Image upload fails
  • "File too large" error
  • Upload button doesn't work

Solutions:

  1. Check file size

    Max size: 2MB
    Accepted formats: PNG, JPG, GIF
  2. Compress image

    • Use tinypng.com
    • Or image editing software
    • Reduce to under 2MB
  3. Use correct format

    • PNG recommended
    • JPG also works
    • No SVG or WEBP
  4. Try different image

    • Might be corrupt file
    • Re-export from editor

Token Creation Failed

Symptoms:

  • Transaction fails
  • SOL deducted but no token
  • Error message

Solutions:

  1. Check SOL balance

    Need ~0.2 SOL for creation
    Plus buffer for network fees
    Total: ~0.25 SOL recommended
  2. Verify all fields

    • Name: 1-32 characters
    • Symbol: 2-8 characters
    • Image: Under 2MB
    • Description: Under 200 characters
  3. Check network status

    • Solana might be congested
    • Wait and retry
  4. Contact support if SOL deducted

    • Provide transaction signature
    • We'll investigate

Real-time Updates

Prices Not Updating

Symptoms:

  • Charts frozen
  • Old prices showing
  • No live updates

Solutions:

  1. Check internet connection

    • Must be stable for WebSocket
    • Mobile data can be spotty
  2. Refresh page

    • Reconnects WebSocket
    • Usually fixes issue
  3. Check browser console

    • F12 → Console tab
    • Look for WebSocket errors
    • Report if seeing errors
  4. Disable ad-blockers

    • Can block WebSocket connections
    • Try whitelisting goonpad.dev

Trades Not Showing

Symptoms:

  • Trade feed empty
  • Own trades don't appear
  • Delayed updates

Solutions:

  1. Wait 5-10 seconds

    • Transactions need to confirm
    • Updates batch for performance
  2. Check transaction confirmed

    • View on Solana Explorer
    • Might still be pending
  3. Refresh page

    • Reloads all data
    • Reconnects feeds

Rewards & Claiming

Can't Claim Rewards

Symptoms:

  • "Claim" button disabled
  • Transaction fails
  • No rewards shown

Checks:

  1. Is token graduated or expired?

    • Must hit 85 SOL OR
    • Wait 24 hours from creation
  2. Already claimed?

    • Can only claim once per token
    • Check claim history
  3. Any fees collected?

    • If no trading, no fees
    • Nothing to claim
  4. Wallet connected?

    • Must connect creator wallet
    • Same wallet that created token

Solutions:

  • Wait for graduation/expiry
  • Check you're using right wallet
  • Verify fees accumulated (should show amount)

Reward Amount Wrong

Symptoms:

  • Amount less than expected
  • Numbers don't match

Calculation:

Your reward = (Total Volume × 1.75%) × 30%

Example:
Volume: 100 SOL
Fees: 100 × 0.0175 = 1.75 SOL
Your share: 1.75 × 0.30 = 0.525 SOL

Check:

  • Total volume on token page
  • Do math manually
  • Verify on Solana Explorer

Performance

Site Loading Slow

Solutions:

  1. Check internet speed

    • Run speed test
    • Need stable connection
  2. Clear browser cache

    • Settings → Clear cache
    • Restart browser
  3. Disable browser extensions

    • Some extensions slow down sites
    • Try incognito mode
  4. Try different browser

    • Chrome/Brave fastest
    • Firefox also good

Charts Not Loading

Solutions:

  1. Refresh page
  2. Clear cache
  3. Check ad-blockers (disable for goonpad.dev)
  4. Try different browser

API & Developers

API Returning Errors

Common errors:

  1. 404 Not Found

    Check:
    - Token address is correct
    - Token actually exists
    - Using correct endpoint
  2. 500 Internal Server Error

    Usually temporary RPC issues
    Wait and retry
  3. 503 Service Unavailable

    Solana RPC down
    Check status.solana.com
    Wait for recovery

WebSocket Won't Connect

Solutions:

  1. Check URL

    Correct: wss://api.goonpad.dev
    Wrong: ws://api.goonpad.dev (no SSL)
  2. Check firewall

    • Corporate networks might block WebSocket
    • Try different network
  3. Check browser support

    • All modern browsers support WebSocket
    • IE not supported

Mobile Issues

Wallet Not Opening on Mobile

Solutions:

  1. Use in-app browser

    • Open GoonPad from Phantom app
    • Not from Chrome/Safari
  2. Update wallet app

    • Ensure latest version
    • Check app store
  3. Clear app cache

    • App settings → Clear cache
    • Restart app

Touch Targets Too Small

Solution:

  • Pinch to zoom in
  • Platform is responsive but optimized for desktop
  • Mobile version coming soon

Error Messages

"RPC Error"

Meaning: Solana network issue

Solution:

  • Wait a few minutes
  • Retry transaction
  • Check Solana status

"Insufficient funds"

Meaning: Not enough SOL

Solution:

  • Add more SOL to wallet
  • Or reduce trade amount

"Slippage tolerance exceeded"

Meaning: Price moved too much

Solution:

  • Increase slippage setting
  • Try smaller trade
  • Wait for stability

"Token not found"

Meaning: Token doesn't exist

Solution:

  • Check token address
  • Verify on correct network (devnet/mainnet)
  • Might be new token (wait 30s)

Getting More Help

If issues persist:

  1. Check FAQ
  2. Review relevant guides:
  3. Check API docs:

Reporting Bugs

Include:

  • What you were doing
  • Error message (exact text)
  • Transaction signature (if applicable)
  • Browser and wallet used
  • Screenshots if possible

Most issues resolve with a refresh or retry! Don't panic, blockchain transactions are safe.

Built with passion on Solana