status-im
/
eth2.0-specs
mirror of https://github.com/status-im/eth2.0-specs.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity

Update validator.md

This commit is contained in:
Justin 2020-12-12 21:46:39 +00:00 committed by Danny Ryan
parent e93f1e1fa8
commit 0f94fa51b8
No known key found for this signature in database
GPG Key ID: 2765A792E42CE07A
1 changed files with 13 additions and 25 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
specs/phase0/validator.md
View File

@ -105,40 +105,28 @@ Validator public keys are [G1 points](beacon-chain.md#bls-signatures) on the [BL
#### Withdrawal credentials #### Withdrawal credentials
The `withdrawal_credentials` ultimately control the deposited ETH once the The `withdrawal_credentials` field specifies how a validator's withdrawable balance may be withdrawn. The first byte of this 32-byte field is a withdrawal prefix which defines the semantics of the remaining 31 bytes. The following withdrawal prefixes are currently supported.
validator has exited and is withdrawable. The 0th byte of this 32-byte field,
called the "withdrawal prefix" defines the withdrawal credential version
while the remaining 31 bytes define the version-specific content.
The following withdrawal credentials versions are currently supported. The ##### `BLS_WITHDRAWAL_PREFIX`
validator must choose and construct a version for the `withdrawal_credentials` field.
##### BLS key credentials Withdrawal credentials with the BLS withdrawal prefix allow a BLS key pair `(bls_withdrawal_privkey, bls_withdrawal_pubkey)` to trigger withdrawals. The `withdrawal_credentials` field must be constructed such that:
BLS withdrawal credentials are controlled by a secondary withdrawal BLS private key, `bls_withdrawal_privkey`. * `withdrawal_credentials[:1] == BLS_WITHDRAWAL_PREFIX`
This key is securely generated along with the resultant `bls_withdrawal_pubkey`. * `withdrawal_credentials[1:] == hash(bls_withdrawal_pubkey)[1:]`
This `withdrawal_privkey` does not have to be available for signing during
the normal lifetime of a validator and can live in "cold storage".
The validator constructs `withdrawal_credentials` as the following: *Note*: The `bls_withdrawal_pubkey` is not required for validating and can be kept in cold storage.
* Set `withdrawal_credentials[:1] = BLS_WITHDRAWAL_PREFIX`.
* Set `withdrawal_credentials[1:] = hash(bls_withdrawal_pubkey)[1:]`.
##### Eth1 address credentials ##### `ETH1_ADDRESS_WITHDRAWAL_PREFIX`
Eth1 address credentials are controlled by an eth1 address. This can be an either an externally owned account or a contract. Withdrawal credentials with the Eth1 address withdrawal prefix specify a 20-byte Eth1 address `eth1_withdrawal_address` as the recipient for all withdrawals. The `eth1_withdrawal_address` can be the address of an externally owned account or of a contract. The `withdrawal_credentials` field must be constructed such that:
The withdrawal to the address specified will be a normal ETH transfer (with no payload other than the validator's ETH) * `withdrawal_credentials[:1] = ETH1_ADDRESS_WITHDRAWAL_PREFIX`
triggered by an eth1 transaction that will handle gas price/limit and payment of fees. * `withdrawal_credentials[1:12] == Bytes32()[1:12]`
* `withdrawal_credentials[12:] = eth1_withdrawal_address`
As long as such a withdrawal account/contract can receive ETH transfers, Withdrawals to `eth1_withdrawal_address` will be normal ETH transfers (with no payload other than the validator's ETH) triggered by an Eth1 transaction that will handle gas price/limit and payment of fees. As long as the account or contract with address `eth1_withdrawal_address` can receive ETH transfers the future withdrawal protocol is agnostic to all other implementation details.
the future withdrawal protocol is agnostic to all other implementation details.
The validator selects a 20-byte eth1 address, `eth1_withdrawal_address`, and constructs `withdrawal_credentials` as the following: **TODO**: Be explicit about the endianness of `eth1_withdrawal_address`.
* Set `withdrawal_credentials[:1] = ETH1_ADDRESS_WITHDRAWAL_PREFIX`.
* Set `withdrawal_credentials[12:] = eth1_withdrawal_address`.
*Note*: Bytes `withdrawal_credentials[1:12]` remain the default `0x00` value.
### Submit deposit ### Submit deposit