Validator Kit

The Mezo Validator Kit provides a comprehensive solution for running Mezo nodes, including validators, RPC nodes, and seed nodes. This guide covers setup, configuration, and maintenance of Mezo infrastructure.

Overview

The Validator Kit simplifies the deployment of Mezo nodes with multiple deployment options:

Docker: Containerized deployment
Native Daemon: Direct system installation
Kubernetes: Helm charts for orchestration
Cloud Deployment: AWS, GCP, Azure support

Node Types

Validator Nodes: Participate in consensus and block production
RPC Nodes: Provide API endpoints for dApps
Seed Nodes: Help bootstrap the network

Repository Structure

The Validator Kit repository includes:

Docker Configuration: Container setup and orchestration
Kubernetes Manifests: Helm charts and K8s resources
Configuration Templates: Node configuration files
Monitoring: Prometheus, Grafana, and alerting
Scripts: Automation and maintenance tools

Hardware Requirements

Minimum Requirements

Validator Node:

CPU: 4 cores
RAM: 8GB
Storage: 100GB SSD
Network: 100 Mbps

RPC Node:

CPU: 2 cores
RAM: 4GB
Storage: 50GB SSD
Network: 50 Mbps

Seed Node:

CPU: 1 core
RAM: 2GB
Storage: 20GB SSD
Network: 10 Mbps

Recommended Requirements

Validator Node:

CPU: 8 cores
RAM: 16GB
Storage: 500GB NVMe SSD
Network: 1 Gbps

For production validator nodes, we strongly recommend using the recommended specifications to ensure optimal performance and reliability.

Installation Methods

Docker Deployment

Clone Repository

Clone the validator kit repository:

git clone https://github.com/mezo-org/validator-kit.git
cd validator-kit

Configure Environment

Copy the example environment file and edit it with your configuration:

cp .env.example .env
# Edit .env with your configuration

Start Node

Start your node using Docker Compose:

docker-compose up -d

Native Installation

Install Dependencies

Install required dependencies and Go:

sudo apt update
sudo apt install -y curl git make build-essential

# Install Go
curl -fsSL https://go.dev/dl/go1.21.0.linux-amd64.tar.gz | sudo tar -xzC /usr/local

Build Mezod

Clone and build the mezod client:

git clone https://github.com/mezo-org/mezod.git
cd mezod
make build

Configure Node

Initialize your node:

./mezod init mynode --chain-id mezo-testnet

Kubernetes Deployment

Install Helm

Install Helm package manager:

curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

Deploy with Helm

Deploy your node using the Helm chart:

helm install mezo-node ./helm/mezo-node \
  --set node.type=validator \
  --set node.name=my-validator

Configuration

Node Configuration

[consensus]
timeout_commit = "1s"
timeout_propose = "3s"

[p2p]
laddr = "tcp://0.0.0.0:26656"
external_address = "YOUR_EXTERNAL_IP:26656"
persistent_peers = "peer1@ip1:26656,peer2@ip2:26656"

Environment Variables

.env

# Node configuration
NODE_TYPE=validator
CHAIN_ID=mezo-mainnet
MONIKER=my-validator

# Network configuration
P2P_PORT=26656
RPC_PORT=26657
API_PORT=1317
GRPC_PORT=9090
EVM_RPC_PORT=8545

# Security
PRIV_VALIDATOR_KEY_FILE=/config/priv_validator_key.json
NODE_KEY_FILE=/config/node_key.json

Validator Setup

Prerequisites

Proof of Authority (PoA)

Apply for validator status through the official channels

Stake Requirements

Ensure you meet the minimum stake amount

Technical Requirements

Verify your hardware meets the specifications

Validator Configuration

# Initialize validator
./mezod init validator --chain-id mezo-mainnet

Never commit validator keys to version control! Store them securely using hardware security modules (HSM) or secure key management systems.

RPC Node Setup

Purpose

RPC nodes provide:

API Endpoints: REST and gRPC APIs
EVM RPC: Ethereum-compatible JSON-RPC
WebSocket: Real-time data streams
Load Balancing: Distribute traffic across nodes

Configuration

docker-compose.yml

version: '3.8'
services:
  rpc-node:
    image: mezod:latest
    ports:
      - "26657:26657"  # Tendermint RPC
      - "1317:1317"    # Cosmos API
      - "9090:9090"    # gRPC
      - "8545:8545"    # EVM RPC
    environment:
      - NODE_TYPE=rpc
      - CHAIN_ID=mezo-mainnet
    volumes:
      - ./data:/root/.mezod

Monitoring and Observability

Prometheus Configuration

prometheus.yml

