Troubleshooting
Common issues and solutions for Lyraverse platform users.
Wallet Connection Issues
Cannot Connect Wallet
Problem: "Wallet not connecting to Lyraverse" Solutions:
Check Network: Ensure Hyperliquid testnet selected
Browser Refresh: Hard refresh (Ctrl+F5)
Extension Update: Update wallet extension
Network Addition: Manually add Hyperliquid network
Error: "Unsupported network"
Solution: Switch to Hyperliquid Testnet in wallet
Network ID: 998
RPC URL: https://api.hyperliquid-testnet.xyz/evmTransaction Not Confirming
Problem: "Transaction stuck in pending" Solutions:
Wait Time: Hyperliquid blocks ~3 seconds
Gas Increase: Speed up with higher gas
Network Check: Verify network connectivity
Wallet Restart: Restart wallet extension
Minting Problems
Mint Transaction Failed
Problem: "Mint failed with error message" Common Errors:
"Insufficient balance"
"Not whitelisted"
"Phase not active"
Cannot Access Mint Page
Problem: "Mint button not appearing" Solutions:
Phase Status: Check if minting is active
Wallet Connection: Ensure wallet is connected
Network: Confirm correct network
Browser Cache: Clear cache and refresh
Marketplace Issues
Listing Not Appearing
Problem: "NFT listed but not visible" Solutions:
Wait Time: Indexer sync takes 2-3 minutes
Transaction Check: Verify transaction confirmed
Contract Approval: Ensure marketplace approved
Refresh Page: Hard refresh browser
Purchase Failed
Problem: "Cannot complete NFT purchase" Common Issues:
"Price changed"
"NFT sold"
"Insufficient funds"
NFT Display Problems
Image Not Loading
Problem: "NFT image shows as broken" Solutions:
IPFS Gateway: Try different IPFS gateway
Metadata Refresh: Wait for metadata update
Cache Clear: Clear browser cache
Network Issues: Check internet connection
Wrong NFT Information
Problem: "NFT shows incorrect details" Solutions:
Indexer Sync: Wait 5-10 minutes
Metadata Update: Contact collection creator
Cache Issues: Hard refresh page
Contract Check: Verify contract address
Collection Issues
Collection Not Found
Problem: "Cannot find collection" Solutions:
Address Check: Verify contract address
Network Confirm: Ensure correct network
Deployment Status: Check if deployed
Search Function: Use search bar
Minting Not Working
Problem: "Collection shows but cannot mint" Solutions:
Phase Check: Verify active mint phase
Supply Check: Confirm NFTs remaining
Paused Status: Check if minting paused
Creator Contact: Reach out to creator
DAO and Governance
Cannot Create Proposal
Problem: "Proposal creation blocked" Solutions:
NFT Ownership: Must hold collection NFTs
Minimum Stake: Check proposal threshold
Phase Status: Ensure governance active
Wallet Balance: Sufficient HYPE for gas
Vote Not Counting
Problem: "Vote transaction successful but not recorded" Solutions:
Wait Time: Allow indexer sync (2-3 minutes)
Transaction Check: Verify on explorer
Proposal Status: Confirm proposal still active
Support Contact: Report to support team
Performance Issues
Slow Loading
Problem: "Pages loading slowly" Solutions:
Network Speed: Check internet connection
Browser Cache: Clear cache and cookies
Extensions: Disable conflicting extensions
Device Resources: Close other applications
App Crashing
Problem: "Application freezing or crashing" Solutions:
Browser Update: Use latest browser version
Memory Clear: Close other tabs/applications
Extension Conflict: Disable wallet extensions temporarily
Device Restart: Restart computer/device
Account and Profile
Profile Not Updating
Problem: "Profile changes not saving" Solutions:
Save Confirmation: Ensure save button clicked
Image Size: Check image file size limits
Format Support: Verify supported formats
Network Issues: Check connection stability
Transaction History Missing
Problem: "Cannot see past transactions" Solutions:
Wallet Sync: Allow full wallet synchronization
Network Selection: Confirm correct network
Explorer Check: Verify on block explorer
Support Contact: Request transaction history
Network and Connectivity
RPC Errors
Problem: "RPC endpoint issues" Solutions:
Network Switch: Try different RPC endpoint
Wallet Reconnect: Disconnect and reconnect wallet
Network Reset: Reset network settings
Support Check: Verify network status
Connection Timeouts
Problem: "Requests timing out" Solutions:
Retry Request: Try again after delay
Network Check: Verify internet stability
VPN Disable: Turn off VPN if used
Regional Issues: Try different network
Security Concerns
Suspicious Transactions
Problem: "Unexpected transaction appeared" Solutions:
Verify Address: Check recipient address
Transaction Details: Review transaction details
Wallet Security: Enable additional security
Report Incident: Contact support immediately
Phishing Attempts
Problem: "Received suspicious links/messages" Solutions:
Verify Source: Only use official links
URL Check: Verify lyraverse.io domain
No Private Keys: Never share private keys
Report Phishing: Alert support team
Advanced Troubleshooting
Developer Console
Access Console: Press F12 → Console tab Look for: Error messages, network failures Report: Copy error messages when contacting support
Network Logs
Check Network Tab: F12 → Network tab Failed Requests: Look for failed API calls Status Codes: Note HTTP error codes
Wallet Logs
Extension Logs: Check wallet extension console Transaction Hashes: Save for support tickets Error Messages: Copy exact error text
Getting Help
Self-Service Resources
Documentation: Check relevant guides
FAQ: Search common questions
Community: Ask in Discord channels
Status Page: Check platform status
Contact Support
General Issues: [email protected]
Technical Problems: [email protected]
Creator Support: [email protected]
Security Issues: [email protected]
Support Response Times
Urgent Issues: < 4 hours
General Support: < 24 hours
Technical Issues: < 48 hours
Feature Requests: 1-2 weeks
Most issues can be resolved with these troubleshooting steps! 🔧
Last updated