Docs

Appearance

Troubleshooting Guide ​

Having issues with CoinBuddy? This comprehensive guide covers common problems and their solutions. Most issues can be resolved quickly with the right approach.

Quick Help

Most problems are related to wallet connection, network issues, or gas fees. Check these first before trying advanced solutions.

Wallet Connection Issues ​

Wallet Not Connecting ​

MetaMask Not Appearing

Symptoms: Can't see MetaMask option when clicking "Connect Wallet"

Solutions:

  1. Check Extension: Ensure MetaMask extension is installed and enabled
  2. Refresh Page: Simple page refresh often resolves connection issues
  3. Clear Cache: Clear browser cache and cookies
  4. Try Incognito: Use private/incognito browsing mode
  5. Disable Ad Blockers: Temporarily disable browser ad blockers
  6. Update MetaMask: Ensure you're using the latest version
Connection Keeps Failing

Symptoms: Connection attempt fails or times out

Solutions:

  1. Unlock Wallet: Ensure MetaMask is unlocked
  2. Check Network: Verify you're on a supported network
  3. Reset Connection: Disconnect and reconnect in MetaMask settings
  4. Browser Compatibility: Try a different browser (Chrome, Firefox, Edge)
  5. Restart Browser: Close and reopen your browser completely

Wrong Network Issues ​

Network Mismatch

Problem: Connected to wrong blockchain network

Symptoms:

  • Can't see your tokens
  • Transaction fails immediately
  • Balance shows as zero

Solution:

  1. Open MetaMask
  2. Click network dropdown (top center)
  3. Select correct network from list
  4. Or add custom network if needed
  5. Refresh CoinBuddy page

Transaction Problems ​

Transaction Failures ​

"Transaction Failed" Error

Common Causes & Solutions:

Insufficient Gas Fees:

  • Problem: Not enough native tokens for gas
  • Solution: Add more ETH/BNB/MATIC to your wallet

Gas Limit Too Low:

  • Problem: Complex transactions need more gas
  • Solution: Increase gas limit manually in MetaMask

Network Congestion:

  • Problem: Blockchain is overloaded
  • Solution: Wait and retry during off-peak hours

Invalid Parameters:

  • Problem: Incorrect token settings
  • Solution: Review all inputs for errors
Transaction Stuck "Pending"

Symptoms: Transaction shows as pending for long time

Solutions:

  1. Wait: Network congestion can cause delays (up to 30+ minutes)
  2. Speed Up: Use MetaMask's "Speed Up" button with higher gas
  3. Cancel: Cancel transaction and retry with higher gas price
  4. Check Explorer: Verify transaction status on blockchain explorer
  5. Reset Account: Last resort - reset MetaMask account (loses transaction history)

Gas Fee Issues ​

High Gas Fees

Understanding Gas Costs:

Simple Token: ~$20-50 USD (depending on network congestion) Advanced Token: ~$50-150+ USD (more features = higher cost)

Cost-Saving Strategies:

  • Use Testnets: Free testing on Sepolia/other testnets
  • Off-Peak Hours: Deploy during low network usage
  • Layer 2 Networks: Use Polygon, Arbitrum, or BSC for lower fees
  • Batch Operations: Group multiple actions together

Token Creation Issues ​

Deployment Problems ​

Contract Deployment Failed

Symptoms: "Token creation failed" or similar error

Diagnostic Steps:

  1. Check Wallet Balance: Ensure sufficient funds for gas
  2. Verify Network: Confirm you're on intended blockchain
  3. Review Settings: Check for invalid parameters
  4. Try Again: Network issues are often temporary
  5. Lower Complexity: Reduce advanced features if failing

Common Parameter Issues:

  • Token name too long (>50 characters)
  • Symbol too long (>10 characters) or contains special characters
  • Total supply too large (number overflow)
  • Invalid addresses for advanced features
Token Not Appearing After Creation

Symptoms: Successful transaction but token not visible

