lotus- interopnet命令及其参数

1 lotus

1.1 lotus daemon

启动守护进程

• --version, -v: 打印版本

1.1.1 lotus daemon

• --api value: 设置lotus监听地址，默认1234
• --genesis value: 设置第一个节点
• --bootstrap: 默认true
• --import-chain value: 第一次运行时，从给定文件加载链
• --halt-after-import: 从文件导入链后停止进程,默认false
• --pprof value: 指定写入CPU的配置文件的文件名
• --profile value: 指定节点类型

1、 lotus daemon stop
停止守护进程

1.2 lotus wallet

钱包管理

1.2.1 lotus wallet new bls

创建一个新的bls钱包地址

1.2.2 lotus wallet list

列出所有钱包地址（密钥）

1.2.3 lotus wallet balance

获取钱包总额

1.2.4 lotus wallet export

导出地址

lotus wallet export [command options] [address]

1.2.5 lotus wallet import

导入地址

lotus wallet import [command options] [ (optional, will read from stdin if omitted)]

• --format value: 指定地址（密钥）的输入格式

1.2.6 lotus wallet default

获取默认钱包地址（密钥）

1.2.7 lotus wallet set-default

设置默认钱包地址（密钥）

lotus wallet set-default [address]

1.2.8 lotus wallet sign

签署消息

lotus wallet sign   

1.2.9 lotus wallet verify

验证消息的签名

lotus wallet verify   

1.2.10 lotus wallet delete

删除钱包地址（密钥）

lotus wallet delete 
 

1.3 lotus send

在帐户之间发送资金

lotus send [command options] [targetAddress] [amount]

• --source value: 可以选择指定要从中发送资金的帐户
• --gas-price value: 指定要在AttoFIL中使用的gas价格，默认值为0
• --nonce value: 指定要使用的nonce，默认值为-1

1.4 lotus client

做交易，存储数据，检索数据

1.4.1 lotus client import

导入数据

lotus client import [command options] [inputPath]

• --car: 从一个car文件而不是常规文件去导入

1.4.2 lotus client commp

计算CAR文件的piece-cid

lotus client commP [inputFile minerAddress]

1.4.3 lotus client local

列出本地导入的数据

1.4.4 lotus client deal

与矿工初始化存储交易

lotus client deal [command options] [dataCid miner price duration]

• --manual-piece-cid value: 手动指定数据的piece commitmen（dataCid必须是car文件）
• --manual-piece-size value: 如果手动指定piece cid，则用于指定尺寸（dataCid必须是car文件），默认为0
• --from value: 指定为交易提供资金的地址
• --start-epoch value: 指定交易开始的时间，默认-1

1.4.5 lotus client find

在网络中查找数据

lotus client find  [dataCid]

1.4.6 lotus client retrieve

从网络检索数据

lotus client retrieve [command options] [dataCid outputPath]

• --address value: 用于交易的地址
• --car : 从一个car文件而不是常规文件去导出，默认false

1.4.7 lotus client query-ask

找个矿工问一问

lotus client query-ask [command options] [minerAddress]

• --peerid value: 指定要查询的节点peer ID
• --size value: 数据大小（字节），默认为0
• --duration value: 交易持续时间，默认为0

1.4.8 lotus client list-deals

列出存储市场交易

1.4.9 lotus client generate-car

从输入中生成一个car文件

lotus client generate-car  [inputPath outputPath]

1.5 lotus msig

与一个multisig钱包互动

1.5.1 lotus msig create

创建一个新的multisig钱包

lotus msig create [command options] [address1 address2 ...]

• --required value: 默认为0
• --value value: 给multisig的初始资金
• --sender value: 发送创建消息的帐户

1.5.2 lotus msig inspect

检查multisig钱包

lotus msig inspect  [address]

1.5.3 lotus msig propose

提出一个multisig事务

lotus msig propose [command options] [multisigAddress destinationAddress value  (optional)]

• --source value: 设置发送建议消息的帐户

1.5.4 lotus msig approve

批准multisig消息

lotus msig approve [command options] [multisigAddress messageId proposerAddress destination value  (optional)]

• --source value: 设置发送批准消息的帐户

1.6 lotus paych

管理支付渠道

1.6.1 lotus paych get

创建新的付款渠道或获取现有的付款渠道

lotus paych get  [fromAddress toAddress amount]

1.6.2 lotus paych list

列出所有本地注册的付款渠道

1.6.3 lotus paych voucher

与支付渠道凭证交互

1、lotus paych voucher create
创建已签名的付款渠道凭证

lotus paych voucher create [channelAddress amount]

• --lane value: 指定要使用的付款渠道通道

