p2p

package
v1.18.0-rc5 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 23, 2023 License: BSD-3-Clause Imports: 11 Imported by: 28

Documentation

Overview

Package p2p provides the peer-to-peer abstractions used across different protocols in Bee.

Index

Constants

View Source 
const (
	ReachabilityStatusUnknown = ReachabilityStatus(network.ReachabilityUnknown)
	ReachabilityStatusPublic  = ReachabilityStatus(network.ReachabilityPublic)
	ReachabilityStatusPrivate = ReachabilityStatus(network.ReachabilityPrivate)
)
View Source 
const (
	DefaultBlocklistTime = 1 * time.Minute
)
View Source 
const (
	HeaderNameTracingSpanContext = "tracing-span-context"
)

Common header names.

Variables

View Source 
var (
	// ErrPeerNotFound should be returned by p2p service methods when the requested
	// peer is not found.
	ErrPeerNotFound = errors.New("peer not found")
	// ErrAlreadyConnected is returned if connect was called for already connected node.
	ErrAlreadyConnected = errors.New("already connected")
	// ErrDialLightNode is returned if connect was attempted to a light node.
	ErrDialLightNode = errors.New("target peer is a light node")
	// ErrPeerBlocklisted is returned if peer is on blocklist
	ErrPeerBlocklisted = errors.New("peer blocklisted")
)
View Source 
var ErrNetworkUnavailable = errors.New("network unavailable")
View Source 
var ErrUnexpected = errors.New("unexpected request while in light mode")

Functions

func Discover 

func Discover(ctx context.Context, addr ma.Multiaddr, f func(ma.Multiaddr) (bool, error)) (bool, error)

func NewBlockPeerError added in v0.3.0 

func NewBlockPeerError(duration time.Duration, err error) error

NewBlockPeerError wraps error and creates a special error that is treated specially by p2p. It causes peer to be disconnected and blocks any new connection for this peer for the provided duration.

func NewChunkDeliveryError added in v1.17.4 

func NewChunkDeliveryError(msg string) error

NewChunkDeliveryError is a convenience constructor for ChunkDeliveryError.

func NewConnectionBackoffError 

func NewConnectionBackoffError(err error, tryAfter time.Time) error

NewConnectionBackoffError creates new `ConnectionBackoffError` with provided underlying error and `tryAfter` timestamp.

func NewDisconnectError 

func NewDisconnectError(err error) error

NewDisconnectError wraps error and creates a special error that is treated specially by p2p. It causes peer to disconnect.

func NewSwarmStreamName 

func NewSwarmStreamName(protocol, version, stream string) string

NewSwarmStreamName constructs a libp2p compatible stream name out of protocol name and version and stream name.

func WithBlocklistStreams added in v0.6.0 

func WithBlocklistStreams(dur time.Duration, spec ProtocolSpec)

WithBlocklistStreams will mutate the given spec and replace the handler with a always erroring one.

func WithDisconnectStreams added in v0.6.0 

func WithDisconnectStreams(spec ProtocolSpec)

WithDisconnectStreams will mutate the given spec and replace the handler with a always erroring one.

Types

type BlockListedPeer added in v1.15.0 

type BlockListedPeer struct {
	Peer
	Reason   string
	Duration time.Duration
}

BlockListedPeer holds information about a Peer that is blocked.

type BlockPeerError added in v0.3.0 

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

func (*BlockPeerError) Duration added in v0.3.0 

func (e *BlockPeerError) Duration() time.Duration

Duration represents the period for which the peer will be blocked. 0 duration is treated as infinity

func (*BlockPeerError) Error added in v0.3.0 

func (e *BlockPeerError) Error() string

Error implements function of the standard go error interface.

func (*BlockPeerError) Unwrap added in v0.3.0 

func (e *BlockPeerError) Unwrap() error

Unwrap returns an underlying error.

type Blocklister added in v1.2.0 

type Blocklister interface {
	NetworkStatuser

	// Blocklist will disconnect a peer and put it on a blocklist (blocking in & out connections) for provided duration
	// Duration 0 is treated as an infinite duration.
	Blocklist(overlay swarm.Address, duration time.Duration, reason string) error
}

