Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/main' into wiki-pages
Browse files Browse the repository at this point in the history
  • Loading branch information
taxmeifyoucan committed May 13, 2024
2 parents 4402909 + 6112c6e commit 0c73b65
Show file tree
Hide file tree
Showing 7 changed files with 21 additions and 20 deletions.
1 change: 1 addition & 0 deletions docs/_sidebar.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,7 @@
- [PTC](/wiki/research/PBS/PTC.md)
- [PEPC](/wiki/research/PBS/PEPC.md)
- [TBHL](/wiki/research/PBS/TBHL.md)
- [eODS](/wiki/research/eODS.md)
- Preconfirmations
- [Preconfirmations](/wiki/research/Preconfirmations/Preconfirmations.md)
- [Based Sequencing with Preconfs](/wiki/research/Preconfirmations/BasedSequencingPreconfs.md)
Expand Down
9 changes: 6 additions & 3 deletions docs/wiki/CL/SSZ.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,10 @@

## Overview

Simple Serialize (SSZ) is a serialization and [Merkleization](/docs/wiki/CL/merkleization.md) scheme designed specifically for Ethereum's Beacon Chain. SSZ replaces the [RLP serialization](/docs/wiki/EL/RLP.md) used on the execution layer (EL) everywhere across the consensus layer (CL) except the [peer discovery protocol](https://github.com/ethereum/devp2p). Its development and adoption are aimed at enhancing the efficiency, security, and scalability of Ethereum's CL.

This document is about SSZ Serialization. You can learn more about SSZ merkleization at the [merkleization wiki page](/docs/wiki/CL/merkleization.md).
Simple Serialize (SSZ) is a serialization and [Merkleization](/wiki/CL/merkleization.md) scheme designed specifically for Ethereum's Beacon Chain. SSZ replaces the [RLP serialization](/wiki/EL/RLP.md) used on the execution layer (EL) everywhere across the consensus layer (CL) except the [peer discovery protocol](https://github.com/ethereum/devp2p). Its development and adoption are aimed at enhancing the efficiency, security, and scalability of Ethereum's CL.

This document is about SSZ Serialization. You can learn more about SSZ merkleization at the [merkleization wiki page](/wiki/CL/merkleization.md).


