This repository hosts the Riecoin Core source code. Riecoin Core connects to the Bitcoin 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.
Guides and release notes are available on the project's page on Riecoin.xyz.
Riecoin is a currency based on Bitcoin, and follows in its footsteps into becoming a world currency. The Project supports and concretizes the idea that the gigantic mining resources can also serve scientific research, thus power a world currency of greater value for the society.
Riecoin miners are not looking for useless hashes, but doing actual scientific number crunching, like in Folding@Home or the GIMPS (currently, they are looking for prime constellations).
The project broke and holds several number theory world records, and demonstrated that scientific computations can be done using the PoW concept, and at the same time power a secure and practical international currency. It effectively solves the Bitcoin's power consumption issue without resorting to ideas like PoS that enrich the richer by design and makes value out of thin air.
Visit Riecoin.xyz to learn more about Riecoin.
Here are basic build instructions to generate the Riecoin Core binaries, including the Riecoin-Qt GUI wallet.
First, get the build tools and dependencies, which can be done by running as root the following commands.
apt install build-essential cmake pkg-config bsdmainutils python3
apt install libevent-dev libboost-system-dev libboost-filesystem-dev libboost-test-dev libboost-thread-dev qt6-base-dev qt6-tools-dev qt6-l10n-tools qt6-wayland libgmp-dev libsqlite3-dev libqrencode-dev libcapnp-dev capnprotoGet the source code.
git clone https://github.com/RiecoinTeam/Riecoin.gitThen,
cd Riecoin
cmake -B build -DBUILD_GUI=ON
cmake --build buildThe Riecoin-Qt binary is located in build/bin. You can run strip riecoin-qt to reduce its size a lot, or build without the Qt Gui with
cd Riecoin
cmake -B build
cmake --build buildThe build can be speed up by appending -j N to the last command, which runs N parallel jobs.
Riecoin can be built using Guix. The process is longer, but also deterministic: everyone building this way should obtain the exact same binaries. Distributed binaries are produced this way, so anyone can ensure that they were not created with an altered source code by building themselves using Guix.
You should have a lot of free disk space (at least 40 GB), and 16 GB of RAM or more is recommended. Read the Guix Guide for installation instructions and more.
Now, get the Riecoin Core source code.
git clone https://github.com/RiecoinTeam/Riecoin.gitStart the Guix build. The environment variable will set which binaries to build (here, Linux x64, Linux Arm64, and Windows x64, but it is possible to add other architectures or Mac with an SDK).
export HOSTS="x86_64-linux-gnu aarch64-linux-gnu x86_64-w64-mingw32"
cd Riecoin
./contrib/guix/guix-buildIt will be very long, do not be surprised if it takes an hour or more, even with a powerful machine, though subsequent builds will be faster as some steps are cached. The binaries will be generated in a guix-build-.../output folder.
Either build using Guix as explained above in a spare physical or virtual machine, or refer to the Bitcoin's Documentation (build-... files) and adapt the instructions for Riecoin if needed.
Most Boost and Python Bitcoin Tests were ported for Riecoin. These should all pass after every code change, unless it is precised in the test_runner.py file that a particular Test may fail. In order to run them,
build/bin/test_riecoin # Boost Test Suite
build/test/functional/test_runner.py # Python Functional Tests, use -j N for N jobs
build/bin/test_riecoin-qt # Riecoin-Qt TestsHere are examples in order to run a particular test (check the Source Code regarding the names of the Boost Tests),
build/src/test/test_riecoin --run_test=getarg_tests
build/src/test/test_riecoin --run_test=getarg_tests/doubledash
build/src/test/test_riecoin --log_level=all --run_test=getarg_tests/doubledash
build/test/functional/mining_basic.pyCurrently, the Cirrus Ci was not ported, and Fuzz Tests are not checked beyond being able to compile. Given the current very limited development resources, successfully running the Tests above and not encountering major issues in normal use of Riecoin Core is deemed sufficient.
The Riecoin Core code is published under the terms of the MIT license. See COPYING for more information or see https://opensource.org/licenses/MIT.
However, releases are under the terms of the Gnu General Public License Version 3 (GPLv3) since Riecoin Core uses some GPL licensed software.
Please do not profit off the permissive licenses to create yet more cryptos, there are already way too many of these out there. If you like Bitcoin or Riecoin, then support these Projects directly, contribute Code, mine and hold BTC and RIC. Otherwise, surely there is already one out there suiting your purposes, or one close enough with maintainers happy to work out with you. Every new coin naturally becomes yet another rival to existing ones that divides further resources by needing separate maintenance and upgrades, sites, explorers, listing payments, etc. when people could instead join forces. For these reasons, we adopt a Maximalist philosophy.