Updates and fixes (#12)

-Introduction page: renamed to Erigon 3 Docs, updated with inputs from PR simplify release section #11 , introduced logo and Topics section
- Introduced foldable menus for better reading
- Updated to Erigon v3.0 while fixed git clone CLI in all pages
- Txpool: fixed instructions and removed link to embedded docs see also documentation: incorrect description for external txpool I-internal-issues#2
- Staking with external client: fixed wrong instructions
- Added Hoodi testnet
- Other minor fixes

Author: bloxster

README.md

@@ -1,4 +1,4 @@
-# The Erigon 3 Book
+# Erigon 3 Docs
 
 This is the official Erigon 3 documentation, hosted at <https://docs.erigon.tech/>.
 

book.toml

@@ -1,5 +1,5 @@
 [book]
-title = "The Erigon 3 Book"
+title = "Erigon 3 Docs"
 authors = ["Erigon"]
 description = "Erigon 3 documentation!"
 language = "en"
@@ -8,3 +8,8 @@ src = "src"
 
 [output.html]
 git-repository-url = "https://github.com/erigontech/docs"
+[output.html.fold]
+enable = true    # whether or not to enable section folding
+level = 0         # the depth to start folding
+theme = "my-theme"
+default-theme = "Ayu"

src/SUMMARY.md

@@ -21,6 +21,7 @@
         - [Optimizing Storage](basic/optimizing-storage.md)
     - [Supported Networks](basic/networks.md)
     - [Default Ports and Firewalls](basic/ports.md)
+    - [YAML/TOML Config](basic/yaml.md)
     - [Web3 Wallet](basic/wallet)
 
 - [Quick nodes](quick_nodes.md)
@@ -57,10 +58,9 @@
         - [Browser Interface](tools/user_interface.md)
     - [Otterscan](tools/otterscan.md)
 
-- [Frequently Asked Questions](faq.md)
-
 - [About](about.md)
     - [License](about/license.md)
     - [Contributing](about/contributing.md)
+    - [Disclaimer](about/disclaimer.md)
     - [Donate](about/donate.md)
     - [How to reach us](about/reachus.md)

src/_introduction.md

@@ -1,53 +1,27 @@
 # Introduction
-             
-	########b          oo                               d####b. 
-	##                                                      '## 
-	##aaaa    ##d###b. dP .d####b. .d####b. ##d###b.     aaad#' 
-	##        ##'  '## ## ##'  '## ##'  '## ##'  '##        '## 
-	##        ##       ## ##.  .## ##.  .## ##    ##        .## 
-	########P dP       dP '####P## '#####P' dP    dP    d#####P 
-	                           .##                              
-	                       d####P    
 
-> 📖 **Contributing**
->
-> You can contribute to this book on [GitHub](https://github.com/erigontech/docs).
->  
-> For instructions regarding Erigon 2 please refer to <https://erigon.gitbook.io>.
+<img src="/images/Erigon-2024-ICON-V1-O-scaled.webp" alt="Erigon 3" style="display: block; margin: 0 auto; max-width: 200px">
 
-Erigon is an efficient Ethereum implementation designed for speed, modularity, and optimization. By default, it functions as an archive node, utilizing technologies like staged sync, efficient state storage, and database compression.
+Erigon is an efficient Ethereum implementation designed for speed, modularity, and optimization. By default, it functions as a full node, utilizing technologies like staged sync, efficient state storage, and database compression.
 
-With Erigon 3 the default configuration shifts from archive node to full node, enhancing efficiency, accessibility, and versatility for a wider range of users. Archive nodes remain available for developers and researchers needing full historical data, while the full node offers faster sync times and lower resource usage for everyday operations. More info [here](https://erigon.tech/announcing-erigon-v3-alpha-6-focus-on-staking-and-full-node-performance/).
+With Erigon 3 the default configuration shifts from archive node to full node, enhancing efficiency, accessibility, and versatility for a wider range of users. Archive nodes remain available for developers and researchers needing full historical data, while the full node offers faster sync times and lower resource usage for everyday operations.
 
-<div class="warning">
+# Topics
 
-**Information**
+- Review the hardware and software requirements [get started](getting_started.md).
+- Follow the [installation guide](installation.md) to set up Erigon.
+- Learn the [basic usage](basic-usage.md) of Erigon.
+- Quickly deploy your own Ethereum, Gnosis, or Polygon [node](quick_nodes.md).
+- Explore Erigon's [advanced features](advanced.md).
+- Discover the capabilities of the [RPC Daemon](advanced/JSONRPC-daemon.md).
+- Utilize integrated [tools](tools.md) like Diagnostic Tools and Otterscan.
 
-If you wanto to test Erigon without reading all the documentation, go straight to the [quick nodes](quick_nodes.md) section.
+# Additional Resources and Information
 
-</div>
-
-> **DISCLAIMER**
->
-> Erigon 3 is in alpha phase and it is not recommended to be used in production environments. The Erigon team does not take any responsibility for losses or damages occurred through the use of Erigon. While we employ a seasoned in-house security team, we have not subjected our systems to independent third-party security assessments, leaving potential vulnerabilities to bugs or malicious activity unaddressed. It is essential for validators to be aware that unforeseen events, including software glitches, may result in lost rewards.
-
-# Features
-
-Erigon offers several features that make it a good option for a node application such as efficient state storage through the use of a key-value database and faster initial synchronisation.
-
-Built with modularity in mind, it also offers separate components such as the JSON RPC daemon, that can connect to both local and remote databases. For read-only calls, this RPC daemon does not need to run on the same system as the main Erigon binary, and can even run from a database snapshot.
-
-Erigon 3 is a major update that introduces several significant changes, improvements, and optimizations. Some of the key features and differences include:
-
-The main changes from Erigon 2 are listed [here](https://github.com/erigontech/erigon?tab=readme-ov-file#erigon3-changes-from-erigon2).
-
-# Release Process
-
-Erigon 3 also introduces changes to the release process, including:
-* New Docker Image Repository: Erigon images are now available on Dockerhub repository "erigontech/erigon".
-* Multi-Platform Support: The docker image is built for linux/amd64/v2 and linux/arm64 platforms using Alpine 3.20.2.
-* Release Workflow Changes: Build flags are now passed to the release workflow, allowing users to view previously missed build information in released binaries.
-
-# Known Issues
-
-See <https://github.com/erigontech/erigon?tab=readme-ov-file#known-issues>.
+- **Releases**: see <https://github.com/erigontech/erigon/releases>.
+- **Docker image releases**:
+	- New Docker Image Repository: Erigon images are now available on Dockerhub repository [erigontech/erigon](https://hub.docker.com/r/erigontech/erigon).
+	- Multi-Platform Support: The docker image is built for linux/amd64/v2 and linux/arm64 platforms using Alpine.
+- **Frequently Asked Questions**: see <https://github.com/erigontech/erigon?tab=readme-ov-file#faq>.
+- **Known Issues**: See <https://github.com/erigontech/erigon?tab=readme-ov-file#known-issues>.
+- **Changes from Erigon 2**: The main changes from Erigon 2 are listed [here](https://github.com/erigontech/erigon?tab=readme-ov-file#erigon3-changes-from-erigon2).

src/about/disclaimer.md

@@ -0,0 +1,3 @@
+# Disclaimer
+
+The Erigon team does not take any responsibility for losses or damages occurred through the use of Erigon. While we employ a seasoned in-house security team, we have not subjected our systems to independent third-party security assessments.

src/advanced/JSONRPC-daemon.md

@@ -29,7 +29,7 @@ This document provides guidelines for understanding and using the various RPC me
 
 ## More info
 
-For a comprehensive understanding of the RPC daemon's functionality, configuration, and usage, please refer to *<https://github.com/erigontech/erigon/blob/main/cmd/rpcdaemon/README.md>** (also contained in your locally compiled Erigon folder at `/cmd/rpcdaemon`) which covers the following key topics:
+For a comprehensive understanding of the RPC daemon's functionality, configuration, and usage, please refer to <https://github.com/erigontech/erigon/blob/main/cmd/rpcdaemon/README.md> (also contained in your locally compiled Erigon folder at `/cmd/rpcdaemon`) which covers the following key topics:
 
 1. **Introduction**: An overview of the RPC daemon, its benefits, and how it integrates with Erigon.
 2. **Getting Started**: Step-by-step guides for running the RPC daemon locally and remotely, including configuration options and command-line flags.

src/advanced/bp-caplin.md

@@ -7,13 +7,11 @@ This guide explains how to use Erigon with its embedded Caplin consensus layer a
 
 ## 1. Start Erigon with Caplin
 
-Run the following command to start Erigon with the embedded Caplin consensus layer with the beacon API on:
+The following command starts Erigon with the embedded Caplin consensus layer with the beacon API on:
 
 ```bash
 erigon \
   --datadir=/data/erigon \
-  --chain=mainnet \
-  --prune.mode=full \
   --http \
   --http.addr=0.0.0.0 \
   --http.port=8545 \
@@ -24,13 +22,12 @@ erigon \
   --caplin.discovery.addr=0.0.0.0 \
   --caplin.discovery.port=4000 \
   --caplin.discovery.tcpport=4001 \
-  --chain=<NETWORK>
   --beacon.api=beacon,validator,builder,config,debug,events,node,lighthouse 
 ```
 
 **Flags Explanation**:
 
-- Execution Layer:
+- Execution Layer (Erigon):
     - `--http.api=engine,eth,net,web3`: enables the necessary APIs for external clients and Caplin.
     - `--ws`: enables WebSocket-based communication (optional).
 - Consensus Layer (Caplin):
@@ -41,15 +38,7 @@ erigon \
 
 ### 2.1 Install Lighthouse
 
-Download the latest Lighthouse binary:
-
-```
-curl -LO https://github.com/sigp/lighthouse/releases/latest/download/lighthouse
-chmod +x lighthouse
-sudo mv lighthouse /usr/local/bin/
-```
-
-Or, use Docker:
+Install and run Lighthouse by following the official guide at <https://lighthouse-book.sigmaprime.io/installation.html> or use Docker:
 
 ```bash
 docker pull sigp/lighthouse:latest
@@ -63,7 +52,7 @@ mkdir -p ~/.lighthouse/validators
 
 ### 2.3. Run Lighthouse Validator Client
 
-Start the validator client and connect it to the Caplin consensus layer:
+Start the validator client and connect it to the Caplin CL:
 
 ```bash
 lighthouse vc \

src/advanced/bp-ext.md

@@ -1,3 +1,54 @@
 # Using an external consensus client as validator
 
+To use an external Consensus Layer (CL) it is necessary to add to Erigon the flag `--externalcl`. Here are a couple of examples on how to configure Lighhouse and Prysm to run along with Erigon:
+
+- [Ethereum](/nodes/ethereum.md#erigon-with-prysm-as-the-external-consensus-layer)
+- [Gnosis Chain](/nodes/gnosis.md#erigon-with-lighthouse)
+
+Once you have Erigon and a CL client up and running, you can proceed to set up a Validator Client (VC). The VC is responsible for managing your keys and signing valid blocks.
+
+## Getting Started with a Validator Client
+
+To set up a VC, follow the instructions provided in the official documentation, such as:
+
+<https://lighthouse-book.sigmaprime.io/mainnet-validator.html>.
+
+This guide will walk you through the process of setting up a VC, including:
+
+- Generating and managing your keys
+- Configuring the Validator Client
+- Signing valid blocks
+
+Make sure to follow the instructions carefully and thoroughly to ensure that your VC is set up correctly. It is always recommended to start staking with a testnet.
+
+## Example of configuration
+
+The following example demonstrates how to configure Erigon to run with an external Consensus Layer:
+
+```bash
+erigon \
+  --externalcl \
+  --datadir=/data/erigon \
+  --chain=sepolia \
+  --authrpc.jwtsecret=/jwt
+  --authrpc.addr=0.0.0.0 \
+  --http \
+  --http.addr=0.0.0.0 \
+  --http.port=8545 \
+  --http.api=engine,eth,net,web3 \
+  --ws \
+  --ws.port=8546 \
+```
+
+## Flags explanation:
+
+- `--externalcl`: Enables the use of an external CL.
+- `--datadir=/data/erigon`: Defines the directory to be used for databases.
+- `--chain=sepolia`: Specifies the Sepolia chain.
+- `--authrpc.jwtsecret=/jwt`: Sets the location of the JWT authentication code in hex encoding. This is used by Erigon (the EL) and the CL (in this case Lighthouse) to authenticate communication.
+- `--authrpc.addr=0.0.0.0`: Allows the engine API to be accessed from any address.
+- `--http.api=engine,eth,net,web3`: Enables the necessary APIs for external clients and Caplin.
+- `--ws`: enables WebSocket-based communication, which is optional.
+
+> Note that many pre-merge flags, such as `--miner.etherbase`, are no longer useful, as block rewards and other validator-related configurations are now controlled by the Consensus Layer (CL).
 

src/advanced/consensus_layer.md

@@ -12,13 +12,16 @@ The consensus client, also known as the *Beacon Node* or *CL client*, implements
 
 **Information**
 
-By default, Erigon is configured to run with [Caplin](/advanced/bp-caplin.md), the embedded Consensus Layer.
+By default, Erigon is configured to run with [Caplin](/advanced/caplin.md), the embedded Consensus Layer.
 </div>
 
 ## Choosing the Consensus Layer client
 
-A Consensus Layer (CL) client needs to run alongside Erigon to run a full Ethereum node, a Gnosis Chain node and a Polygon node and its respective testnets. Basically, without a CL client the EL will never get in sync. See below which Beacon node for which chain you can run along with Erigon
+A Consensus Layer (CL) client needs to run alongside Erigon to run a full Ethereum node, a Gnosis Chain node and a Polygon node and its respective testnets. Basically, without a CL client the EL will never get in sync.
 
-- [Ethereum](./src/nodes/ethereum.md)
-- [Gnosis Chain](/nodes/gnosis.md)
-- [Polygon](/nodes/polygon.md)
+Below are the links to examples on how to configure Lighhouse and Prysm to run along with Erigon:
+
+- [Ethereum](/nodes/ethereum.md#erigon-with-prysm-as-the-external-consensus-layer)
+- [Gnosis Chain](/nodes/gnosis.md#erigon-with-lighthouse)
+
+> **important Note**: When configuring a CL client, always refer to the official CL documentation for the most up-to-date and accurate configuration instructions. This will ensure that you set up your CL client correctly and avoid any potential issues.

src/advanced/op-node.md

@@ -1,4 +1,4 @@
-# Running an Op-Node Alongside Erigon
+# Running an Op-Node alongside Erigon
 
 To run an op-node alongside Erigon, follow these steps: