Documentation
¶
Index ¶
- Variables
- func DistCmp(target, a, b ID) int
- func LogDist(a, b ID) int
- func SignV4(r *enr.Record, privkey *ecdsa.PrivateKey) error
- type DB
- func (db *DB) Close()
- func (db *DB) DeleteNode(id ID) error
- func (db *DB) FindFails(id ID) int
- func (db *DB) LastPingReceived(id ID) time.Time
- func (db *DB) LastPongReceived(id ID) time.Time
- func (db *DB) Node(id ID) *Node
- func (db *DB) QueryAllSeeds() []*Node
- func (db *DB) QuerySeeds(n int, maxAge time.Duration) []*Node
- func (db *DB) UpdateFindFails(id ID, fails int) error
- func (db *DB) UpdateLastPingReceived(id ID, instance time.Time) error
- func (db *DB) UpdateLastPongReceived(id ID, instance time.Time) error
- func (db *DB) UpdateNode(node *Node) error
- type ID
- type Node
- func (n *Node) ID() ID
- func (n *Node) IP() net.IP
- func (n *Node) Incomplete() bool
- func (n *Node) IsFinderNode() bool
- func (n *Node) Load(k enr.Entry) error
- func (n *Node) MarshalText() ([]byte, error)
- func (n *Node) Pubkey() *ecdsa.PublicKey
- func (n *Node) Seq() uint64
- func (n *Node) String() string
- func (n *Node) TCP() int
- func (n *Node) UDP() int
- func (n *Node) UnmarshalText(text []byte) error
- func (n *Node) ValidateComplete() error
- type NullID
- type Secp256k1
- type V4ID
Constants ¶
This section is empty.
Variables ¶
var ValidSchemes = enr.SchemeMap{ "v4": V4ID{}, }
List of known secure identity schemes.
var ValidSchemesForTesting = enr.SchemeMap{ "v4": V4ID{}, "null": NullID{}, }
Functions ¶
func DistCmp ¶
DistCmp compares the distances a->target and b->target. Returns -1 if a is closer to target, 1 if b is closer to target and 0 if they are equal.
Types ¶
type DB ¶
type DB struct {
// contains filtered or unexported fields
}
DB is the node database, storing previously seen nodes and any collected metadata about them for QoS purposes.
func OpenDB ¶
OpenDB opens a node database for storing and retrieving infos about known peers in the network. If no path is given an in-memory, temporary database is constructed.
func (*DB) DeleteNode ¶
DeleteNode deletes all information/keys associated with a node.
func (*DB) LastPingReceived ¶
LastPingReceived retrieves the time of the last ping packet received from a remote node.
func (*DB) LastPongReceived ¶
LastPongReceived retrieves the time of the last successful pong from remote node.
func (*DB) QueryAllSeeds ¶ added in v1.0.0
QueryAllSeeds retrieves all nodes to be used as potential seed nodes for bootstrapping.
func (*DB) QuerySeeds ¶
QuerySeeds retrieves random nodes to be used as potential seed nodes for bootstrapping.
func (*DB) UpdateFindFails ¶
UpdateFindFails updates the number of findnode failures since bonding.
func (*DB) UpdateLastPingReceived ¶
UpdateLastPingReceived updates the last time we tried contacting a remote node.
func (*DB) UpdateLastPongReceived ¶
UpdateLastPongReceived updates the last pong time of a node.
func (*DB) UpdateNode ¶
UpdateNode inserts - potentially overwriting - a node into the peer database.
type ID ¶
type ID [32]byte
ID is a unique identifier for each node.
func HexID ¶
HexID converts a hex string to an ID. The string may be prefixed with 0x. It panics if the string is not a valid ID.
func PubkeyToIDV4 ¶
PubkeyToIDV4 derives the v4 node address from the given public key.
func (ID) MarshalText ¶
MarshalText implements the encoding.TextMarshaler interface.
func (ID) TerminalString ¶
TerminalString returns a shortened hex string for terminal logging.
func (*ID) UnmarshalText ¶
UnmarshalText implements the encoding.TextUnmarshaler interface.
type Node ¶
type Node struct {
// contains filtered or unexported fields
}
Node represents a host on the network.
func MustParseV4 ¶
MustParseV4 parses a node URL. It panics if the URL is not valid.
func New ¶
New wraps a node record. The record must be valid according to the given identity scheme.
func NewV4 ¶
NewV4 creates a node from discovery v4 node information. The record contained in the node has a zero-length signature.
func ParseV4 ¶
ParseV4 parses a node URL.
There are two basic forms of node URLs:
- incomplete nodes, which only have the public key (node ID)
- complete nodes, which contain the public key and IP/Port information
For incomplete nodes, the designator must look like one of these
fnode://<hex node id> <hex node id>
For complete nodes, the node ID is encoded in the username portion of the URL, separated from the host by an @ sign. The hostname can only be given as an IP address, DNS domain names are not allowed. The port in the host name section is the TCP listening port. If the TCP and UDP (discovery) ports differ, the UDP port is specified as query parameter "discport".
In the following example, the node URL describes a node with IP address 10.3.58.6, TCP listening port 30303 and UDP discovery port 30301.
fnode://<hex node id>@10.3.58.6:30303?discport=30301
func (*Node) Incomplete ¶
Incomplete returns true for nodes with no IP address.
func (*Node) IsFinderNode ¶
IsFinderNode returns true for nodes only support node discover
func (*Node) MarshalText ¶
MarshalText implements encoding.TextMarshaler.
func (*Node) String ¶
The string representation of a Node is a URL. Please see ParseNode for a description of the format.
func (*Node) UnmarshalText ¶
UnmarshalText implements encoding.TextUnmarshaler.
func (*Node) ValidateComplete ¶
checks whether n is a valid complete node.
type NullID ¶
type NullID struct{}
NullID is the "null" ENR identity scheme. This scheme stores the node ID in the record without any signature.
Source Files