MetaMask is a popular web browser extension and mobile application that enables users to securely manage cryptocurrency wallets. This guide will walk you through setting up MetaMask for Gnosis Chain, allowing you to interact with decentralized applications (dApps) and manage assets like xDai and GNO tokens.
Downloading MetaMask
To get started, download MetaMask from the official sources:
- Visit the MetaMask Download Page
- The site will automatically detect your browser and direct you to the correct extension store
- Supported browsers: Chrome, Firefox, Opera, Edge, and Brave
- Mobile versions available for both Android and iOS
Configuring MetaMask for Gnosis Chain
After installation, you'll need to configure MetaMask to work with Gnosis Chain. You have two options:
Quick Configuration Method
For the fastest setup:
- Visit ChainList
- Search for "Gnosis"
- Click "Connect Wallet" and follow the prompts
Select either:
- Gnosis Mainnet (for production)
- Chiado Testnet (for testing)
Manual Configuration
If you prefer manual setup:
- Open MetaMask and click the network dropdown
- Select "Custom RPC"
- Enter these details:
| Setting | Value |
|---|---|
| Network Name | Gnosis Chain Mainnet |
| New RPC URL | https://rpc.gnosischain.com |
| Chain ID | 100 |
| Currency Symbol | xDai |
| Block Explorer URL | https://blockscout.com/xdai/mainnet |
- Click "Save"
For Chiado Testnet, use:
- RPC URL:
https://rpc.chiadochain.net - Chain ID: 10200
- Symbol: xDai
Advanced Configuration Options
Adding Custom Tokens
To add tokens not automatically detected:
- In MetaMask, click "Import Tokens"
- Enter the token contract address
- MetaMask will auto-fill other details
- Click "Add Custom Token"
👉 Learn more about custom tokens
Programmatic Integration for Developers
If you're building a dApp:
- Follow the MetaMask Developer Documentation
- Implement wallet connection logic
- Handle chain switching when needed
Changing RPC Endpoints
To modify your connection:
- Go to MetaMask Settings
- Select "Networks"
- Choose Gnosis Chain
- Update the RPC URL field
- Save changes
Frequently Asked Questions
Is MetaMask safe to use with Gnosis Chain?
Yes, MetaMask is a secure way to interact with Gnosis Chain when downloaded from official sources and used with proper security measures.
Can I use hardware wallets with MetaMask on Gnosis?
Absolutely! MetaMask supports integration with Ledger and Trezor devices for enhanced security.
What's the difference between Mainnet and Testnet?
Mainnet is for real transactions with actual value, while Testnet (Chiado) is for development and testing with fake tokens.
Why isn't my token balance showing?
You may need to manually add the token using the contract address if it's not automatically detected.
How do I troubleshoot connection issues?
Try these steps:
- Check your internet connection
- Verify the RPC URL is correct
- Clear cache and restart your browser
- Try switching networks and back
Additional Resources
For more information about using MetaMask with Gnosis Chain:
Remember to always keep your seed phrase secure and never share it with anyone. Happy decentralized exploring!