Conspulse

Conspulse is a modern Tendermint validator dashboard for networks like the Polygon. It provides real-time consensus state, validator stats, and network insights, helping users and operators monitor validator performance and network health.

Features

• Live consensus state and validator stats
• Auto-refresh every block
• Favourites and sorting for validators
• Voting and precommit status per validator

Getting Started

Server Setup

Prerequisites

• Node.js (v22+ recommended)
• Click House Database
• npm

1. Clone the repository:

git clone https://github.com/vitwit/conspulse
cd conspulse/server

2. Install dependencies:

npm install

3. Create a .env file with the following contents:

API_SECRET=api-secret
CLICKHOUSE_HOST=http://localhost:8123
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=your_secure_password
CLICKHOUSE_DATABASE=default
PORT=3000
RPC_URL=http://localhost:26657

4. Running the Server

npm run dev

Frontend Setup

1. Checkout to frontend directory

cd dashboard

2. Setup .env file

NEXT_PUBLIC_RPC_URL=http://localhost:26657/
NEXT_PUBLIC_NETWORK_NAME=Polygon Localnet
NEXT_PUBLIC_SCRIPT_API_URL=http://localhost:8080
NEXT_PUBLIC_WEBSOCKET = ws://localhost:26657/
NEXT_PUBLIC_METRICS_BACKEND_URL= http://localhost:3000
NEXT_PUBLIC_EXPLORER_URL=https://polygonscan.com/address/

2. Install dependencies

npm install

3. Build and Start the server

npm run build && npm start

4. Visit http://localhost:3000 in your browser.

Running the IAVLViewer Backend

The dashboard can connect to a Go-based backend for comparing Cosmos SDK node databases (for consensus/apphash debugging).

To run the backend server:

cd scripts/iavlviewer
./iavlviewer --server --port=8080

• The API will be available at http://localhost:8080/compare.
• Verify the API at http://localhost:8080/health.
• You can change the port as needed.

Environment Variables

• NEXT_PUBLIC_RPC_URL: Tendermint RPC endpoint (must support /consensus_state and /validators?height=)
• NEXT_PUBLIC_NETWORK_NAME: Name of the network (displayed in the UI)
• NEXT_PUBLIC_SCRIPT_API_URL: URL of the iavlviewer backend (e.g. http://localhost:8080)

Contact & Support

• Email: contact@vitwit.com
• Telegram: @vitwit
• Twitter: @vitwit
• GitHub: vitwit

---

Powered by Vitwit