Troubleshooting

Wallet Issues

Wallet not detected

Symptoms: "No wallet detected" or wallet option is greyed out.

Fix:

1. Ensure the wallet browser extension is installed
2. Check that the extension is enabled (not disabled in browser settings)
3. Refresh the page (Ctrl/Cmd + R)
4. Try a different browser (Chrome recommended)
5. Disable other wallet extensions that may conflict

Cannot connect wallet

Symptoms: Clicking "Connect" does nothing or shows an error.

Fix:

1. Disconnect from ChainPortal in your wallet settings
2. Clear browser cache for chainportal.org
3. Restart your browser
4. Update your wallet extension to the latest version

Wrong network

Symptoms: Transactions fail with "wrong network" errors.

Fix:

1. Check which network your wallet is on
2. Use ChainPortal's chain selector to switch
3. Approve the network switch in your wallet popup
4. If the network is not added to your wallet, it will be added automatically

---

Transaction Issues

Transaction failed

Symptoms: Transaction rejected or reverted.

Common causes and fixes:

Transaction pending forever

Fix:

1. Check the block explorer for your transaction hash
2. If "pending": the gas price may be too low. Speed up in your wallet
3. If "dropped": the transaction was replaced. Try again
4. Wait at least 5 minutes before assuming it failed

Out of gas

Fix:

1. The default gas limit may be too low for complex operations
2. Increase gas limit by 50% in your wallet when confirming
3. If the issue persists, the contract may have an error -- contact support

---

Token Issues

Created token not showing in wallet

Fix:

1. Copy the contract address from ChainPortal (shown after creation)
2. In your wallet, click "Import Token" or "Add Custom Token"
3. Paste the contract address
4. Name and symbol should auto-fill
5. Click "Add"

Token shows 0 balance

Possible causes:

1. You are on the wrong network -- switch to the network where you deployed
2. The token was deployed but supply was not minted -- check if mintable
3. You transferred all tokens -- check transaction history

Cannot mint more tokens

Fix:

1. Ensure "Mintable" was enabled during creation
2. Only the contract owner can mint -- verify your connected wallet is the owner
3. If max supply is set, you cannot mint beyond it

---

NFT Issues

IPFS upload failed

Fix:

1. Check file size -- max 10MB per file
2. Supported formats: PNG, JPEG, GIF, WebP, JSON
3. Try a smaller file
4. Check your internet connection
5. If the issue persists, try again later

NFT image not showing

Possible causes:

1. IPFS propagation can take a few minutes
2. The metadata URI may be incorrect
3. Try refreshing metadata on the marketplace (OpenSea: click "Refresh Metadata")

---

Network Issues

RPC errors

Symptoms: "Failed to fetch" or "RPC error" messages.

Fix:

1. The default RPC may be overloaded -- try again in a few seconds
2. Switch to a different network and back
3. ChainPortal automatically falls back to alternative RPCs
4. Clear your browser cache

Chain not supported

Fix:

1. Check the Supported Chains page
2. ChainPortal adds new chains regularly
3. If your chain is listed but not working, the factory contracts may not be deployed yet

---

Still stuck?

If none of the above solutions work:

External Help Resources