status-im/eth2.0-specs
2
0
Fork 0
mirror of https://github.com/status-im/eth2.0-specs.git synced 2025-02-20 06:18:15 +00:00
Code Issues Projects Releases Wiki Activity

Added WIP note, explanation for WS period calculation

Browse Source
This commit is contained in:
Aditya Asgaonkar 2020-09-17 10:34:37 -07:00
parent 6b33c766f2
commit 58d225c9be
1 changed files with 5 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
specs/phase0/weak-subjectivity.md
View File

@ -24,7 +24,7 @@
<!-- /TOC --> <!-- /TOC -->
## Introduction ## Introduction
This document is a guide for implementing the Weak Subjectivity protections in Phase 0 of Ethereum 2.0. For more information about weak subjectivity and why it is required, please refer to: This document is a guide for implementing the Weak Subjectivity protections in Phase 0 of Ethereum 2.0. This document is still a work-in-progress, and is subject to large changes. For more information about weak subjectivity and why it is required, please refer to:
- [Weak Subjectivity in Eth2.0](https://notes.ethereum.org/@adiasg/weak-subjectvity-eth2) - [Weak Subjectivity in Eth2.0](https://notes.ethereum.org/@adiasg/weak-subjectvity-eth2)
- [Proof of Stake: How I Learned to Love Weak Subjectivity](https://blog.ethereum.org/2014/11/25/proof-stake-learned-love-weak-subjectivity/) - [Proof of Stake: How I Learned to Love Weak Subjectivity](https://blog.ethereum.org/2014/11/25/proof-stake-learned-love-weak-subjectivity/)
@ -46,8 +46,6 @@ The Weak Subjectivity Period is the number of recent epochs within which there m
`SAFETY_DECAY` is defined as the maximum percentage tolerable loss in the one-third safety margin of FFG finality. Thus, any attack exploiting the Weak Subjectivity Period has a safety margin of at least `1/3 - SAFETY_DECAY/100`. `SAFETY_DECAY` is defined as the maximum percentage tolerable loss in the one-third safety margin of FFG finality. Thus, any attack exploiting the Weak Subjectivity Period has a safety margin of at least `1/3 - SAFETY_DECAY/100`.
### Calculating the Weak Subjectivity Period ### Calculating the Weak Subjectivity Period
For more information about this calculation, refer to [Weak Subjectivity in Eth2.0](https://notes.ethereum.org/@adiasg/weak-subjectvity-eth2).
*Note*: `compute_weak_subjectivity_period()` is planned to be updated when a more accurate calculation is made. *Note*: `compute_weak_subjectivity_period()` is planned to be updated when a more accurate calculation is made.
```python ```python
@ -61,6 +59,10 @@ For more information about this calculation, refer to [Weak Subjectivity in Eth2
return weak_subjectivity_period return weak_subjectivity_period
``` ```
*Details about the calculation*:
- `100` appears in the denominator to get the actual percentage ratio from `SAFETY_DECAY`
- For more information about other terms in this equation, refer to [Weak Subjectivity in Eth2.0](https://notes.ethereum.org/@adiasg/weak-subjectvity-eth2)
A brief reference for what these values look like in practice: A brief reference for what these values look like in practice:
| `val_count` | `weak_subjectivity_period` | | `val_count` | `weak_subjectivity_period` |