suggested fee recipient documentation (#3729)

* tentative suggested fee recipient description

* numbered priority list

* add chapter to book
This commit is contained in:
tersec 2022-07-07 09:25:51 +00:00 committed by GitHub
parent e1830519a4
commit 35712e0dd0
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 11 additions and 0 deletions

View File

@ -21,6 +21,7 @@
- [Make a deposit](./deposit.md)
- [Import your validator keys](./keys.md)
- [Connect your validator to eth2](./connect-eth2.md)
- [Set up transaction fee recipients](./suggested-fee-recipient.md)
- [Keep an eye on your validator](./keep-an-eye.md)
- [Recover / generate keys](./more-keys.md)
- [Perform a voluntary exit](./voluntary-exit.md)

View File

@ -0,0 +1,10 @@
# Suggested Fee Recipient
A suggested fee recipient offers an execution client, in a merged Ethereum network, a coinbase it might use. The execution client might not use this offered coinbase, unless one ensures that by running, controlling, and similarly configuring this execution client oneself.
Nimbus offers two ways to a suggested fee recipient, the `--suggested-fee-recipient` option and a per-validator recipient set using the keymanager API. Any validator without a per-validator recipient set will fall back to a `--suggested-fee-recipient` if configured. In order, it selects from the first available, for each validator, of:
1. the keymanager API per-validator suggested fee recipient
2. `--suggested-fee-recipient`
For example, `nimbus_beacon_node --suggested-fee-recipient=0x79b53bc7a89347d3ab90789e99a0a9c58f2fea57` suggests to the execution client that `0x79b53bc7a89347d3ab90789e99a0a9c58f2fea57` might be the coinbase. If this Nimbus node has two validators, one of which has its own suggested fee recipient via the keymanager API and the other does not, the former would use its own per-validator suggested fee cipient while the latter would fall back to `0x79b53bc7a89347d3ab90789e99a0a9c58f2fea57`.