Abstract

This document describes a classification scheme for CIPs, adapted from BIP 123.

CIPs 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 CIP belongs.

Motivation

Genesis 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 CIP process which more closely reflects the interoperability requirements, it is necessary to categorize CIPs accordingly. Lower layers present considerably greater challenges in getting standards accepted and deployed.

Specification

Standards CIPs are placed in one of four layers:

  1. Consensus
  2. Networking
  3. API/RPC
  4. 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. Networking Layer

The networking layer specifies the Genesis wire protocol and the Light Genesis Subprotocol (les). RLPx is excluded and tracked in the [https://github.com/FIXME/devp2p devp2p repository].

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.

3. API/RPC Layer

The API/RPC layer specifies higher level calls accessible to applications. Support for these CIPs 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.