firmware/unix

Coldcard Desktop Simulator

Usage

make && ./simulator.py

Other Startup Flags

The default is to boot up, skip the tedious PIN entry step, and start as a functional wallet (on testnet, always with the same seed). But there are other options:

• -w => like a factory-fresh unit; no PIN no secrets
• -l => PIN is set (12-12) but no secret yet
• -2 => enable a secondary wallet, with pin 33-33 and no secret
• -q => boot and drop into REPL; does nothing else, no setup
• -f -w => boot like a unit that hasn't left factory yet

See frozen-modules/sim-settings.py for the details.

Requirements

• uses good olde xterm for console input and output
• this directory has additional requirements.txt (a superset of other requirements of the project)
• run "brew install sdl2" before/after doing python requirements
• run "make setup" then "make"
• then "./simulator.py"

MacOS building

• Follow instructions on https://github.com/micropython/micropython

• probably: brew install libffi if not already present

• to get pkg-config libffi to output useful things, need this:

  setenv PKG_CONFIG_PATH /usr/local/opt/libffi/lib/pkgconfig

• but that's in the Makefile now

Other OS

• sorry we haven't gotten around to that yet, but certainly would be possible to build this on Linux or FreeBSD... but not Windows.