BitBox02: MyEtherWallet

Table of contents

  1. Prerequisites
  2. Getting started
    1. Step 1: Setup the BitBox02 Multi
    2. Step 2: Install BitBoxBridge
    3. Step 3: Start using MyEtherWallet with the BitBox02
  3. Receiving & Sending
    1. Receiving ETH and ERC-20 tokens
    2. Sending ETH and ERC-20 tokens
  4. Troubleshooting

Prerequisites

  • A BitBox02 Multi edition hardware wallet
  • The BitBox02 needs to be set up. If it isn’t follow this guide

Getting started

Step 1: Setup the BitBox02 Multi

If your BitBox02 is new, set up the device by downloading and installing the BitBoxApp and following the in-app instructions.

Download BitBoxApp

Step 2: Install BitBoxBridge

To use your BitBox02 with web wallets such as MyEtherWallet, you need to download and install the BitBoxBridge. The BitBoxBridge is a program that runs in the background and allows the BitBox02 to communicate with web based wallets.

Download BitBoxBridge

Step 3: Start using MyEtherWallet with the BitBox02

  1. Go to myetherwallet.com
  2. Click “Access My Wallet” then choose “Hardware”.
  3. Select “BitBox” and then “BitBox02”.
  4. Unlock your BitBox02 by entering the password on the device.
  5. When using MyEtherWallet for the first time, you will be prompted with a pairing code.
  6. Confirm on your BitBox02 that the pairing code matches and select “Continue”.
  7. Now select the account/address you want to use, accept the terms and click “Access My Wallet”.
  8. Done! You can now use your BitBox02 to send, receive and interact with Ethereum and ERC-20 tokens.

Note: You will be prompted with a pairing code whenever you use the BitBox02 with a new browser or computer.

Note: When selecting the account/address during step 7: The first account is identical to the one used by the BitBoxApp

Safety tip: Always check the URL of MyEtherWallet. The URL should be https://www.myetherwallet.com/

Receiving & Sending

Receiving ETH and ERC-20 tokens

To verify your receive address on your BitBox02 display click the highlighted button in the upper-right corner of MyEtherWallet:

alt text

Then confirm the address on your BitBox02.

Sending ETH and ERC-20 tokens

  1. To send ETH and ERC-20 tokens, select the button that says ‘Send Transaction’, or find this section in the ‘Send’ category from the left menu.
  2. Then choose if you want to send ETH or an ERC-20 token. You can search for a token.
  3. Enter the amount.
  4. Enter the address you want to send to.
  5. Optionally edit the transaction fee settings.
  6. Click “Send Transaction”.
  7. Then review the transaction details on the display of your BitBox02.
  8. If all is correct, confirm the transaction on your BitBox02, abort otherwise.
  9. Your transaction has been posted! Copy your transaction hash for your records.

Check your transaction hash on Etherscan to make sure everything went through properly.

Troubleshooting

If MyEtherWallet shows you an error message, please see if you can find the error in the list below.

Error messageProposed solution
BitBoxBridge not foundPlease make you have downloaded and installed the BitBoxBridge. If it is already installed, make sure it is running by following these instructions.
Unlock BitBox02Unlock the BitBox02 by entering your password on the device
Unexpected errorDisconnect and reconnect the BitBox02 and try again.
Action aborted by userYou cancelled a process on the BitBox02. Try again.
Your BitBox02 is not initialisedDownload and install the BitBoxApp to setup your BitBox02.
Please upgrade to the newest firmware using Shift Crypto’s BitBoxAppYour BitBox02 firmware is out of date. Open the BitBoxApp to update the BitBox02
MyEtherWallet does not yet support this version of the firmware.MyEtherWallet may need to update. Try to hard refresh when on the MyEtherWallet page. If this does not work, it is possible you need to wait for MyEtherWallet to release an update.
Trying to connect from a non-whitelisted origin.Attention! You may be on a phishing site. Please check if the URL is correct. The URL for MyEtherWallet should be https://myetherwallet.com
Expected exactly one BitBox02. No or more than one BitBox02 detected.Please make sure you only have one BitBox02 plugged in at a time.
Pairing rejected on device, please try againReconnect the BitBox02 and accept the pairing code by clicking the “check mark” on the BitBox02 when prompted.
Your BitBox02 is busy. Please close all other wallets and try again.Close the BitBoxApp. Close any other wallets you may have open using the BitBox02, such as Electrum.
Device attestation failedReconnect BitBox02 and try again. If you keep getting the warning. Please contact support@shiftcrypto.ch
Unsupported BitBox deviceMyEtherWallet only supports the BitBox02 Multi edition or the BitBox01. If you are using a BitBox02 Bitcoin-only edition, it is not compatible with MyEtherWallet because it does not support Ethereum.
Plug in BitBox02 and choose screen orientation by tapping one of the sides.Make sure BitBox02 is inserted into USB and powered. Choose orientation of BitBox02 by tapping one of the sides of the device. USB connection is only established after you choose the screen orientation.

Issue: BitBoxBridge not found

  1. To use MyEtherWallet, you need to download and install the BitBoxBridge
  2. If BitBoxBridge is already installed, make sure service is running by visiting http://127.0.0.1:8178/ in your browser. If the bridge is running you should see something like:
    BitBoxBridge v1.1.0
     GET /api/info
     GET /api/v1/devices
     GET/WS /api/v1/socket/:socket
    

    If the bridge is not running, please follow the instructions below to re-start it.

Windows

  1. In search bar type services
  2. Find bitbox-bridge
  3. Check it’s status.
  • If status is empty, right click on bitbox-bridge and click Start
  • To make sure the BitBoxBridge starts on boot, right click bitbox-bridge -> properties then select in startup type automatic

macOS

  1. Open Activity Monitor and search for the service bitbox-bridge.
    • If it is not listed there, then the bridge is not running.
  2. To restart the BitBoxBridge, select it in Activity Monitor, then click the “x” in the upper left corner. Alternatively do the following:
    • Open the Terminal
    • Insert the following commands:
    • To stop the bridge run: sudo launchctl unload /Library/LaunchDaemons/ch.shiftcrypto.bitboxbridge.plist
    • To re-start the bridge run: sudo launchctl load /Library/LaunchDaemons/ch.shiftcrypto.bitboxbridge.plist
  • Log files are in /opt/shiftcrypto/bitbox-bridge/logs

Linux:

  1. To see the status: $ systemctl status bitbox-bridge
    • You should see something like:
      bitbox-bridge.service - Shiftcrypto BitBoxBridge
      Loaded: loaded (/usr/lib/systemd/system/bitbox-bridge.service; enabled; vendor preset: enabled)
      Active: active (running) since Fri 2020-02-07 22:58:31 CET; 24s ago
       Main PID: 4556 (bitbox-bridge)
       Tasks: 6 (limit: 4915)
      Memory: 4.4M
      CGroup: /system.slice/bitbox-bridge.service
        	└─4556 /opt/bitbox-bridge/bin/bitbox-bridge
      
  2. To stop the bridge run: $ sudo systemctl stop bitbox-bridge
  3. To re-start the bridge run: $ sudo systemctl start bitbox-bridge