aboutsummaryrefslogblamecommitdiffstats
path: root/params/config.go
blob: 0620e6ad625a61f9a5f78a9c70d01f6b81505fb1 (plain) (tree)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16















                                                                                  
              

        
                         
             

                  
                                                
                                                

 
                                              
     

                                                                                                                   
                                                                                                                   
                                                                                                                   

 








                                                                               


                                                                                      

                                                    
                                                    
                                                   

 
     

                                                                                        
                                                   







                                                                                                                            

                                                         
                                                       

         

                                                                                                      
















                                                                                                                     

         
                                                                                                      
                                          
                                                   







                                                                                                                            
                                                         
                                                         
                                                       

         

                                                                                                              
















                                                                                                                     

         

                                                                                                      
                                                   







                                                                                                                            
                                                         
                                                         





                                      

                                                                                                              



                                                                                                                     

         




                                                                                                   
                                                                                                    





                                                                                                   



















                                                                                                            
















                                                                                                                     

         

                                                                                    
          

                                                                                     
                                                                                                                                                                                                                                  





                                                                                     
                                                                                                                                                                                                                                                       
 
                                                                                                                                                                                                                      
                                                             
 
 




                                                                                  





                                                      






























                                                                                                                 





                                                                           
                                                                                                                   
 
                                                                                                                                  
 

                                                                                                                            
 
                                                                                                
                                                                                                 
                                                                                                                                             
 

                                                                              
 

                                                                                                                                                 
                                                                                                                                     
                                                                                                                                        






















                                                                                     

 
                                                
                                       








                                  
                                                                                                                                                                             
                          





                                 
                                 
                                      
                                  
                       


         

                                                                                     


                                              
                                                                                  



                                                    
                                                                                    



                                                   
                                                                                    



                                                   
                                                                                    

                                                   
 
 
                                                                                          

                                                      

 
                                                                                                    



                                                           






                                                                                                                   




                                                                             


                                                                                                      



                                                       
                

                                             
                             
                                     
                             
                                     




                                        













                                                                                              
         
                      

 





                                                                                                      
         











                                                                                                   
                                                                           

                                                                                           

                                                                                                      
         


                                                                                                                     
                                                                                
                                                                                                         
         


                                                                                          

                  
 



                                                                                     

 


                                                                                          
                            
         

                               
 







                                         
 
 
























                                                                                         

 

                                                                                                                                                 
 
 
                                                                                     




                                                                                        


                                                            

 
                                        
                                                 


                                      
         







                                                            
                                                      
         
 
// Copyright 2016 The go-ethereum Authors
// This file is part of the go-ethereum library.
//
// The go-ethereum library is free software: you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// The go-ethereum library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public License
// along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.

package params

import (
    "encoding/binary"
    "fmt"
    "math/big"

    "github.com/ethereum/go-ethereum/common"
    "github.com/ethereum/go-ethereum/crypto"
)

// Genesis hashes to enforce below configs on.
var (
    MainnetGenesisHash = common.HexToHash("0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3")
    TestnetGenesisHash = common.HexToHash("0x41941023680923e0fe4d74a34bdac8141f2540e3ae90623718e47d66d1ca4a2d")
    RinkebyGenesisHash = common.HexToHash("0x6341fd3daf94b748c72ced5a5b26028f2474f5f00d824504e4fa37a75767e177")
    GoerliGenesisHash  = common.HexToHash("0xbf7e331f7f7c1dd2e05159666b3bf8bc7a8a3a9eb1d518969eab529dd9b88c1a")
)

// TrustedCheckpoints associates each known checkpoint with the genesis hash of
// the chain it belongs to.
var TrustedCheckpoints = map[common.Hash]*TrustedCheckpoint{
    MainnetGenesisHash: MainnetTrustedCheckpoint,
    TestnetGenesisHash: TestnetTrustedCheckpoint,
    RinkebyGenesisHash: RinkebyTrustedCheckpoint,
    GoerliGenesisHash:  GoerliTrustedCheckpoint,
}

// CheckpointOracles associates each known checkpoint oracles with the genesis hash of
// the chain it belongs to.
var CheckpointOracles = map[common.Hash]*CheckpointOracleConfig{
    MainnetGenesisHash: MainnetCheckpointOracle,
    TestnetGenesisHash: TestnetCheckpointOracle,
    RinkebyGenesisHash: RinkebyCheckpointOracle,
    GoerliGenesisHash:  GoerliCheckpointOracle,
}

