第四章我们了解了如何连接别的节点以及建立通道,大家对lightning-cli命令的重要性应该有了充分的了解,但是这还不够,我们还需要进一步用这个命令监控节点以及通道运行状况。
下面我们就把这个命令详细操作演练一下。
基本操作命令
lightning-cli help //显示命令的帮助说明
lightning-cli stop //关闭c-lightning
连接节点常用命令
lightning-cli getinfo //查看自己节点的情况
lightning-cli listnodes [id] //不带节点id,就列出能看到的所有节点
lightning-cli listpeers [id] [level] //列出已知的所有对等节点情况,或者指定节点的细节。listnodes和listpeers比较可以发现后者输出了更详细的内容,包括channel的内容。
lightning-cli ping id //运行上述命令之前最好使用这个ping测试一下是否连通。后面可以跟数据包大小(默认是128)
lightning-cli getroute id msatoshi riskfactor //这条命令的含义是尝试查找付款的最佳路由,就是说这笔金额的资金达到目标节点,承受设定值风险因子的最佳路由。这几个参数是节点id,毫聪金额(支付金额),风险因子,必备参数。其中的风险因素是为了比较路线,能够接受的路线上的额外费用,单位是年息百分比,如果设定为20,就是年息20%。
lightning-cli connect id [host] [port] // 主动连接对方节点,需要对方节点id编号。后面最好加上ip地址,端口号,该命令支持id@host:port格式
lightning-cli disconnect id [force] //断开连接。
通道管理命令
listchannels [short_channel_id] [source] //查看通道情况,默认是自己知道的全部,可以指定通道的短id(这里不用通道id)
lightning-cli newaddr [addresstype] //生成新地址用于注资到通道中。类型可以是bech32, p2sh-segwit
lightning-cli fundchannel id satoshi [feerate] [announce] [minconf] //给通道注资,这就是建立通道的命令
lightning-cli setchannelfee id [base] [ppm] //设置通道路由收费标准,可以是固定收费,比如1sat,也可以按照比例,就是后面的ppm(proportional per millionth)
lightning-cli listfunds //显示输出和通道中的金额等。
lightning-cli close id [force] [timeout] //关闭通道
支付收款相关命令
lightning-cli invoice msatoshi label description //生成bolt11地址进行收款,后面 label 和 description 是支付的标签和说明。
我生成这个地址后,过了一会才去用比特派闪电网络手机端支付后,看到这个标签的收款码超时了,就重新产生第二个,然后转账成功,标注位置可以看到第二笔支付成功了。
lightning-cli delinvoice label status //删除未收到的收款信息,再使用listinvoices命令就看不到这个收款信息了。
lightning-cli decodepay bolt11地址 //解码收款地址的详细信息
lightning-cli pay bolt11地址 //转账给手机端生成的bolt地址,体验了真实秒到的感觉。后面还可以跟其他参数比如金额,标签,延时重试等等,只有地址的的话,默认就是地址中设定的金额。
lightning-cli paystatus [bolt11] //检查转账的状态。
lightning-cli listpayments [bolt11] //列出转账情况,和上面的命令差不多。
lightning-cli listpays [bolt11] //显示转账结果,也与上面的命令差不多
其实转账结果在日志中也能看到:
lightning-cli feerates style //显示收费情况,其中的style可以是satoshi-per-kw ({style} perkw)或者是satoshi-per-kb ({style} perkb).
参考内容:
lightning-cli help