Merge branch 'main' into marko/flatten_grpc

Author: tac0turtle

CHANGELOG.md

@@ -14,6 +14,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Optimization of mutex usage in cache for reaper [#3286](https://github.com/evstack/ev-node/pull/3286)
 - Add Unix domain socket support for gRPC execution endpoints via `unix:///path/to/socket` [#3297](https://github.com/evstack/ev-node/pull/3297)
 - **BREAKING:** Replace legacy gRPC execution `txs` payload fields with `tx_batch` so clients and servers use contiguous transaction buffers [#3297](https://github.com/evstack/ev-node/pull/3297)
+- Optimize metadata writes by making it async in cache store [#3298](https://github.com/evstack/ev-node/pull/3298)
+- Reduce tx cache retention to avoid OOM under (really) heavy tx load [#3299](https://github.com/evstack/ev-node/pull/3299)
 
 ## v1.1.1
 

block/internal/cache/manager.go

@@ -26,7 +26,8 @@ const (
 	DataDAIncludedPrefix = "cache/data-da-included/"
 
 	// DefaultTxCacheRetention is the default time to keep transaction hashes in cache.
-	DefaultTxCacheRetention = 24 * time.Hour
+	// Keeping a too high value can lead to OOM during heavy transaction load.
+	DefaultTxCacheRetention = 30 * time.Minute
 )
 
 // CacheManager provides thread-safe cache operations for tracking seen blocks

block/internal/reaping/reaper.go

@@ -21,7 +21,10 @@ import (
 const (
 	// MaxBackoffInterval is the maximum backoff interval for retries
 	MaxBackoffInterval = 30 * time.Second
-	CleanupInterval    = 1 * time.Hour
+
+	// CleanupInterval is how often the reaper sweeps expired hashes
+	// out of the seen-tx cache.
+	CleanupInterval = max(cache.DefaultTxCacheRetention/10, 15*time.Second)
 )
 
 // Reaper is responsible for periodically retrieving transactions from the executor,

docs/.vitepress/config.ts

@@ -279,6 +279,24 @@ function sidebarHome() {
             },
           ],
         },
+        {
+          text: "High Availability",
+          collapsed: true,
+          items: [
+            {
+              text: "Overview & Configuration",
+              link: "/guides/ha/overview",
+            },
+            {
+              text: "Bootstrap a 5-Node Cluster",
+              link: "/guides/ha/cluster-setup",
+            },
+            {
+              text: "Migrate Single → HA",
+              link: "/guides/ha/single-to-ha",
+            },
+          ],
+        },
         {
           text: "Run a Full Node",
           link: "/guides/full-node",