var (
    // MainnetChainConfig is the chain parameters to run a node on the main network.
    MainnetChainConfig = &ChainConfig{
        ChainID:             big.NewInt(1),
        HomesteadBlock:      big.NewInt(1150000),
        DAOForkBlock:        big.NewInt(1920000),
        DAOForkSupport:      true,
        EIP150Block:         big.NewInt(2463000),
        EIP150Hash:          common.HexToHash("0x2086799aeebeae135c246c65021c82b4e15a2c451340993aacfd2751886514f0"),
        EIP155Block:         big.NewInt(2675000),
        EIP158Block:         big.NewInt(2675000),
        ByzantiumBlock:      big.NewInt(4370000),
        ConstantinopleBlock: big.NewInt(7280000),
        PetersburgBlock:     big.NewInt(7280000),
        Ethash:              new(EthashConfig),
    }

    // MainnetTrustedCheckpoint contains the light client trusted checkpoint for the main network.
    MainnetTrustedCheckpoint = &TrustedCheckpoint{
        SectionIndex: 246,
        SectionHead:  common.HexToHash("0xb86fbe8a2b1f3c576d06fe1721cd976f98ac1cbf1823da16ef74811e85fd44ac"),
        CHTRoot:      common.HexToHash("0xe99b397f908a391d0d6bd41d1c19cea4bf5051a9695c94d58de44c538d7a1037"),
        BloomRoot:    common.HexToHash("0xa1c1e064ccc16690c5fbabf600c4c7ebb2d8e8fcc674e59365087a77fb391a47"),
    }

    // MainnetCheckpointOracle contains a set of configs for the main network oracle.
    MainnetCheckpointOracle = &CheckpointOracleConfig{
        Address: common.HexToAddress("0x9a9070028361F7AAbeB3f2F2Dc07F82C4a98A02a"),
        Signers: []common.Address{
            common.HexToAddress("0x1b2C260efc720BE89101890E4Db589b44E950527"), // Peter
            common.HexToAddress("0x78d1aD571A1A09D60D9BBf25894b44e4C8859595"), // Martin
            common.HexToAddress("0x286834935f4A8Cfb4FF4C77D5770C2775aE2b0E7"), // Zsolt
            common.HexToAddress("0xb86e2B0Ab5A4B1373e40c51A7C712c70Ba2f9f8E"), // Gary
            common.HexToAddress("0x0DF8fa387C602AE62559cC4aFa4972A7045d6707"), // Guillaume
        },
        Threshold: 2,
    }

    // TestnetChainConfig contains the chain parameters to run a node on the Ropsten test network.
    TestnetChainConfig = &ChainConfig{
        ChainID:             big.NewInt(3),
        HomesteadBlock:      big.NewInt(0),
        DAOForkBlock:        nil,
        DAOForkSupport:      true,
        EIP150Block:         big.NewInt(0),
        EIP150Hash:          common.HexToHash("0x41941023680923e0fe4d74a34bdac8141f2540e3ae90623718e47d66d1ca4a2d"),
        EIP155Block:         big.NewInt(10),
        EIP158Block:         big.NewInt(10),
        ByzantiumBlock:      big.NewInt(1700000),
        ConstantinopleBlock: big.NewInt(4230000),
        PetersburgBlock:     big.NewInt(4939394),
        Ethash:              new(EthashConfig),
    }

    // TestnetTrustedCheckpoint contains the light client trusted checkpoint for the Ropsten test network.
    TestnetTrustedCheckpoint = &TrustedCheckpoint{
        SectionIndex: 180,
        SectionHead:  common.HexToHash("0xc5741683f9fcff7b670732deef2ebe6e7ff7a7bb29249401300b13b4eee690a6"),
        CHTRoot:      common.HexToHash("0xf03ccebbf71a0998833afdf0e7c29095138c2df1cee6ed44ad9da62b5206b8ad"),
        BloomRoot:    common.HexToHash("0xec46c48cf218891c91ad1139d3b3aec7cf385d4c1100c06711e56b83d8993b23"),
    }

    // TestnetCheckpointOracle contains a set of configs for the Ropsten test network oracle.
    TestnetCheckpointOracle = &CheckpointOracleConfig{
        Address: common.HexToAddress("0xEF79475013f154E6A65b54cB2742867791bf0B84"),
        Signers: []common.Address{
            common.HexToAddress("0x32162F3581E88a5f62e8A61892B42C46E2c18f7b"), // Peter
            common.HexToAddress("0x78d1aD571A1A09D60D9BBf25894b44e4C8859595"), // Martin
            common.HexToAddress("0x286834935f4A8Cfb4FF4C77D5770C2775aE2b0E7"), // Zsolt
            common.HexToAddress("0xb86e2B0Ab5A4B1373e40c51A7C712c70Ba2f9f8E"), // Gary
            common.HexToAddress("0x0DF8fa387C602AE62559cC4aFa4972A7045d6707"), // Guillaume
        },
        Threshold: 2,
    }

    // RinkebyChainConfig contains the chain parameters to run a node on the Rinkeby test network.
    RinkebyChainConfig = &ChainConfig{
        ChainID:             big.NewInt(4),
        HomesteadBlock:      big.NewInt(1),
        DAOForkBlock:        nil,
        DAOForkSupport:      true,
        EIP150Block:         big.NewInt(2),
        EIP150Hash:          common.HexToHash("0x9b095b36c15eaf13044373aef8ee0bd3a382a5abb92e402afa44b8249c3a90e9"),
        EIP155Block:         big.NewInt(3),
        EIP158Block:         big.NewInt(3),
        ByzantiumBlock:      big.NewInt(1035301),
        ConstantinopleBlock: big.NewInt(3660663),
        PetersburgBlock:     big.NewInt(4321234),
        Clique: &CliqueConfig{
            Period: 15,
            Epoch:  30000,
        },
    }

    // RinkebyTrustedCheckpoint contains the light client trusted checkpoint for the Rinkeby test network.
    RinkebyTrustedCheckpoint = &TrustedCheckpoint{
        SectionIndex: 142,
        SectionHead:  common.HexToHash("0xf7e3946d54c3040d391edd61a855fec7293f9d0b51445ede88562f2dc2edce3f"),
        CHTRoot:      common.HexToHash("0xb2beee185e3ecada83eb69f72cbcca3e0978dbc8da5cdb3e34a71b3d597815d0"),
        BloomRoot:    common.HexToHash("0x3970039fee31eb0542090030d1567cc99b8051572d51899db4d91619ca26f0cb"),
    }

    // RinkebyCheckpointOracle contains a set of configs for the Rinkeby test network oracle.
    RinkebyCheckpointOracle = &CheckpointOracleConfig{
        Address: common.HexToAddress("0xebe8eFA441B9302A0d7eaECc277c09d20D684540"),
        Signers: []common.Address{
            common.HexToAddress("0xd9c9cd5f6779558b6e0ed4e6acf6b1947e7fa1f3"), // Peter
            common.HexToAddress("0x78d1aD571A1A09D60D9BBf25894b44e4C8859595"), // Martin
            common.HexToAddress("0x286834935f4A8Cfb4FF4C77D5770C2775aE2b0E7"), // Zsolt
            common.HexToAddress("0xb86e2B0Ab5A4B1373e40c51A7C712c70Ba2f9f8E"), // Gary
        },
        Threshold: 2,
    }

    // GoerliChainConfig contains the chain parameters to run a node on the Görli test network.
    GoerliChainConfig = &ChainConfig{
        ChainID:             big.NewInt(5),
        HomesteadBlock:      big.NewInt(0),
        DAOForkBlock:        nil,
        DAOForkSupport:      true,
        EIP150Block:         big.NewInt(0),
        EIP155Block:         big.NewInt(0),
        EIP158Block:         big.NewInt(0),
        ByzantiumBlock:      big.NewInt(0),
        ConstantinopleBlock: big.NewInt(0),
        PetersburgBlock:     big.NewInt(0),
        Clique: &CliqueConfig{
            Period: 15,
            Epoch:  30000,
        },
    }

    // GoerliTrustedCheckpoint contains the light client trusted checkpoint for the Görli test network.
    GoerliTrustedCheckpoint = &TrustedCheckpoint{
        SectionIndex: 26,
        SectionHead:  common.HexToHash("0xd0c206e064c8efea930d97e56786af95354ea481b35294a20e5a340937e4c2c9"),
        CHTRoot:      common.HexToHash("0xce7235999aa8d73c4493b8f397474dafc627652a790dec60c4a968e2dfa5d7be"),
        BloomRoot:    common.HexToHash("0xc1ac19553473ebb07325b5092a09277d62e9ffe159166a1c6fbec614c4dfd885"),
    }

    // GoerliCheckpointOracle contains a set of configs for the Goerli test network oracle.
    GoerliCheckpointOracle = &CheckpointOracleConfig{
        Address: common.HexToAddress("0x18CA0E045F0D772a851BC7e48357Bcaab0a0795D"),
        Signers: []common.Address{
            common.HexToAddress("0x4769bcaD07e3b938B7f43EB7D278Bc7Cb9efFb38"), // Peter
            common.HexToAddress("0x78d1aD571A1A09D60D9BBf25894b44e4C8859595"), // Martin
            common.HexToAddress("0x286834935f4A8Cfb4FF4C77D5770C2775aE2b0E7"), // Zsolt
            common.HexToAddress("0xb86e2B0Ab5A4B1373e40c51A7C712c70Ba2f9f8E"), // Gary
            common.HexToAddress("0x0DF8fa387C602AE62559cC4aFa4972A7045d6707"), // Guillaume
        },
        Threshold: 2,
    }

    // AllEthashProtocolChanges contains every protocol change (EIPs) introduced
    // and accepted by the Ethereum core developers into the Ethash consensus.
    //
    // This configuration is intentionally not using keyed fields to force anyone
    // adding flags to the config to also have to set these fields.
    AllEthashProtocolChanges = &ChainConfig{big.NewInt(1337), big.NewInt(0), nil, false, big.NewInt(0), common.Hash{}, big.NewInt(0), big.NewInt(0), big.NewInt(0), big.NewInt(0), big.NewInt(0), nil, new(EthashConfig), nil}

    // AllCliqueProtocolChanges contains every protocol change (EIPs) introduced
    // and accepted by the Ethereum core developers into the Clique consensus.
    //
    // This configuration is intentionally not using keyed fields to force anyone
    // adding flags to the config to also have to set these fields.
    AllCliqueProtocolChanges = &ChainConfig{big.NewInt(1337), big.NewInt(0), nil, false, big.NewInt(0), common.Hash{}, big.NewInt(0), big.NewInt(0), big.NewInt(0), big.NewInt(0), big.NewInt(0), nil, nil, &CliqueConfig{Period: 0, Epoch: 30000}}

    TestChainConfig = &ChainConfig{big.NewInt(1), big.NewInt(0), nil, false, big.NewInt(0), common.Hash{}, big.NewInt(0), big.NewInt(0), big.NewInt(0), big.NewInt(0), big.NewInt(0), nil, new(EthashConfig), nil}
    TestRules       = TestChainConfig.Rules(new(big.Int))
)

