From d5c189f3285baa4822c03ca312f962b16d8eb199 Mon Sep 17 00:00:00 2001 From: Murch Date: Thu, 20 Feb 2025 17:18:08 -0500 Subject: [PATCH] BIP3: Update BIP Process --- README.mediawiki | 7 + bip-0003.md | 753 ++++++++++++++++++++++++++++++++++++ bip-0003/status-diagram.png | Bin 0 -> 92759 bytes 3 files changed, 760 insertions(+) create mode 100644 bip-0003.md create mode 100644 bip-0003/status-diagram.png diff --git a/README.mediawiki b/README.mediawiki index e89ccf5b..260a740d 100644 --- a/README.mediawiki +++ b/README.mediawiki @@ -28,6 +28,13 @@ Those proposing changes should consider that ultimately consent may rest with th | Process | Active |- +| [[bip-0003.md|3]] +| +| Updated BIP Process +| Murch +| Process +| Draft +|- | [[bip-0008.mediawiki|8]] | | Version bits with lock-in by height diff --git a/bip-0003.md b/bip-0003.md new file mode 100644 index 00000000..c7d46871 --- /dev/null +++ b/bip-0003.md @@ -0,0 +1,753 @@ +``` + BIP: 3 + Title: Updated BIP Process + Author: Murch + Comments-URI: https://github.com/bitcoin/bips/wiki/Comments:BIP-0003 + Status: Draft + Type: Process + Created: 2025-01-09 + License: BSD-2-Clause + Post-History: https://github.com/murchandamus/bips/pull/2 + https://gnusha.org/pi/bitcoindev/59fa94cea6f70e02b1ce0da07ae230670730171c.camel@timruffing.de/#t + Requires: 123 + Replaces: 2 +``` + +## Abstract + +This _Bitcoin Improvement Proposal (BIP)_ provides information about the preparation of BIPs and policies relating to +the publication of BIPs. It replaces [BIP 2](bip-0002.mediawiki) with a streamlined process, and may be amended to +address the evolving needs of the BIP process. + +## Motivation + +BIP 2 was written in 2016. +This BIP revisits aspects of the BIP 2 process +that did not achieve broad adoption, reduces the judgment calls assigned to the BIP Editor role, delineates the +BIP Types more clearly, and generalizes the BIP process to meet the community’s use of the repository. + +## Fundamentals + +### What is a BIP? + +BIPs cover the range of interests of the Bitcoin[^capitalization] community. The main topic is information and technologies that support and expand the utility of the bitcoin +currency. Most BIPs provide a concise, self-contained, technical description of one new concept, feature, or standard. +Some BIPs describe processes, implementation guidelines, best practices, incident reports (e.g., +[BIP 50](bip-0050.mediawiki)), or other information relevant to the Bitcoin community. However, any topics related to +the Bitcoin protocol, peer-to-peer network, and client software may be acceptable. + +BIPs are intended to be a means for proposing new protocol features, coordinating client standards, and +documenting design decisions that have gone into implementations. BIPs may be submitted by anyone. + +The scope of the BIP +repository is limited to BIPs that do not oppose the fundamental principle that Bitcoin constitutes a peer-to-peer +electronic cash system for the bitcoin currency. + +### BIP Ownership + +Each BIP is primarily owned by its authors and represents the authors’ opinion or recommendation. The authors are +expected to foster discussion, address feedback and dissenting opinions, and, if applicable, advance the adoption of +their proposal within the Bitcoin community. As a BIP progresses through the workflow, it becomes increasingly + co-owned by the Bitcoin community. + +#### Authors and Deputies + +Authors may want additional help with the BIP process after writing an initial draft. In that case, they may assign +one or more Deputies to their BIP. Deputies are stand-in owners of a BIP who were not involved in writing the +document. They support the authors in advancing the proposal, or act as a point of contact for the BIP in the absence of the +authors. Deputies may perform the role of Authors for any aspect of the BIP process unless overruled by an Author. +Deputies share ownership of the BIP at the discretion of the Authors. + +### What is the Significance of BIPs? + +BIPs do not define what Bitcoin is: individual BIPs do not represent Bitcoin community consensus or a general +recommendation for implementation. A BIP represents a personal recommendation by the BIP authors to the Bitcoin +community. Some BIPs may never be adopted. Some BIPs may be adopted by one or more Bitcoin clients or other related +software. Some may even end up changing the consensus rules that the Bitcoin ecosystem jointly enforces. + +### What is the Purpose of the BIPs Repository? + +The [BIPs repository](https://github.com/bitcoin/bips/) serves as a publication medium and archive for mature proposals. +Through its high visibility, it facilitates the community-wide consideration of BIPs and provides a well-established +source to retrieve the latest version of any BIP. The repository transparently records all changes to each BIP and +allows any community member to retain a complete copy of the archive easily. + +The BIPs repository is not a tool to track acceptance[^acceptance], adoption, or community consensus on BIPs, beyond +providing a brief overview of BIP statuses (see [Workflow](#workflow) below) to the audience. +There is no formal or informal decision body that governs Bitcoin development or decides acceptance of BIPs. Bitcoin +development emerges from the participation of shareholders across the ecosystem. + +## BIP Format and Structure + +### Specification + +Authors may choose to submit BIPs in MediaWiki or Markdown[^markdown] format. + +Each BIP must have a _Preamble_, an _Abstract_, a _Copyright_, and a _Motivation_ section. Authors should consider all issues in the +following list and address each as appropriate. + +* Preamble — Headers containing metadata about the BIP (see the section [BIP Header Preamble](#bip-header-preamble) + below). +* Abstract — A short description of the issue being addressed. +* Motivation — Why is this BIP being written? Clearly explain how the existing situation presents a problem and why the proposed idea resolves the + issue or improves upon the current situation. +* Specification — The technical specification should describe the syntax and semantics of any new feature. The + specification should be detailed enough to enable any Bitcoin project to create an interoperable implementation. +* Rationale — The rationale fleshes out the specification by describing what inspired the design and why particular + design decisions were made. It should describe related work and alternate designs that were considered. The rationale + should record relevant objections or important concerns that were raised and addressed as this proposal was developed. +* Backward Compatibility — Any BIP that introduces incompatibilities must include a section describing these incompatibities and their severity as well as provide instructions on how + implementers and users should deal with these incompatibilities. +* Reference Implementation — Where applicable, a reference implementation, test vectors, and documentation must be + finished before the BIP can be given the status "Complete". Test vectors must be provided in the BIP or + as auxiliary files (see [Auxiliary Files](#auxiliary-files)) under an acceptable license. The reference implementation can be provided in the BIP, as an auxiliary file, or per reference to a pull request that is expected to remain available permanently. +* Changelog — A section to track modifications to a BIP after reaching Complete status. +* Copyright — The BIP must be placed under an acceptable license (see [BIP Licensing](#bip-licensing) below). + +#### BIP Header Preamble + +Each BIP must begin with an [RFC 822-style header preamble](https://www.w3.org/Protocols/rfc822/). The headers must +appear in the following order. Headers marked with "\*" are optional. All other headers are required. + +##### Overview + +``` + BIP: +* Layer: + Title: + Authors: +* Deputies: + Status: + Type: + Created: + License: +* License-Code: +* Discussion: +* Version: +* Requires: +* Replaces: +* Proposed-Replacement: +``` + +##### Header Descriptions + +* BIP — The assigned number of the BIP. Please use "?" before a number has been assigned by the BIP Editors. +* Layer — The layer of Bitcoin the BIP applies to using the BIP classification defined in [BIP 123](bip-0123.mediawiki). +* Authors — The names (or pseudonyms) and email addresses of all authors of the BIP. The format of each authors header + value must be + + Random J. User + + Multiple authors are recorded on separate lines: + + Authors: Random J. User + Anata Sample + +* Deputies — Additional owners of the BIP that are not authors. The Deputies header uses the same format as the + Authors header. See the [BIP Ownership](#bip-ownership) section above. +* Status — The stage of the workflow of the proposal. See the [Workflow](#workflow) section below. +* Type — See the [BIP Types](#bip-types) section below for a description of the three BIP types. +* License and License-Code — These headers list SPDX License Identifier(s) of the acceptable licenses under which the + BIP and corresponding code are available. See the [BIP Licensing](#bip-licensing) section below for a description of + the Licenses and their SPDX License Identifiers. If there are multiple acceptable licenses, each should be on a + separate line. +* Discussion — The Discussion header points the audience to relevant discussions of the BIP, e.g., the mailing list + thread in which the idea for the BIP was discussed, a thread where a new version of the BIP was presented, or relevant + discussion threads on other platforms. Entries take the format "yyyy-mm-dd: URL", e.g., `2009-01-09: + https://www.mail-archive.com/cryptography@metzdowd.com/msg10142.html`, using the date and URL of the start of the + conversation. Multiple discussions should be listed on separate lines. +* Version — The current version number of this BIP. See the [Changelog](#changelog) section below. +* Requires — A list of existing BIPs the new proposal depends on. If multiple BIPs + are required, they should be listed in one line separated by a comma and space (e.g., "1, 2"). +* Replaces — BIP authors may place the numbers of one or more prior BIPs in the Replaces header to recommend that their + BIP succeeds, supersedes, or renders obsolete those prior BIPs. +* Proposed-Replacement[^superseded-by-proposed-replacement] — When a later BIP indicates that it intends to supersede an + existing BIP, the later BIP’s number is added to the Proposed-Replacement header of the existing BIP to indicate the + potential successor BIP. + +#### Auxiliary Files + +BIPs may include auxiliary files such as diagrams and source code. Auxiliary files must be included in a subdirectory +for that BIP named `bip-XXXX`, where "XXXX" is the BIP number zero-padded to four digits. File names in the subdirectory +do not need to adhere to a specific convention. + +### BIP Types + +* A **Specification BIP** defines a set of technical rules describing a new feature or affecting the interoperability of implementations. The + distinguishing characteristic of a Specification BIP is that it can be implemented, and implementations can be compliant with + it. Specification BIPs must have a Specification section, must have a Backward Compatibility section (if incompatibilities are introduced), and can only be advanced to Complete after they contain or refer to a reference implementation and test vectors. +* An **Informational BIP** describes a Bitcoin design issue, or provides general guidelines or other information to the + Bitcoin community. +* A **Process BIP** describes a process surrounding Bitcoin, or proposes a change to (or an event in) a process. Process + BIPs are like Specification BIPs, but apply to topics other than the Bitcoin protocol and Bitcoin implementations. + They often require community consensus and are typically binding for the corresponding process. Examples include + procedures, guidelines, and changes to decision-making processes such as the BIP Process. + +## Workflow + +The BIP process starts with a new idea for Bitcoin. Each potential BIP must have authors—people who write the BIP, +gather feedback, shepherd the discussion in the appropriate forums, and finally recommend a mature proposal to the +community. + +![Status Diagram](bip-0003/status-diagram.png "Status Diagram for the BIP Workflow") + +### Ideation + +After having an idea, the authors should evaluate whether it meets the criteria to become a BIP, as described in this +BIP. The idea must be of interest to the broader community or relevant to multiple software projects. Minor improvements +and matters concerning only a single project usually do not require standardization and should instead be brought up directly to +the relevant project. + +The authors should first research whether an idea has been considered before. Ideas in Bitcoin are often rediscovered, +and prior related discussions may inform the authors of the issues that may arise in its progression. After some investigation, +the novelty of an idea can be tested by posting about it to the [Bitcoin Development Mailing +List](https://groups.google.com/g/bitcoindev). Prior correspondence can be found in the [mailing list +archive](https://gnusha.org/pi/bitcoindev/). + +Vetting an idea publicly before investing the time to describe the idea formally is meant to save both the authors and +the broader community time. Not only may someone point out relevant discussion topics that were missed in the authors’ +research, or that an idea is guaranteed to be rejected based on prior discussions, but describing an idea publicly also +tests whether it is of interest to more people besides the authors. After establishing that the idea may be of interest +to the Bitcoin community, the authors should work on drafting a BIP. + +As a first sketch of the proposal is taking shape, the authors should present it to the [Bitcoin Development Mailing +List](https://groups.google.com/g/bitcoindev). This gives the authors a chance to collect initial feedback and address +fundamental concerns. If the authors wish to work in public on the proposal at this stage, it is recommended that they +open a pull request against one of their forks of the BIPs repository instead of the main BIPs repository. + +It is recommended that complicated proposals be split into separate BIPs that each focus on a specific component of the +overall proposal. + +### Progression through BIP Statuses + +The following sections refer to BIP Status Field values. The BIP Status Field is defined in the Header Preamble +specification above. + +#### Draft + +After fleshing out the proposal further and ensuring that it is of high quality and properly formatted, the authors +should open a pull request to the [BIPs repository](https://github.com/bitcoin/bips). The document must adhere to the +formatting requirements specified above and should be provided as a file named with a working title of the form +"bip-title.[md|mediawiki]". The authors must not self-assign a number to their proposal. + +BIPs that (1) adhere to the formatting requirements, (2) are on-topic, and (3) have materially progressed beyond the +ideation phase, e.g., by generating substantial public discussion and commentary from diverse contributors, by +independent Bitcoin projects working on adopting the proposal, or by the authors working for an extended period toward +improving the proposal based on community feedback, will be assigned a number by a BIP editor. The BIP editors should +delay number assignment when they perceive a proposal being met with lack of interest: number assignment facilitates the +distributed discussion of ideas, but before a proposal garners some interest in the Bitcoin community, there is no need +to refer to it by a number. + +Proposals are also not ready for number assignment if they duplicate efforts, disregard formatting rules, are too +unfocused or too broad, fail to provide proper motivation, fail to address backward compatibility where necessary, or +fail to specify the feature clearly and comprehensively. Reviewers and BIP editors should provide guidance on how the +proposal may be improved to progress toward readiness. Pull requests that are proposing off-topic ideas or +have stopped making progress may be closed. + +When the proposal is ready and has been assigned a number, a BIP editor will merge it into the BIPs repository. After the +BIP has been merged to the repository, its main focus should no longer shift significantly, even while the authors may +continue to update the proposal as necessary. Updates to merged documents by the authors should also be submitted as +pull requests. + +#### Complete[^complete] + +When the authors have concluded all planned work on their proposal, are confident that their BIP represents a net +improvement, is clear, comprehensive, and is +ready for adoption by the Bitcoin community, they may update the BIP’s status to Complete to indicate that they +recommend adoption, implementation, or deployment of the BIP. Where applicable, the authors must ensure that any +proposed specification is solid, not unduly complicated, and definitive. Specification BIPs must come with or refer to a working reference implementation and comprehensive test vectors before they can be moved to Complete. Subsequently, the BIP’s content should only be +adjusted in minor details, e.g., to improve language, clarify ambiguities, backfill omissions in the specification, add +test vectors for edge cases, or address other issues discovered as the BIP is being adopted. + +A Complete BIP can only move to Deployed or Closed. Any necessary changes to the specification should be minimal and +interfere as little as possible with ongoing adoption. If a Complete BIP is found to need substantial functional +changes, it may be preferable to move it to Closed[^new-BIP], and to start a new BIP with the changes instead. +Otherwise, it could cause confusion as to what being compliant with the BIP means. + +A BIP may remain in the Complete status indefinitely unless its authors decide to move it to Closed or it is advanced to +Deployed. +Complete is the final status for most successful Informational BIPs. + +#### Deployed + +A settled[^settled] BIP may be advanced to Deployed upon request by any community member with evidence[^evidence] that the idea +described in the BIP is in active use. Convincing evidence includes for example: an established project having deployed support +for the BIP in mainnet software releases, a soft fork proposal’s activation criteria having been met on the network, or +rough consensus for the BIP having been demonstrated. + +At that point, the BIP should be considered final and any breaking changes to the BIP should be proposed as a new +separate BIP.[^new-BIP] + +##### Process BIPs + +A Process BIP may change status from Complete to Deployed when it achieves rough consensus on the Bitcoin Development Mailing List. Such a +proposal is said to have rough consensus if it has been open to discussion on the mailing list for at least +one month, and no person maintains any unaddressed substantiated objections to it. Addressed or obstructive objections +may be ignored/overruled by general agreement that they have been sufficiently addressed, but clear reasoning must be +given in such circumstances. Deployed Process BIPs may be modified indefinitely as long as a proposed modification has +rough consensus per the same criteria.[^living-documents] + +#### Closed[^closed] + +A BIP that is of historical interest only, and is not being actively worked on, promoted or in active use, should be +marked as Closed. The reason for moving the +proposal to (or from) Closed should be recorded in the Changelog section in the same commit that updates the status. +BIPs do not get deleted, they are retained even after being updated to Closed. +Transitions involving the Closed state are: + +##### Draft ↦ Closed + +BIP authors may decide on their own to change their BIP’s status from Draft to Closed. If a Draft BIP stops making +progress, sees accumulated feedback unaddressed, or otherwise appears stalled for a year, the community may move the BIP +to Closed unless the authors assert that they intend to continue work within four weeks of being contacted. + +##### Complete ↦ Closed + +BIPs that had attained the Complete status, i.e., that had been recommended for adoption, may be moved to Closed per the +authors’ announcement to the Bitcoin Development Mailing List[^bip-announcements-to-list]. However, if someone volunteers to adopt the proposal +within four weeks, they become the BIP's author or deputy, and the BIP will +remain Complete instead. + +##### Deployed ↦ Closed + +A BIP may evolve from Deployed to Closed when it is no longer in active use. Any community member may initiate this +Status update by announcing it to the mailing list[^bip-announcements-to-list], and proceed if no objections have been raised for four weeks. + +##### Closed ↦ Draft + +The Closed status is generally intended to be a final status for BIPs, +and if BIP authors decide to make another attempt at a previously Closed BIP, it is generally recommended to create a new +proposal. (Obviously, the authors may borrow any amount of inspiration or actual text from any prior BIPs as licensing +permits.) The authors should take special care to address the issues that caused the prior attempt’s abandonment. Even +if the prior attempt had been assigned a number, the new BIP will generally be assigned a distinct number. However, if it is +obvious that the new attempt directly continues work on the same idea, it may be reasonable to return the +Closed BIP to Draft status. + +### Changelog + +To help implementers understand updates to a BIP, any changes after it has reached Complete must be tracked with version, +date, and description in a Changelog section sorted by most recent version first. The version number is inspired by semantic versioning (MAJOR.MINOR.PATCH). +The MAJOR version is incremented if changes to the BIP’s Specification are introduced that are incompatible with prior +versions (which should be rare after a BIP is Complete, and only happen in well-grounded exceptional cases to a BIP that +is Deployed). The MINOR version is incremented whenever the specification of the BIP is changed or extended in a +backward-compatible way. The PATCH version is incremented for other changes to the BIP that are noteworthy (bug fixes, +test vectors, important clarifications, etc.). Version 1.0.0 is used to label the promotion to +Complete. A Changelog section may be introduced during the Draft phase to record significant changes (using versions 0.x.y). + +Example: + +> __Changelog__ +> +> * __2.0.0__ (2025-01-22): +> * Introduce a breaking change in the specification to fix a bug. +> * __1.1.0__ (2025-01-17): +> * Add a backward compatible extension to the BIP. +> * __1.0.1__ (2025-01-15): +> * Clarify an edge case and add corresponding test vectors. +> * __1.0.0__ (2025-01-14): +> * Complete planned work on the BIP. + +After a BIP receives a Changelog, the +Preamble must indicate the latest version in the Version header. The Changelog highlights revisions to BIPs to human readers. A single +BIP shall not recommend more than one variant of an idea at the same time. A different or +competing variant of an existing BIP must be published as a separate BIP. + +### Adoption of Proposals + +The BIPs repository does not track the sentiment on proposals and does not track the adoption of BIPs beyond whether they +are in active use or not. It is not intended for BIPs to list additional implementations beyond the reference +implementation: the BIPs repository is not a signpost where to find implementations.[^OtherImplementations] After a BIP +is advanced to Complete, it is up to the Bitcoin community to evaluate, adopt, ignore, or reject a BIP. Individual +Bitcoin projects are encouraged to publish a list of BIPs they implement. A good example of this at the time of writing +this BIP can be observed in Bitcoin Core’s [doc/bips.md](https://github.com/bitcoin/bitcoin/blob/master/doc/bips.md) +file. + +### Transferring BIP Ownership + +It occasionally becomes necessary to transfer ownership of BIPs to new owners. In general, it would be preferable to +retain the original authors of the transferred BIP, but that is up to the original authors. A good reason to transfer +ownership is because the original authors no longer have the time or interest in updating it or following through with +the BIP process, or are unreachable or unresponsive. A bad reason +to transfer ownership is because someone doesn't agree with the direction of the BIP. The community tries to build +consensus around a BIP, but if that's not possible, rather than fighting over control, the dissenters should supply a +competing BIP. + +If someone is interested in assuming ownership of a BIP, they should send an email asking to take over, addressed to the +original authors, the BIP Editors, and the Bitcoin Development Mailing List[^bip-announcements-to-list]. If the authors are unreachable or do not respond in a timely +manner (e.g., four weeks), the BIP editors will make a unilateral decision whether to appoint the applicants as +[Authors or Deputies](#authors-and-deputies) (which may be amended should the original authors make a delayed reappearance). + +## BIP Licensing + +The Bitcoin project develops a global peer-to-peer digital cash system. Open standards are indispensable for continued +interoperability. Open standards reduce friction, and encourage anybody and everyone to contribute, compete, and +innovate on a level playing field. Only freely licensed contributions are accepted to the BIPs repository. + +### Specification + +Each new BIP must identify at least one acceptable license in its preamble. Licenses must be referenced per their +respective [SPDX License identifier](https://spdx.org/licenses). New BIPs may be accepted with the licenses described +below. + +For example, a preamble might include the following License header: + + License: CC0-1.0 + GNU-All-Permissive + +In this case, the BIP text is fully licensed under both the Creative Commons CC0 1.0 Universal license as well as the +GNU All-Permissive License, and anyone may modify and redistribute the text provided they comply with the terms of +*either* license. In other words, the license list is an "OR choice", not an "AND also" requirement. + +It is also possible to license source code differently from the BIP text by including the optional License-Code header +after the License header. Again, each license must be referenced by their respective SPDX License identifier shown +below. + +Each source code file or source directory should specify the license under which it is made available as is common in +software (e.g., with a license header or a LICENSE/COPYING file). It is recommended to make any test vectors available +under CC0-1.0 or GNU-All-Permissive in addition to any other licenses to allow anyone to copy test vectors into their +implementations without introducing license hindrances. Licenses listed in the License-Code header apply to all source +directories, source code files, and test vectors provided with the BIP except those where a LICENSE file in a directory +or the file header states otherwise. + +For example, a preamble specifying the optional License-Code header might look like: + + License: CC0-1.0 + License-Code: MIT + +In this case, the code in the BIP is not available under CC0-1.0, but is only available under the terms of the MIT +License. + +BIPs are not required to be *exclusively* licensed under approved terms, and may also be licensed under unacceptable +licenses *in addition to* at least one acceptable license. In this case, only the acceptable license(s) should be listed +in the License and License-Code headers. + +It is recommended that BIPs that include literal code be licensed under the same license terms as the project it +modifies. For example, literal code intended for Bitcoin Core would ideally be licensed (or dual-licensed) under the MIT +license terms. + +In all cases, details of the licensing terms must be provided in the Copyright section of the BIP. + +#### Acceptable Licenses[^licenses] + +* BSD-2-Clause: [OSI-approved BSD 2-clause license](https://opensource.org/licenses/BSD-2-Clause) +* BSD-3-Clause: [OSI-approved BSD 3-clause license](https://opensource.org/licenses/BSD-3-Clause) +* CC0-1.0: [Creative Commons CC0 1.0 Universal](https://creativecommons.org/publicdomain/zero/1.0/) +* GNU-All-Permissive: [GNU All-Permissive License](http://www.gnu.org/prep/maintain/html_node/License-Notices-for-Other-Files.html) +* CC-BY-4.0: [Creative Commons Attribution 4.0 International](https://creativecommons.org/licenses/by/4.0/) +* MIT: [Expat/MIT/X11 license](https://opensource.org/licenses/MIT) +* Apache-2.0: [Apache License, version 2.0](http://www.apache.org/licenses/LICENSE-2.0) +* BSL-1.0: [Boost Software License, version 1.0](http://www.boost.org/LICENSE_1_0.txt) + +#### Not Acceptable Licenses + +All licenses not explicitly included in the above lists are not acceptable terms for a Bitcoin Improvement Proposal. +However, BIPs predating the acceptance of this BIP were allowed under other terms, and should use these abbreviations +when no other license is granted: + +* PD: Released into the public domain +* OPL: [Open Publication License, version 1.0](http://opencontent.org/openpub/) + +## BIP Editors + +The current BIP editors are: + +* Bryan Bishop ([kanzure@gmail.com](mailto:kanzure@gmail.com)) +* Jon Atack ([jon@atack.com](mailto:jon@atack.com)) +* Luke Dashjr ([luke_bipeditor@dashjr.org](mailto:luke_bipeditor@dashjr.org)) +* Mark "Murch" Erhardt ([murch@murch.one](mailto:murch@murch.one)) +* Olaoluwa Osuntokun ([laolu32@gmail.com](mailto:laolu32@gmail.com)) +* Ruben Somsen ([rsomsen@gmail.com](mailto:rsomsen@gmail.com)) + +### BIP Editor Responsibilities and Workflow + +The BIP editors subscribe to the Bitcoin Development Mailing List and watch the [BIPs +repository](https://github.com/bitcoin/bips). + +When a new BIP idea is submitted to the mailing list, BIP editors and other community members should comment in regard +to: + +* Novelty of the idea +* Viability, utility, and relevance of the concept +* Readiness of the proposal +* On-topic for the Bitcoin community + +Discussion in pull request comments can often be hard to follow as feedback gets marked as resolved when it is addressed +by authors. Substantive discussion of ideas may be more accessible to a broader audience on the mailing list, where it +is also more likely to be retained by the community memory. + +If the BIP needs more work, an editor should ensure that constructive, actionable feedback is provided to the authors +for revision. Once the BIP is ready it should be submitted as a "pull request" to the [BIPs +repository](https://github.com/bitcoin/bips) where it may get further feedback. + +For each new BIP pull request that comes in, an editor checks the following: + +* The idea has been previously discussed on the Bitcoin Development Mailing List +* Title accurately describes the content +* Proposal is of general interest and/or pertains to more than one Bitcoin project/implementation +* Document is properly formatted +* Licensing terms are acceptable +* Motivation, Rationale, and Backward Compatibility have been addressed +* Specification provides sufficient detail for implementation +* The defined Layer header must be correctly assigned for the given specification +* The BIP is ready: it is comprehensible, technically feasible, and all aspects are addressed as necessary + +Editors do NOT evaluate whether the proposal is likely to be adopted. + +A BIP editor will: + +* Assign a BIP number and BIP type in the pull request +* Ensure that the BIP is listed in the [README](README.mediawiki) +* Merge the pull request when it is ready + +The BIP editors are intended to fulfill administrative and editorial responsibilities. The BIP editors monitor BIP +changes, and update BIP headers as appropriate. + +BIP editors may also, at their option, unilaterally make and merge strictly editorial changes to BIPs, such as +correcting misspellings, fixing broken links, etc. as long as they do not change the meaning or conflict with the +original intent of the authors. Such a change must be recorded in the Changelog if it’s noteworthy per the criteria +mentioned in the [Changelog](#changelog) section. + +## Backward Compatibility + +### Changes from BIP 2 + +#### Workflow + +- Status field values are reduced from nine to four: + - Deferred, Obsolete, Rejected, Replaced, and Withdrawn are gathered up into Closed.[^closed] + - Final and Active are collapsed into Deployed. + - Proposed is renamed to Complete. + - The remaining statuses are Draft, Complete, Deployed, and Closed. +- The comment system is abolished.[^comments] +- A BIP in Draft or Complete status may no longer be closed solely on grounds of not making progress for three years.[^rejection] + - A BIP in Draft status may be set to Closed by anyone if it appears to have stopped making progress for at least a + year and its authors do not assert that they are still working on it when contacted. + - Complete BIPs can only be moved to Closed by its authors and may remain in Complete indefinitely. +- Process BIPs are living documents that do not ossify and may be modified indefinitely. +- Some judgment calls previously required from BIP Editors are reassigned either to the BIP authors or the repository’s + audience. + +#### BIP Format + +- The Standards Track type is superseded by the similar Specification type.[^standard-track] +- Many sections are declared optional, it is up to the authors and audience to judge whether all relevant topics have + been comprehensively addressed and which topics require a designated section to do so. +- "Other Implementations" sections are discouraged.[^OtherImplementations] +- Auxiliary files are only permitted in the corresponding BIP’s subdirectory, as no one used the alternative of labeling + them with the BIP number. +- Tracking of adoption, acceptance, and community consensus is out of scope for the BIPs repository, except to determine + whether a BIP is in active use for the move into or out of the Deployed status. +- The distinction between recommended and acceptable licenses was dropped. +- Most licenses that have not been used in the BIP process have been dropped from the list of acceptable licenses. + +#### Preamble + +- Comments-URI and Comment-Summary headers are dropped from the preamble.[^comments] +- The "Superseded-By" header is replaced with the "Proposed-Replacement" header. +- The "Post-History" header is replaced with the "Discussion" header. +- The "Discussions-To" header is dropped as it has never been used in any BIP. +- Introduce Deputies and optional Deputies header. +- Titles may now be up to 50 characters. +- Layer header is optional for Specification BIPs or Informational BIPs, as it does not make sense for all BIPs.[^layer] +- Rename "Author" field to "Authors". + +### Updates to Existing BIPs should this BIP be Activated + +#### Previous BIP Process + +This BIP supersedes BIP 2 as the guideline for the BIP process. + +#### BIP Types + +Standards Track BIPs and eligible Informational BIPs are assigned the Specification type. The Standards Track type is +considered obsolete. Specification BIPs use the Layer header rules specified in [BIP 123](BIP-0123.mediawiki). + +#### Comments + +The Comments-URI and Comment-Summary headers should be removed from all BIPs whose comment page in the wiki is empty. +For existing BIPs whose comment page has content, BIP Authors may keep both headers or remove both headers at their +discretion. It is recommended that existing wiki pages are not modified due to the activation of this BIP. + +#### Status Field + +After the activation of this BIP, the Status fields of existing BIPs that do not fit the specification in this BIP are +updated to the corresponding values prescribed in this BIP. BIPs that have had Draft status for extended periods will be +moved to Complete or Deployed as applicable in collaboration with their authors. The authors of incomplete Draft BIPs +will be contacted to learn whether the BIPs are still in progress toward Complete, and will otherwise be updated to +Closed as described in the [Workflow](#workflow) section above. + +#### Authors Header + +The Author header is replaced with the Authors header in all BIPs. + +#### Discussion Header + +The Post-History header is replaced with the Discussion header in all BIPs. + +#### Proposed-Replacement Header + +The Superseded-By header is replaced with the Proposed-Replacement header in all BIPs. + +#### Licenses + +The licenses of existing BIPs remain untouched. + +## Copyright + +This BIP is licensed under the [BSD-2-Clause License](https://opensource.org/licenses/BSD-2-Clause). Some content was +adapted from [BIP 2](BIP-0002.mediawiki) which was also licensed under the BSD-2-Clause. + +## Related Work + +- [BIP 1: BIP Purpose and Guidelines](bip-0001.mediawiki) +- [BIP 2: BIP Process, revised](BIP-0002.mediawiki) +- [BIP 123: BIP Classification](BIP-0123.mediawiki) +- [RFC 822: Standard for ARPA Internet Text Messages](https://datatracker.ietf.org/doc/html/rfc822) +- [RFC 2223: Instructions to RFC Authors](https://datatracker.ietf.org/doc/html/rfc2223) +- [RFC 7282: On Consensus and Humming in the IETF](https://tools.ietf.org/html/rfc7282) + +## Acknowledgements + +We thank AJ Towns, Jon Atack, Jonas Nick, Larry Ruane, Pieter Wuille, Tim Ruffing, and others for their review, +feedback, and helpful comments. + +## Rationale + +[^capitalization]: **When is Bitcoin capitalized and when is it lowercased?** + This document uses capitalized Bitcoin to refer to the system, network and abstract concept, and only uses lowercase + bitcoin to refer to units of the bitcoin currency. +[^standard-track]: **Why was the Specification type introduced?** + The definitions of Informational and Standards Track BIPs caused some confusion in the past. Due to Informational + BIPs being described as optional, Standards Track BIPs were sometimes misunderstood to be generally recommended. + This has led to a number of BIPs that propose new features affecting interoperability of implementations being + assigned the Informational type. The situation is remedied by introducing a new _Specification BIP_ type that is + inclusive of any BIPs that can be implemented and affect interoperability of Bitcoin applications. Since all BIPs + are individual recommendations by the authors (even if some may eventually achieve endorsement by the majority of + the community), the prior reminder that Informational BIPs are optional is dropped. +[^comments]: **Why were comments, Comments-URI, and Comment-Summary removed from the process?** + The comments feature saw insignificant adoption. Few BIPs received any comments and barely any more than two with + only a handful of contributors commenting at all. This led to many situations in which one or two comments ended up + dominating the comment summary. While some of those comments may have been representative of broadly held opinions, + it also overstated the importance of individual comments directly in the Preamble of BIPs. As collecting feedback in + this accessible fashion failed, the new process puts the onus back on the audience to make their own evaluation. +[^layer]: **Why is the layer header now permitted for other BIP types?** + The layer header had already been used by many Informational BIPs, so the rule that it is only available to + Standards Track BIPs is dropped. +[^OtherImplementations]: **What is the issue with "Other Implementations" sections in BIPs?** + In the past, some BIPs had "Other Implementations" sections that caused frequent change requests to existing BIPs. + This put an onus on the BIP authors, and frequently led to lingering pull requests due to the corresponding BIPs’ + authors no longer participating in the process. Many of these alternative implementations eventually became + unmaintained or were low-quality to begin with. Therefore, "Other Implementations" sections are heavily discouraged. +[^complete]: **Why was the Proposed status renamed to Complete?** + Some reviewers of this BIP raised that in a process which outlines the workflow of Bitcoin Improvement _Proposals_ + using "Proposed" as a status field value was overloading the term: clearly _proposals_ are proposed at all stages of + the process. "Complete" expresses that the authors have concluded planned work on all parts of the proposal and are + ready to recommend their BIP for adoption. The term "ready" was also considered, but considered too subjective. +[^rejection]: **Why can proposals remain in Draft or Complete indefinitely?** + The automatic 3-year timeout of BIPs has led to some disagreement in the past and seems unnecessary in cases where + the authors are still active in the community and still consider their idea worth pursuing. On the other hand, + Draft proposals that appear stale may be tested and cleared out after only one year which should achieve the main goal of + the original rule by limiting the effort and attention spent on proposals that never reach Complete. +[^closed]: **Why was the Closed Status introduced?** + The Closed Status provides value to the audience by indicating which documents are only of historical significance. + Previously, the process had Deferred, Obsolete, Rejected, Replaced, and Withdrawn which all meant some flavor of + "work has stopped on this". The many statuses complicated the process, may have contributed to process fatigue, and + may have resulted in BIPs’ statuses not being maintained well. The author of this BIP feels that all of the + aforementioned can be represented by _Closed_ without significantly impacting the information quality of the + overview table. Where the many Status variants provided minuscule additional information, the simplification is more + valuable and the Changelog section now collects specific details. +[^acceptance]: **Why does the BIPs repository no longer track adoption?** + BIP 2 made an attempt to gather community feedback into comment summaries in BIPs directly. Given the low adoption + and corresponding low information quality of the summaries that resulted from that feature, this BIP instead intends + to leave the evaluation of BIPs to the audience. +[^markdown]: **Which flavor of Markdown is allowed?** + The author of this proposal has no opinion on Markdown flavors, but recommends that proposals stick to the basic + Markdown syntax features commonly shared across Markdown dialects. +[^living-documents]: **Why are Process BIPs living documents?** + In the past years, the existing BIPs process has not always provided a clear approach to all situations. For + example, the content of BIP 2 appears to have been penned especially with fork proposals in mind. It seems clear + that Bitcoin development will evolve in many surprising ways in the future. Instead of mandating the effort of + writing a new process document every time new situations arise, it seems preferable to allow the process to adapt to + the concerns of the future in specific aspects. Therefore, Process BIPs are defined as living documents that remain + open to amendment. If a Process BIP requires large modifications or even a complete overhaul, a new BIP should be + preferred. +[^new-BIP]: **Why should the specification of an implemented BIP no longer be changed?** + After a Complete or Deployed BIP has been deployed by one or more implementations, breaking changes to the + specification could lead to a situation where multiple "compliant" implementations fail at being interoperable, + because they implemented different versions of the same BIP. Therefore, even changes to the specification of + Complete BIPs should be avoided, but Deployed BIPs should never be subject to breaking changes to their + specification. +[^settled]: **What is meant by a BIP being settled?** + Since Deployed BIPs should not be changed, a Complete BIP should only be moved to Deployed after its Specification + has been put through its paces and changes to the BIP have stopped. +[^bip-announcements-to-list]: **Why are some BIP status changes announced to the mailing list?** + The BIPs repository does not and cannot track who might be interested in or has deployed a BIP. While concerns were + raised that making announcements to the Bitcoin Developer Mailing List would introduce unnecessary noise, our + rationale is that 1) moving Complete and Deployed BIPs to the Closed status will be a rare occurrence, 2) status + updates will usually not generate a lot of discussion, 3) while the mailing list should preferably only used for + getting review for new BIPs, it is the only channel available to us that can be consider a public announcement to + the audience of the BIPs repository: even if the authors, implementers, or other parties interested in a BIP do not + see the announcement themselves, they may be made aware by someone that does see it. +[^superseded-by-proposed-replacement]: **Why is Superseded-By replaced with Proposed-Replacement?** + Reviewers asked who should get to decide whether a BIP is superseded in case of a disagreement among the authors of + the original BIP, the authors of the new BIP, the editors, or the community? This is addressed by making the + "Replaces" header part of the recommendation of the authors of the new document, and replacing the "Superseded-By" + header with the "Proposed-Replacement" header that lists any proposals that recommend replacing the original document. +[^evidence]: **How is evidence for advancing to Deployed evaluated?** + Whether evidence is deemed convincing to move a BIP to Deployed is up to the BIP Editors and Bitcoin community. + Running a single instance of a personal fork of a software project might be rejected, while a small software project with + dozens of users may be sufficient. The main point of the Deployed status is to indicate that changes to the BIP + could negatively impact users of projects that have already implemented support. +[^licenses]: **Why were some licenses dropped?** + Among the 141 BIPs with licenses in the repository, only nine licenses have ever been used to license BIPs + (although, some BIPs were made available under more than one license) and only one license has been used to license + code: + + Licenses used: + + * BSD-2-Clause: 55 + * PD: 42 + * CC0-1.0: 23 + * BSD-3-Clause: 19 + * OPL: 5 + * CC-BY-SA-4.0: 4 + * GNU-All-Permissive: 3 + * MIT: 2 + * CC-BY-4.0: 1 + + License-Code used: + + * MIT: 4 + + The following previously acceptable licenses were retained per request of reviewers, even though they have so far + never been used in the BIPs process: + + * Apache-2.0: [Apache License, version 2.0](http://www.apache.org/licenses/LICENSE-2.0) + * BSL-1.0: [Boost Software License, version 1.0](http://www.boost.org/LICENSE_1_0.txt) + + The following previously acceptable licenses have never been used in the BIPs Process and have been dropped: + + * AGPL-3.0+: [GNU Affero General Public License (AGPL), version 3 or newer](http://www.gnu.org/licenses/agpl-3.0.en.html) + * FDL-1.3: [GNU Free Documentation License, version 1.3](http://www.gnu.org/licenses/fdl-1.3.en.html) + * GPL-2.0+: [GNU General Public License (GPL), version 2 or newer](http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) + * LGPL-2.1+: [GNU Lesser General Public License (LGPL), version 2.1 or newer](http://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html) + + Why are software licenses included? + + * Some BIPs, in particular those concerning the consensus layer, may include literal code in the BIP itself which + may not be available under the license terms the authors wish to use for the BIP. + * The author of this BIP has been provided with a learned opinion indicating that software licenses are perfectly + acceptable for licensing "human code" i.e., text as well as Markdown or MediaWiki code. + + Why is CC-BY-SA-4.0 no longer acceptable for new BIPs? + + * Specification BIPs are required to have a Reference Implementation and Test Vectors to be advanced to Complete. As + the BIPs repository is aiming to make proposals easily adoptable, the intention is for the reference + implementation and test vectors to be as accessible as possible. Copyleft licenses may introduce friction here, + and therefore CC-BY-SA-4.0 (and the GPL-flavors) is no longer considered acceptable for new BIPs. As mentioned + above, existing BIPs will retain their original licensing. + + Why are OPL and Public Domain no longer acceptable for new BIPs? + + * Public domain is not universally recognised as a legitimate action, thus it is inadvisable. + * The OPL is generally regarded as obsolete, and not a license suitable for new publications. diff --git a/bip-0003/status-diagram.png b/bip-0003/status-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..acddba63379441c3f01970c9cb65637d6dd90f67 GIT binary patch literal 92759 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