Merge branch 'main' into 20250826_timeout_handler

Author: meetrick

CHANGELOG.md

@@ -55,7 +55,7 @@ Ref: https://keepachangelog.com/en/1.0.0/
 * (crypto) [#24919](https://github.com/cosmos/cosmos-sdk/pull/24919) add `NewPubKeyFromBytes` function to the `secp256r1` package to create `PubKey` from bytes
 * (server) [#24720](https://github.com/cosmos/cosmos-sdk/pull/24720) add `verbose_log_level` flag for configuring the log level when switching to verbose logging mode during sensitive operations (such as chain upgrades).
 * (crypto) [#24861](https://github.com/cosmos/cosmos-sdk/pull/24861) add `PubKeyFromCometTypeAndBytes` helper function to convert from `comet/v2` PubKeys to the `cryptotypes.Pubkey` interface.
-* (abci_utils) [#25008](https://github.com/cosmos/cosmos-sdk/pull/24861) add the ability to assign a custom signer extraction adapter in `DefaultProposalHandler`.
+* (abci_utils) [#25008](https://github.com/cosmos/cosmos-sdk/pull/25008) add the ability to assign a custom signer extraction adapter in `DefaultProposalHandler`.
 
 ### Improvements
 

README.md

@@ -24,8 +24,10 @@
   </a>
   <a href="https://github.com/cosmos/cosmos-sdk/actions/workflows/sims.yml">
     <img alt="Sims" src="https://github.com/cosmos/cosmos-sdk/workflows/Sims/badge.svg" />
+  </a>
   <a href="https://github.com/cosmos/cosmos-sdk/actions/workflows/lint.yml"> 
     <img alt="Lint Status" src="https://github.com/cosmos/cosmos-sdk/workflows/Lint/badge.svg" />
+  </a>
 </div>
 
 The Cosmos SDK is a framework for building blockchain applications. [CometBFT (BFT Consensus)](https://github.com/cometbft/cometbft) and the Cosmos SDK are written in the Go programming language. Cosmos SDK is used to build [Gaia](https://github.com/cosmos/gaia), the implementation of the Cosmos Hub.

docs/architecture/adr-063-core-module-api.md

@@ -192,8 +192,6 @@ func NewKeeper(logger log.Logger) Keeper {
 }
 ```
 
-```
-
 ### Core `AppModule` extension interfaces
 
 

x/simulation/params.go

@@ -20,7 +20,20 @@ const (
 	maxTimePerBlock int64 = 10000
 )
 
-// TODO: explain transitional matrix usage
+// The transition matrices below control stochastic behavior in the simulation:
+//
+//   - defaultLivenessTransitionMatrix: models validator liveness across three
+//     states (online, spotty, offline). Each column represents the current state,
+//     each row represents the next state; entries are integer weights used for
+//     weighted random selection. Higher weights mean higher probability.
+//
+//   - defaultBlockSizeTransitionMatrix: models block size regimes across three
+//     states (large range, medium range, zero). Similar column-as-current,
+//     row-as-next convention applies.
+//
+// These matrices are fed into CreateTransitionMatrix, which precomputes column
+// totals for efficient sampling. During simulation, NextState(r, i) is called
+// with a deterministic RNG r and current state i to obtain the next state.
 var (
 	// Currently there are 3 different liveness types,
 	// fully online, spotty connection, offline.

x/simulation/transition_matrix.go

@@ -20,7 +20,25 @@ type TransitionMatrix struct {
 }
 
 // CreateTransitionMatrix creates a transition matrix from the provided weights.
-// TODO: Provide example usage
+//
+// Example:
+//
+//	weights := [][]int{
+//	  // From state 0 to states 0,1,2
+//	  {90, 10, 0},
+//	  // From state 1 to states 0,1,2
+//	  {20, 70, 10},
+//	  // From state 2 to states 0,1,2
+//	  {5,  15, 80},
+//	}
+//	tm, err := CreateTransitionMatrix(weights)
+//	if err != nil {
+//	  // handle error
+//	}
+//
+//	// NextState picks the next state from current state i.
+//	// r should be a deterministic *rand.Rand when used in simulations.
+//	// next := tm.NextState(r, i)
 func CreateTransitionMatrix(weights [][]int) (simulation.TransitionMatrix, error) {
 	n := len(weights)
 	for i := range n {