addressbook

Documentation

Overview

Package addressbook provides persisted mapping between overlay (topology) address and hop.Address address, which contains underlay (physical) address. The underlay address contains both physical and p2p addresses.

It is single point of truth about known peers and relations of their overlay and underlay addresses.

Index

• Variables
• type GetPutter
• type Getter
• type Interface
  • func New(storer storage.StateStorer) Interface
• type Putter
• type Remover

Variables

var ErrNotFound = errors.New("addressbook: not found")

Types

type GetPutter

type GetPutter interface {
	Getter
	Putter
}

type Getter

type Getter interface {
	// Get returns pointer to saved hop.Address for requested overlay address.
	Get(overlay swarm.Address) (addr *hop.Address, err error)
}

type Interface

type Interface interface {
	GetPutter
	Remover
	// Overlays returns a list of all overlay addresses saved in addressbook.
	Overlays() ([]swarm.Address, error)
	// IterateOverlays exposes overlays in a form of an iterator.
	IterateOverlays(func(swarm.Address) (bool, error)) error
	// Addresses returns a list of all hop.Address-es saved in addressbook.
	Addresses() ([]hop.Address, error)
}

Interface is the AddressBook interface.

func New

func New(storer storage.StateStorer) Interface

New creates new addressbook for state storer.

type Putter

type Putter interface {
	// Put saves relation between peer overlay address and hop.Address address.
	Put(overlay swarm.Address, addr hop.Address) (err error)
}

type Remover

type Remover interface {
	// Remove removes overlay address.
	Remove(overlay swarm.Address) error
}