This guide explains BIP 123 BIP Classification in plain English. It covers the problem behind the BIP, why it matters and whether the proposal is part of Bitcoin today.
TL;DR
- What it is: BIP 123 classifies standards proposals by four Bitcoin system layers: Consensus, Peer Services, API/RPC and Applications. Lower-numbered layers carry tighter interoperability requirements and more severe disagreement costs.
- Why it matters: BIP 123 turns a vague protocol label into four practical risk classes. Applying the layer before testing makes evidence more relevant and prevents application support from being mistaken for consensus compatibility.
- Current position: The Process BIP is Deployed and provides a useful way to choose evidence, reviewers and rollback controls before changing node, pool, wallet or business software.
BIP 123 BIP Classification in simple English
BIP 123 BIP Classification: Take every proposal, feature flag and incident in the change queue and assign a BIP 123 layer. Record the consequence of disagreement, authoritative evidence, owners, failover path and rollback limit.
Simple example
A node operator is checking BIP 123 BIP Classification. Classification helps an operator ask whether universal agreement is required, whether coexistence is possible and which test can show compatibility.
Key terms in plain English
- BIP:
- Bitcoin Improvement Proposal: a document describing a proposed rule, standard or process. Its status must be checked separately.
- RPC:
- A command that software sends to a node to request information or a local action.
- Consensus:
- The shared rules full nodes use to decide whether blocks and transactions are valid.
- Soft fork:
- A proposed tightening of Bitcoin rules that old nodes may not enforce themselves.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
Why classification matters
Bitcoin proposals can describe validity rules, optional network messages, local interfaces or wallet conventions. Calling them all protocol changes hides different authorities and failure modes. Classification helps an operator ask whether universal agreement is required, whether coexistence is possible and which test can show compatibility.
Consensus layer
Consensus defines structures that let a node determine whether history and state are valid. A soft fork narrows what upgraded nodes accept; a hard fork makes something previously invalid valid. Disagreement can partition the network. Evidence therefore requires validating implementations, activation state and explicit accept and reject vectors.
Peer Services layer
Peer services cover discovery and message propagation. Optional services can be added and old ones deprecated without every node supporting the same extension. A service bit or negotiation message advertises capability, but peer input remains untrusted and local validation still decides whether received transactions and blocks are valid.
API and RPC layer
APIs expose higher-level calls to applications and operators. Competing interfaces can coexist without breaking basic network consensus, although an incompatible response can still harm a wallet, pool or automation. Contract tests, authentication, permissions, error semantics and versioned client behaviour are the relevant controls.
Applications layer
Application BIPs define formats, abstractions and conventions shared by wallets or services, such as addresses and payment requests. Adoption may be partial. The user interface must preserve security meaning, and round-trip tests should span actual products rather than proving only that one library can parse its own output.
Layer boundaries in real systems
A mining stack crosses layers: the node validates consensus, peer connections relay data, RPC supplies templates and pool applications distribute work. A defect can appear at one boundary while dashboards blame another. Map the full path and name the authoritative check for each transition.
Classification review exercise
Take every proposal, feature flag and incident in the change queue and assign a BIP 123 layer. Record the consequence of disagreement, authoritative evidence, owners, failover path and rollback limit. Where one project spans layers, split the test plan rather than forcing one label onto the whole deployment.
Frequently asked questions
What is the main point of BIP 123 BIP Classification?
BIP 123 BIP Classification: Take every proposal, feature flag and incident in the change queue and assign a BIP 123 layer.
For BIP 123 BIP Classification, why classification matters?
Bitcoin proposals can describe validity rules, optional network messages, local interfaces or wallet conventions.
For BIP 123 BIP Classification, what should a beginner know about consensus layer?
Consensus defines structures that let a node determine whether history and state are valid.
For BIP 123 BIP Classification, what should a beginner know about peer Services layer?
Peer services cover discovery and message propagation. Optional services can be added and old ones deprecated without every node supporting the same extension.
Conclusion
BIP 123 turns a vague protocol label into four practical risk classes. Applying the layer before testing makes evidence more relevant and prevents application support from being mistaken for consensus compatibility.
Primary sources
Check the current specification status and the documentation for the exact implementation you operate before moving production funds or changing a mining node.
Join the ASIC Mining Discussion
Members can read and join the discussion
Log in to read comments from other miners. Create a free account if you would like to ask a question or share your experience.
Membership helps us protect the discussion from spam and keep answers useful.