Troubleshooting
Fix common issues with wallet connections, transactions, gas, and deployments on ChainPortal.
Wallet Issues
Wallet not detected
Symptoms: "No wallet detected" or wallet option is greyed out.
Fix:
- Ensure the wallet browser extension is installed
- Check that the extension is enabled (not disabled in browser settings)
- Refresh the page (Ctrl/Cmd + R)
- Try a different browser (Chrome recommended)
- Disable other wallet extensions that may conflict
Cannot connect wallet
Symptoms: Clicking "Connect" does nothing or shows an error.
Fix:
- Disconnect from ChainPortal in your wallet settings
- Clear browser cache for chainportal.org
- Restart your browser
- Update your wallet extension to the latest version
Wrong network
Symptoms: Transactions fail with "wrong network" errors.
Fix:
- Check which network your wallet is on
- Use ChainPortal's chain selector to switch
- Approve the network switch in your wallet popup
- 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:
| Cause | Fix |
|---|---|
| Insufficient gas | Add more native tokens (ETH/SOL/MATIC) to your wallet |
| Gas price too low | Increase gas price in wallet settings |
| Contract error | Check that all form inputs are valid |
| Network congestion | Wait and try again, or switch to a less congested network |
| Nonce error | Reset your wallet's nonce (MetaMask: Settings > Advanced > Reset Account) |
Transaction pending forever
Fix:
- Check the block explorer for your transaction hash
- If "pending": the gas price may be too low. Speed up in your wallet
- If "dropped": the transaction was replaced. Try again
- Wait at least 5 minutes before assuming it failed
NEAR creation: "not enough balance"
Symptoms: The NEAR create form says you need more NEAR, or the wallet rejects the transaction.
Fix: A NEAR creation attaches the creation fee plus the new account's funding (about 4-6 NEAR, refunded where unused), and needs about 0.3 NEAR more for gas. Top up your wallet to the amount the form shows (on testnet, use the NEAR faucet) and try again.
Out of gas
Fix:
- The default gas limit may be too low for complex operations
- Increase gas limit by 50% in your wallet when confirming
- If the issue persists, the contract may have an error -- contact support
On NEAR, ChainPortal attaches 300 Tgas to creations and to launchpad sale creation. Do not lower it in your wallet: a fee-charging creation needs at least 280 Tgas, and a launchpad sale created with too little gas is still created but without your referral.
Token Issues
Created token not showing in wallet
Fix:
- Copy the contract address from ChainPortal (shown after creation)
- In your wallet, click "Import Token" or "Add Custom Token"
- Paste the contract address
- Name and symbol should auto-fill
- Click "Add"
Token shows 0 balance
Possible causes:
- You are on the wrong network -- switch to the network where you deployed
- The token was deployed but supply was not minted -- check if mintable
- You transferred all tokens -- check transaction history
Cannot mint more tokens
Fix:
- Ensure "Mintable" was enabled during creation
- Only the contract owner can mint -- verify your connected wallet is the owner
- If max supply is set, you cannot mint beyond it
NFT Issues
IPFS upload failed
Fix:
- Check file size -- max 10MB per file
- Supported formats: PNG, JPEG, GIF, WebP, JSON
- Try a smaller file
- Check your internet connection
- If the issue persists, try again later
NFT image not showing
Possible causes:
- IPFS propagation can take a few minutes
- The metadata URI may be incorrect
- Try refreshing metadata on the marketplace (OpenSea: click "Refresh Metadata")
Network Issues
RPC errors
Symptoms: "Failed to fetch" or "RPC error" messages.
Fix:
- The default RPC may be overloaded -- try again in a few seconds
- Switch to a different network and back
- ChainPortal automatically falls back to alternative RPCs
- Clear your browser cache
Chain not supported
Fix:
- Check the Supported Chains page
- ChainPortal adds new chains regularly
- 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:
Check the Browser Console
Open DevTools (F12) and look at the Console tab for specific error messages. Copy the error and search for it.
Try a Different Network
Switch to a testnet (Sepolia, Solana Devnet) to rule out network-specific issues. Testnets are free.
Ask the Community
Join our Discord at discord.gg/xUTvhHyaVW and post your issue in the #support channel. Include the error message and network.
Open a GitHub Issue
For bugs, open an issue at github.com/0xChainPortal with steps to reproduce, your network, wallet, and the error.
When asking for help, always include: your wallet type, the network you're using, the exact error message, and what you were trying to do. This helps the community assist you faster.
External Help Resources
| Resource | URL |
|---|---|
| ChainPortal Discord | https://discord.gg/xUTvhHyaVW |
| ChainPortal GitHub Issues | https://github.com/0xChainPortal |
| WalletConnect Status | https://status.walletconnect.com |
| Ethereum Gas Tracker | https://etherscan.io/gastracker |
| Solana Status | https://status.solana.com |
| Pinata Status | https://status.pinata.cloud |