genesis

type Account struct {
	// InitBalanceMap is the address and initial balance mapping before the first block.
	InitBalanceMap map[string]string `yaml:"initBalances"`
	// ReplayDeployerWhitelist is the whitelist address for unprotected (pre-EIP155) transaction
	ReplayDeployerWhitelist []string `yaml:"replayDeployerWhitelist"`
}

type Blockchain struct {
	// Timestamp is the timestamp of the genesis block
	Timestamp int64
	// BlockGasLimit is the total gas limit could be consumed in a block
	BlockGasLimit uint64 `yaml:"blockGasLimit"`
	// TsunamiBlockGasLimit is the block gas limit starting Tsunami height (raised to 50M by default)
	TsunamiBlockGasLimit uint64 `yaml:"tsunamiBlockGasLimit"`
	// ActionGasLimit is the per action gas limit cap
	ActionGasLimit uint64 `yaml:"actionGasLimit"`
	// BlockInterval is the interval between two blocks
	BlockInterval time.Duration `yaml:"blockInterval"`
	// NumSubEpochs is the number of sub epochs in one epoch of block production
	NumSubEpochs uint64 `yaml:"numSubEpochs"`
	// DardanellesNumSubEpochs is the number of sub epochs starts from dardanelles height in one epoch of block production
	DardanellesNumSubEpochs uint64 `yaml:"dardanellesNumSubEpochs"`
	// NumDelegates is the number of delegates that participate into one epoch of block production
	NumDelegates uint64 `yaml:"numDelegates"`
	// NumCandidateDelegates is the number of candidate delegates, who may be selected as a delegate via roll dpos
	NumCandidateDelegates uint64 `yaml:"numCandidateDelegates"`
	// TimeBasedRotation is the flag to enable rotating delegates' time slots on a block height
	TimeBasedRotation bool `yaml:"timeBasedRotation"`
	// MinBlocksForBlobRetention is the minimum number of blocks for blob retention
	MinBlocksForBlobRetention uint64 `yaml:"minBlocksForBlobRetention"`
	// PacificBlockHeight is the start height of using the logic of Pacific version
	// TODO: PacificBlockHeight is not added into protobuf definition for backward compatibility
	PacificBlockHeight uint64 `yaml:"pacificHeight"`
	// AleutianBlockHeight is the start height of adding bloom filter of all events into block header
	AleutianBlockHeight uint64 `yaml:"aleutianHeight"`
	// BeringBlockHeight is the start height of evm upgrade
	BeringBlockHeight uint64 `yaml:"beringHeight"`
	// CookBlockHeight is the start height of native staking
	CookBlockHeight uint64 `yaml:"cookHeight"`
	// DardanellesBlockHeight is the start height of 5s block internal
	DardanellesBlockHeight uint64 `yaml:"dardanellesHeight"`
	// DaytonaBlockHeight is the height to fix low gas for read native staking contract
	DaytonaBlockHeight uint64 `yaml:"daytonaBlockHeight"`
	// EasterBlockHeight is the start height of probation for slashing
	EasterBlockHeight uint64 `yaml:"easterHeight"`
	// FbkMigrationBlockHeight is the start height for fairbank migration
	FbkMigrationBlockHeight uint64 `yaml:"fbkMigrationHeight"`
	// FairbankBlockHeight is the start height to switch to native staking V2
	FairbankBlockHeight uint64 `yaml:"fairbankHeight"`
	// GreenlandBlockHeight is the start height of storing latest 720 block meta and rewarding/staking bucket pool
	GreenlandBlockHeight uint64 `yaml:"greenlandHeight"`
	// HawaiiBlockHeight is the start height to
	// 1. fix GetBlockHash in EVM
	// 2. add revert message to log
	// 3. fix change to same candidate in staking protocol
	// 4. fix sorted map in StateDBAdapter
	// 5. use pending nonce in EVM
	HawaiiBlockHeight uint64 `yaml:"hawaiiHeight"`
	// IcelandBlockHeight is the start height to support chainID opcode and EVM Istanbul
	IcelandBlockHeight uint64 `yaml:"icelandHeight"`
	// JutlandBlockHeight is the start height to
	// 1. report more EVM error codes
	// 2. enable the opCall fix
	JutlandBlockHeight uint64 `yaml:"jutlandHeight"`
	// KamchatkaBlockHeight is the start height to
	// 1. fix EVM snapshot order
	// 2. extend foundation bonus
	KamchatkaBlockHeight uint64 `yaml:"kamchatkaHeight"`
	// LordHoweBlockHeight is the start height to
	// 1. recover the smart contracts affected by snapshot order
	// 2. clear snapshots in Revert()
	LordHoweBlockHeight uint64 `yaml:"lordHoweHeight"`
	// MidwayBlockHeight is the start height to
	// 1. allow correct and default ChainID
	// 2. fix GetHashFunc in EVM
	// 3. correct tx/log index for transaction receipt and EVM log
	// 4. revert logs upon tx reversion in EVM
	MidwayBlockHeight uint64 `yaml:"midwayHeight"`
	// NewfoundlandBlockHeight is the start height to
	// 1. use correct chainID
	// 2. check legacy address
	// 3. enable web3 staking transaction
	NewfoundlandBlockHeight uint64 `yaml:"newfoundlandHeight"`
	// OkhotskBlockHeight is the start height to
	// 1. enable London EVM
	// 2. create zero-nonce account
	// 3. fix gas and nonce update
	// 4. fix unproductive delegates in staking protocol
	OkhotskBlockHeight uint64 `yaml:"okhotskHeight"`
	// PalauBlockHeight is the the start height to
	// 1. enable rewarding action via web3
	// 2. broadcast node info into the p2p network
	PalauBlockHeight uint64 `yaml:"palauHeight"`
	// QuebecBlockHeight is the start height to
	// 1. enforce using correct chainID only
	// 2. enable IIP-13 liquidity staking
	// 3. valiate system action layout
	QuebecBlockHeight uint64 `yaml:"quebecHeight"`
	// RedseaBlockHeight is the start height to
	// 1. upgrade go-ethereum to Bellatrix release
	// 2. correct weighted votes for contract staking bucket
	RedseaBlockHeight uint64 `yaml:"redseaHeight"`
	// SumatraBlockHeight is the start height to enable Shanghai EVM
	SumatraBlockHeight uint64 `yaml:"sumatraHeight"`
	// TsunamiBlockHeight is the start height to
	// 1. enable delegate endorsement
	// 2. raise block gas limit to 50M
	TsunamiBlockHeight uint64 `yaml:"tsunamiHeight"`
	// UpernavikBlockHeight is the start height to
	// 1. enable new NFT staking contract
	// 2. migrate native staking bucket to NFT staking
	// 3. delegate ownership transfer
	// 4. send EVM transaction in general container format
	// 5. generate transaction log for SelfDestruct() call in EVM
	// 6. add address in claim reward action
	UpernavikBlockHeight uint64 `yaml:"upernavikHeight"`
	// VanuatuBlockHeight is the start height to
	// 1. enable Cancun EVM
	// 2. enable dynamic fee tx
	VanuatuBlockHeight uint64 `yaml:"vanuatuHeight"`
	// ToBeEnabledBlockHeight is a fake height that acts as a gating factor for WIP features
	// upon next release, change IsToBeEnabled() to IsNextHeight() for features to be released
	ToBeEnabledBlockHeight uint64 `yaml:"toBeEnabledHeight"`
}

