peerManager

package
v0.57.1 Latest Latest
Warning

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

Go to latest
Published: Nov 13, 2026 License: GPL-3.0 Imports: 32 Imported by: 1

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type BasicPeerManager

type BasicPeerManager struct {
	*basicConnGater.BasicConnectionGater
	*basicConnMgr.BasicConnMgr
	// contains filtered or unexported fields
}

func (*BasicPeerManager) AdjustPeerQuality added in v0.32.0

func (pm *BasicPeerManager) AdjustPeerQuality(peer p2p.PeerID, topic string, adjFn func(int) int)

func (*BasicPeerManager) BanPeer

func (pm *BasicPeerManager) BanPeer(peer p2p.PeerID)

func (*BasicPeerManager) CloseStream

func (pm *BasicPeerManager) CloseStream(peerID p2p.PeerID) error

func (*BasicPeerManager) DialCooldownRemaining added in v0.57.0

func (pm *BasicPeerManager) DialCooldownRemaining(peerID peer.ID) time.Duration

func (*BasicPeerManager) GetHost

func (pm *BasicPeerManager) GetHost() host.Host

func (*BasicPeerManager) GetPeerQuality added in v0.40.1

func (pm *BasicPeerManager) GetPeerQuality(peer p2p.PeerID) int

func (*BasicPeerManager) GetPeers

func (pm *BasicPeerManager) GetPeers(topic *pubsubManager.Topic) map[p2p.PeerID]struct{}

func (*BasicPeerManager) GetPeersExcluding added in v0.57.0

func (pm *BasicPeerManager) GetPeersExcluding(topic *pubsubManager.Topic, excluded map[p2p.PeerID]struct{}) []p2p.PeerID

GetPeersExcluding prefers better quality buckets and removes already-tried peers before the request-degree cap.

func (*BasicPeerManager) GetSelfID

func (pm *BasicPeerManager) GetSelfID() p2p.PeerID

func (*BasicPeerManager) GetStream

func (pm *BasicPeerManager) GetStream(peerID p2p.PeerID) (network.Stream, error)

func (*BasicPeerManager) GetStreamPeers added in v0.40.1

func (pm *BasicPeerManager) GetStreamPeers() []peer.ID

func (*BasicPeerManager) IsProtectedPeer added in v0.53.0

func (pm *BasicPeerManager) IsProtectedPeer(peerID p2p.PeerID) bool

func (*BasicPeerManager) ProtectPeer

func (pm *BasicPeerManager) ProtectPeer(peer p2p.PeerID)

func (*BasicPeerManager) Provide

func (pm *BasicPeerManager) Provide(ctx context.Context, location common.Location, data interface{}) error

func (*BasicPeerManager) RefreshBootpeers added in v0.30.0

func (pm *BasicPeerManager) RefreshBootpeers() []peer.AddrInfo

func (*BasicPeerManager) RemovePeer

func (pm *BasicPeerManager) RemovePeer(peerID p2p.PeerID) error

func (*BasicPeerManager) SetDHT

func (pm *BasicPeerManager) SetDHT(dht *kaddht.IpfsDHT)

func (*BasicPeerManager) SetHost

func (pm *BasicPeerManager) SetHost(host host.Host)

func (*BasicPeerManager) SetP2PBackend

func (pm *BasicPeerManager) SetP2PBackend(p2pnode protocol.QuaiP2PNode)

Set the host for the stream manager

func (*BasicPeerManager) SetSelfID

func (pm *BasicPeerManager) SetSelfID(selfID p2p.PeerID)

func (*BasicPeerManager) SetStreamManager

func (pm *BasicPeerManager) SetStreamManager(streamManager streamManager.StreamManager)

Implementation of underlying StreamManager interface

func (*BasicPeerManager) Stop

func (pm *BasicPeerManager) Stop() error

func (*BasicPeerManager) UnprotectPeer

func (pm *BasicPeerManager) UnprotectPeer(peer p2p.PeerID)

func (*BasicPeerManager) WriteMessageToStream

func (pm *BasicPeerManager) WriteMessageToStream(peerID p2p.PeerID, stream network.Stream, msg []byte, protoversion libp2pprotocol.ID, reporter libp2pmetrics.Reporter) error

type PeerManager

type PeerManager interface {
	connmgr.ConnManager
	connmgr.ConnectionGater
	streamManager.StreamManager

	BlockAddr(ip net.IP) error
	BlockPeer(p peer.ID) error
	BlockSubnet(ipnet *net.IPNet) error
	ListBlockedAddrs() []net.IP
	ListBlockedPeers() []peer.ID
	ListBlockedSubnets() []*net.IPNet
	UnblockAddr(ip net.IP) error
	UnblockPeer(p peer.ID) error
	UnblockSubnet(ipnet *net.IPNet) error

	// Sets the ID for the node running the peer manager
	SetSelfID(p2p.PeerID)
	GetSelfID() p2p.PeerID

	// Sets the DHT provided from the Host interface
	SetDHT(*kaddht.IpfsDHT)

	// Sets the streamManager interface
	SetStreamManager(streamManager.StreamManager)

	// Announces to the DHT that we are providing this data
	Provide(context.Context, common.Location, interface{}) error

	// Removes a peer from all the quality buckets
	RemovePeer(p2p.PeerID) error

	// GetPeers returns peers from the database up to the topic's request degree.
	GetPeers(topic *pubsubManager.Topic) map[p2p.PeerID]struct{}
	GetPeersExcluding(topic *pubsubManager.Topic, excluded map[p2p.PeerID]struct{}) []p2p.PeerID

	// RefreshBootpeers returns all the current bootpeers for bootstrapping
	RefreshBootpeers() []peer.AddrInfo

	// Adjust the quality score of a peer by applying the given adjustment function
	AdjustPeerQuality(p2p.PeerID, string, func(int) int)
	GetPeerQuality(p2p.PeerID) int

	// Protects the peer's connection from being disconnected
	ProtectPeer(p2p.PeerID)
	// Remove protection from the peer's connection
	UnprotectPeer(p2p.PeerID)
	// Reports whether the peer is configured as protected on this node.
	IsProtectedPeer(p2p.PeerID) bool
	// Bans the peer's connection from being re-established
	BanPeer(p2p.PeerID)

	// Stops the peer manager
	Stop() error
}

PeerManager is an interface that extends libp2p Connection Manager and Gater

func NewManager

func NewManager(ctx context.Context, low int, high int, datastore datastore.Datastore) (PeerManager, error)

type PeerQuality

type PeerQuality int
const (
	Best PeerQuality = iota
	Responsive
	LastResort
	All
)

func QualityBucket added in v0.57.0

func QualityBucket(quality, maxQuality int) PeerQuality

QualityBucket uses the same thresholds for live request selection and stored peer categorization. maxQuality is the highest score in the candidate set.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
⌂ 换网址