gitee.com/liu-zhao234568/cntest@v1.0.0/core/genesis.go (about) 1 // Copyright 2014 The go-ethereum Authors 2 // This file is part of the go-ethereum library. 3 // 4 // The go-ethereum library is free software: you can redistribute it and/or modify 5 // it under the terms of the GNU Lesser General Public License as published by 6 // the Free Software Foundation, either version 3 of the License, or 7 // (at your option) any later version. 8 // 9 // The go-ethereum library is distributed in the hope that it will be useful, 10 // but WITHOUT ANY WARRANTY; without even the implied warranty of 11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 12 // GNU Lesser General Public License for more details. 13 // 14 // You should have received a copy of the GNU Lesser General Public License 15 // along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>. 16 17 package core 18 19 import ( 20 "bytes" 21 "encoding/hex" 22 "encoding/json" 23 "errors" 24 "fmt" 25 "math/big" 26 "strings" 27 28 "gitee.com/liu-zhao234568/cntest/common" 29 "gitee.com/liu-zhao234568/cntest/common/hexutil" 30 "gitee.com/liu-zhao234568/cntest/common/math" 31 "gitee.com/liu-zhao234568/cntest/core/rawdb" 32 "gitee.com/liu-zhao234568/cntest/core/state" 33 "gitee.com/liu-zhao234568/cntest/core/types" 34 "gitee.com/liu-zhao234568/cntest/crypto" 35 "gitee.com/liu-zhao234568/cntest/ethdb" 36 "gitee.com/liu-zhao234568/cntest/log" 37 "gitee.com/liu-zhao234568/cntest/params" 38 "gitee.com/liu-zhao234568/cntest/rlp" 39 "gitee.com/liu-zhao234568/cntest/trie" 40 ) 41 42 //go:generate gencodec -type Genesis -field-override genesisSpecMarshaling -out gen_genesis.go 43 //go:generate gencodec -type GenesisAccount -field-override genesisAccountMarshaling -out gen_genesis_account.go 44 45 var errGenesisNoConfig = errors.New("genesis has no chain configuration") 46 47 // Genesis specifies the header fields, state of a genesis block. It also defines hard 48 // fork switch-over blocks through the chain configuration. 49 type Genesis struct { 50 Config *params.ChainConfig `json:"config"` 51 Nonce uint64 `json:"nonce"` 52 Timestamp uint64 `json:"timestamp"` 53 ExtraData []byte `json:"extraData"` 54 GasLimit uint64 `json:"gasLimit" gencodec:"required"` 55 Difficulty *big.Int `json:"difficulty" gencodec:"required"` 56 Mixhash common.Hash `json:"mixHash"` 57 Coinbase common.Address `json:"coinbase"` 58 Alloc GenesisAlloc `json:"alloc" gencodec:"required"` 59 60 // These fields are used for consensus tests. Please don't use them 61 // in actual genesis blocks. 62 Number uint64 `json:"number"` 63 GasUsed uint64 `json:"gasUsed"` 64 ParentHash common.Hash `json:"parentHash"` 65 BaseFee *big.Int `json:"baseFeePerGas"` 66 } 67 68 // GenesisAlloc specifies the initial state that is part of the genesis block. 69 type GenesisAlloc map[common.Address]GenesisAccount 70 71 func (ga *GenesisAlloc) UnmarshalJSON(data []byte) error { 72 m := make(map[common.UnprefixedAddress]GenesisAccount) 73 if err := json.Unmarshal(data, &m); err != nil { 74 return err 75 } 76 *ga = make(GenesisAlloc) 77 for addr, a := range m { 78 (*ga)[common.Address(addr)] = a 79 } 80 return nil 81 } 82 83 // GenesisAccount is an account in the state of the genesis block. 84 type GenesisAccount struct { 85 Code []byte `json:"code,omitempty"` 86 Storage map[common.Hash]common.Hash `json:"storage,omitempty"` 87 Balance *big.Int `json:"balance" gencodec:"required"` 88 Nonce uint64 `json:"nonce,omitempty"` 89 PrivateKey []byte `json:"secretKey,omitempty"` // for tests 90 } 91 92 // field type overrides for gencodec 93 type genesisSpecMarshaling struct { 94 Nonce math.HexOrDecimal64 95 Timestamp math.HexOrDecimal64 96 ExtraData hexutil.Bytes 97 GasLimit math.HexOrDecimal64 98 GasUsed math.HexOrDecimal64 99 Number math.HexOrDecimal64 100 Difficulty *math.HexOrDecimal256 101 BaseFee *math.HexOrDecimal256 102 Alloc map[common.UnprefixedAddress]GenesisAccount 103 } 104 105 type genesisAccountMarshaling struct { 106 Code hexutil.Bytes 107 Balance *math.HexOrDecimal256 108 Nonce math.HexOrDecimal64 109 Storage map[storageJSON]storageJSON 110 PrivateKey hexutil.Bytes 111 } 112 113 // storageJSON represents a 256 bit byte array, but allows less than 256 bits when 114 // unmarshaling from hex. 115 type storageJSON common.Hash 116 117 func (h *storageJSON) UnmarshalText(text []byte) error { 118 text = bytes.TrimPrefix(text, []byte("0x")) 119 if len(text) > 64 { 120 return fmt.Errorf("too many hex characters in storage key/value %q", text) 121 } 122 offset := len(h) - len(text)/2 // pad on the left 123 if _, err := hex.Decode(h[offset:], text); err != nil { 124 fmt.Println(err) 125 return fmt.Errorf("invalid hex storage key/value %q", text) 126 } 127 return nil 128 } 129 130 func (h storageJSON) MarshalText() ([]byte, error) { 131 return hexutil.Bytes(h[:]).MarshalText() 132 } 133 134 // GenesisMismatchError is raised when trying to overwrite an existing 135 // genesis block with an incompatible one. 136 type GenesisMismatchError struct { 137 Stored, New common.Hash 138 } 139 140 func (e *GenesisMismatchError) Error() string { 141 return fmt.Sprintf("database contains incompatible genesis (have %x, new %x)", e.Stored, e.New) 142 } 143 144 // SetupGenesisBlock writes or updates the genesis block in db. 145 // The block that will be used is: 146 // 147 // genesis == nil genesis != nil 148 // +------------------------------------------ 149 // db has no genesis | main-net default | genesis 150 // db has genesis | from DB | genesis (if compatible) 151 // 152 // The stored chain configuration will be updated if it is compatible (i.e. does not 153 // specify a fork block below the local head block). In case of a conflict, the 154 // error is a *params.ConfigCompatError and the new, unwritten config is returned. 155 // 156 // The returned chain configuration is never nil. 157 func SetupGenesisBlock(db ethdb.Database, genesis *Genesis) (*params.ChainConfig, common.Hash, error) { 158 return SetupGenesisBlockWithOverride(db, genesis, nil) 159 } 160 161 func SetupGenesisBlockWithOverride(db ethdb.Database, genesis *Genesis, overrideLondon *big.Int) (*params.ChainConfig, common.Hash, error) { 162 if genesis != nil && genesis.Config == nil { 163 return params.AllEthashProtocolChanges, common.Hash{}, errGenesisNoConfig 164 } 165 // Just commit the new block if there is no stored genesis block. 166 stored := rawdb.ReadCanonicalHash(db, 0) 167 if (stored == common.Hash{}) { 168 if genesis == nil { 169 log.Info("Writing default main-net genesis block") 170 genesis = DefaultGenesisBlock() 171 } else { 172 log.Info("Writing custom genesis block") 173 } 174 block, err := genesis.Commit(db) 175 if err != nil { 176 return genesis.Config, common.Hash{}, err 177 } 178 return genesis.Config, block.Hash(), nil 179 } 180 // We have the genesis block in database(perhaps in ancient database) 181 // but the corresponding state is missing. 182 header := rawdb.ReadHeader(db, stored, 0) 183 if _, err := state.New(header.Root, state.NewDatabaseWithConfig(db, nil), nil); err != nil { 184 if genesis == nil { 185 genesis = DefaultGenesisBlock() 186 } 187 // Ensure the stored genesis matches with the given one. 188 hash := genesis.ToBlock(nil).Hash() 189 if hash != stored { 190 return genesis.Config, hash, &GenesisMismatchError{stored, hash} 191 } 192 block, err := genesis.Commit(db) 193 if err != nil { 194 return genesis.Config, hash, err 195 } 196 return genesis.Config, block.Hash(), nil 197 } 198 // Check whether the genesis block is already written. 199 if genesis != nil { 200 hash := genesis.ToBlock(nil).Hash() 201 if hash != stored { 202 return genesis.Config, hash, &GenesisMismatchError{stored, hash} 203 } 204 } 205 // Get the existing chain configuration. 206 newcfg := genesis.configOrDefault(stored) 207 if overrideLondon != nil { 208 newcfg.LondonBlock = overrideLondon 209 } 210 if err := newcfg.CheckConfigForkOrder(); err != nil { 211 return newcfg, common.Hash{}, err 212 } 213 storedcfg := rawdb.ReadChainConfig(db, stored) 214 if storedcfg == nil { 215 log.Warn("Found genesis block without chain config") 216 rawdb.WriteChainConfig(db, stored, newcfg) 217 return newcfg, stored, nil 218 } 219 // Special case: don't change the existing config of a non-mainnet chain if no new 220 // config is supplied. These chains would get AllProtocolChanges (and a compat error) 221 // if we just continued here. 222 if genesis == nil && stored != params.MainnetGenesisHash { 223 return storedcfg, stored, nil 224 } 225 // Check config compatibility and write the config. Compatibility errors 226 // are returned to the caller unless we're already at block zero. 227 height := rawdb.ReadHeaderNumber(db, rawdb.ReadHeadHeaderHash(db)) 228 if height == nil { 229 return newcfg, stored, fmt.Errorf("missing block number for head header hash") 230 } 231 compatErr := storedcfg.CheckCompatible(newcfg, *height) 232 if compatErr != nil && *height != 0 && compatErr.RewindTo != 0 { 233 return newcfg, stored, compatErr 234 } 235 rawdb.WriteChainConfig(db, stored, newcfg) 236 return newcfg, stored, nil 237 } 238 239 func (g *Genesis) configOrDefault(ghash common.Hash) *params.ChainConfig { 240 switch { 241 case g != nil: 242 return g.Config 243 case ghash == params.MainnetGenesisHash: 244 return params.MainnetChainConfig 245 case ghash == params.RopstenGenesisHash: 246 return params.RopstenChainConfig 247 case ghash == params.RinkebyGenesisHash: 248 return params.RinkebyChainConfig 249 case ghash == params.GoerliGenesisHash: 250 return params.GoerliChainConfig 251 case ghash == params.CalaverasGenesisHash: 252 return params.CalaverasChainConfig 253 default: 254 return params.AllEthashProtocolChanges 255 } 256 } 257 258 // ToBlock creates the genesis block and writes state of a genesis specification 259 // to the given database (or discards it if nil). 260 func (g *Genesis) ToBlock(db ethdb.Database) *types.Block { 261 if db == nil { 262 db = rawdb.NewMemoryDatabase() 263 } 264 statedb, err := state.New(common.Hash{}, state.NewDatabase(db), nil) 265 if err != nil { 266 panic(err) 267 } 268 for addr, account := range g.Alloc { 269 statedb.AddBalance(addr, account.Balance) 270 statedb.SetCode(addr, account.Code) 271 statedb.SetNonce(addr, account.Nonce) 272 for key, value := range account.Storage { 273 statedb.SetState(addr, key, value) 274 } 275 } 276 root := statedb.IntermediateRoot(false) 277 head := &types.Header{ 278 Number: new(big.Int).SetUint64(g.Number), 279 Nonce: types.EncodeNonce(g.Nonce), 280 Time: g.Timestamp, 281 ParentHash: g.ParentHash, 282 Extra: g.ExtraData, 283 GasLimit: g.GasLimit, 284 GasUsed: g.GasUsed, 285 BaseFee: g.BaseFee, 286 Difficulty: g.Difficulty, 287 MixDigest: g.Mixhash, 288 Coinbase: g.Coinbase, 289 Root: root, 290 } 291 if g.GasLimit == 0 { 292 head.GasLimit = params.GenesisGasLimit 293 } 294 if g.Difficulty == nil { 295 head.Difficulty = params.GenesisDifficulty 296 } 297 if g.Config != nil && g.Config.IsLondon(common.Big0) { 298 if g.BaseFee != nil { 299 head.BaseFee = g.BaseFee 300 } else { 301 head.BaseFee = new(big.Int).SetUint64(params.InitialBaseFee) 302 } 303 } 304 statedb.Commit(false) 305 statedb.Database().TrieDB().Commit(root, true, nil) 306 307 return types.NewBlock(head, nil, nil, nil, trie.NewStackTrie(nil)) 308 } 309 310 // Commit writes the block and state of a genesis specification to the database. 311 // The block is committed as the canonical head block. 312 func (g *Genesis) Commit(db ethdb.Database) (*types.Block, error) { 313 block := g.ToBlock(db) 314 if block.Number().Sign() != 0 { 315 return nil, fmt.Errorf("can't commit genesis block with number > 0") 316 } 317 config := g.Config 318 if config == nil { 319 config = params.AllEthashProtocolChanges 320 } 321 if err := config.CheckConfigForkOrder(); err != nil { 322 return nil, err 323 } 324 rawdb.WriteTd(db, block.Hash(), block.NumberU64(), g.Difficulty) 325 rawdb.WriteBlock(db, block) 326 rawdb.WriteReceipts(db, block.Hash(), block.NumberU64(), nil) 327 rawdb.WriteCanonicalHash(db, block.Hash(), block.NumberU64()) 328 rawdb.WriteHeadBlockHash(db, block.Hash()) 329 rawdb.WriteHeadFastBlockHash(db, block.Hash()) 330 rawdb.WriteHeadHeaderHash(db, block.Hash()) 331 rawdb.WriteChainConfig(db, block.Hash(), config) 332 return block, nil 333 } 334 335 // MustCommit writes the genesis block and state to db, panicking on error. 336 // The block is committed as the canonical head block. 337 func (g *Genesis) MustCommit(db ethdb.Database) *types.Block { 338 block, err := g.Commit(db) 339 if err != nil { 340 panic(err) 341 } 342 return block 343 } 344 345 // GenesisBlockForTesting creates and writes a block in which addr has the given wei balance. 346 func GenesisBlockForTesting(db ethdb.Database, addr common.Address, balance *big.Int) *types.Block { 347 g := Genesis{ 348 Alloc: GenesisAlloc{addr: {Balance: balance}}, 349 BaseFee: big.NewInt(params.InitialBaseFee), 350 } 351 return g.MustCommit(db) 352 } 353 354 // DefaultGenesisBlock returns the Ethereum main net genesis block. 355 func DefaultGenesisBlock() *Genesis { 356 return &Genesis{ 357 Config: params.MainnetChainConfig, 358 Nonce: 66, 359 ExtraData: hexutil.MustDecode("0x11bbe8db4e347b4e8c937c1c8370e4b5ed33adb3db69cbdb7a38e1e50b1b82fa"), 360 GasLimit: 5000, 361 Difficulty: big.NewInt(17179869184), 362 Alloc: decodePrealloc(mainnetAllocData), 363 } 364 } 365 366 // DefaultRopstenGenesisBlock returns the Ropsten network genesis block. 367 func DefaultRopstenGenesisBlock() *Genesis { 368 return &Genesis{ 369 Config: params.RopstenChainConfig, 370 Nonce: 66, 371 ExtraData: hexutil.MustDecode("0x3535353535353535353535353535353535353535353535353535353535353535"), 372 GasLimit: 16777216, 373 Difficulty: big.NewInt(1048576), 374 Alloc: decodePrealloc(ropstenAllocData), 375 } 376 } 377 378 // DefaultRinkebyGenesisBlock returns the Rinkeby network genesis block. 379 func DefaultRinkebyGenesisBlock() *Genesis { 380 return &Genesis{ 381 Config: params.RinkebyChainConfig, 382 Timestamp: 1492009146, 383 ExtraData: hexutil.MustDecode("0x52657370656374206d7920617574686f7269746168207e452e436172746d616e42eb768f2244c8811c63729a21a3569731535f067ffc57839b00206d1ad20c69a1981b489f772031b279182d99e65703f0076e4812653aab85fca0f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"), 384 GasLimit: 4700000, 385 Difficulty: big.NewInt(1), 386 Alloc: decodePrealloc(rinkebyAllocData), 387 } 388 } 389 390 // DefaultGoerliGenesisBlock returns the Görli network genesis block. 391 func DefaultGoerliGenesisBlock() *Genesis { 392 return &Genesis{ 393 Config: params.GoerliChainConfig, 394 Timestamp: 1548854791, 395 ExtraData: hexutil.MustDecode("0x22466c6578692069732061207468696e6722202d204166726900000000000000e0a2bd4258d2768837baa26a28fe71dc079f84c70000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"), 396 GasLimit: 10485760, 397 Difficulty: big.NewInt(1), 398 Alloc: decodePrealloc(goerliAllocData), 399 } 400 } 401 402 func DefaultCalaverasGenesisBlock() *Genesis { 403 // Full genesis: https://gist.github.com/holiman/c6ed9269dce28304ad176314caa75e97 404 return &Genesis{ 405 Config: params.CalaverasChainConfig, 406 Timestamp: 0x60b3877f, 407 ExtraData: hexutil.MustDecode("0x00000000000000000000000000000000000000000000000000000000000000005211cea3870c7ba7c6c44b185e62eecdb864cd8c560228ce57d31efbf64c200b2c200aacec78cf17a7148e784fe95a7a750335f8b9572ee28d72e7650000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"), 408 GasLimit: 0x47b760, 409 Difficulty: big.NewInt(1), 410 Alloc: decodePrealloc(calaverasAllocData), 411 } 412 } 413 414 // DeveloperGenesisBlock returns the 'geth --dev' genesis block. 415 func DeveloperGenesisBlock(period uint64, faucet common.Address) *Genesis { 416 // Override the default period to the user requested one 417 config := *params.AllCliqueProtocolChanges 418 config.Clique = ¶ms.CliqueConfig{ 419 Period: period, 420 Epoch: config.Clique.Epoch, 421 } 422 423 // Assemble and return the genesis with the precompiles and faucet pre-funded 424 return &Genesis{ 425 Config: &config, 426 ExtraData: append(append(make([]byte, 32), faucet[:]...), make([]byte, crypto.SignatureLength)...), 427 GasLimit: 11500000, 428 BaseFee: big.NewInt(params.InitialBaseFee), 429 Difficulty: big.NewInt(1), 430 Alloc: map[common.Address]GenesisAccount{ 431 common.BytesToAddress([]byte{1}): {Balance: big.NewInt(1)}, // ECRecover 432 common.BytesToAddress([]byte{2}): {Balance: big.NewInt(1)}, // SHA256 433 common.BytesToAddress([]byte{3}): {Balance: big.NewInt(1)}, // RIPEMD 434 common.BytesToAddress([]byte{4}): {Balance: big.NewInt(1)}, // Identity 435 common.BytesToAddress([]byte{5}): {Balance: big.NewInt(1)}, // ModExp 436 common.BytesToAddress([]byte{6}): {Balance: big.NewInt(1)}, // ECAdd 437 common.BytesToAddress([]byte{7}): {Balance: big.NewInt(1)}, // ECScalarMul 438 common.BytesToAddress([]byte{8}): {Balance: big.NewInt(1)}, // ECPairing 439 common.BytesToAddress([]byte{9}): {Balance: big.NewInt(1)}, // BLAKE2b 440 faucet: {Balance: new(big.Int).Sub(new(big.Int).Lsh(big.NewInt(1), 256), big.NewInt(9))}, 441 }, 442 } 443 } 444 445 func decodePrealloc(data string) GenesisAlloc { 446 var p []struct{ Addr, Balance *big.Int } 447 if err := rlp.NewStream(strings.NewReader(data), 0).Decode(&p); err != nil { 448 panic(err) 449 } 450 ga := make(GenesisAlloc, len(p)) 451 for _, account := range p { 452 ga[common.BigToAddress(account.Addr)] = GenesisAccount{Balance: account.Balance} 453 } 454 return ga 455 }