search
Ctrlk
CommunityPromo VPS

Installation

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 

    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

  • 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=grpc.testnet.layeredge.io: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'

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:

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:

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

hashtag
Connecting CLI Node with LayerEdge Dashboard

To link your CLI node with the dashboard for analytics:

Fetch Points via CLI

Replace {walletAddress} with your actual CLI wallet address.

Connect to Dashboard

  1. Navigate to dashboard.layeredge.ioarrow-up-right

  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

hashtag
Logging & Monitoring

The node provides comprehensive logs for:

  • Merkle tree discovery

  • ZK proof generation and verification

  • Submission status

  • Performance optimizations (tree sleep state)

hashtag
Security Best Practices

  • Always store keys, mnemonics, and AUTHKEY offline.

  • Utilize firewall protections and secure SSH configurations.

  • Regularly update nodes from official LayerEdge sources.

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

PreviousLayerEdgeNextAutomation

Last updated