The following instructions are for Ubuntu 22.10, other operating systems may vary. These instructions include automated SSL configuration with LetsEncrypt.
PREREQUISITES
- Update core dependencies
sudo apt-get update
- 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
- Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh && chmod +x get-docker.sh && ./get-docker.sh
- Install git
sudo apt-get install git
- Install node
sudo apt install nodejs npm
DEPLOYMENT
-
Clone this repository
git clone https://github.com/chainwayxyz/privacy-pools-relayer.git && cd privacy-pools-relayer
-
Download the required public parameters for membership proof verification
wget -P public https://github.com/ProofOfInnocence/privacy-pools-v1-relayer/releases/download/v0.0.1/public_parameters.json
-
Copy
.env.example
to.env
and setup environment variables in.env
file- set
CHAIN_ID
(31337 for localhost, 5 for goerli) - set
PRIVATE_KEY
for your relayer address (without 0x prefix) - set
VIRTUAL_HOST
andLETSENCRYPT_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 goerli node for fetching prices - set
WITHDRAWAL_SERVICE_FEE
- fee in % that is used for 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
- set
-
Build and deploy the docker container:
npm run build:docker
docker-compose up -d
yarn
cp .env.example .env
- Modify
.env
as needed yarn start:dev
- Go to
http://127.0.0.1:8000
- 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
- Abi: Json ABI for working with contracts
- Artifacts: The generated file contains typed contract instances
- Config:
bull.config.ts
bull service settingsconfiguration.ts
global application configurationtxManager.config.ts
txManager service settings
- Constants:
contracts.ts
addresses of contracts and rpsvariables.ts
various variables to make things easier
- Modules:
controller.ts
Controller file that will contain all the application routesmodule.ts
The module file essentially bundles all the controllers and providers of your application together.service.ts
The service will include methods that will perform a certain operation.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:
gas-price.ts
update gas pricesprovider.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.