Skip to main content

Wallet Setup

QsnDEX integrates with browser-based Ethereum wallets through RainbowKit, a library that provides a standardized connection flow. This page covers the supported wallets, manual network configuration, and chain switching within the application.

Supported Wallets​

The following wallet providers are supported:

MetaMask​

MetaMask is the most widely used browser extension wallet for Ethereum and EVM-compatible chains.

  • Install from https://metamask.io
  • Available as a browser extension for Chrome, Firefox, Brave, and Edge
  • Also available as a mobile app for iOS and Android

Rabby​

Rabby is a browser extension wallet designed with a focus on DeFi interactions and multi-chain support.

  • Install from https://rabby.io
  • Provides transaction simulation previews before signing
  • Available as a browser extension for Chromium-based browsers

WalletConnect​

WalletConnect is a protocol that enables connections between decentralized applications and mobile wallets.

  • No extension installation required
  • Scan a QR code from the QsnDEX connection modal using any WalletConnect-compatible mobile wallet
  • Supports a wide range of wallet applications including Trust Wallet, Rainbow, and others

Adding the Taiko Network Manually​

If your wallet does not automatically detect the Taiko network, you can add it manually using the following parameters:

ParameterValue
Network NameTaiko Mainnet
Chain ID167000
RPC URLhttps://rpc.mainnet.taiko.xyz
Currency SymbolETH
Block Explorerhttps://taikoscan.io

MetaMask​

  1. Open MetaMask and click the network selector at the top of the window.
  2. Click Add Network or Add a network manually.
  3. Enter the parameters listed in the table above.
  4. Click Save.
  5. The Taiko Mainnet network will now appear in your network list.

Rabby​

  1. Open Rabby and navigate to Settings then Custom Network.
  2. Click Add Network.
  3. Enter the chain ID (167000) and the RPC URL (https://rpc.mainnet.taiko.xyz).
  4. Fill in the remaining fields using the values from the table above.
  5. Save the configuration.

Chain Switching Within the Application​

QsnDEX includes a ChainSwitcher dropdown component in the application header. This component allows you to switch between all supported chains without leaving the interface.

To switch chains:

  1. Locate the chain selector dropdown in the top-right area of the page, near your wallet address.
  2. Click the dropdown to reveal the list of available networks.
  3. Select the chain you want to switch to.
  4. Your wallet will display a prompt asking you to approve the network switch. Confirm the switch in your wallet.
  5. The application will reload its state for the selected chain, including token lists, pool data, and balances.

If the selected chain has not been added to your wallet yet, the application will send an wallet_addEthereumChain request to your wallet, prompting you to add and switch to the network in a single step.

Troubleshooting​

Wallet does not connect​

  • Ensure your wallet extension is unlocked and that you have granted the QsnDEX domain permission to connect.
  • Try refreshing the page and initiating the connection again.
  • If using WalletConnect, verify that your mobile wallet is on the same network and that the QR code has not expired.

Network switch fails​

  • Some wallets require the network to be added before switching. Add the network manually using the parameters provided above and try again.
  • Ensure your wallet extension is up to date.

Transactions are not appearing​

  • Confirm you are connected to the correct chain by checking the ChainSwitcher dropdown.
  • Verify the transaction on the appropriate block explorer. See Supported Chains for explorer links.