type BootstrapCandidate struct {
	OwnerAddress      string `yaml:"ownerAddress"`
	OperatorAddress   string `yaml:"operatorAddress"`
	RewardAddress     string `yaml:"rewardAddress"`
	Name              string `yaml:"name"`
	SelfStakingTokens string `yaml:"selfStakingTokens"`
}

type Delegate struct {
	// OperatorAddrStr is the address who will operate the node
	OperatorAddrStr string `yaml:"operatorAddr"`
	// RewardAddrStr is the address who will get the reward when operator produces blocks
	RewardAddrStr string `yaml:"rewardAddr"`
	// VotesStr is the score for the operator to rank and weight for rewardee to split epoch reward
	VotesStr string `yaml:"votes"`
}

type Genesis struct {
	Blockchain `yaml:"blockchain"`
	Account    `yaml:"account"`
	Poll       `yaml:"poll"`
	Rewarding  `yaml:"rewarding"`
	Staking    `yaml:"staking"`
}

type Poll struct {
	// PollMode is different based on chain type or poll input data source
	PollMode string `yaml:"pollMode"`
	// EnableGravityChainVoting is a flag whether read voting from gravity chain
	EnableGravityChainVoting bool `yaml:"enableGravityChainVoting"`
	// GravityChainStartHeight is the height in gravity chain where the init poll result stored
	GravityChainStartHeight uint64 `yaml:"gravityChainStartHeight"`
	// GravityChainCeilingHeight is the height in gravity chain where the poll is no longer needed
	GravityChainCeilingHeight uint64 `yaml:"gravityChainCeilingHeight"`
	// GravityChainHeightInterval the height interval on gravity chain to pull delegate information
	GravityChainHeightInterval uint64 `yaml:"gravityChainHeightInterval"`
	// RegisterContractAddress is the address of register contract
	RegisterContractAddress string `yaml:"registerContractAddress"`
	// StakingContractAddress is the address of staking contract
	StakingContractAddress string `yaml:"stakingContractAddress"`
	// NativeStakingContractAddress is the address of native staking contract
	NativeStakingContractAddress string `yaml:"nativeStakingContractAddress"`
	// NativeStakingContractCode is the code of native staking contract
	NativeStakingContractCode string `yaml:"nativeStakingContractCode"`
	// ConsortiumCommitteeCode is the code of consortiumCommittee contract
	ConsortiumCommitteeContractCode string `yaml:"consortiumCommitteeContractCode"`
	// VoteThreshold is the vote threshold amount in decimal string format
	VoteThreshold string `yaml:"voteThreshold"`
	// ScoreThreshold is the score threshold amount in decimal string format
	ScoreThreshold string `yaml:"scoreThreshold"`
	// SelfStakingThreshold is self-staking vote threshold amount in decimal string format
	SelfStakingThreshold string `yaml:"selfStakingThreshold"`
	// Delegates is a list of delegates with votes
	Delegates []Delegate `yaml:"delegates"`
	// ProbationEpochPeriod is a duration of probation after delegate's productivity is lower than threshold
	ProbationEpochPeriod uint64 `yaml:"probationEpochPeriod"`
	// ProbationIntensityRate is a intensity rate of probation range from [0, 100], where 100 is hard-probation
	ProbationIntensityRate uint32 `yaml:"probationIntensityRate"`
	// UnproductiveDelegateMaxCacheSize is a max cache size of upd which is stored into state DB (probationEpochPeriod <= UnproductiveDelegateMaxCacheSize)
	UnproductiveDelegateMaxCacheSize uint64 `yaml:"unproductiveDelegateMaxCacheSize"`
	// SystemStakingContractAddress is the address of system staking contract
	SystemStakingContractAddress string `yaml:"systemStakingContractAddress"`
	// SystemStakingContractHeight is the height of system staking contract
	SystemStakingContractHeight uint64 `yaml:"systemStakingContractHeight"`
	// deprecated
	SystemSGDContractAddress string `yaml:"systemSGDContractAddress"`
	// deprecated
	SystemSGDContractHeight uint64 `yaml:"systemSGDContractHeight"`
	// SystemStakingContractV2Address is the address of system staking contract
	SystemStakingContractV2Address string `yaml:"systemStakingContractV2Address"`
	// SystemStakingContractV2Height is the height of system staking contract
	SystemStakingContractV2Height uint64 `yaml:"systemStakingContractV2Height"`
}

type RegistrationConsts struct {
	Fee          string `yaml:"fee"`
	MinSelfStake string `yaml:"minSelfStake"`
}

type Rewarding struct {
	// InitBalanceStr is the initial balance of the rewarding protocol in decimal string format
	InitBalanceStr string `yaml:"initBalance"`
	// BlockReward is the block reward amount in decimal string format
	BlockRewardStr string `yaml:"blockReward"`
	// DardanellesBlockReward is the block reward amount starts from dardanelles height in decimal string format
	DardanellesBlockRewardStr string `yaml:"dardanellesBlockReward"`
	// EpochReward is the epoch reward amount in decimal string format
	EpochRewardStr string `yaml:"epochReward"`
	// AleutianEpochRewardStr is the epoch reward amount in decimal string format after aleutian fork
	AleutianEpochRewardStr string `yaml:"aleutianEpochReward"`
	// NumDelegatesForEpochReward is the number of top candidates that will share a epoch reward
	NumDelegatesForEpochReward uint64 `yaml:"numDelegatesForEpochReward"`
	// ExemptAddrStrsFromEpochReward is the list of addresses in encoded string format that exempt from epoch reward
	ExemptAddrStrsFromEpochReward []string `yaml:"exemptAddrsFromEpochReward"`
	// FoundationBonusStr is the bootstrap bonus in decimal string format
	FoundationBonusStr string `yaml:"foundationBonus"`
	// NumDelegatesForFoundationBonus is the number of top candidate that will get the bootstrap bonus
	NumDelegatesForFoundationBonus uint64 `yaml:"numDelegatesForFoundationBonus"`
	// FoundationBonusLastEpoch is the last epoch number that bootstrap bonus will be granted
	FoundationBonusLastEpoch uint64 `yaml:"foundationBonusLastEpoch"`
	// FoundationBonusP2StartEpoch is the start epoch number for part 2 foundation bonus
	FoundationBonusP2StartEpoch uint64 `yaml:"foundationBonusP2StartEpoch"`
	// FoundationBonusP2EndEpoch is the end epoch number for part 2 foundation bonus
	FoundationBonusP2EndEpoch uint64 `yaml:"foundationBonusP2EndEpoch"`
	// ProductivityThreshold is the percentage number that a delegate's productivity needs to reach not to get probation
	ProductivityThreshold uint64 `yaml:"productivityThreshold"`
}

type Staking struct {
	VoteWeightCalConsts              VoteWeightCalConsts  `yaml:"voteWeightCalConsts"`
	RegistrationConsts               RegistrationConsts   `yaml:"registrationConsts"`
	WithdrawWaitingPeriod            time.Duration        `yaml:"withdrawWaitingPeriod"`
	MinStakeAmount                   string               `yaml:"minStakeAmount"`
	BootstrapCandidates              []BootstrapCandidate `yaml:"bootstrapCandidates"`
	EndorsementWithdrawWaitingBlocks uint64               `yaml:"endorsementWithdrawWaitingBlocks"`
}

type VoteWeightCalConsts struct {
	DurationLg float64 `yaml:"durationLg"`
	AutoStake  float64 `yaml:"autoStake"`
	SelfStake  float64 `yaml:"selfStake"`
}