Merge branch 'main' into development

Author: bloxster

src/advanced/downloader.md

@@ -7,7 +7,7 @@ The Downloader is a service responsible for seeding and downloading historical d
 
 **Information**:
 
-While all Erigon components are separable and can be run on different machines, the downloader must run on the same machine as Erigon to be able to share downloaded and seeded files.
+While all Erigon components are separable and can be run on different machines, the Downloader must run on the same machine as Erigon to be able to share downloaded and seeded files.
 
 </div>
 

src/advanced/options.md

@@ -29,6 +29,11 @@ COMMANDS:
    seg, snapshots, segments  Managing historical data segments (partitions)
    support                   Connect Erigon instance to a diagnostics system for support
    help, h                   Shows a list of commands or help for one command
+   init                      Bootstrap and initialize a new genesis block
+   import                    Import a blockchain file
+   seg, snapshots, segments  Managing historical data segments (partitions)
+   support                   Connect Erigon instance to a diagnostics system for support
+   help, h                   Shows a list of commands or help for one command
 
 GLOBAL OPTIONS:
    --datadir value                                                                  Data directory for the databases (default: /home/bloxster/.local/share/erigon)
@@ -48,6 +53,10 @@ GLOBAL OPTIONS:
    --txpool.commit.every value                                                      How often transactions should be committed to the storage (default: 15s)
    --prune.distance value                                                           Keep state history for the latest N blocks (default: everything) (default: 0)
    --prune.distance.blocks value                                                    Keep block history for the latest N blocks (default: everything) (default: 0)
+   --prune.mode value                                                               Choose a pruning preset to run onto. Available values: "full", "archive", "minimal".
+                                                                                          Full: Keep only blocks and latest state,
+                                                                                          Archive: Keep the entire indexed database, aka. no pruning,
+                                                                                          Minimal: Keep only latest state (default: "full")
    --prune.mode value                                                               Choose a pruning preset to run onto. Available values: "full", "archive", "minimal".
                                                                                           Full: Keep only blocks and latest state,
                                                                                           Archive: Keep the entire indexed database, aka. no pruning,
@@ -87,6 +96,7 @@ GLOBAL OPTIONS:
    --rpc.batch.concurrency value                                                    Does limit amount of goroutines to process 1 batch request. Means 1 bach request can't overload server. 1 batch still can have unlimited amount of request (default: 2)
    --rpc.streaming.disable                                                          Erigon has enabled json streaming for some heavy endpoints (like trace_*). It's a trade-off: greatly reduce amount of RAM (in some cases from 30GB to 30mb), but it produce invalid json format if error happened in the middle of streaming (because json is not streaming-friendly format) (default: false)
    --db.read.concurrency value                                                      Does limit amount of parallel db reads. Default: equal to GOMAXPROCS (or number of CPU) (default: 1408)
+   --db.read.concurrency value                                                      Does limit amount of parallel db reads. Default: equal to GOMAXPROCS (or number of CPU) (default: 1408)
    --rpc.accessList value                                                           Specify granular (method-by-method) API allowlist
    --trace.compat                                                                   Bug for bug compatibility with OE for trace_ routines (default: false)
    --rpc.gascap value                                                               Sets a cap on gas that can be used in eth_call/estimateGas (default: 50000000)
@@ -148,6 +158,7 @@ GLOBAL OPTIONS:
    --staticpeers value                                                              Comma separated enode URLs to connect to
    --trustedpeers value                                                             Comma separated enode URLs which are always allowed to connect, even above the peer limit
    --maxpeers value                                                                 Maximum number of network peers (network disabled if set to 0) (default: 32)
+   --maxpeers value                                                                 Maximum number of network peers (network disabled if set to 0) (default: 32)
    --chain value                                                                    name of the network to join (default: "mainnet")
    --dev.period value                                                               Block period to use in developer mode (0 = mine only if transaction pending) (default: 0)
    --vmdebug                                                                        Record information useful for VM and contract debugging (default: false)
@@ -165,6 +176,7 @@ GLOBAL OPTIONS:
    --proposer.disable                                                               Disables PoS proposer (default: false)
    --miner.notify value                                                             Comma separated HTTP URL list to notify of new work packages
    --miner.gaslimit value                                                           Target gas limit for mined blocks (default: 36000000)
+   --miner.gaslimit value                                                           Target gas limit for mined blocks (default: 36000000)
    --miner.etherbase value                                                          Public address for block mining rewards (default: "0")
    --miner.extradata value                                                          Block extra data set by the miner (default = client version)
    --miner.noverify                                                                 Disable remote sealing verification (default: false)
@@ -199,6 +211,12 @@ GLOBAL OPTIONS:
    --caplin.max-inbound-traffic-per-peer value                                      Max inbound traffic per second per peer (default: "256KB")
    --caplin.max-outbound-traffic-per-peer value                                     Max outbound traffic per second per peer (default: "256KB")
    --caplin.adaptable-maximum-traffic-requirements                                  Make the node adaptable to the maximum traffic requirement based on how many validators are being ran (default: true)
