Skip to content

Commit

Permalink
Document DV Setup Process with Sedge
Browse files Browse the repository at this point in the history
  • Loading branch information
sugh01 committed Jul 30, 2024
1 parent c84beeb commit 0528670
Show file tree
Hide file tree
Showing 3 changed files with 126 additions and 0 deletions.
1 change: 1 addition & 0 deletions docs/docs/commands/generate.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,7 @@ Flags:
-c, --consensus string Consensus engine client, e.g. teku, lodestar, prysm, lighthouse, Nimbus. Additionally, you can use this syntax '<CLIENT>:<DOCKER_IMAGE>' to override the docker image used for the client. If you want to use the default docker image, just use the client name
-e, --execution string Execution engine client, e.g. geth, nethermind, besu, erigon. Additionally, you can use this syntax '<CLIENT>:<DOCKER_IMAGE>' to override the docker image used for the client. If you want to use the default docker image, just use the client name
-v, --validator string Validator engine client, e.g. teku, lodestar, prysm, lighthouse, Nimbus. Additionally, you can use this syntax '<CLIENT>:<DOCKER_IMAGE>' to override the docker image used for the client. If you want to use the default docker image, just use the client name
--distributed boolean Deploy a node configured to run as part of a Distributed Validator Cluster.
--latest Use the latest version of clients. This sets the "latest" tag on the client's docker images. Latest version might not work.
--checkpoint-sync-url string Initial state endpoint (trusted synced consensus endpoint) for the consensus client to sync from a finalized checkpoint. Provide faster sync process for the consensus client and protect it from long-range attacks affored by Weak Subjetivity. Each network has a default checkpoint sync url.
--fee-recipient string Suggested fee recipient. Is a 20-byte Ethereum address which the execution layer might choose to set as the coinbase and the recipient of other fees or rewards. There is no guarantee that an execution node will use the suggested fee recipient to collect fees, it may use any address it chooses. It is assumed that an honest execution node will use the suggested fee recipient, but users should note this trust assumption.
Expand Down
1 change: 1 addition & 0 deletions docs/docs/commands/importKey.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,7 @@ Flags:
--custom-config string file path or url to use as custom network config.
--custom-deploy-block string custom network deploy block.
--custom-genesis string file path or url to use as custom network genesis.
--distributed boolean Import keys generated by Charon Distributed Key Generation (DKG) process
--from string path to the validator keys, must follow the EIP-2335: BLS12-381 Keystore standard (default "[WORK_DIR]/sedge-data/keystore")
-h, --help help for import-key
-n, --network string network (default "mainnet")
Expand Down
124 changes: 124 additions & 0 deletions docs/docs/quickstart/charon.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,124 @@
---
sidebar_position: 10
id: staking-with-obol-DV
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Set up Obol DV Node with Sedge

## What is the Obol DVT in a Nutshell?

**[Read more about Obol DVT here](https://dvt.obol.tech/)**

Sedge supports DV Node setup, by allowing users to set up their full nodes with ease. This guide
will walk you through the process of setting up Obol DV node using Sedge.

:::info

Read more about how to generate **[Distributed Validator keys](https://docs.obol.org/docs/next/start/quickstart_group)**.

:::

## Workflow breakdown

The Obol DV Setup process involves few steps:

1. **Perform Obol DKG process**: Generate distributed node contents and validator keys compatible with Obol DVT using [DKG process](https://docs.obol.org/docs/next/start/quickstart_group).
2. **Set Up Your Full Node**: Set up your full node with **sedge generate** command.
3. **Import DKG Validator keys**: Import the keys generated in Step 1 using the **sedge import_key** command
4. **Run the cluster**: Run the cluster using **sedge run** command.

Let's dive into each step in detail.

## Using Sedge for setting up Obol DV node

### Perform DKG and Generate DKG components

To get started with Obol DVT using Sedge, you first need to generate your validator keys and deposit data and DV node components with [Obol DV Launchpad](https://holesky.launchpad.obol.org/).
You need to follow the steps listed below
1. [Step 1: Get your ENR](https://docs.obol.org/docs/next/start/quickstart_group#step-1-get-your-enr)
2. [Step 2: Create a cluster or accept an invitation to a cluster](https://docs.obol.org/docs/next/start/quickstart_group#step-2-create-a-cluster-or-accept-an-invitation-to-a-cluster)
3. [Step 3: Run the Distributed Key Generation (DKG) ceremony](https://docs.obol.org/docs/next/start/quickstart_group#step-3-run-the-distributed-key-generation-dkg-ceremony)

At this stage, if DKG process is successful, a folder with name **.charon** will be created with the following structure for a cluster of 2 validators.

```bash
$sedge % tree .charon
.
├── charon-enr-private-key
├── cluster-lock.json
├── deposit-data.json
└── validator_keys
├── keystore-0.json
├── keystore-0.txt
├── keystore-1.json
├── keystore-1.txt
```

### Setting up your full node

Once the DKG process is complete and **.charon** folder and its contents are generated, you can set up your full node using **Sedge**:

```bash
sedge generate full-node --validator=teku --consensus=prysm --execution=geth --network=holesky --distributed
```

:::note

This command will generate a DV enabled cluster for the Holesky testnet.
If supported, you can set other networks by changing the `--network` flag.
If supported, you can set other execution, consensus and validator clients using the respective flags.
:::

Once the Full node setup process is complete a folder with name **sedge-data** will be created.

```bash
$sedge % tree sedge-data
tree sedge-data
sedge-data
├── docker-compose.yml
└── jwtsecret
```
Run the import keys step

```bash
sedge import-key --distributed --network holesky teku
```

:::note

This command will import the keys inside **.charon** folder into the validator client.
If supported, you can set other networks by changing the `--network` flag.
The validator client should be identical to the client used in the full-node generate command
:::

Once the Keys import process is complete **sedge-data** folder contents will be updated.

```bash
sedge % tree sedge-data
sedge-data
├── docker-compose.yml
├── jwtsecret
├── keystore
│ ├── deposit-data.json
│ ├── keystore-0.txt
│ ├── keystore-1.txt
│ └── validator_keys
│ ├── keystore-0.json
│ ├── keystore-1.json
└── validator-data
├── keys
│ ├── keystore-0.json
│ ├── keystore-1.json
└── passwords
├── keystore-0.txt
├── keystore-1.txt
```

Finally run the cluster.

```bash
sedge run
```

0 comments on commit 0528670

Please sign in to comment.