Go Up Number!

This is the user manual for Go up Number! — a command line Bitcoin wallet for plebs, degenerates and revolutionaries.

gun is the world's most fully featured stand alone command line bitcoin wallet. The main design goal of gun is for it to be fun! It might also be secure and stuff but we'll have to see. gun is beta quality in all respects. Thanks in advance for making the sacrifice of your time (and perhaps coins!) while testing this software.

The defining feature of gun is the bet command which lets you do peer-to-peer betting by copy-pasting gibberish. Remember to only put in what you are willing to lose!


  • ✅ Peer-to-peer betting
  • ✅ Easily setup with ColdCard
  • ✅ PSBT & Descriptor based wallet
  • ✅ BIP39 seedwords (incl. passphrase support)
  • ✅ Different output formats for writing tools against (JSON, tabs)
  • ✅ Easy to run inside VM or docker container
  • ☐ Single signer Taproot BIP86 signing (in progress 👷)
  • ☐ Threshold Multisig Schnorr signatures i.e. FROST (in research 🧪)
  • ☐ Make all HTTP requests through Tor with arti
  • ☐ Peer-to-Peer betting protocol using Taproot
  • ☐ Lightning payments with LDK
  • ☐ Demo of improved OP_CTV betting mailing list post on signet.
  • ☐ Coin selection issue#86
  • ☐ Fee bumping
  • ☐ WASM plugins/apps with wasmer
  • ☐ A user interface that is graphical


gun is written in rust and uses the Bitcoin Dev Kit (bdk) to implement the underlying wallet functionality1. It needs a trusted esplora backend server to provide blockchain data and by default it uses mempool.space.


gun is open source. It relies on the community to report and (if they can) fix bugs. Bugs aren't fun so please report them on the repository. Please help improve this book too.


Right now it uses a branch of bdk at llfourn/bdk.


Join us on Discord