Skip to content

Why this project exists

A hardware wallet is a small device that keeps the secret behind your bitcoin away from your computer. You can buy one, plug it in and use it without knowing how it works inside. That’s fine for everyday use, but it leaves the device a sealed box.

This project opens the box. You build a working signing device from common hobby boards, wire it yourself, flash its firmware, and watch it check and sign a real transaction on a test network. Every step is explained.

  • Curious beginners. You don’t need to know what a PSBT or a seed is yet. The glossary and these Learn pages explain the terms as they come up.
  • People who already own an ESP32 or two. The build uses an ESP32 DevKit, an ESP32-CAM and a 2.8” touch shield, boards many hobbyists have in a drawer. You may only need to buy what’s missing.
  • Anyone who wants to understand hardware wallets before trusting one with real money.
  • How a signer and a watch-only wallet split the work, so your seed never touches the computer.
  • How a transaction travels as an animated QR code across an air gap.
  • Why the camera board is connected by a wire that only carries data one way.
  • How a signer works out the amounts, fee and change itself, instead of trusting the computer.
  • How a seed can be used for one session and then wiped, without ever being saved.
  • The practical side: wiring boards, patching libraries, flashing two microcontrollers, and fixing what goes wrong.
  • It isn’t a replacement for a commercial or mature DIY wallet. Others are ahead in many ways: support for the real network (mainnet), more address types, reproducible builds, secure boot, and years of use and review.
  • It isn’t a new invention. Stateless seeds, QR-only data, SeedQR and on-device checks all come from earlier projects such as SeedSigner, Krux, Specter-DIY and Blockstream Jade. What this build adds is a way to learn the ideas by putting them together yourself, on hardware you may already have.
  1. How it works: the whole journey of a transaction, step by step.
  2. Security and limits: what the prototype protects against, and what it doesn’t.
  3. The build guide, which takes you from a box of parts to a signed transaction.