CIP-37（Conflux-rust v1.1.1 ）更新对开发者的影响【非正式版】

2021年01月28日 16:01 · 阅读 178

本次更新为兼容版本更新，公链的共识层没有发生改变。

本次升级临近中国假期，贸然升级可能无法得到足够多的技术支持，建议大家谨慎升级。 建议所有Conflux生态产品在2月22日之后升级新节点。Conflux-rust 从版本 v1.1.1 开始将会使用新地址格式，凡是请求参数，返回结果中包含地址的地方，均使用新格式地址。

Conflux基金会建议未来Conflux生态逐渐淘汰旧版hex40格式地址（0x开头），统一更新为 base32格式的地址（以网络标识开头，如cfx:），ConfluxScan会有新旧地址转换。

新旧地址格式只是做了一次编码转换，原有的私钥和助记词可以正常登陆Conflux钱包账户，不会对个人资产有任何影响。

CIP37 详细内容参见： github.com/Conflux-Cha…

中文翻译参见： forum.conflux.fun/t/topic/474…

v1.1.1升级的内容

不兼容变更

CIP-37：Conflux 地址将变更为 base32 地址格式。RPC与全节点的交互中不支持与以太坊格式类似的十六进制地址。
把所有的数据（包括目录 storage_db、 blockchain_db和 net_config）都存储在一个通过“conflux_data_dir”配置的目录中（默认目录名为 blockchain_data）。

兼容 RPC 变更

添加 cfx_getSupplyInfo，返回 CFX 供应量。
在 cfx_getStatus响应中包括 networkId。
在 cfx_getAccount 响应中包括 address

改进

在 mining_author参数中支持 CIP-37 地址格式。
减少日志“发布-订阅”中的延迟，现在我们在日志可用之后立即将其发出。
实现执行跟踪功能，包括详细的由转账触发的调用/创建/返回/内部转账事件等，检查踪迹信息可以让ConfluxScan之类的应用能够追踪 CFX 转移的精确踪迹。
优化了测试框架，解决了一些随机测试失败的问题。

我是Conflux生态开发者，我需要做什么？

Conflux官方将于1月31日更新完毕升级教程和各版本SDK，但建议2月22号之前所有的矿场、交易所、钱包、DApp不要更新新的节点（RPC）。使用官方节点（RPC）的用户可以暂时保持不动，同时官方会推出新版本的RPC，旧的RPC会至少保留到三月底。

更新节点（RPC）后，需要更新使用新的SDK，之后不加额外适配的情况下只能同base32格式的地址（以网络标识开头，如cfx:）交互，请各钱包、交易所、智能合约注意提示用户。

对前端页面的影响

Portal

Portal更新为0.5.10 版本后，api 返回旧版hex40格式地址（0x开头），签名只支持旧版hex40格式地址（0x开头），转账转到旧版hex40格式地址（0x开头）时会有提示。
Portal更新为 0.5.11 版本后，api 只返回 base32 地址，签名同时支持旧版hex40格式地址（0x开头）和base32格式的地址（以网络标识开头，如cfx:）。
DApp 需要考虑用户可能不升级 Portal 新版本，api 返回新老地址共存的情况。

Conflux Javascript SDK如何适配CIP37（教程）： 正在校验中

中文版参考： juejin.cn/post/692014…

对后端服务程序的影响

SDK如何适配参考

Conflux Java SDK如何适配CIP37： 正在校验中

中文版参考： juejin.cn/post/692269…

Conflux Golang SDK如何适配CIP37： 正在校验中

中文版参考： 正在校验中

节点文档配置

目录变化：

现在所有的数据都放在了conflux_data_dir这个参数配置的目录下，默认路径为./blockchain_data.

以前的默认目录结构：

├── blockchain_db
├── net_config
├── storage_db
├── conflux
├── log
├── log.yaml
├── start.bat
├── start.sh
├── stderr.txt
├── tethys.toml
复制代码

现在的默认目录结构

├── blockchain_data
│   ├── blockchain_db
│   ├── net_config
│   └── storage_db
├── conflux
├── log
├── log.yaml
├── start.bat
├── start.sh
├── stderr.txt
├── tethys.toml
复制代码

适配方法1（推荐）：

新建目录blockchain_data，并将blockchain_db, net_config, storage_db 三个目录移动到blockchain_data 下。不用修改配置文件tethys.toml.

适配方法2：

不移动目录，在配置文件tethys.toml里设置

conflux_data_dir = "."
netconf_dir = "./net_config"
block_db_dir = "./blockchain_db"
复制代码

SDK升级的说明文档