2、lotus paych voucher check
检查付款渠道凭证的有效性

lotus paych voucher check [channelAddress voucher]

3、lotus paych voucher add
向本地数据存储添加付款渠道凭证

lotus paych voucher add [channelAddress voucher]

4、lotus paych voucher list
列出给定付款渠道的存储凭证

lotus paych voucher list [command options] [channelAddress]

• --export: 打印导出字符串

5、lotus paych voucher best-spendable
打印当前可消费的最高值凭证

lotus paych voucher best-spendable [channelAddress]

6、lotus paych voucher submit
向链提交凭证以更新付款渠道状态

lotus paych voucher submit [channelAddress voucher]

1.7 lotus auth

管理RPC权限

1.7.1 lotus auth create-token

创建token

lotus auth create-token [command options]

• --perm value: 分配给令牌的权限(value: read, write, sign, admin)

1.7.2 lotus auth api-info

获取连接到此节点所需的API信息的令牌

lotus auth api-info

• --perm value: 分配给令牌的权限(value: read, write, sign, admin)

1.8 lotus mpool

管理消息池

1.8.1 lotus mpool pending

获取挂起的信息

1.8.2 lotus mpool sub

从Subscibe到mpool的更改

1.8.3 lotus mpool stat

打印mpool统计

1.9 lotus state

与filecoin链状态交互并查询

1.9.1 lotus state power

查询网络或矿工的算力（power）
不加minerAddress，就是全网的算力

lotus state power [ (optional)]

1.9.2 lotus state sectors

查询矿工的sector

lotus state sectors [minerAddress]

1.9.3 lotus state proving

查询一个矿工的proving

lotus state proving [minerAddress]

1.9.4 lotus state pledge-collateral

获得最低矿工抵押担保

1.9.5 lotus state list-actors

列出网络中的所有参与者

1.9.6 lotus state list-miners

列出网络中的所有矿工

1.9.7 lotus state get-actor

获取网络中某个参与者的信息

lotus state get-actor [actorrAddress]

1.9.8 lotus state lookup

查找对应的ID地址(输入钱包地址，获取miner矿工号)

lotus state lookup [command options] [address]

• --reverse, -r: 执行反向查找

1.9.9 lotus state replay

在一个tipset中重播特定消息

lotus state replay [tipsetKey messageCid]

1.9.10 lotus state sector-size

查看矿工sector大小

lotus state sector-size [minerAddress]

1.9.11 lotus state read-state

查看参与者状态的json

lotus state read-state [actorAddress]

1.9.12 lotus state list-messages

列出与给定条件匹配的链上消息

lotus state list-messages [command options]

• --to value: 将消息返回到给定地址
• --from value: 从给定地址返回消息
• --toheight value: 在给定的块高度之前不要查看
• --cids: 打印CIDs消息而不是messages

1.9.13 lotus state compute-state

执行状态计算

lotus state compute-state [command options]

• --height value: 将高度设置为计算状态
• --apply-mpool-messages: 将来自mempool的消息应用于计算状态
• --show-trace: 打印给定tipset的完整执行跟踪
• --html: 生成html报表

1.9.14 lotus state call

在本地调用参与者的方法

lotus state call [toAddress methodId  (optional)]

• --from value: 默认值为t00
• --value value: 指定要调用的值字段，默认值为0
• --ret value: 指定如何分析输出（auto, raw, addr, big），默认值为auto

1.9.15 lotus state get-deal

查看on-chain交易信息

lotus state get-deal [dealId]

1.9.16 lotus state wait-msg

等待消息出现在链上

lotus state wait-msg [command options] [messageCid]

• --timeout value: 默认值为1

1.9.17 lotus state search-msg

搜索以查看消息是否已出现在链上

lotus state search-msg [messageCid]

1.9.18 lotus state miner-info

检索矿工信息

lotus state miner-info [minerAddress]

1.10 lotus chain

与filecoin区块链互动

1.10.1 lotus chain head

打印链头

1.10.2 lotus chain getblock

获取一个块并打印其详细信息

lotus chain getblock [command options] [blockCid]

• --raw: 只打印原始块标题

1.10.3 lotus chain read-obj

读取对象的原始字节

lotus chain read-obj [objectCid]

1.10.4 lotus chain stat-obj

收集对象的对象大小和ipld链接计数
当提供一个基时，它将首先被遍历，当传入对象被遍历时，所有访问的链接都将被忽略。

lotus chain stat-obj [command options] [cid]

• --base value: 忽略此对象中找到的链接

1.10.5 lotus chain getmessage

通过cid获取并打印消息

lotus chain getmessage [messageCid]

