stack

type Common interface {
	T() devtest.T
	Logger() log.Logger
	Name() string

	// Label retrieves a label by key.
	// If the label does not exist, it returns an empty string.
	Label(key string) string

	// SetLabel sets a label by key.
	// Note that labels added by tests are not visible to other tests against the same backend.
	SetLabel(key, value string)
}

type Conductor interface {
	Common
	ChainID() eth.ChainID

	RpcAPI() conductorRpc.API
}

type ELNode interface {
	Common
	ChainID() eth.ChainID
	EthClient() apis.EthClient
	TransactionTimeout() time.Duration
}

type Faucet interface {
	Common
	ChainID() eth.ChainID
	API() apis.Faucet
}

type InteropTestControl interface {
	// PauseInteropActivity pauses the interop activity at the given timestamp.
	// When the interop activity attempts to process this timestamp, it returns early.
	// This function is for integration test control only.
	PauseInteropActivity(ts uint64)

	// ResumeInteropActivity clears any pause on the interop activity, allowing normal processing.
	// This function is for integration test control only.
	ResumeInteropActivity()
}

type Keys interface {
	Secret(key devkeys.Key) *ecdsa.PrivateKey
	Address(key devkeys.Key) common.Address
}

type L1CLNode interface {
	Common
	ChainID() eth.ChainID

	BeaconClient() apis.BeaconClient
}

type L1ELNode interface {
	ELNode
}

type L1Network interface {
	Network

	L1ELNodes() []L1ELNode
	L1CLNodes() []L1CLNode
}

type L2Batcher interface {
	Common
	ChainID() eth.ChainID
	ActivityAPI() apis.BatcherActivity
}

type L2CLNode interface {
	Common
	ChainID() eth.ChainID

	ClientRPC() client.RPC
	RollupAPI() apis.RollupClient
	P2PAPI() apis.P2PClient
	InteropRPC() (endpoint string, jwtSecret eth.Bytes32)
	UserRPC() string

	// ELs returns the engine(s) that this L2CLNode is connected to.
	// This may be empty, if the L2CL is not connected to any.
	ELs() []L2ELNode
	RollupBoostNodes() []RollupBoostNode
	OPRBuilderNodes() []OPRBuilderNode

	ELClient() apis.EthClient
}

type L2Challenger interface {
	Common
	ChainID() eth.ChainID
	Config() *config.Config
}

type L2Deployment interface {
	SystemConfigProxyAddr() common.Address
	DisputeGameFactoryProxyAddr() common.Address
	L1StandardBridgeProxyAddr() common.Address
}

type L2ELNode interface {
	L2EthClient() apis.L2EthClient
	L2EngineClient() apis.EngineClient

	ELNode
}

type L2Network interface {
	Network
	RollupConfig() *rollup.Config
	Deployment() L2Deployment
	Keys() Keys

	L1() L1Network

	L2Batchers() []L2Batcher
	L2Proposers() []L2Proposer
	L2Challengers() []L2Challenger
	L2CLNodes() []L2CLNode
	L2ELNodes() []L2ELNode
	Conductors() []Conductor
	RollupBoostNodes() []RollupBoostNode
	OPRBuilderNodes() []OPRBuilderNode
}

type L2Proposer interface {
	Common
	ChainID() eth.ChainID
}

type Lifecycle interface {
	Start()
	Stop()
}

type Network interface {
	Common

	ChainID() eth.ChainID

	ChainConfig() *params.ChainConfig

	Faucets() []Faucet

	SyncTesters() []SyncTester
}

type OPRBuilderNode interface {
	L2EthClient() apis.L2EthClient
	L2EngineClient() apis.EngineClient
	FlashblocksClient() *client.WSClient
	UpdateRuleSet(rulesYaml string) error

	ELNode
}

type RollupBoostNode interface {
	L2EthClient() apis.L2EthClient
	L2EngineClient() apis.EngineClient
	FlashblocksClient() *client.WSClient

	ELNode
}

type SuperchainDeployment interface {
	ProtocolVersionsAddr() common.Address
	SuperchainConfigAddr() common.Address
}

type Supernode interface {
	Common
	QueryAPI() apis.SupernodeQueryAPI
}

type Supervisor interface {
	Common

	AdminAPI() apis.SupervisorAdminAPI
	QueryAPI() apis.SupervisorQueryAPI
}

type SyncTester interface {
	Common
	ChainID() eth.ChainID
	API() apis.SyncTester

	APIWithSession(sessionID string) apis.SyncTester
}

type TestSequencer interface {
	Common

	AdminAPI() apis.TestSequencerAdminAPI
	BuildAPI() apis.TestSequencerBuildAPI
	ControlAPI(chainID eth.ChainID) apis.TestSequencerControlAPI
}