// TrustedCheckpoint represents a set of post-processed trie roots (CHT and
// BloomTrie) associated with the appropriate section index and head hash. It is
// used to start light syncing from this checkpoint and avoid downloading the
// entire header chain while still being able to securely access old headers/logs.
type TrustedCheckpoint struct {
    SectionIndex uint64      `json:"sectionIndex"`
    SectionHead  common.Hash `json:"sectionHead"`
    CHTRoot      common.Hash `json:"chtRoot"`
    BloomRoot    common.Hash `json:"bloomRoot"`
}

// HashEqual returns an indicator comparing the itself hash with given one.
func (c *TrustedCheckpoint) HashEqual(hash common.Hash) bool {
    if c.Empty() {
        return hash == common.Hash{}
    }
    return c.Hash() == hash
}

// Hash returns the hash of checkpoint's four key fields(index, sectionHead, chtRoot and bloomTrieRoot).
func (c *TrustedCheckpoint) Hash() common.Hash {
    buf := make([]byte, 8+3*common.HashLength)
    binary.BigEndian.PutUint64(buf, c.SectionIndex)
    copy(buf[8:], c.SectionHead.Bytes())
    copy(buf[8+common.HashLength:], c.CHTRoot.Bytes())
    copy(buf[8+2*common.HashLength:], c.BloomRoot.Bytes())
    return crypto.Keccak256Hash(buf)
}

