Documentation ¶
Index ¶
- func Filter(addrs []ma.Multiaddr) []ma.Multiaddr
- type AutoRelay
- type AutoRelayHost
- type Option
- func WithBackoff(d time.Duration) Option
- func WithBootDelay(d time.Duration) Option
- func WithCircuitV1Support() Option
- func WithClock(cl clock.Clock) Option
- func WithMaxCandidateAge(d time.Duration) Option
- func WithMaxCandidates(n int) Option
- func WithMinCandidates(n int) Option
- func WithNumRelays(n int) Option
- func WithPeerSource(f func(ctx context.Context, numPeers int) <-chan peer.AddrInfo, ...) Option
- func WithStaticRelays(static []peer.AddrInfo) Option
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type AutoRelayHost ¶
func NewAutoRelayHost ¶
func NewAutoRelayHost(h host.Host, ar *AutoRelay) *AutoRelayHost
func (*AutoRelayHost) Close ¶
func (h *AutoRelayHost) Close() error
type Option ¶
type Option func(*config) error
func WithBackoff ¶ added in v0.19.0
WithBackoff sets the time we wait after failing to obtain a reservation with a candidate.
func WithBootDelay ¶ added in v0.19.0
WithBootDelay set the boot delay for finding relays. We won't attempt any reservation if we've have less than a minimum number of candidates. This prevents us to connect to the "first best" relay, and allows us to carefully select the relay. However, in case we haven't found enough relays after the boot delay, we use what we have.
func WithCircuitV1Support ¶ added in v0.19.0
func WithCircuitV1Support() Option
WithCircuitV1Support enables support for circuit v1 relays.
func WithMaxCandidateAge ¶ added in v0.22.0
WithMaxCandidateAge sets the maximum age of a candidate. When we are connected to the desired number of relays, we don't ask the peer source for new candidates. This can lead to AutoRelay's candidate list becoming outdated, and means we won't be able to quickly establish a new relay connection if our existing connection breaks, if all the candidates have become stale.
func WithMaxCandidates ¶ added in v0.19.0
WithMaxCandidates sets the number of relay candidates that we buffer.
func WithMinCandidates ¶ added in v0.19.0
WithMinCandidates sets the minimum number of relay candidates we collect before to get a reservation with any of them (unless we've been running for longer than the boot delay). This is to make sure that we don't just randomly connect to the first candidate that we discover.
func WithNumRelays ¶ added in v0.19.0
WithNumRelays sets the number of relays we strive to obtain reservations with.
func WithPeerSource ¶ added in v0.19.0
func WithPeerSource(f func(ctx context.Context, numPeers int) <-chan peer.AddrInfo, minInterval time.Duration) Option
WithPeerSource defines a callback for AutoRelay to query for more relay candidates. AutoRelay will call this function when it needs new candidates is connected to the desired number of relays, and it has enough candidates (in case we get disconnected from one of the relays). Implementations must send *at most* numPeers, and close the channel when they don't intend to provide any more peers. AutoRelay will not call the callback again until the channel is closed. Implementations should send new peers, but may send peers they sent before. AutoRelay implements a per-peer backoff (see WithBackoff). minInterval is the minimum interval this callback is called with, even if AutoRelay needs new candidates. The context.Context passed MAY be canceled when AutoRelay feels satisfied, it will be canceled when the node is shutting down. If the channel is canceled you MUST close the output channel at some point.