‼️ Network Version 22 Venus Upgrade Timeline

[Fatman13]

More details on nv22 upgrade can be found here!

Subscribe to notifications on https://status.filecoin.io/ for any additional network updates!
If you have any concerns or questions, ask in #fil-venus.

📌 Venus Releases

Note: This projected timeline is subject to change based on testing, auditing, new discoveries, and development.

You will need to be on new versions of Venus products specified below for the Network v22 upgrade. Version requirement for each Venus products will be listed below in respective comments for both calibration and mainnet. Please make sure you use the right version for each Venus products 1. Sophon (formerly as chain service), 2. Damocles (formerly as storage power service), 3. Droplet (formerly as storage deal service).

💙 Release Features

Please visit respective mIlestone of each Venus product below for new features and improvements.

Sophon, Droplet, Damocles

🗓️ Tentative Releases and Network Upgrade Timelines

• Calibration compatible RC releases for each Venus products
• 2024-03-17 Calibration-testnet upgrade
• Mainnet compatible releases for each Venus products
• 2024-04-24 mainnet upgrade

📂 Resources

• https://github.com/filecoin-project/venus/milestone/59 (Sophon milestone)
• https://github.com/ipfs-force-community/damocles/milestone/10 (Damocles milestone)
• https://github.com/ipfs-force-community/droplet/milestone/4 (Droplet milestone)

[Fatman13]

Calibration compatible RC releases

Please use the following Veuns product version for pre-NV22 upgrade testing on Calibration network.

Sophon (formerly as Chain Service)

sophon-auth: v1.15.0-rc1
venus: v1.15.0-rc1
sophon-messager: v1.15.0-rc1
sophon-miner: v1.15.0-rc1
sophon-gateway: v1.15.0-rc1
sophon-co: v0.8.0-rc1

Damocles (formerly as Storage Power Service)

damocles v0.10.0-rc1

Droplet (formerly as Storage Deal Service)

droplet: v2.11.0-rc1

[Fatman13]

Mainnet compatible releases

Please use the following Veuns product version for NV22 upgrade on mainnet.

Sophon (formerly as Chain Service)

sophon-auth: v1.15.0
venus: v1.15.2
sophon-miner: v1.15.0
sophon-gateway: v1.15.1
sophon-co: v0.8.0
sophon-messager: v1.15.0

venus-wallet: v1.15.0

Damocles (formerly as Storage Power Service)

damocles v0.10.2

Droplet (formerly as Storage Deal Service)

droplet: v2.11.1

[simlecode]

Venus 各组件升级文档

注意事项

1. 所有组件全部更换
2. 更新完通过 curl 命令调用 Version 接口检查版本号，各组件接口调用方式：[Venus] 各组件增加 Version 接口 #5132
3. pre/pro消息上链的情况
4. WD消息上链的情况
5. 出块情况是否正常
6. gas fee 相关设置是否生效

需要升级的组件

组件名	tag	commit
sophon-auth	v1.15.0	a1e964b
venus	v1.15.1	81c99f3
sophon-co	v0.8.0	0e48712
sophon-messager	v1.15.0	1e4f0d5
soohon-gateway	v1.15.1	c08a726
venus-wallet	v1.15.0	6b3de34
sophon-miner	v1.15.0	8dd6c68
droplet	v2.11.0	44481dd
damocles-manager	v0.10.2	88767bc
damocles-worker	v0.10.2	88767bc

升级顺序

1. sophon-auth
2. venus
3. soohon-co
4. soohon-gateway
5. sophon-messager
6. sophon-miner
7. droplet
8. venus-wallet
9. damocles-manager
10. damocles-worker

sophon-auth

影响功能：

• 其他组件对获取 auth 的服务

依赖升级组件: 无

注意事项：

• 启动后能否正常鉴权

venus

影响功能：无

依赖升级组件: sophon-auth

注意事项：

编译：先 make dist-clean 再 make，这样可以防止未能正常升级 filecoin-ffi 而带来的问题

1. 升级后检查vk文件是否完整

2. 升级后执行命令 ./venus state network-info，然后检查通过日志检查 UpgradeDragonHeight 是否正常:

   # cali
   UpgradeDragonHeight: 1427974
   # mainnet
   UpgradeDragonHeight: 3855360
   

3. 升级后需检查是否正常同步区块

