LogoLogo
SDKAPI
Version-v1.4.0 (current)
Version-v1.4.0 (current)
  • Learn
    • Introduction
      • Obol Collective
      • OBOL Incentives
      • Key Staking Concepts
      • Obol vs Other DV Implementations
      • Obol Splits
      • DV Launchpad
      • Frequently Asked Questions
    • Charon
      • Introduction to Charon
      • Distributed Key Generation
      • Cluster Configuration
      • Charon Networking
      • CLI Reference
    • Futher Reading
      • Ethereum and Its Relationship With DVT
      • Community Testing
      • Peer Score
      • Useful Links
  • Run a DV
    • Quickstart
      • Quickstart Overview
      • Create a DV Alone
      • Create a DV With a Group
      • Push Metrics to Obol Monitoring
    • Prepare to Run a DV
      • How and Where To Run DVs
      • Deployment Best Practices
      • Test a Cluster
    • Running a DV
      • Activate a DV
      • Update a DV
      • Monitoring Your Node
      • Claim Rewards
      • Exit a DV
    • Partner Integrations
      • Create an EigenLayer DV
      • Create a Lido CSM DV
      • DappNode
  • Advanced & Troubleshooting
    • Advanced Guides
      • Create a DV Using the SDK
      • Migrate an Existing Validator
      • Enable MEV
      • Combine DV Private Key Shares
      • Self-Host a Relay
      • Advanced Docker Configs
      • Beacon node authentication
    • Troubleshooting
      • Errors & Resolutions
      • Handling DKG Failure
      • Client Configuration
      • Test Commands
    • Security
      • Overview
      • Centralization Risks and Mitigation
      • Obol Bug Bounty Program
      • Smart Contract Audit
      • Software Development at Obol
      • Charon Threat Model
      • Contacts
  • Community & Governance
    • Governance
      • Collective Overview
      • The Token House
      • The RAF
      • Delegate Guide
      • RAF1 Guide
    • The OBOL Token
      • Token Utility
      • Token Distribution & Liquidity
      • TGE FAQ
    • Community
      • Staking Mastery Program
      • Techne
    • Contribution & Feedback
      • Filing a Bug Report
      • Documentation Standards
      • Feedback
  • Walkthrough Guides
    • Walkthroughs
      • Walkthrough Guides
  • SDK
    • Intro
    • Enumerations
      • FORK_MAPPING
    • Classes
      • Client
    • Interfaces
      • ClusterDefinition
      • RewardsSplitPayload
    • Type-Aliases
      • BuilderRegistration
      • BuilderRegistrationMessage
      • ClusterCreator
      • ClusterLock
      • ClusterOperator
      • ClusterPayload
      • ClusterValidator
      • DepositData
      • DistributedValidator
      • ETH_ADDRESS
      • OperatorPayload
      • SplitRecipient
      • TotalSplitPayload
    • Functions
      • validateClusterLock
  • API
    • What is this API?
    • System
    • Metrics
    • Cluster Definition
    • Cluster Lock
    • State
    • DV Exit
    • Cluster Effectiveness
    • Terms And Conditions
    • Techne Credentials
    • Address
    • OWR Information
  • Specification
Powered by GitBook
On this page
  • Peers
  • Charon Peers
  • Charon Relays
  • Self
  • Beacon
  • Validator
  • MEV
  • Infra
Edit on GitHub
  1. Advanced & Troubleshooting
  2. Troubleshooting

Test Commands

Troubleshoot issues spotted by the test command

PreviousClient ConfigurationNextSecurity

Last updated 5 days ago

This page aims to give guidance on the causes, and potential for troubleshooting or improvement, of failed tests or low test scores from the .

Peers

Charon Peers

Ping

  • Peers might have not started their nodes or are not reachable.

