mode

type Dependencies struct {
	// Ethereum clients
	Client    *ethclient.Client
	RPCClient *ethrpc.Client

	// SendClient/SendRPCClient are used only to broadcast signed
	// transactions. They alias Client/RPCClient unless --send-rpc-url is set.
	SendClient    *ethclient.Client
	SendRPCClient *ethrpc.Client

	// Contract instances
	LoadTesterContract *tester.LoadTester
	LoadTesterAddress  common.Address
	ERC20Contract      *tokens.ERC20
	ERC20Address       common.Address
	ERC721Contract     *tokens.ERC721
	ERC721Address      common.Address

	// SyncTracker aggregates eth_sendRawTransactionSync outcomes when
	// --sync-txs is set. Nil otherwise, which records nothing.
	SyncTracker *SyncTracker

	// Mode-specific data
	RecallTransactions []rpctypes.PolyTransaction
	IndexedActivity    *IndexedActivity

	// Random source for deterministic randomness
	RandSource   *rand.Rand
	RandSourceMu sync.Mutex

	// UniswapV3 configuration (populated when uniswapv3 mode is used)
	UniswapV3Config     *uniswap.UniswapV3Config
	UniswapV3PoolConfig *uniswap.PoolConfig
	UniswapV3Pool       *uniswapv3.IUniswapV3Pool
}

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

type IndexedActivity struct {
	BlockNumbers    []string
	TransactionIDs  []string
	BlockIDs        []string
	Addresses       []string
	ERC20Addresses  []string
	ERC721Addresses []string
	Contracts       []string
	BlockNumber     uint64
	Transactions    []rpctypes.PolyTransaction
}

type Runner interface {
	// Name returns the canonical name of the mode.
	Name() string

	// Aliases returns alternative names/shortcuts for this mode.
	Aliases() []string

	// RequiresContract returns true if this mode needs the LoadTester contract.
	RequiresContract() bool

	// RequiresERC20 returns true if this mode needs an ERC20 contract.
	RequiresERC20() bool

	// RequiresERC721 returns true if this mode needs an ERC721 contract.
	RequiresERC721() bool

	// Init sets up any mode-specific state before execution.
	Init(ctx context.Context, cfg *config.Config, deps *Dependencies) error

	// Execute performs a single load test operation.
	// Returns start time, end time, transaction hash, and any error.
	Execute(ctx context.Context, cfg *config.Config, deps *Dependencies, opts *bind.TransactOpts) (start, end time.Time, txHash common.Hash, err error)
}

type SyncReceipt struct {
	TransactionHash common.Hash     `json:"transactionHash"`
	Status          *hexutil.Uint64 `json:"status"`
	GasUsed         *hexutil.Uint64 `json:"gasUsed"`
	BlockNumber     *hexutil.Big    `json:"blockNumber"`
	BlockHash       *common.Hash    `json:"blockHash"`

	// Preconfirmation is bor's marker for a receipt produced by its
	// preconfirmation pipeline rather than canonical block import. It is not
	// part of EIP-7966, so nodes that do not preconfirm simply omit it.
	Preconfirmation *bool `json:"preconfirmation"`
}

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

type SyncTxResult struct {
	TxHash      string `json:"tx_hash"`
	DurationMs  int64  `json:"duration_ms"`
	Speculative bool   `json:"speculative,omitempty"`
	BlockNumber uint64 `json:"block_number,omitempty"`
	GasUsed     uint64 `json:"gas_used,omitempty"`
	Status      uint64 `json:"status,omitempty"`
	ErrorCode   int    `json:"error_code,omitempty"`
	Error       string `json:"error,omitempty"`
}