docs/general/guides/post-censorship.md

132 lines
6.2 KiB
Markdown
Raw Normal View History

2023-01-28 15:11:19 +03:00
# Tornado Cash usage post-censorship
This is a guide to using Tornado Cash after the 8th August crisis, when the OFAC decided to sanction the organisation and the smart contracts. This led to a widespread wave of censorship from middleware service providers, resulting in users being vulnerable and unable to access their assets.
2023-02-01 00:20:12 +03:00
--------
2023-02-01 01:26:47 +03:00
<h4>LANGUAGE:&nbsp;&nbsp;<a href="https://hackmd.io/@gozzy/tornado-cash-制裁后教程">ZH</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="https://hackmd.io/@gozzy/tornado-cash-tras-la-censura">ES</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="https://hackmd.io/@gozzy/tornado-cash-после-цензуры">RU</a>&nbsp;&nbsp;</h4>
2023-02-01 00:20:12 +03:00
--------
2023-01-28 15:11:19 +03:00
2023-02-01 00:20:12 +03:00
### Community build
2023-01-28 15:11:19 +03:00
_The source code for the community build can be found on [the offical community git](https://development.tornadocash.community/tornadocash/classic-ui). For a tutorial on how to audit the changes [see Micah's guide](https://notes.ethereum.org/@GW1ZUbNKR5iRjjKYx6_dJQ/Bk8zsJ9xj)_.
* Current build version: **ea97a39**
* Changelog: [#003](https://development.tornadocash.community/tornadocash/classic-ui/pulls/10)
2023-01-28 19:55:19 +03:00
**See [instructions on RPC configuration](#RPC) if transacting with sanctioned addresses**
2023-01-28 15:11:19 +03:00
2023-02-01 00:20:12 +03:00
#### ENS resolvers
2023-01-28 15:11:19 +03:00
The latest community builds are available at:
* Classic:
* [tornadocash.3th.ws](https://tornadocash.3th.ws) (recommended)
* [tornadocashcommunity.eth.link](https://tornadocashcommunity.eth.link)
* Nova:
* [nova.tornadocash.3th.ws](https://nova.tornadocash.3th.ws) (recommended)
* [nova.tornadocashcommunity.eth.link](https://nova.tornadocashcommunity.eth.link)
2023-02-01 00:20:12 +03:00
#### TOR network
2023-01-28 15:11:19 +03:00
**Browser history must be enabled when using TOR browser for event caching**.
It is now possible to access the builds via onion hidden services with the community resolver (3th.ws), if there is no response see the [network status page](https://status.torproject.org/) for possible disruption.
* [onion.tornadocash.3th.ws](https://onion.tornadocash.3th.ws)
* [fueywrkuuqfikscslaavck762p6xr7fiiakrb2uy3acne4z67jeanqid.onion](https://fueywrkuuqfikscslaavck762p6xr7fiiakrb2uy3acne4z67jeanqid.onion)
* [onion.nova.tornadocash.3th.ws](https://onion.nova.tornadocash.3th.ws)
* [y7ghfvm6jlgfvx25sy5l7muvqnqkw37jjbmzbikpn6sfma65dp3qysqd.onion](https://y7ghfvm6jlgfvx25sy5l7muvqnqkw37jjbmzbikpn6sfma65dp3qysqd.onion)
2023-02-01 00:20:12 +03:00
#### IPFS details
2023-01-28 15:11:19 +03:00
To get the IPFS content hash and link from the domain details. Visit the ENS application domain page at either:
* Classic: [tornadocash.eth](https://app.ens.domains/name/tornadocash.eth/details)
* Nova: [nova.tornadocash.eth](https://app.ens.domains/name/nova.tornadocash.eth/details)
The IPFS link for Classic (tornadocash.eth) for example, will look like:
```
ipfs://bafybeiguelxw5aanwnhvaea5vjhknmcdmwvujne36wgabnkmcbt3563toa
```
The content hash of this link is `bafybeiguelxw5aanwnhvaea5vjhknmcdmwvujne36wgabnkmcbt3563toa`
2023-02-01 00:20:12 +03:00
#### Local IPFS deployment (recommended)
2023-01-28 15:11:19 +03:00
* Brave
* Navigate to the IPFS link in the browser
* When prompted, choose “Use a Brave local IPFS node”
* Chrome / Firefox
* Install IPFS Desktop
* Install IPFS Companion extension ([Chrome](https://chrome.google.com/webstore/detail/ipfs-companion/nibjojkomfdiaoajekhjakgkdhaomnch?hl=en) / [Firefox](https://addons.mozilla.org/en-US/firefox/addon/ipfs-companion/))
* Ensure IPFS Desktop is open and has an internet connection
* Navigate to the IPFS link in the browser
2023-02-01 00:20:12 +03:00
#### IPFS gateway usage
2023-01-28 15:11:19 +03:00
* Take the content hash and prefix it followed by a `.` to one of the following IPFS gateways:
* `ipfs.dweb.link`
* https://bafybeiguelxw5aanwnhvaea5vjhknmcdmwvujne36wgabnkmcbt3563toa.ipfs.dweb.link
* `ipfs.tornadocash.is` (community gateway)
* https://bafybeiguelxw5aanwnhvaea5vjhknmcdmwvujne36wgabnkmcbt3563toa.ipfs.tornadocash.is
* `ipfs.cf-ipfs.com`
* https://bafybeiguelxw5aanwnhvaea5vjhknmcdmwvujne36wgabnkmcbt3563toa.ipfs.cf-ipfs.com
2023-02-01 00:20:12 +03:00
### RPC
2023-01-28 15:11:19 +03:00
--------
2023-02-01 00:20:12 +03:00
<h4>LANGUAGE:&nbsp;&nbsp;<a href="https://hackmd.io/@gozzy/tornado-cash-制裁后教程">ZH</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="https://hackmd.io/@gozzy/tornado-cash-tras-la-censura">ES</a>&nbsp;&nbsp;|&nbsp;&nbsp;<a href="https://hackmd.io/@gozzy/tornado-cash-после-цензуры">RU</a>&nbsp;&nbsp;</h4>
--------
2023-01-28 15:11:19 +03:00
* If you want to deposit you may have to change your wallet RPC, as most providers have censored the smart contracts. One of these providers is Infura, which Metamask uses by default.
2023-01-28 18:13:01 +03:00
* Try searching for a working endpoint on [Chainlist](https://chainlist.org/), which could take multiple attempts (take note of the ChainID for network configuration). An example of how to change your RPC provider for MetaMask is shown below.
2023-02-01 00:20:12 +03:00
![](/.gitbook/assets/zOwfk4k.gif)
2023-01-28 18:13:01 +03:00
* Sometimes visiting the application you could be greeted with the following message, to fix this click "OPEN SETTINGS".
2023-01-28 15:11:19 +03:00
2023-02-01 00:20:12 +03:00
![](/.gitbook/assets/xcNzhNG.png)
2023-01-28 15:11:19 +03:00
2023-01-28 18:13:01 +03:00
* You'll then be displayed a dropdown selection, defaulted to a selection. Click on it and select the "Custom" option.
2023-02-01 00:20:12 +03:00
![](/.gitbook/assets/zrY5GEi.png)
2023-01-28 15:11:19 +03:00
* Here enter a non-censoring RPC provider depending on your network and this will resolve application issues.
2023-01-28 18:13:01 +03:00
2023-02-01 00:20:12 +03:00
![](/.gitbook/assets/dE13HsA.png)
2023-01-28 15:11:19 +03:00
* Then you are freely able to withdraw, deposit, stake or participate in decentralised governance like nothing ever happened.
2023-02-01 00:20:12 +03:00
### FAQ
> Why do I keep recieving the error `Failed to fetch relayers`?
* This error is either related to a poor connection or a result of no available relayers on your network. It usually can be solved by refreshing.
> Why do I keep recieving the error `Failed to fetch proving keys`?
* This error is either related to a poor connection, it usually can be solved by refreshing or changing VPN location for better latency.
> Why do I keep recieving the error `Failed to fetch all deposit events` when trying to withdraw?
* This error is related to a poor connection or using a censored RPC endpoint. To resolve this either:
* change VPN location for better latency
* try a new browser or method of access
* configure the application RPC configuration to an alternative
> Why can't make a deposit from my wallet?
* Most RPCs censor transactions to the protocol and governance since the OFAC sanctions, you need to configure your wallet RPC to a uncensored endpoint.