0G DA Client

This document outlines the steps to setup your own DA client.

DISCLAIMER: This guide is for informational purposes only. Always verify steps with official documentation and ensure you fully understand each action before proceeding.

Hardware Requirement

The following hardware specifications are recommended for running a DA client:

• RAM: 8 GB

• CPU: 2 cores

• Bandwidth: 100 MBps for Download / Upload

1. Install dependencies

sudo apt-get update
sudo apt-get install cmake 

2. Install go

cd $HOME && \
ver="1.22.0" && \
wget "https://golang.org/dl/go$ver.linux-amd64.tar.gz" && \
sudo rm -rf /usr/local/go && \
sudo tar -C /usr/local -xzf "go$ver.linux-amd64.tar.gz" && \
rm "go$ver.linux-amd64.tar.gz" && \
echo "export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin" >> ~/.bash_profile && \
source ~/.bash_profile && \
go version

3. Download the source code

git clone -b v1.0.0-testnet https://github.com/0glabs/0g-da-client.git

Configuration

nano /root/0g-da-client/disperser/Makefile

Replace: --chain.rpc

--chain.private-key

--batcher.storage.flow-contract

Sample Makefile:

clean:
	rm -rf ./bin

build: build_server build_batcher build_encoder build_combined 

build_batcher:
	go build -o ./bin/batcher ./cmd/batcher

build_server:
	go build -o ./bin/server ./cmd/apiserver

build_encoder:
	go build -o ./bin/encoder ./cmd/encoder

build_combined: build_server build_batcher
	go build -o ./bin/combined ./cmd/combined_server

run_batcher: build_batcher
	./bin/batcher \
	--batcher.pull-interval 5s \
	--chain.rpc "https://evmrpc-testnet.0g.ai" \
	--chain.private-key "28dxxxxxxx9d64f93310xxxxx561ee411f40" \
	--chain.receipt-wait-rounds 180 \
	--chain.receipt-wait-interval 1s \
	--chain.gas-limit 2000000 \
	--batcher.finalizer-interval 300s \
	--batcher.confirmer-num 3 \
	--batcher.aws.region us-east-1 \
	--batcher.aws.access-key-id localstack \
	--batcher.aws.secret-access-key localstack \
	--batcher.aws.endpoint-url http://0.0.0.0:4566 \
	--batcher.s3-bucket-name test-zgda-blobstore \
	--batcher.dynamodb-table-name test-BlobMetadata \
	--encoder-socket 0.0.0.0:34000 \
	--batcher.batch-size-limit 50 \
	--batcher.srs-order 300000 \
	--encoding-timeout 10s \
	--chain-read-timeout 12s \
	--chain-write-timeout 13s \
	--batcher.storage.node-url http://0.0.0.0:5678 \
	--batcher.storage.node-url http://0.0.0.0:6789 \
	--batcher.storage.kv-url http://0.0.0.0:7890 \
	--batcher.storage.kv-stream-id 000000000000000000000000000000000000000000000000000000000000f2bd \
	--batcher.storage.flow-contract	"0xB7e39604f47c0e4a6Ad092a281c1A8429c2440d3"

run_server: build_server
	./bin/server \
	--disperser-server.grpc-port 51001 \
	--disperser-server.s3-bucket-name test-zgda-blobstore \
	--disperser-server.dynamodb-table-name test-BlobMetadata \
	--disperser-server.aws.region us-east-1 \
	--disperser-server.aws.access-key-id localstack \
	--disperser-server.aws.secret-access-key localstack \
	--disperser-server.aws.endpoint-url http://0.0.0.0:4566 \

run_encoder: build_encoder
	./bin/encoder \
	--disperser-encoder.grpc-port 34000 \
  --disperser-encoder.metrics-http-port 9109 \
  --kzg.g1-path ../inabox/resources/kzg/g1.point.300000 \
  --kzg.g2-path ../inabox/resources/kzg/g2.point.300000 \
  --kzg.cache-path ../inabox/resources/kzg/SRSTables \
  --kzg.srs-order 300000 \
  --kzg.num-workers 12 \
  --disperser-encoder.log.level-std trace \
  --disperser-encoder.log.level-file trace

run_combined: build_combined
	./bin/combined \
	--chain.rpc "https://evmrpc-testnet.0g.ai" \
	--chain.private-key "28dxxxxxxx9d64f93310xxxxx561ee411f40" \
	--chain.receipt-wait-rounds 180 \
	--chain.receipt-wait-interval 1s \
	--chain.gas-limit 2000000 \
	--combined-server.use-memory-db \
	--combined-server.storage.node-url http://0.0.0.0:5678 \
	--combined-server.storage.node-url http://0.0.0.0:6789 \
	--combined-server.storage.kv-url http://0.0.0.0:7890 \
	--combined-server.storage.kv-stream-id 000000000000000000000000000000000000000000000000000000000000f2bd \
	--combined-server.storage.flow-contract	"0xB7e39604f47c0e4a6Ad092a281c1A8429c2440d3" \
	--disperser-server.s3-bucket-name test-zgda-blobstore \
	--disperser-server.dynamodb-table-name test-BlobMetadata \
	--disperser-server.grpc-port 51001 \
	--batcher.s3-bucket-name test-zgda-blobstore \
	--batcher.dynamodb-table-name test-BlobMetadata \
	--batcher.pull-interval 5s \
	--batcher.finalizer-interval 20s \
	--batcher.confirmer-num 3 \
	--encoder-socket 0.0.0.0:34000 \
	--batcher.batch-size-limit 50 \
	--batcher.srs-order 300000 \
	--encoding-timeout 10s \
	--chain-read-timeout 12s \
	--chain-write-timeout 13s

4. Build combined server

cd /root/0g-da-client/disperser
make build

5. Creat service

sudo tee /etc/systemd/system/0gdacli.service > /dev/null <<EOF
[Unit]
Description=0G-DA-ClI Node
After=network.target

[Service]
User=root
WorkingDirectory=/root/0g-da-client/disperser
ExecStart=/usr/bin/make run_combined
Restart=always
RestartSec=10
LimitNOFILE=65535
Environment="PATH=/usr/local/go/bin:/usr/bin:/bin"

[Install]
WantedBy=multi-user.target
EOF

6. Start service

sudo systemctl daemon-reload && \
sudo systemctl enable 0gdacli && \
sudo systemctl start 0gdacli && \
sudo systemctl status 0gdacli

Check log:

sudo journalctl -u 0gdacli -f -o cat

# Stop Service and Delete node:

sudo systemctl stop 0gdacli
sudo systemctl disable 0gdacli
sudo rm /etc/systemd/system/0gdacli.service
rm -rf $HOME/0g-da-client