mirror of
https://github.com/status-im/eth2.0-specs.git
synced 2025-01-21 08:00:36 +00:00
b15669b7a5
* p2p-interface: clarify that signing_root is used for block requests * hash cleanups * one more hash tree root gone for blocks - block hashes are always signing roots! * use simple serialize data types consistently * Describe which finalized root/epoch to use * remove custody_bits from attestation * remove AttestationDataAndCustodyBit * Specify inclusive range for genesis deposits * add initial fork choice bounce prevention and tests * PR feedback * further test bounce attack * wipe queued justified after epoch transition * remove extra var * minor fmt * only allow attestatiosn to be considered from current and previous epoch * use best_justified_checkpoint instead of queued_justified_checkpoints * use helper for slots since epoch start * be explicit about use of genesis epoch for previous epoch in fork choice on_block * pr feedback * add note aboutgenesis attestations * cleanup get_eth1_vote * make eth1_follow_distance clearer * Update the expected proposer period Since `SECONDS_PER_SLOT` is now `12` * minor fix to comment in mainnet config * Update 0_beacon-chain.md
69 lines
3.4 KiB
Markdown
69 lines
3.4 KiB
Markdown
# Ethereum 2.0 Specifications
|
|
|
|
[](https://discord.gg/hpFs23p) [](https://gitter.im/ethereum/sharding?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
|
|
To learn more about sharding and Ethereum 2.0 (Serenity), see the [sharding FAQ](https://github.com/ethereum/wiki/wiki/Sharding-FAQ) and the [research compendium](https://notes.ethereum.org/s/H1PGqDhpm).
|
|
|
|
This repository hosts the current Eth2 specifications. Discussions about design rationale and proposed changes can be brought up and discussed as issues. Solidified, agreed-upon changes to the spec can be made through pull requests.
|
|
|
|
|
|
## Specs
|
|
|
|
Core specifications for Eth2 client validation can be found in [specs/core](specs/core). These are divided into phases. Each subsequent phase depends upon the prior. The current phases specified are:
|
|
|
|
### Phase 0
|
|
* [The Beacon Chain](specs/core/0_beacon-chain.md)
|
|
* [Fork Choice](specs/core/0_fork-choice.md)
|
|
* [Deposit Contract](specs/core/0_deposit-contract.md)
|
|
* [Honest Validator](specs/validator/0_beacon-chain-validator.md)
|
|
|
|
### Phase 1
|
|
* [Custody Game](specs/core/1_custody-game.md)
|
|
* [Shard Data Chains](specs/core/1_shard-data-chains.md)
|
|
* [Misc beacon chain updates](specs/core/1_beacon-chain-misc.md)
|
|
|
|
### Phase 2
|
|
|
|
Phase 2 is still actively in R&D and does not yet have any formal specifications.
|
|
|
|
See the [Eth2 Phase 2 Wiki](https://hackmd.io/UzysWse1Th240HELswKqVA?view) for current progress, discussions, and definitions regarding this work.
|
|
|
|
### Accompanying documents can be found in [specs](specs) and include:
|
|
|
|
* [SimpleSerialize (SSZ) spec](specs/simple-serialize.md)
|
|
* [BLS signature verification](specs/bls_signature.md)
|
|
* [General test format](specs/test_formats/README.md)
|
|
* [Merkle proof formats](specs/light_client/merkle_proofs.md)
|
|
* [Light client syncing protocol](specs/light_client/sync_protocol.md)
|
|
|
|
## Additional specifications for client implementers
|
|
|
|
Additional specifications and standards outside of requisite client functionality can be found in the following repos:
|
|
|
|
* [Eth2 APIs](https://github.com/ethereum/eth2.0-apis)
|
|
* [Eth2 Metrics](https://github.com/ethereum/eth2.0-metrics/)
|
|
* [Interop Standards in Eth2 PM](https://github.com/ethereum/eth2.0-pm/tree/master/interop)
|
|
|
|
## Design goals
|
|
|
|
The following are the broad design goals for Ethereum 2.0:
|
|
* to minimize complexity, even at the cost of some losses in efficiency
|
|
* to remain live through major network partitions and when very large portions of nodes go offline
|
|
* to select all components such that they are either quantum secure or can be easily swapped out for quantum secure counterparts when available
|
|
* to utilize crypto and design techniques that allow for a large participation of validators in total and per unit time
|
|
* to allow for a typical consumer laptop with `O(C)` resources to process/validate `O(1)` shards (including any system level validation such as the beacon chain)
|
|
|
|
|
|
## Useful external resources
|
|
|
|
* [Design Rationale](https://notes.ethereum.org/s/rkhCgQteN#)
|
|
* [Phase 0 Onboarding Document](https://notes.ethereum.org/s/Bkn3zpwxB)
|
|
|
|
|
|
## For spec contributors
|
|
|
|
Documentation on the different components used during spec writing can be found here:
|
|
* [YAML Test Generators](test_generators/README.md)
|
|
* [Executable Python Spec, with Py-tests](test_libs/pyspec/README.md)
|
|
|