diff --git a/2.x/docs/compatibility.md b/2.x/docs/compatibility.md index 698b4abbc..73d079ea6 100644 --- a/2.x/docs/compatibility.md +++ b/2.x/docs/compatibility.md @@ -477,3 +477,59 @@ FISCO-BCOS 3.0.0 及之后的版本之间相互兼容。FISCO-BCOS 3.0.0-rc的 | WeBankBlockchain-Governance-Key | 私钥管理组件 | v1.0.2 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Key/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Key) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Key) | | | WeBankBlockchain-Governance-Authority | 权限治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Acct/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Account/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Account/tree/V3/) | | | WeBankBlockchain-Governance-Account | 账户治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Auth/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Authority/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Authority/tree/V3/) | | + +#### 3.2.13. FISCO-BCOS v3.9.x + +| 项目 | 功能简介 | 版本 | 文档 | github | gitee | 备注 | +|---------------------------------------|------------------------|-------------|-----------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|---------------------------------------------------------------------------|--------------------------| +| FISCO-BCOS | 区块链底层平台 | v3.9.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/) | [github](https://github.com/FISCO-BCOS/FISCO-BCOS/tree/v3.8.0) | [gitee](https://gitee.com/FISCO-BCOS/FISCO-BCOS/tree/v3.8.0) | | +| Solidity | solidity智能合约 | v0.8.11 | [文档](https://docs.soliditylang.org/en/v0.8.11) | | | **最高支持solidity v0.8.11** | +| JavaSDK | Java语言SDK | v3.7.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/sdk/java_sdk/index.html) | [github](https://github.com/FISCO-BCOS/java-sdk/tree/v3.7.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk/tree/v3.7.0) | | +| GoSDK | Go语言SDK | 开发中 | | [github](https://github.com/FISCO-BCOS/go-sdk) | | | +| PythonSDK | Python语言SDK | 暂不支持 | | | | | +| 控制台(console) | 交互式命令行工具 | v3.7.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/index.html) | [github](https://github.com/FISCO-BCOS/console/tree/v3.7.0) | [gitee](https://gitee.com/FISCO-BCOS/console/tree/v3.7.0) | | +| java-sdk-demo | Java压测工具 | v3.10.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/stress_testing.html) | [github](https://github.com/FISCO-BCOS/java-sdk-demo/tree/3.7.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk-demo/tree/3.7.0) | | +| spring-boot-starter | Gradle SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0-rc4#spring-boot-starter) | [github](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | | +| spring-boot-crud | Maven SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0-rc4#spring-boot-crud) | [github](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | | +| generator | 企业区块链部署工具 | 不支持 | | | | | +| WeBASE | 区块链中间件平台 | v3.0.2 | [文档](https://webasedoc.readthedocs.io/zh_CN/lab/) | [github](https://github.com/WeBankBlockchain/WeBASE/tree/master-3.0) | [gitee](https://gitee.com/WeBank/WeBASE/tree/master-3.0) | | +| WeCross | 跨链协作平台 | v1.3.0 | | | | | +| WeIdentity | 分布式身份解决方案 | v3.0.0-rc.1 | [文档](https://weidentity.readthedocs.io/zh_CN/latest/) | [github](https://github.com/WeBankBlockchain/WeIdentity) | [gitee](https://gitee.com/WeBank/WeIdentity) | | +| WeBankBlockchain-Data-Export | 数据导出组件 | V3 | [文档](https://data-doc.readthedocs.io/zh_CN/data_export_3.0/docs/WeBankBlockchain-Data-Export/index.html) | [github](https://github.com/WeBankBlockchain/Data-Export/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Data-Export/tree/V3/) | | +| WeBankBlockchain-Data-Stash | 数据仓库组件 | 不支持 | | | | | +| WeBankBlockchain-Data-Reconcile | 数据对账组件 | v1.0.0 | [文档](https://data-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Data-Reconcile/index.html) | [github](https://github.com/WeBankBlockchain/Data-Reconcile) | [gitee](https://gitee.com/WeBankBlockchain/Data-Reconcile) | | +| WeBankBlockchain-SmartDev-Scaffold | 应用开发脚手架 | V3 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Scaffold/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3/) | | +| WeBankBlockchain-SmartDev-SCGP | 智能合约编译插件 | v1.0.1 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-SCGP/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-SCGP) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-SCGP) | | +| WeBankBlockchain-SmartDev-Contract | 智能合约库 | v1.0.0 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Contract/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Contract) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Contract) | | +| WeBankBlockchain-Governance-Cert | 证书管理组件 | v1.0.1 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Cert/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Cert) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Cert) | | +| WeBankBlockchain-Governance-Key | 私钥管理组件 | v1.0.2 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Key/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Key) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Key) | | +| WeBankBlockchain-Governance-Authority | 权限治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Acct/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Account/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Account/tree/V3/) | | +| WeBankBlockchain-Governance-Account | 账户治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Auth/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Authority/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Authority/tree/V3/) | | + +#### 3.2.14. FISCO-BCOS v3.10.x + +| 项目 | 功能简介 | 版本 | 文档 | github | gitee | 备注 | +|---------------------------------------|------------------------|-------------|-----------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|---------------------------------------------------------------------------|--------------------------| +| FISCO-BCOS | 区块链底层平台 | v3.10.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/) | [github](https://github.com/FISCO-BCOS/FISCO-BCOS/tree/v3.8.0) | [gitee](https://gitee.com/FISCO-BCOS/FISCO-BCOS/tree/v3.8.0) | | +| Solidity | solidity智能合约 | v0.8.26 | [文档](https://docs.soliditylang.org/en/v0.8.11) | | | **最高支持solidity v0.8.11** | +| JavaSDK | Java语言SDK | v3.8.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/sdk/java_sdk/index.html) | [github](https://github.com/FISCO-BCOS/java-sdk/tree/v3.7.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk/tree/v3.7.0) | | +| GoSDK | Go语言SDK | 开发中 | | [github](https://github.com/FISCO-BCOS/go-sdk) | | | +| PythonSDK | Python语言SDK | 暂不支持 | | | | | +| 控制台(console) | 交互式命令行工具 | v3.8.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/console/index.html) | [github](https://github.com/FISCO-BCOS/console/tree/v3.7.0) | [gitee](https://gitee.com/FISCO-BCOS/console/tree/v3.7.0) | | +| java-sdk-demo | Java压测工具 | v3.10.x | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/stress_testing.html) | [github](https://github.com/FISCO-BCOS/java-sdk-demo/tree/3.7.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk-demo/tree/3.7.0) | | +| spring-boot-starter | Gradle SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0-rc4#spring-boot-starter) | [github](https://github.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-starter/tree/v3.0.0) | | +| spring-boot-crud | Maven SpringBoot 应用示例 | v3.0.0 | [文档](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0-rc4#spring-boot-crud) | [github](https://github.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | [gitee](https://gitee.com/FISCO-BCOS/spring-boot-crud/tree/v3.0.0) | | +| generator | 企业区块链部署工具 | 不支持 | | | | | +| WeBASE | 区块链中间件平台 | v3.0.2 | [文档](https://webasedoc.readthedocs.io/zh_CN/lab/) | [github](https://github.com/WeBankBlockchain/WeBASE/tree/master-3.0) | [gitee](https://gitee.com/WeBank/WeBASE/tree/master-3.0) | | +| WeCross | 跨链协作平台 | v1.3.0 | | | | | +| WeIdentity | 分布式身份解决方案 | v3.0.0-rc.1 | [文档](https://weidentity.readthedocs.io/zh_CN/latest/) | [github](https://github.com/WeBankBlockchain/WeIdentity) | [gitee](https://gitee.com/WeBank/WeIdentity) | | +| WeBankBlockchain-Data-Export | 数据导出组件 | V3 | [文档](https://data-doc.readthedocs.io/zh_CN/data_export_3.0/docs/WeBankBlockchain-Data-Export/index.html) | [github](https://github.com/WeBankBlockchain/Data-Export/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Data-Export/tree/V3/) | | +| WeBankBlockchain-Data-Stash | 数据仓库组件 | 不支持 | | | | | +| WeBankBlockchain-Data-Reconcile | 数据对账组件 | v1.0.0 | [文档](https://data-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Data-Reconcile/index.html) | [github](https://github.com/WeBankBlockchain/Data-Reconcile) | [gitee](https://gitee.com/WeBankBlockchain/Data-Reconcile) | | +| WeBankBlockchain-SmartDev-Scaffold | 应用开发脚手架 | V3 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Scaffold/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Scaffold/tree/V3/) | | +| WeBankBlockchain-SmartDev-SCGP | 智能合约编译插件 | v1.0.1 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-SCGP/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-SCGP) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-SCGP) | | +| WeBankBlockchain-SmartDev-Contract | 智能合约库 | v1.0.0 | [文档](https://toolkit-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-SmartDev-Contract/index.html) | [github](https://github.com/WeBankBlockchain/SmartDev-Contract) | [gitee](https://gitee.com/WeBankBlockchain/SmartDev-Contract) | | +| WeBankBlockchain-Governance-Cert | 证书管理组件 | v1.0.1 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Cert/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Cert) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Cert) | | +| WeBankBlockchain-Governance-Key | 私钥管理组件 | v1.0.2 | [文档](https://governance-doc.readthedocs.io/zh_CN/latest/docs/WeBankBlockchain-Governance-Key/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Key) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Key) | | +| WeBankBlockchain-Governance-Authority | 权限治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Acct/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Account/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Account/tree/V3/) | | +| WeBankBlockchain-Governance-Account | 账户治理组件 | V3 | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Auth/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Authority/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Authority/tree/V3/) | | diff --git a/2.x/docs/manual/permission_control.md b/2.x/docs/manual/permission_control.md index 2ea9f7596..bcc3d7c6b 100644 --- a/2.x/docs/manual/permission_control.md +++ b/2.x/docs/manual/permission_control.md @@ -299,7 +299,7 @@ Empty set. ```eval_rst .. important:: - 推荐管理员机制：由于系统默认无权限设置记录，因此任何账户均可以使用权限设置功能。例如当账户1设置账户1有权限部署合约，但是账户2也可以设置账户2有权限部署合约。那么账户1的设置将失去控制的意义，因为其他账户可以自由添加权限。因此，搭建联盟链之前，推荐确定权限使用规则。可以使用grantPermissionManager(V2.5.0之前的命令,V2.5.0之后由grantCommitteeManager替代，涉及下文中出现的grantPermissionManager，均与此相同)指令设置链管理员账户，即指定特定账户可以使用权限分配功能，非链管理员账户无权限分配功能。 + 推荐管理员机制：由于系统默认无权限设置记录，因此任何账户均可以使用权限设置功能。例如当账户1设置账户1有权限部署合约，但是账户2也可以设置账户2有权限部署合约。那么账户1的设置将失去控制的意义，因为其他账户可以自由添加权限。因此，搭建联盟链之前，推荐确定权限使用规则。可以使用grantPermissionManager(V2.5.0之前的命令,V2.5.0之后由grantCommitteeMember替代，涉及下文中出现的grantPermissionManager，均与此相同)指令设置链管理员账户，即指定特定账户可以使用权限分配功能，非链管理员账户无权限分配功能。 ``` ### 操作内容 @@ -321,9 +321,9 @@ FISCO BCOS提供控制台命令使用权限功能（针对开发者，可以调 |命令名称|命令参数|功能| |:----|:-----|:----| -|grantPermissionManager |address |授权账户的链管理员权限(V2.5.0之前的命令,V2.5.0之后由grantCommitteeManager替代) | -|revokePermissionManager |address |撤销账户的链管理员权限(V2.5.0之前的命令,V2.5.0之后由revokeCommitteeManager替代) | -|listPermissionManager | |查询拥有链管理员权限的账户列表(V2.5.0之前的命令,V2.5.0之后由listCommitteeManager替代) | +|grantPermissionManager |address |授权账户的链管理员权限(V2.5.0之前的命令,V2.5.0之后由grantCommitteeMember替代) | +|revokePermissionManager |address |撤销账户的链管理员权限(V2.5.0之前的命令,V2.5.0之后由revokeCommitteeMember替代) | +|listPermissionManager | |查询拥有链管理员权限的账户列表(V2.5.0之前的命令,V2.5.0之后由listCommitteeMember替代) | |grantDeployAndCreateManager |address |授权账户的部署合约和创建用户表权限 | |revokeDeployAndCreateManager |address |撤销账户的部署合约和创建用户表权限 | |listDeployAndCreateManager | |查询拥有部署合约和创建用户表权限的账户列表| diff --git a/3.x/release_note.txt b/3.x/release_note.txt index 130165bc0..5f22788f5 100644 --- a/3.x/release_note.txt +++ b/3.x/release_note.txt @@ -1 +1 @@ -v3.6.0 +v3.9.0 diff --git a/3.x/zh_CN/conf.py b/3.x/zh_CN/conf.py index cee3bb7da..e8252e374 100644 --- a/3.x/zh_CN/conf.py +++ b/3.x/zh_CN/conf.py @@ -87,7 +87,7 @@ # The short X.Y version. version = '3.0' # The full version, including alpha/beta/rc tags. -release = 'v3.6.0' +release = 'v3.9.0' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. diff --git a/3.x/zh_CN/docs/design/sync.md b/3.x/zh_CN/docs/design/sync.md index ea09a9be5..a17612793 100644 --- a/3.x/zh_CN/docs/design/sync.md +++ b/3.x/zh_CN/docs/design/sync.md @@ -36,6 +36,18 @@ 收到回复区块的节点，在本地维护一个下载队列，用来对下载下来的区块进行缓冲和排序。下载队列是一个以块高为顺序的优先队列。下载下来的区块，会不断的插入到下载队列中，当队列中的区块能连接上节点当前本地的区块链，则将区块从下载队列中取出，真正的连接到当前本地的区块链上。 +### 同步区块处理流程 + +同步收到的区块处理流程如下： + +1. 节点收到请求的同步区块，按块高排序 +1. 验证接收队列中的最大块是否是节点当前区块高的下一个块高 +1. 执行区块，验证执行后得到的区块头与接收的区块头是否一致 +1. 验证区块不是空块 +1. 验证区块的签名列表是否正确 + +当上述验证都通过后，同步的区块才会被提交到账本中 + ## 同步场景举例 ### 交易广播场景 diff --git a/3.x/zh_CN/docs/develop/amop.md b/3.x/zh_CN/docs/develop/amop.md index f2f108745..de836157d 100644 --- a/3.x/zh_CN/docs/develop/amop.md +++ b/3.x/zh_CN/docs/develop/amop.md @@ -1,4 +1,4 @@ -# 7. 使用AMOP功能 +# 8. 使用AMOP功能 标签：``java-sdk`` ``AMOP`` ``链上信使协议`` diff --git a/3.x/zh_CN/docs/develop/contract_safty_practice.md b/3.x/zh_CN/docs/develop/contract_safty_practice.md index 7c77ee2ba..1aaccc702 100644 --- a/3.x/zh_CN/docs/develop/contract_safty_practice.md +++ b/3.x/zh_CN/docs/develop/contract_safty_practice.md @@ -1,4 +1,4 @@ -# 9. 智能合约安全实践 +# 10. 智能合约安全实践 智能合约安全是指在设计、编码、部署、运行和维护智能合约的全生命周期中，采取措施确保合约的安全性和可靠性，防止恶意攻击、漏洞利用或错误操作导致的资产损失或系统崩溃。 diff --git a/3.x/zh_CN/docs/develop/privacy.md b/3.x/zh_CN/docs/develop/privacy.md index a0082c76c..4a1db6b35 100644 --- a/3.x/zh_CN/docs/develop/privacy.md +++ b/3.x/zh_CN/docs/develop/privacy.md @@ -1,4 +1,4 @@ -# 8. 使用同态加密与群环签名 +# 9. 使用同态加密与群环签名 标签：``隐私合约`` ``隐私保护`` ``合约开发`` ``同态加密`` ``环签名`` ``群签名`` @@ -115,7 +115,7 @@ FISCO BCOS隐私保护模块是通过预编译合约实现的，默认被启用 源码可参考链接：[GitHub链接](https://github.com/FISCO-BCOS/FISCO-BCOS/tree/master/bcos-executor/src/precompiled/extension)、[Gitee链接](https://gitee.com/FISCO-BCOS/FISCO-BCOS/tree/master/bcos-executor/src/precompiled/extension) - | 地址 | 功能 | 源码 | - | ------ | ---------- | ------------------------------------------------------------ | - | 0x5004 | 群签名 | GroupSigPrecompiled.cpp | - | 0x5005 | 环签名 | RingSigPrecompiled.cpp | + | 地址 | 功能 | 源码 | + |--------|--------|-------------------------| + | 0x5004 | 群签名 | GroupSigPrecompiled.cpp | + | 0x5005 | 环签名 | RingSigPrecompiled.cpp | diff --git a/3.x/zh_CN/docs/develop/smartdev_index.md b/3.x/zh_CN/docs/develop/smartdev_index.md index 425a8bb62..5f616ac5d 100644 --- a/3.x/zh_CN/docs/develop/smartdev_index.md +++ b/3.x/zh_CN/docs/develop/smartdev_index.md @@ -1,4 +1,4 @@ -# 6. SmartDev应用开发组件 +# 7. SmartDev应用开发组件 标签：``WeBankBlockchain-SmartDev`` ``应用开发`` ``通用组件`` ``智能合约库`` ``智能合约编译插件`` ``应用开发脚手架`` diff --git a/3.x/zh_CN/docs/develop/web3_usage.md b/3.x/zh_CN/docs/develop/web3_usage.md new file mode 100644 index 000000000..a0c10db82 --- /dev/null +++ b/3.x/zh_CN/docs/develop/web3_usage.md @@ -0,0 +1,190 @@ +# 6. (New✨)使用Web3工具部署调用合约 + +标签：``Web3`` ``Remix`` ``Hardhat`` ``OpenZeppelin`` + +---- + +```eval_rst +.. important:: + FISCO BCOS在3.9.0版本开始支持使用Web3 JSON RPC，本文都基于FISCO BCOS开启Web3 JSON RPC之后使用的。详情请参考`【3.9.0版本说明】 `_ +``` + +## 1. 开启Web3配置 + +在3.9.0的版本中的创世块中新增了web3 chain_id的字段，该字段将用于Web3工具辨认链的标识，有重要作用，**必须在启动初始化时确定**。 + +```toml +[web3] + chain_id=20200 +``` + +在配置项中新增了`web3_rpc`的配置项，默认为false，需要手动开启。 + +```toml +[web3_rpc] + enable=false + listen_ip=127.0.0.1 + listen_port=8545 + thread_count=16 +``` + +### 1.1 旧节点升级并开启Web3配置 + +由于旧节点未存储关于Web3 Chain ID的信息，所以需要使用增加配置项的形式更新字段信息。按以下步骤执行即可： + +1. 升级区块链二进制至3.9.0版本，灰度操作可参考：[版本升级指南](https://fisco-bcos-doc.readthedocs.io/zh-cn/latest/docs/introduction/change_log/upgrade.html) + +2. 更新数据版本号到最新版本3.9.0： + + ```shell + setSystemConfigByKey compatibility_version 3.9.0 + ``` + +3. 配置系统配置项`web3_chain_id` + + ```shell + setSystemConfigByKey web3_chain_id 20200 + ``` + +4. 选择旧节点的配置文件，开启配置项 + + ```shell + # 更改config.ini + vim config.ini + + [web3_rpc] + enable=true + listen_ip=0.0.0.0 + listen_port=8545 + thread_count=16 + ``` + +### 1.2 开启Balance功能 + +Balance功能在FISCO BCOS从3.7.0开始就已经支持。为了用户能顺滑地使用Web3相关的工具，需要在节点处预先开启Balance相关的功能，并给测试账户充值足够多的Balance。详情请参考以下步骤： + +```shell +# 开启总体功能 +setSystemConfigByKey feature_balance 1 +# 开启Balance预编译功能 +setSystemConfigByKey feature_balance_precompiled 1 +``` + +## 2. 使用Remix向FISCO BCOS发送交易 + +**使用前提** + +- **必须熟悉**Remix、MetaMask的使用，这两个工具都是开源工具，请参考以下文档： + - [Remix documentation](https://remix-ide.readthedocs.io/en/latest/) + - [MetaMask developer documentation](https://docs.metamask.io/) +- 为了更好地使用，请在能流畅访问外网环境下进行测试。 + +### 2.1 配置MetaMask + +以下步骤以完全配置好MetaMask作为前提。 + +#### 2.1.1 手动添加网络 + +在MetaMask的设置中选择网络选项，点击`Add a network` + +![](../../images/develop/metamask_add_network.png) + +由于测试链没有在MetaMask列表中，需要手动填写链信息添加到MetaMask。 + +![](../../images/develop/metamask_manual_add_network.png) + +手动填写FISCO BCOS的信息内容。**特别注意：** RPC URL与Chain ID必须要和真是场景保持一致。 + +![metamask_add_fb_info](../../images/develop/metamask_add_fb_info.png) + +#### 2.1.2 在MetaMask查看账户余额 + +可以从账户列表中查看所有账户以及对应的balance余额 + +![metamask_balance](../../images/develop/metamask_balance.png) + +#### 2.1.3 使用MetaMask进行转账 + +用户可以通过MetaMask自带的转账功能进行balance转账。需要注意的是，Gas Limit需要手动填写。 + +![metamask_transfer](../../images/develop/metamask_transfer.png) + +确认好交易信息之后点击确认即可发送交易。 + +![metamask_transfer_confirm](../../images/develop/metamask_transfer_confirm.png) + +#### 2.1.4 查看交易信息 + +可以点击活动页查看交易的详细信息。 + +![metamask_transfer_tx](../../images/develop/metamask_transfer_tx.png) + +### 2.2 使用Remix接入MetaMask部署调用合约 + +在Remix部署和调用交易界面中配置环境信息。在环境中选择 `Injected Provider - MetaMask`即可。 + +![remix_metamask_in](../../images/develop/remix_metamask_in.png) + +在发起部署/调用合约时，Remix将会把合约内容发送到MetaMask，页面将会跳转到MetaMask进行确认签名。 + +![remix_metamask_tx](../../images/develop/remix_metamask_tx.png) + +## 3. 使用Hardhat工具向FISCO BCOS发送交易 + +**使用前提** ：**必须熟悉** Nodejs项目构建、nodejs基础语法、HardHat的使用，请参考以下文档： + +- [Hardhat's tutorial for beginners](https://hardhat.org/tutorial) +- [Hardhat setting up a project](https://hardhat.org/hardhat-runner/docs/guides/project-setup) + +### 3.1 使用Hardhat demo + +为了方便测试，另外建好了hardhat的demo仓库：https://github.com/kyonRay/bcos-hardhat-tutorial + +项目结构如下，contracts存放solidity合约，ignition存放最终部署上链的工具，test存放所有的合约测试代码。hardhat.config.js就是hardhat的基础配置文件。 + +![hardhat_structure](../../images/develop/hardhat_structure.png) + +在hardhat.config.js的配置文件中配置好IP端口、chainID，并向红框内的地址发送足够的balance。 + +![](../../images/develop/hardhat_config.png) + +在test文件夹中实现了基础token的测试代码。 + +![hardhat_test](/Users/kyonguo/workdir/code/FISCO-BCOS-DOC/3.x/zh_CN/images/develop/hardhat_test.png) + +在终端执行以下命令就可以跑所有测试： + +```shell +hardhat test --network localhost +``` + +### 3.2 使用Hardhat连接FISCO BCOS注意点 + +#### 部署合约后地址需要重新设置 + +由于FISCO BCOS与Web3在地址计算中存在区别，Hardhat在部署好合约后将在本地根据合约的nonce以及发送者地址计算得出新的合约地址，这与FISCO BCOS不兼容。因此在部署完成合约之后，还需要手动设置合约地址才行。代码示例如下： + +```js +// fb-deploy-helper.js +const { ethers } = require('hardhat'); + +async function deployFBContract(name, args, opts = undefined) { + let contract = await ethers.deployContract(name, args, opts); + const txHash = contract.deploymentTransaction().hash; + const receipt = await ethers.provider.getTransactionReceipt(txHash); + contract = contract.attach(receipt.contractAddress); + return contract; +} + +module.exports = { deployFBContract }; +``` + +## 4. 遗留工作 + +FISCO BCOS目前已经支持使用绝大多数Web3工具连接，拓展了FISCO BCOS的生态圈。由于工程时间、优先级不高的原因，还剩一些遗留工作，后续将逐步补全。 + +1. 合约地址符合Web3合约地址规则 —— 3.12版本解决 +2. 暂不支持cancun的opcode —— 3.10版本解决 +3. gaslimit等EIP1559字段在计算gas时没用使用 —— 3.12版本解决 +4. EVM中时间从毫秒对齐到秒 —— 3.12版本解决 +5. 读取合约历史状态 —— 3.12版本解决 diff --git a/3.x/zh_CN/docs/introduction/change_log/3_10_0.md b/3.x/zh_CN/docs/introduction/change_log/3_10_0.md new file mode 100644 index 000000000..3df44db38 --- /dev/null +++ b/3.x/zh_CN/docs/introduction/change_log/3_10_0.md @@ -0,0 +1,130 @@ +# v3.10.0 + +## 新增 + +- 新增feature开关feature_evm_cancun，用于控制EVM升级至CANCUN版本。相关PR：[#4332](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4332) +- EVM支持至CANCUN版本，支持TLOAD, TSTORE, MCOPY, BLOBHASH and + BLOBBASEFEE等最新操作码，支持soldity为0.8.26版本合约部署。相关PR：[#4332](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4332) +- 一键搭链脚本增加开启日志级别为debug功能。相关PR：[#4411](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4511) + +## 修复 + +* 解决baseline模式下合约不存在时返回码与串行模式不同的问题。相关PR：[#4512](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4512) +* 解决baseline模式下合约revert时可能会内存泄露的问题。相关PR：[#4554](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4554) +* 限制baseline模式下缓存合约executive的数量，减少内存占用。相关PR：[#4559](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4559) +* 修复Web3 JSON RPC部分接口不填入Block Tag导致节点退出的问题。PR：[#4547](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4559) + +## 兼容性说明 + +### 兼容版本 + +需要升级的链的“数据兼容版本号（[compatibility_version](#id5)）”为如下版本时： + +* 3.4.x、3.5.x，3.6.x、3.7.x、3.8.x：数据完全兼容当前版本，直接替换二进制即可完成升级 +* 3.3.x、3.2.x、3.1.x、3.0.x：支持通过替换二进制进行灰度升级，若需使用当前版本的新特性，需升级数据兼容版本号，操作见[文档](#id5) +* 3.0-rc x：数据不兼容，无法升级，可考虑逐步将业务迁移至3.x正式版 +* 2.x：数据不兼容，2.x版本仍持续维护，可考虑升级为2.x的最新版本 + +### 实验功能 + +效果：通过feature开关控制实验功能的开启 + +操作：升级节点可执行程序后，通过控制台命令`setSystemConfigByKey 1` 开启对应实验功能，具体操作见文档升级方法部分 + +注意事项： + +* feature操作不可逆，打开后不可关闭 +* 需确认所有可执行程序版本相同后，再进行feature开启操作 + +| | Feature 名 | 默认状态 | 说明 | +|--------------|----------------------------|------|--------------------------------------------| +| 资产管理 | feature_balance | 关：0 | 默认关闭 | +| 资产操作预编译合约 | feature_balance_precompile | 关：0 | 默认关闭 | +| 计费模式 | feature_policy1 | 关：0 | 默认关闭 | +| 块内分片 | feature_sharding | 关：0 | 默认关闭，仅在从3.3、3.4升级至当前版本时，feature_sharding打开 | +| 同态加密 | feature_paillier | 关：0 | 默认关闭 | +| rpbft共识 | feature_rpbft | 关：0 | 默认关闭 | +| EVM升级至CANCUN | feature_evm_cancun | 关：0 | 默认关闭 | +| bug修复 | bugfix_\ | 开：1 | 从低版本升级默认关闭 | + +**组件兼容性** + +| | 推荐版本 | 最低版本 | 说明 | +|------------|-------------|---------------------|-------------------| +| WeBASE | 3.0.2 | 3.0.2 | | +| WeIdentity | v3.0.0-rc.1 | v3.0.0-rc.1 | | +| Console | 3.8.0 | 3.0.0 | | +| Java SDK | 3.8.0 | 3.0.0 | | +| CPP SDK | 3.8.0 | 3.0.0 | | +| Solidity | 0.8.26 | 最低 0.4.25，最高 0.8.26 | 需根据合约版本下载编译器（控制台） | +| WBC-Liquid | 1.0.0-rc3 | 1.0.0-rc3 | | + +#### 升级方法 + +该操作仅支持将3.x版本升级为本版本，不支持3.0-rc或2.x的升级。 + +##### 查询数据兼容版本号（compatibility_version） + +用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#getsystemconfigbykey) +进行查询，如当前返回的版本为3.9.0 + +``` +[group0]: /apps> getSystemConfigByKey compatibility_version +3.9.0 +``` + +##### 替换节点二进制 + +需将**所有节点** 的二进制逐步替换为当前版本。为了不影响业务，替换过程能够以灰度方式进行，逐个替换并重启节点。替换过程中，当前的链仍然会以旧的数据兼容版本号的逻辑继续执行。当所有节点二进制替换完成并重启后，需用控制台修改数据兼容版本号为当前版本。 + +##### 设置数据兼容版本号（compatibility_version） + +用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#setsystemconfigbykey) +设置数据兼容版本号，如当前版本为3.9.0。 + +``` +[group0]: /apps> setSystemConfigByKey compatibility_version 3.9.0 +{ + "code":0, + "msg":"success" +} + +注：若开启权限治理功能，需要使用 setSysConfigProposal 命令 +``` + +设置成功，再次查询，得到当前版本已升级为3.10.0 + +``` +[group0]: /apps> getSystemConfigByKey compatibility_version +3.10.0 +``` + +当前链已经完成升级，至此，**链开始以新的逻辑继续运行**，并支持了新的特性。 + +#### EVM升级至CANCUN使用说明 + +首先通过控制台命令`setSystemConfigByKey feature_evm_cancun 1`开启EVM升级至CANCUN功能，然后部署0.8.26版本的合约。 + +注意：在部署0.8.26版本合约时，需要在depoly 后面指定sol-version 为0.8.26，如下所示： + +``` + +[group0]: /apps> deploy StorageSlot.sol --sol-version 0.8.26 +transaction hash: 0x8f3564047e3dd2913ed30f193e10c2b8af2b24896ce10b8add8eb47b888d7505 +contract address: 0x29f1926cab679bc8bdd0757fb92adf020c8bd398 +currentAccount: 0x0296737557c85bde21b4cf766c3f85e2e4c14d66 + +// 否则使用默认0.8.11版本编译则会报错 +[group0]: /apps> deploy StorageSlot.sol +Warning: SPDX license identifier not provided in source file. Before publishing, consider adding a comment containing "SPDX-License-Identifier: " to each source file. Use "SPDX-License-Identifier: UNLICENSED" for non-open-source code. Please see https://spdx.org for more information. +--> StorageSlot.sol + +Error: Function "tload" not found. + --> StorageSlot.sol:127:22: + | +127 | value := tload(slot) + | ^^^^^ + +Error: Variable count for assignment to "value" does not match number of values (1 vs. 0) + +``` diff --git a/3.x/zh_CN/docs/introduction/change_log/3_7_0.md b/3.x/zh_CN/docs/introduction/change_log/3_7_0.md index f41d02be7..45174da14 100644 --- a/3.x/zh_CN/docs/introduction/change_log/3_7_0.md +++ b/3.x/zh_CN/docs/introduction/change_log/3_7_0.md @@ -18,8 +18,7 @@ 需要升级的链的“数据兼容版本号（[compatibility_version](#id5)）”为如下版本时： * 3.4.x、3.5.x，3.6.x、3.7.x：数据完全兼容当前版本，直接替换二进制即可完成升级 - * - 3.3.x、3.2.x、3.1.x、3.0.x：支持通过替换二进制进行灰度升级，若需使用当前版本的新特性，需升级数据兼容版本号，操作见[文档](#id5) + * 3.3.x、3.2.x、3.1.x、3.0.x：支持通过替换二进制进行灰度升级，若需使用当前版本的新特性，需升级数据兼容版本号，操作见[文档](#id5) * 3.0-rc x：数据不兼容，无法升级，可考虑逐步将业务迁移至3.x正式版 * 2.x：数据不兼容，2.x版本仍持续维护，可考虑升级为2.x的最新版本 @@ -34,27 +33,27 @@ * feature操作不可逆，打开后不可关闭 * 需确认所有可执行程序版本相同后，再进行feature开启操作 -| | Feature 名 | 默认状态 | 说明 | -|-----------|----------------------------|------|--------------------------------------------| -| 资产管理 | feature_balance | 关：0 | 默认关闭 | -| 资产操作预编译合约 | feature_balance_precompile | 关：0 | 默认关闭 | -| 计费模式 | feature_policy1 | 关：0 | 默认关闭 | -| 块内分片 | feature_sharding | 关：0 | 默认关闭，仅在从3.3、3.4升级至当前版本时，feature_sharding打开 | -| 同态加密 | feature_paillier | 关：0 | 默认关闭 | -| rpbft共识 | feature_rpbft | 关：0 | 默认关闭 | -| bug修复 | bugfix_\ | 开：1 | 从低版本升级默认关闭 | +| | Feature 名 | 默认状态 | 说明 | +|--------------------|----------------------------|----------|----------------------------------------------------------------| +| 资产管理 | feature_balance | 关：0 | 默认关闭 | +| 资产操作预编译合约 | feature_balance_precompile | 关：0 | 默认关闭 | +| 计费模式 | feature_policy1 | 关：0 | 默认关闭 | +| 块内分片 | feature_sharding | 关：0 | 默认关闭，仅在从3.3、3.4升级至当前版本时，feature_sharding打开 | +| 同态加密 | feature_paillier | 关：0 | 默认关闭 | +| rpbft共识 | feature_rpbft | 关：0 | 默认关闭 | +| bug修复 | bugfix_\ | 开：1 | 从低版本升级默认关闭 | **组件兼容性** -| | 推荐版本 | 最低版本 | 说明 | -|------------|-------------|---------------------|-------------------| -| WeBASE | 3.0.2 | 3.0.2 | | -| WeIdentity | v3.0.0-rc.1 | v3.0.0-rc.1 | | -| Console | 3.7.0 | 3.0.0 | | -| Java SDK | 3.7.0 | 3.0.0 | | -| CPP SDK | 3.7.0 | 3.0.0 | | +| | 推荐版本 | 最低版本 | 说明 | +|------------|-------------|--------------------------|------------------------------------| +| WeBASE | 3.0.2 | 3.0.2 | | +| WeIdentity | v3.0.0-rc.1 | v3.0.0-rc.1 | | +| Console | 3.7.0 | 3.0.0 | | +| Java SDK | 3.7.0 | 3.0.0 | | +| CPP SDK | 3.7.0 | 3.0.0 | | | Solidity | 0.8.11 | 最低 0.4.25，最高 0.8.11 | 需根据合约版本下载编译器（控制台） | -| WBC-Liquid | 1.0.0-rc3 | 1.0.0-rc3 | | +| WBC-Liquid | 1.0.0-rc3 | 1.0.0-rc3 | | #### 升级方法 diff --git a/3.x/zh_CN/docs/introduction/change_log/3_9_0.md b/3.x/zh_CN/docs/introduction/change_log/3_9_0.md new file mode 100644 index 000000000..ef494a316 --- /dev/null +++ b/3.x/zh_CN/docs/introduction/change_log/3_9_0.md @@ -0,0 +1,103 @@ +# v3.9.0 + +## 新增 + +- 实现[Web3 Json RPC接口](https://ethereum.org/en/developers/docs/apis/json-rpc)，用户可以使用Hardhat、OpenZeppelin 等现有Web3开发工具在FISCO BCOS上进行调试。相关PR: [#4334](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4334), [#4337](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4337), [#4356](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4356)，[#4365](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4365) +- 支持RLP交易类型的解析以及执行。相关PR：[#4347](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4347)，[#4350](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4350)， +- 新增事件拉取接口，用户可以使用主动拉取的方式收取合约事件、区块变化等。相关PR：[#4403](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4403) ， [#4412](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4412)，[#4440](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4440) +- 新增系统配置项`web3_chain_id`，用于Web3工具识别链的ID，发送正确的交易。相关PR：[#4392](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4392) +- 新增配置项`[web3_rpc]`，用户可选择开启Web3 Json RPC服务，默认端口号为8545。 + +## 修复 + + +* 修复在Solidity合约中使用staticcall的opcode调用合约异常时返回错误的问题。相关PR：[#4443](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4443) +* 修复在Solidity合约中receive函数没有被正确处理的问题。相关PR：[#4443](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4443) +* 修复在Solidity合约中获取EOA的code时返回错误的问题。相关PR：[#4505](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4505) +* 修复在调用Solidity合约view函数时，合约内取区块高、时间戳错误的问题。相关PR：[#4505](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4505) + +## 兼容性说明 + +### 兼容版本 + +需要升级的链的“数据兼容版本号（[compatibility_version](#id5)）”为如下版本时： + +* 3.4.x、3.5.x，3.6.x、3.7.x、3.8.x：数据完全兼容当前版本，直接替换二进制即可完成升级 +* 3.3.x、3.2.x、3.1.x、3.0.x：支持通过替换二进制进行灰度升级，若需使用当前版本的新特性，需升级数据兼容版本号，操作见[文档](#id5) +* 3.0-rc x：数据不兼容，无法升级，可考虑逐步将业务迁移至3.x正式版 +* 2.x：数据不兼容，2.x版本仍持续维护，可考虑升级为2.x的最新版本 + +### 实验功能 + +效果：通过feature开关控制实验功能的开启 + +操作：升级节点可执行程序后，通过控制台命令`setSystemConfigByKey 1` 开启对应实验功能，具体操作见文档升级方法部分 + +注意事项： +* feature操作不可逆，打开后不可关闭 +* 需确认所有可执行程序版本相同后，再进行feature开启操作 + +| | Feature 名 | 默认状态 | 说明 | +|--------------------|----------------------------|----------|----------------------------------------------------------------| +| 资产管理 | feature_balance | 关：0 | 默认关闭 | +| 资产操作预编译合约 | feature_balance_precompile | 关：0 | 默认关闭 | +| 计费模式 | feature_policy1 | 关：0 | 默认关闭 | +| 块内分片 | feature_sharding | 关：0 | 默认关闭，仅在从3.3、3.4升级至当前版本时，feature_sharding打开 | +| 同态加密 | feature_paillier | 关：0 | 默认关闭 | +| rpbft共识 | feature_rpbft | 关：0 | 默认关闭 | +| bug修复 | bugfix_\ | 开：1 | 从低版本升级默认关闭 | + +**组件兼容性** + +| | 推荐版本 | 最低版本 | 说明 | +|------------|-------------|--------------------------|------------------------------------| +| WeBASE | 3.0.2 | 3.0.2 | | +| WeIdentity | v3.0.0-rc.1 | v3.0.0-rc.1 | | +| Console | 3.7.0 | 3.0.0 | | +| Java SDK | 3.7.0 | 3.0.0 | | +| CPP SDK | 3.7.0 | 3.0.0 | | +| Solidity | 0.8.11 | 最低 0.4.25，最高 0.8.11 | 需根据合约版本下载编译器（控制台） | +| WBC-Liquid | 1.0.0-rc3 | 1.0.0-rc3 | | + +#### 升级方法 + +该操作仅支持将3.x版本升级为本版本，不支持3.0-rc或2.x的升级。 + +##### 查询数据兼容版本号（compatibility_version） + +用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#getsystemconfigbykey) +进行查询，如当前返回的版本为3.8.0 + +``` +[group0]: /apps> getSystemConfigByKey compatibility_version +3.8.0 +``` + +##### 替换节点二进制 + +需将**所有节点** +的二进制逐步替换为当前版本。为了不影响业务，替换过程能够以灰度方式进行，逐个替换并重启节点。替换过程中，当前的链仍然会以旧的数据兼容版本号的逻辑继续执行。当所有节点二进制替换完成并重启后，需用控制台修改数据兼容版本号为当前版本。 + +##### 设置数据兼容版本号（compatibility_version） + +用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#setsystemconfigbykey) +设置数据兼容版本号，如当前版本为3.7.0。 + +``` +[group0]: /apps> setSystemConfigByKey compatibility_version 3.9.0 +{ + "code":0, + "msg":"success" +} + +注：若开启权限治理功能，需要使用 setSysConfigProposal 命令 +``` + +设置成功，再次查询，得到当前版本已升级为3.9.0 + +``` +[group0]: /apps> getSystemConfigByKey compatibility_version +3.9.0 +``` + +当前链已经完成升级，至此，**链开始以新的逻辑继续运行**，并支持了新的特性。 diff --git a/3.x/zh_CN/docs/introduction/change_log/feature_bugfix_list.md b/3.x/zh_CN/docs/introduction/change_log/feature_bugfix_list.md index de821fe7d..e70296635 100644 --- a/3.x/zh_CN/docs/introduction/change_log/feature_bugfix_list.md +++ b/3.x/zh_CN/docs/introduction/change_log/feature_bugfix_list.md @@ -4,34 +4,38 @@ ## 1. feature功能开关 -| | Feature 名 | 默认状态 | 说明 | -|-----------|----------------------------|------|--------------------------------------------| -| 资产管理 | feature_balance | 关：0 | 默认关闭 | -| 资产操作预编译合约 | feature_balance_precompile | 关：0 | 默认关闭 | -| 计费模式 | feature_policy1 | 关：0 | 默认关闭 | -| 块内分片 | feature_sharding | 关：0 | 默认关闭，仅在从3.3、3.4升级至当前版本时，feature_sharding打开 | -| 同态加密 | feature_paillier | 关：0 | 默认关闭 | -| rpbft共识 | feature_rpbft | 关：0 | 默认关闭 | -| dmc切换至串行 | feature_dmc2serial | 关：0 | 默认关闭 | +| | Feature 名 | 默认状态 | 说明 | +|--------------|----------------------------|------|--------------------------------------------| +| 资产管理 | feature_balance | 关：0 | 默认关闭 | +| 资产操作预编译合约 | feature_balance_precompile | 关：0 | 默认关闭 | +| 计费模式 | feature_policy1 | 关：0 | 默认关闭 | +| 块内分片 | feature_sharding | 关：0 | 默认关闭，仅在从3.3、3.4升级至当前版本时，feature_sharding打开 | +| 同态加密 | feature_paillier | 关：0 | 默认关闭 | +| rpbft共识 | feature_rpbft | 关：0 | 默认关闭 | +| dmc切换至串行 | feature_dmc2serial | 关：0 | 默认关闭 | +| EVM升级至CANCUN | feature_evm_cancun | 关：0 | 默认关闭 | ## 2. bugfix列表 -| | bugfix 名 | 默认状态 | 说明 | -|----------------------------|-----------------------------------------------------|------|------------------------| -| 修复串行模式下回滚时不回滚子合约的bug | bugfix_revert | 开启：1 | 3.2.3、3.5.0 默认开启 | -| 修复stateStorage_hash计算错误的问题 | bugfix_statestorage_hash | 开启：1 | 3.2.4、3.5.0、3.6.0 默认开启 | -| 适配以太坊的调用行为 | bugfix_evm_create2_delegatecall_staticcall_codecopy | 开启：1 | 3.2.4、3.6.0 默认开启 | -| 修复抛出事件的顺序问题 | bugfix_event_log_order | 开启：1 | 3.2.7、 3.6.0 默认开启 | -| 修复call没有地址返回的问题 | bugfix_call_noaddr_return | 开启：1 | 3.2.7、3.6.0 默认开启 | -| 修复预编译合约算哈希与以太坊不同的问题 | bugfix_precompiled_codehash | 开启：1 | 3.2.7、3.6.0 默认开启 | -| 修复dmc模式下回滚时不回滚子合约的bug | bugfix_dmc_revert | 开启：1 | 3.2.7、3.6.0 默认开启 | -| 修复keyPage哈希不一致的兼容问 | bugfix_keypage_system_entry_hash | 开启：1 | 3.6.1 默认开启 | -| InternalCreate复用现有部署合约逻辑 | bugfix_internal_create_redundant_storage | 开启：1 | 3.6.1 默认开启 | -| 修复开启合约部署权限后资产转移受限问题 | bugfix_internal_create_permission_denied | 开启：1 | 3.7.0 默认开启 | -| 修复块内分片合约调用合约的问题 | bugfix_sharding_call_in_child_executive | 开启：1 | 3.7.0 默认开启 | -| 修复已部署空abi，部署相同的合约无abi的问题 | bugfix_empty_abi_reset | 开启：1 | 3.7.0 默认开启 | -| 修复无法通过eip55类型的合约地址调用合约的问题 | bugfix_eip55_addr | 开启：1 | 3.7.0 默认开启 | -| 解决对EOA账户getCode的返回值问题 | bugfix_eoa_as_contract | 开启：1 | 3.8.0默认开启 | -| 解决DMC模式下部署合约时gas消耗与串行模式不同的问题 | bugfix_dmc_deploy_gas_used | 开启：1 | 3.8.0默认开启 | -| 解决EVM执行status_code非0和revert时未扣除gas的问题 | bugfix_evm_exception_gas_used | 开启：1 | 3.8.0默认开启 | -| 解决StateStorage和KeyPageStorage的setRow接口写入未修改Entry时不计算DBHash的问题 | bugfix_set_row_with_dirty_flag | 开启：1 | 3.8.0默认开启 | \ No newline at end of file +| | bugfix 名 | 默认状态 | 说明 | +|---------------------------------------------------------------------------------|-----------------------------------------------------|----------|------------------------------| +| 修复串行模式下回滚时不回滚子合约的bug | bugfix_revert | 开启：1 | 3.2.3、3.5.0 默认开启 | +| 修复stateStorage_hash计算错误的问题 | bugfix_statestorage_hash | 开启：1 | 3.2.4、3.5.0、3.6.0 默认开启 | +| 适配以太坊的调用行为 | bugfix_evm_create2_delegatecall_staticcall_codecopy | 开启：1 | 3.2.4、3.6.0 默认开启 | +| 修复抛出事件的顺序问题 | bugfix_event_log_order | 开启：1 | 3.2.7、 3.6.0 默认开启 | +| 修复call没有地址返回的问题 | bugfix_call_noaddr_return | 开启：1 | 3.2.7、3.6.0 默认开启 | +| 修复预编译合约算哈希与以太坊不同的问题 | bugfix_precompiled_codehash | 开启：1 | 3.2.7、3.6.0 默认开启 | +| 修复dmc模式下回滚时不回滚子合约的bug | bugfix_dmc_revert | 开启：1 | 3.2.7、3.6.0 默认开启 | +| 修复keyPage哈希不一致的兼容问 | bugfix_keypage_system_entry_hash | 开启：1 | 3.6.1 默认开启 | +| InternalCreate复用现有部署合约逻辑 | bugfix_internal_create_redundant_storage | 开启：1 | 3.6.1 默认开启 | +| 修复开启合约部署权限后资产转移受限问题 | bugfix_internal_create_permission_denied | 开启：1 | 3.7.0 默认开启 | +| 修复块内分片合约调用合约的问题 | bugfix_sharding_call_in_child_executive | 开启：1 | 3.7.0 默认开启 | +| 修复已部署空abi，部署相同的合约无abi的问题 | bugfix_empty_abi_reset | 开启：1 | 3.7.0 默认开启 | +| 修复无法通过eip55类型的合约地址调用合约的问题 | bugfix_eip55_addr | 开启：1 | 3.7.0 默认开启 | +| 解决对EOA账户getCode的返回值问题 | bugfix_eoa_as_contract | 开启：1 | 3.8.0默认开启 | +| 解决DMC模式下部署合约时gas消耗与串行模式不同的问题 | bugfix_dmc_deploy_gas_used | 开启：1 | 3.8.0默认开启 | +| 解决EVM执行status_code非0和revert时未扣除gas的问题 | bugfix_evm_exception_gas_used | 开启：1 | 3.8.0默认开启 | +| 解决StateStorage和KeyPageStorage的setRow接口写入未修改Entry时不计算DBHash的问题 | bugfix_set_row_with_dirty_flag | 开启：1 | 3.8.0默认开启 | +| 修复Solidity合约使用staticcall的opcode时当出现错误时没有正确返回的问题 | bugfix_staticcall_noaddr_return | 开启：1 | 3.9.0默认开启 | +| 修复在Solidity合约中receive函数没有正确处理的问题 | bugfix_support_transfer_receive_fallback | 开启：1 | 3.9.0默认开启 | +| 修复在合约中获取EOA code时可能出现错误结果的问题 | bugfix_eoa_match_failed | 开启：1 | 3.9.0默认开启 | diff --git a/3.x/zh_CN/docs/introduction/change_log/index.rst b/3.x/zh_CN/docs/introduction/change_log/index.rst index 123ed98ce..f6815ea88 100644 --- a/3.x/zh_CN/docs/introduction/change_log/index.rst +++ b/3.x/zh_CN/docs/introduction/change_log/index.rst @@ -21,6 +21,47 @@ FISCO BCOS 设计 Feature控制特性功能开启关闭，用户可以根据自 :maxdepth: 0 upgrade.md +v3.10.x +------------------ + +.. admonition:: FISCO BCOS 3.x Releases + + - `FISCO BCOS v3.10.0 <./3_10_0.html>`_ [`release `_] + +.. admonition:: 查看节点和数据版本 + + - 查看Air版本FISCO BCOS节点二进制版本：``./fisco-bcos --version`` + - 查看Pro版本FISCO BCOS节点二进制版本：``./BcosNodeService --version``, ``./BcosRpcService --version``, ``./BcosGatewayService --version`` + - 查看Max版本FISCO BCOS节点二进制版本：``./BcosMaxNodeService --version``, ``./BcosRpcService --version``, ``./BcosGatewayService --version``, ``./BcosExecutorService --version`` + - 查看轻节点二进制版本：``../fisco-bcos-lightnode --version`` + - 查看轻节点相关文档，请参考 [`轻节点搭建工具 `_] + +.. toctree:: + :hidden: + :maxdepth: 0 + + 3_10_0.md + +v3.9.x +------------------ + +.. admonition:: FISCO BCOS 3.x Releases + + - `FISCO BCOS v3.9.0 <./3_9_0.html>`_ [`release `_] + +.. admonition:: 查看节点和数据版本 + + - 查看Air版本FISCO BCOS节点二进制版本：``./fisco-bcos --version`` + - 查看Pro版本FISCO BCOS节点二进制版本：``./BcosNodeService --version``, ``./BcosRpcService --version``, ``./BcosGatewayService --version`` + - 查看Max版本FISCO BCOS节点二进制版本：``./BcosMaxNodeService --version``, ``./BcosRpcService --version``, ``./BcosGatewayService --version``, ``./BcosExecutorService --version`` + - 查看轻节点二进制版本：``../fisco-bcos-lightnode --version`` + - 查看轻节点相关文档，请参考 [`轻节点搭建工具 `_] + +.. toctree:: + :hidden: + :maxdepth: 0 + + 3_9_0.md v3.8.x ------------------ diff --git a/3.x/zh_CN/docs/quick_start/air_installation.md b/3.x/zh_CN/docs/quick_start/air_installation.md index 59639cb48..90ca2336c 100644 --- a/3.x/zh_CN/docs/quick_start/air_installation.md +++ b/3.x/zh_CN/docs/quick_start/air_installation.md @@ -49,7 +49,7 @@ sudo yum install -y curl openssl openssl-devel wget ```eval_rst .. note:: - 如果因为网络问题导致长时间无法下载build_chain.sh脚本，请尝试 curl -#LO https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/FISCO-BCOS/releases/v3.6.0/build_chain.sh && chmod u+x build_chain.sh + 如果因为网络问题导致长时间无法下载build_chain.sh脚本，请尝试 curl -#LO https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/FISCO-BCOS/releases/v3.10.0/build_chain.sh && chmod u+x build_chain.sh ``` ```shell @@ -57,10 +57,10 @@ sudo yum install -y curl openssl openssl-devel wget cd ~ && mkdir -p fisco && cd fisco # 下载建链脚本 -curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.6.0/build_chain.sh && chmod u+x build_chain.sh +curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.10.0/build_chain.sh && chmod u+x build_chain.sh # Note: 若访问git网速太慢，可尝试如下命令下载建链脚本: -curl -#LO https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/FISCO-BCOS/releases/v3.6.0/build_chain.sh && chmod u+x build_chain.sh +curl -#LO https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/FISCO-BCOS/releases/v3.10.0/build_chain.sh && chmod u+x build_chain.sh ``` ### 第三步. 搭建4节点非国密联盟链 @@ -192,7 +192,7 @@ sudo yum install -y java java-devel ### 第二步. 下载控制台 ```shell -cd ~/fisco && curl -LO https://github.com/FISCO-BCOS/console/releases/download/v3.6.0/download_console.sh && bash download_console.sh +cd ~/fisco && curl -LO https://github.com/FISCO-BCOS/console/releases/download/v3.7.0/download_console.sh && bash download_console.sh ``` ```eval_rst diff --git a/3.x/zh_CN/docs/quick_start/solidity_application.md b/3.x/zh_CN/docs/quick_start/solidity_application.md index 00e74deab..e6f7faccc 100644 --- a/3.x/zh_CN/docs/quick_start/solidity_application.md +++ b/3.x/zh_CN/docs/quick_start/solidity_application.md @@ -65,7 +65,7 @@ function transfer(string memory from_account, string memory to_account, uint256 mkdir -p ~/fisco # 下载控制台 -cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v3.6.0/download_console.sh && bash download_console.sh +cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v3.10.0/download_console.sh && bash download_console.sh # 切换到fisco/console/目录 cd ~/fisco/console/ diff --git a/3.x/zh_CN/docs/quick_start/wbc_liquid_application.md b/3.x/zh_CN/docs/quick_start/wbc_liquid_application.md index 2cf9b5c51..1eb84b35b 100644 --- a/3.x/zh_CN/docs/quick_start/wbc_liquid_application.md +++ b/3.x/zh_CN/docs/quick_start/wbc_liquid_application.md @@ -86,7 +86,7 @@ pub fn transfer(&mut self, from: String, to: String, value: u128) -> i16 mkdir -p ~/fisco # 下载控制台 -cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v3.6.0/download_console.sh && bash download_console.sh +cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v3.10.0/download_console.sh && bash download_console.sh # 切换到fisco/console/目录 cd ~/fisco/console/ diff --git a/3.x/zh_CN/docs/sdk/java_sdk/assemble_service.md b/3.x/zh_CN/docs/sdk/java_sdk/assemble_service.md index 8b46c9279..5d260c2c0 100644 --- a/3.x/zh_CN/docs/sdk/java_sdk/assemble_service.md +++ b/3.x/zh_CN/docs/sdk/java_sdk/assemble_service.md @@ -183,7 +183,7 @@ TransactionResponse transactionResponse = transactionService.sendTransaction(req ## 3. Solidity生成Java文件使用新接口 -生成智能合约的Java接口文件详细文档可见：[链接](./contracts_to_java.html) +生成智能合约的Java接口文件详细文档可见：[链接](./contracts_to_java.md) 在3.6.0以后版本的控制台中，contract2java.sh脚本新增 `-t` 选项，当值为1就生成使用新接口的Java文件，使用姿势与之前无异。例如： @@ -205,3 +205,8 @@ Ok ok = Ok.deploy(client, client.getCryptoSuite().getCryptoKeyPair()); // 设置TransactionManager ok.setTransactionManager(new DefaultTransactionManager(client)); ``` + +### 3.1 通过修改TransactionManager的Provider更改交易字段 + +### 3.2 使用V2版本交易的接口 + diff --git a/3.x/zh_CN/docs/sdk/java_sdk/contracts_to_java.md b/3.x/zh_CN/docs/sdk/java_sdk/contracts_to_java.md index f699e1e3a..40f61f9de 100644 --- a/3.x/zh_CN/docs/sdk/java_sdk/contracts_to_java.md +++ b/3.x/zh_CN/docs/sdk/java_sdk/contracts_to_java.md @@ -199,7 +199,11 @@ usage: contract2java.sh [OPTIONS...] - `output`: (可选)生成`Java`文件的目录，默认生成在`contracts/sdk/java`目录。 - `no-analysis`：（可选）跳过solidity编译的静态分析，可以有效缩减编译速度。静态分析可以分析合约的接口并行可行性，并将分析结果放到abi文件中。 - `enable-async-call` ：（可选）可生成具有异步call接口的Java文件，异步接口只有在Java-sdk版本>=3.3.0时使用。 -- `transaction-version`：（可选）指定生成Java文件发交易的版本号，默认是0，可以兼容所有版本的节点；当使用交易版本为1时，可以支持交易带有value、gasLimit、gasPrice、EIP1559等字段，只能发给3.6.0及以上的节点中。 +- `transaction-version`：（可选）指定生成Java文件发交易的版本号，默认是0； + - 当使用交易版本为0时，或者不使用该选项，可以兼容所有版本的节点。 + - 当使用交易版本为1时，可以支持交易带有value、gasLimit、gasPrice、EIP1559等字段，只能发给3.6.0及以上的节点中； + - 当使用交易版本为2时，可以支持交易带有extension字段，只能发给3.7.0及以上的节点中。 + ### 6.2 WBC-Liquid合约使用 diff --git a/3.x/zh_CN/docs/tutorial/air/build_chain.md b/3.x/zh_CN/docs/tutorial/air/build_chain.md index 24e53333d..9fd559169 100644 --- a/3.x/zh_CN/docs/tutorial/air/build_chain.md +++ b/3.x/zh_CN/docs/tutorial/air/build_chain.md @@ -27,7 +27,7 @@ FISCO BCOS提供了`build_chain.sh`脚本帮助用户快速搭建FISCO BCOS联 ```shell # 下载建链脚本 -curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.6.0/build_chain.sh && chmod u+x build_chain.sh +curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.10.0/build_chain.sh && chmod u+x build_chain.sh # Note: 若访问git网速太慢，可尝试如下命令下载建链脚本: curl -#LO https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/FISCO-BCOS/releases/v3.6.0/build_chain.sh && chmod u+x build_chain.sh @@ -35,10 +35,11 @@ curl -#LO https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/FISCO- # 键入bash build_chain.sh -h展示脚本用法及参数 $ bash build_chain.sh Usage: +air -C [Optional] the command, support 'deploy' and 'expand' now, default is deploy -g [Optional] set the group id, default: group0 -I [Optional] set the chain id, default: chain0 - -v [Optional] Default is the latest v3.6.0 + -v [Optional] Default is the latest v3.10.0 -l [Required] "ip1:nodeNum1,ip2:nodeNum2" e.g:"192.168.0.1:2,192.168.0.2:3" -L [Optional] fisco bcos lightnode executable, input "download_binary" to download lightnode binary or assign correct lightnode binary path -e [Optional] fisco-bcos binary exec @@ -49,28 +50,73 @@ Usage: -H [Optional] Whether to use HSM(Hardware secure module), default is false -c [Required when expand node] Specify the path of the expanded node config.ini, config.genesis and p2p connection file nodes.json -d [Required when expand node] When expanding the node, specify the path where the CA certificate and private key are located - -D Default off. If set -d, build with docker + -D Default off. If set -D, build with docker + -E Default off. If set -E, enable debug log -a [Optional] when Auth mode Specify the admin account address. -w [Optional] Whether to use the wasm virtual machine engine, default is false -R [Optional] Whether to use serial execute,default is true - -k [Optional] key page size, default size is 10240 + -k [Optional] key page size, default is 10240 -m [Optional] node monitor or not, default is false -i [Optional] When expanding the node, should specify ip and port -M [Optional] When expanding the node, specify the path where prometheus are located -z [Optional] Pack the data on the chain to generate tar packet -n [Optional] set the path of the node key file to load nodeid + -N [Optional] set the path of the node modified to multi ca mode + -u [Optional] set the path of another ca for multi ca mode + -6 [Optional] IPv6 mode use :: as default listen ip, default is false + -T [Optional] Default PBFT. Options can be pbft / rpbft, pbft is recommended + -h Help +pro or max + -C [Optional] the command, support 'deploy' now, default is deploy + -g [Optional] set the group id, default: group0 + -I [Optional] set the chain id, default: chain0 + -V [Optional] support 'air'、'pro'、'max', default is 'air' + -l [Required] "ip1:nodeNum1,ip2:nodeNum2" e.g:"192.168.0.1:2,192.168.0.2:3" + -p [Optional] Default 30300、20200、40400、2379 means p2p_port start from 30300, rpc_port from 20200, tars_port from 40400, tikv_port default 2379 + -e [Optional] rpc gateway node service binary path + -y [Optional] rpc gateway node service binary download type, default type is cdn + -v [Optional] Default is the latest v3.10.0 + -r [Optional] service binary download path, default is binary + -c [Optional] Specify the path of the deploy node config.toml + -t [Optional] support 'rpc'、'gateway'、'node'、'all', default is 'all' + -o [Optional] output directory, default genearted + -s [Optional] SM SSL connection or not, default is false -h Help deploy nodes e.g bash build_chain.sh -p 30300,20200 -l 127.0.0.1:4 -o nodes -e ./fisco-bcos - bash build_chain.sh -p 30300,20200 -l 127.0.0.1:4 -o nodes -e ./fisco-bcos -m (部署节点带监控功能) + bash build_chain.sh -p 30300,20200 -l 127.0.0.1:4 -o nodes -e ./fisco-bcos -m bash build_chain.sh -p 30300,20200 -l 127.0.0.1:4 -o nodes -e ./fisco-bcos -s expand node e.g bash build_chain.sh -C expand -c config -d config/ca -o nodes/127.0.0.1/node5 -e ./fisco-bcos - bash build_chain.sh -C expand -c config -d config/ca -o nodes/127.0.0.1/node5 -e ./fisco-bcos -m -i 127.0.0.1:5 -M monitor/prometheus/prometheus.yml (部署节点带监控功能) + bash build_chain.sh -C expand -c config -d config/ca -o nodes/127.0.0.1/node5 -e ./fisco-bcos -m -i 127.0.0.1:5 -M monitor/prometheus/prometheus.yml bash build_chain.sh -C expand -c config -d config/ca -o nodes/127.0.0.1/node5 -e ./fisco-bcos -s bash build_chain.sh -C expand_lightnode -c config -d config/ca -o nodes/lightnode1 bash build_chain.sh -C expand_lightnode -c config -d config/ca -o nodes/lightnode1 -L ./fisco-bcos-lightnode +modify node e.g + bash build_chain.sh -C modify -N ./node0 -u ./ca/ca.crt + bash build_chain.sh -C modify -N ./node0 -u ./ca/ca.crt -s +deploy pro service e.g + bash build_chain.sh -p 30300,20200 -l 172.31.184.227:2,172.30.93.111:2 -C deploy -V pro -o generate -t all + bash build_chain.sh -p 30300,20200 -l 172.31.184.227:2,172.30.93.111:2 -C deploy -V pro -o generate -t all -s + bash build_chain.sh -p 30300,20200 -l 172.31.184.227:2,172.30.93.111:2 -C deploy -V pro -o generate -e ./binary + bash build_chain.sh -p 30300,20200,40400 -l 172.31.184.227:2,172.30.93.111:2 -C deploy -V pro -o generate -y cdn -v v3.10.0 -r ./binaryPath +deploy max service e.g + bash build_chain.sh -p 30300,20200,40400,2379 -l 172.31.184.227:1,172.30.93.111:1,172.31.184.54:1,172.31.185.59:1 -C deploy -V max -o generate -t all + bash build_chain.sh -p 30300,20200,40400,2379 -l 172.31.184.227:1,172.30.93.111:1,172.31.184.54:1,172.31.185.59:1 -C deploy -V max -o generate -t all -e ./binary -s + bash build_chain.sh -p 30300,20200,40400,2379 -l 172.31.184.227:1,172.30.93.111:1,172.31.184.54:1,172.31.185.59:1 -C deploy -V max -o generate -y cdn -v v3.10.0 -r ./binaryPath + bash build_chain.sh -c config.toml -C deploy -V max -o generate -t all +expand pro node e.g + bash build_chain.sh -C expand_node -V pro -o expand_node -c ./config.toml +expand pro rpc/gateway e.g + bash build_chain.sh -C expand_service -V pro -o expand_service -c ./config.toml +expand pro group e.g + bash build_chain.sh -C expand_group -V pro -o expand_group -c ./config.toml +expand max node e.g + bash build_chain.sh -C expand_node -V max -o expand_node -c ./config.toml +expand max rpc/gateway e.g + bash build_chain.sh -C expand_service -V max -o expand_service -c ./config.toml + ``` @@ -247,15 +293,21 @@ Processing IP:127.0.0.1 Total:4 查看脚本使用用法。 +### **`E`选项[**Optional**]** + +可选参数，当需要开启debug日志时，可通过`-E`选项设置开启debug日志。 + ## 2. 节点配置文件组织结构 `build_chain`生成的节点配置主要如下： - **根证书和根证书私钥**: 位于指定的配置生成目录的`ca`文件夹。 -- **节点连接证书**: 每个节点`conf`目录下均存放节点的网络连接证书，非国密节点证书和私钥主要包括`ca.crt, ssl.crt, sslkey`，国密节点证书和私钥主要包括`sm_ca.crt, sm_ssl.crt, sm_enssl.crt, sm_enssl.key, sm_ssl.key`。 +- **节点连接证书**: 每个节点`conf`目录下均存放节点的网络连接证书，非国密节点证书和私钥主要包括`ca.crt, ssl.crt, sslkey` + ，国密节点证书和私钥主要包括`sm_ca.crt, sm_ssl.crt, sm_enssl.crt, sm_enssl.key, sm_ssl.key`。 - **节点签名私钥**: 节点`conf`目录下的`node.pem`，主要位于共识模块的签名。 - **SDK连接证书**: 由`build_chain.sh`生成，客户端可拷贝该证书与节点建立SSL连接。 -- **节点配置文件**: 节点目录下的`config.ini`和`config.genesis`配置，前者主要配置链信息，后者主要配置创世块信息，具体可参考[Air版本区块链节点配置介绍](./config.md)。 +- **节点配置文件**: 节点目录下的`config.ini`和`config.genesis` + 配置，前者主要配置链信息，后者主要配置创世块信息，具体可参考[Air版本区块链节点配置介绍](./config.md)。 - **启停脚本**: `start.sh`和`stop.sh`，用于启动和停止节点。 - **启停监控脚本**: `monitor/start_monitor.sh`和`monitor/stop_monitor.sh`，用于启动和停止节点监控。 diff --git a/3.x/zh_CN/docs/tutorial/air/multihost.md b/3.x/zh_CN/docs/tutorial/air/multihost.md index b5193d539..80e020c48 100644 --- a/3.x/zh_CN/docs/tutorial/air/multihost.md +++ b/3.x/zh_CN/docs/tutorial/air/multihost.md @@ -31,7 +31,7 @@ mkdir -p ~/fisco && cd ~/fisco ./download_bin.sh -v 3.4.0 # 下载开发部署工具build_chain -curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.6.0/build_chain.sh && chmod u+x build_chain.sh +curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.10.0/build_chain.sh && chmod u+x build_chain.sh ``` **生成多机节点配置** @@ -214,7 +214,7 @@ sudo yum install -y java java-devel # 创建操作目录 mkdir -p ~/fisco && cd ~/fisco -curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v3.6.0/download_console.sh && bash download_console.sh +curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v3.10.0/download_console.sh && bash download_console.sh # 若因为网络问题导致长时间无法下载，请尝试以下命令： curl -#LO https://gitee.com/FISCO-BCOS/console/raw/master/tools/download_console.sh && bash download_console.sh diff --git a/3.x/zh_CN/docs/tutorial/air/storage_security.md b/3.x/zh_CN/docs/tutorial/air/storage_security.md index 24c3bc752..43cf7089f 100644 --- a/3.x/zh_CN/docs/tutorial/air/storage_security.md +++ b/3.x/zh_CN/docs/tutorial/air/storage_security.md @@ -25,7 +25,7 @@ 下载`build_chain.sh`脚本 ``` shell -curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.6.0/build_chain.sh && chmod u+x build_chain.sh +curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.10.0/build_chain.sh && chmod u+x build_chain.sh ``` ```eval_rst diff --git a/3.x/zh_CN/docs/tutorial/air/use_hsm.md b/3.x/zh_CN/docs/tutorial/air/use_hsm.md index f74ccfd2a..edea2ac68 100644 --- a/3.x/zh_CN/docs/tutorial/air/use_hsm.md +++ b/3.x/zh_CN/docs/tutorial/air/use_hsm.md @@ -45,7 +45,7 @@ cmake .. || cat *.log ```bash cd ~/fisco -curl -LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.6.0/build_chain.sh && chmod u+x build_chain.sh +curl -LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.10.0/build_chain.sh && chmod u+x build_chain.sh ``` 在build_chain同级目录下，创建文件夹（例如nodeKeyDir），用于存放密码机密钥的node.pem文件(证书数目和搭建节点数一致)。 ```bash diff --git a/3.x/zh_CN/docs/tutorial/max/installation.md b/3.x/zh_CN/docs/tutorial/max/installation.md index 9d345a986..913598eac 100644 --- a/3.x/zh_CN/docs/tutorial/max/installation.md +++ b/3.x/zh_CN/docs/tutorial/max/installation.md @@ -53,7 +53,7 @@ brew install curl docker docker-compose python3 wget mkdir -p ~/fisco && cd ~/fisco # 下载区块链构建工具BcosBuilder -curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.6.0/BcosBuilder.tgz && tar -xvf BcosBuilder.tgz +curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.10.0/BcosBuilder.tgz && tar -xvf BcosBuilder.tgz # Note: 若网速太慢，可尝试如下命令下载部署脚本: curl -#LO https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/FISCO-BCOS/releases/v3.6.0/BcosBuilder.tgz && tar -xvf BcosBuilder.tgz @@ -435,7 +435,7 @@ sudo yum install -y java java-devel **步骤1：下载控制台** ```shell -cd ~/fisco && curl -LO https://github.com/FISCO-BCOS/console/releases/download/v3.6.0/download_console.sh && bash download_console.sh +cd ~/fisco && curl -LO https://github.com/FISCO-BCOS/console/releases/download/v3.10.0/download_console.sh && bash download_console.sh ``` ```eval_rst .. note:: diff --git a/3.x/zh_CN/docs/tutorial/pro/installation.md b/3.x/zh_CN/docs/tutorial/pro/installation.md index c916747ff..83879ab7b 100644 --- a/3.x/zh_CN/docs/tutorial/pro/installation.md +++ b/3.x/zh_CN/docs/tutorial/pro/installation.md @@ -49,7 +49,7 @@ brew install curl docker docker-compose python3 wget mkdir -p ~/fisco && cd ~/fisco # 下载Pro版区块链构建工具BcosBuilder -curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.6.0/BcosBuilder.tgz && tar -xvf BcosBuilder.tgz +curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v3.10.0/BcosBuilder.tgz && tar -xvf BcosBuilder.tgz # Note: 若网速太慢，可尝试如下命令下载部署脚本: curl -#LO https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/FISCO-BCOS/FISCO-BCOS/releases/v3.6.0/BcosBuilder.tgz && tar -xvf BcosBuilder.tgz @@ -610,7 +610,7 @@ sudo yum install -y java java-devel **步骤1：下载控制台** ```shell -cd ~/fisco && curl -LO https://github.com/FISCO-BCOS/console/releases/download/v3.6.0/download_console.sh && bash download_console.sh +cd ~/fisco && curl -LO https://github.com/FISCO-BCOS/console/releases/download/v3.10.0/download_console.sh && bash download_console.sh ``` ```eval_rst .. note:: diff --git a/3.x/zh_CN/images/develop/hardhat_config.png b/3.x/zh_CN/images/develop/hardhat_config.png new file mode 100644 index 000000000..68c2df769 Binary files /dev/null and b/3.x/zh_CN/images/develop/hardhat_config.png differ diff --git a/3.x/zh_CN/images/develop/hardhat_structure.png b/3.x/zh_CN/images/develop/hardhat_structure.png new file mode 100644 index 000000000..81262d963 Binary files /dev/null and b/3.x/zh_CN/images/develop/hardhat_structure.png differ diff --git a/3.x/zh_CN/images/develop/hardhat_test.png b/3.x/zh_CN/images/develop/hardhat_test.png new file mode 100644 index 000000000..84be8c08d Binary files /dev/null and b/3.x/zh_CN/images/develop/hardhat_test.png differ diff --git a/3.x/zh_CN/images/develop/metamask_add_fb_info.png b/3.x/zh_CN/images/develop/metamask_add_fb_info.png new file mode 100644 index 000000000..041e2e5c8 Binary files /dev/null and b/3.x/zh_CN/images/develop/metamask_add_fb_info.png differ diff --git a/3.x/zh_CN/images/develop/metamask_add_network.png b/3.x/zh_CN/images/develop/metamask_add_network.png new file mode 100644 index 000000000..5fd910068 Binary files /dev/null and b/3.x/zh_CN/images/develop/metamask_add_network.png differ diff --git a/3.x/zh_CN/images/develop/metamask_balance.png b/3.x/zh_CN/images/develop/metamask_balance.png new file mode 100644 index 000000000..13717f509 Binary files /dev/null and b/3.x/zh_CN/images/develop/metamask_balance.png differ diff --git a/3.x/zh_CN/images/develop/metamask_manual_add_network.png b/3.x/zh_CN/images/develop/metamask_manual_add_network.png new file mode 100644 index 000000000..0f9925f45 Binary files /dev/null and b/3.x/zh_CN/images/develop/metamask_manual_add_network.png differ diff --git a/3.x/zh_CN/images/develop/metamask_transfer.png b/3.x/zh_CN/images/develop/metamask_transfer.png new file mode 100644 index 000000000..648dd4526 Binary files /dev/null and b/3.x/zh_CN/images/develop/metamask_transfer.png differ diff --git a/3.x/zh_CN/images/develop/metamask_transfer_confirm.png b/3.x/zh_CN/images/develop/metamask_transfer_confirm.png new file mode 100644 index 000000000..2f7296e63 Binary files /dev/null and b/3.x/zh_CN/images/develop/metamask_transfer_confirm.png differ diff --git a/3.x/zh_CN/images/develop/metamask_transfer_tx.png b/3.x/zh_CN/images/develop/metamask_transfer_tx.png new file mode 100644 index 000000000..35f6b284e Binary files /dev/null and b/3.x/zh_CN/images/develop/metamask_transfer_tx.png differ diff --git a/3.x/zh_CN/images/develop/remix_metamask_in.png b/3.x/zh_CN/images/develop/remix_metamask_in.png new file mode 100644 index 000000000..0833c78c2 Binary files /dev/null and b/3.x/zh_CN/images/develop/remix_metamask_in.png differ diff --git a/3.x/zh_CN/images/develop/remix_metamask_tx.png b/3.x/zh_CN/images/develop/remix_metamask_tx.png new file mode 100644 index 000000000..d413f1d05 Binary files /dev/null and b/3.x/zh_CN/images/develop/remix_metamask_tx.png differ diff --git a/3.x/zh_CN/index.rst b/3.x/zh_CN/index.rst index 7c008ebb1..92c5cf28b 100644 --- a/3.x/zh_CN/index.rst +++ b/3.x/zh_CN/index.rst @@ -341,6 +341,7 @@ FISCO BCOS开源社区致力打造开放多元的开源联盟链生态，至今 docs/develop/account.md docs/develop/contract_life_cycle.md docs/develop/console_deploy_contract.md + docs/develop/web3_usage.md docs/develop/console/index.md docs/develop/smartdev_index.md docs/develop/amop.md