updated core enums in state changes.

cmd/node/CLI.md

@@ -73,6 +73,7 @@ GLOBAL OPTIONS:
    --operation-mode operation mode           String flag for specifying the desired operation mode(s) of the node, resulting in altering some configuration values accordingly. Possible values are: snapshotless-observer, full-archive, db-lookup-extension, historical-balances or `""` (empty). Multiple values can be separated via ,
    --repopulate-tokens-supplies              Boolean flag for repopulating the tokens supplies database. It will delete the current data, iterate over the entire trie and add he new obtained supplies
    --p2p-prometheus-metrics                  Boolean option for enabling the /debug/metrics/prometheus route for p2p prometheus metrics
+   --state-changes-types-to-collect value    String slice option for enabling collecting specified state changes types. Can be (READ, WRITE)
    --help, -h                                show help
    --version, -v                             print the version
 

cmd/node/config/config.toml

@@ -662,7 +662,8 @@
     MaxStateTrieLevelInMemory = 5
     MaxPeerTrieLevelInMemory = 5
     StateStatisticsEnabled = false
-    CollectStateChangesEnabled = false
+    StateChangesDataAnalysis = false
+    StateChangesTypesToCollect = []
 
 [BlockSizeThrottleConfig]
     MinSizeInBytes = 104857 # 104857 is 10% from 1MB

cmd/node/flags.go

@@ -6,12 +6,13 @@ import (
 	"os"
 	"runtime"
 
+	logger "github.com/multiversx/mx-chain-logger-go"
+	"github.com/urfave/cli"
+
 	"github.com/multiversx/mx-chain-go/common"
 	"github.com/multiversx/mx-chain-go/common/operationmodes"
 	"github.com/multiversx/mx-chain-go/config"
 	"github.com/multiversx/mx-chain-go/facade"
-	logger "github.com/multiversx/mx-chain-logger-go"
-	"github.com/urfave/cli"
 )
 
 var (
@@ -408,6 +409,13 @@ var (
 		Name:  "p2p-prometheus-metrics",
 		Usage: "Boolean option for enabling the /debug/metrics/prometheus route for p2p prometheus metrics",
 	}
+
+	// stateChangesTypesToCollect defines a flag for collecting specified types of state changes
+	// If enabled, it will override the configuration
+	stateChangesTypesToCollect = cli.StringSliceFlag{
+		Name:  "state-changes-types-to-collect",
+		Usage: "String slice option for enabling collecting specified state changes types. Can be (READ, WRITE)",
+	}
 )
 
 func getFlags() []cli.Flag {
@@ -470,6 +478,7 @@ func getFlags() []cli.Flag {
 		operationMode,
 		repopulateTokensSupplies,
 		p2pPrometheusMetrics,
+		stateChangesTypesToCollect,
 	}
 }
 

cmd/node/main.go

@@ -9,14 +9,15 @@ import (
 	"github.com/klauspost/cpuid/v2"
 	"github.com/multiversx/mx-chain-core-go/core"
 	"github.com/multiversx/mx-chain-core-go/core/check"
+	logger "github.com/multiversx/mx-chain-logger-go"
+	"github.com/multiversx/mx-chain-logger-go/file"
+	"github.com/urfave/cli"
+
 	"github.com/multiversx/mx-chain-go/cmd/node/factory"
 	"github.com/multiversx/mx-chain-go/common"
 	"github.com/multiversx/mx-chain-go/config"
 	"github.com/multiversx/mx-chain-go/config/overridableConfig"
 	"github.com/multiversx/mx-chain-go/node"
-	logger "github.com/multiversx/mx-chain-logger-go"
-	"github.com/multiversx/mx-chain-logger-go/file"
-	"github.com/urfave/cli"
 	// test point 1 for custom profiler
 )
 