## SSZ Tools
Expand All @@ -13,7 +14,7 @@ There are many tools available for SSZ. Here is a [full list](https://github.com

- [py-ssz](https://github.com/ethereum/py-ssz)
- [dafny](https://github.com/ConsenSys/eth2.0-dafny)
- [Eth2.py](https://github.com/protolambda/remerkleable)
- [remerkleable](https://github.com/protolambda/remerkleable)
- [fastssz](https://github.com/ferranbt/fastssz/)
- [rust-ssz](https://github.com/ralexstokes/ssz-rs)

Expand Down Expand Up @@ -44,6 +45,8 @@ _Table: SSZ VS RLP Comparison by [Piper Merriam](https://twitter.com/pipermerria

**Deterministic Serialization**:
- **SSZ**: Provides deterministic serialization results, ensuring that the same data structure serializes to the exact same byte sequence every time, which is crucial for consensus reliability.
- **RLP**: RLP also provides deterministic serialization results.


For these reasons, there is a strong effort in Ethereum to completely migrate to SSZ serialization for everything and stop the usage of RLP serialization.

Expand Down
4 changes: 3 additions & 1 deletion docs/wiki/CL/merkleization.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Merkleization and Hash Tree Roots

In Ethereum consensus mechanism, it's critical for all participating nodes to agree on the state of the system consistently and efficiently. The [Simple Serialize (SSZ)](/docs/wiki/CL/SSZ.md) framework facilitates this through Merkleization, a process that transforms serialized data into a Merkle tree structure. The goal of the Merkleization scheme is to ensure that constrained environments (light clients, execution environments, etc.) can have access to light-weight proofs which they can use to make important decisions. This wiki page discusses the intricacies of Merkleization and its importance in ensuring a shared state across nodes in a scalable and secure manner.

In Ethereum consensus mechanism, it's critical for all participating nodes to agree on the state of the system consistently and efficiently. The [Simple Serialize (SSZ)](/wiki/CL/SSZ.md) framework facilitates this through Merkleization, a process that transforms serialized data into a Merkle tree structure. The goal of the Merkleization scheme is to ensure that constrained environments (light clients, execution environments, etc.) can have access to light-weight proofs which they can use to make important decisions. This wiki page discusses the intricacies of Merkleization and its importance in ensuring a shared state across nodes in a scalable and secure manner.


## Terminology and Methods

Expand Down
2 changes: 1 addition & 1 deletion docs/wiki/epf.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,6 @@ Because the protocol, its development and research is fully public and open, any

The fellowship is fully open and permissionless, anyone can join the community to start working their area of interest. The cohort opens up with an application process and ends with EPF Day in-person event at Devcon. The most active and skilled contributors might be eligible for stipend at the start of the cohort based on their application or retrospectively.

> Upcoming EPF cohorts are announced when applications open. Follow the [mailing list, ESP discord and EF blog](/eps/intro.md#important-links) to stay informed.
> Upcoming EPF cohorts are announced when applications open. Follow the [mailing list, EPS discord and EF blog](/eps/intro.md#important-links) to stay informed.
All work done within EPF cohorts can be found in [eth-protocol-fellows repositories](https://github.com/orgs/eth-protocol-fellows/repositories). Each cohort repo includes `/projects` directory with all project proposals and `dev-updates.md` document tracking weekly progress of every participant. Use these resources to learn about the protocol, fellows' work and get inspiration for your own projects.
4 changes: 2 additions & 2 deletions docs/wiki/research/eODS.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@

Principal–Agent problem of liquid staking, in which the interests of the Agent are not aligned with the interests of the Principal, is part of any capital delegation, and even more so present in today's staking ecosystem[^1].

Since the early days of Beacon Chain, market structures enabling to provide liquidty for staking pools without running an actual validator software have emerged in Ethereum.
Since the early days of Beacon Chain, market structures enabling to provide liquidity for staking pools without running an actual validator software have emerged in Ethereum.
Thus, staking has split naturally in two classes of participants, outside protocol level[^2]:

| Tier | Current natural separation | Slashing risk |
Expand Down Expand Up @@ -198,7 +198,7 @@ In order to improve delegate selection powers[^17], we can:

* improve voting tools within pools

Under the current paradigm, voting within staking pools is limited to governance token-holders (not ETH holders). There are attempts of Optimistic governance, where ETH holders can veto LSP governance votes, but (paraphrasing Vitalik) token voting is not strong enough, and ultimately any form of unincentivised delegate selection is just a type of token voting.
Under the current paradigm, voting within staking pools is limited to governance token-holders (not ETH holders). There are attempts of Optimistic governance, where ETH holders can veto LSP governance votes, but (paraphrasing Vitalik) token voting is not strong enough, and ultimately any form of unincentivized delegate selection is just a type of token voting.

* improve competition between pools

Expand Down
4 changes: 2 additions & 2 deletions docs/wiki/research/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ The discussion, resources and all research and development on the core protocol
While there is not a single roadmap that Ethereum development follows, we can track the current R&D efforts to map what changes are happening and might happen in the future.
A popular overview mapping many domains of the current core research and development is Vitalik's chart (December 2023):

![Ethereum roadmap updated by V.B. Dec2023](/wiki/research/img/full_roadmap2024_1600x1596.webp)
![Ethereum roadmap updated by V.B. Dec2023](../research/img/full_roadmap2024_1600x1596.webp)

In this overview, different domains are coupled to related categories forming various 'urges'. Many of these boxes have their own page on this wiki where you can study more.

Expand All @@ -28,7 +28,7 @@ Upgrades relating to the switch from proof-of-work to proof-of-stake. The Merge
**IMPLEMENTED**
| Upgrade | Description | Effect | State of the art |
|:------------------------------------ |:---------------------------------------------------------------------------------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------- |
| Launch the Beacon Chain | A crucial step in Ethereum's shift to a proof-of-stake consensus mechanism | Beacon Chain was launched as an independent network connected to Ethereum, bootstraping validators in preparation for the Merge. | shipped </br> EIP-2982<span markdown='1'>[^1]</span> |
| Launch the Beacon Chain | A crucial step in Ethereum's shift to a proof-of-stake consensus mechanism | Beacon Chain was launched as an independent network connected to Ethereum, bootstrapping validators in preparation for the Merge. | shipped </br> EIP-2982<span markdown='1'>[^1]</span> |
| Merge Execution and Consensus Layers | Ethereum's execution layer merged with the Beacon chain (consensus layer) | Proof-of-work activities ceased and the network's consensus mechanism shifted to proof-of-stake. Validators have the role and responsibility for processing the validity of all transactions and proposing blocks | shipped |
| Enable Withdrawals | The last of the three-part process of Ethereum's transition to a proof-of-stake consensus mechanism | Validators can add their withdrawal credentials and Beacon Chain sweeps all inactive ETH | shipped </br>EIP-4895[^2] |

Expand Down
17 changes: 6 additions & 11 deletions wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,6 @@ bilinear
bilinearity
BIP
bitlist
Bitlist
Bitlists
bitrate
bitvector
Expand All @@ -63,7 +62,6 @@ blockchain's
blockchains
blockquote
blockquotes
blockquote
blocksize
bloXroute
bloXroute's
Expand All @@ -72,7 +70,6 @@ Bogotá
Boneh
bool
booleans
Booleans
bootup
borderless
BPE
Expand Down Expand Up @@ -112,6 +109,7 @@ CODECOPY
codecs
coinbase
collateralised
collateralized
COMIS
commoditized
Composability
Expand Down Expand Up @@ -270,6 +268,7 @@ Francesco
Frege
Friedrich
frontend
frontrunning
fulfillments
fullscreen
Fullstack
Expand All @@ -287,7 +286,6 @@ getPayloadV
getters
ghost
Gilles
Goeril
Goerli
Golang
Goldwasser
Expand Down Expand Up @@ -316,6 +314,7 @@ homomorphic
Hopinheimer
Hotz
Hsiao
HSP
Hulsing
Hyperledger
Hyperplonk
Expand Down Expand Up @@ -362,6 +361,7 @@ Kira
Kleppmann
Koblitz
Kurtosis
Kyber
KZG
Lamport
Lamport's
Expand All @@ -380,7 +380,6 @@ lmd
LMD
Longrightarrow
lookahead
Lookahead
LSB
LSM
LSP
Expand All @@ -402,12 +401,10 @@ Mempool
Menezes
merkelizing
merkle
Merkle
Merkleization
Merkleize
Merkleized
Merkleizing
mev
MEV
mevboost
Michaël
Expand Down Expand Up @@ -478,7 +475,6 @@ PeerDAS
Peeters
pepc
pepc's
performace
performence
permissionless
permissionlessness
Expand All @@ -504,7 +500,6 @@ preconfed
preconfer
preconfer's
preconfers
Preconfers
preconfirm
preconfirmation
preconfirmations
Expand Down Expand Up @@ -544,6 +539,7 @@ Rareskills
RB
README
referrerpolicy
remerkleable
repo
responder
restaking
Expand Down Expand Up @@ -648,7 +644,6 @@ TLS
TODO
TPS
tracoor
Tracoor
tradeoff
tradeoffs
transactional
Expand Down Expand Up @@ -715,4 +710,4 @@ zk
zkEVMs
ZKSNARK
ZKSNARKs
Zksync
Zksync

0 comments on commit 0c73b65

Please sign in to comment.