// Empty returns an indicator whether the checkpoint is regarded as empty.
func (c *TrustedCheckpoint) Empty() bool {
    return c.SectionHead == (common.Hash{}) || c.CHTRoot == (common.Hash{}) || c.BloomRoot == (common.Hash{})
}

// CheckpointOracleConfig represents a set of checkpoint contract(which acts as an oracle)
// config which used for light client checkpoint syncing.
type CheckpointOracleConfig struct {
    Address   common.Address   `json:"address"`
    Signers   []common.Address `json:"signers"`
    Threshold uint64           `json:"threshold"`
}

// ChainConfig is the core config which determines the blockchain settings.
//
// ChainConfig is stored in the database on a per block basis. This means
// that any network, identified by its genesis block, can have its own
// set of configuration options.
type ChainConfig struct {
    ChainID *big.Int `json:"chainId"` // chainId identifies the current chain and is used for replay protection

    HomesteadBlock *big.Int `json:"homesteadBlock,omitempty"` // Homestead switch block (nil = no fork, 0 = already homestead)

    DAOForkBlock   *big.Int `json:"daoForkBlock,omitempty"`   // TheDAO hard-fork switch block (nil = no fork)
    DAOForkSupport bool     `json:"daoForkSupport,omitempty"` // Whether the nodes supports or opposes the DAO hard-fork

    // EIP150 implements the Gas price changes (https://github.com/ethereum/EIPs/issues/150)
    EIP150Block *big.Int    `json:"eip150Block,omitempty"` // EIP150 HF block (nil = no fork)
    EIP150Hash  common.Hash `json:"eip150Hash,omitempty"`  // EIP150 HF hash (needed for header only clients as only gas pricing changed)

    EIP155Block *big.Int `json:"eip155Block,omitempty"` // EIP155 HF block
    EIP158Block *big.Int `json:"eip158Block,omitempty"` // EIP158 HF block

    ByzantiumBlock      *big.Int `json:"byzantiumBlock,omitempty"`      // Byzantium switch block (nil = no fork, 0 = already on byzantium)
    ConstantinopleBlock *big.Int `json:"constantinopleBlock,omitempty"` // Constantinople switch block (nil = no fork, 0 = already activated)
    PetersburgBlock     *big.Int `json:"petersburgBlock,omitempty"`     // Petersburg switch block (nil = same as Constantinople)
    EWASMBlock          *big.Int `json:"ewasmBlock,omitempty"`          // EWASM switch block (nil = no fork, 0 = already activated)

    // Various consensus engines
    Ethash *EthashConfig `json:"ethash,omitempty"`
    Clique *CliqueConfig `json:"clique,omitempty"`
}

