{"id":13623136,"url":"https://github.com/filecoin-project/lotus","last_synced_at":"2025-05-15T00:05:49.454Z","repository":{"id":37420284,"uuid":"193681111","full_name":"filecoin-project/lotus","owner":"filecoin-project","description":"Reference implementation of the Filecoin protocol, written in Go","archived":false,"fork":false,"pushed_at":"2025-05-12T22:13:40.000Z","size":336633,"stargazers_count":2921,"open_issues_count":599,"forks_count":1306,"subscribers_count":129,"default_branch":"master","last_synced_at":"2025-05-13T14:21:29.297Z","etag":null,"topics":["blockchain","filecoin","golang","ipfs"],"latest_commit_sha":null,"homepage":"https://lotus.filecoin.io/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/filecoin-project.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-06-25T09:52:07.000Z","updated_at":"2025-05-11T15:03:03.000Z","dependencies_parsed_at":"2023-10-13T08:45:29.406Z","dependency_job_id":"fbfc3e5a-e1d5-4d89-b956-dee14ff73434","html_url":"https://github.com/filecoin-project/lotus","commit_stats":{"total_commits":15953,"total_committers":316,"mean_commits":"50.484177215189874","dds":0.7566601893060867,"last_synced_commit":"471819bf1ef8a4d5c7c0476a38ce9f5e23c59bfc"},"previous_names":["filecoin-project/go-lotus"],"tags_count":427,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filecoin-project%2Flotus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filecoin-project%2Flotus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filecoin-project%2Flotus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filecoin-project%2Flotus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/filecoin-project","download_url":"https://codeload.github.com/filecoin-project/lotus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254249199,"owners_count":22039029,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","filecoin","golang","ipfs"],"created_at":"2024-08-01T21:01:28.553Z","updated_at":"2025-05-15T00:05:44.386Z","avatar_url":"https://github.com/filecoin-project.png","language":"Go","funding_links":[],"categories":["Go","代码下载地址","Projects","Networks / Blockchains","Web 3.0","Uncategorized"],"sub_categories":["Uncategorized"],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://lotus.filecoin.io/\" title=\"Filecoin Docs\"\u003e\n    \u003cimg src=\"documentation/images/lotus_logo_h.png\" alt=\"Project Lotus Logo\" width=\"244\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eProject Lotus - 莲\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/filecoin-project/lotus/actions/workflows/build.yml\"\u003e\u003cimg src=\"https://github.com/filecoin-project/lotus/actions/workflows/build.yml/badge.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/filecoin-project/lotus/actions/workflows/check.yml\"\u003e\u003cimg src=\"https://github.com/filecoin-project/lotus/actions/workflows/check.yml/badge.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/filecoin-project/lotus/actions/workflows/test.yml\"\u003e\u003cimg src=\"https://github.com/filecoin-project/lotus/actions/workflows/test.yml/badge.svg\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://goreportcard.com/report/github.com/filecoin-project/lotus\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/filecoin-project/lotus\" /\u003e\u003c/a\u003e\n  \u003ca href=\"\"\u003e\u003cimg src=\"https://img.shields.io/badge/golang-%3E%3D1.23.6-blue.svg\" /\u003e\u003c/a\u003e\n  \u003cbr\u003e\n\u003c/p\u003e\n\nLotus is an implementation of the Filecoin Distributed Storage Network. For more details about Filecoin, check out the [Filecoin Spec](https://spec.filecoin.io).\n\n## Building \u0026 Documentation\n\n\u003e [!NOTE]\n\u003e The default `master` branch is the dev branch, please use with caution. For the latest stable version, checkout the [latest release](https://github.com/filecoin-project/lotus/blob/master/LOTUS_RELEASE_FLOW.md#why-is-the-releases-branch-deprecated-and-what-are-alternatives).\n\nFor complete instructions on how to build, install and setup lotus, please visit [https://lotus.filecoin.io](https://lotus.filecoin.io/lotus/install/prerequisites/#supported-platforms). Basic build instructions can be found further down in this readme.\n\n## Reporting a Vulnerability\n\nPlease send an email to security@filecoin.org. See our [security policy](SECURITY.md) for more details.\n\n## Related packages\n\nThese repos are independent and reusable modules, but are tightly integrated into Lotus to make up a fully featured Filecoin implementation:\n\n- [go-fil-markets](https://github.com/filecoin-project/go-fil-markets) which has its own [kanban work tracker available here](https://app.zenhub.com/workspaces/markets-shared-components-5daa144a7046a60001c6e253/board)\n- [builtin-actors](https://github.com/filecoin-project/builtin-actors)\n\n## Contributing\n\nWe welcome contributions to Lotus! Please see our [Contributing Guide](CONTRIBUTING.md) for more details on how to get started.\n\n## Basic Build Instructions\n**System-specific Software Dependencies**:\n\nBuilding Lotus requires some system dependencies, usually provided by your distribution.\n\nUbuntu/Debian:\n```\nsudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git bzr jq pkg-config curl clang build-essential hwloc libhwloc-dev wget -y \u0026\u0026 sudo apt upgrade -y\n```\n\nFedora:\n```\nsudo dnf -y install gcc make git bzr jq pkgconfig mesa-libOpenCL mesa-libOpenCL-devel opencl-headers ocl-icd ocl-icd-devel clang llvm wget hwloc hwloc-devel\n```\n\nFor other distributions you can find the required dependencies [here.](https://lotus.filecoin.io/lotus/install/prerequisites/#supported-platforms) For instructions specific to macOS, you can find them [here.](https://lotus.filecoin.io/lotus/install/macos/)\n\n#### Go\n\nTo build Lotus, you need a working installation of [Go 1.23.7 or higher](https://golang.org/dl/):\n\n```bash\nwget -c https://golang.org/dl/go1.23.7.linux-amd64.tar.gz -O - | sudo tar -xz -C /usr/local\n```\n\n**TIP:**\nYou'll need to add `/usr/local/go/bin` to your path. For most Linux distributions you can run something like:\n\n```shell\necho \"export PATH=$PATH:/usr/local/go/bin\" \u003e\u003e ~/.bashrc \u0026\u0026 source ~/.bashrc\n```\n\nSee the [official Golang installation instructions](https://golang.org/doc/install) if you get stuck.\n\n### Build and install Lotus\n\nOnce all the dependencies are installed, you can build and install the Lotus suite (`lotus`, `lotus-miner`, and `lotus-worker`).\n\n1. Clone the repository:\n\n   ```sh\n   git clone https://github.com/filecoin-project/lotus.git\n   cd lotus/\n   ```\n\nNote: The default branch `master` is the dev branch where the latest new features, bug fixes and improvement are in. However, if you want to run lotus on Filecoin mainnet and want to run a production-ready lotus, get the [latest release](https://github.com/filecoin-project/lotus/blob/master/LOTUS_RELEASE_FLOW.md#why-is-the-releases-branch-deprecated-and-what-are-alternatives).\n\n2. To join mainnet, checkout the [latest release](https://github.com/filecoin-project/lotus/blob/master/LOTUS_RELEASE_FLOW.md#why-is-the-releases-branch-deprecated-and-what-are-alternatives).\n\n   If you are changing networks from a previous Lotus installation or there has been a network reset, read the [Switch networks guide](https://lotus.filecoin.io/lotus/manage/switch-networks/) before proceeding.\n\n   For networks other than mainnet, look up the current branch or tag/commit for the network you want to join in the [Filecoin networks dashboard](https://network.filecoin.io), then build Lotus for your specific network below.\n\n   ```sh\n   git checkout \u003ctag_or_branch\u003e\n   # For example:\n   git checkout \u003cvX.X.X\u003e # tag for a release\n   ```\n\n   Currently, the latest code on the _master_ branch corresponds to mainnet.\n\n3. If you are in China, see \"[Lotus: tips when running in China](https://lotus.filecoin.io/lotus/configure/nodes-in-china/)\".\n4. This build instruction uses the prebuilt proofs binaries. If you want to build the proof binaries from source check the [complete instructions](https://lotus.filecoin.io/lotus/install/prerequisites/). Note, if you are building the proof binaries from source, [installing rustup](https://lotus.filecoin.io/lotus/install/linux/#rustup) is also needed.\n\n5. Build and install Lotus:\n\n   ```sh\n   make clean all #mainnet\n\n   # Or to join a testnet or devnet:\n   make clean calibnet # Calibration with min 32GiB sectors\n\n   sudo make install\n   ```\n\n   This will put `lotus`, `lotus-miner` and `lotus-worker` in `/usr/local/bin`.\n\n   `lotus` will use the `$HOME/.lotus` folder by default for storage (configuration, chain data, wallets, etc). See [advanced options](https://lotus.filecoin.io/lotus/configure/defaults/#environment-variables) for information on how to customize the Lotus folder.\n\n6. You should now have Lotus installed. You can now [start the Lotus daemon and sync the chain](https://lotus.filecoin.io/lotus/install/linux/#start-the-lotus-daemon-and-sync-the-chain).\n\n7. (Optional) Follow the [Setting Up Prometheus and Grafana](https://github.com/filecoin-project/lotus/tree/master/metrics/README.md) guide for detailed instructions on setting up a working monitoring system running against a local running lotus node.\n\n## License\n\nDual-licensed under [MIT](https://github.com/filecoin-project/lotus/blob/master/LICENSE-MIT) + [Apache 2.0](https://github.com/filecoin-project/lotus/blob/master/LICENSE-APACHE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilecoin-project%2Flotus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffilecoin-project%2Flotus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilecoin-project%2Flotus/lists"}