Nox Indexer

Indexes mix nodes registered on the NoxRegistry contract. Polls the chain for registrations, scrapes node metrics over SSE, tracks uptime with an EMA score, and serves everything over HTTP + WebSocket.

Setup

Prerequisites: Rust 1.75+ and PostgreSQL 14+

docker run -d --name nox-postgres -p 5432:5432 \
  -e POSTGRES_DB=indexer -e POSTGRES_HOST_AUTH_METHOD=trust \
  postgres:17-alpine

# configure
cp .env.sample .env

# run
cargo run

tables are created automatically on first run.

Config

All options are configurable via env vars or CLI flags. See .env.sample for defaults.

Variable	Description	Required
REGISTRY_ADDRESS	NoxRegistry contract address	Yes
ETH_RPC_URL	RPC endpoint	Yes (testnet/mainnet)
DATABASE_URL	Postgres connection string	Yes
NETWORK	localtestnet, testnet, or mainnet	No
FROM_BLOCK	Contract deployment block (skips genesis scan)	No

API

GET  /v1/state        nodes + metrics + events + reputation
GET  /v1/reputation   uptime rankings
GET  /healthz         returns 200 if db is up
WS   /v1/live         pushes CLUSTER / METRICS / EVENT messages

Docker

docker build -t nox-indexer .
docker run -d -p 4000:4000 --env-file .env nox-indexer

Reputation Scoring

Node uptime is tracked via an exponential moving average (EMA) computed every check interval (default: 60s). Scores range from 0 to 100 based on /metrics/json endpoint availability.

Parameter	Value
Alpha (α)	0.01
Responsive sample	100
Unresponsive sample	0
Stale penalty (>6h without check)	5% per round

New nodes initialize from their first check result. Deregistered nodes are excluded from rankings.

License

MIT