TornadoCash/docs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #1 from RumaDas1/master

Browse Source 
Tornado Cash User Guide
This commit is contained in:
Roman Storm 2021-04-16 12:16:22 +05:00 committed by GitHub
commit f620dfa136
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 154 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
How To Access The Tornado Cash In Goerli Network.md Normal file
View File

@ -0,0 +1,29 @@
# How To Access The Tornado Cash In Goerli Network
Welcome everyone to the Tornado Cash testnet, and thank you for your interest in participating in the pilot phase of the application. The application is available for testing in the Goerli Network. In this article, we will explain to you in detail how you can test and use the Tornado Cash testnet platform in the Goerli network.
The prerequisite for testing the application is testnet is listed below. Please follow the below steps:
## Prerequisites for Goerli Test Network
- Test ETH that can be claimed from the Goerli faucet
- Test TORN, provided by the project team (not mandatory)
- Set your network in the Metamask wallet to **“Goerli Test Network”**
### Step 1: Receive test ETH token in your Wallet
Users can request the test ETH tokens from the Goerli network faucet.
Go to the **[Goerli faucet](https://goerli-faucet.slock.it/)**, enter your ethereum address, and just hit the Request button. You will receive your test ETH tokens shortly at your wallet address.
![goerli faucet](https://siasky.net/XADTOSmJfX6bQVhZ5-ZRivkzCPloyiHLHdShM8wsZNxM1Q)
### Step 2: Get Test TORN Token
The TORN token is not mandatorily required to test the application and it's working. You can use Ethereum (ETH) and examine the Tornado Cash application in testnet.
However, if you want, you can request and get the test TORN token from the project team. Once received, open your Metamask wallet and check for the tokens.
If you are using this token for the first time, then the token will not be directly visible to you in the wallet, and you have to add it manually. You can add the token contract address manually by going to the **Custom Token** tab.
**TORN Contract Address - 0x77777feddddffc19ff86db637967013e6c6a116c**
![user wallet](https://siasky.net/TAD5yMM_XuB3BGv0jP0plWg01qrMSgOeivR4N_7KOOVL7g)
We now have the test ETH and test TORN tokens in our Metamask wallet. We can proceed with testing and depositing tokens into the Tornado application.
### Step 3: Select the network as Goerli Network
As we have mentioned earlier that the Tornado Cash application is available in the Georli network, so set up your network connection to the Goerli network as shown in the above screenshot. [](https://)

79
How To Make A Deposit In Tornado Cash.md Normal file
View File

@ -0,0 +1,79 @@
# How To Make A Deposit In Tornado Cash
To improve privacy, Tornado cash breaks the on-chain link between the source and the destination address. The platform uses a smart contract that accepts ETH deposits. Whenever the user wishes to deposit, he/she generates a secret and sends its hash (called a commitment) along with a deposit amount to the Tornado smart contract. The contract accepts the deposit and adds the commitment to its list of deposits.
## Usage Guide
Go to the Tornado Cash **[webpage](https://tornado.cash/)**.
The landing page looks like this.
![webpage](https://siasky.net/DADgpg5vPOF5JPwOxlFwYXPzT8vRFlR9leCDWqMBIWR9yg)
Click on **Launch App** and it will redirect you to the **[page](https://app.tornado.cash/account)**
![wallet](https://siasky.net/KABpV33X84PCitszZpwa4thYvYOxPHw29Qlx0UqKxf4ioQ)
Connect your Web3 (Metamask) wallet.
### Note Account
Once you have connected your Metamask wallet, the next thing you are required to do is to set up the **Note account**.
The Note Account key is used to encrypt and store your tornado.cash private notes on the ethereum blockchain.
![Note account](https://siasky.net/NAD6aVPWNrE4n1cUknhwZinCGWdCf8WlzBe2H_82i9G9CQ)
Click on **Setup Account**.
![setup account](https://siasky.net/BABEIuEBVLR7kgiE6pOxVCKjIDgjdqK9mystttsRVzprhA)
The application will show your Note Account key that you need to store safely. **Do not share your account key details with anyone**.
![account setup](https://siasky.net/bAAPlh2vU89f5mFkssIFGLhXZJTPHivQDlrrWm0m-yn5ZQ)
Click on **Setup account** and a Metamask transaction is triggered. Confirm the transaction.
Once the transaction is finished, you can see your Note Account is successfully set up.
![note account set](https://siasky.net/HAA4u3D5HkdPlE1de6e2n0NbKg4ANoW_qL5WBY0yGlE6gg)
The basic account setup is done. We can now proceed with Deposit.
### Deposit
To maintain a high level of anonymity,one of the method that Tornado cash uses is that it allows users to deposit only a fixed token value.
Once you go to the **Deposit** tab and select the token you want to deposit, you will find that you are allowed to deposit some fixed token value. For example, in the case of ETH, you can deposit only 0.1 ETH, 1 ETH, 10 ETH, or 100 ETH.
![deposit](https://siasky.net/FAC3nA1tU50pw9JVeqLUy6TP5Cow42uhKp7pbtVrh20-gw)
The Statistics section will show you the list of the latest deposits with the selected denomination.
**Important:** Kindly note that the project is still in the experimental phase. Use at your own risk.
To **Deposit**, select the token and the amount that you wish to deposit. The application will then ask you to save your note file (.txt). This note file can be used later to withdraw your deposit.
![send deposit](https://siasky.net/zACyy3T6bauKX5jrch1N5Nt3Hr3sK13JcAZyg7CGDNAVOA)
Click on **Send Deposit** and confirm the Metamask transaction.
You can now see your deposit transactions will be added in the Statistics section.
![statistics](https://siasky.net/rADt7GRpcVllIhlIoAiUpeqDoKUfVYFhXTiklNLMlXn31w)
From the bottom of the tab, you can check your deposit transactions along with other key details like:
- Your Deposit amount
- Any subsequent deposit after your transaction with the same denomination
- Transaction Hash
- Transaction status
- Rewards Earned
- Note
![deposit details](https://siasky.net/OADOPSot2Tx_FAvtqKJz-jFwkUKbeqtG8YD2z4zNz7YTSA)
The rewards section shows the Anonymity Point (AP) that a user earns for depositing and withdrawing from the ETH anonymity pool. You can earn more AP for staying longer in the pool.
The Note can be used to withdraw the funds. We will explain in detail how you can use the Note to withdraw your funds in the Withdraw section.

46
How To Withdraw From Tornado Cash.md Normal file
View File

@ -0,0 +1,46 @@
# How To Withdraw From Tornado Cash
Users can withdraw their tokens from the Tornado cash platform at any time but to ensure high-level privacy it is recommended to wait until there are a few deposits after yours.
For Withdraw, users are required to provide two details:
- Note
- Recipient Address
![wihdraw button](https://siasky.net/IAA0oMfBCz3vPgANvIUsGBS84y4eC0DFgrbuVWVDwX5i9Q)
Fill in the mandatory details. You can get the Note details from the deposit transaction.
Once your fill in the note details, all details about your deposit get displayed.
![withdraw details](https://siasky.net/TAB6fl4n3yj1f_cd59CzRUEap6QvaPe3fslWThwC6KWBlQ)
From the Withdraw setting tab, you can choose two options for withdrawal:
- Via Relayer
- Web3 wallet
You can choose the withdrawal method as Wallet but for that, you need to have a completely new Ethereum address with some ETH on it. But getting some ETH will eventually lead to the loss of anonymity.
![withdraw wallet](https://siasky.net/MACMuLY11IK0h2b1MON8k0gUjZHLNVqwDYdX5tW9-npAhw)
Thus, it is recommended to choose the withdrawal method as Relayer. A relayer is used to preserve privacy. With Relayer, there is no way to link a connection between the withdrawal and the deposit addresses.
![relayer](https://siasky.net/MAALGPo1Emw_K_-y6t6EaB6Ao--NPnSuIQfTfqI28qSUCw)
Once you select this method to withdraw, your zk-Snark proof gets generated.
The zkSnark technology is a method that helps the users to verify that they possess a secret to an unspent commitment from the list of deposit smart contracts without actually revealing the exact deposit corresponds to a secret.
![confirmation](https://siasky.net/GADcmOqr30fMXl7neBtSR6knAzPg8x_4mxQtUt96dQSa1w)
Confirm the process.
You can now see the withdrawal transaction details at the bottom.
One interesting thing you can note here is that the user’s reward is continuously increasing.
![final withdraw detail](https://siasky.net/KAAxcbm5QgjFr7mTKFqBU8uVKKNHKsaWz3-m85iQOP-6kg)
To cross- verify the anonymity, click on the transaction hash and check the ethereum addresses mentioned on the log.
![txn hash](https://siasky.net/DADzeQWIwr8CkZIRyLyUJTzs8kdve1kNlvOwwc6WBz8gqg)
You can easily check that the source address is something different from your wallet address.
Also, no transaction details will appear in the destination wallet address.
![metamask activity](https://siasky.net/VAAJZImmqf15RxJJp3nbgSrKUPaFpljsh6pQyvpxZavdIw)
As a good practice, it is recommended to destroy the note data once you have successfully withdrawn your funds.