discover

Documentation

Overview

Package discover implements the Node Discovery Protocol.

The Node Discovery protocol provides a way to find RLPx nodes that can be connected to. It uses a Kademlia-like protocol to maintain a distributed database of the IDs and endpoints of all listening nodes.

Index

• type Config
• type ReadPacket
• type Table
  • func ListenUDP(c conn, ln *enode.LocalNode, cfg Config) (*Table, error)
  • func (tab *Table) Close()
  • func (tab *Table) Info() *TableInfo
  • func (tab *Table) LookupRandom() []*enode.Node
  • func (tab *Table) ReadRandomNodes(buf []*enode.Node) (n int)
  • func (tab *Table) Resolve(n *enode.Node) *enode.Node
• type TableInfo

Types

type Config

type Config struct {
	// These settings are required and configure the UDP listener:
	PingIPFromPacket bool
	PrivateKey       *ecdsa.PrivateKey

	// These settings are optional:
	NetRestrict *netutil.Netlist  // network whitelist
	Bootnodes   []*enode.Node     // list of bootstrap nodes
	Unhandled   chan<- ReadPacket // unhandled packets are sent on this channel
}

Config holds Table-related settings.

type ReadPacket

type ReadPacket struct {
	Data []byte
	Addr *net.UDPAddr
}

ReadPacket is sent to the unhandled channel when it could not be processed

type Table

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

func ListenUDP

func ListenUDP(c conn, ln *enode.LocalNode, cfg Config) (*Table, error)

ListenUDP returns a new table that listens for UDP packets on laddr.

func (*Table) Close

func (tab *Table) Close()

Close terminates the network listener and flushes the node database.

func (*Table) Info

func (tab *Table) Info() *TableInfo

Info gives information on all the buckets and IPs in the Table

func (*Table) LookupRandom

func (tab *Table) LookupRandom() []*enode.Node

LookupRandom finds random nodes in the network.

func (*Table) ReadRandomNodes

func (tab *Table) ReadRandomNodes(buf []*enode.Node) (n int)

ReadRandomNodes fills the given slice with random nodes from the table. The results are guaranteed to be unique for a single invocation, no node will appear twice.

func (*Table) Resolve

func (tab *Table) Resolve(n *enode.Node) *enode.Node

Resolve searches for a specific node with the given ID. It returns nil if the node could not be found.

type TableInfo

type TableInfo struct {
	Buckets [nBuckets]*bucketInfo `json:"buckets"`
	IPs     string                `json:"ips"`
}

TableInfo provides information on the discovery table