From 1dc0798a136fdd4dc697d474dbcc3841e8863e5e Mon Sep 17 00:00:00 2001
From: Evgeny Gusarov <evgeny@stakewise.io>
Date: Thu, 24 Sep 2026 11:48:36 +0300
Subject: [PATCH] Bump v3-operator:v5.1.0 and update execution client pruning
 limits

v5.1.0 only needs event logs from per-network checkpoints, so document
the new retention blocks and replace the Keeper-only Reth log filter
with a global receipts limit.
---
 operator/launch-operator-service.mdx |  6 +++---
 operator/staking-nodes.mdx           | 27 ++++++++++++++-------------
 operator/start-operator.mdx          |  2 +-
 3 files changed, 18 insertions(+), 17 deletions(-)

diff --git a/operator/launch-operator-service.mdx b/operator/launch-operator-service.mdx
index 33420d4..1385f4a 100644
--- a/operator/launch-operator-service.mdx
+++ b/operator/launch-operator-service.mdx
@@ -100,7 +100,7 @@ The Operator Service can be installed as a binary, via Docker, or built from sou
     Pull Official Image
 
     ```bash
-    docker pull europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.0.0
+    docker pull europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.1.0
     ```
 
     Alternatively, build the Docker image locally:
@@ -108,7 +108,7 @@ The Operator Service can be installed as a binary, via Docker, or built from sou
     ```bash
     git clone https://github.com/stakewise/v3-operator.git
     cd v3-operator
-    docker build --pull -t europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.0.0 .
+    docker build --pull -t europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.1.0 .
     ```
 
     Run commands using this format:
@@ -117,7 +117,7 @@ The Operator Service can be installed as a binary, via Docker, or built from sou
     docker run --rm -ti \
     -u $(id -u):$(id -g) \
     -v ~/.stakewise/:/data \
-    europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.0.0 \
+    europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.1.0 \
     src/main.py COMMAND \
     --flagA=123 \
     --flagB=xyz
diff --git a/operator/staking-nodes.mdx b/operator/staking-nodes.mdx
index ce03582..ea345d3 100644
--- a/operator/staking-nodes.mdx
+++ b/operator/staking-nodes.mdx
@@ -25,8 +25,15 @@ Your execution node must be fully synced and running. Any client that supports t
 - **[Reth ↗](https://github.com/paradigmxyz/reth)** — (Ethereum)
 
 :::custom-warning[Configure execution client]
-Preserve event logs to ensure the Operator Service functions correctly.
-Some clients require specific configuration to sync event logs and prevent event log pruning:
+The Operator Service needs event logs from a network checkpoint onward. If your execution client prunes history, retain receipts and logs from at least the following blocks:
+
+| Network | Required from block | Recommended setting |
+| --- | --- | --- |
+| Ethereum | 25,933,938 | 25,900,000 |
+| Hoodi | 3,583,807 | 3,580,000 |
+| Gnosis | 48,127,042 | 48,100,000 |
+
+The recommended value rounds down to leave a safety margin; any block at or below it works.
 
 <Tabs groupId="special-config" defaultValue="erigon">
   <TabItem value="nethermind" label="Nethermind">
@@ -39,28 +46,22 @@ Some clients require specific configuration to sync event logs and prevent event
   <TabItem value="erigon" label="Erigon">
     ```bash
     # Ethereum Mainnet
-    erigon --prune=receipts --prune.to=18470089
-
-    # For other networks, adjust the block number to the Keeper contract creation block
+    erigon --prune=receipts --prune.to=25900000
     ```
-
-  These flags prevent pruning of event logs as required by the Operator Service.
   </TabItem>
   <TabItem value="reth" label="Reth">
     Add the following option to Reth command:
 
     ```bash
     # Ethereum Mainnet
-    --prune.receiptslogfilter=0x6b5815467da09daa7dc83db21c9239d98bb487b5:before:18470089
-
-    # For other networks, adjust the block number to the Keeper contract creation block
+    --prune.receipts.before=25900000
     ```
-
-    The [Keeper contract ↗](https://etherscan.io/address/0x6B5815467da09DaA7DC83Db21c9239D98Bb487b5#code) on Ethereum Mainnet is located at
-    `0x6b5815467da09daa7dc83db21c9239d98bb487b5` (must be provided in lowercase).
   </TabItem>
 </Tabs>
 
+For other networks, use the recommended setting from the table above.
+
+Operator Service versions before v5.1.0 still require the full event log history since the Keeper contract deployment. Upgrade the Operator Service before pruning.
 :::
 
 ## Consensus Client
diff --git a/operator/start-operator.mdx b/operator/start-operator.mdx
index 46a251b..19df1ff 100644
--- a/operator/start-operator.mdx
+++ b/operator/start-operator.mdx
@@ -43,7 +43,7 @@ Choose the format matching your installation method:
     <CommandSnippet template={`docker run --restart on-failure:10 \\
 -u $(id -u):$(id -g) \\
 -v ~/.stakewise/:/data \\
-europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.0.0 \\
+europe-west4-docker.pkg.dev/stakewiselabs/public/v3-operator:v5.1.0 \\
 src/main.py start \\
 --vault={{0x834F27bC8670491b75af512d943f01D5383F87Cf}} \\
 --data-dir=/data \\