Skip to content

Commit 80fe133

Browse files
chong-hechong-he
authored
Update Lighthouse Book for Electra features (#7280)
* #7227
1 parent 410af7c commit 80fe133

19 files changed

+95
-127
lines changed

‎.github/workflows/release.yml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -221,7 +221,7 @@ jobs:
221221
|Non-Staking Users| <TODO>|---|
222222
223223
*See [Update
224-
Priorities](https://lighthouse-book.sigmaprime.io/installation-priorities.html)
224+
Priorities](https://lighthouse-book.sigmaprime.io/installation_priorities.html)
225225
more information about this table.*
226226
227227
## All Changes
@@ -230,7 +230,7 @@ jobs:
230230
231231
## Binaries
232232
233-
[See pre-built binaries documentation.](https://lighthouse-book.sigmaprime.io/installation-binaries.html)
233+
[See pre-built binaries documentation.](https://lighthouse-book.sigmaprime.io/installation_binaries.html)
234234
235235
The binaries are signed with Sigma Prime's PGP key: `15E66D941F697E28F49381F426416DC3F30674B0`
236236

‎account_manager/src/validator/exit.rs‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ pub const PASSWORD_PROMPT: &str = "Enter the keystore password";
2727

2828
pub const DEFAULT_BEACON_NODE: &str = "http://localhost:5052/";
2929
pub const CONFIRMATION_PHRASE: &str = "Exit my validator";
30-
pub const WEBSITE_URL: &str = "https://lighthouse-book.sigmaprime.io/voluntary-exit.html";
30+
pub const WEBSITE_URL: &str = "https://lighthouse-book.sigmaprime.io/validator_voluntary_exit.html";
3131

3232
pub fn cli_app() -> Command {
3333
Command::new("exit")

‎beacon_node/client/src/notifier.rs‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -353,7 +353,7 @@ async fn bellatrix_readiness_logging<T: BeaconChainTypes>(
353353
if !beacon_chain.is_time_to_prepare_for_capella(current_slot) {
354354
error!(
355355
info = "you need an execution engine to validate blocks, see: \
356-
https://lighthouse-book.sigmaprime.io/merge-migration.html",
356+
https://lighthouse-book.sigmaprime.io/archived_merge_migration.html",
357357
"Execution endpoint required"
358358
);
359359
}
@@ -433,7 +433,7 @@ async fn capella_readiness_logging<T: BeaconChainTypes>(
433433
if !beacon_chain.is_time_to_prepare_for_deneb(current_slot) {
434434
error!(
435435
info = "you need a Capella enabled execution engine to validate blocks, see: \
436-
https://lighthouse-book.sigmaprime.io/merge-migration.html",
436+
https://lighthouse-book.sigmaprime.io/archived_merge_migration.html",
437437
"Execution endpoint required"
438438
);
439439
}

‎book/src/SUMMARY.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@
2222
* [Doppelganger Protection](./validator_doppelganger.md)
2323
* [Suggested Fee Recipient](./validator_fee_recipient.md)
2424
* [Validator Graffiti](./validator_graffiti.md)
25+
* [Consolidation](./validator_consolidation.md)
2526
* [APIs](./api.md)
2627
* [Beacon Node API](./api_bn.md)
2728
* [Lighthouse API](./api_lighthouse.md)
@@ -61,6 +62,7 @@
6162
* [Development Environment](./contributing_setup.md)
6263
* [FAQs](./faq.md)
6364
* [Protocol Developers](./developers.md)
65+
* [Lighthouse Architecture](./developers_architecture.md)
6466
* [Security Researchers](./security.md)
6567
* [Archived](./archived.md)
6668
* [Merge Migration](./archived_merge_migration.md)

‎book/src/advanced_blobs.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ In the Deneb network upgrade, one of the changes is the implementation of EIP-48
66

77
1. What is the storage requirement for blobs?
88

9-
We expect an additional increase of ~50 GB of storage requirement for blobs (on top of what is required by the consensus and execution clients database). The calculation is as below:
9+
After Deneb, we expect an additional increase of ~50 GB of storage requirement for blobs (on top of what is required by the consensus and execution clients database). The calculation is as below:
1010

1111
One blob is 128 KB in size. Each block can carry a maximum of 6 blobs. Blobs will be kept for 4096 epochs and pruned afterwards. This means that the maximum increase in storage requirement will be:
1212

@@ -16,6 +16,8 @@ In the Deneb network upgrade, one of the changes is the implementation of EIP-48
1616

1717
However, the blob base fee targets 3 blobs per block and it works similarly to how EIP-1559 operates in the Ethereum gas fee. Therefore, practically it is very likely to average to 3 blobs per blocks, which translates to a storage requirement of 48 GB.
1818

19+
After Electra, the target blobs is increased to 6 blobs per block. This means blobs storage is expected to use ~100GB of disk space.
20+
1921
1. Do I have to add any flags for blobs?
2022

2123
No, you can use the default values for blob-related flags, which means you do not need add or remove any flags.
@@ -25,7 +27,7 @@ In the Deneb network upgrade, one of the changes is the implementation of EIP-48
2527
Use the flag `--prune-blobs false` in the beacon node. The storage requirement will be:
2628

2729
```text
28-
2**17 bytes * 3 blobs / block * 7200 blocks / day * 30 days = 79GB / month or 948GB / year
30+
2**17 bytes * 6 blobs / block * 7200 blocks / day * 30 days = 158GB / month or 1896GB / year
2931
```
3032

3133
To keep blobs for a custom period, you may use the flag `--blob-prune-margin-epochs <EPOCHS>` which keeps blobs for 4096+EPOCHS specified in the flag.

‎book/src/advanced_database_migrations.md‎

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,8 @@ been applied automatically and in a _backwards compatible_ way.
77

88
However, backwards compatibility does not imply the ability to _downgrade_ to a prior version of
99
Lighthouse after upgrading. To facilitate smooth downgrades, Lighthouse v2.3.0 and above includes a
10-
command for applying database downgrades.
10+
command for applying database downgrades. If a downgrade is available _from_ a schema version,
11+
it is listed in the table below under the "Downgrade available?" header.
1112

1213
**Everything on this page applies to the Lighthouse _beacon node_, not to the
1314
validator client or the slasher**.
@@ -16,12 +17,8 @@ validator client or the slasher**.
1617

1718
| Lighthouse version | Release date | Schema version | Downgrade available? |
1819
|--------------------|--------------|----------------|----------------------|
20+
| v7.0.0 | Apr 2025 | v22 | no |
1921
| v6.0.0 | Nov 2024 | v22 | no |
20-
| v5.3.0 | Aug 2024 | v21 | yes |
21-
| v5.2.0 | Jun 2024 | v19 | no |
22-
| v5.1.0 | Mar 2024 | v19 | no |
23-
| v5.0.0 | Feb 2024 | v19 | no |
24-
| v4.6.0 | Dec 2023 | v19 | no |
2522

2623
> **Note**: All point releases (e.g. v4.4.1) are schema-compatible with the prior minor release
2724
> (e.g. v4.4.0).
@@ -209,8 +206,9 @@ Here are the steps to prune historic states:
209206

210207
| Lighthouse version | Release date | Schema version | Downgrade available? |
211208
|--------------------|--------------|----------------|-------------------------------------|
209+
| v7.0.0 | Apr 2025 | v22 | no |
212210
| v6.0.0 | Nov 2024 | v22 | no |
213-
| v5.3.0 | Aug 2024 | v21 | yes |
211+
| v5.3.0 | Aug 2024 | v21 | yes before Electra using <= v7.0.0 |
214212
| v5.2.0 | Jun 2024 | v19 | yes before Deneb using <= v5.2.1 |
215213
| v5.1.0 | Mar 2024 | v19 | yes before Deneb using <= v5.2.1 |
216214
| v5.0.0 | Feb 2024 | v19 | yes before Deneb using <= v5.2.1 |

‎book/src/archived.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
# Archived
22

3-
This section keeps the topics that are deprecated or less applicable for archived purposes.
3+
This section keeps the topics that are deprecated. Documentation in this section is for informational purposes only and will not be maintained.

book/src/archived-key-management.md renamed to book/src/archived_key_management.md

File renamed without changes.

book/src/archived-merge-migration.md renamed to book/src/archived_merge_migration.md

File renamed without changes.

‎book/src/developers_architecture.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Lighthouse architecture
2+
3+
A technical walkthrough of Lighthouse's architecture can be found at: [Lighthouse technical walkthrough](https://www.youtube.com/watch?v=pLHhTh_vGZ0)
4+
5+
![Lighthouse architecture](imgs/developers_architecture.svg)

0 commit comments

Comments
 (0)