Skip to content

Latest commit

 

History

History
130 lines (103 loc) · 5.64 KB

installation-testnet-mainnet.md

File metadata and controls

130 lines (103 loc) · 5.64 KB
Raw

Installation - Testnet

Notes

  1. This installation assumes you're using Ubuntu or similar
  2. You need a non-root user that belongs to the sudo group.

Required software install procedure

  1. Install Ethereum
sudo apt install software-properties-common
sudo add-apt-repository -y ppa:ethereum/ethereum
sudo apt install ethereum
  1. Install NodeJS using NVM (Check NVM repo for updated procedure)
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash
source .bashrc
nvm install --lts
  1. Install Python and other software
sudo apt install python build-essential

Clone the repo

git clone https://github.com/status-im/snt-gas-relay.git
cd snt-gas-relay/gas-relayer
npm install

Setup geth for Whisper

  1. Verify geth light mode starts successfully. Exit geth when you see everything is ok
geth --testnet --syncmode=light console
> exit
  1. There aren't enough geth peers with Whisper enabled to guarantee that messages will arrive from one node to other. We need to create a static-nodes.json file in ~/.ethereum/testnet/geth/.

This file needs to contain the following array:

[
    "enode://436cc6f674928fdc9a9f7990f2944002b685d1c37f025c1be425185b5b1f0900feaf1ccc2a6130268f9901be4a7d252f37302c8335a2c1a62736e9232691cc3a@174.138.105.243:30404",
    "enode://5395aab7833f1ecb671b59bf0521cf20224fe8162fc3d2675de4ee4d5636a75ec32d13268fc184df8d1ddfa803943906882da62a4df42d4fccf6d17808156a87@206.189.243.57:30404",
    "enode://7427dfe38bd4cf7c58bb96417806fab25782ec3e6046a8053370022cbaa281536e8d64ecd1b02e1f8f72768e295d06258ba43d88304db068e6f2417ae8bcb9a6@104.154.88.123:30404",
    "enode://ebefab39b69bbbe64d8cd86be765b3be356d8c4b24660f65d493143a0c44f38c85a257300178f7845592a1b0332811542e9a58281c835babdd7535babb64efc1@35.202.99.224:30404",
    "enode://a6a2a9b3a7cbb0a15da74301537ebba549c990e3325ae78e1272a19a3ace150d03c184b8ac86cc33f1f2f63691e467d49308f02d613277754c4dccd6773b95e8@206.189.243.176:30304",
    "enode://207e53d9bf66be7441e3daba36f53bfbda0b6099dba9a865afc6260a2d253fb8a56a72a48598a4f7ba271792c2e4a8e1a43aaef7f34857f520c8c820f63b44c8@35.224.15.65:30304",
    "enode://c42f368a23fa98ee546fd247220759062323249ef657d26d357a777443aec04db1b29a3a22ef3e7c548e18493ddaf51a31b0aed6079bd6ebe5ae838fcfaf3a49@206.189.243.162:30504",
    "enode://7aa648d6e855950b2e3d3bf220c496e0cae4adfddef3e1e6062e6b177aec93bc6cdcf1282cb40d1656932ebfdd565729da440368d7c4da7dbd4d004b1ac02bf8@206.189.243.169:30504",
    "enode://8a64b3c349a2e0ef4a32ea49609ed6eb3364be1110253c20adc17a3cebbc39a219e5d3e13b151c0eee5d8e0f9a8ba2cd026014e67b41a4ab7d1d5dd67ca27427@206.189.243.168:30504",
    "enode://7de99e4cb1b3523bd26ca212369540646607c721ad4f3e5c821ed9148150ce6ce2e72631723002210fac1fd52dfa8bbdf3555e05379af79515e1179da37cc3db@35.188.19.210:30504",
    "enode://015e22f6cd2b44c8a51bd7a23555e271e0759c7d7f52432719665a74966f2da456d28e154e836bee6092b4d686fe67e331655586c57b718be3997c1629d24167@35.226.21.19:30504",
    "enode://531e252ec966b7e83f5538c19bf1cde7381cc7949026a6e499b6e998e695751aadf26d4c98d5a4eabfb7cefd31c3c88d600a775f14ed5781520a88ecd25da3c6@35.225.227.79:30504"
]

These enodes were extracted from https://github.com/status-im/status-go/blob/develop/params/cluster.go.

Setup the gas relayer

Before executing this program, config/config.json must be setup and npm install needs to be executed. Important values to verify are related to the node configuration, just like:

  • Host, port and protocol to connect to the geth node
  • Host, port and protocol Ganache will use when forking the blockchain for gas estimations and other operations
  • Account used for processing the transactions
  • Symmetric key used to receive the Whisper messages
  • Accepted tokens information
  • Contract configuration
  1. For testnet, a config file is provided with the required configuration, you just need to set the account information
cd config
rm config.js 
mv config.testnet.js config.js
  1. A node that wants to act as a relayer only needs to have a geth node with whisper enabled, and an account with ether to process the transactions. This account needs to be configured in ./config/config.js. Edit this file and set the account:
"blockchain": {
    // Use one of these options:

    // Option1 ===========================
    // privateKey: "your_private_key",

    // Option2 ===========================
    // privateKeyFile: "path/to/file"

    // Option3 ===========================
    // mnemonic: "12 word mnemonic",
    // addressIndex: "0", // Optionnal. The index to start getting the address
    // hdpath: "m/44'/60'/0'/0/" // Optionnal. HD derivation path
},

Launching the relayer

A launch-geth-testnet.sh script is provided in the snt-gas-relayer/gas-relayer folder:

chmod +x ./launch-geth-testnet.sh
./launch-geth-testnet.sh

you may use any of the following three commands to launch the relayer.

npm start
node src/service.js
nodemon src/service.js

Using the testdapp with testnet

The test dapp may be used for testnet from your computer. It requires a node that allows websockets. You may use this command to launch a geth instance pointing to testnet:

chmod +x ./launch-geth-testnet.sh
./launch-geth-testnet.sh
  1. Execute embark run testnet to launch the dapp connected to testnet
  2. Navigate in your browser to http://localhost:8000. Use metamask to connect to your local node.
  3. You're now able to use the dapp normally. The status for the relayer that can be seen in the footer of the dapp won't reflect accurate information, since the relayers account are not deterministic anymore since you're not in a development environment

NOTE

Work is in progress for using the test-dapp inside status.