Core Validator Node Tool

TUI Tool for Setting up Testnet Validator Node

A robust Terminal User Interface (TUI) for setting up and managing Core testnet validator nodes. This installer provides an intuitive, dialog-based interface that simplifies the entire process from initial setup to ongoing maintenance.

Key Features

1. Installation & Setup

• Automated Hardware Verification

  • CPU cores check (minimum 4 cores)
  • RAM verification (minimum 8GB)
  • Storage space validation (minimum 1TB)
  • Network speed test (minimum 10 Mbps)
  • Real-time system requirements display

• Smart Dependency Management

  • Auto-detection of missing dependencies
  • Automated installation of required packages
  • Support for multiple package managers (apt, yum, brew)
  • Go version management and installation

• Robust Download System

  • Real-time progress display with percentage and speed
  • Automatic retry mechanism (up to 3 attempts)
  • Integrity verification of downloaded files
  • Support for large file downloads with progress tracking
  • Graceful handling of network interruptions

2. Node Management

• Validator Setup

  • Automated consensus key generation
  • Secure password management
  • Keystore file handling and verification
  • Clear display of validator addresses

• Node Operations

  • Start/stop node with status monitoring
  • Support for validator and non-validator modes
  • Automatic port conflict detection and resolution
  • Genesis initialization with error recovery
  • Snapshot synchronization support

3. Log Monitoring System

• Real-time Log Viewing

  • Live updates every 2 seconds
  • Color-coded output for different log levels
  • Automatic scroll with newest entries
  • Search functionality within logs

• Log Management

  • Log rotation and archiving
  • Export capabilities with timestamps
  • Log statistics and analysis
  • Error tracking and reporting

4. Error Handling & Recovery

• Intelligent Error Detection

  • Database consistency checks
  • Chain gap detection and resolution
  • Automatic recovery suggestions
  • Guided error resolution

• Recovery Options

  • Database reset capabilities
  • Snapshot-based recovery
  • Configuration reset options
  • Backup and restore functionality

5. Admin Dashboard

• System Maintenance

  • Clean build functionality
  • Chain deletion with safety checks
  • Configuration management
  • Permission repair tools

• System Monitoring

  • Resource usage tracking
  • Chain sync status
  • Node health monitoring
  • Performance metrics

Installation

1. Clone the repository:

   git clone https://github.com/coredao-org/core-validator-tui.git
   cd core-testnet-validator-node-installer/core-node-installer

2. Run the installer:

   ./install.sh

Usage Guide

Initial Setup

1. Hardware Check

   Main Menu → Check Hardware Requirements
   

   • Verifies system compatibility
   • Displays detailed hardware information
   • Provides recommendations if requirements aren't met

2. Node Installation

   Main Menu → Install Core Node
   

   • Guides through dependency installation
   • Handles repository cloning and building
   • Sets up node directory structure

3. Validator Setup

   Main Menu → Node Management → Generate Consensus Key
   

   • Creates and secures validator keys
   • Manages passwords and keystores
   • Displays validator address information

Node Management

1. Starting the Node

   Node Management → Start Node
   

   • Regular mode: Start Node
   • Validator mode: Start Node as Validator

2. Monitoring

   Node Management → View Node Status
   

   • Shows sync status
   • Displays validator information
   • Monitors performance metrics

3. Log Viewing

   Node Management → View Logs
   

   • Real-time log updates
   • Error highlighting
   • Search functionality

Advanced Features

1. Snapshot Management

   • Download with progress tracking
   • Integrity verification
   • Automatic retry on failure
   • Size verification and validation

2. Database Recovery

   • Handles chain gaps
   • Provides recovery options
   • Maintains data integrity
   • Guided recovery process

3. Configuration Management

   • Template-based configuration
   • Automatic backup creation
   • Reset capabilities
   • Validation checks

Troubleshooting

Common Issues

1. Download Failures

   • System automatically retries downloads
   • Provides detailed error information
   • Offers manual retry options
   • Verifies file integrity

2. Database Errors

   • Detects chain gaps
   • Offers reset or snapshot options
   • Guides through recovery process
   • Preserves existing data when possible

3. Node Startup Issues

   • Checks for port conflicts
   • Verifies keystore accessibility
   • Validates configurations
   • Provides detailed error messages

Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License.

Support

For issues and feature requests, please use the GitHub issue trackerm, reach out to us on Core Discord Server or Core Developer Forum.