Skip to content

Update split keys quickstart to match charon behavior#164

Open
pinebit wants to merge 2 commits into
mainfrom
pinebit/split-keys-fixes
Open

Update split keys quickstart to match charon behavior#164
pinebit wants to merge 2 commits into
mainfrom
pinebit/split-keys-fixes

Conversation

@pinebit

@pinebit pinebit commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Update the "Migrate an Existing Validator" (split keys) quickstart and the CLI reference to match actual charon behavior:

  • Add --cluster-dir=/opt/charon/cluster to the example docker command; without it the cluster is created in ./node*, contradicting the page's ./cluster tree and the zip step.
  • Document that deposit-data-*.json files ARE re-created in split mode, signed with the existing validator keys using the provided withdrawal addresses, and add a warning not to submit them for already-activated validators. The page previously omitted these files entirely.
  • Match the command output block to actual charon output (Created charon cluster, cluster dir path, deposit-data files).
  • Extend the v1.8.0 note: manual keystore preparation is required when specifying an exact list of withdrawal or fee recipient addresses.
  • Update the --split-existing-keys flag description in the CLI reference.

Note: the fee-recipient ordering note and the updated flag description correspond to ObolNetwork/charon#4577 and apply from the charon release containing it; the deposit data documentation is accurate for current releases as well.

🤖 Generated with Claude Code

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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.

1 participant