lotus文档

于6月16号写

目录

• 1 Lotus介绍
• • 1.1 配置参考
  • 1.2 可以运行的操作系统
• 2 安装Lotus
• • 2.1 安装依赖
  • 2.2 下载Lotus
  • 2.3 安装Lotus
• 3 加入Filecoin区块链
• • 3.1 开始
  • 3.2 链同步情况
• 4 创建钱包

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
           

未完待续…