swarm

Oct 22, 2024

Changes in this version

+ type BlackHoleState int

+ func (st BlackHoleState) String() string

+ type ResolverFromMaDNS struct

+ func (r ResolverFromMaDNS) ResolveDNSAddr(ctx context.Context, expectedPeerID peer.ID, maddr ma.Multiaddr, ...) ([]ma.Multiaddr, error)

+ func (r ResolverFromMaDNS) ResolveDNSComponent(ctx context.Context, maddr ma.Multiaddr, outputLimit int) ([]ma.Multiaddr, error)

Aug 5, 2024

retracted

Changes in this version

+ type BlackHoleSuccessCounter struct

+ MinSuccesses int

+ N int

+ Name string

+ func (b *BlackHoleSuccessCounter) HandleRequest() blackHoleState

+ func (b *BlackHoleSuccessCounter) RecordResult(success bool)

+ func (b *BlackHoleSuccessCounter) State() blackHoleState

type MetricsTracer

+ UpdatedBlackHoleSuccessCounter func(name string, state blackHoleState, nextProbeAfter int, successFraction float64)

type Option

+ func WithIPv6BlackHoleSuccessCounter(f *BlackHoleSuccessCounter) Option

+ func WithReadOnlyBlackHoleDetector() Option

+ func WithUDPBlackHoleSuccessCounter(f *BlackHoleSuccessCounter) Option

+ type OrderedListener interface

+ ListenOrder func() int

type Swarm

+ func (s *Swarm) CanDial(p peer.ID, addr ma.Multiaddr) bool

May 20, 2024

Changes in this version

type Swarm

+ func (s *Swarm) Done() <-chan struct{}

Aug 30, 2023

Changes in this version

+ var ErrQUICDraft29 errQUICDraft29

type TransportError

+ func (e *TransportError) Unwrap() error

Jul 14, 2023 GO-2023-2000

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

Changes in this version

+ var ErrDialRefusedBlackHole = errors.New("dial refused because of black hole")

type MetricsTracer

+ UpdatedBlackHoleFilterState func(name string, state blackHoleState, nextProbeAfter int, successFraction float64)

type Option

+ func WithIPv6BlackHoleConfig(enabled bool, n, min int) Option

+ func WithUDPBlackHoleConfig(enabled bool, n, min int) Option

Jun 20, 2023 GO-2023-2000

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

Jun 12, 2023 GO-2023-2000

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

Changes in this version

+ const PrivateQUICDelay

+ const PrivateTCPDelay

+ const PublicQUICDelay

+ const PublicTCPDelay

+ const RelayDelay

+ func DefaultDialRanker(addrs []ma.Multiaddr) []network.AddrDelay

+ func NoDelayDialRanker(addrs []ma.Multiaddr) []network.AddrDelay

+ type Clock interface

+ InstantTimer func(when time.Time) InstantTimer

+ Now func() time.Time

+ Since func(t time.Time) time.Duration

+ type InstantTimer interface

+ Ch func() <-chan time.Time

+ Reset func(d time.Time) bool

+ Stop func() bool

type MetricsTracer

+ DialCompleted func(success bool, totalDials int)

+ DialRankingDelay func(d time.Duration)

type Option

+ func WithDialRanker(d network.DialRanker) Option

+ type RealClock struct

+ func (RealClock) InstantTimer(when time.Time) InstantTimer

+ func (RealClock) Now() time.Time

+ func (RealClock) Since(t time.Time) time.Duration

+ type RealTimer struct

+ func (t RealTimer) Ch() <-chan time.Time

+ func (t RealTimer) Reset(d time.Time) bool

+ func (t RealTimer) Stop() bool

Jun 19, 2023 GO-2023-2000

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

Jun 12, 2023 GO-2023-2000

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

Jun 2, 2023 GO-2023-2000

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

May 30, 2023 GO-2023-2000

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

May 9, 2023 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

May 5, 2023 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Apr 13, 2023 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Apr 6, 2023 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Changes in this version

type Conn

+ func (c *Conn) IsClosed() bool

Mar 24, 2023 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Mar 17, 2023 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Mar 1, 2023 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Feb 27, 2023

retracted

GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Feb 23, 2023 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Changes in this version

+ type MetricsTracerOption func(*metricsTracerSetting)

+ func WithRegisterer(reg prometheus.Registerer) MetricsTracerOption

Feb 10, 2023 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Feb 9, 2023 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Changes in this version

+ func NewMetricsTracer() *metricsTracer

+ type MetricsTracer interface

+ ClosedConnection func(network.Direction, time.Duration, network.ConnectionState)

+ CompletedHandshake func(time.Duration, network.ConnectionState)

+ FailedDialing func(ma.Multiaddr, error)

+ OpenedConnection func(network.Direction, crypto.PubKey, network.ConnectionState)

type Option

+ func WithMetricsTracer(t MetricsTracer) Option

Dec 31, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Dec 12, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Dec 6, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Changes in this version

type Conn

+ func (c *Conn) ConnState() network.ConnectionState

Sep 23, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Nov 9, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Nov 2, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Sep 23, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Sep 21, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Sep 20, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Changes in this version

type Option

+ func WithMultiaddrResolver(maResolver *madns.Resolver) Option

Aug 19, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Jul 27, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Changes in this version

type Swarm

+ func (s *Swarm) ListenClose(addrs ...ma.Multiaddr)

Jul 5, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Jun 28, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Jun 24, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Jun 2, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

May 25, 2022 GO-2023-2000 +1 more

  GO-2023-2000: Large RSA keys can cause high resource usage in github.com/libp2p/go-libp2p

  GO-2023-2024: Out-of-memory vulnerability in github.com/libp2p/go-libp2p

