Ethereum Test Forks package¶
Ethereum test fork definitions.
Frontier
¶
Bases: BaseFork
Frontier fork
Source code in src/ethereum_test_forks/forks/forks.py
10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 | |
header_base_fee_required(block_number, timestamp)
classmethod
¶
At genesis, header must not contain base fee
Source code in src/ethereum_test_forks/forks/forks.py
15 16 17 18 19 20 | |
header_prev_randao_required(block_number, timestamp)
classmethod
¶
At genesis, header must not contain Prev Randao value
Source code in src/ethereum_test_forks/forks/forks.py
22 23 24 25 26 27 | |
header_zero_difficulty_required(block_number, timestamp)
classmethod
¶
At genesis, header must not have difficulty zero
Source code in src/ethereum_test_forks/forks/forks.py
29 30 31 32 33 34 | |
header_withdrawals_required(block_number, timestamp)
classmethod
¶
At genesis, header must not contain withdrawals
Source code in src/ethereum_test_forks/forks/forks.py
36 37 38 39 40 41 | |
header_excess_data_gas_required(block_number, timestamp)
classmethod
¶
At genesis, header must not contain excess data gas
Source code in src/ethereum_test_forks/forks/forks.py
43 44 45 46 47 48 | |
header_data_gas_used_required(block_number, timestamp)
classmethod
¶
At genesis, header must not contain data gas used
Source code in src/ethereum_test_forks/forks/forks.py
50 51 52 53 54 55 | |
engine_new_payload_version(block_number, timestamp)
classmethod
¶
At genesis, payloads cannot be sent through the engine API
Source code in src/ethereum_test_forks/forks/forks.py
57 58 59 60 61 62 | |
engine_new_payload_blob_hashes(block_number, timestamp)
classmethod
¶
At genesis, payloads do not have blob hashes.
Source code in src/ethereum_test_forks/forks/forks.py
64 65 66 67 68 69 | |
get_reward(block_number, timestamp)
classmethod
¶
At Genesis the expected reward amount in wei is 5_000_000_000_000_000_000
Source code in src/ethereum_test_forks/forks/forks.py
71 72 73 74 75 76 77 | |
BerlinToLondonAt5
¶
Bases: Berlin
Berlin to London transition at Block 5 fork
Source code in src/ethereum_test_forks/forks/transition.py
11 12 13 14 15 16 17 18 19 20 21 22 | |
header_base_fee_required(block_number, _)
classmethod
¶
Base Fee is required starting from London.
Source code in src/ethereum_test_forks/forks/transition.py
17 18 19 20 21 22 | |
InvalidForkError
¶
Bases: Exception
Invalid fork error raised when the fork specified by command-line option --latest-fork is not found.
Source code in src/ethereum_test_forks/helpers.py
11 12 13 14 15 16 17 18 | |
get_forks()
¶
Returns a list of all the fork classes implemented by
ethereum_test_forks ordered chronologically by deployment.
Source code in src/ethereum_test_forks/helpers.py
21 22 23 24 25 26 27 28 29 30 31 32 33 | |
MergeToShanghaiAtTime15k
¶
Bases: Merge
Merge to Shanghai transition at Timestamp 15k fork
Source code in src/ethereum_test_forks/forks/transition.py
25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 | |
header_withdrawals_required(_, timestamp)
classmethod
¶
Withdrawals are required starting from Shanghai.
Source code in src/ethereum_test_forks/forks/transition.py
31 32 33 34 35 36 | |
engine_new_payload_version(block_number, timestamp)
classmethod
¶
Starting at Shanghai, new payload calls must use version 2
Source code in src/ethereum_test_forks/forks/transition.py
38 39 40 41 42 43 | |
get_deployed_forks()
¶
Returns a list of all the fork classes implemented by ethereum_test_forks
that have been deployed to mainnet, chronologically ordered by deployment.
Source code in src/ethereum_test_forks/helpers.py
36 37 38 39 40 41 | |
get_development_forks()
¶
Returns a list of all the fork classes implemented by ethereum_test_forks
that have been not yet deployed to mainnet and are currently under
development. The list is ordered by their planned deployment date.
Source code in src/ethereum_test_forks/helpers.py
44 45 46 47 48 49 50 | |
ShanghaiToCancunAtTime15k
¶
Bases: Shanghai
Shanghai to Cancun transition at Timestamp 15k
Source code in src/ethereum_test_forks/forks/transition.py
46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 | |
header_excess_data_gas_required(_, timestamp)
classmethod
¶
Excess data gas is required if transitioning to Cancun.
Source code in src/ethereum_test_forks/forks/transition.py
52 53 54 55 56 57 | |
engine_new_payload_version(block_number, timestamp)
classmethod
¶
Starting at Cancun, new payload calls must use version 3
Source code in src/ethereum_test_forks/forks/transition.py
59 60 61 62 63 64 | |
engine_new_payload_blob_hashes(block_number, timestamp)
classmethod
¶
Starting at Cancun, payloads must have blob hashes.
Source code in src/ethereum_test_forks/forks/transition.py
66 67 68 69 70 71 | |
get_transition_forks()
¶
Returns all the transition forks
Source code in src/ethereum_test_forks/helpers.py
60 61 62 63 64 65 66 67 68 69 70 71 72 73 | |
transition_fork_from_to(fork_from, fork_to)
¶
Returns the transition fork that transitions to and from the specified forks.
Source code in src/ethereum_test_forks/helpers.py
76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 | |
Homestead
¶
Bases: Frontier
Homestead fork
Source code in src/ethereum_test_forks/forks/forks.py
80 81 82 83 84 85 | |
Byzantium
¶
Bases: Homestead
Byzantium fork
Source code in src/ethereum_test_forks/forks/forks.py
88 89 90 91 92 93 94 95 96 97 98 99 | |
get_reward(block_number, timestamp)
classmethod
¶
At Byzantium, the block reward is reduced to 3_000_000_000_000_000_000 wei
Source code in src/ethereum_test_forks/forks/forks.py
93 94 95 96 97 98 99 | |
transition_fork_to(fork_to)
¶
Returns the transition fork that transitions to the specified fork.
Source code in src/ethereum_test_forks/helpers.py
93 94 95 96 97 98 99 100 101 102 103 104 | |
Constantinople
¶
Bases: Byzantium
Constantinople fork
Source code in src/ethereum_test_forks/forks/forks.py
102 103 104 105 106 107 108 109 110 111 112 113 | |
get_reward(block_number, timestamp)
classmethod
¶
At Constantinople, the block reward is reduced to 2_000_000_000_000_000_000 wei
Source code in src/ethereum_test_forks/forks/forks.py
107 108 109 110 111 112 113 | |
forks_from_until(fork_from, fork_until)
¶
Returns the specified fork and all forks after it until and including the second specified fork
Source code in src/ethereum_test_forks/helpers.py
107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 | |
ConstantinopleFix
¶
Bases: Constantinople
Constantinople Fix fork
Source code in src/ethereum_test_forks/forks/forks.py
116 117 118 119 120 121 | |
Istanbul
¶
Bases: ConstantinopleFix
Istanbul fork
Source code in src/ethereum_test_forks/forks/forks.py
124 125 126 127 128 129 | |
forks_from(fork, deployed_only=True)
¶
Returns the specified fork and all forks after it.
Source code in src/ethereum_test_forks/helpers.py
129 130 131 132 133 134 135 136 137 | |
MuirGlacier
¶
Bases: Istanbul
Muir Glacier fork
Source code in src/ethereum_test_forks/forks/forks.py
133 134 135 136 137 138 | |
is_fork(fork, which)
¶
Returns True if fork is which or beyond, `False otherwise.
Source code in src/ethereum_test_forks/helpers.py
140 141 142 143 144 145 146 147 148 149 150 151 152 | |
Berlin
¶
Bases: Istanbul
Berlin fork
Source code in src/ethereum_test_forks/forks/forks.py
141 142 143 144 145 146 | |
London
¶
Bases: Berlin
London fork
Source code in src/ethereum_test_forks/forks/forks.py
149 150 151 152 153 154 155 156 157 158 159 | |
header_base_fee_required(block_number, timestamp)
classmethod
¶
Base Fee is required starting from London.
Source code in src/ethereum_test_forks/forks/forks.py
154 155 156 157 158 159 | |
ArrowGlacier
¶
Bases: London
Arrow Glacier fork
Source code in src/ethereum_test_forks/forks/forks.py
163 164 165 166 167 168 | |
GrayGlacier
¶
Bases: ArrowGlacier
Gray Glacier fork
Source code in src/ethereum_test_forks/forks/forks.py
171 172 173 174 175 176 | |
Merge
¶
Bases: London
Merge fork
Source code in src/ethereum_test_forks/forks/forks.py
179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 | |
header_prev_randao_required(block_number, timestamp)
classmethod
¶
Prev Randao is required starting from Merge.
Source code in src/ethereum_test_forks/forks/forks.py
184 185 186 187 188 189 | |
header_zero_difficulty_required(block_number, timestamp)
classmethod
¶
Zero difficulty is required starting from Merge.
Source code in src/ethereum_test_forks/forks/forks.py
191 192 193 194 195 196 | |
get_reward(block_number, timestamp)
classmethod
¶
Merge updates the reward to 0.
Source code in src/ethereum_test_forks/forks/forks.py
198 199 200 201 202 203 | |
engine_new_payload_version(block_number, timestamp)
classmethod
¶
Starting at the merge, payloads can be sent through the engine API
Source code in src/ethereum_test_forks/forks/forks.py
205 206 207 208 209 210 | |
Shanghai
¶
Bases: Merge
Shanghai fork
Source code in src/ethereum_test_forks/forks/forks.py
213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 | |
header_withdrawals_required(block_number, timestamp)
classmethod
¶
Withdrawals are required starting from Shanghai.
Source code in src/ethereum_test_forks/forks/forks.py
218 219 220 221 222 223 | |
engine_new_payload_version(block_number, timestamp)
classmethod
¶
Starting at Shanghai, new payload calls must use version 2
Source code in src/ethereum_test_forks/forks/forks.py
225 226 227 228 229 230 | |
Cancun
¶
Bases: Shanghai
Cancun fork
Source code in src/ethereum_test_forks/forks/forks.py
233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 | |
is_deployed()
classmethod
¶
Flags that Cancun has not been deployed to mainnet; it is under active development.
Source code in src/ethereum_test_forks/forks/forks.py
238 239 240 241 242 243 244 | |
header_excess_data_gas_required(block_number, timestamp)
classmethod
¶
Excess data gas is required starting from Cancun.
Source code in src/ethereum_test_forks/forks/forks.py
246 247 248 249 250 251 | |
header_data_gas_used_required(block_number, timestamp)
classmethod
¶
Data gas used is required starting from Cancun.
Source code in src/ethereum_test_forks/forks/forks.py
253 254 255 256 257 258 | |
engine_new_payload_version(block_number, timestamp)
classmethod
¶
Starting at Cancun, new payload calls must use version 3
Source code in src/ethereum_test_forks/forks/forks.py
260 261 262 263 264 265 | |
engine_new_payload_blob_hashes(block_number, timestamp)
classmethod
¶
Starting at Cancun, payloads must have blob hashes.
Source code in src/ethereum_test_forks/forks/forks.py
267 268 269 270 271 272 | |