Practical overview
When it fits
Use the repository when you need to inspect or build the SKALE consensus implementation, study its protocol specification, or work with its documented test workflows.
Who it is for
- Blockchain developers exploring or integrating a consensus engine into a SKALE-compatible node.
- Engineers studying asynchronous Byzantine agreement, block finality or consensus behavior.
- Developers building and examining multi-node consensus tests.
Documented uses
- Review the protocol specification and C++ implementation.
- Build the engine from source in the documented Ubuntu environment.
- Run the included unit, integration, end-to-end and tagged test suites.
- Use the testing guide to investigate multi-node scenarios, including SGX simulation.
Requirements & limits
The repository is public and identifies its license as AGPL-3.0.
- The implementation is written in C++ and the preferred build environment is Ubuntu 22.04.
- The design describes asynchronous Byzantine Binary Agreement, BLS signatures and threshold encryption.
- The repository includes specification and test resources as well as implementation code.
- The README's performance and resilience statements are project claims, not independently verified results.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Build the consensus engine from source
Configure and compile the repository in Debug mode on the documented Ubuntu environment.
Before you start
- Ubuntu 22.04 is the preferred documented environment.
- Install the packages listed in the repository README, including GCC 11, CMake, Git and the specified development libraries.
Steps
Clone the repository with its submodules using the README command.
Build dependencies in debug mode from the deps directory with ./build.sh DEBUG=1.
Configure a Debug CMake build with cmake . -Bbuild -DCMAKE_BUILD_TYPE=Debug.
Build all targets with cmake --build build -- -j$(nproc).
Expected outcome
A Debug build of the repository's targets.
Guide limitations
- The README says later Ubuntu versions may work but are not officially tested.
- These are repository instructions, not a report of an independently performed build.
Run the documented one-node basic test
Use the built test executable for the README's basic one-node test invocation.
Before you start
- Complete the repository build first.
- The README's invocation uses sudo and runs from test/onenode.
Steps
Change to the test/onenode directory.
Run the documented command with NO_ULIMIT_CHECK=1, TEST_TIME_S=60 and TEST_TRANSACTIONS_PER_BLOCK=10, passing [consensus-basic] to ../../build/consensust.
Expected outcome
The basic one-node test is invoked with the README's stated duration and transactions-per-block setting.
Guide limitations
- The README does not state a test result in the cited instructions.
- The more detailed multi-node scenarios are covered separately in TESTING.md.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 13 October 2026
- Original website title
- skalenetwork/skale-consensus · Official homepage title · retained in its source language

