From 49f4b5e30dab7923b93c02c6898cea3de7cefaba Mon Sep 17 00:00:00 2001
From: consumeobeydie <mustix478@email.com>
Date: Wed, 8 Jul 2026 19:57:32 +0300
Subject: [PATCH] docs: document RETH_HISTORICAL_PROOFS optional feature

---
 .env.mainnet | 5 +++++
 .env.sepolia | 5 +++++
 README.md    | 1 +
 3 files changed, 11 insertions(+)

diff --git a/.env.mainnet b/.env.mainnet
index ac9e52b66..7ed6fcd6d 100644
--- a/.env.mainnet
+++ b/.env.mainnet
@@ -48,6 +48,11 @@ STATSD_ADDRESS="172.17.0.1"
 # FLASHBLOCKS (OPTIONAL - UNCOMMENT TO ENABLE)
 # RETH_FB_WEBSOCKET_URL=wss://mainnet.flashblocks.base.org/ws
 
+# HISTORICAL PROOFS (OPTIONAL - UNCOMMENT TO ENABLE)
+# Enables historical proof generation. Initialization may take up to 6 hours on first run.
+# RETH_HISTORICAL_PROOFS=true
+# RETH_HISTORICAL_PROOFS_STORAGE_PATH=/data/proofs
+
 # PRUNING (OPTIONAL - UNCOMMENT TO ENABLE)
 # NOTE: Set to any number of blocks you want, but it should be >10064
 # NOTE: The node type that was chosen when first running a node cannot be changed after the initial sync. Turning Archive into Pruned, or Pruned into Full is not supported [source](https://reth.rs/run/faq/pruning/).
diff --git a/.env.sepolia b/.env.sepolia
index e518129fb..e7c9e8aaf 100644
--- a/.env.sepolia
+++ b/.env.sepolia
@@ -48,6 +48,11 @@ STATSD_ADDRESS="172.17.0.1"
 # FLASHBLOCKS (OPTIONAL - UNCOMMENT TO ENABLE)
 # RETH_FB_WEBSOCKET_URL=wss://sepolia.flashblocks.base.org/ws
 
+# HISTORICAL PROOFS (OPTIONAL - UNCOMMENT TO ENABLE)
+# Enables historical proof generation. Initialization may take up to 6 hours on first run.
+# RETH_HISTORICAL_PROOFS=true
+# RETH_HISTORICAL_PROOFS_STORAGE_PATH=/data/proofs
+
 # PRUNING (OPTIONAL - UNCOMMENT TO ENABLE)
 # NOTE: Set to any number of blocks you want, but it should be >10064
 # NOTE: The node type that was chosen when first running a node cannot be changed after the initial sync. Turning Archive into Pruned, or Pruned into Full is not supported [source](https://reth.rs/run/faq/pruning/).
diff --git a/README.md b/README.md
index 2e0b62998..38835de8d 100644
--- a/README.md
+++ b/README.md
@@ -81,6 +81,7 @@ The following are the hardware specifications we use in production:
 - Flashblocks: set `RETH_FB_WEBSOCKET_URL`. When set, the execution client runs in Flashblocks mode; otherwise it runs in vanilla mode.
 - Follow mode: set `BASE_NODE_SOURCE_L2_RPC`
 - Pruning: set `RETH_PRUNING_ARGS`
+- Historical Proofs: set `RETH_HISTORICAL_PROOFS=true` and `RETH_HISTORICAL_PROOFS_STORAGE_PATH=<path>`. Enables historical proof generation. Note: initialization may take up to 6 hours on first run.
 
 For full configuration options, see `.env.mainnet` or `.env.sepolia`.