mirror of
https://github.com/kaspanet/kaspad.git
synced 2025-06-20 04:56:41 +00:00
50 lines
1.4 KiB
Go
50 lines
1.4 KiB
Go
package server
|
|
|
|
import (
|
|
"fmt"
|
|
"net"
|
|
|
|
"github.com/pkg/errors"
|
|
|
|
"github.com/kaspanet/kaspad/netadapter/router"
|
|
)
|
|
|
|
// OnConnectedHandler is a function that is to be called
|
|
// once a new Connection is successfully established.
|
|
type OnConnectedHandler func(connection Connection) error
|
|
|
|
// OnDisconnectedHandler is a function that is to be
|
|
// called once a Connection has been disconnected.
|
|
type OnDisconnectedHandler func() error
|
|
|
|
// OnInvalidMessageHandler is a function that is to be called when
|
|
// an invalid message (cannot be parsed/doesn't have a route)
|
|
// was received from a connection.
|
|
type OnInvalidMessageHandler func(err error)
|
|
|
|
// Server represents a p2p server.
|
|
type Server interface {
|
|
Connect(address string) (Connection, error)
|
|
Start() error
|
|
Stop() error
|
|
SetOnConnectedHandler(onConnectedHandler OnConnectedHandler)
|
|
IsBanned(address *net.TCPAddr) bool
|
|
Ban(address *net.TCPAddr)
|
|
}
|
|
|
|
// Connection represents a p2p server connection.
|
|
type Connection interface {
|
|
fmt.Stringer
|
|
Start(router *router.Router)
|
|
Disconnect() error
|
|
IsConnected() bool
|
|
IsOutbound() bool
|
|
SetOnDisconnectedHandler(onDisconnectedHandler OnDisconnectedHandler)
|
|
SetOnInvalidMessageHandler(onInvalidMessageHandler OnInvalidMessageHandler)
|
|
Address() *net.TCPAddr
|
|
}
|
|
|
|
// ErrNetwork is an error related to the internals of the connection, and not an error that
|
|
// came from outside (e.g. from OnDisconnectedHandler).
|
|
var ErrNetwork = errors.New("network error")
|