Merge branch 'release-2' into dev

FISCO-BCOS · Mar 31, 2021 · f04d168 · f04d168
2 parents e6ec678 + 91a9403
commit f04d168
Show file tree

Hide file tree

Showing 42 changed files with 2,860 additions and 1,613 deletions.
diff --git a/.ci/ci_check.sh b/.ci/ci_check.sh
@@ -32,10 +32,10 @@ function check_PR()
         echo "Modified files are all en."
     else
         LOG_ERROR "Modified files should include cn and en"
-        git diff --stat HEAD^ HEAD 
+        git diff --stat HEAD^ HEAD
         git show HEAD^ --stat --format=oneline
         git show HEAD --stat --format=oneline
-        exit 1
+        # exit 1
     fi
     local commits=$(git rev-list --count HEAD^..HEAD)
     local unique_commit=$(git log --format=%s HEAD^..HEAD | sort -u | wc -l)

diff --git a/docs/app_dev/index.rst b/docs/app_dev/index.rst
@@ -1,28 +1,29 @@
-##############################################################
-开发和使用智能合约
-##############################################################
-
-标签：``应用开发`` ``索引`` ``开发手册`` ``区块链应用``
-
-----
-
-.. admonition:: 合约开发
-
-    - `智能合约开发 <../manual/smart_contract.html>`_
-        + 普通智能合约开发、预编译合约开发合约开发
-    - `使用预编译合约 <../manual/precompiled_contract.html>`_
-        + 普通智能合约开发、预编译合约开发合约开发
-    - `开发并行合约 <../manual/transaction_parallel.html>`_
-        + 写并行合约，满足高并发场景
-    - `合约隐私保护 <../manual/privacy.html>`_
-        + 预编译合约支持同态加密、群/环签名验证
-
-
-.. toctree::
-   :hidden:
-
-
-   ../manual/smart_contract.md
-   ../manual/precompiled_contract.md
-   ../manual/transaction_parallel.md
-   ../manual/privacy.md
+##############################################################
+开发和使用智能合约
+##############################################################
+
+标签：``应用开发`` ``索引`` ``开发手册`` ``区块链应用``
+
+----
+
+.. admonition:: 合约开发
+
+    - `智能合约开发 <../manual/smart_contract.html>`_
+        + 普通智能合约开发、预编译合约开发合约开发
+    - `使用预编译合约 <../manual/precompiled_contract.html>`_
+        + 普通智能合约开发、预编译合约开发合约开发
+    - `开发并行合约 <../manual/transaction_parallel.html>`_
+        + 写并行合约，满足高并发场景
+    - `合约隐私保护 <../manual/privacy.html>`_
+        + 预编译合约支持同态加密、群/环签名验证
+
+
+.. toctree::
+   :hidden:
+
+
+   ../manual/smart_contract.md
+   ../manual/precompiled_contract.md
+   ../manual/transaction_parallel.md
+   ../manual/privacy.md
+   ../manual/bcos_node_proxy.md
diff --git a/docs/articles/7_practice/build_chain_with_wsl_on_windows.md b/docs/articles/7_practice/build_chain_with_wsl_on_windows.md
@@ -187,7 +187,7 @@ deb-src http://mirrors.aliyun.com/ubuntu/ focal-backports main restricted univer
 
 ```bash
 sudo apt update && sudo apt install -y default-jdk
-cd ~/fisco && curl -LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.1/download_console.sh && bash download_console.sh
+cd ~/fisco && curl -LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.2/download_console.sh && bash download_console.sh
 cp -n console/conf/config-example.toml console/conf/config.toml
 cp -r nodes/127.0.0.1/sdk/* console/conf/
 cd ~/fisco/console && bash start.sh

diff --git a/docs/articles/7_practice/kunpeng_platform_compiles_and_runs_fisco-bcos-2.6.0.md b/docs/articles/7_practice/kunpeng_platform_compiles_and_runs_fisco-bcos-2.6.0.md
@@ -267,7 +267,7 @@ info|2020-09-04 17:34:22.459794|[g:1][CONSENSUS][SEALER]++++++++++++++++ Generat
 
 ```bash
 # 下载控制台
