dot

Documentation

Index

• Variables
• func CreateJSONRawFile(bs *BuildSpec, fp string)
• func ImportState(basepath, stateFP, headerFP string, firstSlot uint64) error
• func InitNode(cfg *Config) error
• func IsNodeInitialised(basepath string) bool
• func LoadGlobalNodeName(basepath string) (nodename string, err error)
• func NewTestGenesisRawFile(t *testing.T, cfg *Config) (filename string)
• func RandomNodeName() string
• func WriteGenesisSpecFile(data []byte, fp string) error
• type AccountConfig
• type BuildSpec
  • func BuildFromDB(path string) (*BuildSpec, error)
  • func BuildFromGenesis(path string, authCount int) (*BuildSpec, error)
  • func (b *BuildSpec) ToJSON() ([]byte, error)
  • func (b *BuildSpec) ToJSONRaw() ([]byte, error)
• type Config
  • func DevConfig() *Config
  • func GssmrConfig() *Config
  • func KusamaConfig() *Config
  • func PolkadotConfig() *Config
• type CoreConfig
• type GlobalConfig
• type InitConfig
• type LogConfig
  • func (l LogConfig) String() string
• type NetworkConfig
• type Node
  • func NewNode(cfg *Config, ks *keystore.GlobalKeystore) (*Node, error)
  • func (n *Node) Start() error
  • func (n *Node) Stop()
• type PprofConfig
  • func (p PprofConfig) String() string
• type RPCConfig
  • func (r *RPCConfig) String() string
• type ServiceBuilder
• type StateConfig
  • func (s *StateConfig) String() string

Variables

var ErrInvalidKeystoreType = errors.New("invalid keystore type")

ErrInvalidKeystoreType when trying to create a service with the wrong keystore type

var ErrNoKeysProvided = errors.New("no keys provided for authority node")

ErrNoKeysProvided is returned when no keys are given for an authority node

var ErrWasmInterpreterName = errors.New("unknown wasm interpreter name")

Functions

func CreateJSONRawFile

func CreateJSONRawFile(bs *BuildSpec, fp string)

CreateJSONRawFile will generate a JSON genesis file with raw storage

func ImportState

func ImportState(basepath, stateFP, headerFP string, firstSlot uint64) error

ImportState imports the state in the given files to the database with the given path.

func InitNode

func InitNode(cfg *Config) error

InitNode initialise the node with the given Config

func IsNodeInitialised

func IsNodeInitialised(basepath string) bool

IsNodeInitialised returns true if, within the configured data directory for the node, the state database has been created and the genesis data can been loaded

func LoadGlobalNodeName

func LoadGlobalNodeName(basepath string) (nodename string, err error)

LoadGlobalNodeName returns the stored global node name from database

func NewTestGenesisRawFile

func NewTestGenesisRawFile(t *testing.T, cfg *Config) (filename string)

NewTestGenesisRawFile returns a test genesis file using "gssmr" raw data

func RandomNodeName

func RandomNodeName() string

RandomNodeName generates a new random name if there is no name configured for the node

func WriteGenesisSpecFile

func WriteGenesisSpecFile(data []byte, fp string) error

WriteGenesisSpecFile writes the build-spec in the output filepath

Types

type AccountConfig

type AccountConfig struct {
	Key    string
	Unlock string // TODO: change to []int (#1849)
}

AccountConfig is to marshal/unmarshal account config vars

type BuildSpec

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

BuildSpec object for working with building genesis JSON files

func BuildFromDB

func BuildFromDB(path string) (*BuildSpec, error)

BuildFromDB builds a BuildSpec from the DB located at path

func BuildFromGenesis

func BuildFromGenesis(path string, authCount int) (*BuildSpec, error)

BuildFromGenesis builds a BuildSpec based on the human-readable genesis file at path

func (*BuildSpec) ToJSON

func (b *BuildSpec) ToJSON() ([]byte, error)

ToJSON outputs genesis JSON in human-readable form

func (*BuildSpec) ToJSONRaw

func (b *BuildSpec) ToJSONRaw() ([]byte, error)

ToJSONRaw outputs genesis JSON in raw form

