status-im
/
nimbus-eth2
mirror of https://github.com/status-im/nimbus-eth2.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity
nimbus-eth2/docs/the_nimbus_book/src/voluntary-exit.md

29 lines
1.5 KiB
Markdown
Raw Normal View History

Updates (#2108)
2020-11-30 01:13:47 +00:00
# Perform a voluntary exit
REST parameter defaults (#3689) * add default BN for VC * unify "default" beacon node across commands * clean up validator exit docs
2022-06-01 10:47:52 +00:00
Voluntary exits allow validators to permanently stop performing their duties, and eventually recover the deposit.
Doc fixes, part 2 (#4806) * part 2 of the initial doc fixes - spelling fixes - grammar fixes - em-dashes should be em-dashes (`—`): double dashes (`--`) are not rendered properly - reduce overusage of em-dashes, some of those should be separate sentences - use the correct syntax for notes, tips and warnings - every sentence is in a separate line (helps with future diffs) - add missing dots at the end of list items - fix some lists * sentences on separate lines in the remaining files
2023-04-11 15:42:35 +00:00
Exits are subject to a wait period that depends on the length of the exit queue.
While a validator is exiting, it still must perform its duties in order not to lose funds to inactivity penalities.
Updates (#2108)
2020-11-30 01:13:47 +00:00
Migrate docs to mkdocs (#3900) `mkdocs` works with markdown similar to `mdbook` but is generally more pleasing to the eye and has several nice UX features. This PR does the bulk of the transition - likely, a followup would be needed to fully make use of the extra features and navigation. Book pages have been kept url-compatible, meaning that for the most part, old links should continue to work! Co-authored-by: Etan Kissling <etan@status.im>
2022-07-22 19:47:24 +00:00
!!! warning
Doc fixes, part 2 (#4806) * part 2 of the initial doc fixes - spelling fixes - grammar fixes - em-dashes should be em-dashes (`—`): double dashes (`--`) are not rendered properly - reduce overusage of em-dashes, some of those should be separate sentences - use the correct syntax for notes, tips and warnings - every sentence is in a separate line (helps with future diffs) - add missing dots at the end of list items - fix some lists * sentences on separate lines in the remaining files
2023-04-11 15:42:35 +00:00
Voluntary exits are **irreversible**.
You won't be able to validate again with the same key.
update docs (#3890) * update docs * introduce mdbook-admonish for nice looking callouts * new section on data directory * recommend source build for advanced users and direct the rest to binaries * more strongly highlight that execution client is needed * write an actual deposit guide * remove cruft / fix links / etc
2022-07-21 18:19:47 +00:00
Migrate docs to mkdocs (#3900) `mkdocs` works with markdown similar to `mdbook` but is generally more pleasing to the eye and has several nice UX features. This PR does the bulk of the transition - likely, a followup would be needed to fully make use of the extra features and navigation. Book pages have been kept url-compatible, meaning that for the most part, old links should continue to work! Co-authored-by: Etan Kissling <etan@status.im>
2022-07-22 19:47:24 +00:00
!!! note
Doc fixes, part 2 (#4806) * part 2 of the initial doc fixes - spelling fixes - grammar fixes - em-dashes should be em-dashes (`—`): double dashes (`--`) are not rendered properly - reduce overusage of em-dashes, some of those should be separate sentences - use the correct syntax for notes, tips and warnings - every sentence is in a separate line (helps with future diffs) - add missing dots at the end of list items - fix some lists * sentences on separate lines in the remaining files
2023-04-11 15:42:35 +00:00
Voluntary exits won't be processed if the chain isn't finalizing.
Updates (#2108)
2020-11-30 01:13:47 +00:00
Some documentation for the new 'deposit exit' work-around
2023-03-21 21:06:40 +00:00
To perform a voluntary exit, make sure your beacon node is running with the `--rest` option enabled (e.g. `./run-mainnet-beacon-node.sh --rest`), then run:
refocus guide around prater
2021-05-22 09:13:27 +00:00
Simplify the validator exit docs further
2023-03-22 00:56:55 +00:00
build/nimbus_beacon_node deposits exit --validator=<VALIDATOR_KEYSTORE_PATH>
Migrate docs to mkdocs (#3900) `mkdocs` works with markdown similar to `mdbook` but is generally more pleasing to the eye and has several nice UX features. This PR does the bulk of the transition - likely, a followup would be needed to fully make use of the extra features and navigation. Book pages have been kept url-compatible, meaning that for the most part, old links should continue to work! Co-authored-by: Etan Kissling <etan@status.im>
2022-07-22 19:47:24 +00:00
!!! note
Some documentation for the new 'deposit exit' work-around
2023-03-21 21:06:40 +00:00
In the command above, you must replace `<VALIDATOR_KEYSTORE_PATH>` with the file-system path of an Ethereum [ERC-2335 Keystore](https://eips.ethereum.org/EIPS/eip-2335) created by a tool such as [staking-deposit-cli](https://github.com/ethereum/staking-deposit-cli) or [ethdo](https://github.com/wealdtech/ethdo).
Updates (#2108)
2020-11-30 01:13:47 +00:00
Allow exiting multiple validators at once (#4855)
2023-04-25 06:44:01 +00:00
!!! tip
You can perform multiple voluntary exits at once by supplying the `--validator` option multiple times on the command-line. This is typically more convenient when the provided keystores share the same password - you'll be asked to enter it only once.
book updates (#3388)
2022-02-14 11:39:10 +00:00
## `rest-url` parameter
REST parameter defaults (#3689) * add default BN for VC * unify "default" beacon node across commands * clean up validator exit docs
2022-06-01 10:47:52 +00:00
The `--rest-url` parameter can be used to point the exit command to a specific node for publishing the request, as long as it's compatible with the [REST API](./rest-api.md).
Add a guide for withdrawals (#4790)
2023-04-05 16:23:23 +00:00