# joinmarket-clientserver JoinMarket is software to create a special kind of bitcoin transaction called a CoinJoin transaction. It's aim is to improve the confidentiality and privacy of bitcoin transactions. A CoinJoin transaction requires other people to take part. The right resources (coins) have to be in the right place, at the right time, in the right quantity. This isn't a software or tech problem, its an economic problem. JoinMarket works by creating a new kind of market that would allocate these resources in the best way. One group of participants (called market makers) will always be available to take part in CoinJoins at any time. Other participants (called market takers) can create a CoinJoin at any time. The takers pay a fee which incentivizes the makers. A form of smart contract is created, meaning the private keys will never be broadcasted outside of your computer, resulting in virtually zero risk of loss (aside from malware or bugs). As a result of free-market forces the fees will eventually be next to nothing. Widespread use of JoinMarket improves bitcoin's fungibility and privacy. This implementation of JoinMarket also implements [PayJoin](https://en.bitcoin.it/wiki/PayJoin). For a quick introduction to Joinmarket you can watch [this demonstration](https://youtu.be/hwmvZVQ4C4M) of installation and usage given by [Adam Gibson](https://github.com/AdamISZ) during the [Understanding Bitcoin conference](https://understandingbtc.com/) on April 6 2019. ### Wallet features * Segwit addresses in the backward compatible form (start with `3`) * Multiple "mixdepths" or pockets (by default 5) for better coin isolation * Ability to spend directly, or with coinjoin; export private keys; BIP49 compatible seed (Trezor, Samourai etc.) and mnemonic extension option * Fine-grained control over bitcoin transaction fees * Basic coin control - can freeze individual utxos to stop them being spent in any transaction * Can run sequence of coinjoins in automated form, either auto-generated (see `tumbler.py`) or self-generated sequence. * Can specify exact amount of coinjoin (figures from 0.01 to 30.0 btc and higher are practical), can choose time and number of counterparties * Can run passively to receive small payouts for taking part in coinjoins (see "Maker" and "yield-generator" in docs) * GUI to support Taker role, including tumbler/automated coinjoin sequence. * PayJoin - more economical and private payments between Joinmarket wallets. * Protection from [forced address reuse](https://en.bitcoin.it/wiki/Privacy#Forced_address_reuse) attacks. ### Quickstart - RECOMMENDED INSTALLATION METHOD (Linux only) Once you've downloaded this repo, either as a tar/zip file, and extracted it, or via `git clone`: Make sure to validate the signature on the tar/zip file provided on the [release page](https://github.com/Joinmarket-Org/joinmarket-clientserver/releases), or check the signature in git if you install that way using `git log --show-signature`. ./install.sh (follow instructions on screen; provide sudo password when prompted) source jmvenv/bin/activate cd scripts (You can add `--develop` as an extra flag to `install.sh` to make the Joinmarket code editable in-place.) You can optionally install a Qt GUI application, you will be prompted to choose this during installation. Do note, Python 2 is no longer supported as it has reached its end of life. You should now be able to run the scripts like `python wallet-tool.py` etc., just as you did in the previous Joinmarket version. Alternative to this "quickstart": follow the [install guide](docs/INSTALL.md). ### More installation guides * Installation on MacOS or Windows. Follow [this install guide](docs/INSTALL.md). * [Installation guide for RaspiBlitz](https://github.com/openoms/bitcoin-tutorials/blob/master/joinmarket/README.md). * [Installation guide for RaspiBolt](https://github.com/kristapsk/raspibolt-extras/blob/master/joinmarket.md). * [Installation guide for Qubes+Whonix](https://github.com/qubenix/qubes-whonix-bitcoin/blob/master/1_joinmarket.md). * [Youtube video installation tutorial for Ubuntu](https://www.youtube.com/watch?v=zTCC86IUzWo). ### Usage If you are new, follow and read the links in the [usage guide](docs/USAGE.md). If you are running Joinmarket-Qt, you can instead use the [walkthrough](docs/JOINMARKET-QT-GUIDE.md) to start. If you used the old version of Joinmarket, the notes in the [scripts readme](scripts/README.md) help to understand what has and hasn't changed about the scripts. ### PayJoin If you want to use the PayJoin feature to pay/receive money to/from another Joinmarket wallet user, read [this guide](docs/PAYJOIN.md). ### Joinmarket-Qt Provides single join and multi-join/tumbler functionality (i.e. "Taker") only, in a GUI. If binaries are built, they will be gpg signed and announced on the Releases page. If you haven't chosen the Qt option during installation with `install.sh`, then to run the script `joinmarket-qt.py` from the command line you will need to install two more packages. Use these 2 commands while the `jmvenv` virtual environment is activated: ``` pip install -r requirements/gui.txt ``` After this, the command `python joinmarket-qt.py` from within the `scripts` subdirectory should work. There is a [walkthrough](docs/JOINMARKET-QT-GUIDE.md) for what to do next. ### Architecture notes See [architecture-notes.md](docs/architecture-notes.md). ### TESTING Instructions for developers for testing [here](docs/TESTING.md). If you want to help improve the project, please have a read of [this todo list](docs/TODO.md) and the [Help Wanted tag](https://github.com/JoinMarket-Org/joinmarket-clientserver/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) on the issue tracker. ### Community + IRC: `#joinmarket` on irc.freenode.net https://webchat.freenode.net/?channels=%23joinmarket + IRC on tor: `#joinmarket` on the networks [Hackint](https://www.hackint.org/) and [Darkscience](https://www.darkscience.net/). These channels are bridged to the above freenode channel. + Bitcoin wiki page: https://en.bitcoin.it/wiki/JoinMarket + Subreddit: https://reddit.com/r/joinmarket + Bitcointalk thread: https://bitcointalk.org/index.php?topic=919116.msg10096563 + Twitter: https://twitter.com/joinmarket ### Support JoinMarket and bitcoin privacy Donate to help make JoinMarket even better: [Obtain a bitcoin address here](https://bitcoinprivacy.me/joinmarket-donations) JoinMarket is an open source project which does not have a funding model, fortunately the project itself has very low running costs as it is almost-fully decentralized and available to everyone for free. Developers contribute only as volunteers and donations are divided amongst them. Many developers have also been important in advocating for privacy and educating the wider bitcoin user base. Be part of the effort to improve bitcoin privacy and fungibility. Every donated coin helps us spend more time on JoinMarket instead of doing other stuff. Old donation addresses: `bc1q5x02zqj5nshw0yhx2s4tj75z6vkvuvww26jak5` or `1AZgQZWYRteh6UyF87hwuvyWj73NvWKpL`. Signatures can be found [here](docs/signed-donation-address.txt). Ideally use the above https link to obtain a brand new address.