Coldcard Wallet

Coldcard is a Cheap, Ultra-secure & Opensource Hardware Wallet for Bitcoin and other crypto-currencies. Get yours at ColdcardWallet.com

Follow @COLDCARDwallet on Twitter to keep up with the latest updates and security alerts.

Check-out and Setup

Do a checkout, recursively to get all the submodules:

git clone --recursive https://github.com/Coldcard/firmware.git

Then:

cd firmware
git submodule update --init (if needed?)
brew install autogen
virtualenv -p python3 ENV
source ENV/bin/activate (or source ENV/bin/activate.csh based on shell preference)
pip install -r requirements.txt
cd unix; make setup && make; ./simulator.py
Desktop-based Coldcard simulator will open at this point, enjoy! Explore!
cd ../cli; pip install --editable .
cd ../stm32; make; make firmware-signed.dfu
The resulting file, firmware-signed.dfu can be loaded directly onto a Coldcard, using this command (already installed based on above)
ckcc upgrade firmware-signed.dfu

Which looks like this:

[ENV] [firmware/stm32 42] ckcc upgrade firmware-signed.dfu
675328 bytes (start @ 293) to send from 'firmware-signed.dfu'
Uploading  [##########--------------------------]   29%  0d 00:01:04

Code Organization

Top-level dirs:

shared

shared code between desktop test version and real-deal
expected to be largely in python, and higher-level

unix

unix (MacOS) version for testing/rapid dev
this is a simulator for the product

testing

test cases and associated data

stm32

embedded micro version, for actual product
final target is a binary file for loading onto hardware

external

code from other projects, ie. the dreaded submodules

stm32/bootloader

32k of factory-set code that you cannot change
however, you can inspect what code is on your coldcard and compare to this.

2.1 KiB Raw Permalink Blame History

Coldcard Wallet

Check-out and Setup

Code Organization

2.1 KiB

Raw Permalink Blame History