Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
September 3, 2023 19:02
October 30, 2019 13:55
August 17, 2023 00:59
September 3, 2023 19:02
June 6, 2019 23:19
October 8, 2019 15:35


The BitBox02 is a hardware wallet that simplifies secure handling of crypto coins through storing private keys and signing transactions. The content of this repository is the bootloader and firmware used on the device. The BitBox02 is meant to be used primarily with the BitBoxApp, although third party integration is possible through the BitBox02 API.

The main functionality of the firmware is the following:

  • Safely receive and send coins.
  • Interacting with the user through touch sliders and a display.
  • Back up the seed to a microSD card.
  • Back up the seed by displaying the BIP39 mnemonic encoding on the screen.
  • Import 12, 18 or 24 word BIP39 mnemonics
  • Generate a random seed from multiple strong sources of entropy.
  • Protect the seed from attackers.
  • Derive keys from the seed according to BIP39 and BIP32.
  • Return the extended public key for a keypath so that the app can find all unspent transaction outputs.
  • Display the receive address for the keypath, coin and script/address type.
  • Display the receive address, transaction amount and network fee and sign each input after confirmation.


The main chip on the device is the microcontroller from Microchip (ATSAMD51J20A). This chip is used for communication to the BitBoxApp via USB, to the user via the sliders and to the secure element (ATECC608B) via I2C.


The sliders along the edges of the device are used for user input. There are three input gestures:

  • Tap
  • Slide
  • Hold to confirm


The USB communication is implemented using the request-response pattern with encrypted protobuf messages. The encryption protocol used is Noise with out-of-band authentication.

Hardware docs

PCB schematics v2.1

PCB bill of materials (BOM) v2.1

PCB x-ray v2.1


The instructions for setting up a development environment can be found in Please also read our before filing issues and pull requests.

Installing/upgrading firmware

There are two main ways to install or upgrade firmware on a BitBox02:

  1. by running the BitBoxApp
  2. by running ./py/ after installing the bitbox02 Python package, e.g. ./py/ firmware-btc.v9.12.0.signed.bin.

Reporting a vulnerability

See our security policy.