PingMeasure

  • Peer might be too far away (geographically) from you.

  • If the connection to the peer is indirect, the route is from your node, to the relay, to the peer. Meaning you are measuring the travel time from you to the relay, and from the relay to the peer: (your node -> relay -> peer). This means, even if your peer's node is right next to yours, if the connection is being transmitted through a relay far away, the latency between your nodes might be too high to be effective.

  • Your general network latency to the public internet might be high. Verify with the tests.

  • If the connection to the peer is indirect, there is a potential that the relay might be overloaded or under-resourced, consider adding , or preferably to the internet to establish direct peer to peer connections.

PingLoad

Same causes as PingMeasure test apply here.

DirectConn

  • Your or your peer's port might not be publicly exposed.

  • Your or your peer's port might be behind a firewall.

  • Your or your peer's port might be behind a strict NAT gateway.

Charon Relays

PingRelay

  • Relay might be down or un-conctactable for other reasons.

PingMeasureRelay

  • Relay might be under heavy load.

  • Your network latency might be high. Verify with the charon test infra tests.

Self

Libp2pTCPPortOpenTest

  • There might be another process running on the designated port (tcp/3610 by default).

  • The process might have died.

Beacon

Ping

  • Beacon node might not be started or is not reachable.

PingMeasure

  • Beacon node might be too far away (geographically) from you.

  • Your network latency might be high. Verify with the charon test infra tests.

Version

  • The beacon node version is not compatible with charon.

IsSynced

  • Beacon node is not synced to the network.

PeerCount

  • Beacon node does not have enough peers. This may result in slower fetching and broadcasting of slots and duties.

PingLoad

This is a load test, to enable it add the --load-test flag.

Same causes as PingMeasure test apply here.

Simulation

This is a load test, to enable it add the --load-test flag.

Same causes as PingMeasure test apply here and additionally:

  • The infrastructure on which the beacon node runs (amount of RAM, disk IOPS) might not be enough to handle the number of simulated validators supplied in this test.

Validator

Ping

  • Validator client might not be started or is not reachable.

PingMeasure

  • Validator client might be too far away (geographically) from the charon client. Generally a low latency between a validator client and its charon client is important for timely signing.

PingLoad

Same causes as PingMeasure test apply here.

MEV

Ping

  • MEV relay might not be started or is not reachable.

PingMeasure

  • MEV relay might be too far away (geographically) from you.

  • Your network latency might be high. Verify with the charon test infra tests.

CreateBlock

Same causes as PingMeasure test apply here and additionally:

  • MEV relay might be too slow in block production.

CreateMultipleBlocks

Same causes as CreateBlock test apply here.

Infra

DiskWriteSpeed

DiskWriteIOPS

DiskReadSpeed

DiskReadIOPS

AvailableMemory

  • Your available memory (RAM) is not enough to run Charon. The minimum available memory should be 2GB, the recommended available memory is 4GB. Note that this test is a best estimate, as memory availability can be hard to predict, particularly if the command is run in a virtualised environment (i.e.: a Docker container).

TotalMemory

InternetLatency

  • Your internet latency to the nearest server is too high. Latency is expected to be at least less than 50ms and at best less than 20ms.

InternetDownloadSpeed

  • Your internet download speed from the nearest test server is too low. Download speed is expected to be at least above 10Mb/s and at best above 50Mb/s.

InternetUploadSpeed

  • Your internet upload speed to the nearest test server is too low. Upload speed is expected to be at least above 10Mb/s and at best above 50Mb/s.

Read more in our .

Read more in our .

Read more in our .

Read more in our .

Your total memory (RAM) may not be enough to run a full validating node. The recommended minimum total memory is 16GB. Specialised, or optimised deployments can use less RAM than the recommended minimum, but may require some monitoring to assert sufficient stability and performance. Read more in our

Deployment Best Practices
Deployment Best Practices
Deployment Best Practices
Deployment Best Practices
Deployment Best Practices
Charon Test commands
charon test infra
opening charon's p2p port
alternative relays