- Now that the overall code structure has been largely established, we welcome potential feature additions/improvements
- We are also actively seeking contributors to create walkthroughs/tutorials on building and using SeedSigner
- We are seeking a smaller group of more technical users to test new features and upcoming releases
Please contact @SeedSigner on Twitter/Telegram to inquire with any questions about contributing!
To build a SeedSigner, you will need:
- Raspberry Pi Zero (version 1.3 with no wireless capability)
- Waveshare 1.3" 240x240 pxl LCD (more info at https://www.waveshare.com/wiki/1.3inch_LCD_HAT)
- Pi Zero-conpatible camera (tested to work with the Aokin / AuviPal 5MP 1080p with OV5647 Sensor)
Notes:
- Other cameras with the above sensor module should work, but may not fit in the Orange Pill enclosure
- Choose the Waveshare screen carefully; make sure to purchase the model that has a resolution of 240x240 pixels
The easiest way to install the software is to download the "seedsigner_X_X_X.zip" file in the current release, extract the seedsigner .img file, and write it to a MicroSD card (at least 4GB in size or larger). Then install the MicroSD in the assembled hardware and off you go.
The Orange Pill enclosure design has been open-sourced! Check out the "Orange_Pill" folder in this repo. You'll need the following additional hardware to assemble it:
- 4 x F-F M2.5 spacers, 10mm length
- 4 x M2.5 pan head screws, 6mm length
- 4 x M2.5 pan head screws, 12mm length
The upper and lower portions of the enclosure can be printed with a conventional FDM 3D printer, 0.2mm layer height is fine, no supports necessary. The buttons and joystick nub should be produced with a SLA/resin printer (orient the square hole on the joystick nub away from the build plate). An overview of the entire assembly process can be found here:
- Calculate word 12/24 of a BIP39 seed phrase
- Create 24-word BIP39 seed phrase with 99 dice rolls
- Temporarily store up to 3 seed phrases while device is powered
- Native Segwit Multisig XPUB generation w/ QR display
- Scan and parse transaction data from animated QR codes
- Sign transactions & transfer XPUB data using animated QR codes
- Support for Bitcoin Mainnet & Testnet
- Responsive, event-driven user interface
- Only valid input letters appear during seed word entry (time-saver!)
- Built for compatibility with Specter-desktop, Sparrow and BlueWallet Vaults
- Current release takes ~50 seconds to boot before menu appears (be patient!)
- Always test your setup before transfering larger amounts of bitcoin (try testnet first!)
- Currently ONLY generating Native Segwit Multisig Xpubs
- (Holding the screen upside-down or at a slight angle can significantly reduce glare)
- Check out our "seedsigner" telegram group for community help / feedback: (https://t.me/joinchat/GHNuc_nhNQjLPWsS)
- If you think SeedSigner adds value to the Bitcoin ecosystem, please help me spread the word! (tweets, pics, videos, etc.)
- Support for single-signature XPUB generation / signing
- Support for BIP39 passphrases
- User-guided manual QR transcription to quickly input seed phrases
- Low/Med/High customizable QR density
- Other optimizations based on user feedback!
Begin by preparing a copy of the Raspberry Pi Lite operating system (https://www.raspberrypi.org/software/operating-systems/) on a MicroSD card. Their Raspberry Pi Imager tool makes this easy.
SeedSigner installation and configuration requires an internet connection on the device to download the necessary libraries and code. But because the Pi Zero 1.3 does not have onboard wifi, you have two options:
- Run these steps on a separate Raspberry Pi 2/3/4 or Zero W which can connect to the internet and then transfer the SD card to the Pi Zero 1.3 when complete.
- OR configure the Pi Zero 1.3 directly by relaying through your computer's internet connection over USB. See instructions here.
Connect a keyboard & monitor to the device or SSH into the Pi if you're familiar with that process.
On the Pi bring up its system config:
sudo raspi-config
Set the following:
Interface Options:Camera: enableSPI: enable
Localisation Options:Locale: arrow up and down through the list and select or deselect languages with the spacebar.en_US.UTF-8 UTF-8for US English
- WiFi settings (only necessary for the option #1 setup above)
Exit and reboot when prompted within the raspi-config interface.
Install these dependencies:
sudo apt-get update && sudo apt-get install -y wiringpi python3-pip python3-numpy python-pil libopenjp2-7 ttf-mscorefonts-installer git python3-opencv libzbar0 python3-picamera
Install the C library for Broadcom BCM 2835:
wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.60.tar.gz
tar zxvf bcm2835-1.60.tar.gz
cd bcm2835-1.60/
sudo ./configure
sudo make && sudo make check && sudo make install
cd ..
rm bcm2835-1.60.tar.gz
Download SeedSigner
git clone https://github.com/SeedSigner/seedsigner
Install python dependencies:
cd seedsigner
pip3 install -r requirements.txt
Modify the systemd to run SeedSigner at boot:
sudo nano /etc/systemd/system/seedsigner.service
Add the following contents to the file:
[Unit]
Description=Seedsigner
[Service]
User=pi
WorkingDirectory=/home/pi/seedsigner/src/
ExecStart=/usr/bin/python3 main.py
Restart=always
[Install]
WantedBy=multi-user.target
Use Control + O, then [enter], to write the file. Then use Control + X, to exit the program.
Run sudo systemctl enable seedsigner.service to enable service on boot. (This will restart the seedsigner code automatically at startup and if it crashes.)
(Optional) Modify the system swap configuration to disable virtual memory:
sudo nano /etc/dphys-swapfile
Change CONF_SWAPSIZE=100 to CONF_SWAPSIZE=0
Use Control + O, then [enter], to write the file. Then use Control + X, to exit the program.
If you completed these steps on a separate Pi (option #1), shut down the pi with sudo shutdown --poweroff now and then transfer the SD card to the Pi Zero 1.3 (note: the LCD Hat will also run fine on a Raspberry Pi 2/3/4 or Zero W; just remember to disable networking if you want to run the software in isolation).
OR if you're working directly on the Pi Zero 1.3 (option #2), just reboot it:
sudo reboot
It will take about a minute after the Pi is powered on for the GUI to launch -- be patient!
Reminder: If you used option #2, return the guide to remove the internet access over USB configuration.
see: tests/README.md