Validator Info

Web3 Blockchain Explorer. Validator, Mining Pool, Token and Network Real-time Metrics

Interactive Onchain Dashboard

Managed by a team of humans and AI

Self-hosted on off the grid infrastructure in the Atlantic ocean

25+ chains. Decentralzied Forum. P2P chat. Token Swap. Web3 Login. Live, interactive data indexed on our own hardware

Unique design. Interactive UI. Private dashboards. AI chatbot and more...

| Blog | X | Docs | Design Assets | BE GOOD License |

🄳 🄵 🅽 🄍 ⚀ 🌐

---

Getting Started

Prerequisites

Make sure you have the following installed on your system:

sudo apt install cmdtest
sudo apt install nodejs
sudo apt install npm
sudo apt install build-essential
npm install --global yarn
yarn global add pm2

Clone repo

git clone https://github.com/citizenweb3/validatorinfo.git validatorinfo
cd validatorinfo

Prepare Environment and Makefile

cp .env.example .env
cp Makefile.example Makefile

Install dependencies

yarn

Development

make create-deps
make generate-client
make deploy-migrations
make init-chains
make generate-schema
yarn dev

Build

make create-deps
make generate-client
make deploy-migrations
make init-chains
make generate-schema
yarn build

Start Built Project

pm2 start "yarn start" --name next
pm2 start "make start-indexer" --name indexer

---

Docker Development Environment

Using Docker Compose (Recommended)

Docker Compose provides a fully isolated development environment with all required services.

1. Ensure Docker and Docker Compose are installed on your system.

2. Set up environment variables:

cp .env.example .env

Required variables in .env file:

# Database
POSTGRES_DB=validatorinfo_db
POSTGRES_USER=validatorinfo_user
POSTGRES_PASSWORD=mysecretpassword

# Front and indexer environment
PUBLIC_URL=localhost
REDIS_HOST=redis
VALIDATORS_APP_TOKEN="<your_token>"

3. Start the project:

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

This will start:

• PostgreSQL (port 5432)
• Redis (port 6379)
• Migrations service (automatic database setup)
• Frontend application (port 3000)
• Indexer service (port 3001)