interfaces

type AppError struct {
	Code    int32
	Message string
}

type AppHandler interface {
	// AppRequest handles an application-level request from a node.
	AppRequest(ctx context.Context, nodeID ids.NodeID, requestID uint32, deadline time.Time, request []byte) error

	// AppRequestFailed handles a failed application-level request.
	AppRequestFailed(ctx context.Context, nodeID ids.NodeID, requestID uint32, appErr *AppError) error

	// AppResponse handles an application-level response from a node.
	AppResponse(ctx context.Context, nodeID ids.NodeID, requestID uint32, response []byte) error

	// AppGossip handles an application-level gossip from a node.
	AppGossip(ctx context.Context, nodeID ids.NodeID, msg []byte) error
}

type AppSender interface {
	// SendAppRequest sends an application-level request to the given nodes.
	SendAppRequest(ctx context.Context, nodeIDs set.Set[ids.NodeID], requestID uint32, appRequestBytes []byte) error

	// SendAppResponse sends an application-level response to the given node.
	SendAppResponse(ctx context.Context, nodeID ids.NodeID, requestID uint32, appResponseBytes []byte) error

	// SendAppError sends an application-level error to the given node.
	SendAppError(ctx context.Context, nodeID ids.NodeID, requestID uint32, errorCode int32, errorMessage string) error

	// SendAppGossip sends an application-level gossip to all connected nodes.
	SendAppGossip(ctx context.Context, nodeIDs set.Set[ids.NodeID], appGossipBytes []byte) error

	// SendAppGossipSpecific sends an application-level gossip to specific nodes.
	SendAppGossipSpecific(ctx context.Context, nodeIDs set.Set[ids.NodeID], appGossipBytes []byte) error
}

type Engine interface {
	// Start starts the engine
	Start(context.Context, uint32) error

	// Stop stops the engine
	Stop(context.Context) error

	// HealthCheck performs health check
	HealthCheck(context.Context) (interface{}, error)

	// IsBootstrapped checks if bootstrapped
	IsBootstrapped() bool
}

type Fx struct {
	ID ids.ID
	Fx FxInterface
}

type FxInterface interface {
	// Initialize initializes the Fx
	Initialize(vm interface{}) error
	// Bootstrapping is called when the chain is bootstrapping
	Bootstrapping() error
	// Bootstrapped is called when the chain is done bootstrapping
	Bootstrapped() error
}

type VM interface {
	// Initialize initializes the VM
	Initialize(context.Context, *VMConfig) error

	// Shutdown shuts down the VM
	Shutdown(context.Context) error

	// Version returns VM version
	Version(context.Context) (string, error)
}

type VMConfig struct {
	ChainID   ids.ID
	NetworkID uint32
	NodeID    ids.NodeID
	PublicKey []byte
}