global:
  scrape_interval: 15s

scrape_configs:
  - job_name: 'mezod'
    static_configs:
      - targets: ['localhost:26660']
    metrics_path: /metrics

Key Metrics

Monitor these critical metrics for your node:

Block Height: Current blockchain height
Validator Status: Active/inactive status
Network Connectivity: Peer connections
Resource Usage: CPU, memory, disk
Transaction Throughput: TPS metrics

Alerting Rules

alerts.yml

groups:
  - name: mezod
    rules:
      - alert: NodeDown
        expr: up{job="mezod"} == 0
        for: 1m
        labels:
          severity: critical
        annotations:
          summary: "Mezod node is down"

Security Best Practices

Network Security

Firewall Configuration

Configure firewall to allow only necessary ports:

# Allow only necessary ports
ufw allow 26656/tcp  # P2P
ufw allow 26657/tcp  # RPC
ufw allow 1317/tcp   # API
ufw allow 8545/tcp   # EVM RPC

Access Control

Restrict RPC access to trusted IPs:

# Restrict RPC access
iptables -A INPUT -p tcp --dport 26657 -s TRUSTED_IP -j ACCEPT
iptables -A INPUT -p tcp --dport 26657 -j DROP

Key Management

Secure Storage: Use hardware security modules (HSM)
Backup Strategy: Regular key backups
Access Control: Limit key access permissions

Never commit validator keys to version control! This is critical for maintaining the security of your validator.

Maintenance

Regular Tasks

# Update mezod
git pull origin main
make build
systemctl restart mezod

Backup Strategy

Configuration Backup

Backup your node configuration:

tar -czf config-backup.tar.gz ~/.mezod/config/

Key Backup

Backup validator keys to a secure location:

# Backup validator keys to secure location
cp ~/.mezod/config/priv_validator_key.json /secure/backup/

Store key backups in a secure, offline location with appropriate encryption and access controls.

Troubleshooting

Common Issues

Sync Issues

Check sync status and reset if needed:

# Check sync status
./mezod status

# Reset and resync
./mezod tendermint unsafe-reset-all

Connection Problems

Verify peer connections:

# Check peer connections
./mezod tendermint show-node-id

# Update persistent peers in config.toml

Performance Issues

Monitor resource usage:

# Monitor resource usage
htop
iotop
netstat -tulpn

Debug Commands

journalctl -u mezod -f

Development Integration

Local Development

Start Local Node

Start a local development node:

docker-compose -f docker-compose.dev.yml up

Connect dApp

Connect your dApp to the local node:

const provider = new ethers.JsonRpcProvider('http://localhost:8545');

Testing Environment

./mezod init testnode --chain-id mezo-testnet

Additional Resources

Validator Kit Repository - Main repository
Mezod Repository - Chain client
Mezo Nodes Overview - Node operations
Docker Documentation - Docker reference
Kubernetes Documentation - K8s reference

For detailed validator requirements, application processes, and advanced configurations, refer to the validator kit repository documentation.

Support

For validator support:

Join the Mezo Discord
Check the GitHub Issues
Review the FAQ

Get Started

Mezo Nodes

Architecture

Features

Bridge & MUSD

Reference

​Overview

​Node Types

​Repository Structure

​Hardware Requirements

​Minimum Requirements

​Recommended Requirements

​Installation Methods

​Docker Deployment

​Native Installation

​Kubernetes Deployment

​Configuration

​Node Configuration

​Environment Variables

​Validator Setup

​Prerequisites

​Validator Configuration

​RPC Node Setup

​Purpose

​Configuration

​Monitoring and Observability

​Prometheus Configuration

​Key Metrics

​Alerting Rules

​Security Best Practices

​Network Security

​Key Management

​Maintenance

​Regular Tasks

​Backup Strategy

​Troubleshooting

​Common Issues

​Debug Commands

​Development Integration

​Local Development

​Testing Environment

​Additional Resources

​Support

Build docs developers (and LLMs) love

Overview

Node Types

Repository Structure

Hardware Requirements

Minimum Requirements

Recommended Requirements

Installation Methods

Docker Deployment

Native Installation

Kubernetes Deployment

Configuration

Node Configuration

Environment Variables

Validator Setup

Prerequisites

Validator Configuration

RPC Node Setup

Purpose

Configuration

Monitoring and Observability

Prometheus Configuration

Key Metrics

Alerting Rules

Security Best Practices

Network Security

Key Management

Maintenance

Regular Tasks

Backup Strategy

Troubleshooting

Common Issues

Debug Commands

Development Integration

Local Development

Testing Environment

Additional Resources

Support