client

type ClientType string

type RPCRollbackSpec struct {
	Method    RollbackMethodType
	RPCMethod string // e.g. "debug_setHead", "debug_resetHead"
}

type Registry interface {
	Get(clientType ClientType) (Spec, error)
	Register(spec Spec)
	List() []ClientType
}

type RollbackMethodType string

type Spec interface {
	// Type returns the client type.
	Type() ClientType

	// DefaultImage returns the default Docker image.
	DefaultImage() string

	// DefaultCommand returns the default command arguments.
	DefaultCommand() []string

	// GenesisFlag returns the genesis flag format (e.g., "--genesis-file=").
	// Returns empty string if client doesn't use a genesis flag (e.g., Erigon uses init container).
	GenesisFlag() string

	// RequiresInit returns true if client needs init container.
	RequiresInit() bool

	// InitCommand returns the init container command (if RequiresInit is true).
	InitCommand() []string

	// DataDir returns the data directory path inside container.
	DataDir() string

	// GenesisPath returns the genesis file path inside container.
	GenesisPath() string

	// JWTPath returns the JWT secret file path inside container.
	JWTPath() string

	// RPCPort returns the JSON-RPC port.
	RPCPort() int

	// EnginePort returns the Engine API port.
	EnginePort() int

	// MetricsPort returns the metrics port.
	MetricsPort() int

	// DefaultEnvironment returns default environment variables for the client.
	DefaultEnvironment() map[string]string

	// RPCRollbackSpec returns the client's rollback RPC method and parameter format.
	// Returns nil if the client does not support rollback.
	RPCRollbackSpec() *RPCRollbackSpec
}