nv18 Upgrade Guide

If you are upgrading chain service components from v1.8.x to v1.10.0, please read venus chain-service v1.9.* & venus-market v2.5.* upgrade list / 链服务 v1.9.*和订单服务 v2.5.*升级清单 (opens new window) first and pay special attention to the upgrade of venus-auth and venus-market. Before upgrading venus-auth, a user account needs to be created for each miner. Also startup CLI and configurations of venus-market major breaking changes made to it.

About nv18 upgrade

We storngly encourage you to test out the upgrade in calibration before mainnet.

Upgrade Timeline

Upgrade UTC time: 2023-03-14T15:14:00Z, which is 2023-03-14 23:14:00 in Beijing time

nv18 compatible versions

• calibrationnet (opens new window)
• mainnet (opens new window)

venus

Feature: support nv18 network

Dependency: None

Precautions:

1. Compile: make sure to first make dist-clean and then make. This can prevent problems caused by failing to upgrade filecoin-ffi normally

2. Check whether the vk file is complete after upgrading

3. After upgrading, check the configuration file. And see whether AllowableClockDriftSecs, UpgradeHyggeHeight and UpgradeHyggeHeight are normal in the log:

   #cali
   AllowableClockDriftSecs: 1
   Eip155ChainID:314159
   UpgradeHyggeHeight: 322354
   #mainnet
   AllowableClockDriftSecs: 1
   Eip155ChainID:314
   UpgradeHyggeHeight: 2683348
   

4. After upgrading, check the status of block synchronization

5. Check the mainnet v10 actors CID and make sure it is the same as the output below...

   ./venus state actor-cids --network-version 18
   
   # order may vary
   Network Version: 18
   Actor Version: 10
   Actor CIDs
   datacap bafk2bzacealj5uk7wixhvk7l5tnredtelralwnceafqq34nb2lbylhtuyo64u
   evm bafk2bzaceahmzdxhqsm7cu2mexusjp6frm7r4kdesvti3etv5evfqboos2j4g
   init bafk2bzaced2f5rhir3hbpqbz5ght7ohv2kgj42g5ykxrypuo2opxsup3ykwl6
   account bafk2bzaceampw4romta75hyz5p4cqriypmpbgnkxncgxgqn6zptv5lsp2w2bo
   ethaccount bafk2bzaceaqoc5zakbhjxn3jljc4lxnthllzunhdor7sxhwgmskvc6drqc3fa
   multisig bafk2bzaceduf3hayh63jnl4z2knxv7cnrdenoubni22fxersc4octlwpxpmy4
   paymentchannel bafk2bzaceartlg4mrbwgzcwric6mtvyawpbgx2xclo2vj27nna57nxynf3pgc
   reward bafk2bzacebnhtaejfjtzymyfmbdrfmo7vgj3zsof6zlucbmkhrvcuotw5dxpq
   storagemarket bafk2bzaceclejwjtpu2dhw3qbx6ow7b4pmhwa7ocrbbiqwp36sq5yeg6jz2bc
   storageminer bafk2bzaced4h7noksockro7glnssz2jnmo2rpzd7dvnmfs4p24zx3h6gtx47s
   verifiedregistry bafk2bzacedfel6edzqpe5oujno7fog4i526go4dtcs6vwrdtbpy2xq6htvcg6
   eam bafk2bzacedrpm5gbleh4xkyo2jvs7p5g6f34soa6dpv7ashcdgy676snsum6g
   placeholder bafk2bzacedfvut2myeleyq67fljcrw4kkmn5pb5dpyozovj7jpoez5irnc3ro
   storagepower bafk2bzacec4ay4crzo73ypmh7o3fjendhbqrxake46bprabw67fvwjz5q6ixq
   system bafk2bzacedakk5nofebyup4m7nvx6djksfwhnxzrfuq4oyemhpl4lllaikr64
   cron bafk2bzacedcbtsifegiu432m5tysjzkxkmoczxscb6hqpmrr6img7xzdbbs2g
   

6. When not debugging, it is not recommended is set the rust log level to trace as too much logs may be printed

7. After upgrading, you can use the command ./venus state get-actor t01000 to confirm whether the upgrade is successful

8. Actor Migration

   The pre-migration height is 60 epoch before the upgrade epoch of 2683288
   Pre-migration start: STARTING pre-migration end: COMPLETED pre-migration
   migration started: STARTING migration ended: COMPLETED migration
   

9. Configuration changes

   # Added fevm related configuration, where the enableEthRPC field is used to control whether to enable ETH RPC, the default is false
   "fevm": {
       "enableEthRPC": false,
       "ethTxHashMappingLifetimeDays": 0,
       "event": {
               "enableRealTimeFilterAPI": false,
               "enableHistoricFilterAPI": false,
               "filterTTL": "24h0m0s",
               "maxFilters": 100,
               "maxFilterResults": 10000,
               "maxFilterHeightRange": 2880,
               "databasePath": ""
       }
   }
   
   # Added allowableClockDriftSecs field, default is 1
   "parameters": {
       "allowableClockDriftSecs": 1
   },
   

venus-auth

Feature:

Dependency: none

Precautions:

1. Check whether the command line can be used correctly

venus-messager

Function:

1. Added additional interface authentication

Dependency:

Precautions:

1. Observe if messages can be received normally after upgrading

2. After upgrading, observe whether the message can be on-chained properly

3. ReplacedMsg is renamed to NonceConflictMsg

venus-miner

Feature:

Dependency:

Precautions:

1. Check if block be produced properly after upgrading

venus-gateway

Feature:

Precautions:

1. Compile: first make dist-clean and then make

2. Check remote wallet after upgrading: ./venus-gateway wallet list

3. Check miners after upgrading: ./venus-gateway miner list

venus-market

Feature:

Precautions:

1. Compile: first make dist-clean and then make

venus-wallet

Feature:

Precautions:

1. Need to unlock the wallet after restart

2. Check if wallet is properly registered to the gateway

venus-sector-manager

Compile: first make dist-clean and then make