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

  1. Visit the MetaMask Snaps Directory
  2. Search for “Quai Wallet” or navigate to the Quai Wallet snap
  3. Click “Add to MetaMask” to install the snap
  4. Follow the MetaMask prompts to approve the installation

Step 2: Access Your Quai Wallet

Once installed, you can access your Quai wallet through MetaMask:

  1. Open the MetaMask extension
  2. Click the three dashed lines (⋮⋮⋮) at the top right of the MetaMask window
  3. Click on “Snaps” in the dropdown list
  4. Click on “Quai Wallet” in the list
  5. 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

  1. Access your Quai Wallet through the MetaMask Snaps interface
  2. Click “Send” or “Transfer”
  3. Enter the recipient’s Quai address
  4. Specify the amount of QUAI to send
  5. Review the transaction details
  6. Confirm the transaction through MetaMask

Receiving QUAI Tokens

  1. Access your Quai Wallet through the MetaMask Snaps interface
  2. Copy your Quai address from the wallet interface
  3. Share this address with others to receive QUAI tokens
  4. 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:

Frequently Asked Questions

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.