Troubleshooting

Troubleshooting Guide for Wallets (MetaMask, Coinbase, Trust Wallet, WalletConnect) on Chrome/Brave

This document is designed to help you troubleshoot issues related to cryptocurrency wallets like MetaMask, Coinbase Wallet, Trust Wallet, and WalletConnect on Chrome and Brave browsers. It also provides tips on debugging and resolving common issues.

Table of Contents

Introduction

Cryptocurrency wallets such as MetaMask, Coinbase Wallet, Trust Wallet, and WalletConnect are essential tools for managing digital assets. However, users may encounter issues due to interference between multiple wallets, outdated browser versions, or hardware wallet connection problems. This guide provides step-by-step instructions to resolve these issues and ensure smooth operation of your wallets.

Common Issues and Solutions

Multiple Wallets Interference

When multiple wallet extensions are installed in Chrome or Brave, they can interfere with each other, causing connection and transaction issues. Follow these steps to disable all but one wallet extension:

  1. Open Chrome/Brave and navigate to the extensions page by typing chrome://extensions or brave://extensions in the address bar.

  2. Identify the wallet extensions installed (MetaMask, Coinbase Wallet, Trust Wallet, etc.).

  3. Disable all wallet extensions except the one you intend to use by toggling the switch next to each extension.

Updating Brave Browser

Keeping your browser up to date is crucial for security and compatibility. Here's how to update Brave:

  1. Open Brave and click on the menu icon (three horizontal lines) in the upper-right corner.

  2. Select About Brave. The browser will automatically check for updates and install them.

  3. Restart Brave to apply the updates.

Resetting Ledger Device Connection

If you use a Ledger hardware wallet, resetting the connection can resolve many issues. Here's how to do it:

  1. Disconnect the Ledger device from your laptop/PC.

  2. Close any associated applications (e.g., Ledger Live).

  3. Reconnect the Ledger device.

  4. Open Ledger Live or your preferred wallet application and retry the connection.

Client Debugging for MetaMask and Similar Wallets

Enable Detailed Logging

For detailed troubleshooting, enable logging in MetaMask or similar wallets:

  1. Open the MetaMask extension.

  2. Click on the account icon and select Settings.

  3. Go to Advanced and enable Show Advanced Gas Controls and Show Hex Data.

  4. This will provide more detailed logs that can help in troubleshooting.

Checking Network Connections

Ensure your wallet is connected to the correct network:

  1. Open your wallet extension.

  2. Verify that the selected network (e.g., Ethereum Mainnet) matches your intended network.

  3. If necessary, switch networks by clicking on the network name and selecting the appropriate one.

Clearing Cache and Cookies

Clearing the browser's cache and cookies can resolve many issues:

  1. Open Chrome/Brave settings by clicking on the menu icon and selecting Settings.

  2. Navigate to Privacy and Security and select Clear browsing data.

  3. Choose Cookies and other site data and Cached images and files, then click Clear data.

Additional Debugging Topics

Ledger Connector Issues

  1. Glitchy Connectors: The Ledger connector can sometimes glitch. If you experience issues, try disconnecting and reconnecting the device.

  2. Slow Adapters: Some USB adapters can slow down your PC. If you notice performance issues, remove the adapter temporarily and check if it resolves the problem.

Network Configuration Issues

  1. Verify that your internet connection is stable.

  2. Ensure that no firewall or VPN is blocking the connection to wallet services.

  3. Check the network status on the wallet's official status page if available.

Reporting Issues

If you need to report an issue after trying the above steps:

  1. Open Terminal:

    • On Windows: Press Ctrl + Shift + I or F12 to open the Developer Tools.

    • On Mac: Press Cmd + Opt + I or Cmd + Opt + J to open the Developer Tools.

    • On Linux: Press Ctrl + Shift + I or F12 to open the Developer Tools.

  2. Go to Console:

    • Navigate to the Console tab in the Developer Tools.

    • Perform the action in Dough Finance DAPP that is causing the error.

    • Take a screenshot of the console with errors or make a video recording of the issue.

  3. Submit the Report:

    • If the issue persists after trying all the above troubleshooting steps, submit your screenshots or video recordings to our support team to help debug your client issues.

Inspecting and Debugging by Browser and Wallet

Chrome/Brave on Mac

  1. Open Developer Tools:

    • Press Cmd + Opt + I or Cmd + Opt + J to open Developer Tools.

  2. Select Wallet Extension:

    • Click on the wallet extension icon (e.g., MetaMask) in the browser toolbar.

  3. Inspect Element:

    • Right-click on the wallet interface and select Inspect to view the HTML and CSS.

  4. View Console:

    • Click on the Console tab to view error messages and logs.

  5. Perform Actions:

    • Perform the actions that are causing issues and observe the console for errors.

Chrome/Brave on Windows

  1. Open Developer Tools:

    • Press Ctrl + Shift + I or F12 to open Developer Tools.

  2. Select Wallet Extension:

    • Click on the wallet extension icon (e.g., MetaMask) in the browser toolbar.

  3. Inspect Element:

    • Right-click on the wallet interface and select Inspect to view the HTML and CSS.

  4. View Console:

    • Click on the Console tab to view error messages and logs.

  5. Perform Actions:

    • Perform the actions that are causing issues and observe the console for errors.

Chrome/Brave on Linux

  1. Open Developer Tools:

    • Press Ctrl + Shift + I or F12 to open Developer Tools.

  2. Select Wallet Extension:

    • Click on the wallet extension icon (e.g., MetaMask) in the browser toolbar.

  3. Inspect Element:

    • Right-click on the wallet interface and select Inspect to view the HTML and CSS.

  4. View Console:

    • Click on the Console tab to view error messages and logs.

  5. Perform Actions:

    • Perform the actions that are causing issues and observe the console for errors.


By following this guide, you should be able to resolve most issues related to using cryptocurrency wallets in Chrome and Brave. For further assistance, always refer to the official support resources of the wallet you are using. If you want to provide the team a report for your browser/wallet client acting buggy, please try all steps above and always provide us a screenshot/video of your browser console!

Last updated