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