2019-08-13 15:16:03 -07:00
|
|
|
package module
|
|
|
|
|
|
|
|
import (
|
2019-08-28 07:58:25 -07:00
|
|
|
"encoding/json"
|
|
|
|
"math/rand"
|
|
|
|
"time"
|
|
|
|
|
|
|
|
"github.com/cosmos/cosmos-sdk/codec"
|
2019-08-13 15:16:03 -07:00
|
|
|
sdk "github.com/cosmos/cosmos-sdk/types"
|
2019-08-28 07:58:25 -07:00
|
|
|
"github.com/cosmos/cosmos-sdk/x/simulation"
|
2019-08-13 15:16:03 -07:00
|
|
|
)
|
|
|
|
|
2019-08-28 07:58:25 -07:00
|
|
|
// AppModuleSimulation defines the standard functions that every module should expose
|
|
|
|
// for the SDK blockchain simulator
|
|
|
|
type AppModuleSimulation interface {
|
|
|
|
// register a func to decode the each module's defined types from their corresponding store key
|
|
|
|
RegisterStoreDecoder(sdk.StoreDecoderRegistry)
|
|
|
|
|
|
|
|
// randomized genesis states
|
|
|
|
GenerateGenesisState(input *SimulationState)
|
|
|
|
|
|
|
|
// randomized module parameters for param change proposals
|
|
|
|
RandomizedParams(r *rand.Rand) []simulation.ParamChange
|
|
|
|
}
|
|
|
|
|
2019-08-13 15:16:03 -07:00
|
|
|
// SimulationManager defines a simulation manager that provides the high level utility
|
|
|
|
// for managing and executing simulation functionalities for a group of modules
|
|
|
|
type SimulationManager struct {
|
2019-08-28 07:58:25 -07:00
|
|
|
Modules []AppModuleSimulation // array of app modules; we use an array for deterministic simulation tests
|
|
|
|
StoreDecoders sdk.StoreDecoderRegistry // functions to decode the key-value pairs from each module's store
|
2019-08-13 15:16:03 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
// NewSimulationManager creates a new SimulationManager object
|
2019-08-28 07:58:25 -07:00
|
|
|
//
|
|
|
|
// CONTRACT: All the modules provided must be also registered on the module Manager
|
|
|
|
func NewSimulationManager(modules ...AppModuleSimulation) *SimulationManager {
|
2019-08-13 15:16:03 -07:00
|
|
|
return &SimulationManager{
|
2019-08-28 07:58:25 -07:00
|
|
|
Modules: modules,
|
2019-08-13 15:16:03 -07:00
|
|
|
StoreDecoders: make(sdk.StoreDecoderRegistry),
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// RegisterStoreDecoders registers each of the modules' store decoders into a map
|
|
|
|
func (sm *SimulationManager) RegisterStoreDecoders() {
|
|
|
|
for _, module := range sm.Modules {
|
|
|
|
module.RegisterStoreDecoder(sm.StoreDecoders)
|
|
|
|
}
|
|
|
|
}
|
2019-08-28 07:58:25 -07:00
|
|
|
|
|
|
|
// GenerateGenesisStates generates a randomized GenesisState for each of the
|
|
|
|
// registered modules
|
|
|
|
func (sm *SimulationManager) GenerateGenesisStates(input *SimulationState) {
|
|
|
|
for _, module := range sm.Modules {
|
|
|
|
module.GenerateGenesisState(input)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// GenerateParamChanges generates randomized contents for creating params change
|
|
|
|
// proposal transactions
|
|
|
|
func (sm *SimulationManager) GenerateParamChanges(seed int64) (paramChanges []simulation.ParamChange) {
|
|
|
|
r := rand.New(rand.NewSource(seed))
|
|
|
|
|
|
|
|
for _, module := range sm.Modules {
|
|
|
|
paramChanges = append(paramChanges, module.RandomizedParams(r)...)
|
|
|
|
}
|
|
|
|
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
// SimulationState is the input parameters used on each of the module's randomized
|
|
|
|
// GenesisState generator function
|
|
|
|
type SimulationState struct {
|
|
|
|
AppParams simulation.AppParams
|
|
|
|
Cdc *codec.Codec // application codec
|
|
|
|
Rand *rand.Rand // random number
|
|
|
|
GenState map[string]json.RawMessage // genesis state
|
|
|
|
Accounts []simulation.Account // simulation accounts
|
|
|
|
InitialStake int64 // initial coins per account
|
|
|
|
NumBonded int64 // number of initially bonded acconts
|
|
|
|
GenTimestamp time.Time // genesis timestamp
|
|
|
|
UnbondTime time.Duration // staking unbond time stored to use it as the slashing maximum evidence duration
|
|
|
|
}
|