1.10.6 lotus chain sethead

手动设置本地节点头tipset（注意：通常仅用于恢复）

lotus chain sethead [command options] [tipsetkey]

• --genesis: 重置头部去为genesis
• --epoch value: 重置头部为给定的纪元

1.10.7 lotus chain list

查看链的一段

lotus chain list [command options]

• --height value: 默认为0
• --count value: 默认为30
• --format value: 指定打印提示集的格式，默认为": () "

1.10.8 lotus chain get

按路径获取链DAG节点

lotus chain get [command options] [path]

DESCRIPTION:
   Get ipld node under a specified path:

   lotus chain get /ipfs/[cid]/some/path

   Path prefixes:
   - /ipfs/[cid], /ipld/[cid] - traverse IPLD path
   - /pstate - traverse from head.ParentStateRoot

   Note:
   You can use special path elements to traverse through some data structures:
   - /ipfs/[cid]/@H:elem - get 'elem' from hamt
   - /ipfs/[cid]/@Hi:123 - get varint elem 123 from hamt
   - /ipfs/[cid]/@Hu:123 - get uvarint elem 123 from hamt
   - /ipfs/[cid]/@Ha:t01 - get element under Addr(t01).Bytes
   - /ipfs/[cid]/@A:10   - get 10th amt element
   - .../@Ha:t01/@state  - get pretty map-based actor state

   List of --as-type types:
   - raw
   - block
   - message
   - smessage, signedmessage
   - actor
   - amt
   - hamt-epoch
   - hamt-address
   - cronevent
   - account-state

• --as-type value: 指定要将输出解释为的类型
• --verbose:
• --tipset value: 为/pstate指定tipset，（传递以逗号分隔的cids数组）

1.10.9 lotus chain bisect

事件的对分链

lotus chain bisect [minHeight maxHeight path shellCommand ]

DESCRIPTION:
   Bisect the chain state tree:

   lotus chain bisect [min height] [max height] '1/2/3/state/path' 'shell command' 'args'

   Returns the first tipset in which condition is true
                  v
   [start] FFFFFFFTTT [end]

   Example: find height at which deal ID 100 000 appeared
    - lotus chain bisect 1 32000 '@Ha:t03/1' jq -e '.[2] > 100000'

   For special path elements see 'chain get' help

1.10.10 lotus chain export

将链导出到car文件

lotus chain export [outputPath]

1.10.11 lotus chain slash-consensus

报告一致性错误

lotus chain slash-consensus [command options] [blockCid1 blockCid2]

• --miner value: Miner address
• --extra value: 额外的block cid

1.11 lotus log

管理日志记录

1.11.1 lotus log list

列出日志系统

1.11.2 lotus log set-level

设置日志级别

lotus log set-level [command options] [level]

DESCRIPTION:
   Set the log level for logging systems:

   The system flag can be specified multiple times.

   eg) log set-level --system chain --system blocksync debug

   Available Levels:
   debug
   info
   warn
   error

   Environment Variables:
   GOLOG_LOG_LEVEL - Default log level for all log systems
   GOLOG_LOG_FMT   - Change output log format (json, nocolor)
   GOLOG_FILE      - Write logs to file in addition to stderr

• --system value: 日志系统限制

1.12 lotus wait-api

等待lotus api上线

1.13 lotus fetch-params

获取证明参数

lotus fetch-params [sectorSize]

1.14 lotus net

管理P2P网络

1.14.1 lotus net peers

打印peers

1.14.2 lotus net connect

连接一个peer

lotus net connect [peerMultiaddr]

1.14.3 lotus net listen

列出监听的地址

1.14.4 lotus net id

获取节点标识

1.14.5 lotus net findpeer

查找给定peerID的地址

lotus net findpeer [peerId]

1.14.6 lotus net scores

打印peer的pubsub scores

1.15 lotus sync

检查或与链同步器交互

1.15.1 lotus sync status

检查同步状态

1.15.2 lotus sync wait

等待同步完成

1.15.3 lotus sync mark-bad

将给定块标记为坏块，将阻止与包含它的链同步

lotus sync mark-bad [blockCid]

1.15.4 lotus sync check-bad

检查给定的块是否标记为坏，以及原因

lotus sync check-bad [blockCid]

2 lotus-storage-miner

Filecoin分散存储网络存储矿工

• --storagerepo value: 矿工初始化和运行路径，默认为~/.lotusstorage，环境变量参数为LOTUS_STORAGE_PATH

2.1 lotus-storage-miner init

初始化lotus storage miner repo

lotus-storage-miner init [command options]

