Repository files navigation

Stratus is a shared Mempool protocol that effectively addresses the communication bottleneck of leader-based Byzantine fault-tolerant (BFT) consensus protocols. For technical details, please find thepaper, which has been accepted toICDE'23.

We implemented Stratus and integrated it with state-of-the-art BFT protocols,HotStuff andStreamlet, based onBamboo, which is an open source project for prototyping, evaluating, and benchmarking BFT consensus and replication protocols.The native implementations of HotStuff and Streamlet can also be found inBamboo.

WARNING: This is an academic proof-of-concept prototype, and in particular has not received careful code review. This implementation is NOT ready for production use.

Protocols:

• HotStuff with a simple shared Mempool (SMP-HS)
• Stratus enabled HotStuff (S-HS)
• Stratus enabled Streamlet (S-SL)
• HotStuff with a gossip-based shared Mempoo (S-HS-G)

Features:

• Benchmarking

1. InstallGo.

2. Download Bamboo-Stratus source code.

3. Buildserver andclient.

cd bamboo/bingo build ../servergo build ../client

Users can run the protocols in simulation (single process) or deployment.

In simulation mode, replicas are running in separate Goroutines and messages are passing via Go channel.

1. cd bamboo/bin

2. Modifyips.txt with a set of IPs of each node. The number of IPs equals to the number of nodes. Here, the local IP is127.0.0.1. Each node will be assigned by an increasing port from8070.

3. Modify configuration parameters inconfig.json.

4. Modifysimulation.sh to specify the name of the protocol you are going to run.

5. Runserver and then runclient using scripts. Note that the number followed by therunClient.sh is the number of clients that you wish to run.

./simulation.sh

./runClient.sh 10

6. Close the simulation by stopping the client and the server in order.

./closeClient.sh./stop.sh

Logs are produced in the local directory with the name ofclient/server.xxx.log wherexxx is the pid of the process.

Nodes can be deployed in a real network.

1. cd bamboo/bin/deploy/linux

2. Authorize remote servers (send local public key to the remote) by adding the IP list intoauth/server_auth.txt and modifying the user name and password inauth/server_auth.json. Then, run the script.

./auth/server_auth.sh

3. Buildserver andclient.
4. Specify external IPs and internal IPs of server nodes inpub_ips.txt andips.txt, respectively.
5. IPs of machines running as clients are specified inclients.txt.
6. The type of the protocol is specified inrun.sh.
7. Modify configuration parameters inconfig.json.
8. Upload binaries and config files onto the remote machines.

./deploy.sh./setup_cli.sh

9. Start the server nodes.

./start_server.sh

10. Start the clients by specifying no. of clients running on each machine.

./start_client.sh 10

11. Stop the client and server.

./exp_stop.sh

During each run, one can view the statistics (throughput, latency, view number, etc.) at a node via a browser.

http://127.0.0.1:8070/query

where127.0.0.1:8070 can be replaced with the actual node address.