lachesis

Documentation

Index

• Constants
• Variables
• type BlocksConfig
• type BlocksMissed
• type Config
  • func FakeNetConfig(accs genesis.VAccounts) Config
  • func MainNetConfig() Config
  • func TestNetConfig() Config
  • func (c *Config) EvmChainConfig() *ethparams.ChainConfig
• type DagConfig
  • func DefaultDagConfig() DagConfig
  • func FakeNetDagConfig() DagConfig
• type EconomyConfig
  • func DefaultEconomyConfig() EconomyConfig
  • func FakeEconomyConfig() EconomyConfig
• type GasPowerConfig
  • func DefaulLongGasPowerConfig() GasPowerConfig
  • func DefaultShortGasPowerConfig() GasPowerConfig
  • func FakeLongGasPowerConfig() GasPowerConfig
  • func FakeShortGasPowerConfig() GasPowerConfig

Constants

const (
	MainNetworkID uint64 = 0xfa
	TestNetworkID uint64 = 0xfa2
	FakeNetworkID uint64 = 0xfa3
)

Variables

var (
	// PercentUnit is used to define ratios with integers, it's 1.0
	PercentUnit = big.NewInt(1e6)
)

Types

type BlocksConfig

type BlocksConfig struct {
	BlockGasHardLimit uint64 `json:"maxBlockGasLimit"` // technical hard limit, gas is mostly governed by gas power allocation
}

BlocksConfig contains blocks constants

type BlocksMissed

type BlocksMissed struct {
	BlocksNum idx.Block
	Period    time.Duration
}

BlocksMissed is information about missed blocks from a staker

type Config

type Config struct {
	Name      string
	NetworkID uint64

	Genesis genesis.Genesis

	// Graph options
	Dag DagConfig

	// Blockchain options
	Blocks BlocksConfig

	// Economy options
	Economy EconomyConfig
}

Config describes lachesis net.

func FakeNetConfig

func FakeNetConfig(accs genesis.VAccounts) Config

func MainNetConfig

func MainNetConfig() Config

func TestNetConfig

func TestNetConfig() Config

func (*Config) EvmChainConfig

func (c *Config) EvmChainConfig() *ethparams.ChainConfig

EvmChainConfig returns ChainConfig for transaction signing and execution

type DagConfig

type DagConfig struct {
	MaxParents     int `json:"maxParents"`
	MaxFreeParents int `json:"maxFreeParents"` // maximum number of parents with no gas cost

	MaxEpochBlocks   idx.Frame     `json:"maxEpochBlocks"`
	MaxEpochDuration time.Duration `json:"maxEpochDuration"`

	VectorClockConfig vector.IndexConfig `json:"vectorClockConfig"`

	MaxValidatorEventsInBlock idx.Event `json:"maxValidatorEventsInBlock"`
}

DagConfig of Lachesis DAG (directed acyclic graph).

func DefaultDagConfig

func DefaultDagConfig() DagConfig

func FakeNetDagConfig

func FakeNetDagConfig() DagConfig

type EconomyConfig

type EconomyConfig struct {
	PoiPeriodDuration              time.Duration
	BlockMissedLatency             idx.Block
	InitialOfflinePenaltyThreshold BlocksMissed
	TxRewardPoiImpact              *big.Int
	InitialRewardPerSecond         *big.Int
	InitialMinGasPrice             *big.Int
	MaxRewardPerSecond             *big.Int

	ShortGasPower GasPowerConfig `json:"shortGasPower"`
	LongGasPower  GasPowerConfig `json:"longGasPower"`
}

EconomyConfig contains economy constants

func DefaultEconomyConfig

func DefaultEconomyConfig() EconomyConfig

DefaultEconomyConfig returns mainnet economy

func FakeEconomyConfig

func FakeEconomyConfig() EconomyConfig

FakeEconomyConfig returns fakenet economy

type GasPowerConfig

type GasPowerConfig struct {
	InitialAllocPerSec uint64          `json:"initialAllocPerSec"`
	MaxAllocPerSec     uint64          `json:"maxAllocPerSec"`
	MinAllocPerSec     uint64          `json:"minAllocPerSec"`
	MaxAllocPeriod     inter.Timestamp `json:"maxAllocPeriod"`
	StartupAllocPeriod inter.Timestamp `json:"startupAllocPeriod"`
	MinStartupGas      uint64          `json:"minStartupGas"`
}

GasPowerConfig defines gas power rules in the consensus.

func DefaulLongGasPowerConfig

func DefaulLongGasPowerConfig() GasPowerConfig

DefaulLongGasPowerConfig is long-window config

func DefaultShortGasPowerConfig

func DefaultShortGasPowerConfig() GasPowerConfig

DefaultShortGasPowerConfig is short-window config

func FakeLongGasPowerConfig

func FakeLongGasPowerConfig() GasPowerConfig

FakeLongGasPowerConfig is fake long-window config

func FakeShortGasPowerConfig

func FakeShortGasPowerConfig() GasPowerConfig

FakeShortGasPowerConfig is fake short-window config