EIP-1013 Hardfork meta: Constantinople ("Hardfork Meta: Constantinople")
Final · Other · EIP status Final · created 2018-04-20
A meta EIP that finalizes and records the five EIPs included in the Constantinople hardfork and the activation block numbers for mainnet and each testnet.
Why it is needed
Ethereum upgrades via hardforks, which change the network rules all at once when a predetermined block number is reached. But because improvement proposals are each proposed and discussed separately, if a single document doesn't pin down exactly which proposals go into a given upgrade and exactly which block activates them, client (node software) implementations can end up diverging. If nodes with differing rules mix on the network, there is a risk the network splits. This meta EIP provides, as the official reference, the fact that the hardfork named Constantinople includes five EIPs - EIP-145, 1014, 1052, 1234, and 1283 - along with the activation block numbers for mainnet and each testnet. This document's role is to make every implementation team work from the same list and the same block numbers.
What changes
Today
- The EVM lacks instructions such as bitwise shift operations and EXTCODEHASH
- The difficulty bomb operates as scheduled and block rewards remain at their existing level
- Which EIPs go into Constantinople is not finalized in a single official document
After EIP-1013
- Shift instructions (EIP-145), CREATE2 (EIP-1014), and EXTCODEHASH (EIP-1052) are added to the EVM
- The difficulty bomb is delayed and block rewards are adjusted (EIP-1234)
- Net gas metering is applied to SSTORE (EIP-1283)
- All five changes activate at once starting at mainnet block 7,280,000
Who is affected
- Client teams: The five EIPs must be implemented and activated identically at the specified block numbers.
- Smart contract developers: New EVM features such as bit shift instructions, CREATE2, and EXTCODEHASH become available.
- Miners: Block rewards are adjusted per EIP-1234.
- Node operators: You must update to a client version that supports Constantinople before the activation block to keep following the network.
In depth
The meta EIP document format
This document does not itself propose any new technical change. It is an EIP of type Meta, and its entire purpose is to specify which EIPs are included in the hardfork named Constantinople. The technical specification of each individual change lives in its own EIP's original text, and this document serves as the list that bundles them into a single upgrade. The preamble's requires field lists EIP-609 in addition to the five included EIPs (145, 1014, 1052, 1234, 1283).
Codename and activation block
The codename is Constantinople, and the aliases Metropolis/Constantinople and Metropolis part 2 are also recorded. In other words, it is the hardfork planned as the second part of the Metropolis upgrade. Activation is specified by block number for each network. Ethereum mainnet activates at Block >= 7,280,000, the Ropsten testnet at Block >= 4,230,000, the Kovan testnet at Block >= 9,200,000, and the Rinkeby testnet at Block >= 3,660,663. The testnets have earlier activation blocks, so the same changes can be verified on testnets before they are applied on mainnet.
The five included EIPs
The included list is as follows. EIP-145: Bitwise shifting instructions in EVM. EIP-1014: Skinny CREATE2, which introduces the new contract creation instruction CREATE2. EIP-1052: the EXTCODEHASH opcode, an instruction for looking up the code hash of another account. EIP-1234: Delay difficulty bomb, adjust block reward. EIP-1283: Net gas metering for SSTORE without dirty maps. The detailed specification and figures for each change are governed by that EIP's original text.
Candidate selection process and references
According to the original References, the above list consists of EIPs discussed as candidates at Constantinople Session #1 of the All Core Devs call, and progress was tracked on a separate Constantinople Progress Tracker wiki. A link to the Ethereum Foundation blog's February 22, 2019 announcement of the Constantinople and St. Petersburg upgrades is also included as a reference.
Document status: Final
This EIP was written on April 20, 2018, and its status is Final. It is the finalized document for the hardfork's composition and activation blocks, so its content will not change further. There are no additional decisions related to this document in the call records.