From 1ec7cedc6bf3985b2c0c0075d51a322e9669958d Mon Sep 17 00:00:00 2001
From: masih <m@derkani.org>
Date: Thu, 17 Sep 2026 04:59:39 +0000
Subject: [PATCH] Settle async state and receipt writes before evmrpc tests
 query committed blocks

---
 evmrpc/tests/utils.go                 | 43 ++++++++++++++++++---------
 sei-db/state_db/ss/composite/store.go | 10 +++++++
 2 files changed, 39 insertions(+), 14 deletions(-)

diff --git a/evmrpc/tests/utils.go b/evmrpc/tests/utils.go
index 54592ac5d9..78bbf620c0 100644
--- a/evmrpc/tests/utils.go
+++ b/evmrpc/tests/utils.go
@@ -5,7 +5,6 @@ import (
 	"encoding/json"
 	"fmt"
 	"io"
-	"math"
 	"net/http"
 	"strings"
 	"sync/atomic"
@@ -20,6 +19,7 @@ import (
 	evmrpcconfig "github.com/sei-protocol/sei-chain/evmrpc/config"
 	"github.com/sei-protocol/sei-chain/sei-cosmos/client"
 	sdk "github.com/sei-protocol/sei-chain/sei-cosmos/types"
+	dbtypes "github.com/sei-protocol/sei-chain/sei-db/db_engine/types"
 	"github.com/sei-protocol/sei-chain/sei-db/ledger_db/receipt"
 	abci "github.com/sei-protocol/sei-chain/sei-tendermint/abci/types"
 	tmproto "github.com/sei-protocol/sei-chain/sei-tendermint/proto/tendermint/types"
@@ -73,24 +73,39 @@ func (ts TestServer) SetupBlocks(blocks [][][]byte, initializer ...func(sdk.Cont
 		_, _ = ts.app.Commit(context.Background())
 		ts.mockClient.recordBlockResult(res.TxResults, res.ConsensusParamUpdates, res.Events)
 	}
-	pinStateStoreLatestVersion(ts.app, ts.ctxProvider)
+	settleCommittedBlocks(ts.app, ts.ctxProvider)
 }
 
-// pinStateStoreLatestVersion advances the state store's latest version to the app's
-// committed height so the RPC watermark does not lag behind the asynchronous SS writer.
-func pinStateStoreLatestVersion(a *app.App, ctxProvider func(int64) sdk.Context) {
-	stateStore := a.GetStateStore()
-	if stateStore == nil {
-		return
-	}
+// settleCommittedBlocks blocks until the state store and receipt store have applied every block the
+// app has committed. Both apply writes in the background, so a query served from either right after
+// Commit would otherwise read state that is not there yet.
+func settleCommittedBlocks(a *app.App, ctxProvider func(int64) sdk.Context) {
 	latest := ctxProvider(evmrpc.LatestCtxHeight).BlockHeight()
-	if stateStore.GetLatestVersion() < latest {
-		if err := stateStore.SetLatestVersion(latest); err != nil {
-			panic(err)
+	if stateStore := a.GetStateStore(); stateStore != nil {
+		if w, ok := stateStore.(dbtypes.PendingWriteWaiter); ok {
+			w.WaitForPendingWrites()
+		}
+		if stateStore.GetLatestVersion() < latest {
+			if err := stateStore.SetLatestVersion(latest); err != nil {
+				panic(err)
+			}
+		}
+	}
+	if store := a.EvmKeeper.ReceiptStore(); store != nil {
+		deadline := time.Now().Add(receiptSettleTimeout)
+		for store.LatestVersion() < latest {
+			if time.Now().After(deadline) {
+				panic(fmt.Sprintf("receipt store still at version %d after committing height %d", store.LatestVersion(), latest))
+			}
+			time.Sleep(time.Millisecond)
 		}
 	}
 }
 
+// receiptSettleTimeout bounds how long settleCommittedBlocks waits for the receipt writer, which
+// otherwise has no failure signal a caller can observe short of the package test timeout.
+const receiptSettleTimeout = 30 * time.Second
+
 func initializeApp(
 	t *testing.T,
 	chainID string,
@@ -186,10 +201,10 @@ func setupTestServer(
 	if err != nil {
 		panic(err)
 	}
-	pinStateStoreLatestVersion(a, ctxProvider)
+	settleCommittedBlocks(a, ctxProvider)
 	if store := a.EvmKeeper.ReceiptStore(); store != nil {
 		// These tests seed receipts by other means and would otherwise read against an unset window.
-		if err := receipt.PinVersions(store, 1, math.MaxInt64); err != nil {
+		if err := receipt.PinVersions(store, 1, store.LatestVersion()); err != nil {
 			panic(err)
 		}
 	}
diff --git a/sei-db/state_db/ss/composite/store.go b/sei-db/state_db/ss/composite/store.go
index 7707010c0a..ae6cfcf52a 100644
--- a/sei-db/state_db/ss/composite/store.go
+++ b/sei-db/state_db/ss/composite/store.go
@@ -324,6 +324,16 @@ func (s *CompositeStateStore) GetLatestVersion() int64 {
 	return s.cosmosStore.GetLatestVersion()
 }
 
+// WaitForPendingWrites blocks until both underlying stores have applied every queued changeset.
+func (s *CompositeStateStore) WaitForPendingWrites() {
+	if w, ok := s.cosmosStore.(types.PendingWriteWaiter); ok {
+		w.WaitForPendingWrites()
+	}
+	if w, ok := s.evmStore.(types.PendingWriteWaiter); ok {
+		w.WaitForPendingWrites()
+	}
+}
+
 func (s *CompositeStateStore) GetEarliestVersion() int64 {
 	earliest := s.cosmosStore.GetEarliestVersion()
 	if s.evmStore != nil {