-$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.1/download_console.sh && bash download_console.sh
+$ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.2/download_console.sh && bash download_console.sh
 $ cd console
 
 # 拷贝证书

diff --git a/docs/console/console.md b/docs/console/console.md
@@ -25,7 +25,7 @@
 ```bash
 cd ~ && mkdir -p fisco && cd fisco
 # 获取控制台
-curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.1/download_console.sh && bash download_console.sh -c 1.2.0
+curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.2/download_console.sh && bash download_console.sh -c 1.2.0
 ```
 
 ```eval_rst

diff --git a/docs/console/console_of_java_sdk.md b/docs/console/console_of_java_sdk.md
@@ -25,7 +25,7 @@
 ```bash
 cd ~ && mkdir -p fisco && cd fisco
 # 获取控制台
-curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.1/download_console.sh && bash download_console.sh
+curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.2/download_console.sh && bash download_console.sh
 ```
 
 ```eval_rst
@@ -58,9 +58,9 @@ curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.1/downloa
 **注意：默认下载的控制台内置`0.4.25`版本的`solidity`编译器，用户需要编译`0.5`或者`0.6`版本的合约时，可以通过下列命令获取内置对应编译器版本的控制台**	
 ```bash	
 # 0.5	
-curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.1/download_console.sh && bash download_console.sh -v 0.5	
+curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.2/download_console.sh && bash download_console.sh -v 0.5	
 # 0.6	
-curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.1/download_console.sh && bash download_console.sh -v 0.6	
+curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.2/download_console.sh && bash download_console.sh -v 0.6	
 ```
 
 ```eval_rst

diff --git a/docs/console/download_console.md b/docs/console/download_console.md
@@ -6,7 +6,7 @@
 `download_console.sh`脚本提供获取所有版本的控制台的功能，默认获取[2.6+版本的控制台](../console/console_of_java_sdk.md)，可通过如下命令获取最新的`download_console.sh`脚本：
 
 ```bash
-mkdir -p ~/fisco && cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.1/download_console.sh
+mkdir -p ~/fisco && cd ~/fisco && curl -#LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.2/download_console.sh
 ```
 
 ```eval_rst

diff --git a/docs/enterprise_tools/tutorial_detail_operation.md b/docs/enterprise_tools/tutorial_detail_operation.md
@@ -904,7 +904,7 @@ cd ~/generator-A
 ./generator --add_group ./group/group.1.genesis  ~/generator-C/nodeC
 ```
 
-当前`FISCO BCOS`暂不支持文件热更新，为机构C节点添加群组1创世区块后需重启节点。
+此步操作需要重启节点，热更新操作请参考[JSON-RPC API](../api.md##generategroup)
 
 重启机构C节点:
 

diff --git a/docs/enterprise_tools/tutorial_detail_operation_gm.md b/docs/enterprise_tools/tutorial_detail_operation_gm.md
@@ -943,7 +943,7 @@ cd ~/generator-A
 ./generator --add_group ./group/group.1.genesis  ~/generator-C/nodeC
 ```
 
