Troubleshooting

Solutions to common issues on Stargaze.

Wallet Issues

Wallet won't connect

Try these steps:

1. Refresh the page

2. Make sure wallet extension is installed and unlocked

3. Check for pending popups (may be behind other windows)

4. Try disconnecting and reconnecting

5. Clear browser cache and try again

Still not working?

• Update your wallet extension

• Try a different browser

• Disable other wallet extensions temporarily

Wrong network

If prompted to switch networks:

1. Click "Switch Network" in the popup

2. Or manually switch to Cosmos Hub in your wallet settings

Transaction stuck/pending

Transactions are usually instant. If stuck:

1. Wait a few minutes

2. Check transaction status in your wallet

3. Refresh the page

4. The transaction may have failed silently - check your balances

---

Transaction Errors

"Insufficient funds"

You need ATOM for gas fees. Solutions:

• Get at least 0.1 ATOM in your wallet

• Gas fees are small but required for every transaction

"Transaction failed"

Common causes:

• Network congestion - wait and retry

• Insufficient gas - shouldn't happen with default settings

• Item already sold - someone else bought it first

"Rejected by user"

You clicked "Reject" in your wallet. Simply retry and click "Approve" this time.

"Out of gas"

Rare on Cosmos. If it happens:

• Try the transaction again

• Contact support if it persists

---

Display Issues

NFTs not showing

1. Refresh the page

2. Verify you're connected with the right wallet

3. Clear browser cache

4. NFTs may take a moment to index after purchase

Images not loading

• Images are stored on IPFS

• Slow loading can happen during high traffic

• Try refreshing

• Check your internet connection

Wrong prices showing

• Prices update in real-time

• Hard refresh (Ctrl/Cmd + Shift + R)

• May be a caching issue - clear cache

Site looks broken

• Clear browser cache

• Disable browser extensions temporarily

• Try incognito/private mode

• Update your browser

---

Trading Issues

Can't buy an NFT

• Item may have just sold

• You may not have enough funds

• Ensure you have ATOM for gas

Can't list for sale

• Verify you own the NFT

• Check if it's already listed

• Ensure you have ATOM for gas

Offer not appearing

• Offers need time to index

• Refresh the page

• Check your "Offers Made" in profile

---

Minting Issues

Can't mint

• Check if mint is live (timing)

• Verify you're whitelisted (if required)

• Ensure you have enough funds (mint price + gas)

• Check per-wallet limits

Minted but don't see NFT

• May take a moment to appear

• Refresh your profile

• Check transaction was successful

Wrong NFT received

• Minting is random within a collection

---

Account Issues

Can't update profile

• Ensure wallet is connected

• Try signing out and back in

• Clear cache and retry

Notifications not working

• Check notification settings

• Verify email/Telegram is connected

• Check spam folder for emails

---

Getting More Help

Collect information

Before contacting support, gather:

• Your wallet address

• Transaction hash (if applicable)

• Screenshots of the issue

• Steps to reproduce the problem

Contact options

• Discord: #support channel (fastest)

• Twitter: @StargazeZone

• Email: For sensitive issues

Response times

• Discord: Usually within hours

• Complex issues may take longer

• Provide clear details for faster help