// EthashConfig is the consensus engine configs for proof-of-work based sealing.
type EthashConfig struct{}

// String implements the stringer interface, returning the consensus engine details.
func (c *EthashConfig) String() string {
    return "ethash"
}

// CliqueConfig is the consensus engine configs for proof-of-authority based sealing.
type CliqueConfig struct {
    Period uint64 `json:"period"` // Number of seconds between blocks to enforce
    Epoch  uint64 `json:"epoch"`  // Epoch length to reset votes and checkpoint
}

// String implements the stringer interface, returning the consensus engine details.
func (c *CliqueConfig) String() string {
    return "clique"
}

// String implements the fmt.Stringer interface.
func (c *ChainConfig) String() string {
    var engine interface{}
    switch {
    case c.Ethash != nil:
        engine = c.Ethash
    case c.Clique != nil:
        engine = c.Clique
    default:
        engine = "unknown"
    }
    return fmt.Sprintf("{ChainID: %v Homestead: %v DAO: %v DAOSupport: %v EIP150: %v EIP155: %v EIP158: %v Byzantium: %v Constantinople: %v  Petersburg: %v Engine: %v}",
        c.ChainID,
        c.HomesteadBlock,
        c.DAOForkBlock,
        c.DAOForkSupport,
        c.EIP150Block,
        c.EIP155Block,
        c.EIP158Block,
        c.ByzantiumBlock,
        c.ConstantinopleBlock,
        c.PetersburgBlock,
        engine,
    )
}

