Overview
The Quai Wallet snap allows MetaMask users to send and receive QUAI tokens on Quai mainnet. It also enables Quai dApps to interact with MetaMask users who have the snap installed. This integration provides a seamless way for MetaMask users to access the Quai Network ecosystem without needing a separate wallet.Features
QUAI Token Support
Send and receive QUAI tokens on Quai mainnet directly through MetaMask
dApp Integration
Interact with Quai dApps when support is added, using your existing MetaMask interface
Deterministic Address
Your Quai address is generated from your MetaMask keys, ensuring consistency across installations
No Seed Phrase Required
No additional seed phrase needed - your Quai wallet is derived from your existing MetaMask keys
Installation
Step 1: Install from MetaMask Snaps Directory
- Visit the MetaMask Snaps Directory
- Search for “Quai Wallet” or navigate to the Quai Wallet snap
- Click “Add to MetaMask” to install the snap
- Follow the MetaMask prompts to approve the installation
Step 2: Access Your Quai Wallet
Once installed, you can access your Quai wallet through MetaMask:- Open the MetaMask extension
- Click the three dashed lines (⋮⋮⋮) at the top right of the MetaMask window
- Click on “Snaps” in the dropdown list
- Click on “Quai Wallet” in the list
- Wait for the snap to generate your Quai wallet (this will take a few seconds)
If you do not see “Quai Wallet” in the Snaps list, ensure you have successfully installed the snap from the Snaps Directory first.
Wallet Generation
The Quai Wallet snap generates your wallet address deterministically from your MetaMask keys. This means:- No seed phrase required: Your Quai address is derived from your existing MetaMask account
- Consistent addresses: As long as you have your MetaMask keys, you will always generate the same Quai address
- Secure: Your Quai wallet inherits the security of your MetaMask setup
Usage
Sending QUAI Tokens
- Access your Quai Wallet through the MetaMask Snaps interface
- Click “Send” or “Transfer”
- Enter the recipient’s Quai address
- Specify the amount of QUAI to send
- Review the transaction details
- Confirm the transaction through MetaMask
Receiving QUAI Tokens
- Access your Quai Wallet through the MetaMask Snaps interface
- Copy your Quai address from the wallet interface
- Share this address with others to receive QUAI tokens
- Incoming transactions will appear in your transaction history
Security Considerations
- Your Quai wallet is as secure as your MetaMask wallet
- Always verify transaction details before confirming
- Keep your MetaMask seed phrase safe - it controls both your Ethereum and Quai wallets
- Be cautious of phishing attempts and only install snaps from official sources
Troubleshooting
Snap Not Appearing
- Ensure you’ve successfully installed the snap from the MetaMask Snaps Directory
- Try refreshing MetaMask or restarting your browser
- Check that you’re using a supported version of MetaMask
Wallet Generation Issues
- Wait a few seconds for the wallet to generate
- If issues persist, try removing and reinstalling the snap
- Ensure your MetaMask is properly set up and unlocked
Transaction Issues
- Verify you have sufficient QUAI balance for the transaction
- Ensure the recipient address is a valid Quai address
Support
For issues with the Quai Wallet snap:- Check the MetaMask Snaps documentation
- Visit the Quai Network community channels
- Review the Quai Network documentation
Frequently Asked Questions
What is a MetaMask Snap?
What is a MetaMask Snap?
MetaMask Snaps are programs that extend the functionality of MetaMask. They allow developers to add new features and capabilities to the MetaMask wallet, such as supporting new blockchains like Quai Network.
Do I need a separate wallet for Quai Network?
Do I need a separate wallet for Quai Network?
Not necessarily. The Quai Wallet snap allows you to interact with Quai Network directly through your existing MetaMask wallet. You don’t need to install or manage a separate wallet application. However, for users who want the best experience with dApps, we recommend installing Pelagus Wallet
Is the Quai Wallet snap safe to use?
Is the Quai Wallet snap safe to use?
Yes, the Quai Wallet snap was audited by Hacken and is designed with security in mind. It generates your Quai address deterministically from your existing MetaMask keys, so it inherits the security of your MetaMask setup.
Can I store other tokens in the Quai Wallet snap?
Can I store other tokens in the Quai Wallet snap?
Not yet. You can receive QRC20 tokens to your address, but you currently cannot send them. This will be fixed in the next update.
Can I interact with Quai dApps with the Quai Wallet snap?
Can I interact with Quai dApps with the Quai Wallet snap?
Not yet. Quai dApps have to add support specifically for the Quai Wallet snap. It is a different process than integrating MetaMask directly. We will update here when dApps have added support for Quai Wallet snap. If you are interested in interacting with Quai dApps, we recommend you install Pelagus Wallet
Can I create a new address within the Quai Wallet snap?
Can I create a new address within the Quai Wallet snap?
No, the Quai Wallet snap was designed with the basics in mind. Your Quai address is generated from your MetaMask keys and currently only one address is generated from each MetaMask seed phrase. If you wish to generate multiple Quai addresses, we recommend you install Pelagus Wallet
I can't find the Quai Wallet snap in the Snaps Directory. What should I do?
I can't find the Quai Wallet snap in the Snaps Directory. What should I do?
Make sure you’re visiting the official MetaMask Snaps Directory at https://snaps.metamask.io. If you still can’t find it, the snap might be temporarily unavailable or you may need to update your MetaMask version.
Why does it take a few seconds to generate my Quai wallet?
Why does it take a few seconds to generate my Quai wallet?
The snap needs to derive your Quai address from your MetaMask keys using cryptographic functions. This process takes a few seconds but only happens once per session.
Will I get the same Quai address every time I install the snap with the same MetaMask account?
Will I get the same Quai address every time I install the snap with the same MetaMask account?
Yes! Since your Quai address is generated deterministically from your MetaMask keys, you will always get the same address as long as you use the same MetaMask account.
Can I send QUAI tokens to any Ethereum address?
Can I send QUAI tokens to any Ethereum address?
No, you can only send QUAI tokens to valid Quai addresses. Quai addresses look like Ethereum addresses but start with 0x00.
How do I know if a transaction was successful?
How do I know if a transaction was successful?
You can check the transaction status in your Quai Wallet interface within MetaMask, or on Quaiscan.
What happens if I send QUAI to an invalid address?
What happens if I send QUAI to an invalid address?
If you send QUAI to an invalid address, the transaction will fail and your tokens should be returned. Always double-check addresses before sending.
Can I use the Quai Wallet snap with existing Ethereum dApps?
Can I use the Quai Wallet snap with existing Ethereum dApps?
The Quai Wallet snap is specifically designed for Quai interactions. For Ethereum dApps, you’ll continue to use your regular MetaMask wallet.
I'm getting an error when trying to send QUAI. What could be wrong?
I'm getting an error when trying to send QUAI. What could be wrong?
Common issues include insufficient QUAI balance, invalid recipient address, or network connectivity problems. Check your balance and verify the recipient address format.
Can I export my Quai private keys?
Can I export my Quai private keys?
Not yet. The Quai Wallet snap currently doesn’t provide direct access to private keys. Your Quai wallet is derived from your MetaMask keys, so as long as you have access to your MetaMask account, you have access to your Quai wallet. This will be updated in a future version.
The Quai Wallet snap is designed to provide a seamless bridge between MetaMask users and the Quai Network ecosystem. As the ecosystem continues to grow, expect more features and dApp integrations to become available.