Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/skalenetwork/skale-consensus

Running the very core of SKL network, SKALE BFT consensus is universal, modern, modular, high-performance, asynchronous, provably-secure, agent-based Proof-of-Stake blockchain consensus engine in C++ 17. Includes provably secure embedded Oracle. Used by SKALE elastic blockchains. Easy and flexible enough to implement your own blockchain or smart contract platform. BLS signatures and Binary Asynchronous Consensus are main building blocks.
https://github.com/skalenetwork/skale-consensus

asynchronous bft consensus consistency cpp cryptography distributed-systems skale-network

Last synced: 3 months ago
JSON representation

Host: GitHub
URL: https://github.com/skalenetwork/skale-consensus
Owner: skalenetwork
License: agpl-3.0
Created: 2019-04-12T14:52:38.000Z (almost 6 years ago)
Default Branch: develop
Last Pushed: 2024-07-19T14:46:18.000Z (7 months ago)
Last Synced: 2024-08-01T22:44:36.881Z (6 months ago)
Topics: asynchronous, bft, consensus, consistency, cpp, cryptography, distributed-systems, skale-network
Language: C++
Homepage: https://docs.skale.network/technology/consensus-spec
Size: 28.4 MB
Stars: 78
Watchers: 12
Forks: 31
Open Issues: 30
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md

Awesome Lists containing this project

README

# SKALE Consensus: a BFT Consensus engine in C++

[![Discord](https://img.shields.io/discord/534485763354787851.svg)](https://discord.gg/vvUtWJB)
![Build and test skale-consensus](https://github.com/skalenetwork/skale-consensus/workflows/Build%20and%20test%20skale-consensus/badge.svg)

Skale-consensus is an **implementation of SKALE provable consensus spec** as described here https://docs.skale.network/technology/consensus-spec

Key features of of SKALE consensus

* **provably secure**
* **forkless**
* **single block finality** - blocks become immediately finalized once committed.
* **survives under arbitrarily long network distruptions and delays** by implementing asynchronous network model
* **multiple block proposers per block provide protocol stability** even if **some block proposers are down**

Read the spec for more exciting features.

The consensus is under active improvement and research.

## Installation Requirements

SKALE consensus has been built and tested on Ubuntu 18.04 and later.

The preferred build and execution environment is currenty Ubuntu 22.04.

Ensure that the required packages are installed by executing:

```bash
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo apt update
sudo apt install -yq libprocps-dev gcc-9 g++-9 valgrind gawk sed libffi-dev ccache \
libgoogle-perftools-dev flex bison yasm texinfo autotools-dev automake \
python3 python3-pip cmake libtool build-essential pkg-config autoconf wget \
git libargtable2-dev libmicrohttpd-dev libhiredis-dev redis-server openssl \
libssl-dev doxygen libgcrypt20-dev
```

### Building from source on Ubuntu (Development)

Steps to build from source:

```bash
# clone repo
git clone --recurse-submodules https://github.com/skalenetwork/skale-consensus.git
# build dependencies
cd scripts && ./build_deps.sh
# Configure the Cmake build.
cd .. && cmake . -Bbuild
# now run hunter bug workaround
mkdir -p "${HOME}"/.hunter/_Base/Download/crc32c/1.0.5/dc7fa8c/ && wget -O "${HOME}"/.hunter/_Base/Download/crc32c/1.0.5/dc7fa8c/hunter-1.0.5.tar.gz https://github.com/hunter-packages/crc32c/archive/refs/tags/hunter-1.0.5.tar.gz
# now build all targets using all available CPU cores
cmake --build build -- -j$(nproc)
```

### Running tests

Navigate to the testing directories and run `./consensusd .`

## Libraries

- [libBLS](https://github.com/skalenetwork/libBLS) by [SKALE Labs](https://skalelabs.com/)

## An important note about production readiness:

The SKALE consensus is still in active development and contains bugs. This software should be regarded as _alpha software_. Development is still subject to competing the specification, security hardening, further testing, and breaking changes. **This consensus engine has not yet been reviewed or audited for security.** Please see [SECURITY.md](SECURITY.md) for reporting policies.

## Contributing

**If you have any questions please ask our development community on [Discord](https://discord.gg/vvUtWJB).**

[![Discord](https://img.shields.io/discord/534485763354787851.svg)](https://discord.gg/vvUtWJB)

## License

[![License](https://img.shields.io/github/license/skalenetwork/skale-consensus.svg)](LICENSE)