• --actor value: 指定已创建的miner actor的地址
• --create-worker-key: 创建单独的工作密钥
• --worker value, -w value: 要使用的工作密钥(覆盖 --create-worker-key)
• --owner value, -o value: owner key to use
• --sector-size value: 指定要使用的扇区(sector)大小，默认512MiB
• --pre-sealed-sectors value: 指定一组presealed sectors，以作为genesis miner启动
• --pre-sealed-metadata value: 为presealed sectors指定元数据文件
• --nosync: 不检查完全节点同步状态
• --symlink-imported-sectors: 尝试去符号链接(symlink)presealed sectors，而不是将它们复制到适当的位置
• --no-local-storage: 对于sector storage不使用storageminer repo
• --gas-price value: 在AttoFIL中设置初始化消息的gas价格，默认为0

2.2 lotus-storage-miner info

打印矿工信息

• --color: 有颜色的打印

2.3 lotus-storage-miner run

开始运行lotus 矿工进程

lotus-storage-miner run [command options]

• --api value: 2345
• --enable-gpu-proving: 启用对mining操作使用GPU，默认true
• --nosync: 不检查完全节点同步状态
• --manage-fdlimit: 管理打开的文件限制，默认为true

2.4 lotus-storage-miner stop

停止矿工运行进程

2.5 lotus-storage-miner deals

interact with your deals

2.5.1 lotus-storage-miner deals import-data

手动导入交易数据

lotus-storage-miner deals import-data  

2.5.2 lotus-storage-miner deals list

列出此矿工的所有交易（deals）

2.5.3 lotus-storage-miner deals enable

配置矿工以考虑存储交易提议

2.5.4 lotus-storage-miner deals disable

配置矿工以拒绝所有存储交易提议

2.6 lotus-storage-miner rewards

一个新的cli应用程序

2.6.1 lotus-storage-miner rewards redeem

兑换区块奖励

• --gas-limit value: 设置gas限制

2.7 lotus-storage-miner sectors

interact with sector store

2.7.1 lotus-storage-miner sectors status

通过扇区(sector)的ID获取它的seal状态

• --log: 显示事件日志

2.7.2 lotus-storage-miner sectors list

列出sectors

2.7.3 lotus-storage-miner sectors refs

List References to sectors

2.7.4 lotus-storage-miner sectors update-state

高级：手动更新扇区(sector)的状态，这可能有助于错误恢复

• --really-do-it: 如果你知道你在做什么，就传递此标志

2.7.5 lotus-storage-miner sectors pledge

在扇区(sector)中存储随机数据

2.8 lotus-storage-miner set-price

矿工接受存储交易的设定价格（FIL/GiB/Epoch）

2.9 lotus-storage-miner workers

interact with workers

2.9.1 lotus-storage-miner workers list

列出workers

• --color: 默认为false

2.10 lotus-storage-miner proving

查看证明(proving)信息

2.10.1 lotus-storage-miner proving info

查看当前状态信息

2.10.2 lotus-storage-miner proving deadlines

查看当前proving period deadlines 信息

2.11 lotus-storage-miner auth

管理RPC权限

2.11.1 lotus-storage-miner auth create-token

创建token

lotus-storage-miner auth create-token [command options]

• --perm value: 分配给令牌的权限(value: read, write, sign, admin)

2.11.2 lotus-storage-miner auth api-info

获取连接到此节点所需的API信息的令牌

lotus-storage-miner auth api-info

• --perm value: 分配给令牌的权限(value: read, write, sign, admin)

2.12 lotus-storage-miner log

与lotus log介绍一样

2.13 lotus-storage-miner wait-api

与lotus wait-api介绍一样

2.14 lotus-storage-miner fetch-params

与lotus fetch-params介绍一样

2.15 lotus-storage-miner net

与lotus net介绍一样

3 lotus-seal-worker

远程存储矿工工人(Remote storage miner worker)

• --workerrepo value: seal-worker运行路径，默认为~/.lotussworker，环境配置参数WORKER_PATH
• --storagerepo value: 矿工运行路径，默认为~/.lotusstorage，环境变量参数为LOTUS_STORAGE_PATH
• --enable-gpu-proving: 启用对mining操作使用GPU，默认true

3.1 lotus-seal-worker run

开始lotus worker

• --address value: 本地可访问地址
• --no-local-storage: 对于sector storage不使用storageminer repo，默认false
• --precommit1: 允许precommit1（32G sectors: 1 core, 128GiB Memory），默认true
• --precommit2: 允许precommit2(32G sectors: all cores, 96GiB Memory)，默认true
• --commit: 允许commit(32G sectors: all cores or GPUs, 128GiB Memory + 64GiB swap)，默认true