Welcome to a Rust library of the Honey Badger Byzantine Fault Tolerant (BFT) consensus algorithm. The research and protocols for this algorithm are explained in detail in "The Honey Badger of BFT Protocols" by Miller et al., 2016.
Following is an overview of HoneyBadger BFT and basic instructions for getting started.
Note: This library is a work in progress and parts of the algorithm are still in development.
The Honey Badger consensus algorithm allows nodes in a distributed, potentially asynchronous environment to achieve agreement on transactions. The agreement process does not require a leader node, tolerates corrupted nodes, and makes progress in adverse network conditions. Example use cases are decentralized databases and blockchains.
Honey Badger is Byzantine Fault Tolerant. The protocol can reach consensus with a number of failed nodes f (including complete takeover by an attacker), as long as the total number N of nodes is greater than 3 * f.
Honey Badger is asynchronous. It does not make timing assumptions about message delivery. An adversary can control network scheduling and delay messages without impacting consensus.
Honey Badger is a modular library composed of several independent algorithms. To reach consensus, Honey Badger proceeds in epochs. In each epoch, participating nodes broadcast a set of encrypted data transactions to one another and agree on the contents of those transactions.
In an optimal networking environment, output includes data sent from each node. In an adverse environment, the output is an agreed upon subset of data. Either way, the resulting output contains a batch of transactions which is guaranteed to be consistent across all nodes.
In addition to validators, the algorithms support observers: These don't actively participate, and don't need to be trusted, but they receive the output as well, and are able to verify it under the assumption that more than two thirds of the validators are correct.
-
Honey Badger: Each node inputs transactions. The protocol outputs a sequence of batches of transactions.
-
Dynamic Honey Badger: A modified Honey Badger where nodes can dynamically add and remove other nodes to/from the network.
-
Queueing Honey Badger: Works exactly like Dynamic Honey Badger, but includes a built in transaction queue.
-
Subset: Each node inputs data. The nodes agree on a subset of suggested data.
-
Broadcast: A proposer node inputs data and every node receives this output.
-
Binary Agreement: Each node inputs a binary value. The nodes agree on a value that was input by at least one correct node.
-
Coin: A pseudorandom binary value used by the Binary Agreement protocol.
-
Threshold Decryption: Each node inputs the same ciphertext, encrypted to the public master key, and outputs the decrypted data.
-
Synchronous Key Generation A dealerless algorithm that generates keys for threshold encryption and signing. Unlike the other algorithms, this one is completely synchronous and should run on top of Honey Badger (or another consensus algorithm)
- Threshold Crypto: A threshold cryptosystem for collaborative message decryption and signature creation.
This library requires a distributed network environment to function. Details on network requirements TBD.
Note: Additional examples are currently in progress.
Requires Rust 1.29 or higher and cargo
: installation instructions. The library is tested against the stable
release channel.
$ cargo build [--release]
$ MLOCK_SECRETS=false cargo test --release
The MLOCK_SECRETS envvar is associated with the threshold_crypto
dependency and should only be used in development and testing. The test suite can run without setting MLOCK_SECRETS=false
, however, it runs faster when it is set and ensures tests won't fail if the testing system's locked memory limit is reached.
See the tests README for more information on our testing toolkit.
A basic example is included to run a network simulation.
$ cargo run --example simulation --release
Heading | Definition |
---|---|
Epoch | Epoch number. In each epoch, transactions are processed in a batch by simulated nodes (default is 10 nodes) on a network. The batch is always output in one piece, with all transactions at once. |
Min Time | Time in simulated milliseconds until the first correct (i.e. not faulty) node outputs the batch. |
Max Time | Time in simulated milliseconds until the last correct node outputs the batch. |
Txs | Number of transactions processed in the epoch. |
Msgs/Node | Average number of messages handled by a node. The counter is cumulative and includes the number of messages handled in the current epoch and all previous epochs. |
Size/Node | Average message size (in converted bytes) handled by a node. This is cumulative and includes message size for the current epoch and all previous epochs. |
Set different parameters to simulate different transaction and network conditions.
Flag | Description |
---|---|
-h, --help |
Show help options |
--version |
Show the version of hbbft |
-n <n>, --nodes <n> |
The total number of nodes [default: 10] |
-f <f>, --faulty <f> |
The number of faulty nodes [default: 0] |
-t <txs>, --txs <txs> |
The number of transactions to process [default: 1000] |
-b <b>, --batch <b> |
The batch size, i.e. txs per epoch [default: 100] |
-l <lag>, --lag <lag> |
The network lag between sending and receiving [default: 100] |
--bw <bw> |
The bandwidth, in kbit/s [default: 2000] |
--cpu <cpu> |
The CPU speed, in percent of this machine's [default: 100] |
--tx-size <size> |
The size of a transaction, in bytes [default: 10] |
Examples:
# view options
$ cargo run --example simulation --release -- -h
# simulate a network with 12 nodes, 2 of which are faulty
$ cargo run --example simulation --release -- -n 12 -f 2
# increase batch size to 500 transactions per epoch
$ cargo run --example simulation --release -- -b 500
See Issues for all tasks.
- Create additional adversarial scenarios and tests
- Networking example to detail Honey Badger implementation
Our implementation modifies the protocols described in "The Honey Badger of BFT Protocols" in several ways:
- We use a pairing elliptic curve library to implement pairing-based cryptography using a Barrento-Lynn-Scott (BLS12-381) curve.
- We add a
Terminate
message to the Binary Agreement algorithm. Termination occurs following output, preventing the algorithm from running (or staying in memory) indefinitely. (#53) - We add a
Conf
message to the Binary Agreement algorithm. An additional message phase prevents an attack if an adversary controls a network scheduler and a node. (#37) - We return additional information from the Subset and Honey Badger algorithms that specifies which node input which data. This allows for identification of potentially malicious nodes.
- We include a Distributed Key Generation (DKG) protocol which does not require a trusted dealer; nodes collectively generate a secret key. This addresses the problem of single point of failure. See Distributed Key Generation in the Wild.
We have simplified algorithm naming conventions from the original paper.
Algorithm Name | Original Name |
---|---|
Honey Badger | HoneyBadgerBFT |
Subset | Asynchronous Common Subset (ACS) |
Broadcast | Reliable Broadcast (RBC) |
Binary Agreement | Binary Byzantine Agreement (BBA) |
Coin | Common Coin |
See the CONTRIBUTING document for contribution, testing and pull request protocol.
Licensed under either of:
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
-
Other language implementations