【公告】PlatON网络V1.2.1升级公告及说明

中文版

PlatON节点伙伴们，PlatON网络赫歇尔 (v1.2.1)版本已经发布，本版本为小版本更新，节点可根据自身情况选择升级。需要升级的情况说明请您查看本文的DApp部分。

为什么升级

V1.2.0版本虽然已经可以同时支持两个链ID（100和210425），但仍存在以下问题：

1.无法在MetaMask上使用新链ID
2.通过SDK使用新链ID或通过在节点上unlock账户的方式不能创建新的合约

根据PIP-7提案的最终目标，PlatON主网的链ID将最终只支持210425，为了新应用在后续升级过程中影响降低到最小，在PIP-7提案的阶段2中将节点的默认链ID调整为新值210425，这同时也能让MetaMask适配新链ID。这一阶段将通过PlatON V1.2.1版本实现，同时上述不能使用新链ID或通过在节点上unlock账户的方式发起合约部署交易的问题也在该版本一并做了修复。

升级有什么影响

验证人节点

V1.2.1版本是小版本（Patch），无需通过链上提案升级，因此该版本对于验证人节点或候选节点来说无任何影响。

DApp应用

V1.2.1版本升级后，开发者需要注意以下内容的变更，以确定应用逻辑是否需要修改。

1.合约中CHAINID指令返回的仍是旧链ID，后续版本会修改为返回新链ID
2.应用发起交易时既可以使用新链ID也可以继续沿用旧链ID
3.通过RPC接口获取的链ID将是新的链ID
4.用unlock方式发交易用的是新的链ID

已部署大部分的DAPP应用无需修改，但是仍然建议：

1.检查合约中是否使用CHAINID指令，评估该指令返回旧链ID对现有逻辑的影响，需要考虑外部交易可能会使用新链ID，比如通过Metamask签发的交易
2.检查链下发起交易的方式，特别注意使用通过RPC接口获取的链ID是新链ID，unlock方式也是使用新链ID
3.如果要升级合约，且合约中有使用CHAINID指令的，建议同时适配新旧2个链ID

对于新部署的DAPP应用，建议：
1.因PlatON将逐渐减少对旧ID的支持，如无特殊情况请使用新链ID发起交易，这样可以减少后续升级对应用造成的影响
2.由于合约中CHAINID指令返回的仍是旧链ID，且后续会升级为返回新链ID，建议同时适配新旧2个链ID

关于应用适配双ChainId的最佳实践请参考开发手册。

用户

升级到V1.2.1版本后，用户可自行决定使用新链ID还是旧ID。

PlatON主网

1.使用新链ID
如果用户希望使用新链ID，可以在V1.2.1版本发布后通过在MetaMask上添加新网络时指定新RPCURL：

https://openapi2.platon.network/rpc。

也可以通过ChainList添加PlatON主网络，打开ChainList(https://chainlist.org/)并搜索”PlatON”，可以发现PlatON Mainnet。

2.继续使用旧ID
以旧链ID面向开发者提供的公共RPC服务（地址为https://openapi.platon.network/rpc）将继续保留，升级前已经添加旧链ID网络配置的用户，可以继续使用原有网络配置，但是建议切换为新链ID的网络配置。

PlatON开发网

1.使用新链ID
如果用户想使用新链ID，请在MetaMask上添加新网络时指定新RPCURL：https://devnetopenapi2.platon.network/rpc。
2.继续使用旧ID
和主网类似，PlatON开发网公共RPC地址https://devnetopenapi.platon.network/rpc将继续以旧链ID 210309向开发者提供公共RPC服务，之前已经添加了开发网的MetaMask用户可以继续使用不受影响。