SyncLink Client PoC

A very basic implementation of the SyncLink Client.

Supported clients

Client	Support
Teku	✅
Nimbus	❎
Lodestar	❎
Lighthouse	❎
Prysm	❎

Install Python 3

Please refer to the official Python docs to install Python >= 3.10 on your OS.

Install additional Requirements on Windows

Start a virtual environment and install or update required Python packages:

python -m venv .venv
".venv/scripts/activate.bat"
pip install -r requirements.txt

Install additional Requirements on Linux / MacOS

On Debian or Ubuntu you first need to install venv:

apt install pythonX.Y-venv

Replace X.Y with the python MAJOR and MINOR version retrieved by python -V

Then start a virtual environment and install or update required Python packages:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Configure the App

1. Copy config.yaml.example to config.yaml
2. Define settings in config.yaml as desired

Name	Description	Default	Required
addr	The IP address or domain for the SyncLink Client	0.0.0.0	No
port	The port for the SyncLink Client	9000	No
nodes	List of URLs to your SyncLink Server Nodes	[http://localhost:8000]	Yes

Optional you can also specify the path to your config file or add/overwrite this arguments on the command line. Run python main.py -h for details.

Run the App

Activate the virtual environment and run the app.

On Windows:

".venv/scripts/activate.bat"
python main.py

On Linux / MacOS:

source .venv/bin/activate
python main.py

Open API Docs

After the app is started you can visit the API docs (depending on your settings in config.yaml) by default at http://127.0.0.1:9000/docs.

Debug Request

To check if the SyncLink Client works proper you may do the following CURL request:

curl -X GET http://127.0.0.1:9000/eth/v2/debug/beacon/states/finalized > ~/synclinktestdata.json

This should download a checkpoint file to ~/synclinktestdata.json with a size of about 50-100MB.

Depending on your settings in config.yaml you may need to adjust the ip address and port as needed (127.0.0.1:9000 is the default).

Stop the App

If you're done you can stop the Python process and deactivate the virtual environment by typing the following in your active terminal:

CTRL+C
deactivate