EIPs/EIPS/eip-4.md

68 lines
3.1 KiB
Markdown
Raw Normal View History

---
2018-03-21 12:51:05 +00:00
eip: 4
layer: Process
title: EIP Classification
author: Joseph Chow
status: Draft
2018-03-22 14:17:20 +00:00
type: Meta
2018-03-21 12:51:05 +00:00
created: 2015-11-17
---
2015-11-17 19:59:55 +00:00
2018-01-26 12:55:04 +00:00
# Abstract
2015-11-17 19:59:55 +00:00
2018-01-27 12:56:29 +00:00
This document describes a classification scheme for EIPs, adapted from [BIP 123](https://github.com/bitcoin/bips/blob/master/bip-0123.mediawiki).
2015-11-17 19:59:55 +00:00
EIPs are classified by system layers with lower numbered layers involving more intricate interoperability requirements.
The specification defines the layers and sets forth specific criteria for deciding to which layer a particular standards EIP belongs.
2018-01-26 12:55:04 +00:00
# Motivation
2015-11-17 19:59:55 +00:00
2015-11-18 23:34:46 +00:00
Ethereum is a system involving a number of different standards. Some standards are absolute requirements for interoperability while others can be considered optional, giving implementors a choice of whether to support them.
2015-11-17 19:59:55 +00:00
In order to have a EIP process which more closely reflects the interoperability requirements, it is necessary to categorize EIPs accordingly. Lower layers present considerably greater challenges in getting standards accepted and deployed.
2018-01-26 12:55:04 +00:00
# Specification
2015-11-17 19:59:55 +00:00
Standards EIPs are placed in one of four layers:
2018-01-26 12:55:04 +00:00
1. Consensus
2. Networking
3. API/RPC
4. Applications
2015-11-17 19:59:55 +00:00
2018-01-26 12:55:04 +00:00
# 1. Consensus Layer
2015-11-17 19:59:55 +00:00
The consensus layer defines cryptographic commitment structures. Its purpose is ensuring that anyone can locally evaluate whether a particular state and history is valid, providing settlement guarantees, and assuring eventual convergence.
The consensus layer is not concerned with how messages are propagated on a network.
Disagreements over the consensus layer can result in network partitioning, or forks, where different nodes might end up accepting different incompatible histories. We further subdivide consensus layer changes into soft forks and hard forks.
2018-01-26 12:55:04 +00:00
## Soft Forks
2015-11-17 19:59:55 +00:00
In a soft fork, some structures that were valid under the old rules are no longer valid under the new rules. Structures that were invalid under the old rules continue to be invalid under the new rules.
2018-01-26 12:55:04 +00:00
## Hard Forks
2015-11-17 19:59:55 +00:00
In a hard fork, structures that were invalid under the old rules become valid under the new rules.
2018-01-26 12:55:04 +00:00
# 2. Networking Layer
2015-11-17 19:59:55 +00:00
2015-11-21 23:48:45 +00:00
The networking layer specifies the Ethereum wire protocol (eth) and the Light Ethereum Subprotocol (les). RLPx is excluded and tracked in the [https://github.com/ethereum/devp2p devp2p repository].
2015-11-17 19:59:55 +00:00
2015-11-21 23:48:45 +00:00
Only a subset of subprotocols are required for basic node interoperability. Nodes can support further optional extensions.
It is always possible to add new subprotocols without breaking compatibility with existing protocols, then gradually deprecate older protocols. In this manner, the entire network can be upgraded without serious risks of service disruption.
2015-11-17 19:59:55 +00:00
2018-01-26 12:55:04 +00:00
# 3. API/RPC Layer
2015-11-17 19:59:55 +00:00
The API/RPC layer specifies higher level calls accessible to applications. Support for these EIPs is not required for basic network interoperability but might be expected by some client applications.
There's room at this layer to allow for competing standards without breaking basic network interoperability.
2018-01-26 12:55:04 +00:00
# 4. Applications Layer
2015-11-17 19:59:55 +00:00
2018-01-27 12:56:29 +00:00
The applications layer specifies high level structures, abstractions, and conventions that allow different applications to support similar features and share data.