classic-ui/README.md

73 lines
2.3 KiB
Markdown
Raw Normal View History

2022-04-22 10:04:16 +03:00
# Tornado Cash Classic UI
2022-04-22 06:05:56 +03:00
> Self-hostable Tornado Cash UI software for interacting with the protocol
2022-04-22 06:05:56 +03:00
2022-04-22 10:04:16 +03:00
## Building locally
2022-04-22 06:05:56 +03:00
2022-04-22 10:04:16 +03:00
- Install [Node.js](https://nodejs.org) version 14
2022-06-15 09:24:13 +03:00
- If you are using [nvm](https://github.com/creationix/nvm#installation) (recommended) running `nvm use` will automatically choose the right node version for you.
2022-04-22 10:04:16 +03:00
- Install [Yarn](https://yarnpkg.com/en/docs/install)
- Install dependencies: `yarn`
- Copy the `.env.example` file to `.env`
2022-06-15 09:24:13 +03:00
- Replace environment variables with your own personal.
2022-04-22 10:04:16 +03:00
- Build the project to the `./dist/` folder with `yarn generate`.
2022-04-22 06:05:56 +03:00
2022-04-22 10:04:16 +03:00
## Development builds
2022-04-22 06:05:56 +03:00
2022-04-22 10:04:16 +03:00
To start a development build (e.g. with logging and file watching) run `yarn dev`.
2022-04-22 06:05:56 +03:00
2022-04-22 10:04:16 +03:00
## Deploy on IPFS
- Make sure you set `PINATA_API_KEY` and `PINATA_SECRET_API_KEY` environment variables in `.env`
- To deploy a production build run `yarn deploy-ipfs`.
## Architecture
2022-04-22 06:05:56 +03:00
For detailed explanation on how things work, checkout [Nuxt.js docs](https://nuxtjs.org).
2022-06-15 09:24:13 +03:00
## Audit
[TornadoCash_Classic_dApp_audit_Decurity.pdf](https://ipfs.io/ipfs/QmXzmwfsb4GwzmPD7W9VDNHh7ttyYKgXCY74973QMZqBDA)
## Update cached files
- To update deposit and withdrawal events use `yarn update:events {chainId} {optional: tokenOrEvent} {optional: tokenOrEvent}`
- To update encrypted notes use `yarn update:encrypted {chainId}`
- To update merkle tree use `yarn update:tree {chainId}`
#### NOTE!
After updating cached files do not forget to use `yarn update:zip`.
### Example for Ethereum Mainnet:
You may set in [`networkConfig.js`](./networkConfig.js) the `blockSyncInterval` (def: 10_000) to the maximum value allowed by your RPC provider. Command usage follows below.
```bash
# Updating events with just the required chain id parameter
yarn update:events 1
# Updating events for only one token across all instances on that network
yarn update:events 1 dai
# Updating events for only one event on only some network
yarn update:events 1 deposit
# Both
yarn update:events 1 dai deposit
# Updating encrypted notes for some chain id
yarn update:encrypted 1
# Updating trees for some chain id
yarn update:tree 1
# Finally zips must be updated
yarn update:zip
```
### Example for Binance Smart Chain:
```bash
yarn update:events 56
yarn update:events 56 bnb
yarn update:events 56 bnb deposit
2022-06-13 10:13:54 +03:00
yarn update:encrypted 56
yarn update:tree 56
yarn update:zip
```