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

Compare commits

base: tornadocash:proposal-31
Branches Tags
tornadocash:master
tornadocash:proposal-31
tornadocash:en-archive
..
compare: tornadocash:master
Branches Tags
tornadocash:master
tornadocash:proposal-31
tornadocash:en-archive

5 Commits
proposal-3 ... master

Author SHA1 Message Date
Theo
ed72164dfa Merge pull request 'Correct deployments and add sepolia deployments' (#3) from tornadocontrib/docs:master into master 
Reviewed-on: #3
 2024-09-22 13:49:21 +03:00
tornadocontrib
3d5504049b
Correct deployments and add sepolia deployments 2024-09-22 02:33:54 +00:00
Theo
85922f7ce1 Revert ButterflyEffect malicious commit 
revert update ui version
 2024-06-10 23:52:43 +03:00
ButterflyEffect
1ee069e1c2 update ui version 2024-01-19 05:07:53 +00:00
ButterflyEffect
3de70fb3b2 update releyaer threshold 2024-01-19 04:50:45 +00:00
2 changed files with 45 additions and 12 deletions
Show Stats Expand all files Collapse all files

39
book/general/deployments.md
View File

@ -105,6 +105,39 @@ The following addresses are deployments of the [source code of Tornado Cash smar
| 1 WBTC | [0x776198CCF446DFa168347089d7338879273172cF](https://goerli.etherscan.io/address/0x776198CCF446DFa168347089d7338879273172cF) | | 1 WBTC | [0x776198CCF446DFa168347089d7338879273172cF](https://goerli.etherscan.io/address/0x776198CCF446DFa168347089d7338879273172cF) |
| 10 WBTC | [0xeDC5d01286f99A066559F60a585406f3878a033e](https://goerli.etherscan.io/address/0xeDC5d01286f99A066559F60a585406f3878a033e) | | 10 WBTC | [0xeDC5d01286f99A066559F60a585406f3878a033e](https://goerli.etherscan.io/address/0xeDC5d01286f99A066559F60a585406f3878a033e) |
* Sepolia
| Contract | Address |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| [DAI](https://staging.aave.com/faucet/) | [0xFF34B3d4Aee8ddCd6F9AFFFB6Fe49bD371b8a357](https://sepolia.etherscan.io/address/0xFF34B3d4Aee8ddCd6F9AFFFB6Fe49bD371b8a357) |
| Hasher | [0x20bc314FC55345d74235731B6C0Cd57ede6cdF2F](https://sepolia.etherscan.io/address/0x20bc314FC55345d74235731B6C0Cd57ede6cdF2F) |
| Verifier | [0xAE523682eB597e057acA3dC009161a122656F00e](https://sepolia.etherscan.io/address/0xAE523682eB597e057acA3dC009161a122656F00e) |
| TORN | [0x3AE6667167C0f44394106E197904519D808323cA](https://sepolia.etherscan.io/address/0x3AE6667167C0f44394106E197904519D808323cA) |
| GovernanceProxy | [0xe5324cD7602eeb387418e594B87aCADee08aeCAD](https://sepolia.etherscan.io/address/0xe5324cD7602eeb387418e594B87aCADee08aeCAD) |
| GovernanceV5 | [0x27fb0722D38996ff3ffa2F65a959Ec2Cd95C9525](https://sepolia.etherscan.io/address/0x27fb0722D38996ff3ffa2F65a959Ec2Cd95C9525) |
| GovernanceVesting | [0x488F1d0135eF240D4594273AA5E05782c5d39De1](https://sepolia.etherscan.io/address/0x488F1d0135eF240D4594273AA5E05782c5d39De1) |
| GasCompensationVault | [0x258356291E9000270118b07396fc8BFdF6646041](https://sepolia.etherscan.io/address/0x258356291E9000270118b07396fc8BFdF6646041) |
| TornadoVault | [0x09Aedf485b0F3Ab213015F13dBe15d9490E9BfBD](https://sepolia.etherscan.io/address/0x09Aedf485b0F3Ab213015F13dBe15d9490E9BfBD) |
| InstanceRegistryProxy | [0xdbBeC11BE17AD70B931DB6e01Bcd1f6Ae973b14E](https://sepolia.etherscan.io/address/0xdbBeC11BE17AD70B931DB6e01Bcd1f6Ae973b14E) |
| InstanceRegistryImpl | [0x4e69fD587118dFb64957d18654E3894118E9B1BF](https://sepolia.etherscan.io/address/0x4e69fD587118dFb64957d18654E3894118E9B1BF) |
| FeeManagerProxy | [0x5BEd99c71f9416C2F8E1c36052AdA73A0d4dbe4e](https://sepolia.etherscan.io/address/0x5BEd99c71f9416C2F8E1c36052AdA73A0d4dbe4e) |
| FeeManagerImpl | [0x4ff67cC3Cd810556DD6ef72D12D72dCFa925Ff95](https://sepolia.etherscan.io/address/0x4ff67cC3Cd810556DD6ef72D12D72dCFa925Ff95) |
| RelayerRegistryProxy | [0x1428e5d2356b13778A13108b10c440C83011dfB8](https://sepolia.etherscan.io/address/0x1428e5d2356b13778A13108b10c440C83011dfB8) |
| RelayerRegistryImpl | [0xD6663593E71e4916eCb6f6606e1A6FbfA1634ffA](https://sepolia.etherscan.io/address/0xD6663593E71e4916eCb6f6606e1A6FbfA1634ffA) |
| TornadoStakingRewardsProxy | [0x6d0018890751Efd31feb8166711B16732E2b496b](https://sepolia.etherscan.io/address/0x6d0018890751Efd31feb8166711B16732E2b496b) |
| TornadoStakingRewardsImpl | [0xe2e051c18baACA3Bfeb71b578f3748C519CA0628](https://sepolia.etherscan.io/address/0xe2e051c18baACA3Bfeb71b578f3748C519CA0628) |
| TornadoRouter | [0x1572AFE6949fdF51Cb3E0856216670ae9Ee160Ee](https://sepolia.etherscan.io/address/0x1572AFE6949fdF51Cb3E0856216670ae9Ee160Ee) |
| Aggregator | [0x4088712AC9fad39ea133cdb9130E465d235e9642](https://sepolia.etherscan.io/address/0x4088712AC9fad39ea133cdb9130E465d235e9642) |
| Echoer | [0xcDD1fc3F5ac2782D83449d3AbE80D6b7B273B0e5](https://sepolia.etherscan.io/address/0xcDD1fc3F5ac2782D83449d3AbE80D6b7B273B0e5) |
| 0.1 ETH | [0x8C4A04d872a6C1BE37964A21ba3a138525dFF50b](https://sepolia.etherscan.io/address/0x8C4A04d872a6C1BE37964A21ba3a138525dFF50b) |
| 1 ETH | [0x8cc930096B4Df705A007c4A039BDFA1320Ed2508](https://sepolia.etherscan.io/address/0x8cc930096B4Df705A007c4A039BDFA1320Ed2508) |
| 10 ETH | [0x8D10d506D29Fc62ABb8A290B99F66dB27Fc43585](https://sepolia.etherscan.io/address/0x8D10d506D29Fc62ABb8A290B99F66dB27Fc43585) |
| 100 ETH | [0x44c5C92ed73dB43888210264f0C8b36Fd68D8379](https://sepolia.etherscan.io/address/0x44c5C92ed73dB43888210264f0C8b36Fd68D8379) |
| 100 DAI | [0x6921fd1a97441dd603a997ED6DDF388658daf754](https://sepolia.etherscan.io/address/0x6921fd1a97441dd603a997ED6DDF388658daf754) |
| 1,000 DAI | [0x50a637770F5d161999420F7d70d888DE47207145](https://sepolia.etherscan.io/address/0x50a637770F5d161999420F7d70d888DE47207145) |
| 10,000 DAI | [0xecD649870407cD43923A816Cc6334a5bdf113621](https://sepolia.etherscan.io/address/0xecD649870407cD43923A816Cc6334a5bdf113621) |
| 100,000 DAI | [0x73B4BD04bF83206B6e979BE2507098F92EDf4F90](https://sepolia.etherscan.io/address/0x73B4BD04bF83206B6e979BE2507098F92EDf4F90) |
### Tornado Cash Nova ### Tornado Cash Nova
| Contract | Address | | Contract | Address |
@ -123,7 +156,7 @@ The following addresses are deployments of the [source code of Tornado Cash smar
| Governance Contract | [0x5efda50f22d34f262c29268506c5fa42cb56a1ce](https://etherscan.io/address/0x5efda50f22d34f262c29268506c5fa42cb56a1ce) | | Governance Contract | [0x5efda50f22d34f262c29268506c5fa42cb56a1ce](https://etherscan.io/address/0x5efda50f22d34f262c29268506c5fa42cb56a1ce) |
| Governance Vault (for locked TORN) | [0x2f50508a8a3d323b91336fa3ea6ae50e55f32185](https://etherscan.io/address/0x2f50508a8a3d323b91336fa3ea6ae50e55f32185#tokentxns) | | Governance Vault (for locked TORN) | [0x2f50508a8a3d323b91336fa3ea6ae50e55f32185](https://etherscan.io/address/0x2f50508a8a3d323b91336fa3ea6ae50e55f32185#tokentxns) |
| Deployer Contract | [0xCEe71753C9820f063b38FDbE4cFDAf1d3D928A80](https://etherscan.io/address/0xCEe71753C9820f063b38FDbE4cFDAf1d3D928A80) | | Deployer Contract | [0xCEe71753C9820f063b38FDbE4cFDAf1d3D928A80](https://etherscan.io/address/0xCEe71753C9820f063b38FDbE4cFDAf1d3D928A80) |
| Governance Impl | [0xBa178126C28F50Ee60322a82f5EbCd6b3711e101](https://etherscan.io/address/0xba178126c28f50ee60322a82f5ebcd6b3711e101#code) | | Governance Impl | [0xbf46f2222c0712cAF2f13B8590732DbD964ce395](https://etherscan.io/address/0xbf46f2222c0712cAF2f13B8590732DbD964ce395#code) |
| Governance Vesting | [0x179f48c78f57a3a78f0608cc9197b8972921d1d2](https://etherscan.io/address/0x179f48c78f57a3a78f0608cc9197b8972921d1d2) | | Governance Vesting | [0x179f48c78f57a3a78f0608cc9197b8972921d1d2](https://etherscan.io/address/0x179f48c78f57a3a78f0608cc9197b8972921d1d2) |
| Community Fund | [0xb04E030140b30C27bcdfaafFFA98C57d80eDa7B4](https://gnosis-safe.io/app/eth:0xb04E030140b30C27bcdfaafFFA98C57d80eDa7B4/balances) | | Community Fund | [0xb04E030140b30C27bcdfaafFFA98C57d80eDa7B4](https://gnosis-safe.io/app/eth:0xb04E030140b30C27bcdfaafFFA98C57d80eDa7B4/balances) |
| TORN Token | [0x77777feddddffc19ff86db637967013e6c6a116c](https://etherscan.io/address/0x77777feddddffc19ff86db637967013e6c6a116c) | | TORN Token | [0x77777feddddffc19ff86db637967013e6c6a116c](https://etherscan.io/address/0x77777feddddffc19ff86db637967013e6c6a116c) |
@ -138,9 +171,9 @@ The following addresses are deployments of the [source code of Tornado Cash smar
| Proxy of feeManagerContract | [0x5f6c97C6AD7bdd0AE7E0Dd4ca33A4ED3fDabD4D7](https://etherscan.io/address/0x5f6c97C6AD7bdd0AE7E0Dd4ca33A4ED3fDabD4D7) | | Proxy of feeManagerContract | [0x5f6c97C6AD7bdd0AE7E0Dd4ca33A4ED3fDabD4D7](https://etherscan.io/address/0x5f6c97C6AD7bdd0AE7E0Dd4ca33A4ED3fDabD4D7) |
| FeeManager | [0xf4B067dD14e95Bab89Be928c07Cb22E3c94E0DAA](https://etherscan.io/address/0xf4B067dD14e95Bab89Be928c07Cb22E3c94E0DAA) | | FeeManager | [0xf4B067dD14e95Bab89Be928c07Cb22E3c94E0DAA](https://etherscan.io/address/0xf4B067dD14e95Bab89Be928c07Cb22E3c94E0DAA) |
| Proxy of relayerRegistryContract | [0x58E8dCC13BE9780fC42E8723D8EaD4CF46943dF2](https://etherscan.io/address/0x58E8dCC13BE9780fC42E8723D8EaD4CF46943dF2) | | Proxy of relayerRegistryContract | [0x58E8dCC13BE9780fC42E8723D8EaD4CF46943dF2](https://etherscan.io/address/0x58E8dCC13BE9780fC42E8723D8EaD4CF46943dF2) |
| RelayerRegistry | [0xe27b91724c55e950f68b394f33fa3b86693179c0](https://etherscan.io/address/0xe27b91724c55e950f68b394f33fa3b86693179c0) | | RelayerRegistry | [0x84b0c75c1F6211450FEC7289c32D717AdaDD702A](https://etherscan.io/address/0x84b0c75c1F6211450FEC7289c32D717AdaDD702A) |
| Proxy of stakingContract | [0x5b3f656c80e8ddb9ec01dd9018815576e9238c29](https://etherscan.io/address/0x5b3f656c80e8ddb9ec01dd9018815576e9238c29) | | Proxy of stakingContract | [0x5b3f656c80e8ddb9ec01dd9018815576e9238c29](https://etherscan.io/address/0x5b3f656c80e8ddb9ec01dd9018815576e9238c29) |
| TornadoStakingRewards | [0xefbea4ec481c2467a1a94d94bc54f111f6a7345f](https://etherscan.io/address/0xefbea4ec481c2467a1a94d94bc54f111f6a7345f) | | TornadoStakingRewards | [0x9c97be37840f0e754bb7aDB1b16fD0954A2BA248](https://etherscan.io/address/0x9c97be37840f0e754bb7aDB1b16fD0954A2BA248) |
| Proxy of instanceRegistryContract | [0xB20c66C4DE72433F3cE747b58B86830c459CA911](https://etherscan.io/address/0xB20c66C4DE72433F3cE747b58B86830c459CA911) | | Proxy of instanceRegistryContract | [0xB20c66C4DE72433F3cE747b58B86830c459CA911](https://etherscan.io/address/0xB20c66C4DE72433F3cE747b58B86830c459CA911) |
| InstanceRegistry | [0x2573BAc39EBe2901B4389CD468F2872cF7767FAF](https://etherscan.io/address/0x2573BAc39EBe2901B4389CD468F2872cF7767FAF) | | InstanceRegistry | [0x2573BAc39EBe2901B4389CD468F2872cF7767FAF](https://etherscan.io/address/0x2573BAc39EBe2901B4389CD468F2872cF7767FAF) |

18
book/general/guides/relayer.md
View File

@ -28,9 +28,9 @@ Before you commit to sharing part of your journey with Tornado Cash users as a r
The formula for designating a relayer is as follows: The formula for designating a relayer is as follows:
* The list of all registered relayers is retrieved from the Relayer Registry smart contract. - The list of all registered relayers is retrieved from the Relayer Registry smart contract.
* For each relayer, calculate a score based on its staked TORN and its fee. The higher the stake, the higher the score is; the higher the fee, the lower the score is. For Ethereum mainnet, the formula used to calculate the score is `stake * [1 - 25*(fee-0.33)^2]`; for sidechains, the formula is `stake * [1 - 11.89*(fee-0.01)^2]`. - For each relayer, calculate a score based on its staked TORN and its fee. The higher the stake, the higher the score is; the higher the fee, the lower the score is. For Ethereum mainnet, the formula used to calculate the score is `stake * [1 - 25*(fee-0.33)^2]`; for sidechains, the formula is `stake * [1 - 11.89*(fee-0.01)^2]`.
* Then randomly pick a relayer, weighted by its calculated score. - Then randomly pick a relayer, weighted by its calculated score.
### 2. Set up relayer ### 2. Set up relayer
@ -38,7 +38,7 @@ The first concrete step is to run the Tornado Cash Relayer software for Ethereum
Once completed, you will need to insert your url in the input box. Once completed, you will need to insert your url in the input box.
![](<../../.gitbook/assets/set-relayer-link.png>) ![](../../.gitbook/assets/set-relayer-link.png)
{% hint style="warning" %} {% hint style="warning" %}
It is strongly recommended that you use your own RPC nodes. Instructions on how to run full nodes can be found [here](https://github.com/feshchenkod/rpc-nodes). It is strongly recommended that you use your own RPC nodes. Instructions on how to run full nodes can be found [here](https://github.com/feshchenkod/rpc-nodes).
@ -48,10 +48,10 @@ It is strongly recommended that you use your own RPC nodes. Instructions on how
The next steps entail: The next steps entail:
* Creating an [ENS domain](https://ens.domains/) for your relayer. - Creating an [ENS domain](https://ens.domains/) for your relayer.
* Unwrap domain in settings on app.ens.domains or by calling [this function](https://etherscan.io/address/0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401#writeContract#F23). - Unwrap domain in settings on app.ens.domains or by calling [this function](https://etherscan.io/address/0xD4416b13d2b3a9aBae7AcD5D6C2BbDBE25686401#writeContract#F23).
* Setting up its mainnet subdomain. - Setting up its mainnet subdomain.
* Adding a TXT record with the Relayer URL to the mainnet subdomain according to this specific format: - Adding a TXT record with the Relayer URL to the mainnet subdomain according to this specific format:
#### **Ethereum relayers (Mandatory)** #### **Ethereum relayers (Mandatory)**
@ -97,7 +97,7 @@ Only the mainnet requires you to register workers. All other networks do not req
With the implementation of a decentralized relayer registry, a staking condition has been introduced as a requirement to become listed on Tornado Cash UI. Keep in mind **staking TORN is now necessary to be added to the recommended list of relayers.** With the implementation of a decentralized relayer registry, a staking condition has been introduced as a requirement to become listed on Tornado Cash UI. Keep in mind **staking TORN is now necessary to be added to the recommended list of relayers.**
The minimum staked amount is currently set by Tornado Cash governance at **`2000 TORN`**. This threshold can be changed by Tornado Cash governance at any time. The minimum staked amount is currently set by Tornado Cash governance at **`5000 TORN`**. This threshold can be changed by Tornado Cash governance at any time.
When a relayer is used in the Tornado Cash pool, a small amount of TORN is automatically collected from this staked balance by the `StakingReward` contract. This element is essential to keep in mind as relayers will need to keep enough TORN locked (\~`500 TORN` at the moment in June 2023) to be able to pay back the transaction fee to the staking contract. When a relayer is used in the Tornado Cash pool, a small amount of TORN is automatically collected from this staked balance by the `StakingReward` contract. This element is essential to keep in mind as relayers will need to keep enough TORN locked (\~`500 TORN` at the moment in June 2023) to be able to pay back the transaction fee to the staking contract.