scenario

type Category struct {
	Name        string
	Description string
	Descriptors []*Descriptor
	Children    []*Category
}

type ConfigValidator struct {
	// contains filtered or unexported fields
}

type Descriptor struct {
	Name           string
	Aliases        []string
	Description    string
	DefaultOptions any
	NewScenario    func(logger logrus.FieldLogger) Scenario
}

type FieldInfo struct {
	Type         reflect.Type
	DefaultValue interface{}
	Description  string
}

type Options struct {
	WalletPool *spamoor.WalletPool
	Config     string
	GlobalCfg  map[string]any
	PluginPath string // Path to plugin resources (empty for native scenarios)
}

type PluginDescriptor struct {
	Name        string
	Description string
	Categories  []*Category
}

type ProcessNextTxParams struct {
	TxIdx           uint64
	OrderedLogCb    func(logFunc func()) // Optional callback to log transaction results in order
	NotifySubmitted func()               // Optional callback to notify that the transaction has been submitted
}

type ReceiptChan chan *types.Receipt

type Registry struct {
	// contains filtered or unexported fields
}

type Scenario interface {
	// Flags registers the scenario's flags with the given flag set.
	Flags(flags *pflag.FlagSet) error
	// Init initializes the scenario with the given options.
	Init(options *Options) error
	// Run runs the scenario.
	Run(ctx context.Context) error
}

type ScenarioEntry struct {
	Descriptor *Descriptor
	Source     ScenarioSource
	Plugin     ScenarioPlugin // nil for native scenarios
}

type ScenarioPlugin interface {
	GetName() string
	GetDescription() string
	AddRunning()
	RemoveRunning()
}

type ScenarioSource int

type TransactionScenarioOptions struct {
	TotalCount                  uint64
	Throughput                  uint64
	MaxPending                  uint64
	ThroughputIncrementInterval uint64
	Timeout                     time.Duration // Maximum duration for scenario execution (0 = no timeout)
	WalletPool                  *spamoor.WalletPool
	NoAwaitTransactions         bool // If true, the scenario will not wait for transactions to be included in a block

	// Logger for scenario execution information
	Logger *logrus.Entry

	// ProcessNextTxFn handles transaction execution with the given index
	// It should return:
	// - A callback function to log transaction results (can be nil)
	// - An error if transaction creation failed
	ProcessNextTxFn func(ctx context.Context, params *ProcessNextTxParams) error
}

type ValidationResult struct {
	Valid    bool
	Errors   []string
	Warnings []string
}