LayerEdge Light Node Setup Guide

A comprehensive guide for setting up and running a LayerEdge Light Node

Features • Prerequisites • Installation • Configuration • Troubleshooting

Table of Contents

• Features
• Prerequisites
• System Requirements
• Installation
  • Installing Dependencies
  • RISC0 Installation
  • LayerEdge Setup
• Configuration
• Running the Node
• Monitoring
• Troubleshooting
• Security Recommendations
• Contributing
• Support
• License

Features

• Full Light Node implementation for LayerEdge network
• Merkle tree verification and proof generation
• Dashboard integration for monitoring
• Secure and efficient proof aggregation
• Points tracking system

Prerequisites

Before you begin, ensure you have the following installed:

• Operating System: Ubuntu 20.04+, macOS 12+, or Windows with WSL2
• Go: Version 1.18 or higher
• Rust: Latest stable version
• Git: Latest version
• CMake: Version 3.12 or higher
• Build Essential Tools

System Requirements

• CPU: 4+ cores recommended
• RAM: Minimum 8GB, 16GB recommended
• Storage: 50GB+ free space
• Network: Stable internet connection

Installation

Installing Dependencies

Ubuntu/Debian

# Update system
sudo apt update && sudo apt upgrade -y

# Install essential packages
sudo apt install -y build-essential cmake pkg-config libssl-dev clang git curl

# Install Go
wget https://go.dev/dl/go1.21.6.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.21.6.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

macOS

# Install Homebrew if not installed
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install dependencies
brew install go cmake pkg-config openssl git

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

Windows (WSL)

# Install WSL if not already installed (run in PowerShell as Administrator)
# wsl --install

# After WSL is installed and you're in Ubuntu on WSL:

# Update system
sudo apt update && sudo apt upgrade -y

# Install essential packages
sudo apt install -y build-essential cmake pkg-config libssl-dev clang git curl

# Install Go
wget https://go.dev/dl/go1.21.6.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.21.6.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

Termux (with Ubuntu)

# Install Termux from F-Droid and run:

# Update Termux packages
pkg update && pkg upgrade -y

# Install required packages in Termux
pkg install proot-distro curl

# Install Ubuntu in Termux
proot-distro install ubuntu

# Login to Ubuntu
proot-distro login ubuntu

# Now inside Ubuntu in Termux:
# Update system
apt update && apt upgrade -y

# Install essential packages
apt install -y build-essential cmake pkg-config libssl-dev clang git curl wget

# Install Go
wget https://go.dev/dl/go1.21.6.linux-amd64.tar.gz
rm -rf /usr/local/go
tar -C /usr/local -xzf go1.21.6.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

RISC0 Installation

# Add Rust components
rustup component add rustfmt
rustup component add clippy
rustup target add wasm32-unknown-unknown

# Clone RISC0 repository
git clone https://github.com/risc0/risc0.git
cd risc0

# Checkout stable version
git checkout v0.19.1

# Build RISC0
cargo build --release

# Add to PATH
echo 'export PATH=$PATH:'\"$HOME/risc0/target/release\" >> ~/.bashrc
source ~/.bashrc

LayerEdge Setup

# Clone LayerEdge repository
git clone https://github.com/Layer-Edge/light-node.git
cd light-node

# Create environment file
cat > .env << EOL
GRPC_URL=34.31.74.109:9090
CONTRACT_ADDR=cosmos1ufs3tlq4umljk0qfe8k5ya0x6hpavn897u2cnf9k0en9jr7qarqqt56709
ZK_PROVER_URL=http://127.0.0.1:3001
API_REQUEST_TIMEOUT=100
POINTS_API=https://light-node.layeredge.io
PRIVATE_KEY='your-private-key'
EOL

Configuration

Environment Variables

Variable	Description	Default
GRPC_URL	LayerEdge gRPC endpoint	34.31.74.109:9090
CONTRACT_ADDR	Smart contract address	cosmos1ufs...
ZK_PROVER_URL	RISC0 prover service URL	http://127.0.0.1:3001
API_REQUEST_TIMEOUT	API timeout in seconds	100
POINTS_API	Points tracking API endpoint	https://light-node.layeredge.io
PRIVATE_KEY	Your wallet private key	-

Running the Node

1. Start the Merkle Service

cd risc0-merkle-service
cargo build && cargo run

2. Run the Light Node

# In a new terminal
cd light-node
go build ./light-node
./light-node

Monitoring

Dashboard Integration

1. Visit dashboard.layeredge.io
2. Connect your wallet
3. Link your CLI node's Public Key

Logging

The node provides comprehensive logs for:

• Merkle tree operations
• ZK proof generation
• Verification status
• Performance metrics

Troubleshooting

Common Issues and Solutions

RISC0 Installation Issues

# If compilation fails
rustup update
cargo clean
cargo build --release

# Missing dependencies
sudo apt install -y libclang-dev  # Ubuntu
brew install llvm  # macOS

# Memory issues
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

Node Connection Issues

1. gRPC Connection Failed

   • Verify GRPC_URL in .env
   • Check network connectivity
   • Ensure ports are open

2. Merkle Service Issues

   • Verify RISC0 installation
   • Check system resources
   • Review service logs

3. Wallet Connection Issues

   • Verify PRIVATE_KEY in .env
   • Check wallet balance
   • Ensure correct network configuration

Platform-Specific Issues

Termux Issues

1. Storage Permission

   • Run termux-setup-storage to grant storage permissions
   • Restart Termux after granting permissions

2. Memory Limitations

   • Reduce compilation parallelism with export CARGO_BUILD_JOBS=1
   • Close other apps before building resource-intensive components

3. Ubuntu PRoot Issues

   • If Ubuntu fails to start: proot-distro reset ubuntu
   • For DNS issues: echo "nameserver 8.8.8.8" > ~/resolv.conf && proot-distro login ubuntu --bind ~/resolv.conf:/etc/resolv.conf

Windows WSL Issues

1. WSL Performance

   • Store project files in the Linux filesystem, not Windows-mounted drives
   • Add to .wslconfig in Windows user directory:

     [wsl2]
     memory=8GB
     processors=4
     

2. File Permissions

   • If getting permission errors: chmod -R 755 ./light-node
   • For git issues: git config --global core.fileMode false

3. Network Connectivity

   • If gRPC connection fails, check Windows firewall settings
   • Try wsl --shutdown and restart WSL if network issues persist

Security Recommendations

1. Private Key Management

   • Store private keys securely
   • Use environment variables
   • Never commit sensitive data

2. System Security

   • Keep system updated
   • Use firewall protection
   • Regular security audits

3. Backup Procedures

   • Regular configuration backups
   • Secure key storage
   • Document recovery procedures

🌐 Connect With Me