Tornado Cash relayer software
Go to file
2023-10-07 06:41:04 -07:00
.github/workflows updated discord notification message 2022-02-04 21:24:20 +10:00
.vscode feat: add vscode debug 2021-09-13 20:38:35 +03:00
src Update deprecated dependencies & resolve via self-hosted registry 2023-09-24 23:44:41 -07:00
test fix: e2e test 2021-12-10 18:47:15 +10:00
.dockerignore refactor: spread across services & added docker 2021-07-19 15:50:34 +03:00
.env.example Change default parameters in example .env file to actual 2023-10-07 06:41:04 -07:00
.eslintrc.js feat: init commit 2021-07-13 20:06:36 +03:00
.gitignore refactor: spread across services & added docker 2021-07-19 15:50:34 +03:00
.npmrc Update deprecated dependencies & resolve via self-hosted registry 2023-09-24 23:44:41 -07:00
.prettierrc refactor: spread across services & added docker 2021-07-19 15:50:34 +03:00
docker-compose.yml Build docker image locally from source & update readme for deployment with docker 2023-09-25 00:08:55 -07:00
Dockerfile fix: contracts 2021-10-22 12:26:18 +03:00
nest-cli.json feat: init commit 2021-07-13 20:06:36 +03:00
package.json Build docker image locally from source & update readme for deployment with docker 2023-09-25 00:08:55 -07:00
README.md Update readme instructions to copy .env for local docker deployment 2023-10-07 04:47:15 -07:00
tsconfig.build.json feat: init commit 2021-07-13 20:06:36 +03:00
tsconfig.json fix: remove node config & use nest configuration 2021-07-14 14:20:59 +03:00
yarn.lock Update deprecated dependencies & resolve via self-hosted registry 2023-09-24 23:44:41 -07:00

Relayer for Tornado Cash Nova Build Status Docker Image Version (latest semver)

The following instructions are for Ubuntu 22.10, other operating systems may vary. These instructions include automated SSL configuration with LetsEncrypt.

PREREQUISITES

  1. Update core dependencies
  • sudo apt-get update
  1. Install docker-compose
  • curl -SL https://github.com/docker/compose/releases/download/v2.16.0/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose && sudo chmod +x /usr/local/bin/docker-compose
  1. Install Docker
  • curl -fsSL https://get.docker.com -o get-docker.sh && chmod +x get-docker.sh && ./get-docker.sh
  1. Install git
  • sudo apt-get install git
  1. Install node
  • sudo apt install nodejs npm

DEPLOYMENT

  1. Clone this repository

    git clone https://git.tornado.ws/tornadocash/nova-relayer && cd nova-relayer

  2. Copy .env.example to .env and setup environment variables in .env file

    • set CHAIN_ID (100 for xdai, 1 for mainnet)
    • set PRIVATE_KEY for your relayer address (without 0x prefix)
    • set VIRTUAL_HOST and LETSENCRYPT_HOST to your domain and add DNS record pointing to your relayer ip address
    • set REWARD_ADDRESS - eth address that is used to collect fees
    • set RPC_URL rpc url for your node
    • set ORACLE_RPC_URL - rpc url for mainnet node for fetching prices(always have to be on mainnet)
    • set WITHDRAWAL_SERVICE_FEE - fee in % that is used for tornado withdrawals
    • set TRANSFER_SERVICE_FEE - fee is a fixed value in ether for transfer
    • set CONFIRMATIONS if needed - how many block confirmations to wait before processing an event. Not recommended to set less than 3
    • set MAX_GAS_PRICE if needed - maximum value of gwei value for relayer's transaction
  3. Build and deploy the docker container:

    • npm run build:docker
    • docker-compose up -d

Run locally

  1. yarn
  2. cp .env.example .env
  3. Modify .env as needed
  4. yarn start:dev
  5. Go to http://127.0.0.1:8000
  6. In order to execute withdraw/transfer request, you can run following command
curl -X POST -H 'content-type:application/json' --data '<input data>' http://127.0.0.1:8000/transaction

Relayer should return a transaction hash

In that case you will need to add https termination yourself because browsers with default settings will prevent https tornado.cash UI from submitting your request over http connection

Architecture

  • Abi: Json ABI for working with contracts
  • Artifacts: The generated file contains typed contract instances
  • Config:
    1. bull.config.ts bull service settings
    2. configuration.ts global application configuration
    3. txManager.config.ts txManager service settings
  • Constants:
    1. contracts.ts addresses of contracts and rps
    2. variables.ts various variables to make things easier
  • Modules:
    1. controller.ts Controller file that will contain all the application routes
    2. module.ts The module file essentially bundles all the controllers and providers of your application together.
    3. service.ts The service will include methods that will perform a certain operation.
    4. main.ts The entry file of the application will take in your module bundle and create an app instance using the NestFactory provided by Nest.
  • Services:
    1. gas-price.ts update gas prices
    2. offchain-price.ts update the exchange rate
    3. provider.ts add-on for working with ethers js
  • Types: types for the application
  • Utilities: helpers functions

Disclaimer:

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.