Troubleshooting Guide
Common issues and solutions for the OTC Platform
Overview
This guide covers the most common issues users encounter on the OTC Platform and provides step-by-step solutions. If your issue isn't covered here, please contact support.
Connection & Network Issues
"Cannot connect wallet" or "Connection Failed"
Possible Causes:
- MetaMask not installed
- Browser blocking popup windows
- MetaMask locked
- Wrong network selected
Solutions:
- Verify MetaMask extension is installed and enabled
- Unlock MetaMask by entering your password
- Check if browser is blocking popups - allow for OTC domain
- Refresh the page and try connecting again
- Try a different browser (Chrome, Firefox, Brave)
"Wrong Network" or "Please switch to CopyrightChains"
Solution:
- Open MetaMask
- Click the network dropdown at the top
- Select "CopyrightChains"
- If not listed, you need to add the network first
- See Wallet Setup Guide for network details
"Network RPC Error" or "Failed to fetch"
Possible Causes:
- Network congestion
- RPC endpoint temporarily down
- Internet connection issues
Solutions:
- Check your internet connection
- Wait a few moments and try again
- Switch to a different RPC endpoint if available
- Clear browser cache and refresh
Transaction Issues
"Transaction Failed" or "Reverted"
Common Causes:
- Insufficient balance for gas fees
- Token approval not granted
- Trying to buy/sell more than available
- Order already filled by someone else
- Gas limit too low
Solutions:
- Check balances: Ensure you have enough tokens AND gas
- Approve tokens: Complete token approval transaction first
- Refresh listings: Order might be filled - reload the page
- Increase gas: Try setting gas limit manually to 300,000
- Check error message: MetaMask shows specific reason for failure
"Insufficient Funds" Error
For Buying:
- Verify you have enough payment tokens (CCUSD or CCEU) on Hoodi Testnet
- Check you have at least 0.01 ETH on Hoodi Testnet for gas fees
- Ensure you're on the correct network when checking balance
For Selling (Creating Listings - FREE):
- Verify you have enough NUT tokens on CopyrightChains network
- Listing creation is FREE (uses EIP-712 signatures, no gas)
- Confirm you're looking at the CopyrightChains network balance
"Transaction Pending" for Too Long
Solutions:
- Wait: Network might be congested - can take 5-10 minutes
- Check status: View transaction in block explorer
- Speed up: Use MetaMask "Speed Up" feature (costs more gas)
- Cancel: Use MetaMask "Cancel" feature if stuck too long
- Avoid duplicates: Don't submit same transaction multiple times
"Nonce Too Low" or "Replacement Transaction Underpriced"
Solution:
- Open MetaMask Settings
- Go to Advanced
- Click "Reset Account"
- This clears transaction history (funds are safe)
- Try transaction again
SempreID Issues
"SempreID Required" or "No SempreID Found"
This means you haven't completed verification:
- Visit SempreID.com
- Connect your wallet
- Complete the verification process
- Receive your SempreID soulbound token
- Return to OTC Platform and reconnect wallet
Note: SempreID is mandatory. The platform will not function without it.
"SempreID Verification Pending"
Your verification is being processed:
- Check your email for verification status
- Verification typically takes 24-48 hours
- You cannot use the platform until verification is complete
- Contact SempreID support if pending for more than 72 hours
Token & Balance Issues
"Token Balance Not Showing" in MetaMask
Solutions:
- Check network: Ensure you're on the correct network
- NUT tokens: CopyrightChains network
- CCUSD/CCEU: Hoodi Testnet
- Import token: Token might not be added to MetaMask
- Click "Import Tokens"
- Paste token contract address
- See Wallet Setup Guide for addresses
- Refresh: Click the refresh icon in MetaMask
- Verify in explorer: Check balance on block explorer
"Tokens Missing After Transaction"
Don't panic - tokens are likely safe:
- Check transaction status in block explorer
- If successful: tokens are in escrow or transferred
- If failed: tokens are returned to your wallet
- Refresh MetaMask to update balance
- Check "My Orders" - tokens might be in active order
- Verify you're looking at the correct network and address
Interface & Display Issues
"Orders Not Loading" or "Blank Page"
Solutions:
- Hard refresh the page (Ctrl+Shift+R or Cmd+Shift+R)
- Clear browser cache and cookies
- Disable browser extensions (except MetaMask)
- Try incognito/private mode
- Try a different browser
- Check your internet connection
"Prices Not Updating" or "Stale Data"
Solutions:
- Refresh the page
- Check your internet connection
- Verify you're on the correct network
- Clear browser cache if problem persists
"Can't Click Buttons" or "Buttons Not Working"
Possible Causes:
- JavaScript disabled in browser
- Browser extension conflicts
- Page not fully loaded
Solutions:
- Enable JavaScript in browser settings
- Disable ad blockers for the OTC domain
- Wait for page to fully load (check for loading indicators)
- Try different browser
Security Concerns
"Suspicious Transaction Request"
If MetaMask shows unexpected transaction:
- DO NOT CONFIRM if you don't recognize it
- Verify the contract address matches official OTC contracts
- Check the website URL is correct
- When in doubt, reject and contact support
"Think Your Wallet is Compromised?"
Immediate Actions:
- STOP: Don't make any more transactions
- Create new wallet: Set up fresh MetaMask wallet
- Transfer funds: Move assets to new wallet ASAP
- Revoke approvals: Use tools like Revoke.cash to revoke token approvals
- Never use old wallet: Consider it permanently compromised
- Report: Contact support and report the incident
USD Pricing & EIP-712 Listing Issues
"Signature Request Rejected" When Creating Listing
This means you clicked "Reject" in MetaMask:
- Click "Create Listing" again
- MetaMask will show "Sign Message"
- Review the message details (shows your listing amount and price)
- Click "Sign" this time (it's FREE, no gas costs)
- Listing will be created instantly
"Message Signature Verification Failed"
This usually means you're on the wrong network:
- Check that MetaMask is set to CopyrightChains (Chain 1199)
- If wrong network, switch to CopyrightChains in MetaMask dropdown
- Try creating the listing again
- The signature must be made on CopyrightChains network
"How Do I Know What Price to Set?"
Understanding USD Pricing:
- All prices are in USD: You set a price like "$1.50 per NUT"
- Buyers choose payment: They pick CCUSD or CCEU at checkout (both 1:1 USD)
- Check market: Look at current listings to see pricing trends
- Example: If you set "$1.50", buyer can pay 1.50 CCUSD or 1.50 CCEU
- Universal: USD pricing is clear and internationally understood
"My Listing is FREE to Create - Really?"
Yes! Using EIP-712 signatures:
- Listing creation costs ZERO gas fees
- You sign a message (not a blockchain transaction)
- Completely free and takes 1-2 seconds
- This is better than old smart contract based listings
- Only buying NUT costs gas (on Hoodi Testnet)
Still Need Help?
Additional Resources
- Documentation: Review our complete documentation
- AI Chat: Ask questions in our AI help chat
- Support: Contact our support team
- Community: Join our community forums for peer help