Skip to main content
Complete reference for Mezo network configurations including mainnet, testnet, and local development environments.

​
Network Endpoints

Mainnet

Production network for live deployments

Testnet

Testing environment for development

​
Mainnet Configuration

The Mezo mainnet is the production network for live deployments. 
{
  "chain_id": "mezo-mainnet",
  "rpc_endpoint": "https://rpc.mezo.org",
  "websocket": "wss://rpc.mezo.org/websocket",
  "explorer": "https://explorer.mezo.org"
}
Key Endpoints:
  • Chain ID: mezo-mainnet
  • RPC Endpoint: https://rpc.mezo.org
  • WebSocket: wss://rpc.mezo.org/websocket
  • Block Explorer: https://explorer.mezo.org

​
Testnet Configuration

The Mezo testnet provides a safe environment for testing and development. 
{
  "chain_id": "mezo-testnet",
  "rpc_endpoint": "https://testnet-rpc.mezo.org",
  "websocket": "wss://testnet-rpc.mezo.org/websocket",
  "explorer": "https://testnet-explorer.mezo.org"
}
Key Endpoints:
  • Chain ID: mezo-testnet
  • RPC Endpoint: https://testnet-rpc.mezo.org
  • WebSocket: wss://testnet-rpc.mezo.org/websocket
  • Block Explorer: https://testnet-explorer.mezo.org

​
Local Development

Configuration for running a local Mezo node.
Network Details
{
  "chain_id": "mezo-local",
  "rpc_endpoint": "http://localhost:26657",
  "websocket": "ws://localhost:26657/websocket"
}
Key Endpoints:
  • Chain ID: mezo-local
  • RPC Endpoint: http://localhost:26657
  • WebSocket: ws://localhost:26657/websocket

​
Chain Parameters

​
Consensus Configuration

Core consensus parameters for the Mezo chain.
config.toml
[consensus]
timeout_commit = "1s"
timeout_propose = "3s"
timeout_propose_delta = "500ms"
timeout_prevote = "1s"
timeout_prevote_delta = "500ms"
timeout_precommit = "1s"
timeout_precommit_delta = "500ms"

​
P2P Configuration

Peer-to-peer network settings.
config.toml
[p2p]
laddr = "tcp://0.0.0.0:26656"
external_address = "YOUR_EXTERNAL_IP:26656"
persistent_peers = "peer1@ip1:26656,peer2@ip2:26656"
unconditional_peer_ids = ""

​
API Configuration

REST API and service settings.
app.toml
[api]
enable = true
swagger = false
address = "tcp://0.0.0.0:1317"
max_open_connections = 1000
rpc_read_timeout = "10s"
rpc_write_timeout = "10s"
rpc_max_body_bytes = 1000000

​
EVM Configuration

​
Ethereum Compatibility

EVM-compatible settings for Ethereum tooling integration. 
[evm]
rpc_address = "0.0.0.0:8545"
ws_address = "0.0.0.0:8546"
api_address = "0.0.0.0:1317"
max_gas_price = "1000000000000"
min_gas_price = "1000000000"
The EVM configuration enables compatibility with Ethereum development tools like MetaMask, Hardhat, and Foundry.

​
Deployment

​
Docker Deployment

Deploy a Mezo node using Docker Compose.
docker-compose.yml
version: '3.8'

services:
  mezod:
    image: mezod:latest
    container_name: mezod-node
    ports:
      - "26656:26656"  # P2P
      - "26657:26657"  # RPC
      - "1317:1317"    # API
      - "8545:8545"    # EVM RPC
    volumes:
      - ./config:/root/.mezod/config
      - ./data:/root/.mezod/data
    environment:
      - CHAIN_ID=mezo-testnet
      - NODE_TYPE=validator
    command: mezod start

​
Automated Deployment Script

Bash script for deploying a Mezo node.
deploy-chain.sh
#!/bin/bash
set -e

CHAIN_ID=${1:-"mezo-testnet"}
NODE_TYPE=${2:-"validator"}

echo "Deploying $NODE_TYPE node for chain $CHAIN_ID"

# Clone chains repository
git clone https://github.com/mezo-org/chains.git
cd chains

# Copy configuration
cp configs/$CHAIN_ID/config.toml ~/.mezod/config/
cp configs/$CHAIN_ID/app.toml ~/.mezod/config/

# Initialize node
mezod init $NODE_TYPE --chain-id $CHAIN_ID

# Start node
mezod start

​
Security Configuration

​
Network Security

Firewall rules for securing your node.
firewall-setup.sh
# Allow necessary ports
ufw allow 26656/tcp  # P2P
ufw allow 26657/tcp  # RPC
ufw allow 1317/tcp   # API
ufw allow 8545/tcp   # EVM RPC

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

​
SSL/TLS Configuration

app.toml
[api]
tls_cert_file = "/path/to/cert.pem"
tls_key_file = "/path/to/key.pem"

​
Monitoring

​
Prometheus Configuration

Set up Prometheus monitoring for your Mezo node.
prometheus.yml
global:
  scrape_interval: 15s

scrape_configs:
  - job_name: 'mezod-mainnet'
    static_configs:
      - targets: ['rpc.mezo.org:26660']
    metrics_path: /metrics

  - job_name: 'mezod-testnet'
    static_configs:
      - targets: ['testnet-rpc.mezo.org:26660']
    metrics_path: /metrics

​
Troubleshooting

Configuration Errors

Validate and test your configuration files

Network Connectivity

Check RPC connectivity and peer connections

​
Common Issues

Configuration Validation: 
# Check configuration syntax
mezod config validate

# Test configuration
mezod start --dry-run
Network Connectivity: 
# Test RPC connectivity
curl -s http://localhost:26657/status | jq

# Check peer connections
mezod tendermint show-peers
Genesis Issues: 
# Validate genesis file
mezod validate-genesis

# Reset with new genesis
mezod tendermint unsafe-reset-all
Always refer to the latest configurations in the chains repository for up-to-date network parameters and endpoints.

​
Additional Resources

Chains Repository

Configuration files and network parameters

Validator Kit

Complete validator setup guide

Mezo Discord

Join the community for support

FAQ

Frequently asked questions

Build docs developers (and LLMs) love

Get started for freeTalk to us