networking

package
v0.0.0-...-3f3b006 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 24, 2020 License: BSD-3-Clause Imports: 21 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	// Handshake:
	GetVersion salticidae.Opcode = iota
	Version
	GetPeerList
	PeerList
	// Bootstrapping:
	GetAcceptedFrontier
	AcceptedFrontier
	GetAccepted
	Accepted
	// Consensus:
	Get
	Put
	PushQuery
	PullQuery
	Chits
	// Pinging:
	Ping
	Pong
	// Arbitrary data message:
	Data
	// Throughput test:
	IssueTx
	DecidedTx
)

Public commands that may be sent between stakers

View Source 
const (
	// CurrentVersion this avalanche instance is executing.
	CurrentVersion = "avalanche/0.0.1"
	// MaxClockDifference allowed between connected nodes.
	MaxClockDifference = time.Minute
	// PeerListGossipSpacing is the amount of time to wait between pushing this
	// node's peer list to other nodes.
	PeerListGossipSpacing = time.Minute
	// PeerListGossipSize is the number of peers to gossip each period.
	PeerListGossipSize = 100
	// PeerListStakerGossipFraction calculates the fraction of stakers that are
	// gossiped to. If set to 1, then only stakers will be gossiped to.
	PeerListStakerGossipFraction = 2
	// GetVersionTimeout is the amount of time to wait before sending a
	// getVersion message to a partially connected peer
	GetVersionTimeout = 2 * time.Second
)

Variables

View Source 
var (
	HandshakeNet = Handshake{}
)

Manager is the struct that will be accessed on event calls

View Source 
var (
	Messages = map[salticidae.Opcode][]Field{

		GetVersion:  []Field{},
		Version:     []Field{NetworkID, MyTime, VersionStr},
		GetPeerList: []Field{},
		PeerList:    []Field{Peers},

		GetAcceptedFrontier: []Field{ChainID, RequestID},
		AcceptedFrontier:    []Field{ChainID, RequestID, ContainerIDs},
		GetAccepted:         []Field{ChainID, RequestID, ContainerIDs},
		Accepted:            []Field{ChainID, RequestID, ContainerIDs},

		Get:       []Field{ChainID, RequestID, ContainerID},
		Put:       []Field{ChainID, RequestID, ContainerID, ContainerBytes},
		PushQuery: []Field{ChainID, RequestID, ContainerID, ContainerBytes},
		PullQuery: []Field{ChainID, RequestID, ContainerID},
		Chits:     []Field{ChainID, RequestID, ContainerIDs},

		Ping: []Field{},
		Pong: []Field{},

		Data: []Field{Bytes},

		IssueTx:   []Field{ChainID, Tx},
		DecidedTx: []Field{TxID, Status},
	}
)

Defines the messages that can be sent/received with this network

View Source 
var (
	// VotingNet implements the SenderExternal interface.
	VotingNet = Voting{}
)

Functions

func ToIPDesc 

func ToIPDesc(addr salticidae.NetAddr) (utils.IPDesc, error)

ToIPDesc converts an address to an IP

Types

type AddrCert 

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

AddrCert implements the Connections interface

func (*AddrCert) Add 

func (ac *AddrCert) Add(ip salticidae.NetAddr, id ids.ShortID)

Add Assumes that addr is garbage collected normally

func (*AddrCert) Conns 

func (ac *AddrCert) Conns() ([]utils.IPDesc, []ids.ShortID)

Conns return the set of connections in this connection pool.

func (*AddrCert) ContainsID 

func (ac *AddrCert) ContainsID(id ids.ShortID) bool

ContainsID returns true if the id is contained in the connection pool

func (*AddrCert) ContainsIP 

func (ac *AddrCert) ContainsIP(ip salticidae.NetAddr) bool

ContainsIP returns true if the ip is contained in the connection pool

func (*AddrCert) GetID 

func (ac *AddrCert) GetID(ip salticidae.NetAddr) (ids.ShortID, bool)

GetID returns the id mapped to the ip that is provided if one exists.

func (*AddrCert) GetIP 

func (ac *AddrCert) GetIP(id ids.ShortID) (salticidae.NetAddr, bool)

GetIP returns the ip mapped to the id that is provided if one exists.

func (*AddrCert) IDs 

func (ac *AddrCert) IDs() ids.ShortSet

IDs return the set of IDs that are mapping in this connection pool.

func (*AddrCert) IPs 

func (ac *AddrCert) IPs() []salticidae.NetAddr

IPs returns the full list of ips contained in this connection pool. This can be useful for gossiping a node's connections through the network.

func (*AddrCert) Len 

func (ac *AddrCert) Len() int

Len returns the number of elements in the map

func (*AddrCert) Peers 

func (ac *AddrCert) Peers() []utils.IPDesc

Peers returns the full list of ips contained in this connection pool.

func (*AddrCert) RawConns 

