node

Documentation

Index

• Constants
• Variables
• type Config
• type Node
  • func (n *Node) Dispatch() error
  • func (n *Node) Initialize(Config *Config, logger logging.Logger, logFactory logging.Factory) error
  • func (n *Node) Shutdown()
• type Peer

Constants

const (
	TCP = "tcp"
)

Networking constants

Variables

var (

	// Version is the version of this code
	Version = version.NewDefaultVersion("avalanche", 0, 6, 1)
)

Types

type Config

type Config struct {
	// protocol to use for opening the network interface
	Nat nat.Router

	// ID of the network this node should connect to
	NetworkID uint32

	// Transaction fee configuration
	TxFee uint64

	// Minimum stake, in nAVAX, required to validate the Default Subnet
	MinStake uint64

	// Assertions configuration
	EnableAssertions bool

	// Crypto configuration
	EnableCrypto bool

	// Database to use for the node
	DB database.Database

	// Staking configuration
	StakingIP             utils.IPDesc
	StakingLocalPort      uint16
	EnableP2PTLS          bool
	EnableStaking         bool
	StakingKeyFile        string
	StakingCertFile       string
	DisabledStakingWeight uint64
	StakerMsgPortion      float64
	StakerCPUPortion      float64

	// Bootstrapping configuration
	BootstrapPeers []*Peer

	// HTTP configuration
	HTTPHost      string
	HTTPPort      uint16
	EnableHTTPS   bool
	HTTPSKeyFile  string
	HTTPSCertFile string

	// Enable/Disable APIs
	AdminAPIEnabled    bool
	InfoAPIEnabled     bool
	KeystoreAPIEnabled bool
	MetricsAPIEnabled  bool
	HealthAPIEnabled   bool

	// Logging configuration
	LoggingConfig logging.Config

	// Plugin directory
	PluginDir string

	// Consensus configuration
	ConsensusParams avalanche.Parameters

	// Throughput configuration
	ThroughputPort          uint16
	ThroughputServerEnabled bool

	// IPC configuration
	IPCAPIEnabled      bool
	IPCPath            string
	IPCDefaultChainIDs []string

	// Router that is used to handle incoming consensus messages
	ConsensusRouter router.Router
}

Config contains all of the configurations of an Avalanche node.

type Node

type Node struct {
	Log        logging.Logger
	LogFactory logging.Factory
	HTTPLog    logging.Logger

	// This node's unique ID used when communicating with other nodes
	// (in consensus, for example)
	ID ids.ShortID

	// Storage for this node
	DB database.Database

	// dispatcher for events as they happen in consensus
	DecisionDispatcher  *triggers.EventDispatcher
	ConsensusDispatcher *triggers.EventDispatcher

	IPCs *ipcs.ChainIPCs

	// Net runs the networking stack
	Net network.Network

	// Handles HTTP API calls
	APIServer api.Server

	// This node's configuration
	Config *Config
	// contains filtered or unexported fields
}

Node is an instance of an Avalanche node.

func (*Node) Dispatch

func (n *Node) Dispatch() error

Dispatch starts the node's servers. Returns when the node exits.

func (*Node) Initialize

func (n *Node) Initialize(Config *Config, logger logging.Logger, logFactory logging.Factory) error

Initialize this node

func (*Node) Shutdown

func (n *Node) Shutdown()

Shutdown this node

type Peer

type Peer struct {
	// IP of the peer
	IP utils.IPDesc
	// ID of the peer that can be verified during a handshake
	ID ids.ShortID
}

Peer contains the specification of an Avalanche node that can be communicated with.