Relay Client

pls-lsd-relay is an off-chain relay service responsible for interacting with Vouch LSD contracts, synchronising blocks and events, handling tasks related to validators and balances, and other off-chain operations.

For more inforamtion on the Relayer role refer to the Relay component documentation.

Installation

Install Build Tools

On your chosen server/node make sure you have the following tools installed, you will need these to continue.

Install make, gcc and git

sudo apt update
sudo apt install -y make gcc git build-essential

Install Go

Here we will install Go and set the environment variables:

• Existing Go version binary will be removed
• Go will be installed in /usr/local/go
• the downloaded zipped file will be deleted
• File Path locations will be added to .bashrc

cd $HOME
wget -O go1.21.3.linux-amd64.tar.gz https://go.dev/dl/go1.21.3.linux-amd64.tar.gz
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.21.3.linux-amd64.tar.gz && rm go1.21.3.linux-amd64.tar.gz
echo 'export GOROOT=/usr/local/go' >> $HOME/.bashrc
echo 'export GOPATH=$HOME/go' >> $HOME/.bashrc
echo 'export GO111MODULE=on' >> $HOME/.bashrc
echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> $HOME/.bashrc && . $HOME/.bashrc
go version

Confirm that the command prints the installed version of Go.

If you have issues with the above you can always install go by following the official docs. Remember to set your $PATH environment variable, see above example.

Install Vouch Relay Service

💡 Do not run make install as sudo

git clone https://github.com/Vouchrun/pls-lsd-relay.git
cd pls-lsd-relay
make install

Create Working Directory

Create your chosen working directory if required, then copy the config.toml template from the install directory to the working directory.

sudo mkdir -p /blockchain/relay
sudo cp conf.template.toml /blockchain/relay/config.toml

Configure Relay Service Settings

The config.toml file will require some operatror specific settings per Relay client:

1. public address - You will need to enter a Voter account. This is a public address which will be used for voting, as such you will need to export a Private Key which will get imported to the relay client on first run.
2. Pinata API key - The client also saves data to IPFS, you will need to create a pinata account for this purpose and gernate and API key.

Have these ready so you can configure the relay client with these unique settings.

Relay section

config	description	example value (recommended)
account	voter account addressMake sure you imported it before using	0xYOUR_ACCOUNT
trustNodeDepositAmount	the trust node validator initial deposit amount	1000000
eth2EffectiveBalance	the effective balance of a validator	32000000
maxPartialWithdrawalAmount	The threshold used to differentiate between rewards and exit balance. If the amount received from Beacon chain is less than this value, it is treated as rewards; otherwise, it is considered as exit balance.	8000000
gasLimit		3000000
maxGasPrice		600 (in Gwei)
batchRequestBlocksNumber	a number which limits concurrent requests on Beacon chain, due to the design of Beacon chain RPC	16 (32 Max)
runForEntrustedLsdNetwork	set this config to true only if you are one of the entrusted voters who are responsible to relay data for entrusted LSD networks	false

Pinata section

config	description	example value (recommended)
apikey	apikey of your pinata account	YOUR_API_KEY
pinDays	how many days the data retained on IPFS	180

Contracts section

config	description	example value (recommended)
lsdTokenAddress	lsd token address	see config.toml below
lsdFactoryAddress	lsd factory address	see config.toml below

Endpoints section

Groups of eth1 and eth2 endpoints. It will be used only if previous ones are not available.

config	description	example value
eth1	Execution RPC endpoint	https://rpc-pulsechain.g4mm4.io
eth2	Consensus (Beacon chain) RPC endpoint	https://rpc-pulsechain.g4mm4.io/beacon-api/

Example config.toml file

Edit your config.toml using your editor of choice, refer to the example config.toml below.

# Example for Voter Account
account = "0x0E3266DEB55b386CD608C64627155E33Df4657De"
trustNodeDepositAmount     = 1000000  # PLS
eth2EffectiveBalance       = 32000000 # PLS
maxPartialWithdrawalAmount = 8000000  # PLS
gasLimit = "3000000"
maxGasPrice = "600"                            #Gwei
batchRequestBlocksNumber = 16
runForEntrustedLsdNetwork = false

[pinata]
apikey = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.yJ1c2VySW5mb3JtYXsdioufhasoiufhsidkfjhsdkjlfhskdjlhfsidkhfsdkjhfksjdfhsdkjfhsdkjfhsdjkfhsdkjlaksdf8998239309249234h239iuhsd908f89234nfik0s0f8h234h2390sdf89y2h39u4239402390fh234h230949-0h92834902349-0sdfh89u2340923409uisdfvu79hg3249j0324-09uy8v89s-0dsdfiojnk32902398wefhseu8fsfg234982387gsbv92834789234t87gwegsd89sd98fgh23479g82389asdt8g234798237489ysg29348923489yfg2397498289s7as6as78dghh8ui2389239ag98732498234tyagd28937498y_4"
pinDays = 180

[contracts]
lsdTokenAddress = "0xLSD_TOKEN_ADDRESS"
lsdFactoryAddress = "0xLSD_FACTORY_ADDRESS"

[[endpoints]]
eth1 = "https://rpc-pulsechain.g4mm4.io"
eth2 = "https://rpc-pulsechain.g4mm4.io/beacon-api/"

Running the Relay Client

Import voter accounts

Let's import your voter account so that it can be used by relay service. Note you will need to have a Private Key that matches the Public Address you have configured in your config.toml file. You will also set the password for this private key, each time the relay is re-started the password will be required.

Start Command

pls-lsd-relay import-account --base-path /blockchain/relay

Respond with the required information when prompted:

> Enter private key: #enter your exported Private Key

> password for key: #enter a password

Start the relay services

⚠️ You will need your account password (the password you used when importing your account), as we will be passing this to the client at startup when prompted.

sudo pls-lsd-relay start --base-path /blockchain/relay/ --log-level info

Respond with the required information when prompted:

> password for key: #enter password created in above step

That is it, just make sure the Ejector client runs at all times!

Additional Configuration and Start Options

Running using Tmux

It is preferred to run your Relay client using something like systemd TMUX or Screen which will give you more control and flexibilty when running the client. You can use TMUX by doing the following:

💡 If you are unfamiliar with Running TMUX you should learn how to navigate it first before running the below commands. This TMUX guide might help.

sudo apt install tmux
tmux new-session -s relay

Then Issue the above Start Command in the TMUX terminal using the instructions in the preceeding section.

Logging Level

Note: Logging level can be adjusted if required for trouble shooting.

💡 Log files will be saved to [base_path]/log_file/relay

--log-level string   The logging level (trace|debug|info|warn|error|fatal|panic) (default "info")

Updating the Relay Client

Get the latest Client

Update the client files by navigating to the orginal install directory and pulling the latest Relay client from the github repository.

cd $HOME/pls-lsd-relay # assumes home dir was root of install 
git pull https://github.com/Vouchrun/pls-lsd-relay.git

Re-run the installation process as outlined above.

💡 Do not run make install as sudo

cd pls-lsd-relay
make install

Re-start the client

sudo pls-lsd-relay start --base-path /blockchain/relay/ --log-level info

Respond with the required information when prompted:

> password for key: #enter password created in above step

That is it, just make sure the Ejector client runs at all times!