Skip to main content

Documentation Index

Fetch the complete documentation index at: https://covalenthq.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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