func (ac *AddrCert) RawConns() ([]salticidae.NetAddr, []ids.ShortID)

RawConns return the set of connections in this connection pool.

func (*AddrCert) Remove 

func (ac *AddrCert) Remove(ip salticidae.NetAddr, id ids.ShortID)

Remove ensures that no connection will have any mapping containing [ip] or [id].

func (*AddrCert) RemoveID 

func (ac *AddrCert) RemoveID(id ids.ShortID)

RemoveID ensures that no connection will have a mapping containing [id]

func (*AddrCert) RemoveIP 

func (ac *AddrCert) RemoveIP(ip salticidae.NetAddr)

RemoveIP ensures that no connection will have a mapping containing [ip]

type Builder 

type Builder struct{ Codec }

Builder extends a Codec to build messages safely

func (Builder) Accepted 

func (m Builder) Accepted(chainID ids.ID, requestID uint32, containerIDs ids.Set) (Msg, error)

Accepted message

func (Builder) AcceptedFrontier 

func (m Builder) AcceptedFrontier(chainID ids.ID, requestID uint32, containerIDs ids.Set) (Msg, error)

AcceptedFrontier message

func (Builder) Chits 

func (m Builder) Chits(chainID ids.ID, requestID uint32, containerIDs ids.Set) (Msg, error)

Chits message

func (Builder) Data 

func (m Builder) Data(b []byte) (Msg, error)

Data message

func (Builder) DecidedTx 

func (m Builder) DecidedTx(txID ids.ID, status choices.Status) (Msg, error)

DecidedTx message

func (Builder) Get 

func (m Builder) Get(chainID ids.ID, requestID uint32, containerID ids.ID) (Msg, error)

Get message

func (Builder) GetAccepted 

func (m Builder) GetAccepted(chainID ids.ID, requestID uint32, containerIDs ids.Set) (Msg, error)

GetAccepted message

func (Builder) GetAcceptedFrontier 

func (m Builder) GetAcceptedFrontier(chainID ids.ID, requestID uint32) (Msg, error)

GetAcceptedFrontier message

func (Builder) GetPeerList 

func (m Builder) GetPeerList() (Msg, error)

GetPeerList message

func (Builder) GetVersion 

func (m Builder) GetVersion() (Msg, error)

GetVersion message

func (Builder) IssueTx 

func (m Builder) IssueTx(chainID ids.ID, tx []byte) (Msg, error)

IssueTx message

func (Builder) PeerList 

func (m Builder) PeerList(ipDescs []utils.IPDesc) (Msg, error)

PeerList message

func (Builder) Ping 

func (m Builder) Ping() (Msg, error)

Ping message

func (Builder) Pong 

func (m Builder) Pong() (Msg, error)

Pong message

func (Builder) PullQuery 

func (m Builder) PullQuery(chainID ids.ID, requestID uint32, containerID ids.ID) (Msg, error)

PullQuery message

func (Builder) PushQuery 

func (m Builder) PushQuery(chainID ids.ID, requestID uint32, containerID ids.ID, container []byte) (Msg, error)

PushQuery message

func (Builder) Put 

func (m Builder) Put(chainID ids.ID, requestID uint32, containerID ids.ID, container []byte) (Msg, error)

Put message

func (Builder) Version 

func (m Builder) Version(networkID uint32, myTime uint64, myVersion string) (Msg, error)

Version message

type Codec 

type Codec struct{}

Codec defines the serialization and deserialization of network messages

func (Codec) Pack 

func (Codec) Pack(op salticidae.Opcode, fields map[Field]interface{}) (Msg, error)

Pack attempts to pack a map of fields into a message.

func (Codec) Parse 

func (Codec) Parse(op salticidae.Opcode, ds salticidae.DataStream) (Msg, error)

Parse attempts to convert a byte stream into a message.

type Connections 

type Connections interface {
	Add(salticidae.NetAddr, ids.ShortID)

	GetIP(ids.ShortID) (salticidae.NetAddr, bool)
	GetID(salticidae.NetAddr) (ids.ShortID, bool)

	ContainsIP(salticidae.NetAddr) bool
	ContainsID(ids.ShortID) bool

	Remove(salticidae.NetAddr, ids.ShortID)
	RemoveIP(salticidae.NetAddr)
	RemoveID(ids.ShortID)

	Peers() []utils.IPDesc
	IPs() []salticidae.NetAddr
	IDs() ids.ShortSet
	Conns() ([]utils.IPDesc, []ids.ShortID)
	RawConns() ([]salticidae.NetAddr, []ids.ShortID)

	Len() int
}

Connections provides an interface for what a group of connections will support.

type Field 

type Field uint32

Field that may be packed into a message 