type ChunkDeliveryError added in v1.17.4 

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

func (*ChunkDeliveryError) Error added in v1.17.4 

func (e *ChunkDeliveryError) Error() string

Error implements the error interface.

type ConnectionBackoffError 

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

ConnectionBackoffError indicates that connection calls will not be executed until `tryAfter` timetamp. The reason is provided in the wrappped error.

func (*ConnectionBackoffError) Error 

func (e *ConnectionBackoffError) Error() string

Error implements function of the standard go error interface.

func (*ConnectionBackoffError) TryAfter 

func (e *ConnectionBackoffError) TryAfter() time.Time

TryAfter returns a tryAfter timetamp.

func (*ConnectionBackoffError) Unwrap 

func (e *ConnectionBackoffError) Unwrap() error

Unwrap returns an underlying error.

type DebugService added in v0.2.0 

type DebugService interface {
	Service
	SetWelcomeMessage(val string) error
	GetWelcomeMessage() string
}

DebugService extends the Service with method used for debugging.

type DisconnectError 

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

DisconnectError is an error that is specifically handled inside p2p. If returned by specific protocol handler it causes peer disconnect.

func (*DisconnectError) Error 

func (e *DisconnectError) Error() string

Error implements function of the standard go error interface.

func (*DisconnectError) Unwrap 

func (e *DisconnectError) Unwrap() error

Unwrap returns an underlying error.

type Disconnecter added in v0.4.0 

type Disconnecter interface {
	Disconnect(overlay swarm.Address, reason string) error
	Blocklister
}

type Halter added in v0.6.2 

type Halter interface {
	// Halt new incoming connections while shutting down
	Halt()
}

type HandlerFunc 

type HandlerFunc func(context.Context, Peer, Stream) error

HandlerFunc handles a received Stream from a Peer.

type HandlerMiddleware 

type HandlerMiddleware func(HandlerFunc) HandlerFunc

HandlerMiddleware decorates a HandlerFunc by returning a new one.

type Headers 

type Headers map[string][]byte

Headers represents a collection of p2p header key value pairs.

type HeadlerFunc 

type HeadlerFunc func(Headers, swarm.Address) Headers

HeadlerFunc is returning response headers based on the received request headers.

type IncompatibleStreamError 

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

IncompatibleStreamError is the error that should be returned by p2p service NewStream method when the stream or its version is not supported.

func NewIncompatibleStreamError 

func NewIncompatibleStreamError(err error) *IncompatibleStreamError

NewIncompatibleStreamError wraps the error that is the cause of stream incompatibility with IncompatibleStreamError that it can be detected and returns it.

func (*IncompatibleStreamError) Error 

func (e *IncompatibleStreamError) Error() string

Error implements function of the standard go error interface.

func (*IncompatibleStreamError) Unwrap 

func (e *IncompatibleStreamError) Unwrap() error

Unwrap returns an underlying error.

type NetworkStatus added in v1.6.0 

type NetworkStatus int

NetworkStatus represents the network availability status. 

const (
	NetworkStatusUnknown     NetworkStatus = 0
	NetworkStatusAvailable   NetworkStatus = 1
	NetworkStatusUnavailable NetworkStatus = 2
)

func (NetworkStatus) String added in v1.6.0 

func (ns NetworkStatus) String() string

String implements the fmt.Stringer interface.

type NetworkStatuser added in v1.6.0 

type NetworkStatuser interface {
	// NetworkStatus returns current network availability status.
	NetworkStatus() NetworkStatus
}

NetworkStatuser handles bookkeeping of the network availability status.

type Notifier added in v0.3.0 

type Notifier interface {
	Connected(context.Context, Peer, bool) error
	Disconnected(Peer)
	Announce(ctx context.Context, peer swarm.Address, fullnode bool) error
	AnnounceTo(ctx context.Context, addressee, peer swarm.Address, fullnode bool) error
}

type Peer 

type Peer struct {
	Address         swarm.Address
	FullNode        bool
	EthereumAddress []byte
}

Peer holds information about a Peer.

