post-censorship guide

general/guides/post-censorship.md

@@ -0,0 +1,122 @@
+
+# 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.
+
+-------
+### LANGUAGE:&nbsp;&nbsp;&nbsp;|<ul class="langs"><li class="lang-p">ENG*</li><li class="lang-p"><a href="https://hackmd.io/@gozzy/tornado-cash-制裁后教程">ZH</a></li><li class="lang-p"><a href="https://hackmd.io/@gozzy/tornado-cash-tras-la-censura">ES</a></li><li class="lang-p"><a href="https://hackmd.io/@gozzy/tornado-cash-после-цензуры">RU</a></li></ul>
+--------
+
+## Community build
+
+_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)
+
+**See [instructions on RPC configuration](#RPC) if transacting with sanctioned addresses**.
+
+### ENS resolvers
+
+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)
+
+
+### TOR network
+
+**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)
+
+### IPFS details
+
+
+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`
+
+
+### Local IPFS deployment (recommended)
+
+* 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
+
+### IPFS gateway usage
+
+* 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
+
+
+## RPC
+
+-------
+### LANGUAGE:&nbsp;&nbsp;&nbsp;|<ul class="langs"><li class="lang-p">ENG*</li><li class="lang-p"><a href="https://hackmd.io/@gozzy/tornado-cash-制裁后教程">ZH</a></li><li class="lang-p"><a href="https://hackmd.io/@gozzy/tornado-cash-tras-la-censura">ES</a></li><li class="lang-p"><a href="https://hackmd.io/@gozzy/tornado-cash-после-цензуры">RU</a></li></ul>
+--------
+
+* 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.
+
+* 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. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ![](https://i.imgur.com/zOwfk4k.gif)
+
+* Sometimes visiting the application you could be greeted with the following message, to fix this click "OPEN SETTINGS". &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;![](https://i.imgur.com/xcNzhNG.png)
+
+* You'll then be displayed a dropdown selection, defaulted to a selection. Click on it and select the "Custom" option. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ![](https://i.imgur.com/zrY5GEi.png)
+
+* Here enter a non-censoring RPC provider depending on your network and this will resolve application issues.
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;![](https://i.imgur.com/dE13HsA.png)
+
+
+* Then you are freely able to withdraw, deposit, stake or participate in decentralised governance like nothing ever happened.
+
+<style>
+    .langs {
+        width: calc(79% - 50px);
+        list-style-type: none;
+        display: inline-block;
+        padding: 0px !important;
+        margin: 0px !important;
+        margin-bottom: -5px !important;
+    }
+
+    .lang-p {
+        float:left;
+        margin-left: 10%;
+        padding: 0px !important;
+    }
+
+    .lang-p:after {
+        content: "|";
+        margin-left: 4rem;
+    }    
+</style>