Validator Setup Guide
Setup validators with the Commit Boost module.
Quick Start
git clone https://github.com/ethgas-developer/ethgas-preconf-commit-boost-module
cd ethgas-preconf-commit-boost-module
cp .env.example .env
docker compose up -d
Prerequisites
Before setting up your validator, ensure you have:
- Docker & Docker Compose installed and running
- Validator Keys ready for registration
- Network Access to ETHGas endpoints
- Environment Configuration completed
Setup Process
1. Repository Setup
Primary Module:
- Repository: ethgas-preconf-commit-boost-module
- Purpose: Official validator integration module
- Features: Complete validator setup and management
Related Resources:
- Builder Scripts: ethgas-builder-scripts
- Preconf Builder: preconf-builder
- Contracts: ethgas-contracts-avs-for-audit
2. Environment Configuration
cp .env.example .env
nano .env
Key Configuration Variables:
| Variable | Description | Required |
|---|---|---|
| ETHGAS_API_URL | API endpoint URL | Yes |
| ETHGAS_WS_URL | WebSocket endpoint URL | Yes |
| VALIDATOR_KEYS | Your validator keys | Yes |
| NETWORK | MainNet or TestNet selection | Yes |
3. Consensus Client Selection
Choose your preferred consensus client:
| Client | Description | Documentation |
|---|---|---|
| Lighthouse | Rust-based client | Lighthouse Docs |
| Prysm | Go-based client | Prysm Docs |
| Teku | Java-based client | Teku Docs |
Recommendation
Choose a client based on your technical expertise and infrastructure requirements.
Lighthouse Configuration
If you're using Lighthouse, add this configuration to your commitboost.toml:
[timeouts]
# Lighthouse specific guidance
timeout_get_header_ms = 1950
4. Deployment
# Start the validator service
docker compose up -d
# Check service status
docker compose ps
# View logs
docker compose logs -f
Monitoring & Management
Service Status
Monitor your validator using the official API endpoints:
- Health Check: Verify service status
- Performance Metrics: Monitor validator performance
- Error Logs: Review and troubleshoot issues
API Integration
- Service monitoring endpoints
- Performance tracking
- Configuration management
- Error handling
API Endpoints: For programmatic checks and dashboards, start with the Validator API:
- Get user validators — List your registered validators and their status
You can combine this with your own system metrics (CPU, memory, disk, node logs) to build alerts and SLOs.
Troubleshooting
Common Issues
| Issue | Checks | Severity |
|---|---|---|
| Service Won't Start | ✅ Check Docker installation, verify environment configuration, review container logs | High |
| Connection Issues | ✅ Verify network connectivity, check API endpoint URLs, validate authentication credentials | Medium |
| Performance Problems | ✅ Monitor system resources, check consensus client logs, review validator configuration | Low |
Get Help
| Resource | Description | Type |
|---|---|---|
| GitHub Issues | Report bugs and request features | Bug Reports |
| ETHGas Community | Discord, forums, and community support | Community |
| Documentation | Official ETHGas developer docs and guides | Docs |
Useful Links
| Resource | URL | Description |
|---|---|---|
| ETHGas Platform | https://app.ethgas.com/my-portfolio/accounts | Main platform website |
| TestNet | https://testnet.ethgas.com/ | Test environment |
| GitHub Repo | https://github.com/ethgas-developer/ethgas-preconf-commit-boost-module | Commit Boost module source |
Next Steps
- Complete Setup — Follow the quick start guide above
- Configure Monitoring — Set up monitoring and alerts
- Test Integration — Verify all components work correctly
- Go Live — Deploy to production environment
Best Practice
Start with the TestNet environment to validate your setup before moving to production.