const (
	VersionStr     Field = iota // Used in handshake
	NetworkID                   // Used in handshake
	MyTime                      // Used in handshake
	Peers                       // Used in handshake
	ChainID                     // Used for dispatching
	RequestID                   // Used for all messages
	ContainerID                 // Used for querying
	ContainerBytes              // Used for gossiping
	ContainerIDs                // Used for querying
	Bytes                       // Used as arbitrary data
	TxID                        // Used for throughput tests
	Tx                          // Used for throughput tests
	Status                      // Used for throughput tests
)

Fields that may be packed. These values are not sent over the wire.

func (Field) Packer 

func (f Field) Packer() func(*wrappers.Packer, interface{})

Packer returns the packer function that can be used to pack this field.

func (Field) String 

func (f Field) String() string

func (Field) Unpacker 

func (f Field) Unpacker() func(*wrappers.Packer) interface{}

Unpacker returns the unpacker function that can be used to unpack this field.

type Handshake 

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

Handshake handles the authentication of new peers. Only valid stakers will appear connected.

func (*Handshake) AwaitConnections 

func (nm *Handshake) AwaitConnections(awaiting *networking.AwaitingConnections)

AwaitConnections ...

func (*Handshake) Connections 

func (nm *Handshake) Connections() Connections

Connections returns the object that tracks the nodes that are currently connected to this node.

func (*Handshake) Initialize 

func (nm *Handshake) Initialize(
	log logging.Logger,
	vdrs validators.Set,
	myAddr salticidae.NetAddr,
	myID ids.ShortID,
	peerNet salticidae.PeerNetwork,
	registerer prometheus.Registerer,
	enableStaking bool,
	networkID uint32,
)

Initialize to the c networking library. This should only be done once during node setup.

func (*Handshake) SendGetVersion 

func (nm *Handshake) SendGetVersion(addr salticidae.NetAddr)

SendGetVersion to the requested peer

func (*Handshake) SendPeerList 

func (nm *Handshake) SendPeerList(addrs ...salticidae.NetAddr) error

SendPeerList to the requested peer

func (*Handshake) SendVersion 

func (nm *Handshake) SendVersion(addr salticidae.NetAddr) error

SendVersion to the requested peer

func (*Handshake) Shutdown 

func (nm *Handshake) Shutdown()

Shutdown the network

type Msg 

type Msg interface {
	Op() salticidae.Opcode
	Get(Field) interface{}
	DataStream() salticidae.DataStream
}

Msg represents a set of fields that can be serialized into a byte stream

type Voting 

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

Voting implements the SenderExternal interface with a c++ library.

func (*Voting) Accept 

func (s *Voting) Accept(chainID, containerID ids.ID, container []byte) error

Accept is called after every consensus decision

func (*Voting) Accepted 

func (s *Voting) Accepted(validatorID ids.ShortID, chainID ids.ID, requestID uint32, containerIDs ids.Set)

Accepted implements the Sender interface.

func (*Voting) AcceptedFrontier 

func (s *Voting) AcceptedFrontier(validatorID ids.ShortID, chainID ids.ID, requestID uint32, containerIDs ids.Set)

AcceptedFrontier implements the Sender interface.

func (*Voting) Chits 

func (s *Voting) Chits(validatorID ids.ShortID, chainID ids.ID, requestID uint32, votes ids.Set)

Chits implements the Sender interface.

func (*Voting) Get 

func (s *Voting) Get(validatorID ids.ShortID, chainID ids.ID, requestID uint32, containerID ids.ID)

Get implements the Sender interface.

func (*Voting) GetAccepted 

func (s *Voting) GetAccepted(validatorIDs ids.ShortSet, chainID ids.ID, requestID uint32, containerIDs ids.Set)

GetAccepted implements the Sender interface.

func (*Voting) GetAcceptedFrontier 

func (s *Voting) GetAcceptedFrontier(validatorIDs ids.ShortSet, chainID ids.ID, requestID uint32)

GetAcceptedFrontier implements the Sender interface.

func (*Voting) Initialize 

func (s *Voting) Initialize(log logging.Logger, vdrs validators.Set, peerNet salticidae.PeerNetwork, conns Connections, router router.Router, registerer prometheus.Registerer)

Initialize to the c networking library. Should only be called once ever.

func (*Voting) PullQuery 

func (s *Voting) PullQuery(validatorIDs ids.ShortSet, chainID ids.ID, requestID uint32, containerID ids.ID)

PullQuery implements the Sender interface.

func (*Voting) PushQuery 

func (s *Voting) PushQuery(validatorIDs ids.ShortSet, chainID ids.ID, requestID uint32, containerID ids.ID, container []byte)

PushQuery implements the Sender interface.

func (*Voting) Put 

func (s *Voting) Put(validatorID ids.ShortID, chainID ids.ID, requestID uint32, containerID ids.ID, container []byte)

Put implements the Sender interface.

func (*Voting) Shutdown 

func (s *Voting) Shutdown()

Shutdown threads

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.