Light Node Setup Guide

Follow these steps to set up and run your LayerEdge CLI Light Node efficiently.

Step 1: Clone the Light Node Repository

git clone https://github.com/Layer-Edge/light-node.git
cd light-node

Step 2: Install Required Dependencies

Ensure the following dependencies are installed:

• Go: Version 1.18 or higher

• Rust: Version 1.81.0 or higher

• Risc0 Toolchain: If not installed, run:

  curl -L https://risczero.com/install | bash && rzup install

• LayerEdge gRPC Endpoint: Ensure access to a LayerEdge node for seamless communication.

Step 3: Configure Environment Variables

Set up the required environment variables in your terminal session or add them to a .env file:

GRPC_URL=34.31.74.109:9090
CONTRACT_ADDR=cosmos1ufs3tlq4umljk0qfe8k5ya0x6hpavn897u2cnf9k0en9jr7qarqqt56709
ZK_PROVER_URL=http://127.0.0.1:3001
# Alternatively:
ZK_PROVER_URL=https://layeredge.mintair.xyz/
API_REQUEST_TIMEOUT=100
POINTS_API=https://light-node.layeredge.io
PRIVATE_KEY='cli-node-private-key'

Note: Replace 'cli-node-private-key' with the actual private key of the wallet address you choose to run the CLI from. Ensure that you store your private key securely and do not expose it in public repositories or logs.

Ensure that the ZK_PROVER_URL matches the server where the Merkle service is running.

Step 4: Start the Merkle Service

Before running the Light Node, start the Merkle service:

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

Wait until the Merkle service is fully initialized before proceeding.

Step 5: Build and Run the LayerEdge Light Node

In a separate terminal window, navigate to the root directory and execute:

go build
./light-node

Ensure that the Light Node is running independently and correctly connected to the Merkle service.

---

Connecting CLI Node with LayerEdge Dashboard

To link your CLI node with the dashboard for analytics:

Fetch Points via CLI

https://light-node.layeredge.io/api/cli-node/points/{walletAddress}

Replace {walletAddress} with your actual CLI wallet address.

Connect to Dashboard

1. Navigate to dashboard.layeredge.io

2. Connect your wallet

3. Link your CLI node’s Public Key

Important Notes:

• One CLI wallet can only link to one dashboard wallet.

• Linking is mandatory, even if the CLI and dashboard wallets are identical.

Dashboard Monitoring Features

• Node status (Active/Inactive)

• Points tracking & detailed analytics

---

Logging & Monitoring

The node provides comprehensive logs for:

• Merkle tree discovery

• ZK proof generation and verification

• Submission status

• Performance optimizations (tree sleep state)

---

Security Best Practices

• Always store keys, mnemonics, and AUTHKEY offline.

• Utilize firewall protections and secure SSH configurations.

• Regularly update nodes from official LayerEdge sources.

---

Troubleshooting Common Issues

Issue: gRPC connection is inactive. Solution: Verify gRPC connection settings.

Issue: Risc0 prover service is not running. Solution: Restart the prover service and check logs.

Issue: Incorrect wallet or signature configurations. Solution: Double-check wallet addresses and environment variables.

Consult detailed logs for more specific errors.

---

Need Help?

Encounter issues or have questions? Join our Discord community for immediate assistance: discord.gg/layeredge

---

License

Licensed under the MIT License. See the LICENSE file for details.