Solutions:

  1. Wait for Confirmation: Allow 2-5 minutes for blockchain confirmation
  2. Check Transaction: Verify success on blockchain explorer
  3. Add to Wallet: Manually import using contract address
  4. Refresh Interface: Reload CoinBuddy page
  5. Check Network: Ensure viewing correct blockchain

Advanced Token Configuration ​

Feature Incompatibility Errors

Problem: Selected features conflict with each other

Common Conflicts:

  • Reflective + Burning: Cannot combine reflection mechanism with burn features
  • Blacklist + Whitelist: Only one access control type allowed
  • Max Supply without Minting: Supply cap requires minting to be enabled

Solution: Review Advanced Token Compatibility Matrix

Interface Issues ​

Display Problems ​

Page Not Loading Correctly

Symptoms: Broken layout, missing elements, or functionality not working

Solutions:

  1. Hard Refresh: Ctrl+F5 (Windows) or Cmd+Shift+R (Mac)
  2. Clear Cache: Clear browser cache and cookies
  3. Disable Extensions: Temporarily disable browser extensions
  4. Try Different Browser: Test with Chrome, Firefox, or Edge
  5. Check Internet: Ensure stable internet connection
"My Tokens" Section Empty

Problem: Created tokens not showing in dashboard

Causes & Solutions:

  • Wrong Network: Switch to network where tokens were created
  • Different Wallet: Ensure using same wallet address
  • Sync Issues: Wait a few minutes and refresh
  • Contract Address: Manually verify on blockchain explorer

Recovery Procedures ​

Lost Contract Address ​

Critical Information Recovery

If you lost your contract address:

  1. Check Transaction History: Find deployment transaction in MetaMask
  2. Blockchain Explorer: Use transaction hash to find contract address
  3. My Tokens Section: Check if still visible in CoinBuddy dashboard
  4. Browser History: Look for previous CoinBuddy sessions

Prevention: Always save contract address and transaction hash immediately after deployment

Wallet Recovery Issues ​

Wallet Access Problems

If you can't access your wallet:

  1. Seed Phrase Recovery: Use your 12/24 word backup phrase
  2. Private Key Import: Import using private key if available
  3. Hardware Wallet: Reconnect and unlock hardware wallet
  4. Multiple Accounts: Check if using different account within wallet

Important: CoinBuddy cannot recover lost wallet access - this is blockchain-level security

Advanced Diagnostics ​

Using Blockchain Explorers ​

Transaction Investigation

Etherscan (Ethereum) / PolygonScan / BSCScan Usage:

  1. Find Transaction: Enter transaction hash in search
  2. Check Status: Look for "Success" or "Failed" status
  3. Read Error Messages: Failed transactions show error details
  4. Verify Contract: Confirm contract address matches expectations
  5. Check Events: Review token transfer events and emissions

MetaMask Advanced Settings ​

Reset Account (Last Resort)

When to Use: Persistent transaction issues or account corruption

Steps:

  1. Go to MetaMask Settings → Advanced
  2. Find "Reset Account" option
  3. Confirm reset (loses transaction history only, not funds)
  4. Reconnect to CoinBuddy

Warning: Only resets local transaction history, doesn't affect actual blockchain state

Getting Additional Help ​

When to Seek Support ​

Contact support when:

  • Issues persist after trying all solutions
  • Transactions succeed but tokens behave unexpectedly
  • Platform-specific bugs or glitches
  • Lost access to important contract information

Before Contacting Support ​

Prepare This Information

  1. Transaction Hash: For any failed or problematic transactions
  2. Wallet Address: Your connected wallet address
  3. Network Used: Which blockchain network
  4. Browser: Which browser and version
  5. Error Messages: Screenshots of any error messages
  6. Steps Taken: What you've already tried to fix the issue

Community Resources ​

Still having issues? Don't hesitate to reach out for help. The CoinBuddy community and support team are here to assist you!