github.com/MaynardMiner/ethereumprogpow@v1.8.23/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/ethereumprogpow/ethereumprogpow/common" 29 "github.com/ethereumprogpow/ethereumprogpow/common/hexutil" 30 "github.com/ethereumprogpow/ethereumprogpow/common/math" 31 "github.com/ethereumprogpow/ethereumprogpow/core/rawdb" 32 "github.com/ethereumprogpow/ethereumprogpow/core/state" 33 "github.com/ethereumprogpow/ethereumprogpow/core/types" 34 "github.com/ethereumprogpow/ethereumprogpow/ethdb" 35 "github.com/ethereumprogpow/ethereumprogpow/log" 36 "github.com/ethereumprogpow/ethereumprogpow/params" 37 "github.com/ethereumprogpow/ethereumprogpow/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 already contains an incompatible genesis block (have %x, new %x)", e.Stored[:8], e.New[:8]) 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 return SetupGenesisBlockWithOverride(db, genesis, nil) 155 } 156 func SetupGenesisBlockWithOverride(db ethdb.Database, genesis *Genesis, constantinopleOverride *big.Int) (*params.ChainConfig, common.Hash, error) { 157 if genesis != nil && genesis.Config == nil { 158 return params.AllEthashProtocolChanges, common.Hash{}, errGenesisNoConfig 159 } 160 161 // Just commit the new block if there is no stored genesis block. 162 stored := rawdb.ReadCanonicalHash(db, 0) 163 if (stored == common.Hash{}) { 164 if genesis == nil { 165 log.Info("Writing default main-net genesis block") 166 genesis = DefaultGenesisBlock() 167 } else { 168 log.Info("Writing custom genesis block") 169 } 170 block, err := genesis.Commit(db) 171 return genesis.Config, block.Hash(), err 172 } 173 174 // Check whether the genesis block is already written. 175 if genesis != nil { 176 hash := genesis.ToBlock(nil).Hash() 177 if hash != stored { 178 return genesis.Config, hash, &GenesisMismatchError{stored, hash} 179 } 180 } 181 182 // Get the existing chain configuration. 183 newcfg := genesis.configOrDefault(stored) 184 if constantinopleOverride != nil { 185 newcfg.ConstantinopleBlock = constantinopleOverride 186 newcfg.PetersburgBlock = constantinopleOverride 187 } 188 storedcfg := rawdb.ReadChainConfig(db, stored) 189 if storedcfg == nil { 190 log.Warn("Found genesis block without chain config") 191 rawdb.WriteChainConfig(db, stored, newcfg) 192 return newcfg, stored, nil 193 } 194 // Special case: don't change the existing config of a non-mainnet chain if no new 195 // config is supplied. These chains would get AllProtocolChanges (and a compat error) 196 // if we just continued here. 197 if genesis == nil && stored != params.MainnetGenesisHash { 198 return storedcfg, stored, nil 199 } 200 201 // Check config compatibility and write the config. Compatibility errors 202 // are returned to the caller unless we're already at block zero. 203 height := rawdb.ReadHeaderNumber(db, rawdb.ReadHeadHeaderHash(db)) 204 if height == nil { 205 return newcfg, stored, fmt.Errorf("missing block number for head header hash") 206 } 207 compatErr := storedcfg.CheckCompatible(newcfg, *height) 208 if compatErr != nil && *height != 0 && compatErr.RewindTo != 0 { 209 return newcfg, stored, compatErr 210 } 211 rawdb.WriteChainConfig(db, stored, newcfg) 212 return newcfg, stored, nil 213 } 214 215 func (g *Genesis) configOrDefault(ghash common.Hash) *params.ChainConfig { 216 switch { 217 case g != nil: 218 return g.Config 219 case ghash == params.MainnetGenesisHash: 220 return params.MainnetChainConfig 221 case ghash == params.TestnetGenesisHash: 222 return params.TestnetChainConfig 223 default: 224 return params.AllEthashProtocolChanges 225 } 226 } 227 228 // ToBlock creates the genesis block and writes state of a genesis specification 229 // to the given database (or discards it if nil). 230 func (g *Genesis) ToBlock(db ethdb.Database) *types.Block { 231 if db == nil { 232 db = ethdb.NewMemDatabase() 233 } 234 statedb, _ := state.New(common.Hash{}, state.NewDatabase(db)) 235 for addr, account := range g.Alloc { 236 statedb.AddBalance(addr, account.Balance) 237 statedb.SetCode(addr, account.Code) 238 statedb.SetNonce(addr, account.Nonce) 239 for key, value := range account.Storage { 240 statedb.SetState(addr, key, value) 241 } 242 } 243 root := statedb.IntermediateRoot(false) 244 head := &types.Header{ 245 Number: new(big.Int).SetUint64(g.Number), 246 Nonce: types.EncodeNonce(g.Nonce), 247 Time: new(big.Int).SetUint64(g.Timestamp), 248 ParentHash: g.ParentHash, 249 Extra: g.ExtraData, 250 GasLimit: g.GasLimit, 251 GasUsed: g.GasUsed, 252 Difficulty: g.Difficulty, 253 MixDigest: g.Mixhash, 254 Coinbase: g.Coinbase, 255 Root: root, 256 } 257 if g.GasLimit == 0 { 258 head.GasLimit = params.GenesisGasLimit 259 } 260 if g.Difficulty == nil { 261 head.Difficulty = params.GenesisDifficulty 262 } 263 statedb.Commit(false) 264 statedb.Database().TrieDB().Commit(root, true) 265 266 return types.NewBlock(head, nil, nil, nil) 267 } 268 269 // Commit writes the block and state of a genesis specification to the database. 270 // The block is committed as the canonical head block. 271 func (g *Genesis) Commit(db ethdb.Database) (*types.Block, error) { 272 block := g.ToBlock(db) 273 if block.Number().Sign() != 0 { 274 return nil, fmt.Errorf("can't commit genesis block with number > 0") 275 } 276 rawdb.WriteTd(db, block.Hash(), block.NumberU64(), g.Difficulty) 277 rawdb.WriteBlock(db, block) 278 rawdb.WriteReceipts(db, block.Hash(), block.NumberU64(), nil) 279 rawdb.WriteCanonicalHash(db, block.Hash(), block.NumberU64()) 280 rawdb.WriteHeadBlockHash(db, block.Hash()) 281 rawdb.WriteHeadHeaderHash(db, block.Hash()) 282 283 config := g.Config 284 if config == nil { 285 config = params.AllEthashProtocolChanges 286 } 287 rawdb.WriteChainConfig(db, block.Hash(), config) 288 return block, nil 289 } 290 291 // MustCommit writes the genesis block and state to db, panicking on error. 292 // The block is committed as the canonical head block. 293 func (g *Genesis) MustCommit(db ethdb.Database) *types.Block { 294 block, err := g.Commit(db) 295 if err != nil { 296 panic(err) 297 } 298 return block 299 } 300 301 // GenesisBlockForTesting creates and writes a block in which addr has the given wei balance. 302 func GenesisBlockForTesting(db ethdb.Database, addr common.Address, balance *big.Int) *types.Block { 303 g := Genesis{Alloc: GenesisAlloc{addr: {Balance: balance}}} 304 return g.MustCommit(db) 305 } 306 307 // DefaultGenesisBlock returns the Ethereum main net genesis block. 308 func DefaultGenesisBlock() *Genesis { 309 return &Genesis{ 310 Config: params.MainnetChainConfig, 311 Nonce: 66, 312 ExtraData: hexutil.MustDecode("0x11bbe8db4e347b4e8c937c1c8370e4b5ed33adb3db69cbdb7a38e1e50b1b82fa"), 313 GasLimit: 5000, 314 Difficulty: big.NewInt(17179869184), 315 Alloc: decodePrealloc(mainnetAllocData), 316 } 317 } 318 319 // DefaultTestnetGenesisBlock returns the Ropsten network genesis block. 320 func DefaultTestnetGenesisBlock() *Genesis { 321 return &Genesis{ 322 Config: params.TestnetChainConfig, 323 Nonce: 66, 324 ExtraData: hexutil.MustDecode("0x3535353535353535353535353535353535353535353535353535353535353535"), 325 GasLimit: 16777216, 326 Difficulty: big.NewInt(1048576), 327 Alloc: decodePrealloc(testnetAllocData), 328 } 329 } 330 331 // DefaultRinkebyGenesisBlock returns the Rinkeby network genesis block. 332 func DefaultRinkebyGenesisBlock() *Genesis { 333 return &Genesis{ 334 Config: params.RinkebyChainConfig, 335 Timestamp: 1492009146, 336 ExtraData: hexutil.MustDecode("0x52657370656374206d7920617574686f7269746168207e452e436172746d616e42eb768f2244c8811c63729a21a3569731535f067ffc57839b00206d1ad20c69a1981b489f772031b279182d99e65703f0076e4812653aab85fca0f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"), 337 GasLimit: 4700000, 338 Difficulty: big.NewInt(1), 339 Alloc: decodePrealloc(rinkebyAllocData), 340 } 341 } 342 343 // DefaultGangnamGenesisBlock returns the Gangnam network genesis block. 344 func DefaultGangnamGenesisBlock() *Genesis { 345 return &Genesis{ 346 Config: params.GangnamChainConfig, 347 Nonce: 0, 348 Timestamp: 1544523374, 349 ExtraData: hexutil.MustDecode("0x0000000000000000000000000000000000000000000000000000000000000000"), 350 GasLimit: 4700000, 351 Difficulty: big.NewInt(524288), 352 Alloc: decodePrealloc(gangnamAllocData), 353 } 354 } 355 356 // DeveloperGenesisBlock returns the 'geth --dev' genesis block. Note, this must 357 // be seeded with the 358 func DeveloperGenesisBlock(period uint64, faucet common.Address) *Genesis { 359 // Override the default period to the user requested one 360 config := *params.AllCliqueProtocolChanges 361 config.Clique.Period = period 362 363 // Assemble and return the genesis with the precompiles and faucet pre-funded 364 return &Genesis{ 365 Config: &config, 366 ExtraData: append(append(make([]byte, 32), faucet[:]...), make([]byte, 65)...), 367 GasLimit: 6283185, 368 Difficulty: big.NewInt(1), 369 Alloc: map[common.Address]GenesisAccount{ 370 common.BytesToAddress([]byte{1}): {Balance: big.NewInt(1)}, // ECRecover 371 common.BytesToAddress([]byte{2}): {Balance: big.NewInt(1)}, // SHA256 372 common.BytesToAddress([]byte{3}): {Balance: big.NewInt(1)}, // RIPEMD 373 common.BytesToAddress([]byte{4}): {Balance: big.NewInt(1)}, // Identity 374 common.BytesToAddress([]byte{5}): {Balance: big.NewInt(1)}, // ModExp 375 common.BytesToAddress([]byte{6}): {Balance: big.NewInt(1)}, // ECAdd 376 common.BytesToAddress([]byte{7}): {Balance: big.NewInt(1)}, // ECScalarMul 377 common.BytesToAddress([]byte{8}): {Balance: big.NewInt(1)}, // ECPairing 378 faucet: {Balance: new(big.Int).Sub(new(big.Int).Lsh(big.NewInt(1), 256), big.NewInt(9))}, 379 }, 380 } 381 } 382 383 func decodePrealloc(data string) GenesisAlloc { 384 var p []struct{ Addr, Balance *big.Int } 385 if err := rlp.NewStream(strings.NewReader(data), 0).Decode(&p); err != nil { 386 panic(err) 387 } 388 ga := make(GenesisAlloc, len(p)) 389 for _, account := range p { 390 ga[common.BigToAddress(account.Addr)] = GenesisAccount{Balance: account.Balance} 391 } 392 return ga 393 }