Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Update CSPP instructions for DCR 2.0+ #1241

Merged
merged 1 commit into from
Jun 26, 2024
Merged

Update CSPP instructions for DCR 2.0+ #1241

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 6 additions & 28 deletions docs/privacy/cspp/how-to-cspp.md
View file
Open in desktop
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/).