/lbbft

Primary LanguageGo

lbbft

lbbft is an implementation of the LBBFT protocol [1]. It uses the Gorums [2] RPC framework for sending messages between replicas.

Running the examples

We have written an example client located in cmd/pbftclient and an example server located in cmd/pbftserver. These can be compiled by running make. They read a configuration file named lbbft.toml from the working directory. An example configuration that runs on localhost is included in the root of the project. To generate public and private keys for the servers, run cmd/hotstuffkeygen/hotstuffkeygen -p 'r*' -n 4 --hosts 127.0.0.1 --tls keys. To start four servers, run scripts/run_servers.sh with any desired options. To start the client, run cmd/pbftclient/pbftclient.

Protoc安装

  1. 下载 protoc v3.11.2:https://github.com/google/protobuf/releases
  2. 下载protoc关于Go代码的生成器:go get google.golang.org/protobuf/cmd/protoc-gen-go
  3. 下载Gorums插件: go get github.com/relab/gorums/cmd/protoc-gen-gorums
  4. 2步骤下载的内容不兼容,需要把1中解压的include/google覆盖到$GOPATH\pkg\mod\github.com\gogo\protobuf@v1.2.1\protobuf\google。

References

[1] Castro, Miguel, and Barbara Liskov. "Practical Byzantine fault tolerance." OSDI. Vol. 99. No. 1999. 1999.

[2] Tormod Erevik Lea, Leander Jehl, and Hein Meling. Towards New Abstractions for Implementing Quorum-based Systems. In 37th International Conference on Distributed Computing Systems (ICDCS), Jun 2017.

grpc error排查

  1. 有返回值的rpc,不能直接返回nil。
  2. rpc的输入参数,发送的时候,注意不要修改。