A web interface for consolidating and managing validator data. Network supported: Gnosis Chain, Ethereum, Chiado, Sepolia.
- View and filter validator information
- Aggregate and consolidate validator data
Clone the repository and install dependencies:
pnpm installCopy the .env.example file to .env and fill in the values (see
Environment variables).
Start the app locally:
pnpm devThe app will be available at http://localhost:3000.
To build the app for production:
pnpm buildValidated at startup by src/env.ts; a missing required
variable fails the build/boot with a clear error. See .env.example for the
full list.
| Variable | Required | Purpose |
|---|---|---|
GNOSIS_VALIDATORS_API_URL / GNOSIS_VALIDATORS_API_KEY |
✅ | Validator indexer for Gnosis (/api/validators-by-address) |
CHIADO_VALIDATORS_API_URL / CHIADO_VALIDATORS_API_KEY |
✅ | Validator indexer for Chiado |
GRAPHQL_URL |
– | Deposit-event lookups (/api/validate-deposit) |
NEXT_PUBLIC_QUICKNODE_ENDPOINT / NEXT_PUBLIC_QUICKNODE_TOKEN |
– | QuickNode RPC for Ethereum mainnet/Sepolia only |
Set SKIP_ENV_VALIDATION=1 to bypass validation (used by CI builds, which run
without secrets).
| Command | Description |
|---|---|
pnpm dev |
Start the dev server |
pnpm build / pnpm start |
Production build / serve |
pnpm typecheck |
tsc --noEmit |
pnpm lint / pnpm lint:fix |
ESLint (Next flat config) |
pnpm format / pnpm format:check |
Prettier write / check |
pnpm clean |
Remove .next, node_modules, build info |
pnpm audit |
Dependency security audit |
Git hooks (husky) run automatically: pre-commit formats/lints staged files
via lint-staged, pre-push runs pnpm typecheck.
src/components/– React componentssrc/hooks/– Custom React hookssrc/constants/– Network and configuration constantssrc/types/– TypeScript type definitionssrc/utils/– Utility functions
Contributions are welcome! Please open issues or submit pull requests for improvements or bug fixes.