// IsHomestead returns whether num is either equal to the homestead block or greater.
func (c *ChainConfig) IsHomestead(num *big.Int) bool {
    return isForked(c.HomesteadBlock, num)
}

// IsDAOFork returns whether num is either equal to the DAO fork block or greater.
func (c *ChainConfig) IsDAOFork(num *big.Int) bool {
    return isForked(c.DAOForkBlock, num)
}

// IsEIP150 returns whether num is either equal to the EIP150 fork block or greater.
func (c *ChainConfig) IsEIP150(num *big.Int) bool {
    return isForked(c.EIP150Block, num)
}

// IsEIP155 returns whether num is either equal to the EIP155 fork block or greater.
func (c *ChainConfig) IsEIP155(num *big.Int) bool {
    return isForked(c.EIP155Block, num)
}

// IsEIP158 returns whether num is either equal to the EIP158 fork block or greater.
func (c *ChainConfig) IsEIP158(num *big.Int) bool {
    return isForked(c.EIP158Block, num)
}

// IsByzantium returns whether num is either equal to the Byzantium fork block or greater.
func (c *ChainConfig) IsByzantium(num *big.Int) bool {
    return isForked(c.ByzantiumBlock, num)
}

// IsConstantinople returns whether num is either equal to the Constantinople fork block or greater.
func (c *ChainConfig) IsConstantinople(num *big.Int) bool {
    return isForked(c.ConstantinopleBlock, num)
}

// IsPetersburg returns whether num is either
// - equal to or greater than the PetersburgBlock fork block,
// - OR is nil, and Constantinople is active
func (c *ChainConfig) IsPetersburg(num *big.Int) bool {
    return isForked(c.PetersburgBlock, num) || c.PetersburgBlock == nil && isForked(c.ConstantinopleBlock, num)
}

// IsEWASM returns whether num represents a block number after the EWASM fork
func (c *ChainConfig) IsEWASM(num *big.Int) bool {
    return isForked(c.EWASMBlock, num)
}

// GasTable returns the gas table corresponding to the current phase (homestead or homestead reprice).
//
// The returned GasTable's fields shouldn't, under any circumstances, be changed.
func (c *ChainConfig) GasTable(num *big.Int) GasTable {
    if num == nil {
        return GasTableHomestead
    }
    switch {
    case c.IsConstantinople(num):
        return GasTableConstantinople
    case c.IsEIP158(num):
        return GasTableEIP158
    case c.IsEIP150(num):
        return GasTableEIP150
    default:
        return GasTableHomestead
    }
}

// CheckCompatible checks whether scheduled fork transitions have been imported
// with a mismatching chain configuration.
func (c *ChainConfig) CheckCompatible(newcfg *ChainConfig, height uint64) *ConfigCompatError {
    bhead := new(big.Int).SetUint64(height)

    // Iterate checkCompatible to find the lowest conflict.
    var lasterr *ConfigCompatError
    for {
        err := c.checkCompatible(newcfg, bhead)
        if err == nil || (lasterr != nil && err.RewindTo == lasterr.RewindTo) {
            break
        }
        lasterr = err
        bhead.SetUint64(err.RewindTo)
    }
    return lasterr
}

