From 7e6033097e2d2b7b22f988a52de7a3addec7a695 Mon Sep 17 00:00:00 2001
From: Ahmad Kaouk <56095276+ahmadkaouk@users.noreply.github.com>
Date: Wed, 19 Nov 2025 18:23:10 +0100
Subject: [PATCH] doc: Fix fast-runtime documentation (#311)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

`fast-runtime` features does not shortens block time to 3 s. It keeps it at 6 s and instead shortens epochs (1‑minute) and eras (3 sessions) to speed up validator churn and testing workflows.
---
 README.md          | 2 +-
 operator/README.md | 4 ++--
 test/README.md     | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 8552160d..953f3b33 100644
--- a/README.md
+++ b/README.md
@@ -271,7 +271,7 @@ See `.github/workflows/` for workflow definitions.
 - **Type mismatches**: Regenerate with `bun generate:types` after runtime changes
 - **Contract changes not reflected**: Run `bun generate:wagmi` after modifications
 - **Kurtosis issues**: Ensure Docker is running and Kurtosis engine is started
-- **Slow development**: Use `--features fast-runtime` for faster block times
+- **Slow development**: Use `--features fast-runtime` for shorter epochs/eras (block time stays 6s)
 - **Network launch hangs**: Check Blockscout - forge output can appear frozen
 
 See [CLAUDE.md](./CLAUDE.md) for detailed development guidance.
diff --git a/operator/README.md b/operator/README.md
index 319b0309..a9b31ee0 100644
--- a/operator/README.md
+++ b/operator/README.md
@@ -45,13 +45,13 @@ operator/
 
 ### Development Build (Fast Runtime)
 
-For local development with faster block times:
+For local development with shorter epochs and eras:
 
 ```bash
 cargo build --release --features fast-runtime
 ```
 
-This enables 3-second block times instead of the production 12-second blocks.
+This switches runtime parameters to the fast variants (1-minute epochs, 3 sessions per era) while the block time remains 6 seconds.
 
 ### Production Build
 
diff --git a/test/README.md b/test/README.md
index 74f08827..f84f8a51 100644
--- a/test/README.md
+++ b/test/README.md
@@ -68,7 +68,7 @@ The `bun cli launch` command deploys a complete local environment:
 2. **DataHaven Network**:
    - Single validator solochain
    - EVM compatibility via Frontier
-   - Fast block times (3s with `--fast-runtime`)
+   - Fast churn settings (`--fast-runtime` gives 1-minute epochs and 3-session eras while block time stays 6s)
 
 3. **Smart Contracts**:
    - EigenLayer AVS contracts deployed to Ethereum