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!
Features
- ✅ 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
Architecture
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.
Contributing
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.
Community
Join us on Discord