Skip to content

Update Obol DVT guide for DKG and Relayer setup#121

Open
ulieth wants to merge 1 commit into
mainfrom
docs/dvt-dkg-relayer-flow
Open

Update Obol DVT guide for DKG and Relayer setup#121
ulieth wants to merge 1 commit into
mainfrom
docs/dvt-dkg-relayer-flow

Conversation

@ulieth

@ulieth ulieth commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

No description provided.

@vercel

vercel Bot commented Jun 16, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Jun 16, 2026 5:49am

Request Review

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are multiple sidecars. Each sidecar runs along the corresponding obol node. Maybe show this on picture. Now it looks like a single sidecar.

```
You should see `node0/`, `node1/`, and `node2/` directories.
:::custom-warning[Protect Your Key Shares]
Backup the `.charon/cluster/` directory. Someone with access to these files could get the validators slashed.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It reads like backup will protect me from leaking key shares. It will not. Backup is for another purpose.
I would separate this paragraph into 2: one for backups, another for leaking keys.


:::custom-warning[Block Reward Recipient Address]
Replace `[ENTER YOUR BLOCK REWARD RECIPIENT ADDRESS HERE]` inside `docker-compose.yml` file with your Block reward recipient address.
The `docker-compose.yml` launches a full Obol/Charon distributed validator stack for Ethereum mainnet, consisting of Geth (execution client), Lighthouse (consensus client), mev-boost, Charon (relay + 3 nodes), and validator clients (3× Teku, one per Charon node: vc0/vc1/vc2).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mev-boost

needs capitalizing

MEV-Boost

The operators create the validator key shares together through a DKG ceremony, so the full key is never assembled on any machine. Follow Obol's [Create a DV with a group ↗](https://docs.obol.org/run-a-dv/start/create-a-dv-with-a-group) guide — it walks each operator through generating an ENR, building the `cluster-definition.json`, running the ceremony, and starting their node.

:::custom-warning[StakeWise addresses]
When creating the cluster definition, set the `--withdrawal-addresses` to your **Vault contract address** and the `--fee-recipient-addresses` to your **Block reward recipient**:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe repeat this warning in 'Create a DV Alone' section above

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants