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

1

Clone the Repository

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

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
3

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
4

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

1

Install IPFS Kubo Client (If Not Already Installed)

brew install ipfs
2

Configure IPFS Kubo Client

ipfs init
3

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:

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

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

4

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
...
5

Uninstall the Light Client

$HOME/.covalent/uninstall.sh

​
3. Run with Pre-complied Binaries

​
Running from Binaries

1

Install IPFS Kubo Client (If Not Already Installed)

brew install ipfs
2

Configure IPFS Kubo Client

ipfs init
3

Download Binary for Your Platform

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

4

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}
5

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

1

Clone the Repository

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

Install Dependencies

make deps
3

Build Binaries

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

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}
5

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
...
6

Clean Up Build Artifacts

To remove build artifacts, run:

make clean
Setup EWM Light Client NodeGlossary