pex

type AddrBook interface {
	help.Service

	// Add our own addresses so we don't later add ourselves
	AddOurAddress(*tp2p.NetAddress)
	// Check if it is our address
	OurAddress(*tp2p.NetAddress) bool

	AddPrivateIDs([]string)

	// Add and remove an address
	AddAddress(addr *tp2p.NetAddress, src *tp2p.NetAddress) error
	RemoveAddress(*tp2p.NetAddress)

	// Check if the address is in the book
	HasAddress(*tp2p.NetAddress) bool

	// Do we need more peers?
	NeedMoreAddrs() bool
	// Is Address Book Empty? Answer should not depend on being in your own
	// address book, or private peers
	Empty() bool

	// Pick an address to dial
	PickAddress(biasTowardsNewAddrs int) *tp2p.NetAddress

	// Mark address
	MarkGood(*tp2p.NetAddress)
	MarkAttempt(*tp2p.NetAddress)
	MarkBad(*tp2p.NetAddress)

	IsGood(*tp2p.NetAddress) bool

	// Send a selection of addresses to peers
	GetSelection() []*tp2p.NetAddress
	// Send a selection of addresses with bias
	GetSelectionWithBias(biasTowardsNewAddrs int) []*tp2p.NetAddress

	// TODO: remove
	ListOfKnownAddresses() []*knownAddress

	// Persist to disk
	Save()
}

type ErrAddrBookNilAddr struct {
	Addr *tp2p.NetAddress
	Src  *tp2p.NetAddress
}

type ErrAddrBookNonRoutable struct {
	Addr *tp2p.NetAddress
}

type ErrAddrBookPrivate struct {
	Addr *tp2p.NetAddress
}

type ErrAddrBookPrivateSrc struct {
	Src *tp2p.NetAddress
}

type ErrAddrBookSelf struct {
	Addr *tp2p.NetAddress
}