Add changelog entries for pooled cache stores

Author: fastfadingviolets

CHANGELOG.md

@@ -42,6 +42,7 @@ Ref: https://keepachangelog.com/en/1.0.0/
 
 * (baseapp) [#24655](https://github.com/cosmos/cosmos-sdk/pull/24655) Add mutex locks for `state` and make `lastCommitInfo` atomic to prevent race conditions between `Commit` and `CreateQueryContext`.
 * (proto) [#24161](https://github.com/cosmos/cosmos-sdk/pull/24161) Remove unnecessary annotations from `x/staking` authz proto.
+* (baseapp) [#24608](https://github.com/cosmos/cosmos-sdk/pull/24608) Use a `PooledCacheMultiStore` in `cacheTxContext` to prevent allocating a new cache for every transaction.
 
 ### Bug Fixes
 

store/CHANGELOG.md

@@ -23,6 +23,12 @@ Ref: https://keepachangelog.com/en/1.0.0/
 
 # Changelog
 
+## [Unreleased]
+
+### Improvements
+
+* [#24608](https://github.com/cosmos/cosmos-sdk/pull/24608) Introduced pooled versions of cache stores to avoid allocating new caches.
+
 ## v1.1.2 (March 31, 2025)
 
 ### Bug Fixes

store/cachekv/internal/btree.go

@@ -36,7 +36,7 @@ func NewBTree() BTree {
 	}
 }
 
-// Clear clears the tree.
+// Clear resets the tree by setting the root node to nil, dropping all items.
 func (bt BTree) Clear() {
 	bt.tree.Clear()
 }

store/cachekv/store.go

@@ -38,7 +38,10 @@ type PooledStore struct {
 	Store
 }
 
-var _ types.CacheKVStore = (*Store)(nil)
+var (
+	_ types.CacheKVStore       = (*Store)(nil)
+	_ types.PooledCacheKVStore = (*PooledStore)(nil)
+)
 
 // NewStore creates a new Store object
 func NewStore(parent types.KVStore) *Store {
@@ -50,6 +53,10 @@ func NewStore(parent types.KVStore) *Store {
 	}
 }
 
+// storePool is a pool of PooledStore instances. It contains a set of objects
+// that can be reused instead of allocating new ones. It's thread safe.
+// Callers can use Get() to retrieve a store (or allocate a new one if none are available).
+// Callers should use Put() when done with the store to return it to the pool.
 var storePool = sync.Pool{
 	New: func() any {
 		return &PooledStore{

store/cachemulti/store.go

@@ -83,6 +83,10 @@ func NewStore(
 	return NewFromKVStore(dbadapter.Store{DB: db}, stores, keys, traceWriter, traceContext)
 }
 
+// storePool is a pool of PooledStore instances. It contains a set of objects
+// that can be reused instead of allocating new ones. It's thread safe.
+// Callers can use Get() to retrieve a store (or allocate a new one if none are available).
+// Callers should use Put() when done with the store to return it to the pool.
 var storePool = sync.Pool{
 	New: func() any {
 		return &PooledStore{
@@ -122,15 +126,15 @@ func newFromKVStorePooled(
 func (cms *PooledStore) Release() {
 	// clear the stores map
 	for k, v := range cms.stores {
-		if pStore, ok := v.(*cachekv.PooledStore); ok {
+		if pStore, ok := v.(types.PooledCacheKVStore); ok {
 			pStore.Release()
 		}
 		delete(cms.stores, k)
 	}
 	for k := range cms.keys {
 		delete(cms.keys, k)
 	}
-	if pStoreDb, ok := cms.db.(*cachekv.PooledStore); ok {
+	if pStoreDb, ok := cms.db.(types.PooledCacheKVStore); ok {
 		pStoreDb.Release()
 	}
 	cms.db = nil

store/types/store.go

@@ -288,6 +288,12 @@ type CacheKVStore interface {
 	Write()
 }
 
+// PooledCacheKVStore is a CacheKVStore that can be pooled and reused without the overhead of allocation.
+type PooledCacheKVStore interface {
+	CacheKVStore
+	Release()
+}
+
 // CommitKVStore is an interface for MultiStore.
 type CommitKVStore interface {
 	Committer