Blackcoin is a decentralised digital currency with near-instant transaction speeds and negligible transaction fees built upon Proof of Stake 3.1 (PoSV3, BPoS) as introduced by the Blackcoin development team.
Blackcoin More is the name of open source software which enables use of the Blackcoin protocol. It connects to the Blackcoin peer-to-peer network to download and fully validate blocks and transactions. It also includes a wallet and graphical user interface, which can be optionally built.
For more information, as well as an immediately usable, binary version of the Blackcoin More software, see https://blackcoinmore.org.
Blackcoin More is released under the terms of the MIT license. See COPYING for more information or see https://opensource.org/licenses/MIT.
The master branch is regularly built (see doc/build-*.md for instructions) and tested. Tags are created
regularly to indicate new official, stable release versions of Blackcoin More.
The contribution workflow is described in CONTRIBUTING.md and useful hints for developers can be found in doc/developer-notes.md.
The best place to get started is to join Blackcoin Discord: https://discord.blackcoin.nl
Testing and code review might be the bottleneck for development. Please help out by testing other people's pull requests, and remember this is a security-critical project where any mistake might cost people lots of money.
Developers are strongly encouraged to write unit tests for new code, and to
submit new unit tests for old code. Unit tests can be compiled and run
(assuming they weren't disabled in configure) with: make check. Further details on running
and extending unit tests can be found in /src/test/README.md.
There are also regression and integration tests, written
in Python.
These tests can be run (if the test dependencies are installed) with: test/functional/test_runner.py
The CI (Continuous Integration) systems make sure that every pull request is built for Windows, Linux, and macOS, and that unit/sanity tests are run automatically.
Changes should be tested by somebody other than the developer who wrote the code. This is especially important for large or high-risk changes. It is useful to add a test plan to the pull request description if testing the changes is not straightforward.
Changes to translations as well as new translations can be submitted to Blackcoin More's Transifex page.
Translations might be periodically pulled from Transifex and merged into the git repository. See the translation process for details on how this works.
The develop branch is typically used by developers as the main branch for integrating new features and changes into the codebase. Pull requests should always be made to this branch (except for critical fixes), and might possibly break the code. The develop branch is considered an unstable branch, as it is constantly updated with new code, and it may contain bugs or unfinished features. It is not guaranteed to work properly on any system.
The master branch gets latest updates from the stable branch. However, it may contain experimental features and should be used with caution.
The release branch for Blackcoin More 26.x. It is intended to contain stable and functional code that has been thoroughly tested and reviewed.
The release branch for Blackcoin More 28.x. Contains functional but highly experimental code.