@@ -253,6 +254,9 @@ func readConfigs(ctx *cli.Context, log logger.Logger) (*config.Configs, error) {
 	if ctx.IsSet(identityFlagName.Name) {
 		preferencesConfig.Preferences.Identity = ctx.GlobalString(identityFlagName.Name)
 	}
+	if ctx.IsSet(stateChangesTypesToCollect.Name) {
+		generalConfig.StateTriesConfig.StateChangesTypesToCollect = ctx.GlobalStringSlice(stateChangesTypesToCollect.Name)
+	}
 
 	return &config.Configs{
 		GeneralConfig:            generalConfig,

config/config.go

@@ -308,14 +308,14 @@ type FacadeConfig struct {
 
 // StateTriesConfig will hold information about state tries
 type StateTriesConfig struct {
-	SnapshotsEnabled                   bool
-	AccountsStatePruningEnabled        bool
-	PeerStatePruningEnabled            bool
-	CollectStateChangesEnabled         bool
-	CollectStateChangesWithReadEnabled bool
-	MaxStateTrieLevelInMemory          uint
-	MaxPeerTrieLevelInMemory           uint
-	StateStatisticsEnabled             bool
+	SnapshotsEnabled            bool
+	AccountsStatePruningEnabled bool
+	PeerStatePruningEnabled     bool
+	StateChangesDataAnalysis    bool
+	StateChangesTypesToCollect  []string
+	MaxStateTrieLevelInMemory   uint
+	MaxPeerTrieLevelInMemory    uint
+	StateStatisticsEnabled      bool
 }
 
 // TrieStorageManagerConfig will hold config information about trie storage manager

epochStart/metachain/baseRewards_test.go

@@ -15,12 +15,15 @@ import (
 	"github.com/multiversx/mx-chain-core-go/data/rewardTx"
 	"github.com/multiversx/mx-chain-core-go/hashing/sha256"
 	"github.com/multiversx/mx-chain-core-go/marshal"
+	vmcommon "github.com/multiversx/mx-chain-vm-common-go"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+
 	"github.com/multiversx/mx-chain-go/epochStart"
 	"github.com/multiversx/mx-chain-go/epochStart/mock"
 	"github.com/multiversx/mx-chain-go/process"
 	"github.com/multiversx/mx-chain-go/sharding"
 	"github.com/multiversx/mx-chain-go/state/factory"
-	"github.com/multiversx/mx-chain-go/state/stateChanges"
 	"github.com/multiversx/mx-chain-go/testscommon"
 	txExecOrderStub "github.com/multiversx/mx-chain-go/testscommon/common"
 	dataRetrieverMock "github.com/multiversx/mx-chain-go/testscommon/dataRetriever"
@@ -30,9 +33,6 @@ import (
 	stateMock "github.com/multiversx/mx-chain-go/testscommon/state"
 	"github.com/multiversx/mx-chain-go/testscommon/storage"
 	"github.com/multiversx/mx-chain-go/trie"
-	vmcommon "github.com/multiversx/mx-chain-vm-common-go"
-	"github.com/stretchr/testify/assert"
-	"github.com/stretchr/testify/require"
 )
 
 func TestBaseRewardsCreator_NilShardCoordinator(t *testing.T) {
@@ -1181,7 +1181,7 @@ func getBaseRewardsArguments() BaseRewardsCreatorArgs {
 		Hasher:                hasher,
 		Marshaller:            marshalizer,
 		EnableEpochsHandler:   &enableEpochsHandlerMock.EnableEpochsHandlerStub{},
-		StateChangesCollector: stateChanges.NewStateChangesCollector(),
+		StateChangesCollector: &stateMock.StateChangesCollectorStub{},
 	}
 	accCreator, _ := factory.NewAccountCreator(argsAccCreator)
 	enableEpochsHandler := &enableEpochsHandlerMock.EnableEpochsHandlerStub{}

factory/processing/blockProcessorCreator_test.go

@@ -8,6 +8,9 @@ import (
 	"github.com/multiversx/mx-chain-core-go/core"
 	"github.com/multiversx/mx-chain-core-go/hashing"
 	"github.com/multiversx/mx-chain-core-go/marshal"
+	vmcommon "github.com/multiversx/mx-chain-vm-common-go"
+	"github.com/stretchr/testify/require"
+
 	"github.com/multiversx/mx-chain-go/common"
 	"github.com/multiversx/mx-chain-go/dataRetriever"
 	dataComp "github.com/multiversx/mx-chain-go/factory/data"
@@ -17,7 +20,6 @@ import (
 	"github.com/multiversx/mx-chain-go/state/accounts"
 	disabledState "github.com/multiversx/mx-chain-go/state/disabled"
 	factoryState "github.com/multiversx/mx-chain-go/state/factory"
-	"github.com/multiversx/mx-chain-go/state/stateChanges"
 	"github.com/multiversx/mx-chain-go/state/storagePruningManager/disabled"
 	"github.com/multiversx/mx-chain-go/testscommon"
 	componentsMock "github.com/multiversx/mx-chain-go/testscommon/components"
@@ -27,8 +29,6 @@ import (
 	storageManager "github.com/multiversx/mx-chain-go/testscommon/storage"
 	trieMock "github.com/multiversx/mx-chain-go/testscommon/trie"
 	"github.com/multiversx/mx-chain-go/trie"
-	vmcommon "github.com/multiversx/mx-chain-vm-common-go"
-	"github.com/stretchr/testify/require"
 )
 
 func Test_newBlockProcessorCreatorForShard(t *testing.T) {
@@ -107,7 +107,7 @@ func Test_newBlockProcessorCreatorForMeta(t *testing.T) {
 		Hasher:                coreComponents.Hasher(),
 		Marshaller:            coreComponents.InternalMarshalizer(),
 		EnableEpochsHandler:   coreComponents.EnableEpochsHandler(),
-		StateChangesCollector: stateChanges.NewStateChangesCollector(),
+		StateChangesCollector: &stateMock.StateChangesCollectorStub{},
 	}
 	accCreator, _ := factoryState.NewAccountCreator(argsAccCreator)
 

factory/state/stateComponents.go

@@ -2,9 +2,12 @@ package state
 
 import (
 	"fmt"
+	"strings"
 
 	"github.com/multiversx/mx-chain-core-go/core/check"
 	chainData "github.com/multiversx/mx-chain-core-go/data"
+	data "github.com/multiversx/mx-chain-core-go/data/stateChange"
+
 	"github.com/multiversx/mx-chain-go/common"
 	"github.com/multiversx/mx-chain-go/config"
 	"github.com/multiversx/mx-chain-go/dataRetriever"
@@ -122,34 +125,48 @@ func (scf *stateComponentsFactory) Create() (*stateComponents, error) {
 }
 
 func (scf *stateComponentsFactory) createStateChangesCollector() (state.StateChangesCollector, error) {
-	if !scf.config.StateTriesConfig.CollectStateChangesEnabled {
+	if len(scf.config.StateTriesConfig.StateChangesTypesToCollect) == 0 {
 		return disabled.NewDisabledStateChangesCollector(), nil
 	}
 
-	if !scf.config.StateTriesConfig.CollectStateChangesWithReadEnabled {
-		return stateChanges.NewStateChangesCollector(), nil
+	collectRead, collectWrite, err := parseStateChangesTypesToCollect(scf.config.StateTriesConfig.StateChangesTypesToCollect)
+	if err != nil {
+		return nil, fmt.Errorf("failed to parse state changes types to collect: %w", err)
 	}
 
-	// TODO: move to toml config file
-	dbConfig := config.DBConfig{
-		FilePath:          "stateChanges",
-		Type:              "LvlDBSerial",
-		BatchDelaySeconds: 2,
-		MaxBatchSize:      100,
-		MaxOpenFiles:      10,
-	}
+	var opts []stateChanges.CollectorOption
 
-	persisterFactory, err := storageFactory.NewPersisterFactory(dbConfig)
-	if err != nil {
-		return nil, err
+	if collectRead {
+		opts = append(opts, stateChanges.WithCollectRead())
+	}
+	if collectWrite {
+		opts = append(opts, stateChanges.WithCollectRead())
 	}
 
-	db, err := persisterFactory.CreateWithRetries(dbConfig.FilePath)
-	if err != nil {
-		return nil, fmt.Errorf("%w while creating the db for the trie nodes", err)
+	if scf.config.StateTriesConfig.StateChangesDataAnalysis {
+		// TODO: move to toml config file
+		dbConfig := config.DBConfig{
+			FilePath:          "stateChanges",
+			Type:              "LvlDBSerial",
+			BatchDelaySeconds: 2,
+			MaxBatchSize:      100,
+			MaxOpenFiles:      10,
+		}
+
+		persisterFactory, err := storageFactory.NewPersisterFactory(dbConfig)
+		if err != nil {
+			return nil, err
+		}
+
+		db, err := persisterFactory.CreateWithRetries(dbConfig.FilePath)
+		if err != nil {
+			return nil, fmt.Errorf("%w while creating the db for the trie nodes", err)
+		}
+
+		opts = append(opts, stateChanges.WithStorer(db))
 	}
 
-	return stateChanges.NewDataAnalysisStateChangesCollector(db)
+	return stateChanges.NewCollector(opts...), nil
 }
 
 func (scf *stateComponentsFactory) createSnapshotManager(
@@ -375,3 +392,32 @@ func (pc *stateComponents) Close() error {
 	}
 	return nil
 }
+
+func parseStateChangesTypesToCollect(stateChangesTypes []string) (collectRead bool, collectWrite bool, err error) {
+	types := sanitizeActionTypes(data.ActionType_value)
+	for _, stateChangeType := range stateChangesTypes {
+		if value, ok := types[strings.ToLower(stateChangeType)]; ok {
+			switch value {
+			case 0:
+				collectRead = true
+
+			case 1:
+				collectWrite = true
+			}
+		} else {
+			return false, false, fmt.Errorf("unknown action type %s", stateChangeType)
+		}
+	}
+
+	return collectRead, collectWrite, nil
+}
+
+func sanitizeActionTypes(actionTypes map[string]int32) map[string]int32 {
+	sanitizedActionTypes := make(map[string]int32, len(actionTypes))
+
+	for actionType, value := range actionTypes {
+		sanitizedActionTypes[strings.ToLower(actionType)] = value
+	}
+
+	return sanitizedActionTypes
+}

factory/state/stateComponents_test.go

@@ -5,12 +5,13 @@ import (
 
 	"github.com/multiversx/mx-chain-core-go/hashing"
 	"github.com/multiversx/mx-chain-core-go/marshal"
+	"github.com/stretchr/testify/require"
+
 	"github.com/multiversx/mx-chain-go/errors"
 	stateComp "github.com/multiversx/mx-chain-go/factory/state"
 	"github.com/multiversx/mx-chain-go/testscommon"
 	componentsMock "github.com/multiversx/mx-chain-go/testscommon/components"
 	"github.com/multiversx/mx-chain-go/testscommon/factory"
-	"github.com/stretchr/testify/require"
 )
 
 func TestNewStateComponentsFactory(t *testing.T) {

factory/state/stateParser_test.go

@@ -0,0 +1,79 @@
+package state
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestStateComponents_ParseStateChangesTypesToCollect(t *testing.T) {
+	t.Parallel()
+
+	t.Run("should parse state changes: 1 read 1 write", func(t *testing.T) {
+		t.Parallel()
+
+		collectRead, collectWrite, err := parseStateChangesTypesToCollect([]string{"read", "write"})
+		require.NoError(t, err)
+		require.True(t, collectRead)
+		require.True(t, collectWrite)
+	})
+
+	t.Run("should parse state changes: multiple types", func(t *testing.T) {
+		t.Parallel()
+
+		collectRead, collectWrite, err := parseStateChangesTypesToCollect([]string{"read", "read", "write", "write"})
+		require.NoError(t, err)
+		require.True(t, collectRead)
+		require.True(t, collectWrite)
+	})
+
+	t.Run("should parse state changes: inconsistent strings", func(t *testing.T) {
+		collectRead, collectWrite, err := parseStateChangesTypesToCollect([]string{"Read", "read", "Write", "write"})
+		require.NoError(t, err)
+		require.True(t, collectRead)
+		require.True(t, collectWrite)
+
+		collectRead, collectWrite, err = parseStateChangesTypesToCollect([]string{"Read"})
+		require.NoError(t, err)
+		require.True(t, collectRead)
+		require.False(t, collectWrite)
+
+		collectRead, collectWrite, err = parseStateChangesTypesToCollect([]string{"Read", "rEaD"})
+		require.NoError(t, err)
+		require.True(t, collectRead)
+		require.False(t, collectWrite)
+
+		collectRead, collectWrite, err = parseStateChangesTypesToCollect([]string{"Write"})
+		require.NoError(t, err)
+		require.False(t, collectRead)
+		require.True(t, collectWrite)
+
+		collectRead, collectWrite, err = parseStateChangesTypesToCollect([]string{"Write", "write", "wRiTe"})
+		require.NoError(t, err)
+		require.False(t, collectRead)
+		require.True(t, collectWrite)
+	})
+
+	t.Run("should parse state changes: no types", func(t *testing.T) {
+		t.Parallel()
+
+		collectRead, collectWrite, err := parseStateChangesTypesToCollect([]string{})
+		require.NoError(t, err)
+		require.False(t, collectRead)
+		require.False(t, collectWrite)
+
+		collectRead, collectWrite, err = parseStateChangesTypesToCollect(nil)
+		require.NoError(t, err)
+		require.False(t, collectRead)
+		require.False(t, collectWrite)
+	})
+
+	t.Run("should not parse state changes: invalid types", func(t *testing.T) {
+		t.Parallel()
+
+		collectRead, collectWrite, err := parseStateChangesTypesToCollect([]string{"r3ad", "writ3"})
+		require.ErrorContains(t, err, "unknown action type")
+		require.False(t, collectRead)
+		require.False(t, collectWrite)
+	})
+}

factory/status/export_test.go

@@ -2,6 +2,7 @@ package status
 
 import (
 	"github.com/multiversx/mx-chain-core-go/core"
+
 	"github.com/multiversx/mx-chain-go/epochStart"
 	outportDriverFactory "github.com/multiversx/mx-chain-go/outport/factory"
 	"github.com/multiversx/mx-chain-go/p2p"