func (c *ChainConfig) checkCompatible(newcfg *ChainConfig, head *big.Int) *ConfigCompatError {
    if isForkIncompatible(c.HomesteadBlock, newcfg.HomesteadBlock, head) {
        return newCompatError("Homestead fork block", c.HomesteadBlock, newcfg.HomesteadBlock)
    }
    if isForkIncompatible(c.DAOForkBlock, newcfg.DAOForkBlock, head) {
        return newCompatError("DAO fork block", c.DAOForkBlock, newcfg.DAOForkBlock)
    }
    if c.IsDAOFork(head) && c.DAOForkSupport != newcfg.DAOForkSupport {
        return newCompatError("DAO fork support flag", c.DAOForkBlock, newcfg.DAOForkBlock)
    }
    if isForkIncompatible(c.EIP150Block, newcfg.EIP150Block, head) {
        return newCompatError("EIP150 fork block", c.EIP150Block, newcfg.EIP150Block)
    }
    if isForkIncompatible(c.EIP155Block, newcfg.EIP155Block, head) {
        return newCompatError("EIP155 fork block", c.EIP155Block, newcfg.EIP155Block)
    }
    if isForkIncompatible(c.EIP158Block, newcfg.EIP158Block, head) {
        return newCompatError("EIP158 fork block", c.EIP158Block, newcfg.EIP158Block)
    }
    if c.IsEIP158(head) && !configNumEqual(c.ChainID, newcfg.ChainID) {
        return newCompatError("EIP158 chain ID", c.EIP158Block, newcfg.EIP158Block)
    }
    if isForkIncompatible(c.ByzantiumBlock, newcfg.ByzantiumBlock, head) {
        return newCompatError("Byzantium fork block", c.ByzantiumBlock, newcfg.ByzantiumBlock)
    }
    if isForkIncompatible(c.ConstantinopleBlock, newcfg.ConstantinopleBlock, head) {
        return newCompatError("Constantinople fork block", c.ConstantinopleBlock, newcfg.ConstantinopleBlock)
    }
    if isForkIncompatible(c.PetersburgBlock, newcfg.PetersburgBlock, head) {
        return newCompatError("Petersburg fork block", c.PetersburgBlock, newcfg.PetersburgBlock)
    }
    if isForkIncompatible(c.EWASMBlock, newcfg.EWASMBlock, head) {
        return newCompatError("ewasm fork block", c.EWASMBlock, newcfg.EWASMBlock)
    }
    return nil
}

// isForkIncompatible returns true if a fork scheduled at s1 cannot be rescheduled to
// block s2 because head is already past the fork.
func isForkIncompatible(s1, s2, head *big.Int) bool {
    return (isForked(s1, head) || isForked(s2, head)) && !configNumEqual(s1, s2)
}

// isForked returns whether a fork scheduled at block s is active at the given head block.
func isForked(s, head *big.Int) bool {
    if s == nil || head == nil {
        return false
    }
    return s.Cmp(head) <= 0
}

func configNumEqual(x, y *big.Int) bool {
    if x == nil {
        return y == nil
    }
    if y == nil {
        return x == nil
    }
    return x.Cmp(y) == 0
}

// ConfigCompatError is raised if the locally-stored blockchain is initialised with a
// ChainConfig that would alter the past.
type ConfigCompatError struct {
    What string
    // block numbers of the stored and new configurations
    StoredConfig, NewConfig *big.Int
    // the block number to which the local chain must be rewound to correct the error
    RewindTo uint64
}

func newCompatError(what string, storedblock, newblock *big.Int) *ConfigCompatError {
    var rew *big.Int
    switch {
    case storedblock == nil:
        rew = newblock
    case newblock == nil || storedblock.Cmp(newblock) < 0:
        rew = storedblock
    default:
        rew = newblock
    }
    err := &ConfigCompatError{what, storedblock, newblock, 0}
    if rew != nil && rew.Sign() > 0 {
        err.RewindTo = rew.Uint64() - 1
    }
    return err
}

func (err *ConfigCompatError) Error() string {
    return fmt.Sprintf("mismatching %s in database (have %d, want %d, rewindto %d)", err.What, err.StoredConfig, err.NewConfig, err.RewindTo)
}

// Rules wraps ChainConfig and is merely syntactic sugar or can be used for functions
// that do not have or require information about the block.
//
// Rules is a one time interface meaning that it shouldn't be used in between transition
// phases.
type Rules struct {
    ChainID                                     *big.Int
    IsHomestead, IsEIP150, IsEIP155, IsEIP158   bool
    IsByzantium, IsConstantinople, IsPetersburg bool
}

// Rules ensures c's ChainID is not nil.
func (c *ChainConfig) Rules(num *big.Int) Rules {
    chainID := c.ChainID
    if chainID == nil {
        chainID = new(big.Int)
    }
    return Rules{
        ChainID:          new(big.Int).Set(chainID),
        IsHomestead:      c.IsHomestead(num),
        IsEIP150:         c.IsEIP150(num),
        IsEIP155:         c.IsEIP155(num),
        IsEIP158:         c.IsEIP158(num),
        IsByzantium:      c.IsByzantium(num),
        IsConstantinople: c.IsConstantinople(num),
        IsPetersburg:     c.IsPetersburg(num),
    }
}