type Picker added in v1.2.0 

type Picker interface {
	Pick(Peer) bool
}

type PickyNotifier added in v0.5.3 

type PickyNotifier interface {
	Picker
	Notifier
	ReachabilityUpdater
	ReachableNotifier
}

PickyNotifier can decide whether a peer should be picked

type Pinger added in v1.1.0 

type Pinger interface {
	Ping(ctx context.Context, addr ma.Multiaddr) (rtt time.Duration, err error)
}

Pinger interface is used to ping a underlay address which is not yet known to the bee node. It uses libp2p's default ping protocol. This is different from the PingPong protocol as this is meant to be used before we know a particular underlay and we can consider it useful

type ProtocolSpec 

type ProtocolSpec struct {
	Name          string
	Version       string
	StreamSpecs   []StreamSpec
	ConnectIn     func(context.Context, Peer) error
	ConnectOut    func(context.Context, Peer) error
	DisconnectIn  func(Peer) error
	DisconnectOut func(Peer) error
}

ProtocolSpec defines a collection of Stream specifications with handlers.

type ReachabilityStatus added in v1.4.0 

type ReachabilityStatus network.Reachability

ReachabilityStatus represents the node reachability status.

func (ReachabilityStatus) String added in v1.4.0 

func (rs ReachabilityStatus) String() string

String implements the fmt.Stringer interface.

type ReachabilityUpdater added in v1.4.0 

type ReachabilityUpdater interface {
	UpdateReachability(ReachabilityStatus)
}

type ReachableNotifier added in v1.4.0 

type ReachableNotifier interface {
	Reachable(swarm.Address, ReachabilityStatus)
}

type Reacher added in v1.4.0 

type Reacher interface {
	Connected(swarm.Address, ma.Multiaddr)
	Disconnected(swarm.Address)
	Close() error
}

type Service 

type Service interface {
	AddProtocol(ProtocolSpec) error
	// Connect to a peer but do not notify topology about the established connection.
	Connect(ctx context.Context, addr ma.Multiaddr) (address *bzz.Address, err error)
	Disconnecter
	Peers() []Peer
	Blocklisted(swarm.Address) (bool, error)
	BlocklistedPeers() ([]BlockListedPeer, error)
	Addresses() ([]ma.Multiaddr, error)
	SetPickyNotifier(PickyNotifier)
	Halter
	NetworkStatuser
}

Service provides methods to handle p2p Peers and Protocols.

type Stream 

type Stream interface {
	io.ReadWriter
	io.Closer
	ResponseHeaders() Headers
	Headers() Headers
	FullClose() error
	Reset() error
}

Stream represent a bidirectional data Stream.

type StreamSpec 

type StreamSpec struct {
	Name    string
	Handler HandlerFunc
	Headler HeadlerFunc
}

StreamSpec defines a Stream handling within the protocol.

type Streamer 

type Streamer interface {
	NewStream(ctx context.Context, address swarm.Address, h Headers, protocol, version, stream string) (Stream, error)
}

Streamer is able to create a new Stream.

type StreamerDisconnecter added in v0.4.0 

type StreamerDisconnecter interface {
	Streamer
	Disconnecter
}

type StreamerPinger added in v1.1.0 

type StreamerPinger interface {
	Streamer
	Pinger
}

Source Files

View all Source files

Directories

Path Synopsis
internal/blocklist
internal/breaker
internal/handshake
internal/handshake/mock
internal/handshake/pb
Package pb holds only Protocol Buffer definitions and generated code.
 Package pb holds only Protocol Buffer definitions and generated code.
internal/headers/pb
Package pb holds only Protocol Buffer definitions and generated code.
 Package pb holds only Protocol Buffer definitions and generated code.
internal/reacher
Package reacher runs a background worker that will ping peers from an internal queue and report back the reachability to the notifier.
 Package reacher runs a background worker that will ping peers from an internal queue and report back the reachability to the notifier.
internal/pb
Package pb holds only Protocol Buffer definitions and generated code for testing purposes.
 Package pb holds only Protocol Buffer definitions and generated code for testing purposes.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.