Troubleshooting

Common issues and their solutions

Planned Feature

This feature is planned for future development. Documentation is preliminary.

Overview

This guide covers common issues encountered when running a ComputeNet validator and their solutions.

Planned Documentation

Comprehensive troubleshooting documentation will be developed based on testnet operational experience.

Common Issues

The following categories of issues are commonly encountered:

Sync Issues

  • Node stuck syncing
  • Peer discovery failures
  • Chain reorganization handling

Performance Issues

  • High proof generation latency
  • Memory exhaustion
  • Disk I/O bottlenecks

Network Issues

  • Connection timeouts
  • NAT traversal problems
  • Firewall configuration

Consensus Issues

  • Missed attestations
  • Invalid proof rejections
  • Slashing events

Diagnostic Commands

Useful commands for diagnosing issues (planned):

terminal
# Check node status
computenet status

# View sync progress
computenet sync status

# Check peer connections
computenet peers list

# View recent logs
computenet logs --tail 100

# Diagnostic report
computenet debug report

Getting Help

If you encounter issues not covered here:

  • Check the GitHub issues for known problems
  • Join the community Discord for support
  • Review validator announcements for known issues
PreviousMonitoringNextBuilding on ComputeNet