BitBox02: MyEtherWallet
Table of contents
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.
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.
Step 3: Start using MyEtherWallet with the BitBox02
- Go to myetherwallet.com
- Click âAccess My Walletâ then choose âHardwareâ.
- Select âBitBoxâ and then âBitBox02â.
- Unlock your BitBox02 by entering the password on the device.
- When using MyEtherWallet for the first time, you will be prompted with a pairing code.
- Confirm on your BitBox02 that the pairing code matches and select âContinueâ.
- Now select the account/address you want to use, accept the terms and click âAccess My Walletâ.
- 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:
Then confirm the address on your BitBox02.
Sending ETH and ERC-20 tokens
- 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.
- Then choose if you want to send ETH or an ERC-20 token. You can search for a token.
- Enter the amount.
- Enter the address you want to send to.
- Optionally edit the transaction fee settings.
- Click âSend Transactionâ.
- Then review the transaction details on the display of your BitBox02.
- If all is correct, confirm the transaction on your BitBox02, abort otherwise.
- 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 message | Proposed solution |
---|---|
BitBoxBridge not found | Please make you have downloaded and installed the BitBoxBridge. If it is already installed, make sure it is running by following these instructions. |
Unlock BitBox02 | Unlock the BitBox02 by entering your password on the device |
Unexpected error | Disconnect and reconnect the BitBox02 and try again. |
Action aborted by user | You cancelled a process on the BitBox02. Try again. |
Your BitBox02 is not initialised | Download and install the BitBoxApp to setup your BitBox02. |
Please upgrade to the newest firmware using Shift Cryptoâs BitBoxApp | Your 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 again | Reconnect 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 failed | Reconnect BitBox02 and try again. If you keep getting the warning. Please contact support@shiftcrypto.ch |
Unsupported BitBox device | MyEtherWallet 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
- To use MyEtherWallet, you need to download and install the BitBoxBridge
- 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
- In search bar type services
- Find bitbox-bridge
- 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
- Open Activity Monitor and search for the service bitbox-bridge.
- If it is not listed there, then the bridge is not running.
- 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:
- 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
- You should see something like:
- To stop the bridge run:
$ sudo systemctl stop bitbox-bridge
- To re-start the bridge run:
$ sudo systemctl start bitbox-bridge