Software Life Cycle
Overview
This document describes the life-cycle of the Dpowcoin Core software package released by the Dpowcoin Core project. It is in line with standard maintenance policy across commercial software.
Versioning
Dpowcoin Core releases are versioned as follows: MAJOR.MINOR, and release candidates are suffixed with rc1, rc2 etc.
Major releases
We aim to make a major release every 6-7 months.
These will be numbered 22.0, 23.0 etc.
Maintenance releases
We will provide maintenance “minor releases” that fix bugs within the major releases. As a general rule we do not introduce major new features in a maintenance release (except for consensus rules). However, we may add minor features where necessary, and we will back-port consensus rule changes such as soft forks.
Minor releases will be numbered 22.1, 22.2, 23.1, 23.2 etc.
Consensus rules
Proposals to change consensus rules are always shipped first in maintenance versions such as 22.2, 23.1 etc. This makes it easier for enterprise users to assess and test the proposal because of its smaller changeset compared to a major release. It also allows users who follow a more conservative upgrade path to adopt consensus rule changes in a more timely manner.
Maintenance period
We maintain the major versions until their “Maintenance End”. We generally maintain the current and previous major release. For example, if the current release is 23.0, then 22.0 is also considered maintained. Once 24.0 is released, then 22.0 would be considered at its “Maintenance End”. As a major release ages, issues have to be increasingly critical to be backported to it, and an increasing amount or severity of issues is required to warrant a new minor release. Once software has reached the “Maintenance End” period it will only receive critical security fixes until the EOL date. After EOL, users must upgrade to a later version to receive security updates, even though the community may provide fixes for critical issues on a best effort basis. Generally, it is recommended to run the latest maintenance release (point release) of the current or previous major version.
Please note that minor versions get bugfixes, translation updates, and soft forks. Translation on Transifex is only open for the last two major releases.
For example, major version 22.0 was released on 2021-09-13 and we provided maintenance fixes (point releases) until 2022-11-15. Critical security issues would still be continued to be fixed until the End-Of-Life “EOL” date of 2024-04-01. However, to take advantage of bug fixes, you would have to upgrade to a later major version.
Schedule
Once EOL is reached, you will need to upgrade to a newer version.
| Version | Release Date | Maintenance End | End of Life |
|---|---|---|---|
| 26.1 | 2024-04-13 | after v28.0 | TBA |
| 27.0 | TBA* | TBA | TBA |
* We aim to make a major release every 9-10 Months - Year
TBA: to be announced
Protocol versioning
The description above only describes Dpowcoin Core software releases. Many other parts of the Dpowcoin system contain their own versions. A few examples:
- Every transaction contains a version number.
- The P2P network protocol uses version numbers to allow nodes to announce what features they support.
- Dpowcoin Core’s built-in wallet has its own internal version number.
- And even our Algotims have own version as Yespower 1.0.1 and Argon2id 0x13 or 19
These version numbers are deliberately decoupled from Dpowcoin Core’s version number as the Dpowcoin Core project either has no direct control over them (as is the case with blocks and transactions), or tries to maintain compatibility with other projects (as is the case with the network protocol), or allows for the possibility that no major changes will be made in some releases (as is sometimes the case with the built-in wallet).
The consensus protocol itself doesn’t have a version number.
Relationship to SemVer
Dpowcoin Core software versioning does not follow the SemVer optional versioning standard, but its release versioning is superficially similar. SemVer was designed for use in normal software libraries where individuals can choose to upgrade the library at their own pace, or even stay behind on an older release if they don’t like the changes.
Parts of Dpowcoin, most notably the consensus rules, don’t work that way. In order for a new consensus rule to go into effect, it must be enforced by some number of miners, full nodes, or both; and once it has gone into effect, software that doesn’t know about the new rule may generate or accept invalid transactions (although upgrades are designed to prevent this from happening when possible).
For this reason, Dpowcoin Core deviates from SemVer for changes to consensus rules and other updates where network-wide adoption is necessary or desirable. Dpowcoin Core releases these changes as maintenance releases (x.y) instead of as major releases (x.0); this minimizes the size of the patch in order to make it easy for as many people as possible to inspect it, test it, and deploy it. It also makes it possible to backport the same patch to multiple previous major releases, further increasing the number of users who can easily upgrade, although there are not always enough volunteers to manage this.