config.go 33 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784
  1. // Copyright 2016 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. package params
  17. import (
  18. "encoding/binary"
  19. "fmt"
  20. "math/big"
  21. "github.com/ethereum/go-ethereum/common"
  22. "golang.org/x/crypto/sha3"
  23. )
  24. // Genesis hashes to enforce below configs on.
  25. var (
  26. MainnetGenesisHash = common.HexToHash("0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3")
  27. RopstenGenesisHash = common.HexToHash("0x41941023680923e0fe4d74a34bdac8141f2540e3ae90623718e47d66d1ca4a2d")
  28. RinkebyGenesisHash = common.HexToHash("0x6341fd3daf94b748c72ced5a5b26028f2474f5f00d824504e4fa37a75767e177")
  29. GoerliGenesisHash = common.HexToHash("0xbf7e331f7f7c1dd2e05159666b3bf8bc7a8a3a9eb1d518969eab529dd9b88c1a")
  30. BSCGenesisHash = common.HexToHash("0x0d21840abff46b96c84b2ac9e10e4f5cdaeb5693cb665db62a2f3b02d2d57b5b")
  31. ChapelGenesisHash = common.HexToHash("0x6d3c66c5357ec91d5c43af47e234a939b22557cbb552dc45bebbceeed90fbe34")
  32. RialtoGenesisHash = common.HexToHash("0x005dc005bddd1967de6187c1c23be801eb7abdd80cebcc24f341b727b70311d6")
  33. YoloV3GenesisHash = common.HexToHash("0xf1f2876e8500c77afcc03228757b39477eceffccf645b734967fe3c7e16967b7")
  34. )
  35. // TrustedCheckpoints associates each known checkpoint with the genesis hash of
  36. // the chain it belongs to.
  37. var TrustedCheckpoints = map[common.Hash]*TrustedCheckpoint{
  38. MainnetGenesisHash: MainnetTrustedCheckpoint,
  39. RopstenGenesisHash: RopstenTrustedCheckpoint,
  40. RinkebyGenesisHash: RinkebyTrustedCheckpoint,
  41. GoerliGenesisHash: GoerliTrustedCheckpoint,
  42. }
  43. // CheckpointOracles associates each known checkpoint oracles with the genesis hash of
  44. // the chain it belongs to.
  45. var CheckpointOracles = map[common.Hash]*CheckpointOracleConfig{
  46. MainnetGenesisHash: MainnetCheckpointOracle,
  47. RopstenGenesisHash: RopstenCheckpointOracle,
  48. RinkebyGenesisHash: RinkebyCheckpointOracle,
  49. GoerliGenesisHash: GoerliCheckpointOracle,
  50. }
  51. var (
  52. // MainnetChainConfig is the chain parameters to run a node on the main network.
  53. MainnetChainConfig = &ChainConfig{
  54. ChainID: big.NewInt(1),
  55. HomesteadBlock: big.NewInt(1_150_000),
  56. DAOForkBlock: big.NewInt(1_920_000),
  57. DAOForkSupport: true,
  58. EIP150Block: big.NewInt(2_463_000),
  59. EIP150Hash: common.HexToHash("0x2086799aeebeae135c246c65021c82b4e15a2c451340993aacfd2751886514f0"),
  60. EIP155Block: big.NewInt(2_675_000),
  61. EIP158Block: big.NewInt(2_675_000),
  62. ByzantiumBlock: big.NewInt(4_370_000),
  63. ConstantinopleBlock: big.NewInt(7_280_000),
  64. PetersburgBlock: big.NewInt(7_280_000),
  65. IstanbulBlock: big.NewInt(9_069_000),
  66. MuirGlacierBlock: big.NewInt(9_200_000),
  67. BerlinBlock: big.NewInt(12_244_000),
  68. Ethash: new(EthashConfig),
  69. }
  70. // MainnetTrustedCheckpoint contains the light client trusted checkpoint for the main network.
  71. MainnetTrustedCheckpoint = &TrustedCheckpoint{
  72. SectionIndex: 371,
  73. SectionHead: common.HexToHash("0x50fd3cec5376ede90ef9129772022690cd1467f22c18abb7faa11e793c51e9c9"),
  74. CHTRoot: common.HexToHash("0xb57b4b22a77b5930847b1ca9f62daa11eae6578948cb7b18997f2c0fe5757025"),
  75. BloomRoot: common.HexToHash("0xa338f8a868a194fa90327d0f5877f656a9f3640c618d2a01a01f2e76ef9ef954"),
  76. }
  77. // MainnetCheckpointOracle contains a set of configs for the main network oracle.
  78. MainnetCheckpointOracle = &CheckpointOracleConfig{
  79. Address: common.HexToAddress("0x9a9070028361F7AAbeB3f2F2Dc07F82C4a98A02a"),
  80. Signers: []common.Address{
  81. common.HexToAddress("0x1b2C260efc720BE89101890E4Db589b44E950527"), // Peter
  82. common.HexToAddress("0x78d1aD571A1A09D60D9BBf25894b44e4C8859595"), // Martin
  83. common.HexToAddress("0x286834935f4A8Cfb4FF4C77D5770C2775aE2b0E7"), // Zsolt
  84. common.HexToAddress("0xb86e2B0Ab5A4B1373e40c51A7C712c70Ba2f9f8E"), // Gary
  85. common.HexToAddress("0x0DF8fa387C602AE62559cC4aFa4972A7045d6707"), // Guillaume
  86. },
  87. Threshold: 2,
  88. }
  89. // RopstenChainConfig contains the chain parameters to run a node on the Ropsten test network.
  90. RopstenChainConfig = &ChainConfig{
  91. ChainID: big.NewInt(3),
  92. HomesteadBlock: big.NewInt(0),
  93. DAOForkBlock: nil,
  94. DAOForkSupport: true,
  95. EIP150Block: big.NewInt(0),
  96. EIP150Hash: common.HexToHash("0x41941023680923e0fe4d74a34bdac8141f2540e3ae90623718e47d66d1ca4a2d"),
  97. EIP155Block: big.NewInt(10),
  98. EIP158Block: big.NewInt(10),
  99. ByzantiumBlock: big.NewInt(1_700_000),
  100. ConstantinopleBlock: big.NewInt(4_230_000),
  101. PetersburgBlock: big.NewInt(4_939_394),
  102. IstanbulBlock: big.NewInt(6_485_846),
  103. MuirGlacierBlock: big.NewInt(7_117_117),
  104. BerlinBlock: big.NewInt(9_812_189),
  105. Ethash: new(EthashConfig),
  106. }
  107. // RopstenTrustedCheckpoint contains the light client trusted checkpoint for the Ropsten test network.
  108. RopstenTrustedCheckpoint = &TrustedCheckpoint{
  109. SectionIndex: 279,
  110. SectionHead: common.HexToHash("0x4a4912848d4c06090097073357c10015d11c6f4544a0f93cbdd584701c3b7d58"),
  111. CHTRoot: common.HexToHash("0x9053b7867ae921e80a4e2f5a4b15212e4af3d691ca712fb33dc150e9c6ea221c"),
  112. BloomRoot: common.HexToHash("0x3dc04cb1be7ddc271f3f83469b47b76184a79d7209ef51d85b1539ea6d25a645"),
  113. }
  114. // RopstenCheckpointOracle contains a set of configs for the Ropsten test network oracle.
  115. RopstenCheckpointOracle = &CheckpointOracleConfig{
  116. Address: common.HexToAddress("0xEF79475013f154E6A65b54cB2742867791bf0B84"),
  117. Signers: []common.Address{
  118. common.HexToAddress("0x32162F3581E88a5f62e8A61892B42C46E2c18f7b"), // Peter
  119. common.HexToAddress("0x78d1aD571A1A09D60D9BBf25894b44e4C8859595"), // Martin
  120. common.HexToAddress("0x286834935f4A8Cfb4FF4C77D5770C2775aE2b0E7"), // Zsolt
  121. common.HexToAddress("0xb86e2B0Ab5A4B1373e40c51A7C712c70Ba2f9f8E"), // Gary
  122. common.HexToAddress("0x0DF8fa387C602AE62559cC4aFa4972A7045d6707"), // Guillaume
  123. },
  124. Threshold: 2,
  125. }
  126. // RinkebyChainConfig contains the chain parameters to run a node on the Rinkeby test network.
  127. RinkebyChainConfig = &ChainConfig{
  128. ChainID: big.NewInt(4),
  129. HomesteadBlock: big.NewInt(1),
  130. DAOForkBlock: nil,
  131. DAOForkSupport: true,
  132. EIP150Block: big.NewInt(2),
  133. EIP150Hash: common.HexToHash("0x9b095b36c15eaf13044373aef8ee0bd3a382a5abb92e402afa44b8249c3a90e9"),
  134. EIP155Block: big.NewInt(3),
  135. EIP158Block: big.NewInt(3),
  136. ByzantiumBlock: big.NewInt(1_035_301),
  137. ConstantinopleBlock: big.NewInt(3_660_663),
  138. PetersburgBlock: big.NewInt(4_321_234),
  139. IstanbulBlock: big.NewInt(5_435_345),
  140. MuirGlacierBlock: nil,
  141. BerlinBlock: big.NewInt(8_290_928),
  142. Clique: &CliqueConfig{
  143. Period: 15,
  144. Epoch: 30000,
  145. },
  146. }
  147. // RinkebyTrustedCheckpoint contains the light client trusted checkpoint for the Rinkeby test network.
  148. RinkebyTrustedCheckpoint = &TrustedCheckpoint{
  149. SectionIndex: 254,
  150. SectionHead: common.HexToHash("0x0cba01dd71baa22ac8fa0b105bc908e94f9ecfbc79b4eb97427fe07b5851dd10"),
  151. CHTRoot: common.HexToHash("0x5673d8fc49c9c7d8729068640e4b392d46952a5a38798973bac1cf1d0d27ad7d"),
  152. BloomRoot: common.HexToHash("0x70e01232b66df9a7778ae3291c9217afb9a2d9f799f32d7b912bd37e7bce83a8"),
  153. }
  154. // RinkebyCheckpointOracle contains a set of configs for the Rinkeby test network oracle.
  155. RinkebyCheckpointOracle = &CheckpointOracleConfig{
  156. Address: common.HexToAddress("0xebe8eFA441B9302A0d7eaECc277c09d20D684540"),
  157. Signers: []common.Address{
  158. common.HexToAddress("0xd9c9cd5f6779558b6e0ed4e6acf6b1947e7fa1f3"), // Peter
  159. common.HexToAddress("0x78d1aD571A1A09D60D9BBf25894b44e4C8859595"), // Martin
  160. common.HexToAddress("0x286834935f4A8Cfb4FF4C77D5770C2775aE2b0E7"), // Zsolt
  161. common.HexToAddress("0xb86e2B0Ab5A4B1373e40c51A7C712c70Ba2f9f8E"), // Gary
  162. },
  163. Threshold: 2,
  164. }
  165. // GoerliChainConfig contains the chain parameters to run a node on the Görli test network.
  166. GoerliChainConfig = &ChainConfig{
  167. ChainID: big.NewInt(5),
  168. HomesteadBlock: big.NewInt(0),
  169. DAOForkBlock: nil,
  170. DAOForkSupport: true,
  171. EIP150Block: big.NewInt(0),
  172. EIP155Block: big.NewInt(0),
  173. EIP158Block: big.NewInt(0),
  174. ByzantiumBlock: big.NewInt(0),
  175. ConstantinopleBlock: big.NewInt(0),
  176. PetersburgBlock: big.NewInt(0),
  177. IstanbulBlock: big.NewInt(1_561_651),
  178. MuirGlacierBlock: nil,
  179. BerlinBlock: big.NewInt(4_460_644),
  180. Clique: &CliqueConfig{
  181. Period: 15,
  182. Epoch: 30000,
  183. },
  184. }
  185. // GoerliTrustedCheckpoint contains the light client trusted checkpoint for the Görli test network.
  186. GoerliTrustedCheckpoint = &TrustedCheckpoint{
  187. SectionIndex: 138,
  188. SectionHead: common.HexToHash("0xb7ea0566abd7d0def5b3c9afa3431debb7bb30b65af35f106ca93a59e6c859a7"),
  189. CHTRoot: common.HexToHash("0x378c7ea9081242beb982e2e39567ba12f2ed3e59e5aba3f9db1d595646d7c9f4"),
  190. BloomRoot: common.HexToHash("0x523c169286cfca52e8a6579d8c35dc8bf093412d8a7478163bfa81ae91c2492d"),
  191. }
  192. // GoerliCheckpointOracle contains a set of configs for the Goerli test network oracle.
  193. GoerliCheckpointOracle = &CheckpointOracleConfig{
  194. Address: common.HexToAddress("0x18CA0E045F0D772a851BC7e48357Bcaab0a0795D"),
  195. Signers: []common.Address{
  196. common.HexToAddress("0x4769bcaD07e3b938B7f43EB7D278Bc7Cb9efFb38"), // Peter
  197. common.HexToAddress("0x78d1aD571A1A09D60D9BBf25894b44e4C8859595"), // Martin
  198. common.HexToAddress("0x286834935f4A8Cfb4FF4C77D5770C2775aE2b0E7"), // Zsolt
  199. common.HexToAddress("0xb86e2B0Ab5A4B1373e40c51A7C712c70Ba2f9f8E"), // Gary
  200. common.HexToAddress("0x0DF8fa387C602AE62559cC4aFa4972A7045d6707"), // Guillaume
  201. },
  202. Threshold: 2,
  203. }
  204. BSCChainConfig = &ChainConfig{
  205. ChainID: big.NewInt(56),
  206. HomesteadBlock: big.NewInt(0),
  207. EIP150Block: big.NewInt(0),
  208. EIP155Block: big.NewInt(0),
  209. EIP158Block: big.NewInt(0),
  210. ByzantiumBlock: big.NewInt(0),
  211. ConstantinopleBlock: big.NewInt(0),
  212. PetersburgBlock: big.NewInt(0),
  213. IstanbulBlock: big.NewInt(0),
  214. MuirGlacierBlock: big.NewInt(0),
  215. RamanujanBlock: big.NewInt(0),
  216. NielsBlock: big.NewInt(0),
  217. MirrorSyncBlock: big.NewInt(5184000),
  218. Parlia: &ParliaConfig{
  219. Period: 3,
  220. Epoch: 200,
  221. },
  222. }
  223. ChapelChainConfig = &ChainConfig{
  224. ChainID: big.NewInt(97),
  225. HomesteadBlock: big.NewInt(0),
  226. EIP150Block: big.NewInt(0),
  227. EIP155Block: big.NewInt(0),
  228. EIP158Block: big.NewInt(0),
  229. ByzantiumBlock: big.NewInt(0),
  230. ConstantinopleBlock: big.NewInt(0),
  231. PetersburgBlock: big.NewInt(0),
  232. IstanbulBlock: big.NewInt(0),
  233. MuirGlacierBlock: big.NewInt(0),
  234. RamanujanBlock: big.NewInt(1010000),
  235. NielsBlock: big.NewInt(1014369),
  236. MirrorSyncBlock: big.NewInt(5582500),
  237. Parlia: &ParliaConfig{
  238. Period: 3,
  239. Epoch: 200,
  240. },
  241. }
  242. RialtoChainConfig = &ChainConfig{
  243. ChainID: big.NewInt(1417),
  244. HomesteadBlock: big.NewInt(0),
  245. EIP150Block: big.NewInt(0),
  246. EIP155Block: big.NewInt(0),
  247. EIP158Block: big.NewInt(0),
  248. ByzantiumBlock: big.NewInt(0),
  249. ConstantinopleBlock: big.NewInt(0),
  250. PetersburgBlock: big.NewInt(0),
  251. IstanbulBlock: big.NewInt(0),
  252. MuirGlacierBlock: big.NewInt(0),
  253. RamanujanBlock: big.NewInt(400),
  254. NielsBlock: big.NewInt(0),
  255. MirrorSyncBlock: big.NewInt(400),
  256. Parlia: &ParliaConfig{
  257. Period: 3,
  258. Epoch: 200,
  259. },
  260. }
  261. // YoloV3ChainConfig contains the chain parameters to run a node on the YOLOv3 test network.
  262. YoloV3ChainConfig = &ChainConfig{
  263. ChainID: new(big.Int).SetBytes([]byte("yolov3x")),
  264. HomesteadBlock: big.NewInt(0),
  265. DAOForkBlock: nil,
  266. DAOForkSupport: true,
  267. EIP150Block: big.NewInt(0),
  268. EIP155Block: big.NewInt(0),
  269. EIP158Block: big.NewInt(0),
  270. ByzantiumBlock: big.NewInt(0),
  271. ConstantinopleBlock: big.NewInt(0),
  272. PetersburgBlock: big.NewInt(0),
  273. IstanbulBlock: big.NewInt(0),
  274. MuirGlacierBlock: nil,
  275. BerlinBlock: nil, // Don't enable Berlin directly, we're YOLOing it
  276. YoloV3Block: big.NewInt(0),
  277. Clique: &CliqueConfig{
  278. Period: 15,
  279. Epoch: 30000,
  280. },
  281. }
  282. // AllEthashProtocolChanges contains every protocol change (EIPs) introduced
  283. // and accepted by the Ethereum core developers into the Ethash consensus.
  284. //
  285. // This configuration is intentionally not using keyed fields to force anyone
  286. // adding flags to the config to also have to set these fields.
  287. 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), big.NewInt(0), big.NewInt(0), big.NewInt(0), nil, nil, nil,nil, nil, nil, new(EthashConfig), nil, nil}
  288. // AllCliqueProtocolChanges contains every protocol change (EIPs) introduced
  289. // and accepted by the Ethereum core developers into the Clique consensus.
  290. //
  291. // This configuration is intentionally not using keyed fields to force anyone
  292. // adding flags to the config to also have to set these fields.
  293. 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), big.NewInt(0), big.NewInt(0), big.NewInt(0), nil, nil, nil, nil, nil, nil, nil, &CliqueConfig{Period: 0, Epoch: 30000}, nil}
  294. 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), big.NewInt(0), big.NewInt(0), big.NewInt(0), nil, nil, nil, nil,nil, nil, new(EthashConfig), nil, nil}
  295. TestRules = TestChainConfig.Rules(new(big.Int))
  296. )
  297. // TrustedCheckpoint represents a set of post-processed trie roots (CHT and
  298. // BloomTrie) associated with the appropriate section index and head hash. It is
  299. // used to start light syncing from this checkpoint and avoid downloading the
  300. // entire header chain while still being able to securely access old headers/logs.
  301. type TrustedCheckpoint struct {
  302. SectionIndex uint64 `json:"sectionIndex"`
  303. SectionHead common.Hash `json:"sectionHead"`
  304. CHTRoot common.Hash `json:"chtRoot"`
  305. BloomRoot common.Hash `json:"bloomRoot"`
  306. }
  307. // HashEqual returns an indicator comparing the itself hash with given one.
  308. func (c *TrustedCheckpoint) HashEqual(hash common.Hash) bool {
  309. if c.Empty() {
  310. return hash == common.Hash{}
  311. }
  312. return c.Hash() == hash
  313. }
  314. // Hash returns the hash of checkpoint's four key fields(index, sectionHead, chtRoot and bloomTrieRoot).
  315. func (c *TrustedCheckpoint) Hash() common.Hash {
  316. var sectionIndex [8]byte
  317. binary.BigEndian.PutUint64(sectionIndex[:], c.SectionIndex)
  318. w := sha3.NewLegacyKeccak256()
  319. w.Write(sectionIndex[:])
  320. w.Write(c.SectionHead[:])
  321. w.Write(c.CHTRoot[:])
  322. w.Write(c.BloomRoot[:])
  323. var h common.Hash
  324. w.Sum(h[:0])
  325. return h
  326. }
  327. // Empty returns an indicator whether the checkpoint is regarded as empty.
  328. func (c *TrustedCheckpoint) Empty() bool {
  329. return c.SectionHead == (common.Hash{}) || c.CHTRoot == (common.Hash{}) || c.BloomRoot == (common.Hash{})
  330. }
  331. // CheckpointOracleConfig represents a set of checkpoint contract(which acts as an oracle)
  332. // config which used for light client checkpoint syncing.
  333. type CheckpointOracleConfig struct {
  334. Address common.Address `json:"address"`
  335. Signers []common.Address `json:"signers"`
  336. Threshold uint64 `json:"threshold"`
  337. }
  338. // ChainConfig is the core config which determines the blockchain settings.
  339. //
  340. // ChainConfig is stored in the database on a per block basis. This means
  341. // that any network, identified by its genesis block, can have its own
  342. // set of configuration options.
  343. type ChainConfig struct {
  344. ChainID *big.Int `json:"chainId"` // chainId identifies the current chain and is used for replay protection
  345. HomesteadBlock *big.Int `json:"homesteadBlock,omitempty" toml:",omitempty"` // Homestead switch block (nil = no fork, 0 = already homestead)
  346. DAOForkBlock *big.Int `json:"daoForkBlock,omitempty" toml:",omitempty"` // TheDAO hard-fork switch block (nil = no fork)
  347. DAOForkSupport bool `json:"daoForkSupport,omitempty" toml:",omitempty"` // Whether the nodes supports or opposes the DAO hard-fork
  348. // EIP150 implements the Gas price changes (https://github.com/ethereum/EIPs/issues/150)
  349. EIP150Block *big.Int `json:"eip150Block,omitempty"` // EIP150 HF block (nil = no fork)
  350. EIP150Hash common.Hash `json:"eip150Hash,omitempty"` // EIP150 HF hash (needed for header only clients as only gas pricing changed)
  351. EIP155Block *big.Int `json:"eip155Block,omitempty"` // EIP155 HF block
  352. EIP158Block *big.Int `json:"eip158Block,omitempty"` // EIP158 HF block
  353. ByzantiumBlock *big.Int `json:"byzantiumBlock,omitempty"` // Byzantium switch block (nil = no fork, 0 = already on byzantium)
  354. ConstantinopleBlock *big.Int `json:"constantinopleBlock,omitempty"` // Constantinople switch block (nil = no fork, 0 = already activated)
  355. PetersburgBlock *big.Int `json:"petersburgBlock,omitempty"` // Petersburg switch block (nil = same as Constantinople)
  356. IstanbulBlock *big.Int `json:"istanbulBlock,omitempty"` // Istanbul switch block (nil = no fork, 0 = already on istanbul)
  357. MuirGlacierBlock *big.Int `json:"muirGlacierBlock,omitempty"` // Eip-2384 (bomb delay) switch block (nil = no fork, 0 = already activated)
  358. BerlinBlock *big.Int `json:"berlinBlock,omitempty"` // Berlin switch block (nil = no fork, 0 = already on berlin)
  359. YoloV3Block *big.Int `json:"yoloV3Block,omitempty"` // YOLO v3: Gas repricings TODO @holiman add EIP references
  360. EWASMBlock *big.Int `json:"ewasmBlock,omitempty"` // EWASM switch block (nil = no fork, 0 = already activated) RamanujanBlock *big.Int `json:"ramanujanBlock,omitempty" toml:",omitempty"` // ramanujanBlock switch block (nil = no fork, 0 = already activated)
  361. CatalystBlock *big.Int `json:"catalystBlock,omitempty"` // Catalyst switch block (nil = no fork, 0 = already on catalyst)
  362. RamanujanBlock *big.Int `json:"ramanujanBlock,omitempty" toml:",omitempty"` // ramanujanBlock switch block (nil = no fork, 0 = already activated)
  363. NielsBlock *big.Int `json:"nielsBlock,omitempty" toml:",omitempty"` // nielsBlock switch block (nil = no fork, 0 = already activated)
  364. MirrorSyncBlock *big.Int `json:"mirrorSyncBlock,omitempty" toml:",omitempty"` // mirrorSyncBlock switch block (nil = no fork, 0 = already activated)
  365. // Various consensus engines
  366. Ethash *EthashConfig `json:"ethash,omitempty" toml:",omitempty"`
  367. Clique *CliqueConfig `json:"clique,omitempty" toml:",omitempty"`
  368. Parlia *ParliaConfig `json:"parlia,omitempty" toml:",omitempty"`
  369. }
  370. // EthashConfig is the consensus engine configs for proof-of-work based sealing.
  371. type EthashConfig struct{}
  372. // String implements the stringer interface, returning the consensus engine details.
  373. func (c *EthashConfig) String() string {
  374. return "ethash"
  375. }
  376. // CliqueConfig is the consensus engine configs for proof-of-authority based sealing.
  377. type CliqueConfig struct {
  378. Period uint64 `json:"period"` // Number of seconds between blocks to enforce
  379. Epoch uint64 `json:"epoch"` // Epoch length to reset votes and checkpoint
  380. }
  381. // String implements the stringer interface, returning the consensus engine details.
  382. func (c *CliqueConfig) String() string {
  383. return "clique"
  384. }
  385. // ParliaConfig is the consensus engine configs for proof-of-staked-authority based sealing.
  386. type ParliaConfig struct {
  387. Period uint64 `json:"period"` // Number of seconds between blocks to enforce
  388. Epoch uint64 `json:"epoch"` // Epoch length to update validatorSet
  389. }
  390. // String implements the stringer interface, returning the consensus engine details.
  391. func (b *ParliaConfig) String() string {
  392. return "parlia"
  393. }
  394. // String implements the fmt.Stringer interface.
  395. func (c *ChainConfig) String() string {
  396. var engine interface{}
  397. switch {
  398. case c.Ethash != nil:
  399. engine = c.Ethash
  400. case c.Clique != nil:
  401. engine = c.Clique
  402. case c.Parlia != nil:
  403. engine = c.Parlia
  404. default:
  405. engine = "unknown"
  406. }
  407. return fmt.Sprintf("{ChainID: %v Homestead: %v DAO: %v DAOSupport: %v EIP150: %v EIP155: %v EIP158: %v Byzantium: %v Constantinople: %v Petersburg: %v Istanbul: %v, Muir Glacier: %v, Ramanujan: %v, Niels: %v, MirrorSync: %v, Berlin: %v, YOLO v3: %v, Engine: %v}",
  408. c.ChainID,
  409. c.HomesteadBlock,
  410. c.DAOForkBlock,
  411. c.DAOForkSupport,
  412. c.EIP150Block,
  413. c.EIP155Block,
  414. c.EIP158Block,
  415. c.ByzantiumBlock,
  416. c.ConstantinopleBlock,
  417. c.PetersburgBlock,
  418. c.IstanbulBlock,
  419. c.MuirGlacierBlock,
  420. c.RamanujanBlock,
  421. c.NielsBlock,
  422. c.MirrorSyncBlock,
  423. c.BerlinBlock,
  424. c.YoloV3Block,
  425. engine,
  426. )
  427. }
  428. // IsHomestead returns whether num is either equal to the homestead block or greater.
  429. func (c *ChainConfig) IsHomestead(num *big.Int) bool {
  430. return isForked(c.HomesteadBlock, num)
  431. }
  432. // IsDAOFork returns whether num is either equal to the DAO fork block or greater.
  433. func (c *ChainConfig) IsDAOFork(num *big.Int) bool {
  434. return isForked(c.DAOForkBlock, num)
  435. }
  436. // IsEIP150 returns whether num is either equal to the EIP150 fork block or greater.
  437. func (c *ChainConfig) IsEIP150(num *big.Int) bool {
  438. return isForked(c.EIP150Block, num)
  439. }
  440. // IsEIP155 returns whether num is either equal to the EIP155 fork block or greater.
  441. func (c *ChainConfig) IsEIP155(num *big.Int) bool {
  442. return isForked(c.EIP155Block, num)
  443. }
  444. // IsEIP158 returns whether num is either equal to the EIP158 fork block or greater.
  445. func (c *ChainConfig) IsEIP158(num *big.Int) bool {
  446. return isForked(c.EIP158Block, num)
  447. }
  448. // IsByzantium returns whether num is either equal to the Byzantium fork block or greater.
  449. func (c *ChainConfig) IsByzantium(num *big.Int) bool {
  450. return isForked(c.ByzantiumBlock, num)
  451. }
  452. // IsConstantinople returns whether num is either equal to the Constantinople fork block or greater.
  453. func (c *ChainConfig) IsConstantinople(num *big.Int) bool {
  454. return isForked(c.ConstantinopleBlock, num)
  455. }
  456. // IsRamanujan returns whether num is either equal to the IsRamanujan fork block or greater.
  457. func (c *ChainConfig) IsRamanujan(num *big.Int) bool {
  458. return isForked(c.RamanujanBlock, num)
  459. }
  460. // IsOnRamanujan returns whether num is equal to the Ramanujan fork block
  461. func (c *ChainConfig) IsOnRamanujan(num *big.Int) bool {
  462. return configNumEqual(c.RamanujanBlock, num)
  463. }
  464. // IsNiels returns whether num is either equal to the Niels fork block or greater.
  465. func (c *ChainConfig) IsNiels(num *big.Int) bool {
  466. return isForked(c.NielsBlock, num)
  467. }
  468. // IsOnNiels returns whether num is equal to the IsNiels fork block
  469. func (c *ChainConfig) IsOnNiels(num *big.Int) bool {
  470. return configNumEqual(c.NielsBlock, num)
  471. }
  472. // IsMirrorSync returns whether num is either equal to the MirrorSync fork block or greater.
  473. func (c *ChainConfig) IsMirrorSync(num *big.Int) bool {
  474. return isForked(c.MirrorSyncBlock, num)
  475. }
  476. // IsOnMirrorSync returns whether num is equal to the MirrorSync fork block
  477. func (c *ChainConfig) IsOnMirrorSync(num *big.Int) bool {
  478. return configNumEqual(c.MirrorSyncBlock, num)
  479. }
  480. // IsMuirGlacier returns whether num is either equal to the Muir Glacier (EIP-2384) fork block or greater.
  481. func (c *ChainConfig) IsMuirGlacier(num *big.Int) bool {
  482. return isForked(c.MuirGlacierBlock, num)
  483. }
  484. // IsPetersburg returns whether num is either
  485. // - equal to or greater than the PetersburgBlock fork block,
  486. // - OR is nil, and Constantinople is active
  487. func (c *ChainConfig) IsPetersburg(num *big.Int) bool {
  488. return isForked(c.PetersburgBlock, num) || c.PetersburgBlock == nil && isForked(c.ConstantinopleBlock, num)
  489. }
  490. // IsIstanbul returns whether num is either equal to the Istanbul fork block or greater.
  491. func (c *ChainConfig) IsIstanbul(num *big.Int) bool {
  492. return isForked(c.IstanbulBlock, num)
  493. }
  494. // IsBerlin returns whether num is either equal to the Berlin fork block or greater.
  495. func (c *ChainConfig) IsBerlin(num *big.Int) bool {
  496. return isForked(c.BerlinBlock, num) || isForked(c.YoloV3Block, num)
  497. }
  498. // IsCatalyst returns whether num is either equal to the Merge fork block or greater.
  499. func (c *ChainConfig) IsCatalyst(num *big.Int) bool {
  500. return isForked(c.CatalystBlock, num)
  501. }
  502. // IsEWASM returns whether num represents a block number after the EWASM fork
  503. func (c *ChainConfig) IsEWASM(num *big.Int) bool {
  504. return isForked(c.EWASMBlock, num)
  505. }
  506. // CheckCompatible checks whether scheduled fork transitions have been imported
  507. // with a mismatching chain configuration.
  508. func (c *ChainConfig) CheckCompatible(newcfg *ChainConfig, height uint64) *ConfigCompatError {
  509. bhead := new(big.Int).SetUint64(height)
  510. // Iterate checkCompatible to find the lowest conflict.
  511. var lasterr *ConfigCompatError
  512. for {
  513. err := c.checkCompatible(newcfg, bhead)
  514. if err == nil || (lasterr != nil && err.RewindTo == lasterr.RewindTo) {
  515. break
  516. }
  517. lasterr = err
  518. bhead.SetUint64(err.RewindTo)
  519. }
  520. return lasterr
  521. }
  522. // CheckConfigForkOrder checks that we don't "skip" any forks, geth isn't pluggable enough
  523. // to guarantee that forks can be implemented in a different order than on official networks
  524. func (c *ChainConfig) CheckConfigForkOrder() error {
  525. type fork struct {
  526. name string
  527. block *big.Int
  528. optional bool // if true, the fork may be nil and next fork is still allowed
  529. }
  530. var lastFork fork
  531. for _, cur := range []fork{
  532. {name: "homesteadBlock", block: c.HomesteadBlock},
  533. {name: "daoForkBlock", block: c.DAOForkBlock, optional: true},
  534. {name: "eip150Block", block: c.EIP150Block},
  535. {name: "eip155Block", block: c.EIP155Block},
  536. {name: "eip158Block", block: c.EIP158Block},
  537. {name: "byzantiumBlock", block: c.ByzantiumBlock},
  538. {name: "constantinopleBlock", block: c.ConstantinopleBlock},
  539. {name: "petersburgBlock", block: c.PetersburgBlock},
  540. {name: "istanbulBlock", block: c.IstanbulBlock},
  541. {name: "muirGlacierBlock", block: c.MuirGlacierBlock, optional: true},
  542. {name: "ramanujanBlock", block: c.RamanujanBlock},
  543. {name: "mirrorSyncBlock", block: c.MirrorSyncBlock},
  544. {name: "berlinBlock", block: c.BerlinBlock},
  545. } {
  546. if lastFork.name != "" {
  547. // Next one must be higher number
  548. if lastFork.block == nil && cur.block != nil {
  549. return fmt.Errorf("unsupported fork ordering: %v not enabled, but %v enabled at %v",
  550. lastFork.name, cur.name, cur.block)
  551. }
  552. if lastFork.block != nil && cur.block != nil {
  553. if lastFork.block.Cmp(cur.block) > 0 {
  554. return fmt.Errorf("unsupported fork ordering: %v enabled at %v, but %v enabled at %v",
  555. lastFork.name, lastFork.block, cur.name, cur.block)
  556. }
  557. }
  558. }
  559. // If it was optional and not set, then ignore it
  560. if !cur.optional || cur.block != nil {
  561. lastFork = cur
  562. }
  563. }
  564. return nil
  565. }
  566. func (c *ChainConfig) checkCompatible(newcfg *ChainConfig, head *big.Int) *ConfigCompatError {
  567. if isForkIncompatible(c.HomesteadBlock, newcfg.HomesteadBlock, head) {
  568. return newCompatError("Homestead fork block", c.HomesteadBlock, newcfg.HomesteadBlock)
  569. }
  570. if isForkIncompatible(c.DAOForkBlock, newcfg.DAOForkBlock, head) {
  571. return newCompatError("DAO fork block", c.DAOForkBlock, newcfg.DAOForkBlock)
  572. }
  573. if c.IsDAOFork(head) && c.DAOForkSupport != newcfg.DAOForkSupport {
  574. return newCompatError("DAO fork support flag", c.DAOForkBlock, newcfg.DAOForkBlock)
  575. }
  576. if isForkIncompatible(c.EIP150Block, newcfg.EIP150Block, head) {
  577. return newCompatError("EIP150 fork block", c.EIP150Block, newcfg.EIP150Block)
  578. }
  579. if isForkIncompatible(c.EIP155Block, newcfg.EIP155Block, head) {
  580. return newCompatError("EIP155 fork block", c.EIP155Block, newcfg.EIP155Block)
  581. }
  582. if isForkIncompatible(c.EIP158Block, newcfg.EIP158Block, head) {
  583. return newCompatError("EIP158 fork block", c.EIP158Block, newcfg.EIP158Block)
  584. }
  585. if c.IsEIP158(head) && !configNumEqual(c.ChainID, newcfg.ChainID) {
  586. return newCompatError("EIP158 chain ID", c.EIP158Block, newcfg.EIP158Block)
  587. }
  588. if isForkIncompatible(c.ByzantiumBlock, newcfg.ByzantiumBlock, head) {
  589. return newCompatError("Byzantium fork block", c.ByzantiumBlock, newcfg.ByzantiumBlock)
  590. }
  591. if isForkIncompatible(c.ConstantinopleBlock, newcfg.ConstantinopleBlock, head) {
  592. return newCompatError("Constantinople fork block", c.ConstantinopleBlock, newcfg.ConstantinopleBlock)
  593. }
  594. if isForkIncompatible(c.PetersburgBlock, newcfg.PetersburgBlock, head) {
  595. // the only case where we allow Petersburg to be set in the past is if it is equal to Constantinople
  596. // mainly to satisfy fork ordering requirements which state that Petersburg fork be set if Constantinople fork is set
  597. if isForkIncompatible(c.ConstantinopleBlock, newcfg.PetersburgBlock, head) {
  598. return newCompatError("Petersburg fork block", c.PetersburgBlock, newcfg.PetersburgBlock)
  599. }
  600. }
  601. if isForkIncompatible(c.IstanbulBlock, newcfg.IstanbulBlock, head) {
  602. return newCompatError("Istanbul fork block", c.IstanbulBlock, newcfg.IstanbulBlock)
  603. }
  604. if isForkIncompatible(c.MuirGlacierBlock, newcfg.MuirGlacierBlock, head) {
  605. return newCompatError("Muir Glacier fork block", c.MuirGlacierBlock, newcfg.MuirGlacierBlock)
  606. }
  607. if isForkIncompatible(c.BerlinBlock, newcfg.BerlinBlock, head) {
  608. return newCompatError("Berlin fork block", c.BerlinBlock, newcfg.BerlinBlock)
  609. }
  610. if isForkIncompatible(c.YoloV3Block, newcfg.YoloV3Block, head) {
  611. return newCompatError("YOLOv3 fork block", c.YoloV3Block, newcfg.YoloV3Block)
  612. }
  613. if isForkIncompatible(c.EWASMBlock, newcfg.EWASMBlock, head) {
  614. return newCompatError("ewasm fork block", c.EWASMBlock, newcfg.EWASMBlock)
  615. }
  616. if isForkIncompatible(c.RamanujanBlock, newcfg.RamanujanBlock, head) {
  617. return newCompatError("ramanujan fork block", c.RamanujanBlock, newcfg.RamanujanBlock)
  618. }
  619. if isForkIncompatible(c.MirrorSyncBlock, newcfg.MirrorSyncBlock, head) {
  620. return newCompatError("mirrorSync fork block", c.MirrorSyncBlock, newcfg.MirrorSyncBlock)
  621. }
  622. return nil
  623. }
  624. // isForkIncompatible returns true if a fork scheduled at s1 cannot be rescheduled to
  625. // block s2 because head is already past the fork.
  626. func isForkIncompatible(s1, s2, head *big.Int) bool {
  627. return (isForked(s1, head) || isForked(s2, head)) && !configNumEqual(s1, s2)
  628. }
  629. // isForked returns whether a fork scheduled at block s is active at the given head block.
  630. func isForked(s, head *big.Int) bool {
  631. if s == nil || head == nil {
  632. return false
  633. }
  634. return s.Cmp(head) <= 0
  635. }
  636. func configNumEqual(x, y *big.Int) bool {
  637. if x == nil {
  638. return y == nil
  639. }
  640. if y == nil {
  641. return x == nil
  642. }
  643. return x.Cmp(y) == 0
  644. }
  645. // ConfigCompatError is raised if the locally-stored blockchain is initialised with a
  646. // ChainConfig that would alter the past.
  647. type ConfigCompatError struct {
  648. What string
  649. // block numbers of the stored and new configurations
  650. StoredConfig, NewConfig *big.Int
  651. // the block number to which the local chain must be rewound to correct the error
  652. RewindTo uint64
  653. }
  654. func newCompatError(what string, storedblock, newblock *big.Int) *ConfigCompatError {
  655. var rew *big.Int
  656. switch {
  657. case storedblock == nil:
  658. rew = newblock
  659. case newblock == nil || storedblock.Cmp(newblock) < 0:
  660. rew = storedblock
  661. default:
  662. rew = newblock
  663. }
  664. err := &ConfigCompatError{what, storedblock, newblock, 0}
  665. if rew != nil && rew.Sign() > 0 {
  666. err.RewindTo = rew.Uint64() - 1
  667. }
  668. return err
  669. }
  670. func (err *ConfigCompatError) Error() string {
  671. return fmt.Sprintf("mismatching %s in database (have %d, want %d, rewindto %d)", err.What, err.StoredConfig, err.NewConfig, err.RewindTo)
  672. }
  673. // Rules wraps ChainConfig and is merely syntactic sugar or can be used for functions
  674. // that do not have or require information about the block.
  675. //
  676. // Rules is a one time interface meaning that it shouldn't be used in between transition
  677. // phases.
  678. type Rules struct {
  679. ChainID *big.Int
  680. IsHomestead, IsEIP150, IsEIP155, IsEIP158 bool
  681. IsByzantium, IsConstantinople, IsPetersburg, IsIstanbul bool
  682. IsBerlin, IsCatalyst bool
  683. }
  684. // Rules ensures c's ChainID is not nil.
  685. func (c *ChainConfig) Rules(num *big.Int) Rules {
  686. chainID := c.ChainID
  687. if chainID == nil {
  688. chainID = new(big.Int)
  689. }
  690. return Rules{
  691. ChainID: new(big.Int).Set(chainID),
  692. IsHomestead: c.IsHomestead(num),
  693. IsEIP150: c.IsEIP150(num),
  694. IsEIP155: c.IsEIP155(num),
  695. IsEIP158: c.IsEIP158(num),
  696. IsByzantium: c.IsByzantium(num),
  697. IsConstantinople: c.IsConstantinople(num),
  698. IsPetersburg: c.IsPetersburg(num),
  699. IsIstanbul: c.IsIstanbul(num),
  700. IsBerlin: c.IsBerlin(num),
  701. IsCatalyst: c.IsCatalyst(num),
  702. }
  703. }