Run EWM Light Client

The EWM Light Client can be run using four methods. Follow the instructions below based on your preferred approach:

Run with Docker Compose
Run with Installer for macOS
Run with Pre-complied Binaries
Build & Run from Source

1. Run with Docker Compose

Instructions to Run EWM Light Client with Docker

Clone the Repository

git clone https://github.com/covalenthq/ewm-das
cd ewm-das

Build the Docker Image

docker build -t covalent/light-client -f Dockerfile.lc .

Note: If you are running the client on Windows, you may have to modify the Dockerfile.lc script since the lining on Windows is different than Linux.

For Windows:

# Install dos2unix to fix line endings
RUN apk add --no-cache dos2unix

Run the Docker Container

You need to provide the PRIVATE_KEY of your burner address, which was generated as part of Prerequisites Step 2.

docker run -d --restart always --name light-client -e PRIVATE_KEY="YOUR_HEX_PRIVATE_KEY" covalent/light-client

Check the Status of the Light Client

docker logs -f light-client

Expected Output: For version details, please refer to our Discord’s light-client channel.

Version: v0.x.0, commit: 8d6709bee9e79d3c4e6ece35fed65da02f3850f4
2024-09-18T15:45:01.238-0700	INFO	light-client	light-client/main.go:91	Starting client...
2024-09-18T15:45:01.238-0700	INFO	light-client	light-client/main.go:97	Client identity: 0x51b6D674514849aF97FB77BCac51bcdD7799842C
...

2. Run using Installer for macOS only:

Running Light Client on macOS

Install IPFS Kubo Client (If Not Already Installed)

brew install ipfs

Configure IPFS Kubo Client

ipfs init

Install and Launch the Light Client

You need to provide the PRIVATE_KEY of your burner address, which was generated as part of Prerequisites Step 2.Single Command Installation:

curl -sSf https://storage.googleapis.com/ewm-release-artefacts/{{VERSION}}/macos/install.sh | bash -s <YOUR PRIVATE KEY>

Alternative Installation Method:

Go to the Light Client Releases page and download the latest release.
Unzip the downloaded archive and navigate to the directory:
cd das-macos-latest
Run the installation script:
./install.sh <YOUR_PRIVATE_KEY>

The script will install all files in the $HOME/.covalent directory.

Check the Status of the Light Client

tail -n 1000 -f $HOME/.covalent/light-client.log

Expected Output: For version details, please refer to our Discord’s light-client channel.

Version: v0.x.0, commit: 8d6709bee9e79d3c4e6ece35fed65da02f3850f4
2024-09-18T15:45:01.238-0700	INFO	light-client	light-client/main.go:91	Starting client...
2024-09-18T15:45:01.238-0700	INFO	light-client	light-client/main.go:97	Client identity: 0x51b6D674514849aF97FB77BCac51bcdD7799842C
...

Uninstall the Light Client

$HOME/.covalent/uninstall.sh

3. Run with Pre-complied Binaries

Running from Binaries

Install IPFS Kubo Client (If Not Already Installed)

brew install ipfs

Configure IPFS Kubo Client

ipfs init

Download Binary for Your Platform

Get the required pre-compiled binaries for Ubuntu or macOS from the Releases page.

Run the Light Client

You need to provide the PRIVATE_KEY of your burner address, which was generated as part of Prerequisites Step 2.

./bin/light-client --rpc-url <rpc-url> \
    --collect-url <collect-url> \
    --private-key <private-key>

Command:

./bin/light-client --rpc-url ws://coordinator.das.test.covalentnetwork.org/rpc --collect-url https://us-central1-covalent-network-team-sandbox.cloudfunctions.net/ewm-das-collector --private-key ${PRIVATE_KEY}

Check the Status of the Light Client

tail -n 1000 -f $HOME/.covalent/light-client.log

4. Build & Run from Source

Building from the Source

Clone the Repository

git clone https://github.com/covalenthq/ewm-das
cd ewm-das

Install Dependencies

make deps

Build Binaries

make

Note: The binaries will be built in the bin directory.

Run the Light Client

You need to provide the PRIVATE_KEY of your burner address, which was generated as part of Prerequisites Step 2.

./bin/light-client --rpc-url <rpc-url> \
    --collect-url <collect-url> \
    --private-key <private-key>

Command:

./bin/light-client --rpc-url ws://coordinator.das.test.covalentnetwork.org/rpc --collect-url https://us-central1-covalent-network-team-sandbox.cloudfunctions.net/ewm-das-collector --private-key ${PRIVATE_KEY}

Check the Status of the Light Client

tail -n 1000 -f $HOME/.covalent/light-client.log

Expected Output: For version details, please refer to our Discord’s light-client channel.

Version: v0.x.0, commit: 8d6709bee9e79d3c4e6ece35fed65da02f3850f4
2024-09-18T15:45:01.238-0700	INFO	light-client	light-client/main.go:91	Starting client...
2024-09-18T15:45:01.238-0700	INFO	light-client	light-client/main.go:97	Client identity: 0x51b6D674514849aF97FB77BCac51bcdD7799842C
...

Clean Up Build Artifacts

To remove build artifacts, run:

make clean

Get Started

CXT - Covalent Network Token

Run a node

Resources

1. Run with Docker Compose

Instructions to Run EWM Light Client with Docker

For Windows:

2. Run using Installer for macOS only:

Running Light Client on macOS

3. Run with Pre-complied Binaries

Running from Binaries

4. Build & Run from Source

Building from the Source

​1. Run with Docker Compose

​Instructions to Run EWM Light Client with Docker

​For Windows:

​2. Run using Installer for macOS only:

​Running Light Client on macOS

​3. Run with Pre-complied Binaries

​Running from Binaries

​4. Build & Run from Source

​Building from the Source

1. Run with Docker Compose

Instructions to Run EWM Light Client with Docker

For Windows:

2. Run using Installer for macOS only:

Running Light Client on macOS

3. Run with Pre-complied Binaries

Running from Binaries

4. Build & Run from Source

Building from the Source