type Config

type Config struct {
	Global  GlobalConfig
	Log     LogConfig
	Init    InitConfig
	Account AccountConfig
	Core    CoreConfig
	Network NetworkConfig
	RPC     RPCConfig
	System  types.SystemInfo
	State   StateConfig
	Pprof   PprofConfig
}

Config is a collection of configurations throughout the system

func DevConfig

func DevConfig() *Config

DevConfig returns the configuration for a development chain

func GssmrConfig

func GssmrConfig() *Config

GssmrConfig returns a new test configuration using the provided basepath

func KusamaConfig

func KusamaConfig() *Config

KusamaConfig returns a kusama node configuration

func PolkadotConfig

func PolkadotConfig() *Config

PolkadotConfig returns a "polkadot" node configuration

type CoreConfig

type CoreConfig struct {
	Roles            common.Roles
	BabeAuthority    bool
	BABELead         bool
	GrandpaAuthority bool
	WasmInterpreter  string
	GrandpaInterval  time.Duration
}

CoreConfig is to marshal/unmarshal toml core config vars

type GlobalConfig

type GlobalConfig struct {
	Name           string
	ID             string
	BasePath       string
	LogLvl         log.Level
	PublishMetrics bool
	MetricsAddress string
	NoTelemetry    bool
	TelemetryURLs  []genesis.TelemetryEndpoint
	RetainBlocks   uint32
	Pruning        pruner.Mode
}

GlobalConfig is used for every node command

type InitConfig

type InitConfig struct {
	Genesis string
}

InitConfig is the configuration for the node initialization

type LogConfig

type LogConfig struct {
	CoreLvl           log.Level
	DigestLvl         log.Level
	SyncLvl           log.Level
	NetworkLvl        log.Level
	RPCLvl            log.Level
	StateLvl          log.Level
	RuntimeLvl        log.Level
	BlockProducerLvl  log.Level
	FinalityGadgetLvl log.Level
}

LogConfig represents the log levels for individual packages

func (LogConfig) String

func (l LogConfig) String() string

type NetworkConfig

type NetworkConfig struct {
	Port              uint16
	Bootnodes         []string
	ProtocolID        string
	NoBootstrap       bool
	NoMDNS            bool
	MinPeers          int
	MaxPeers          int
	PersistentPeers   []string
	DiscoveryInterval time.Duration
	PublicIP          string
	PublicDNS         string
}

NetworkConfig is to marshal/unmarshal toml network config vars

type Node

type Node struct {
	Name            string
	ServiceRegistry services.ServiceRegisterer // registry of all node services
	// contains filtered or unexported fields
}

Node is a container for all the components of a node.

func NewNode

func NewNode(cfg *Config, ks *keystore.GlobalKeystore) (*Node, error)

NewNode creates a node based on the given Config and key store.

func (*Node) Start

func (n *Node) Start() error

Start starts all dot node services

func (*Node) Stop

func (n *Node) Stop()

Stop stops all dot node services

type PprofConfig

type PprofConfig struct {
	Enabled  bool
	Settings pprof.Settings
}

PprofConfig is the configuration for the pprof HTTP server.

func (PprofConfig) String

func (p PprofConfig) String() string

type RPCConfig

type RPCConfig struct {
	Enabled          bool
	External         bool
	Unsafe           bool
	UnsafeExternal   bool
	Port             uint32
	Host             string
	Modules          []string
	WSPort           uint32
	WS               bool
	WSExternal       bool
	WSUnsafe         bool
	WSUnsafeExternal bool
}

RPCConfig is to marshal/unmarshal toml RPC config vars

func (*RPCConfig) String

func (r *RPCConfig) String() string

Strings returns the configuration in the format field1=value1 field2=value2.

type ServiceBuilder

type ServiceBuilder interface {
	NewServiceIFace(cfg *babe.ServiceConfig) (babe.ServiceIFace, error)
}

ServiceBuilder interface to define the building of babe service

type StateConfig

type StateConfig struct {
	Rewind uint
}

StateConfig is the config for the State service

func (*StateConfig) String

func (s *StateConfig) String() string