filbench

README

filbench

Filecoin benchmarking tool

Background

Filecoin is currently under active development by the Protocol Labs, and developers or miners can use go-filecoin or lotus to participate in the devnet. However, there is a lack of a utility that can quickly test some of Filecoin's key algorithms (such as PoRep and PoSt), which is not conducive to the miners evaluating the performance of commercial mining hardware as good as the manufacturer claims. Therefore, a simple and practical benchmarking tool filbench has been developed by us, hoping to help developers and miners to a certain extent.

Filecoin 目前正由协议实验室紧张开发中，开发者或矿工可以使用 go-filecoin 或 lotus 来参与开发者测试网。然而缺少一款可以迅速测试 Filecoin 的某些关键算法（比如复制证明和时空证明）的实用工具，这也不利于矿工评测商业矿机的性能是否如厂家宣称的那样棒。因此，filbench 这样一个简洁实用的基准测试工具就被我们开发了，希望在一定程度上能够帮助开发者和矿工。

Install

The released binary can be downloaded:

$ wget https://github.com/filcloud/filbench/releases/download/0.0.1/filbench-0.0.1-ubuntu-18.04-amd64.tar.gz
$ tar zxvf filbench-0.0.1-ubuntu-18.04-amd64.tar.gz
$ mv filbench /usr/local/bin/

Or, you can clone this project and compile it.

This project depends on go-filecoin now, so you should ensure that it has been in your GOPATH directory.

Then, install filbench:

$ mkdir -p ${GOPATH}/src/github.com/filcloud
$ cd ${GOPATH}/src/github.com/filcloud
$ git clone https://github.com/filcloud/filbench.git
$ cd filbench
$ go install

Usage

Initialize filbench repo directory (default to ~/.filbench):

$ filbench init

Generate several pieces of 254MB (here is 2), and seal them into sectors of 256MB (i.e. PoRep):

$ filbench sector-builder generate-piece --piece-num 2

Verify the results of PoRep above:

$ filbench sector-builder verify-sectors-porep

Generate PoSt of those sealed sectors, and verify them:

$ filbench sector-builder verify-sectors-post

Maintainers

@RideWindX.

Contributing

Feel free to dive in! Open an issue or submit PRs.

License

MIT © FilCloud