Changes in this version

+ const ConcurrentFdDials

+ const DefaultPerPeerRateLimit

+ const DialAttempts

+ var BackoffBase = time.Second * 5

+ var BackoffCoef = time.Second

+ var BackoffMax = time.Minute * 5

+ var ErrAddrFiltered = errors.New("address filtered")

+ var ErrAllDialsFailed = errors.New("all dials failed")

+ var ErrConnClosed = errors.New("connection closed")

+ var ErrDialBackoff = errors.New("dial backoff")

+ var ErrDialTimeout = errors.New("dial timed out")

+ var ErrDialToSelf = errors.New("dial to self attempted")

+ var ErrGaterDisallowedConnection = errors.New("gater disallows connection to peer")

+ var ErrNoAddresses = errors.New("no addresses")

+ var ErrNoGoodAddresses = errors.New("no good addresses")

+ var ErrNoTransport = errors.New("no transport for protocol")

+ var ErrSwarmClosed = errors.New("swarm closed")

+ type Conn struct

+ func (c *Conn) Close() error

+ func (c *Conn) GetStreams() []network.Stream

+ func (c *Conn) ID() string

+ func (c *Conn) LocalMultiaddr() ma.Multiaddr

+ func (c *Conn) LocalPeer() peer.ID

+ func (c *Conn) LocalPrivateKey() ic.PrivKey

+ func (c *Conn) NewStream(ctx context.Context) (network.Stream, error)

+ func (c *Conn) RemoteMultiaddr() ma.Multiaddr

+ func (c *Conn) RemotePeer() peer.ID

+ func (c *Conn) RemotePublicKey() ic.PubKey

+ func (c *Conn) Scope() network.ConnScope

+ func (c *Conn) Stat() network.ConnStats

+ func (c *Conn) String() string

+ type DialBackoff struct

+ func (db *DialBackoff) AddBackoff(p peer.ID, addr ma.Multiaddr)

+ func (db *DialBackoff) Backoff(p peer.ID, addr ma.Multiaddr) (backoff bool)

+ func (db *DialBackoff) Clear(p peer.ID)

+ type DialError struct

+ Cause error

+ DialErrors []TransportError

+ Peer peer.ID

+ Skipped int

+ func (e *DialError) Error() string

+ func (e *DialError) Timeout() bool

+ func (e *DialError) Unwrap() error

+ type Option func(*Swarm) error

+ func WithConnectionGater(gater connmgr.ConnectionGater) Option

+ func WithDialTimeout(t time.Duration) Option

+ func WithDialTimeoutLocal(t time.Duration) Option

+ func WithMetrics(reporter metrics.Reporter) Option

+ func WithResourceManager(m network.ResourceManager) Option

+ type Stream struct

+ func (s *Stream) Close() error

+ func (s *Stream) CloseRead() error

+ func (s *Stream) CloseWrite() error

+ func (s *Stream) Conn() network.Conn

+ func (s *Stream) ID() string

+ func (s *Stream) Protocol() protocol.ID

+ func (s *Stream) Read(p []byte) (int, error)

+ func (s *Stream) Reset() error

+ func (s *Stream) Scope() network.StreamScope

+ func (s *Stream) SetDeadline(t time.Time) error

+ func (s *Stream) SetProtocol(p protocol.ID) error

+ func (s *Stream) SetReadDeadline(t time.Time) error

+ func (s *Stream) SetWriteDeadline(t time.Time) error

+ func (s *Stream) Stat() network.Stats

+ func (s *Stream) String() string

+ func (s *Stream) Write(p []byte) (int, error)

+ type Swarm struct

+ func NewSwarm(local peer.ID, peers peerstore.Peerstore, opts ...Option) (*Swarm, error)

+ func (s *Swarm) AddListenAddr(a ma.Multiaddr) error

+ func (s *Swarm) AddTransport(t transport.Transport) error

+ func (s *Swarm) Backoff() *DialBackoff

+ func (s *Swarm) Close() error

+ func (s *Swarm) ClosePeer(p peer.ID) error

+ func (s *Swarm) Connectedness(p peer.ID) network.Connectedness

+ func (s *Swarm) Conns() []network.Conn

+ func (s *Swarm) ConnsToPeer(p peer.ID) []network.Conn

+ func (s *Swarm) DialPeer(ctx context.Context, p peer.ID) (network.Conn, error)

+ func (s *Swarm) InterfaceListenAddresses() ([]ma.Multiaddr, error)

+ func (s *Swarm) Listen(addrs ...ma.Multiaddr) error

+ func (s *Swarm) ListenAddresses() []ma.Multiaddr

+ func (s *Swarm) LocalPeer() peer.ID

+ func (s *Swarm) NewStream(ctx context.Context, p peer.ID) (network.Stream, error)

+ func (s *Swarm) Notify(f network.Notifiee)

+ func (s *Swarm) Peers() []peer.ID

+ func (s *Swarm) Peerstore() peerstore.Peerstore

+ func (s *Swarm) ResourceManager() network.ResourceManager

+ func (s *Swarm) SetStreamHandler(handler network.StreamHandler)

+ func (s *Swarm) StopNotify(f network.Notifiee)

+ func (s *Swarm) StreamHandler() network.StreamHandler

+ func (s *Swarm) String() string

+ func (s *Swarm) TransportForDialing(a ma.Multiaddr) transport.Transport

+ func (s *Swarm) TransportForListening(a ma.Multiaddr) transport.Transport

+ type TransportError struct

+ Address ma.Multiaddr

+ Cause error

+ func (e *TransportError) Error() string