http://www.xiaoyenzi.com

Filecoin(go-filecoin)挖矿系统要求

go-filecoin
o-filecoin的问题或问题?首先询问社区。您的问题可能已经解决了。
想要连接到devnet(开发者网络)?请参阅下面的“ 使用”部分

目录

  • 什么是Filecoin?
  • 安装
    • 系统要求
  • 从源安装
    • 安装Go和Rust
    • 安装依赖项
    • 构建,运行测试和安装
    • 手动管理子模块(可选)
  • 用法
  • 高级用法
    • 设置localnet
  • 特约
  • 社区
  • 开发者网络
  • 执照

什么是Filecoin?

Filecoin是一个分散的存储网络,将世界上未使用的存储转变为算法市场,为网络创造一个永久的,分散的未来。矿工通过提供数据存储和/或检索来获得本机协议令牌(也称为“filecoin”)。客户支付矿工存储或分发数据并检索数据。查看Filecoin的工作原理了解更多信息。
警告:go-filecoin正在进行中,尚未准备好进行生产使用。有关已知漏洞的概述,请参阅KNOWN_ISSUES。

安装

波 欢迎来到Filecoin!

系统要求

Filecoin可以在大多数具有至少8GB RAM的Linux和MacOS系统上构建和运行。Windows尚不支持。

从源安装

克隆git存储库:
mkdir -p $ {GOPATH} /src/github.com/filecoin-project
git clone https://github.com/filecoin-project/go-filecoin.git $ {GOPATH} /src/github.com/filecoin-project/go-filecoin
现在安装下面列出的工具和依赖项。如果您在构建go-filecoin时遇到任何问题,请参阅Troubleshooting&FAQ Wiki页面。

安装Go和Rust

go-filecoin的构建过程需要:
  • Go > = v1.12.1
    • 首次安装Go?我们推荐本教程,其中包括环境设置。
  • Rust > = v1.36.0和cargo
  • pkg-config - 由go-filecoin用于处理生成链接器标志
  • Mac OS开发人员可以通过brew安装 brew install pkg-config
由于我们的使用cgo,你需要一个C编译器来构建go-filecoin,无论你是使用预构建的libsector_builder_ffi(我们的cgo兼容的防锈文件库)还是自己从源代码构建它。如果您想在构建go-filecoin时使用gcc(例如export CC=gcc),则需要使用v7.4.0或更高版本。
  • 您必须在链接器搜索路径上使用libclang才能从源代码构建防锈文件。您可以使用您喜欢的包管理器安装Clang,从而在大多数环境中满足此要求。

安装依赖项

go-filecoin取决于一些用Rust编写的证明代码,它们存放在 防锈滤波器中并作为子模块使用。您需要拥有cargojq安装。
首先,我们需要加载所有子模块。
git submodule update --init --recursive
要安装golangci-lint和其他构建和测试依赖项(使用预编译的证明,建议),运行:
cd  $ {GOPATH} /src/github.com/filecoin-project/go-filecoin
FILECOIN_USE_PRECOMPILED_RUST_PROOFS = true go run ./build deps
注意:第一次运行deps可能会很慢,因为~1.6GB参数文件是在本地下载或生成的/tmp/filecoin-proof-parameters。有耐心; 未来的运行会更快。

构建,运行测试和安装

#首先,构建二进制文件
去运行./build build

#将go-filecoin安装到$ {GOPATH} / bin(测试必需)
去运行./build安装

#然后,运行单元测试。
去运行./build test

#构建和测试可以组合!
去运行./build最好
其他方便的构建命令包括:
#检查代码的样式和正确性问题
去运行./build lint

#通过切换标志运行不同类别的测试 
运行./build test -unit= false-integration= true -functional = true

#使用覆盖率报告 
进行测试运行./build test -cover

#使用Go的竞争条件检测和警告进行测试(参见https://blog.golang.org/race-detector)go 
run ./build test -race

# Deps,Lint,Build,Test(任何args将被传递给`test`) 
去运行./build all
注意:传递给go run ./build test(例如-cover)的任何标志都将被传递给go test
如果您在构建时遇到问题,请参阅Troubleshooting&FAQ Wiki页面。

手动管理子模块(可选)

如果您正在编辑rust-fil-proofs,则需要手动管理子模块。如果您没有编辑,rust-fil-proofs您可以放松: deps构建(上面)将为您完成。deps如果子模块由其他人更新(它将显示为已修改git status),则可能需要在拉取主模式后再次运行。
要初始化子模块:
cd  $ {GOPATH} /src/github.com/filecoin-project/go-filecoin
git submodule update --init
稍后,当rust-fil-proofs master分支的头部发生更改时,您可能希望更新go-filecoin以使用这些更改:
git submodule update --remote
请注意,rust-fil-proofs以这种方式更新子模块将需要提交go-filecoin(更改子模块哈希)。

用法

“ 入门”维基页面包含一个简单的序列,用于启动和运行Filecoin节点并连接到devnet。
“ 命令”页面包含有关特定命令和环境变量的更多详细信息,以及用于设置矿工和进行交易的脚本。
要查看完整的命令列表,请运行go-filecoin --help

高级用法

使用不同的代码连接到devnet

为了防止用户错误,已将代码添加到filecoin中,这使得在没有正确代码的情况下很难意外连接到用户或登台devnet。如果您正在积极开发filecoin并希望检查代码与这些devnet的兼容性,您仍然可以在devnet上运行您的节点。这是通过使用以下命令构建filecoin来完成的:
FILECOIN_OVERRIDE_BUILD_SHA=<SHA OF CURRENT FILECOIN RELEASE> go run ./build build 
此构建步骤将允许您的节点使用正确的代码将自身显示为网络上的节点。

设置localnet

localnet FAST二进制工具允许用户在用户计算机上快速轻松地设置本地网络。有关更多信息,请参阅localnet README。localnet工具仅在与目标go-filecoin二进制文件相同的git ref构建时才兼容。

特约

我们 心我们所有的贡献者; 如果没有你,这个项目就不会是这样!如果您想提供帮助,请参阅CONTRIBUTING.md。
查看Go-Filecoin代码概述,了解代码的简要介绍。

社区

以下是一些获取帮助并与Filecoin社区联系的地方:
  • 文档Wiki - 用于教程,故障排除和常见问题解答
  • Filecoin Project Slack或Matrix / Riot#fil-dev上的频道- 用于实时帮助和一些开发讨论
  • Filecoin社区论坛 - 用于讨论设计决策,用例,实施建议和长时间运行的对话
  • GitHub问题 - 目前,仅用于报告错误,查看或促进正在进行的开发。PR欢迎!请参阅我们的贡献指南。
  • Filecoin项目规范 - Filecoin应该如何工作
寻找更多?请参阅filecoin-project / community的完整纲要。

开发者网络

目前有3个开发人员网络(也称为devnet)可用于开发和测试。这些都会经常停机并且会发生变化。有关这些开发人员网络的说明以及将节点连接到这些网络的说明,请参阅Wiki中的Devnets。

执照

Filecoin项目在Apache 2.0和MIT术语下是双重许可的:
  • Apache许可证,版本2.0,(LICENSE-APACHE或http://www.apache.org/licenses/LICENSE-2.0)
  • 麻省理工学院许可证(LICENSE-MIT或http://opensource.org/licenses/MIT)

郑重声明:本文版权归原作者所有,转载文章仅为传播更多信息之目的,如作者信息标记有误,请第一时间联系我们修改或删除,多谢。