relay

Documentation

Overview

The relay package contains the components necessary to implement the "autorelay" feature.

Warning: the internal interfaces are unstable.

System Components:

• A discovery service to discover public relays.
• An AutoNAT client used to determine if the node is behind a NAT/firewall.
• One or more autonat services, instances of `AutoNATServices`. These are used by the autonat client.
• One or more relays, instances of `RelayHost`.
• The AutoRelay service. This is the service that actually:

AutoNATService: https://github.com/libp2p/go-libp2p-autonat-svc AutoNAT: https://github.com/libp2p/go-libp2p-autonat

How it works:

• `AutoNATService` instances are instantiated in the bootstrappers (or other well known publicly reachable hosts)
• `AutoRelay`s are constructed with `libp2p.New(libp2p.Routing(makeDHT))` They passively discover autonat service instances and test dialability of their listen address set through them. When the presence of NAT is detected, they discover relays through the DHT, connect to some of them and begin advertising relay addresses. The new set of addresses is propagated to connected peers through the `identify/push` protocol.

Index

• Constants
• Variables
• func Advertise(ctx context.Context, advertise discovery.Advertiser)
• func Filter(addrs []ma.Multiaddr) []ma.Multiaddr
• type AutoRelay
  • func NewAutoRelay(ctx context.Context, bhost *basic.BasicHost, discover discovery.Discoverer, ...) *AutoRelay
  • func (ar *AutoRelay) ClosedStream(inet.Network, inet.Stream)
  • func (ar *AutoRelay) Connected(inet.Network, inet.Conn)
  • func (ar *AutoRelay) Disconnected(net inet.Network, c inet.Conn)
  • func (ar *AutoRelay) Listen(inet.Network, ma.Multiaddr)
  • func (ar *AutoRelay) ListenClose(inet.Network, ma.Multiaddr)
  • func (ar *AutoRelay) OpenedStream(inet.Network, inet.Stream)

Constants

const (
	RelayRendezvous = "/libp2p/relay"
)

Variables

var (
	DesiredRelays = 3

	BootDelay = 20 * time.Second
)

var (
	AdvertiseBootDelay = 30 * time.Second
)

Functions

func Advertise

func Advertise(ctx context.Context, advertise discovery.Advertiser)

Advertise advertises this node as a libp2p relay.

func Filter

func Filter(addrs []ma.Multiaddr) []ma.Multiaddr

Filter filters out all relay addresses.

Types

type AutoRelay

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

AutoRelay is a Host that uses relays for connectivity when a NAT is detected.

func NewAutoRelay

func NewAutoRelay(ctx context.Context, bhost *basic.BasicHost, discover discovery.Discoverer, router routing.PeerRouting) *AutoRelay

func (*AutoRelay) ClosedStream

func (ar *AutoRelay) ClosedStream(inet.Network, inet.Stream)

func (*AutoRelay) Connected

func (ar *AutoRelay) Connected(inet.Network, inet.Conn)

func (*AutoRelay) Disconnected

func (ar *AutoRelay) Disconnected(net inet.Network, c inet.Conn)

func (*AutoRelay) Listen

func (ar *AutoRelay) Listen(inet.Network, ma.Multiaddr)

func (*AutoRelay) ListenClose

func (ar *AutoRelay) ListenClose(inet.Network, ma.Multiaddr)

func (*AutoRelay) OpenedStream

func (ar *AutoRelay) OpenedStream(inet.Network, inet.Stream)