github.com/filecoin-project/lotus

Reference implementation of the Filecoin protocol, written in Go

Open this visualization on its own page →

Contributors

221

Lines of Code

41,617

From

2019-06-25

To

2022-07-28

About filecoin-project/lotus

Lotus is the reference implementation of the Filecoin protocol, a distributed storage network written in Go. It provides a complete suite of tools for participating in the Filecoin network, including the main lotus daemon, lotus-miner for storage providers, and lotus-worker for computational resources. The project handles blockchain synchronization, smart contract execution through builtin actors, and storage market interactions through integrated modules like go-fil-markets.

The codebase requires Go 1.25.7 or higher and various system dependencies depending on the operating system, with detailed build instructions provided for Ubuntu, Debian, Fedora, and macOS. Users can join different Filecoin networks including mainnet by checking out appropriate releases or branches, with the master branch serving as the development version. The project includes optional monitoring capabilities through Prometheus and Grafana integration, and supports configuration customization through environment variables.

Lotus is actively maintained by the Filecoin project with a focus on security and stability. The project welcomes community contributions and maintains related independent but tightly integrated modules that form a complete Filecoin implementation. It is dual-licensed under MIT and Apache 2.0.

Share this video