lotus文档

于6月16号写

1 Lotus介绍

Lotus是用Go编写的Filecoin分布式存储网络(Filecoin Distributed Storage Network) 的一个实现。 想要了解filecoin。

Lotus是由一套命令行的应用程序组成：

• lotus 节点(lotus)：验证网络交易，管理FIL钱包，发起存储请求和检索交易。
• lotus矿工(lotus-miner)：接收存储，封存扇区。(不能单独运行，必须先运行lotus)
• lotus工人(lotus-worker)：辅助矿工封存扇区。(可以单独运行)

1.1 配置参考

• 如果只运行lotus，至少需要8核CPU和32GiB内存。硬盘必须使用固态硬盘，最好大于1TiB。如果硬盘读写慢，lotus节点会跟不上链的增长。链的信息会不断增加，所以硬盘迟早会被写满，所以硬盘越大越好。
• 如果需要运行lotus-miner或lotus-worker，至少8核CPU和128GiB内存。封存(seal)的速度跟CPU、GPU、内存和硬盘的读写速度有关，用来运行封存的硬盘必须大于1TiB。用来存储的硬盘最好大于20TiB，因为现在只有算力达到10TiB才会有区块奖励，而且存储算力会有一部分冗余。
• GPU能更快的加速获得block rewards(区块奖励)，如GeForce RTX 2080 Ti 。
• 如果只有128GiB的RAM，那么在SSD上启用256GB的NVMe swap将有助于避免挖掘时出现内存不足问题。

1.2 可以运行的操作系统

Lotus支持大多数的Linux和MacOS ,目前不支持Windows。
支持的Linux包括：

• Arch
• Ubuntu/Debian
• Fedora
• OpenSUSE
• Amazon Linux 2

(以下操作，使用的是Ubuntu 18.04)

2 安装Lotus

2.1 安装依赖

1)、安装系统依赖

sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git bzr jq pkg-config curl clang build-essential hwloc libhwloc-dev wget -y && sudo apt upgrade -y

这一步可能会出现各种错误，但一般百度就能解决。

2)、安装Go

3)、安装rustup

4)、其他
顺便安装一下其他工具，后面可能用得上

sudo apt install tmux  nethogs sysstat -qy

2.2 下载Lotus

git clone https://github.com/filecoin-project/lotus.git
cd lotus/

默认分支是主网，除了主网外，还有三个分支：

• Mainnet:：主网。用于Filecoin网络。分支master。
• Calibration：测试网。用于通过测试、基准测试和优化有意义的规模评估Filecoin。分支ntwk-calibration
• Butterlfy：测试网。用于测试新代码。分支ntwk-butterfly
• Nerpa：测试网。用于小规模的测试。因为提供较小的扇区和减少证明参数。分支ntwk-nerpa

切换分支

git checkout <branch>

查看当前分支

git branch --list

（以下操作是默认主网）

2.3 安装Lotus

在系统的环境变量导入以下内容：

export IPFS_GATEWAY=https://proof-parameters.s3.cn-south-1.jdcloud-oss.com/ipfs/
export GOPROXY=https://goproxy.cn

在lotus目录下运行：

make clean all

第一次构建会下载很多东西，所以很慢。耐心等待。
构建完成后，会出现三个可执行文件：

全局安装：

sudo make install

查看lotus是否安装成功

lotus --version

3 加入Filecoin区块链

3.1 开始

启动守护进程，启动后会生成~/.lotus文件，可以通过export LOTUS_PATH=来改变

lotus daemon

这一步会先从头开始同步链，目前链高度已经很高，会非常漫长，所以不推荐从头开始同步。
可以导入最小快照来进行同步（推荐），这能快速的同步上链，但同步的信息不全。

lotus daemon --import-snapshot https://fil-chain-snapshots-fallback.s3.amazonaws.com/mainnet/minimal_finality_stateroots_latest.car

如果要同步完整快照，执行以下命令：

lotus daemon --import-chain https://fil-chain-snapshots-fallback.s3.amazonaws.com/mainnet/complete_chain_with_finality_stateroots_latest.car

3.2 链同步情况

导入快照过程结束后，守护进程正式跑起来，可以通过以下命令查看同步情况：

lotus sync wait

或

lotus sync status

4 创建钱包

创建钱包有两种，分别为secp256k1、bls

• secp256k1:创建出来是f1开头的钱包（可以支持一些硬件设备，来保存）
• bls:创建出来是f3开头的钱包（可以用来创建矿工）

创建f1钱包：

lotus wallet new

创建f3钱包

lotus wallet new bls

未完待续…