4. 检查主网 v13 actors code，确保与下面输出一样

   ./venus state actor-cids --network-version 22
   
   # 顺序可能会不一样
   Network Version: 22
   Actor Version: 13
   Manifest CID: bafy2bzacecdhvfmtirtojwhw2tyciu4jkbpsbk5g53oe24br27oy62sn4dc4e
   Actor             CID
   account           bafk2bzacedxnbtlsqdk76fsfmnhyvsblwyfducerwwtp3mqtx2wbrvs5idl52
   cron              bafk2bzacebbopddyn5csb3fsuhh2an4ttd23x6qnwixgohlirj5ahtcudphyc
   datacap           bafk2bzaceah42tfnhd7xnztawgf46gbvc3m2gudoxshlba2ucmmo2vy67t7ci
   eam               bafk2bzaceb23bhvvcjsth7cn7vp3gbaphrutsaz7v6hkls3ogotzs4bnhm4mk
   ethaccount        bafk2bzaceautge6zhuy6jbj3uldwoxwhpywuon6z3xfvmdbzpbdribc6zzmei
   evm               bafk2bzacedq6v2lyuhgywhlllwmudfj2zufzcauxcsvvd34m2ek5xr55mvh2q
   init              bafk2bzacedr4xacm3fts4vilyeiacjr2hpmwzclyzulbdo24lrfxbtau2wbai
   multisig          bafk2bzacecr5zqarfqak42xqcfeulsxlavcltawsx2fvc7zsjtby6ti4b3wqc
   paymentchannel    bafk2bzacebntdhfmyc24e7tm52ggx5tnw4i3hrr3jmllsepv3mibez4hywsa2
   placeholder       bafk2bzacedfvut2myeleyq67fljcrw4kkmn5pb5dpyozovj7jpoez5irnc3ro
   reward            bafk2bzacedq4q2kwkruu4xm7rkyygumlbw2yt4nimna2ivea4qarvtkohnuwu
   storagemarket     bafk2bzacebjtoltdviyznpj34hh5qp6u257jnnbjole5rhqfixm7ug3epvrfu
   storageminer      bafk2bzacebf4rrqyk7gcfggggul6nfpzay7f2ordnkwm7z2wcf4mq6r7i77t2
   storagepower      bafk2bzacecjy4dkulvxppg3ocbmeixe2wgg6yxoyjxrm4ko2fm3uhpvfvam6e
   system            bafk2bzacecyf523quuq2kdjfdvyty446z2ounmamtgtgeqnr3ynlu5cqrlt6e
   verifiedregistry  bafk2bzacedkxehp7y7iyukbcje3wbpqcvufisos6exatkanyrbotoecdkrbta
   

5. 若不排查问题，rust日志级别不建议设置为 trace，因为会打印较多日志

6. 升级后可以通过命令来 ./venus state get-actor t01000 来确认是否升级成功

7. actor 迁移

   经测试本次预迁移时间在 30 分钟左右，正式迁移时间在 100 秒左右

   预迁移高度是升级高度前 120 个高度：
   pre-migration  开始：STARTING pre-migration  结束：COMPLETED pre-migration
   migration      开始：STARTING migration      结束：COMPLETED migration
   

8. 如果 ~/.venus 存在且需要导入快照，需要先删除 ~/.venus/version 文件再导入快照

   • 主网: ./venus daemon --import-snapshot snapshot.car
   • calibnet: ./venus daemon --import-snapshot snapshot.car --network calibrationnet

sophon-gateway

影响功能：无

依赖升级组件: sophon-auth

注意事项：

• 编译时,需要先 make dist-clean 再 make

sophon-messager

影响功能：

依赖升级组件: venus, sophon-auth, soohon-gateway

注意事项：

• 升级之后需要观察能否正常接收消息, 消息能否正常上链

sophon-miner

影响功能：

依赖升级组件：auth, venus, gateway

注意事项：

droplet

影响功能：

• 支持 direct data onboarding，使用文档：https://github.com/ipfs-force-community/droplet/blob/master/docs/zh/direct-on-boarding.md

依赖升级组件: auth, venus, gateway, messager

注意事项：

• 升级后能否正常发单和检索

venus-wallet

影响功能： 无

依赖升级组件: gateway

注意事项：

• 升级后观察是否正常签名，消息能否正常上链

damocles-manager

依赖升级组件: 链服务组件

注意事项：

• 编译时,需要先 make dist-clean 再 make

damocles-worker

依赖升级组件: damocles-manager

注意事项：

---

更新结果验证步骤:

1. 程序启动正常
2. pre/pro消息正常上链
3. 出块正常
4. WD上链正常
5. 算力增长正常
6. 真实订单检索正常
7. 数据库各种gas，生命周期，聚合设置正常

数据库变更

1. droplet 增加 direct_deals 表，用于存储 direct 订单。

[Fatman13]

English Upgrade guide can be found here.