Charon
The Distributed Validator middleware client

This repo contains the source code for the distributed validator client Charon (pronounced 'kharon'); a HTTP middleware client for Ethereum Staking that enables you to safely run a single validator across a group of independent nodes.

Charon is accompanied by a webapp called the Distributed Validator Launchpad for distributed validator key creation.

Charon is used by stakers to distribute the responsibility of running Ethereum Validators across a number of different instances and client implementations.

A Distributed Validator Cluster that uses the Charon client to hedge client and hardware failure risks

Quickstart

The easiest way to test out charon is with the charon-distributed-validator-cluster repo which contains a docker compose setup for running a full charon cluster on your local machine.

Documentation

The Obol Docs website is the best place to get started. The important sections are intro, key concepts and charon.

For detailed documentation on this repo, see the docs folder:

• Configuration: Configuring a charon node
• Architecture: Overview of charon cluster and node architecture
• Project Structure: Project folder structure
• Branching and Release Model: Git branching and release model
• Go Guidelines: Guidelines and principals relating to go development
• Contributing: How to contribute to charon; githooks, PR templates, etc.

There is always the charon godocs for the source code documentation.

Project Status

See dvt.obol.tech for the latest status of the Obol Network including which upstream consensus clients and which downstream validators are supported.