Skip to content

Commit

Permalink
Update CSPP instructions for DCR 2.0+
Browse files Browse the repository at this point in the history
  • Loading branch information
dajohi authored and jholdstock committed Jun 26, 2024
1 parent 1f8956f commit d1461b8
Showing 1 changed file with 6 additions and 28 deletions.
34 changes: 6 additions & 28 deletions docs/privacy/cspp/how-to-cspp.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,18 +4,7 @@

To use CSPP, several new options must be set in `dcrwallet`.

Regardless of the intended setup, users must create two new accounts, `mixed` and `unmixed`, and point their wallets to Decred's CSPP servers:

Mainnet

- Download the CSPP server [TLS certificate](https://mix.decred.org/mix.decred.org.pem)
- Reference the certificate file using `--csppserver.ca=mix.decred.org.pem`
- Point `dcrwallet`to the CSPP mainnet server by setting `--csppserver=mix.decred.org:5760`

Testnet

- Testnet does **not** use the TLS certificate
- Point `dcrwallet` to the CSPP testnet server by setting `--csppserver=mix.decred.org:15760`
Users must create two new accounts, `mixed` and `unmixed`.

---

Expand All @@ -28,10 +17,9 @@ Solo stakers are recommended to use two wallets to separate ticket buying and vo
Use the following options for a mainnet mixed solo ticket buyer which continues to buy more tickets from the mixed account as outputs mature:

```no-highlight
$ dcrwallet --csppserver=mix.decred.org:5760 \
--csppserver.ca=mix.decred.org.pem \
--enableticketbuyer --purchaseaccount=mixed --mixedaccount=mixed/1 \
--changeaccount=unmixed --ticketbuyer.votingaccount=voting --mixchange
$ dcrwallet --mixing --enableticketbuyer --purchaseaccount=mixed \
--mixedaccount=mixed/1 --changeaccount=unmixed \
--ticketbuyer.votingaccount=voting --mixchange
```

---
Expand Down Expand Up @@ -62,8 +50,7 @@ buyer1$ dcrctl --wallet importxpub mixed mixed-xpub
The mixed ticket buying wallet may use the setup from the previous section. The old wallet must be configured slightly differently:

```no-highlight
buyer1$ dcrwallet --csppserver=mix.decred.org:5760 \
--csppserver.ca=mix.decred.org.pem \
buyer1$ dcrwallet --mixing \
--enableticketbuyer --purchaseaccount=default --mixedaccount=mixed/0 \
--ticketsplitaccount=default --changeaccount=unmixed \
--ticketbuyer.votingaccount=voting --mixchange
Expand All @@ -87,8 +74,7 @@ Change outputs in the CoinJoin are not anonymous, and can easily be traced back
These features are enabled with the following config:

```no-highlight
$ dcrwallet --csppserver=mix.decred.org:5760 \
--csppserver.ca=mix.decred.org.pem \
$ dcrwallet --mixing \
--mixedaccount=mixed/1 --changeaccount=unmixed --mixchange
```

Expand All @@ -98,14 +84,6 @@ Non-stakers are able to use this mechanism to mix received funds by using the un

---

## Tor Hidden Service

The CSPP server is accessible as a Tor hidden service, which provides two-way anonymity. The server doesn't know the IP of the client and the client also doesn't know the IP of the server. The latest onion address can be found at [CSPP server site](https://mix.decred.org/) and can be configured by using the `--csppserver` flag.

In case `dcrwallet` connects to `dcrd` directly, the `--nodcrdproxy=1` option may be specified in addition to the above.

---

## Further Information

For more technical information about CoinShuffle++, visit Decred’s [cspp](https://github.com/decred/cspp) Github repository. You can also read about CoinShuffle++ on [Decred’s blog](https://blog.decred.org/2019/08/28/Iterating-Privacy/).

0 comments on commit d1461b8

Please sign in to comment.