-当前`FISCO BCOS`暂不支持文件热更新，为机构C节点添加群组1创世区块后需重启节点。
+此步操作需要重启节点，热更新操作请参考[JSON-RPC API](../api.md##generategroup)
 
 重启机构C节点:
 

diff --git a/docs/faq/gm_cfca.md b/docs/faq/gm_cfca.md
@@ -0,0 +1,71 @@
+# 使用CFCA国密证书部署FISCO BCOS  
+- 作者：王礼辉 (牛津(海南)区块链研究院有限公司)  
+## 概述  
+- 最近因为业务的需要，在研究使用cfca证书部署fisco bcos。一开始打算部署非国密版，后来发现cfca现在不签发EC算法的证书，所以如果使用cfca证书，只能部署国密版fisco。在向cfca申请sm2国密算法证书时，发现cfca返回的测试环境证书对用户不是很友好，返回的加密证书私钥是加了密的，需要自己进行解密，过程比较折腾，所以写下这篇文章，希望对有共同需求的开发者有所帮助。
+## 申请CFCA证书
+
+- 生成签名证书私钥  
+    * 用以下命令分别生成四个节点的私钥文件：node1.key, node2.key, node3.key, node4.key  
+	openssl ecparam -out node.param -name secp256k1  
+    openssl genpkey -paramfile node.param -out node.key
+- 填写证书申请模板-CSR
+    * 用以下命令分别生成四个节点的证书请求文件：node1.csr, node2.csr, node3.csr, node4.csr  
+	openssl req -new -sha256 -subj "/CN=node_127.0.0.1_30300/O=fisco-bcos/OU=node" -key node1.key -out node1.csr  
+	openssl req -new -sha256 -subj "/CN=node_127.0.0.1_30301/O=fisco-bcos/OU=node" -key node1.key -out node2.csr  
+	openssl req -new -sha256 -subj "/CN=node_127.0.0.1_30302/O=fisco-bcos/OU=node" -key node1.key -out node3.csr  
+	openssl req -new -sha256 -subj "/CN=node_127.0.0.1_30303/O=fisco-bcos/OU=node" -key node1.key -out node4.csr  
+- 获取CFCA签名证书，加密证书，加密证书私钥  
+    * 发送以下内容到support@cfca.com.cn向cfca申请测试环境国密证书  
+	> 1、测试证书类型：OCA31  设备证书SM2双证；  
+      2、密钥长度：SM2256；   
+      3、证书数量 ：4；  
+      4、IP: 127.0.0.1, 127.0.0.1, 127.0.0.1, 127.0.0.1；
+	* 一般在一个工作日内会收到申请结果邮件，里面会返回每个证书文件的序列号，授权码，用来下载证书 
+	* 打开下载证书地址https://cstest.cfca.com.cn/cgi-bin/compoundCertDownload/v_input.do ,输入收到的证书序列号，授权码和上       面步骤生成的csr文件，就会生成签名证书，加密证书和加密私钥的字符串，分别保存成文件gmnode.crt, gmennode.crt, gmennode.key     
+
+- 解析加密证书私钥  
+    * 为了安全考虑，cfca在返回加密私钥时是加了密的，需要把加密私钥解密才能使用，以下是解密过程  
+	> 1，获取密文，去掉“,”和前缀的数字字符后，进行Base64解码。  
+	2，再进行ASN.1解码（ASN.1结构参考如下），即可取得“加密后的加密证书密钥对数据”。  
+	>> EncryptedPrivatekey ::= SEQUENCE {
+	      version INTEGER,  
+		  encryptedPrivateKeyData OCTET STRING  
+		  }  
+	其中：  
+	version: 版本号，本文档中取值为： 0x01.  
+    encryptedPrivateKeyData: 加密后的加密证书密钥对数据。其密文格式为：C1||C3||C2.  
+	解密后的明文格式为： 加密公钥X分量(32字节)||加密公钥Y分量(32字节)||加密私钥(32字节)  
+
+	> 3，对以上步骤生成的encryptedPrivateKeyData，用之前本地生成的私钥进行解密，并把解密后的私钥保存成pem格式的私钥文件。可用两个命令导出公钥文件，查看两个公钥内容是否一致，检验私钥解密是否成功：  
+	openssl pkey -in "gmennode.key" -pubout -out "gmennode.pubkey"  
+	openssl x509 -outform PEM -in gmennode.crt -pubkey -out gmennode1.pubkey  
+	> 4, 下载cfca的根证书和二级根证书(cfca_gmca.crt, cfca_gmagency.crt)  
+	至此，得到了部署联盟链需要的根证书及四组双证证书的证书文件和私钥文件：cfca_gmnode.crt, cfca_gmnode.key, cfca_gmennode.crt, cfca_gmennode.key  
+- 下载cfca二级根证书和根证书
+    * 上cfca官网下载证书签发的二级根证书和根证书，用以下命令验证证书链：  
+	TASSLCMD verify -CAfile cfca_gmca.crt -untrusted cfca_gmagency.crt cfca_gmnode.crt, TASSLCMD是tassl安装路径
+## 使用证书生成节点
+
+- 下载企业部署工具
+    * 下载generator工具，并安装，下载相应版本的fisco-bcos。此步骤和正常部署安装国密联盟链相同，相关细节可查看官网文档，不再赘述。  
+- 生成节点配置文件  
+    * 1，按照正常部署国密版本的方法步骤生成链证书，机构证书，节点证书文件，以及相关的配置文件，不明白其中细节，可查阅官网文档。
+	* 2，以上步骤会生成的所有的证书文件会存放在meta目录中，用前面步骤生成的cfca_gmca.crt根证书替换gmca.crt文件，cfca_gmagency.crt替换机构证书gmagency.crt文件，把cfca生成的签名证书cfca_gmennode.crt替换gmnode.crt文件，cfca生成的加密证书cfca_gmennode.crt替换gmennode.crt文件，注意要把cfca二级证书文件的内容拷贝连接在gmnode.crt和gmennode.crt文件后面。 
+	* 3，执行以下命令构建链文件：  
+	./generator --create_group_genesis ./group -g  
+    ./generator --build_install_package ./meta/peers.txt ./nodes -g
+- 启动节点  
+    * cd nodes && ./start_all.sh 
+- 验证节点启动
+    * 查看进程  
+	ps -ef | grep fisco  
+	* 查看节点node0链接的节点数  
+	tail -f nodes/node_127.0.0.1_30300/log/log*  | grep connected  
+	* 检查是否在共识  
+	tail -f nodes/node_127.0.0.1_30300/log/log*  | grep +++
+## 注意事项
+
+- 证书基本约束：签名证书，加密证书  
+    * 在申请cfca证书时，要分清楚哪个是签名证书，哪个是加密证书，不要搞混。
+- 证书基本用途：客户端，server端  
+    * 向cfca申请证书是要确认申请的是设备双证类型证书，其他类型证书不能同时当客户端和服务器端证书使用。
diff --git a/docs/faq/index.rst b/docs/faq/index.rst
@@ -13,9 +13,11 @@
    version.md
    connect.md
    certificate.md
+   gm_cfca.md
    console.md
    tools.md
    contract.md
    tx.md
    precompiled.md
+   table.md
    compile.md
diff --git a/docs/faq/table.md b/docs/faq/table.md
@@ -0,0 +1,10 @@
+# 合约表问题
+
+标签：``表结构`` ``问题排查``
+
+----
+
+## 对于已经创建的合约表，是否支持添加字段。
+
+不支持。
+作为替代方案，用户可以创建一个新的表，使用相同的key关联两个表的数据，在合约中可以同时操作两个表。
diff --git a/docs/installation.md b/docs/installation.md
@@ -61,7 +61,7 @@ curl -#LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.7.2/buil
 
 ```eval_rst
 .. note::
-    - 如果因为网络问题导致长时间无法下载build_chain.sh脚本，请尝试 `curl -#LO https://gitee.com/FISCO-BCOS/FISCO-BCOS/raw/master/tools/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/v2.7.2/build_chain.sh && chmod u+x build_chain.sh`
 ```
 
 ![](./../images/installation/download_build_chain.gif)
@@ -217,7 +217,7 @@ sudo yum install -y java java-devel
 - 获取控制台并回到fisco目录
 
 ```bash
-cd ~/fisco && curl -LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.1/download_console.sh && bash download_console.sh
+cd ~/fisco && curl -LO https://github.com/FISCO-BCOS/console/releases/download/v2.7.2/download_console.sh && bash download_console.sh
 ```
 
 ```eval_rst