EIP-2228 Standardizing the official name for network ID 1 (Canonicalize the name of network ID 1 and chain ID 1)
Final · Other · EIP status Final · created 2019-08-04
An Informational proposal that standardizes the official name of the Ethereum network with network ID 1 and chain ID 1 as the proper noun 'Ethereum Mainnet' or 'Mainnet'.
Why it is needed
The name used to refer to the same network varied from document to document. At the time this proposal was written, four spellings, "main net", "mainnet", "Main net", and "Mainnet", were used interchangeably across EIP documents, client implementations, and the internet at large, and even varied within documents by the same author. Descriptive phrasing such as "the Ethereum main network" was also a problem, because which chain "main" refers to depends on context. For example, in Ethereum Classic documents, "the main network" refers to network ID 2, chain ID 62. Unifying the name and spelling improves interoperability between implementations and raises user recognition. When multiple pieces of software use the same name in the same way, it gives a professional impression and makes it easier for users to spot unofficial spellings.
What changes
Today
- The same network was spelled inconsistently as "main net", "mainnet", "Main net", "Mainnet", and so on
- Context-dependent descriptive phrases such as "the Ethereum main network" were used
- MetaMask used the name "Main Ethereum Network" in its account network selection menu
After EIP-2228
- The official name is the proper noun 'Ethereum Mainnet', shortened to 'Mainnet' when the Ethereum context is clear
- Names or capitalizations that differ from the examples must not be used
- MetaMask updated its spelling to match this proposal
Who is affected
- Wallet & app developers: The network name must be unified as 'Ethereum Mainnet' or 'Mainnet' across user interfaces and documents. UIs that need different capitalization should handle it at the display layer, such as with CSS.
- EIP authors and editors: Several existing EIPs use spellings that differ from this standard, and editors are recommended to correct them to match this proposal.
- Users: Users see the same network referred to by the same name regardless of which software they use, reducing confusion.
In depth
Naming rule
The network with network ID 1 and chain ID 1 is named Ethereum Mainnet, and Mainnet alone may be used when the context of discussing the Ethereum network is clear. This name is a proper noun. The source text distinguishes, with examples, between using the term as the network's 'name' and 'describing' the network, and specifies that names or capitalizations that do not match the test cases must not be used.
Correct and incorrect spellings
Correct examples include "The contract was deployed to Ethereum Mainnet" and "this Dapp was deployed to Mainnet". When a UI writes it in all caps, such as "SWITCH TO MAINNET", or all lowercase, such as "switch to mainnet", it is recommended to apply a text-transform style in HTML so that the underlying semantic text remains 'Switch to Mainnet'. There are two incorrect examples: "the Ethereum main network" should be avoided because "main" is a context-dependent description, and lowercase "mainnet" is specified as not to be used because it is neither a proper noun nor a word found in an English dictionary. The proposal does not specify which of Dapp, dapp, or dApp is preferred.
Rationale
Using a common term improves interoperability between implementations and raises user recognition. Another rationale is that seeing the same word with the same capitalization across multiple implementations gives a professional impression. The source text cites, as an example, the "IPhone" repair shop signs seen in some countries, pointing out that inconsistent spelling is perceived as unofficial or off-brand. The intent is to avoid Ethereum users getting the same impression if the network name differs from one piece of software to another.
Trademark note
"Ethereum" is a registered trademark of the Ethereum Foundation. The source text refers to USPTO registration number 5110579 and the Foundation's website terms of use, which state that the trademark may not be used without the Foundation's prior written permission. This obligation should be checked when referencing "Ethereum" or "Ethereum Mainnet".
Compatibility with existing documents
MetaMask previously used "Main Ethereum Network" in its account network selection menu but has since been updated to match this proposal. In addition, EIP-2, EIP-779, EIP-150, EIP-155, EIP-190, EIP-225, EIP-1013, EIP-2028, and EIP-2387 contain Mainnet spellings that do not match this specification, and editors are recommended to correct the spelling to match this proposal for consistency.
Nature and status of the proposal
This proposal is not a standard that changes the protocol but an Informational EIP that guides terminology usage. It addresses only the spelling convention used in documents and UIs, with no hard fork or client consensus changes. Its status is Final, so the content will not change further.