+   --caplin.subscribe-all-topics                                                    Subscribe to all gossip topics (default: false)
+   --caplin.max-peer-count value                                                    Max number of peers to connect (default: 80)
+   --caplin.enable-upnp                                                             Enable NAT porting for Caplin (default: false)
+   --caplin.max-inbound-traffic-per-peer value                                      Max inbound traffic per second per peer (default: "256KB")
+   --caplin.max-outbound-traffic-per-peer value                                     Max outbound traffic per second per peer (default: "256KB")
+   --caplin.adaptable-maximum-traffic-requirements                                  Make the node adaptable to the maximum traffic requirement based on how many validators are being ran (default: true)
    --sentinel.addr value                                                            Address for sentinel (default: "localhost")
    --sentinel.port value                                                            Port for sentinel (default: 7777)
    --sentinel.bootnodes value [ --sentinel.bootnodes value ]                        Comma separated enode URLs for P2P discovery bootstrap
@@ -216,6 +234,7 @@ GLOBAL OPTIONS:
    --silkworm.rpc.workers value                                                     Number of worker threads used in embedded Silkworm RPC service (zero means use default in Silkworm) (default: 0)
    --silkworm.rpc.compatibility                                                     Preserve JSON-RPC compatibility using embedded Silkworm RPC service (default: true)
    --beacon.api value [ --beacon.api value ]                                        Enable beacon API (available endpoints: beacon, builder, config, debug, events, node, validator, lighthouse)
+   --beacon.api value [ --beacon.api value ]                                        Enable beacon API (available endpoints: beacon, builder, config, debug, events, node, validator, lighthouse)
    --beacon.api.addr value                                                          sets the host to listen for beacon api requests (default: "localhost")
    --beacon.api.cors.allow-methods value [ --beacon.api.cors.allow-methods value ]  set the cors' allow methods (default: "GET", "POST", "PUT", "DELETE", "OPTIONS")
    --beacon.api.cors.allow-origins value [ --beacon.api.cors.allow-origins value ]  set the cors' allow origins
@@ -232,6 +251,7 @@ GLOBAL OPTIONS:
    --caplin.blobs-no-pruning                                                        disable blob pruning in caplin (default: false)
    --caplin.checkpoint-sync.disable                                                 disable checkpoint sync in caplin (default: false)
    --caplin.snapgen                                                                 enables snapshot generation in caplin (default: false)
+   --caplin.snapgen                                                                 enables snapshot generation in caplin (default: false)
    --caplin.mev-relay-url value                                                     MEV relay endpoint. Caplin runs in builder mode if this is set
    --caplin.validator-monitor                                                       Enable caplin validator monitoring metrics (default: false)
    --caplin.custom-config value                                                     set the custom config for caplin

src/basic/node.md

@@ -6,8 +6,10 @@ Erigon 3 introduces a flexible approach to node configuration, offering three di
 |--------------|--------------|-----------|--------------|
 | Privacy, RPC |    **Yes**   |   **Yes** |    **Yes**   |
 | Contribute to network | No  |   **Yes** |    **Yes**   |
+| Contribute to network | No  |   **Yes** |    **Yes**   |
 | Research     |    No        |    No     |    **Yes**   |
 | Staking      |    **Yes**   |  **Yes**  |    **Yes**   |
+| Staking      |    **Yes**   |  **Yes**  |    **Yes**   |
 
 ## Minimal node
 

src/installation/build_exec_win.md

@@ -57,6 +57,7 @@ Open the Command Prompt and type the following:
 ```bash
 git clone --branch v3.0.0-beta1 --single-branch https://github.com/erigontech/erigon.git
 ```
+
 You might need to change the `ExecutionPolicy` to allow scripts created locally or signed by a trusted publisher to run:
 
 ```powershell

src/installation/docker.md

@@ -34,6 +34,7 @@ docker images
 ```
 
 * Check which Erigon version has been downloaded:
+
 ```bash
 docker run -it <image_id> --v
 ```
@@ -43,6 +44,7 @@ docker run -it <image_id> --v
 ```bash
 docker run -it 50bef1b5d0f9 --chain=holesky --prune.mode=minimal
 ```
+
 * When done, exit the container or press `Ctrl+C`. The container will stop.
 
 ## Optional: Setup dedicated user

src/installation/upgrading-md

@@ -3,11 +3,15 @@
 To upgrade Erigon to a newer version when you've originally installed it via Git and manual compilation, you should follow these steps without needing to delete the entire folder:
 
 * **Terminate your Erigon** session by pressing CTRL+C
-* *Navigate to your Erigon directory*
+
+* **Navigate to your Erigon directory**
+
 * **Fetch the latest changes from the repository**: You need to make sure your local repository is up-to-date with the main GitHub repository. Run:
+
     ```bash
     git fetch --tags
     ```
+
 * **Check out** the [latest version](https://github.com/ledgerwatch/erigon/releases) and switch to it using:
 
     ```bash
@@ -38,9 +42,9 @@ If you're using Docker to run Erigon, the process to upgrade to a newer version
     ```
 
     Replace `<new_version_tag>` with the actual version tag you wish to use. For example:
-
+    
     ```bash
-    docker pull erigontech/erigon:3.0.0
+    docker pull erigontech/erigon:v3.0.0-beta1
     ```
 
 * **List Your Docker Images**: Check your downloaded images to confirm the new image is there and get the new image ID: