forkid

Documentation

Overview

Package forkid implements EIP-2124 (https://eips.ethereum.org/EIPS/eip-2124).

Index

• Variables
• func GatherForks(config *params.ChainConfig) []uint64
• type Filter
  • func NewFilter(config *params.ChainConfig, genesis common.Hash, head func() uint64) Filter
  • func NewFilterFromForks(forks []uint64, genesis common.Hash, headNumber uint64) Filter
  • func NewStaticFilter(config *params.ChainConfig, genesis common.Hash) Filter
• type ID
  • func NewID(config *params.ChainConfig, genesis common.Hash, head uint64) ID
  • func NewIDFromForks(forks []uint64, genesis common.Hash, head uint64) ID

Variables

var (
	// ErrRemoteStale is returned by the validator if a remote fork checksum is a
	// subset of our already applied forks, but the announced next fork block is
	// not on our already passed chain.
	ErrRemoteStale = errors.New("remote needs update")

	// ErrLocalIncompatibleOrStale is returned by the validator if a remote fork
	// checksum does not match any local checksum variation, signalling that the
	// two chains have diverged in the past at some point (possibly at genesis).
	ErrLocalIncompatibleOrStale = errors.New("local incompatible or needs update")
)

Functions

func GatherForks

func GatherForks(config *params.ChainConfig) []uint64

GatherForks gathers all the known forks and creates a sorted list out of them.

Types

type Filter

type Filter func(id ID) error

Filter is a fork id filter to validate a remotely advertised ID.

func NewFilter

func NewFilter(config *params.ChainConfig, genesis common.Hash, head func() uint64) Filter

NewFilter creates a filter that returns if a fork ID should be rejected or notI based on the local chain's status.

func NewFilterFromForks

func NewFilterFromForks(forks []uint64, genesis common.Hash, headNumber uint64) Filter

func NewStaticFilter

func NewStaticFilter(config *params.ChainConfig, genesis common.Hash) Filter

NewStaticFilter creates a filter at block zero.

type ID

type ID struct {
	Hash [4]byte // CRC32 checksum of the genesis block and passed fork block numbers
	Next uint64  // Block number of the next upcoming fork, or 0 if no forks are known
}

ID is a fork identifier as defined by EIP-2124.

func NewID

func NewID(config *params.ChainConfig, genesis common.Hash, head uint64) ID

NewID calculates the Ethereum fork ID from the chain config, genesis hash, and head.

func NewIDFromForks

func NewIDFromForks(forks []uint64, genesis common.Hash, head uint64) ID