venus chain-service v1.9.* & venus-market v2.5.* upgrade list / 链服务v1.9.*和订单服务v2.5.*升级清单

[diwufeiwen]

组件版本

这里没有列出来的组件可以用 v1.8.* 版本.

组件	分支/版本号
venus	v1.9.0
venus-auth	v1.9.0
venus-wallet	v1.9.0
venus-messager	v1.9.1
venus-gateway	v1.9.1
venus-miner	v1.9.0
venus-market	v2.5.0

主要变动

本次变动对于使用者是无感的，这里列出来是为了帮助测试及用户了解各组件的升级内容。

venus-auth

1. 引入签名者角色: 可进行签名的地址,如: worker,controllers.用户,矿工,签名者token之间的关系如下:
   

• venus-wallet 连接到链服务(venus-gateway)时,自动将签名者和用户绑定;
• venus-auth提供了cmd用户手动给指定用户注册/注销签名者.
• venus-auth 中签名者和user是多对多的关系：一个签名者可以绑定到多个用户，也可以给一个用户注册多个签名者.

测试项:

• 签名者操作命令,见 ./venus-auth user signer -h

2. 对矿工增加了是否开启出块的控制开关

测试项:

• 矿工操作命令,见 ./venus-auth user miner add/list -h

venus-wallet

无修改

venus-gateway

1. 在venus-wallet连接上来时会调用venus-auth接口将venus-wallet中管理的签名者与支持的用户绑定;

测试项:

• 自动注册签名者

venus-messager

1. 删除了 ForcePushMessageWithId 和 ForcePushMessage 接口;
2. 在推送消息之前先验证是否可以签名.见后文 签名消息 模块
3. 增加了广播消息相关参数的配置项

[publisher]
  cacheReleasePeriod = 0
  concurrency = 5
  enableMultiNode = true
  enablePubsub = false

4. libp2p配置项变化

# v1.8.0
[libp2p]
  bootstrapAddresses = []
  enablePubsub = true
  listenAddresses = "/ip4/0.0.0.0/tcp/0"

# v1.9.*
[libp2p]
  bootstrapAddresses = []
  expandPeriod = "0s"
  listenAddresses = "/ip4/0.0.0.0/tcp/0"
  minPeerThreshold = 0

venus-miner

1. 给矿工增加了是否出块的控制开关,并提供了相关命令

venus-market

1. 统一启动方式,见后文
2. market-client增加了接入venus链服务运行的方式
3. 更多的签名选择: 链服务(venus-gateway),venus-wallet/lotus-wallet及lotus-fullnode

签名需要满足的条件

• 签名消息:

  • 客户端配置的token对应的账号注册了消息的From地址，即venus-auth的signers表中存在 user-from;
  • venus-gateway至少存在一个支持对From绑定的用户列表中的一个进行签名的venus-wallet.

• 签名区块: 矿工只能注册到一个用户，也就是矿工对应的用户只有一个

  • 矿工的worker地址与矿工绑定的用户(假设是user01)绑定, 即venus-auth的signers表中存在 user01-worker;
  • venus-gateway至少存在一个支持对user01进行签名的venus-wallet

测试功能点

• 从v1.8.*可以平滑升级

• SP签名权限验证
  
  在 venus-wallet 和 venus-auth 如上图配置时:

  • 自动支持venus-wallet配置的链服务token对应的账号下所有矿工的签名:
    • SP01: token01, miner01, from in (from01,from02,from03) 可正常签名
    • SP02: token01, miner02, from in (from01,from02,from03) 可正常签名
  • 矿工归属权错误时无法签名,逻辑到不了venus-wallet就会报错
    • SP03: token01, miner03 不可签名, miner03不属于user01用户
  • 私钥在venus-wallet不存在时无法签名:
    • SP04: token01, miner01, from=from04 不可签名, venus-wallet没有from04的私钥
  • 支持对venus-wallet配置的SupportAccounts用户下所有矿工的签名:
    • SP05: token02, miner03, from in (from01,from02,from03) 可正常签名
  • venus-wallet 拒绝不在 SupportAccounts 列表下用户所属矿工的签名:
    • SP06: token03, miner05 不可签名,venus-wallet不支持对于user03用户下的任何矿工进行签名

以上所属 from 是矿工消息或出块的签名地址, 可以是可签名的owner,woker或controlers.

• venus-market run 只需要配置签名,同步及消息服务节点即可,不再区分 pool/solo 模式, 三类常见模式均服务正常:

  • 作为独立组件，接入 venus chain-service，类似venus-cluster
  • 接入 lotus-fullnode
  • 作为链服务组件

• venus-market的矿工管理: 不再从venus-auth获取，需要手动配置，见[venus-market快速启动] (https://github.com/filecoin-project/venus-market/blob/master/docs/zh/%E5%BF%AB%E9%80%9F%E5%90%AF%E7%94%A8.md#storageminers-配置)

• 其他平时的验证逻辑