diff --git a/EIPS/eip-3.mediawiki b/EIPS/eip-3.mediawiki new file mode 100644 index 00000000..45e739b5 --- /dev/null +++ b/EIPS/eip-3.mediawiki @@ -0,0 +1,66 @@ +
+ EIP: 3 + Layer: Process + Title: EIP Classification + Author: Eric Lombrozo + Status: Draft + Type: Process + Created: 2015-11-17 ++ +==Abstract== + +This document describes a classification scheme for EIPs, adapted from BIP123. + +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. + +==Motivation== + +Bitcoin 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. + +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. + +==Specification== + +Standards EIPs are placed in one of four layers: + +# Consensus +# Peer Services +# API/RPC +# Applications + +===1. Consensus Layer=== + +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. + +====Soft Forks==== + +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. + +====Hard Forks==== + +In a hard fork, structures that were invalid under the old rules become valid under the new rules. + +===2. Peer Services Layer=== + +The peer services layer specifies how nodes find each other and propagate messages. + +Only a subset of all specified peer services are required for basic node interoperability. Nodes can support further optional extensions. + +It is always possible to add new services without breaking compatibility with existing services, then gradually deprecate older services. In this manner, the entire network can be upgraded without serious risks of service disruption. + +===3. API/RPC Layer=== + +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. + +===4. Applications Layer=== + +The applications layer specifies high level structures, abstractions, and conventions that allow different applications to support similar features and share data.