From c7359284de4d7a9bfcb6625580b3a043e685099d Mon Sep 17 00:00:00 2001 From: jdchain <48241540+jdchain@users.noreply.github.com> Date: Thu, 18 Jul 2019 09:49:26 +0800 Subject: [PATCH 01/23] add .travis.yml --- .travis.yml | 3 +++ 1 file changed, 3 insertions(+) create mode 100644 .travis.yml diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 00000000..b179f30c --- /dev/null +++ b/.travis.yml @@ -0,0 +1,3 @@ +language: java +jdk: + - openjdk8 From 8cdd542470aafcbe7a51d5fe61f445b7f25c4d86 Mon Sep 17 00:00:00 2001 From: jdchain <48241540+jdchain@users.noreply.github.com> Date: Thu, 18 Jul 2019 09:57:34 +0800 Subject: [PATCH 02/23] Update .travis.yml --- .travis.yml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/.travis.yml b/.travis.yml index b179f30c..b8d5bb25 100644 --- a/.travis.yml +++ b/.travis.yml @@ -1,3 +1,9 @@ language: java jdk: - openjdk8 + +before_install: + - cd ./source + +script: + - mvn clean package -Dmaven.test.skip=true From f265fd359005881c392182c432122db0552bc920 Mon Sep 17 00:00:00 2001 From: jdchain <48241540+jdchain@users.noreply.github.com> Date: Thu, 18 Jul 2019 10:13:23 +0800 Subject: [PATCH 03/23] add core-0.1.4.jar --- tools/core-0.1.4.jar | Bin 0 -> 67196 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 tools/core-0.1.4.jar diff --git a/tools/core-0.1.4.jar b/tools/core-0.1.4.jar new file mode 100644 index 0000000000000000000000000000000000000000..85ea3a4a69aaa5b600d609edc4004765aad4510c GIT binary patch literal 67196 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 Z{!|rUfkzi8C_&&a2@4A9EdYUn`ae`fJ)Zyo literal 0 HcmV?d00001 From dbec216b258fabf48d2927f2f3b4f72a13fb8b64 Mon Sep 17 00:00:00 2001 From: jdchain <48241540+jdchain@users.noreply.github.com> Date: Thu, 18 Jul 2019 10:16:55 +0800 Subject: [PATCH 04/23] Update .travis.yml --- .travis.yml | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/.travis.yml b/.travis.yml index b8d5bb25..2fc39ada 100644 --- a/.travis.yml +++ b/.travis.yml @@ -3,7 +3,9 @@ jdk: - openjdk8 before_install: - - cd ./source + - cd ./tools + - mvn install:install-file -Dfile=core-0.1.4.jar -DgroupId=com.yahoo.ycsb -DartifactId=core -Dversion=0.1.4 -Dpackaging=jar -DgeneratePom=true -DcreateChecksum=true + - cd ../source script: - mvn clean package -Dmaven.test.skip=true From cd8c3812c4f17fbc815fb1e488a44ba6c45d9bdc Mon Sep 17 00:00:00 2001 From: jdchain <48241540+jdchain@users.noreply.github.com> Date: Thu, 18 Jul 2019 10:28:30 +0800 Subject: [PATCH 05/23] Update README.md --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 6b98db84..b2a01e2e 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,8 @@ [![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html) +[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.jd.blockchain/sdk-pack/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.jd.blockchain/sdk-pack/) +[![Build Status](https://travis-ci.com/blockchain-jd-com/jdchain.svg?branch=release%2F1.0.1)](https://travis-ci.org/blockchain-jd-com/jdchain) ------------------------------------------------------------------------ @@ -623,4 +625,4 @@ JD区块链的核心对象包括： } -``` \ No newline at end of file +``` From 04d9c81f6f78f1dc58d72d560a9b3f9828c4c52b Mon Sep 17 00:00:00 2001 From: shaozhuguang Date: Thu, 18 Jul 2019 10:45:01 +0800 Subject: [PATCH 06/23] add ci --- .travis.yml | 11 +++++++++++ README.md | 4 ++-- 2 files changed, 13 insertions(+), 2 deletions(-) create mode 100644 .travis.yml diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 00000000..18634199 --- /dev/null +++ b/.travis.yml @@ -0,0 +1,11 @@ +language: java +jdk: + - openjdk8 + +before_install: + - cd ./tools + - mvn install:install-file -Dfile=core-0.1.4.jar -DgroupId=com.yahoo.ycsb -DartifactId=core -Dversion=0.1.4 -Dpackaging=jar -DgeneratePom=true -DcreateChecksum=true + - cd ../source + +script: + - mvn clean package \ No newline at end of file diff --git a/README.md b/README.md index 6b98db84..50bb30f4 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ [TOC] #JD区块链 - [![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html) - +[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.jd.blockchain/sdk-pack/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.jd.blockchain/sdk-pack/) +[![Build Status](https://travis-ci.com/blockchain-jd-com/jdchain.svg?branch=master)](https://travis-ci.org/blockchain-jd-com/jdchain) ------------------------------------------------------------------------ ### 版本修订历史 From da2f86123a13ad93d0a7893bbfcef6c4be97c541 Mon Sep 17 00:00:00 2001 From: shaozhuguang Date: Thu, 18 Jul 2019 10:47:04 +0800 Subject: [PATCH 07/23] add ci --- .travis.yml | 11 +++++++++++ README.md | 4 ++-- 2 files changed, 13 insertions(+), 2 deletions(-) create mode 100644 .travis.yml diff --git a/.travis.yml b/.travis.yml new file mode 100644 index 00000000..18634199 --- /dev/null +++ b/.travis.yml @@ -0,0 +1,11 @@ +language: java +jdk: + - openjdk8 + +before_install: + - cd ./tools + - mvn install:install-file -Dfile=core-0.1.4.jar -DgroupId=com.yahoo.ycsb -DartifactId=core -Dversion=0.1.4 -Dpackaging=jar -DgeneratePom=true -DcreateChecksum=true + - cd ../source + +script: + - mvn clean package \ No newline at end of file diff --git a/README.md b/README.md index 6b98db84..50bb30f4 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ [TOC] #JD区块链 - [![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html) - +[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.jd.blockchain/sdk-pack/badge.svg)](https://maven-badges.herokuapp.com/maven-central/com.jd.blockchain/sdk-pack/) +[![Build Status](https://travis-ci.com/blockchain-jd-com/jdchain.svg?branch=master)](https://travis-ci.org/blockchain-jd-com/jdchain) ------------------------------------------------------------------------ ### 版本修订历史 From 08af766dc1705fa5f07793c440202545f64a0feb Mon Sep 17 00:00:00 2001 From: jdchain <48241540+jdchain@users.noreply.github.com> Date: Thu, 18 Jul 2019 10:48:39 +0800 Subject: [PATCH 08/23] add core-0.1.4.jar --- tools/core-0.1.4.jar | Bin 0 -> 67196 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 tools/core-0.1.4.jar diff --git a/tools/core-0.1.4.jar b/tools/core-0.1.4.jar new file mode 100644 index 0000000000000000000000000000000000000000..85ea3a4a69aaa5b600d609edc4004765aad4510c GIT binary patch literal 67196 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 Z{!|rUfkzi8C_&&a2@4A9EdYUn`ae`fJ)Zyo literal 0 HcmV?d00001 From 7acbe0f994b760e7cc30152276fafc144ea00aa2 Mon Sep 17 00:00:00 2001 From: jdchain <48241540+jdchain@users.noreply.github.com> Date: Thu, 18 Jul 2019 10:49:19 +0800 Subject: [PATCH 09/23] add core-0.1.4.jar --- tools/core-0.1.4.jar | Bin 0 -> 67196 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 tools/core-0.1.4.jar diff --git a/tools/core-0.1.4.jar b/tools/core-0.1.4.jar new file mode 100644 index 0000000000000000000000000000000000000000..85ea3a4a69aaa5b600d609edc4004765aad4510c GIT binary patch literal 67196 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 Z{!|rUfkzi8C_&&a2@4A9EdYUn`ae`fJ)Zyo literal 0 HcmV?d00001 From 7752a533f17c2294fa868b7ab66c35f9e2f3cf09 Mon Sep 17 00:00:00 2001 From: shaozhuguang Date: Thu, 18 Jul 2019 11:03:36 +0800 Subject: [PATCH 10/23] =?UTF-8?q?=E5=88=A0=E9=99=A4TimeFormat=E6=B5=8B?= =?UTF-8?q?=E8=AF=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../initializer/LedgerInitPropertiesTest.java | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/source/tools/tools-initializer/src/test/java/test/com/jd/blockchain/tools/initializer/LedgerInitPropertiesTest.java b/source/tools/tools-initializer/src/test/java/test/com/jd/blockchain/tools/initializer/LedgerInitPropertiesTest.java index 703b86b4..431980e8 100644 --- a/source/tools/tools-initializer/src/test/java/test/com/jd/blockchain/tools/initializer/LedgerInitPropertiesTest.java +++ b/source/tools/tools-initializer/src/test/java/test/com/jd/blockchain/tools/initializer/LedgerInitPropertiesTest.java @@ -21,8 +21,9 @@ import com.jd.blockchain.utils.codec.HexUtils; public class LedgerInitPropertiesTest { private static String expectedCreatedTimeStr = "2019-08-01 14:26:58.069+0800"; - - @Test + + // 此测试在非东八区服务器环境下测试会存在问题，但属于正常，因此不再测试 +// @Test public void testTimeFormat() throws ParseException { SimpleDateFormat timeFormat = new SimpleDateFormat(LedgerInitProperties.CREATED_TIME_FORMAT); Date time = timeFormat.parse(expectedCreatedTimeStr); @@ -42,12 +43,12 @@ public class LedgerInitPropertiesTest { String actualLedgerSeed = HexUtils.encode(initProps.getLedgerSeed()); assertEquals(expectedLedgerSeed, actualLedgerSeed); - SimpleDateFormat timeFormat = new SimpleDateFormat(LedgerInitProperties.CREATED_TIME_FORMAT); - long expectedTs = timeFormat.parse(expectedCreatedTimeStr).getTime(); - assertEquals(expectedTs, initProps.getCreatedTime()); - - String createdTimeStr = timeFormat.format(new Date(initProps.getCreatedTime())); - assertEquals(expectedCreatedTimeStr, createdTimeStr); +// SimpleDateFormat timeFormat = new SimpleDateFormat(LedgerInitProperties.CREATED_TIME_FORMAT); +// long expectedTs = timeFormat.parse(expectedCreatedTimeStr).getTime(); +// assertEquals(expectedTs, initProps.getCreatedTime()); +// +// String createdTimeStr = timeFormat.format(new Date(initProps.getCreatedTime())); +// assertEquals(expectedCreatedTimeStr, createdTimeStr); assertEquals("com.jd.blockchain.consensus.bftsmart.BftsmartConsensusProvider", initProps.getConsensusProvider()); From 2916c05b57b600f208fe6773640a17eb2e6cee2a Mon Sep 17 00:00:00 2001 From: shaozhuguang Date: Thu, 18 Jul 2019 11:14:01 +0800 Subject: [PATCH 11/23] =?UTF-8?q?=E5=88=A0=E9=99=A4TimeFormat=E6=B5=8B?= =?UTF-8?q?=E8=AF=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../initializer/LedgerInitPropertiesTest.java | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/source/tools/tools-initializer/src/test/java/test/com/jd/blockchain/tools/initializer/LedgerInitPropertiesTest.java b/source/tools/tools-initializer/src/test/java/test/com/jd/blockchain/tools/initializer/LedgerInitPropertiesTest.java index 703b86b4..431980e8 100644 --- a/source/tools/tools-initializer/src/test/java/test/com/jd/blockchain/tools/initializer/LedgerInitPropertiesTest.java +++ b/source/tools/tools-initializer/src/test/java/test/com/jd/blockchain/tools/initializer/LedgerInitPropertiesTest.java @@ -21,8 +21,9 @@ import com.jd.blockchain.utils.codec.HexUtils; public class LedgerInitPropertiesTest { private static String expectedCreatedTimeStr = "2019-08-01 14:26:58.069+0800"; - - @Test + + // 此测试在非东八区服务器环境下测试会存在问题，但属于正常，因此不再测试 +// @Test public void testTimeFormat() throws ParseException { SimpleDateFormat timeFormat = new SimpleDateFormat(LedgerInitProperties.CREATED_TIME_FORMAT); Date time = timeFormat.parse(expectedCreatedTimeStr); @@ -42,12 +43,12 @@ public class LedgerInitPropertiesTest { String actualLedgerSeed = HexUtils.encode(initProps.getLedgerSeed()); assertEquals(expectedLedgerSeed, actualLedgerSeed); - SimpleDateFormat timeFormat = new SimpleDateFormat(LedgerInitProperties.CREATED_TIME_FORMAT); - long expectedTs = timeFormat.parse(expectedCreatedTimeStr).getTime(); - assertEquals(expectedTs, initProps.getCreatedTime()); - - String createdTimeStr = timeFormat.format(new Date(initProps.getCreatedTime())); - assertEquals(expectedCreatedTimeStr, createdTimeStr); +// SimpleDateFormat timeFormat = new SimpleDateFormat(LedgerInitProperties.CREATED_TIME_FORMAT); +// long expectedTs = timeFormat.parse(expectedCreatedTimeStr).getTime(); +// assertEquals(expectedTs, initProps.getCreatedTime()); +// +// String createdTimeStr = timeFormat.format(new Date(initProps.getCreatedTime())); +// assertEquals(expectedCreatedTimeStr, createdTimeStr); assertEquals("com.jd.blockchain.consensus.bftsmart.BftsmartConsensusProvider", initProps.getConsensusProvider()); From 10a977ce9dfb6fff2f0033a153438fe9f3fe1b7b Mon Sep 17 00:00:00 2001 From: Zhao Guangwei Date: Tue, 30 Jul 2019 17:20:28 +0800 Subject: [PATCH 12/23] Update pom.xml remove the log4j2 in scope test; --- source/pom.xml | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/source/pom.xml b/source/pom.xml index eaaad8c5..e87943f0 100644 --- a/source/pom.xml +++ b/source/pom.xml @@ -92,11 +92,6 @@ mockito-core test - - org.springframework.boot - spring-boot-starter-log4j2 - test - @@ -513,4 +508,4 @@ - \ No newline at end of file + From 266f8e81adcc7a89b3a4871f1ae41ed576cf6ba5 Mon Sep 17 00:00:00 2001 From: Zhao Guangwei Date: Tue, 30 Jul 2019 17:21:48 +0800 Subject: [PATCH 13/23] Update pom.xml add the log4j2 in scope test; --- source/utils/utils-http/pom.xml | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/source/utils/utils-http/pom.xml b/source/utils/utils-http/pom.xml index 53053a54..e62e9564 100644 --- a/source/utils/utils-http/pom.xml +++ b/source/utils/utils-http/pom.xml @@ -43,6 +43,11 @@ org.springframework spring-beans + + org.springframework.boot + spring-boot-starter-log4j2 + test + - \ No newline at end of file + From 0266ba1fbc1efe83f67538715ab8206c9cec5e69 Mon Sep 17 00:00:00 2001 From: zhaoguangwei Date: Tue, 30 Jul 2019 17:25:31 +0800 Subject: [PATCH 14/23] =?UTF-8?q?starter-log4j2=E8=B0=83=E6=95=B4=EF=BC=9B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- source/pom.xml | 5 -- source/utils/utils-http/pom.xml | 146 +++++++++++++++++--------------- 2 files changed, 76 insertions(+), 75 deletions(-) diff --git a/source/pom.xml b/source/pom.xml index 1633c32e..8bf5c664 100644 --- a/source/pom.xml +++ b/source/pom.xml @@ -92,11 +92,6 @@ mockito-core test - - org.springframework.boot - spring-boot-starter-log4j2 - test - diff --git a/source/utils/utils-http/pom.xml b/source/utils/utils-http/pom.xml index cf3a6ed7..91292ad9 100644 --- a/source/utils/utils-http/pom.xml +++ b/source/utils/utils-http/pom.xml @@ -1,71 +1,77 @@ - - 4.0.0 - - com.jd.blockchain - utils - 1.0.1.RELEASE - - - - 0.5.0-SNAPSHOT - 0.5.0-SNAPSHOT - - - utils-http - - - com.jd.blockchain - utils-common - ${project.version} - - - com.jd.blockchain - utils-serialize - ${project.version} - - - com.jd.blockchain - utils-web-server - test - ${project.version} - - - - org.apache.httpcomponents - httpclient - - - org.springframework - spring-core - - - org.springframework - spring-beans - - - - - - + + 4.0.0 + + com.jd.blockchain + utils + 1.0.1.RELEASE + + + + 0.5.0-SNAPSHOT + 0.5.0-SNAPSHOT + + + utils-http + + + com.jd.blockchain + utils-common + ${project.version} + + + com.jd.blockchain + utils-serialize + ${project.version} + + + com.jd.blockchain + utils-web-server + test + ${project.version} + + + + org.apache.httpcomponents + httpclient + + + org.springframework + spring-core + + + org.springframework + spring-beans + + + + org.springframework.boot + spring-boot-starter-log4j2 + test + + + + + + \ No newline at end of file From 82c2233fed8a88853b30d2a9ae54e24e3bf89de5 Mon Sep 17 00:00:00 2001 From: huanghaiquan Date: Tue, 27 Aug 2019 03:05:41 +0800 Subject: [PATCH 15/23] Upgraded readme; --- README.md | 649 ++++--------------------------------- docs/design.md | 630 +++++++++++++++++++++++++++++++++++ docs/images/deployment.jpg | Bin 0 -> 131011 bytes 3 files changed, 700 insertions(+), 579 deletions(-) create mode 100644 docs/design.md create mode 100644 docs/images/deployment.jpg diff --git a/README.md b/README.md index 6b98db84..6854f3b7 100644 --- a/README.md +++ b/README.md @@ -6,621 +6,112 @@ ------------------------------------------------------------------------ -### 版本修订历史 - - - - - - - - - - - - - - - - - - - - - - - - - -
版本号作 者修改日期备 注
0.0.6黄海泉2017-11-10 - 定义JD区块链项目的目标与关键能力；
- 定义JD区块链的核心对象模型；
- 定义“账户”的生成算法和“区块/交易/操作/账户”的关键属性；
- 描述了编程接口的示例代码； -
0.0.7黄海泉2017-11-17 - 丰富了对“节点共识”、“节点分区”两项关键能力的详细描述； -
0.0.8黄海泉2018-07-17 - 增加部署图；增加智能合约开发的示例； -
------------------------------------------------------------------------- - -## 一、概述 -JD区块链项目的目标是提供一个面向广泛的应用场景、满足企业核心需求的灵活和易用的区块链系统。 -以下是 JD 区块链用以满足企业核心需求的关键能力，也是显著区别于其它区块链的重要特征： - - - 快速共识 - - 节点分区 - - 并行多账本 - - 大数据伸缩存储 - - 条件检索 - - 面向对象的合约代码编程模型 - - 节点快速部署 - - 多终端灵活接入 - - 分布式自治的账户权限管理模型 - -JD区块链对于关键能力的定义是建立在深入理解和抽象各种多样化需求的基础上的。 - - - 快速共识（Efficient Consensus） - 我们认为，“快速”不仅仅体现在“用更短时间”达成共识，还要体现在交易（Transaction）要得到可靠地执行。 - 需要在算法和实现层面做出保障，确保所有提交的合法的交易会被系统在一个“确定性”和“足够短”的时间之内被严格地执行，系统不主动作出随机性地丢弃（不包括系统故障因素）。注：POW类算法产生的链分叉处理是一种系统随机性地丢弃交易的行为。 - 从使用者的视角来看，这种能力就是区块链系统的“可靠性”，这对于企业、金融场景而言尤其重要。 - - - 节点分区（Peer Partition） - “分区”是一种分布式系统架构原则，通过将大范围目标按照某种相似特征分隔为一个个小范围目标，分别进行更高效地处理，这能从整体上提升整个系统的处理能力。 - 区块链系统也是一种分布式系统，沿用“分区”的思想这点来自以往的系统架构实践的经验，是有可能让区块链系统获得可媲美现有系统的处理能力。这种能力将可以无障碍地把区块链在应用于广泛的企业场景中。 - 在此，我们所说的“节点分区（Peer Partition）” 是共识过程中的物理通讯层面的分区，在共识过程中只有相关的物理节点才会建立通讯链路并复制和存储共识的状态数据。在一个区块链系统中，可以从节点全集中选择一个或多个节点子集，分别组成一个或多个节点分区（Peer Partition） - - - 并行多账本 - 账本（Ledger） - - 大数据伸缩存储 - - 条件检索 - - 面向对象的合约代码编程模型 - - 节点快速部署 - - 多终端灵活接入 - - 分布式自治的账户权限管理模型 - -## 二、对象模型 -JD区块链的核心对象包括： - - - 账本（Ledger） - 一份账本（Ledger）实质上是由两部分组成： - - 一组以“账户（Account）”表示的状态数据； - - 以“区块的链条（Block-chain）”表示的状态数据的变更历史； - - JD区块链的“账本（Ledger）”是一个最顶层的管理数据的逻辑单元。在一个区块链节点构成的共识网络中，可以维护多套并行的“账本（Ledger）”。 - - - 账户（Account） - - 在JD区块链中，账户（Account）被设计为包含“身份（Identity）”、“权限（Privilege）”、“状态（State）”、“控制规则（Control Rule）” 这4种属性的对象。 - - 其中，“身份（Identity）”、“权限（Privilege）”这两种属性是一个面向应用的系统的基本功能； - - “状态（State）”、“控制规则（Control Rule）” 这两种属性这是一个具备“图灵完备性”的系统的基本属性，使系统可以处理任意多样化的任务； - - 在这里，“身份（Identity）”是一个抽象表述，其形式上就是一个“区块链地址（Address）”和相应的“非对称秘钥钥对（KeyPair）”/证书。 简单来说，一个“账户（Account）”就是一个区块链地址、公私钥对以及一套的权限配置. - - 一个“账户（Account）”的“状态（State）”、“控制规则（Control Rule）” 这2种属性则是可选的，这提供了不同于其它区块链的账户/合约的一种新的使用方式，即一种数据和逻辑分离的应用设计思路（这在传统的web应用编程中被称为“贫血模型”）。同时，也意味着一个特定“账户”中的数据状态是可以跨账户/合约代码进行共享访问的。 - - 从应用的视角来看，对“账户”的使用方式可以有几种模式： - - 用于表示业务角色/用户： - - 用于表示业务数据：仅有“状态（State）”没有“控制规则（Control Rule）”的账户，可称为数据账户，就有些类似于关系数据库中的“表（Table）”的作用，不同业务类别的数据则使用不同的账户来管理。 - - 用于表示业务逻辑：仅有“控制规则（Control Rule）”没有“状态（State）”的账户，即所谓的合约账户，可表示某种用于处理数据的通用逻辑，可被授权访问特定的数据账户。 - - - 区块（Block） - 在概念上，与通常所说的区块的概念是一致的。 - 在实现上，一个区块的主要内容是包含了某一时刻提交的所有交易以及交易执行之后的状态数据的快照的hash，而不存储具体的交易操作和状态数据。 - - - 交易（Transaction） - 在概念上，与通常所说的Transaction的概念是一致的，表示一组需要原子执行的操作。 - - - 操作（Operation） - 操作是针对“账户（Account）”的“写”指令，包括以下几类： - - 注册账户 - - 更新账户的状态数据 - - 更新账户的合约代码定义 - - 调用账户的合约代码 - - - 合约代码（Contract Code） - 合约代码是一段用于对“账户（Account）”的状态数据执行操作的代码程序。 - -## 三、部署模型 - - 1. 总体部署 -![deployment architecture](docs/images/deployment.png) - - 2. 系统组件 - - 共识节点 - - 复制节点 - - SDK - - 网关 - - 终端 - - 3. 配置和管理 - -## 四、账本结构 - -### 1. 账户生成算法 - - - 公私钥对 - - 算法：默认ED25519 ，支持 SM2、CA； - - 公钥存储格式：版本 + 算法标识 + 公私钥原始内容 + 校验码 - - 字符编码方式：Base64 - - 地址 - - 算法 - - 给定公钥 P （或由私钥 R 算出公钥 P） - - 中间值 H1 = SHA256( P ) - - 中间值 H2 = RIPEMD-160( H1 ) - - 中间值 X = 版本 + 公钥算法标识 + H2 - - 校验和 C = 前4字节( SHA256( SHA256( X )) ) - - 地址 Address = Base58( X + C ) - -### 2. 区块 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
属性名称说明
BlockHash当前区块 hash对区块中除此之外的其它所有属性一起进行哈希运算生成
BlockVersion 区块版本表示区块-交易的属性结构的版本号；
PreviousBlockHash上一区块 hash
BlockNumber区块高度区块高度是一个区块在链中的序号；
创始区块的高度为 0，每个新区块的高度依次递增；
AccountHash账户树hash账户的 Merkle Tree 根的 hash
AccountCount账户数量区块生成时账本中的全部账户的总数
TxTreeHash交易树 hash本区块的交易集合的 Merkle Tree 根的 hash
TxCount区块交易数量当前区块包含的交易的数量；
TxTotalCount账本交易总数截止到当前区块为止当前账本的所有交易的总数量；
CloseTime区块关闭时间生成当前区块时的区块链节点的网络时间；
- -### 3. 交易 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
属性名称说明
Hash当前交易 hash对交易中除此之外的其它所有属性一起进行哈希运算生成
LedgerNumber区块高度交易被包含的区块高度
BlobHash交易数据块hash交易的数据块是交易的原始数据，包含客户端提交的交易的全部操作及其参数； -
交易的参与者需要使用私钥对交易数据块进行签名；
Operations操作列表交易的操作列表；
Sponsor交易发起人交易发起人的账户地址；
SequenceNumber交易序号交易序号记录了一个特定的发起人的交易的顺序号，等同于该发起人历史上发起的交易的总数；
Signatures签名列表由交易发起人和其它参与者对交易数据块的签名的列表；
Result交易结果0 - 表示执行成功；非零表示执行失败；
注：最终的账本只包含成功的交易;
- -### 4. 操作 - - - - - - - - - - - - - - - - - - - - - -
属性名称说明
OpType操作类型 - 一级操作类型包括：注册账户、配置权限、写入键值数据、写入对象数据、定义合约代码、调用合约代码；
- “键值数据写入”操作的子操作类型包括：填入键值、移除键、数值增加、数值减少；
- “对象数据写入”操作的自操作类型包括：插入对象、更新对象、移除对象； -
Args参数列表与操作类型相对应的参数列表；
SubOps子操作列表“子操作”是“操作”的递归定义，由“操作类型”来标识；
- -### 5. 账户 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
属性名称说明
Address地址账户的唯一标识
RegNumber注册号账户被注册到区块链的区块高度；
TxSquenceNumber交易序列号由账户发起的交易的序列号，初始为 0，账户每发起一个交易则增加1；
ModelVersion账户模型版本表示构成一个账户结构的属性模型的程序版本号；
Version账户版本初始为 0，对账户的每一次变更(包括对权限设置、状态和合约代码的变更)都会使账户状态版本增加 1 ；
注：交易序号的改变不会导致账户版本的增加；
PrivilegeHash权限 hash权限树的根hash；
PrivilegeVersion权限版本初始为 0， 每次对权限的变更都导致版本号加 1；
StateType状态类型账户的状态类型有3种：空类型(NIL)；键值类型；对象类型；
StateVersion状态版本账户的状态类型有3种：空类型(NIL)；键值类型；对象类型；
StateHash状态哈希数据状态的 merkle tree 的根hash；
CodeHash合约代码哈希由“账户地址+合约代码版本号+合约代码内容”生成的哈希；
CodeVersion代码版本初始为 0，每次对代码的变更都使版本加 1 ；
- -## 五、编程接口 - -### 1. 服务连接 - - -```java - //创建服务代理 - public static BlockchainKeyPair CLIENT_CERT = BlockchainKeyGenerator.getInstance().generate(); - final String GATEWAY_IP = "127.0.0.1"; - final int GATEWAY_PORT = 80; - final boolean SECURE = false; - GatewayServiceFactory serviceFactory = GatewayServiceFactory.connect(GATEWAY_IP, GATEWAY_PORT, SECURE, - CLIENT_CERT); - // 创建服务代理； - BlockchainService service = serviceFactory.getBlockchainService(); -``` +## 一、项目简介 +JD Chain 的目标是实现一个面向企业应用场景的通用区块链框架系统，能够作为企业级基础设施，为业务创新提供高效、灵活和安全的解决方案。 -### 2. 用户注册 +## 二、部署模型 +JD Chain 主要部署组件包括以下几种： -```java - // 创建服务代理； - BlockchainService service = serviceFactory.getBlockchainService(); - // 在本地定义注册账号的 TX； - TransactionTemplate txTemp = service.newTransaction(ledgerHash); - SignatureFunction signatureFunction = asymmetricCryptography.getSignatureFunction(CryptoAlgorithm.ED25519); - CryptoKeyPair cryptoKeyPair = signatureFunction.generateKeyPair(); - BlockchainKeyPair user = new BlockchainKeyPair(cryptoKeyPair.getPubKey(), cryptoKeyPair.getPrivKey()); - - txTemp.users().register(user.getIdentity()); +- 共识节点 - // TX 准备就绪； - PreparedTransaction prepTx = txTemp.prepare(); - // 使用私钥进行签名； - CryptoKeyPair keyPair = getSponsorKey(); - prepTx.sign(keyPair); + 共识节点即参与共识的节点，这是系统的核心组件，承担了运行共识协议、管理账本数据、运行智能合约的职责。 - // 提交交易； - prepTx.commit(); -``` + 一个区块链网络由多个共识节点组成，共识节点的数量范围由选择的共识协议决定。 + 共识节点和账本是两个不同的概念，共识节点是个物理上的概念，账本是个逻辑上的概念。JD Chain 是一个多账本区块链系统，一个共识节点上可以装载运行多个账本。账本是数据维度的独立管理单元。共识节点和账本的关系，就像关系数据库系统中，数据库服务器和数据库实例的关系。 -### 3. 数据账户注册 + 共识节点通常都部署在参与方的内部网络中，通过由网络管理员指定的安全的网络出口与其它的共识节点建立通讯连接。 + 共识节点在形态上是服务器中的一个处理进程，背后需要连接一个本地或者内网的NoSQL数据库系统作为账本的存储。当前版本，共识节点目前是单进程的，未来版本将实现多进程以及多服务器集群模式。 -```java - // 创建服务代理； - BlockchainService service = serviceFactory.getBlockchainService(); - // 在本地定义注册账号的 TX； - TransactionTemplate txTemp = service.newTransaction(ledgerHash); - SignatureFunction signatureFunction = asymmetricCryptography.getSignatureFunction(CryptoAlgorithm.ED25519); - CryptoKeyPair cryptoKeyPair = signatureFunction.generateKeyPair(); - BlockchainKeyPair dataAccount = new BlockchainKeyPair(cryptoKeyPair.getPubKey(), cryptoKeyPair.getPrivKey()); - - txTemp.dataAccounts().register(dataAccount.getIdentity()); - - // TX 准备就绪； - PreparedTransaction prepTx = txTemp.prepare(); - // 使用私钥进行签名； - CryptoKeyPair keyPair = getSponsorKey(); - prepTx.sign(keyPair); - - // 提交交易； - prepTx.commit(); -``` +- 网关节点 -### 4. 写入数据 + 网关节点是负责终端接入的节点，负责终端连接、协议转换、交易准入、本地密码运算、密钥管理等职责。 -```java - // 创建服务代理； - BlockchainService service = serviceFactory.getBlockchainService(); - - HashDigest ledgerHash = getLedgerHash(); - // 在本地定义注册账号的 TX； - TransactionTemplate txTemp = service.newTransaction(ledgerHash); - - // -------------------------------------- - // 将商品信息写入到指定的账户中； - // 对象将被序列化为 JSON 形式存储，并基于 JSON 结构建立查询索引； - String commodityDataAccount = "GGhhreGeasdfasfUUfehf9932lkae99ds66jf=="; - Commodity commodity1 = new Commodity(); - txTemp.dataAccount(commodityDataAccount).set("ASSET_CODE", commodity1.getCode().getBytes(), -1); - - // TX 准备就绪； - PreparedTransaction prepTx = txTemp.prepare(); - - String txHash = ByteArray.toBase64(prepTx.getHash().toBytes()); - // 使用私钥进行签名； - CryptoKeyPair keyPair = getSponsorKey(); - prepTx.sign(keyPair); - - // 提交交易； - prepTx.commit(); -``` + 网关节点是一种轻量节点，需要绑定一个特定参与方的密钥对，连接到一个或多个共识节点。 - -### 5. 查询数据 + 网关节点向共识节点的连接是需要通过认证的，绑定的参与方的密钥对必须事先已经注册到区块链账本中，且得到接入授权。 -> 注：详细的查询可参考模块sdk-samples中SDK_GateWay_Query_Test_相关测试用例 +- 终端 -```java - // 创建服务代理； - BlockchainService service = serviceFactory.getBlockchainService(); - - // 查询区块信息； - // 区块高度； - long ledgerNumber = service.getLedger(LEDGER_HASH).getLatestBlockHeight(); - // 最新区块； - LedgerBlock latestBlock = service.getBlock(LEDGER_HASH, ledgerNumber); - // 区块中的交易的数量； - long txCount = service.getTransactionCount(LEDGER_HASH, latestBlock.getHash()); - // 获取交易列表； - LedgerTransaction[] txList = service.getTransactions(LEDGER_HASH, ledgerNumber, 0, 100); - // 遍历交易列表 - for (LedgerTransaction ledgerTransaction : txList) { - TransactionContent txContent = ledgerTransaction.getTransactionContent(); - Operation[] operations = txContent.getOperations(); - if (operations != null && operations.length > 0) { - for (Operation operation : operations) { - operation = ClientOperationUtil.read(operation); - // 操作类型：数据账户注册操作 - if (operation instanceof DataAccountRegisterOperation) { - DataAccountRegisterOperation daro = (DataAccountRegisterOperation) operation; - BlockchainIdentity blockchainIdentity = daro.getAccountID(); - } - // 操作类型：用户注册操作 - else if (operation instanceof UserRegisterOperation) { - UserRegisterOperation uro = (UserRegisterOperation) operation; - BlockchainIdentity blockchainIdentity = uro.getUserID(); - } - // 操作类型：账本注册操作 - else if (operation instanceof LedgerInitOperation) { - - LedgerInitOperation ledgerInitOperation = (LedgerInitOperation)operation; - LedgerInitSetting ledgerInitSetting = ledgerInitOperation.getInitSetting(); - - ParticipantNode[] participantNodes = ledgerInitSetting.getConsensusParticipants(); - } - // 操作类型：合约发布操作 - else if (operation instanceof ContractCodeDeployOperation) { - ContractCodeDeployOperation ccdo = (ContractCodeDeployOperation) operation; - BlockchainIdentity blockchainIdentity = ccdo.getContractID(); - } - // 操作类型：合约执行操作 - else if (operation instanceof ContractEventSendOperation) { - ContractEventSendOperation ceso = (ContractEventSendOperation) operation; - } - // 操作类型：KV存储操作 - else if (operation instanceof DataAccountKVSetOperation) { - DataAccountKVSetOperation.KVWriteEntry[] kvWriteEntries = - ((DataAccountKVSetOperation) operation).getWriteSet(); - if (kvWriteEntries != null && kvWriteEntries.length > 0) { - for (DataAccountKVSetOperation.KVWriteEntry kvWriteEntry : kvWriteEntries) { - BytesValue bytesValue = kvWriteEntry.getValue(); - DataType dataType = bytesValue.getType(); - Object showVal = ClientOperationUtil.readValueByBytesValue(bytesValue); - System.out.println("writeSet.key=" + kvWriteEntry.getKey()); - System.out.println("writeSet.value=" + showVal); - System.out.println("writeSet.type=" + dataType); - System.out.println("writeSet.version=" + kvWriteEntry.getExpectedVersion()); - } - } - } - } - } - } - - // 根据交易的 hash 获得交易；注：客户端生成 PrepareTransaction 时得到交易hash； - HashDigest txHash = txList[0].getTransactionContent().getHash(); - Transaction tx = service.getTransactionByContentHash(LEDGER_HASH, txHash); - // 获取数据； - String commerceAccount = "GGhhreGeasdfasfUUfehf9932lkae99ds66jf=="; - String[] objKeys = new String[] { "x001", "x002" }; - KVDataEntry[] kvData = service.getDataEntries(LEDGER_HASH, commerceAccount, objKeys); - - long payloadVersion = kvData[0].getVersion(); - - // 获取数据账户下所有的KV列表 - KVDataEntry[] kvData = service.getDataEntries(ledgerHash, commerceAccount, 0, 100); - if (kvData != null && kvData.length > 0) { - for (KVDataEntry kvDatum : kvData) { - System.out.println("kvData.key=" + kvDatum.getKey()); - System.out.println("kvData.version=" + kvDatum.getVersion()); - System.out.println("kvData.type=" + kvDatum.getType()); - System.out.println("kvData.value=" + kvDatum.getValue()); - } - } -``` + 终端泛指可以提交交易的客户端，典型来说，包括人、自动化设备、链外的信息系统等。 + 终端只能通过网关节点来提交交易。终端提交的交易需要用体现该终端身份的私钥来签署，产生一份电子签名。随后当交易提交给网关节点时，网关节点需要在把交易提交到共识节点之前，对交易请求以网关节点绑定的私钥追加一项“节点签名”。 -### 6. 合约发布 +- 备份节点 -```java - - // 创建服务代理； - BlockchainService service = serviceFactory.getBlockchainService(); + 仅对账本数据提供备份，但不参与交易共识的节点。（注：目前版本中尚未实现，将在后续版本中提供） - // 在本地定义TX模板 - TransactionTemplate txTemp = service.newTransaction(ledgerHash); - // 合约内容读取 - byte[] contractBytes = FileUtils.readBytes(new File(CONTRACT_FILE)); +![](docs/images/deployment.jpg) - // 生成用户 - BlockchainIdentityData blockchainIdentity = new BlockchainIdentityData(getSponsorKey().getPubKey()); - // 发布合约 - txTemp.contracts().deploy(blockchainIdentity, contractBytes); +## 三、代码下载与编译 - // TX 准备就绪； - PreparedTransaction prepTx = txTemp.prepare(); + 1. 安装 Maven 环境 + JD Chain 当前版本以 Java 语言开发，需要安装配置 JVM 和 Maven，JDK 版本不低于1.8 。没有特殊的安装要求，请另行搜索安装方法，此处不赘述。 + + 2. 安装 Git 工具 + + 为了能够执行 git clone 命令获取代码仓库。没有特殊的安装要求，请另行搜索安装方法，此处不赘述。 + + 3. 编译过程 - // 使用私钥进行签名； - CryptoKeyPair keyPair = getSponsorKey(); + JD Chain 项目包括 3 个代码仓库 - prepTx.sign(keyPair); + - jdchain + - 这是当前仓库，也是核心仓库，包含了共识节点、网关节点、SDK等一切部署组件。依赖于 explorer 和 bftsmart 这两个仓库先进行编译安装； + + - explorer + - 这是区块链浏览器的前端Web页面的工程，需要编译成静态资源包，由网关节点集成到一起部署。 + - 地址：git@github.com:blockchain-jd-com/explorer.git - // 提交交易； - TransactionResponse transactionResponse = prepTx.commit(); + - bftsmart + - 这是bftsmart共识协议的工程，需要 - assertTrue(transactionResponse.isSuccess()); - // 打印合约地址 - System.out.println(blockchainIdentity.getAddress().toBase58()); +4. 命令操作 -``` +- 编译安装 explorer 到本地 maven 仓库； +```sh + $ git clone git@github.com:blockchain-jd-com/explorer.git explorer -### 7. 合约执行 + $ cd explorer -```java + $ git checkout master - // 创建服务代理； - BlockchainService service = serviceFactory.getBlockchainService(); + $ mvn clean install + +``` +- 编译安装 bftsmart 到本地 maven 仓库； + - 需要手动先安装一个第三方包，位于仓库根目录下 lib/core-0.1.4.jar +```sh + $ git clone git@github.com:blockchain-jd-com/bftsmart.git bftsmart - // 在本地定义TX模板 - TransactionTemplate txTemp = service.newTransaction(ledgerHash); + $ cd bftsmart - // 合约地址 - String contractAddressBase58 = ""; - - // 使用接口方式调用合约 - TransferContract transferContract = txTpl.contract(contractAddress, TransferContract.class); - - // 使用decode方式调用合约内部方法（create方法） - // 返回GenericValueHolder可通过get方法获取结果，但get方法需要在commit调用后执行 - GenericValueHolder result = ContractReturnValue.decode(transferContract.create(address, account, money)); - - PreparedTransaction ptx = txTpl.prepare(); + $ git checkout master - ptx.sign(adminKey); - - TransactionResponse transactionResponse = ptx.commit(); - - String cotractExecResult = result.get(); - - // TransactionResponse也提供了可供查询结果的接口 - OperationResult[] operationResults = transactionResponse.getOperationResults(); - - // 通过OperationResult获取结果 - for (int i = 0; i < operationResults.length; i++) { - OperationResult opResult = operationResults[i]; - System.out.printf("Operation[%s].result = %s \r\n", - opResult.getIndex(), BytesValueEncoding.decode(opResult.getResult())); - } + $ mvn install:install-file -Dfile=lib/core-0.1.4.jar -DgroupId=com.yahoo.ycsb -DartifactId=core -Dversion=0.1.4 -Dpackaging=jar + + $ mvn clean install +``` +- 编译 jdchain 工程； + - 当编译完成后，共识节点的安装包位于 "仓库根目录"/source/deployment/deployment-peer/target/jdchain-peer-1.0.1.RELEASE.zip + - 当编译完成后，网关节点的安装包位于 "仓库根目录"/source/deployment/deployment-gateway/target/jdchain-gateway-1.0.1.RELEASE.zip -``` \ No newline at end of file +```sh + $ git clone git@github.com:blockchain-jd-com/jdchain.git jdchain + + $ cd jdchain/source + + $ git checkout master + + $ mvn clean package + +``` diff --git a/docs/design.md b/docs/design.md new file mode 100644 index 00000000..7cea13d1 --- /dev/null +++ b/docs/design.md @@ -0,0 +1,630 @@ +[TOC] +#JD区块链 + + +[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html) + + +------------------------------------------------------------------------ +### 版本修订历史 + + + + + + + + + + + + + + + + + + + + + + + + + +
版本号作 者修改日期备 注
0.0.6黄海泉2017-11-10 + 定义JD区块链项目的目标与关键能力；
+ 定义JD区块链的核心对象模型；
+ 定义“账户”的生成算法和“区块/交易/操作/账户”的关键属性；
+ 描述了编程接口的示例代码； +
0.0.7黄海泉2017-11-17 + 丰富了对“节点共识”、“节点分区”两项关键能力的详细描述； +
0.0.8黄海泉2018-07-17 + 增加部署图；增加智能合约开发的示例； +
+ +------------------------------------------------------------------------ + +## 一、概述 +JD Chain 的目标是实现一个面向企业应用场景的通用区块链框架系统，能够作为企业级基础设施，为业务创新提供高效、灵活和安全的解决方案。 + +区块链本质上是一种新的分布式架构，以密码学和分布式技术为核心，旨在实现无需借助“第三方” 就能在多个业务方之间进行安全、可信、直接的信息和价值交换。从点对点的信息和价值交换的角度看，区块链发挥了“协议”的作用。 + + +以下是 JD 区块链用以满足企业核心需求的关键能力，也是显著区别于其它区块链的重要特征： + + - 快速共识 + - 节点分区 + - 并行多账本 + - 大数据伸缩存储 + - 条件检索 + - 面向对象的合约代码编程模型 + - 节点快速部署 + - 多终端灵活接入 + - 分布式自治的账户权限管理模型 + +JD区块链对于关键能力的定义是建立在深入理解和抽象各种多样化需求的基础上的。 + + - 快速共识（Efficient Consensus） + 我们认为，“快速”不仅仅体现在“用更短时间”达成共识，还要体现在交易（Transaction）要得到可靠地执行。 + 需要在算法和实现层面做出保障，确保所有提交的合法的交易会被系统在一个“确定性”和“足够短”的时间之内被严格地执行，系统不主动作出随机性地丢弃（不包括系统故障因素）。注：POW类算法产生的链分叉处理是一种系统随机性地丢弃交易的行为。 + 从使用者的视角来看，这种能力就是区块链系统的“可靠性”，这对于企业、金融场景而言尤其重要。 + + - 节点分区（Peer Partition） + “分区”是一种分布式系统架构原则，通过将大范围目标按照某种相似特征分隔为一个个小范围目标，分别进行更高效地处理，这能从整体上提升整个系统的处理能力。 + 区块链系统也是一种分布式系统，沿用“分区”的思想这点来自以往的系统架构实践的经验，是有可能让区块链系统获得可媲美现有系统的处理能力。这种能力将可以无障碍地把区块链在应用于广泛的企业场景中。 + 在此，我们所说的“节点分区（Peer Partition）” 是共识过程中的物理通讯层面的分区，在共识过程中只有相关的物理节点才会建立通讯链路并复制和存储共识的状态数据。在一个区块链系统中，可以从节点全集中选择一个或多个节点子集，分别组成一个或多个节点分区（Peer Partition） + + - 并行多账本 + 账本（Ledger） + - 大数据伸缩存储 + - 条件检索 + - 面向对象的合约代码编程模型 + - 节点快速部署 + - 多终端灵活接入 + - 分布式自治的账户权限管理模型 + +## 二、对象模型 +JD区块链的核心对象包括： + + - 账本（Ledger） + 一份账本（Ledger）实质上是由两部分组成： + - 一组以“账户（Account）”表示的状态数据； + - 以“区块的链条（Block-chain）”表示的状态数据的变更历史； + + JD区块链的“账本（Ledger）”是一个最顶层的管理数据的逻辑单元。在一个区块链节点构成的共识网络中，可以维护多套并行的“账本（Ledger）”。 + + - 账户（Account） + - 在JD区块链中，账户（Account）被设计为包含“身份（Identity）”、“权限（Privilege）”、“状态（State）”、“控制规则（Control Rule）” 这4种属性的对象。 + - 其中，“身份（Identity）”、“权限（Privilege）”这两种属性是一个面向应用的系统的基本功能； + - “状态（State）”、“控制规则（Control Rule）” 这两种属性这是一个具备“图灵完备性”的系统的基本属性，使系统可以处理任意多样化的任务； + - 在这里，“身份（Identity）”是一个抽象表述，其形式上就是一个“区块链地址（Address）”和相应的“非对称秘钥钥对（KeyPair）”/证书。 简单来说，一个“账户（Account）”就是一个区块链地址、公私钥对以及一套的权限配置. + - 一个“账户（Account）”的“状态（State）”、“控制规则（Control Rule）” 这2种属性则是可选的，这提供了不同于其它区块链的账户/合约的一种新的使用方式，即一种数据和逻辑分离的应用设计思路（这在传统的web应用编程中被称为“贫血模型”）。同时，也意味着一个特定“账户”中的数据状态是可以跨账户/合约代码进行共享访问的。 + - 从应用的视角来看，对“账户”的使用方式可以有几种模式： + - 用于表示业务角色/用户： + - 用于表示业务数据：仅有“状态（State）”没有“控制规则（Control Rule）”的账户，可称为数据账户，就有些类似于关系数据库中的“表（Table）”的作用，不同业务类别的数据则使用不同的账户来管理。 + - 用于表示业务逻辑：仅有“控制规则（Control Rule）”没有“状态（State）”的账户，即所谓的合约账户，可表示某种用于处理数据的通用逻辑，可被授权访问特定的数据账户。 + + - 区块（Block） + 在概念上，与通常所说的区块的概念是一致的。 + 在实现上，一个区块的主要内容是包含了某一时刻提交的所有交易以及交易执行之后的状态数据的快照的hash，而不存储具体的交易操作和状态数据。 + + - 交易（Transaction） + 在概念上，与通常所说的Transaction的概念是一致的，表示一组需要原子执行的操作。 + + - 操作（Operation） + 操作是针对“账户（Account）”的“写”指令，包括以下几类： + - 注册账户 + - 更新账户的状态数据 + - 更新账户的合约代码定义 + - 调用账户的合约代码 + + - 合约代码（Contract Code） + 合约代码是一段用于对“账户（Account）”的状态数据执行操作的代码程序。 + +## 三、部署模型 + + 1. 总体部署 +![deployment architecture](docs/images/deployment.png) + + 2. 系统组件 + - 共识节点 + - 复制节点 + - SDK + - 网关 + - 终端 + + 3. 配置和管理 + +## 四、账本结构 + +### 1. 账户生成算法 + + - 公私钥对 + - 算法：默认ED25519 ，支持 SM2、CA； + - 公钥存储格式：版本 + 算法标识 + 公私钥原始内容 + 校验码 + - 字符编码方式：Base64 + - 地址 + - 算法 + - 给定公钥 P （或由私钥 R 算出公钥 P） + - 中间值 H1 = SHA256( P ) + - 中间值 H2 = RIPEMD-160( H1 ) + - 中间值 X = 版本 + 公钥算法标识 + H2 + - 校验和 C = 前4字节( SHA256( SHA256( X )) ) + - 地址 Address = Base58( X + C ) + +### 2. 区块 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
属性名称说明
BlockHash当前区块 hash对区块中除此之外的其它所有属性一起进行哈希运算生成
BlockVersion 区块版本表示区块-交易的属性结构的版本号；
PreviousBlockHash上一区块 hash
BlockNumber区块高度区块高度是一个区块在链中的序号；
创始区块的高度为 0，每个新区块的高度依次递增；
AccountHash账户树hash账户的 Merkle Tree 根的 hash
AccountCount账户数量区块生成时账本中的全部账户的总数
TxTreeHash交易树 hash本区块的交易集合的 Merkle Tree 根的 hash
TxCount区块交易数量当前区块包含的交易的数量；
TxTotalCount账本交易总数截止到当前区块为止当前账本的所有交易的总数量；
CloseTime区块关闭时间生成当前区块时的区块链节点的网络时间；
+ +### 3. 交易 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
属性名称说明
Hash当前交易 hash对交易中除此之外的其它所有属性一起进行哈希运算生成
LedgerNumber区块高度交易被包含的区块高度
BlobHash交易数据块hash交易的数据块是交易的原始数据，包含客户端提交的交易的全部操作及其参数； +
交易的参与者需要使用私钥对交易数据块进行签名；
Operations操作列表交易的操作列表；
Sponsor交易发起人交易发起人的账户地址；
SequenceNumber交易序号交易序号记录了一个特定的发起人的交易的顺序号，等同于该发起人历史上发起的交易的总数；
Signatures签名列表由交易发起人和其它参与者对交易数据块的签名的列表；
Result交易结果0 - 表示执行成功；非零表示执行失败；
注：最终的账本只包含成功的交易;
+ +### 4. 操作 + + + + + + + + + + + + + + + + + + + + + +
属性名称说明
OpType操作类型 + 一级操作类型包括：注册账户、配置权限、写入键值数据、写入对象数据、定义合约代码、调用合约代码；
+ “键值数据写入”操作的子操作类型包括：填入键值、移除键、数值增加、数值减少；
+ “对象数据写入”操作的自操作类型包括：插入对象、更新对象、移除对象； +
Args参数列表与操作类型相对应的参数列表；
SubOps子操作列表“子操作”是“操作”的递归定义，由“操作类型”来标识；
+ +### 5. 账户 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
属性名称说明
Address地址账户的唯一标识
RegNumber注册号账户被注册到区块链的区块高度；
TxSquenceNumber交易序列号由账户发起的交易的序列号，初始为 0，账户每发起一个交易则增加1；
ModelVersion账户模型版本表示构成一个账户结构的属性模型的程序版本号；
Version账户版本初始为 0，对账户的每一次变更(包括对权限设置、状态和合约代码的变更)都会使账户状态版本增加 1 ；
注：交易序号的改变不会导致账户版本的增加；
PrivilegeHash权限 hash权限树的根hash；
PrivilegeVersion权限版本初始为 0， 每次对权限的变更都导致版本号加 1；
StateType状态类型账户的状态类型有3种：空类型(NIL)；键值类型；对象类型；
StateVersion状态版本账户的状态类型有3种：空类型(NIL)；键值类型；对象类型；
StateHash状态哈希数据状态的 merkle tree 的根hash；
CodeHash合约代码哈希由“账户地址+合约代码版本号+合约代码内容”生成的哈希；
CodeVersion代码版本初始为 0，每次对代码的变更都使版本加 1 ；
+ +## 五、编程接口 + +### 1. 服务连接 + + +```java + //创建服务代理 + public static BlockchainKeyPair CLIENT_CERT = BlockchainKeyGenerator.getInstance().generate(); + final String GATEWAY_IP = "127.0.0.1"; + final int GATEWAY_PORT = 80; + final boolean SECURE = false; + GatewayServiceFactory serviceFactory = GatewayServiceFactory.connect(GATEWAY_IP, GATEWAY_PORT, SECURE, + CLIENT_CERT); + // 创建服务代理； + BlockchainService service = serviceFactory.getBlockchainService(); +``` + + +### 2. 用户注册 + + +```java + // 创建服务代理； + BlockchainService service = serviceFactory.getBlockchainService(); + // 在本地定义注册账号的 TX； + TransactionTemplate txTemp = service.newTransaction(ledgerHash); + SignatureFunction signatureFunction = asymmetricCryptography.getSignatureFunction(CryptoAlgorithm.ED25519); + CryptoKeyPair cryptoKeyPair = signatureFunction.generateKeyPair(); + BlockchainKeyPair user = new BlockchainKeyPair(cryptoKeyPair.getPubKey(), cryptoKeyPair.getPrivKey()); + + txTemp.users().register(user.getIdentity()); + + // TX 准备就绪； + PreparedTransaction prepTx = txTemp.prepare(); + // 使用私钥进行签名； + CryptoKeyPair keyPair = getSponsorKey(); + prepTx.sign(keyPair); + + // 提交交易； + prepTx.commit(); +``` + + +### 3. 数据账户注册 + + +```java + // 创建服务代理； + BlockchainService service = serviceFactory.getBlockchainService(); + // 在本地定义注册账号的 TX； + TransactionTemplate txTemp = service.newTransaction(ledgerHash); + SignatureFunction signatureFunction = asymmetricCryptography.getSignatureFunction(CryptoAlgorithm.ED25519); + CryptoKeyPair cryptoKeyPair = signatureFunction.generateKeyPair(); + BlockchainKeyPair dataAccount = new BlockchainKeyPair(cryptoKeyPair.getPubKey(), cryptoKeyPair.getPrivKey()); + + txTemp.dataAccounts().register(dataAccount.getIdentity()); + + // TX 准备就绪； + PreparedTransaction prepTx = txTemp.prepare(); + // 使用私钥进行签名； + CryptoKeyPair keyPair = getSponsorKey(); + prepTx.sign(keyPair); + + // 提交交易； + prepTx.commit(); +``` + +### 4. 写入数据 + +```java + // 创建服务代理； + BlockchainService service = serviceFactory.getBlockchainService(); + + HashDigest ledgerHash = getLedgerHash(); + // 在本地定义注册账号的 TX； + TransactionTemplate txTemp = service.newTransaction(ledgerHash); + + // -------------------------------------- + // 将商品信息写入到指定的账户中； + // 对象将被序列化为 JSON 形式存储，并基于 JSON 结构建立查询索引； + String commodityDataAccount = "GGhhreGeasdfasfUUfehf9932lkae99ds66jf=="; + Commodity commodity1 = new Commodity(); + txTemp.dataAccount(commodityDataAccount).set("ASSET_CODE", commodity1.getCode().getBytes(), -1); + + // TX 准备就绪； + PreparedTransaction prepTx = txTemp.prepare(); + + String txHash = ByteArray.toBase64(prepTx.getHash().toBytes()); + // 使用私钥进行签名； + CryptoKeyPair keyPair = getSponsorKey(); + prepTx.sign(keyPair); + + // 提交交易； + prepTx.commit(); +``` + + +### 5. 查询数据 + +> 注：详细的查询可参考模块sdk-samples中SDK_GateWay_Query_Test_相关测试用例 + +```java + // 创建服务代理； + BlockchainService service = serviceFactory.getBlockchainService(); + + // 查询区块信息； + // 区块高度； + long ledgerNumber = service.getLedger(LEDGER_HASH).getLatestBlockHeight(); + // 最新区块； + LedgerBlock latestBlock = service.getBlock(LEDGER_HASH, ledgerNumber); + // 区块中的交易的数量； + long txCount = service.getTransactionCount(LEDGER_HASH, latestBlock.getHash()); + // 获取交易列表； + LedgerTransaction[] txList = service.getTransactions(LEDGER_HASH, ledgerNumber, 0, 100); + // 遍历交易列表 + for (LedgerTransaction ledgerTransaction : txList) { + TransactionContent txContent = ledgerTransaction.getTransactionContent(); + Operation[] operations = txContent.getOperations(); + if (operations != null && operations.length > 0) { + for (Operation operation : operations) { + operation = ClientOperationUtil.read(operation); + // 操作类型：数据账户注册操作 + if (operation instanceof DataAccountRegisterOperation) { + DataAccountRegisterOperation daro = (DataAccountRegisterOperation) operation; + BlockchainIdentity blockchainIdentity = daro.getAccountID(); + } + // 操作类型：用户注册操作 + else if (operation instanceof UserRegisterOperation) { + UserRegisterOperation uro = (UserRegisterOperation) operation; + BlockchainIdentity blockchainIdentity = uro.getUserID(); + } + // 操作类型：账本注册操作 + else if (operation instanceof LedgerInitOperation) { + + LedgerInitOperation ledgerInitOperation = (LedgerInitOperation)operation; + LedgerInitSetting ledgerInitSetting = ledgerInitOperation.getInitSetting(); + + ParticipantNode[] participantNodes = ledgerInitSetting.getConsensusParticipants(); + } + // 操作类型：合约发布操作 + else if (operation instanceof ContractCodeDeployOperation) { + ContractCodeDeployOperation ccdo = (ContractCodeDeployOperation) operation; + BlockchainIdentity blockchainIdentity = ccdo.getContractID(); + } + // 操作类型：合约执行操作 + else if (operation instanceof ContractEventSendOperation) { + ContractEventSendOperation ceso = (ContractEventSendOperation) operation; + } + // 操作类型：KV存储操作 + else if (operation instanceof DataAccountKVSetOperation) { + DataAccountKVSetOperation.KVWriteEntry[] kvWriteEntries = + ((DataAccountKVSetOperation) operation).getWriteSet(); + if (kvWriteEntries != null && kvWriteEntries.length > 0) { + for (DataAccountKVSetOperation.KVWriteEntry kvWriteEntry : kvWriteEntries) { + BytesValue bytesValue = kvWriteEntry.getValue(); + DataType dataType = bytesValue.getType(); + Object showVal = ClientOperationUtil.readValueByBytesValue(bytesValue); + System.out.println("writeSet.key=" + kvWriteEntry.getKey()); + System.out.println("writeSet.value=" + showVal); + System.out.println("writeSet.type=" + dataType); + System.out.println("writeSet.version=" + kvWriteEntry.getExpectedVersion()); + } + } + } + } + } + } + + // 根据交易的 hash 获得交易；注：客户端生成 PrepareTransaction 时得到交易hash； + HashDigest txHash = txList[0].getTransactionContent().getHash(); + Transaction tx = service.getTransactionByContentHash(LEDGER_HASH, txHash); + // 获取数据； + String commerceAccount = "GGhhreGeasdfasfUUfehf9932lkae99ds66jf=="; + String[] objKeys = new String[] { "x001", "x002" }; + KVDataEntry[] kvData = service.getDataEntries(LEDGER_HASH, commerceAccount, objKeys); + + long payloadVersion = kvData[0].getVersion(); + + // 获取数据账户下所有的KV列表 + KVDataEntry[] kvData = service.getDataEntries(ledgerHash, commerceAccount, 0, 100); + if (kvData != null && kvData.length > 0) { + for (KVDataEntry kvDatum : kvData) { + System.out.println("kvData.key=" + kvDatum.getKey()); + System.out.println("kvData.version=" + kvDatum.getVersion()); + System.out.println("kvData.type=" + kvDatum.getType()); + System.out.println("kvData.value=" + kvDatum.getValue()); + } + } +``` + + +### 6. 合约发布 + + +```java + + // 创建服务代理； + BlockchainService service = serviceFactory.getBlockchainService(); + + // 在本地定义TX模板 + TransactionTemplate txTemp = service.newTransaction(ledgerHash); + + // 合约内容读取 + byte[] contractBytes = FileUtils.readBytes(new File(CONTRACT_FILE)); + + // 生成用户 + BlockchainIdentityData blockchainIdentity = new BlockchainIdentityData(getSponsorKey().getPubKey()); + + // 发布合约 + txTemp.contracts().deploy(blockchainIdentity, contractBytes); + + // TX 准备就绪； + PreparedTransaction prepTx = txTemp.prepare(); + + // 使用私钥进行签名； + CryptoKeyPair keyPair = getSponsorKey(); + + prepTx.sign(keyPair); + + // 提交交易； + TransactionResponse transactionResponse = prepTx.commit(); + + assertTrue(transactionResponse.isSuccess()); + + // 打印合约地址 + System.out.println(blockchainIdentity.getAddress().toBase58()); + +``` + +### 7. 合约执行 + +```java + + // 创建服务代理； + BlockchainService service = serviceFactory.getBlockchainService(); + + // 在本地定义TX模板 + TransactionTemplate txTemp = service.newTransaction(ledgerHash); + + // 合约地址 + String contractAddressBase58 = ""; + + // 使用接口方式调用合约 + TransferContract transferContract = txTpl.contract(contractAddress, TransferContract.class); + + // 使用decode方式调用合约内部方法（create方法） + // 返回GenericValueHolder可通过get方法获取结果，但get方法需要在commit调用后执行 + GenericValueHolder result = ContractReturnValue.decode(transferContract.create(address, account, money)); + + PreparedTransaction ptx = txTpl.prepare(); + + ptx.sign(adminKey); + + TransactionResponse transactionResponse = ptx.commit(); + + String cotractExecResult = result.get(); + + // TransactionResponse也提供了可供查询结果的接口 + OperationResult[] operationResults = transactionResponse.getOperationResults(); + + // 通过OperationResult获取结果 + for (int i = 0; i < operationResults.length; i++) { + OperationResult opResult = operationResults[i]; + System.out.printf("Operation[%s].result = %s \r\n", + opResult.getIndex(), BytesValueEncoding.decode(opResult.getResult())); + } + + +``` \ No newline at end of file diff --git a/docs/images/deployment.jpg b/docs/images/deployment.jpg new file mode 100644 index 0000000000000000000000000000000000000000..aec66f03d653931de983a14f49dc902983121449 GIT binary patch literal 131011 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 z zVc3?rI+cFnz?g&-mOZpOSo?WD@;wZCE#}o>&-tJPxUcRPecXlb>G5CBtto;@Rp2^9 z6ufWjLvTxXpk{HVA6)?NzObWoKb*r(Nk`n7^z*!4QC}#ocm>iFKUa_C`O}yL!Lv8? zzON9y&Idpu%*ZdorBkd{#y$UubMqVQt9u2;lh|fW#DvKSpRkXVMO9}lwyaq zM|q*FMzWZNv-vYn?A`&3tF}=kuWcPK0gNN!JC?_``auj3y7 z;D`4Qqi%cm82cH{z&yB#^V@AehZJpd+Gqvs4HHgy&O9lG+(veN;D%_6Nu8$j?$^uB zb6ilArkIeQ)TtxILH`bz(iR#y%Wr^Ledj~i9*jZ0yb(!wfc;df1RtVcvnrhCL6n!~ zeNCsHaQzVBp3dL%r#&m)r>b7~d7a9ucf$D_#9_{!s}u0XXK*2TX?Ka}#sqgR|0QMk z0CCnZ!s(l*q^>?o+ZqVn10XTsEDc(@6cb?fih$YsI42pqfza~qu^lze^(HqfZo7tG zC#o}V*TzAoh*`4#IwYqrcW&TC#O;1p$xO1;`g0}#DnqLt8NlxRbx|r`&XL+rI`X7Q z{l{n5d#i@^hkI&V@rl}4@u(Q(X$@kE$wx5DYN~J&FAFi0lhVKjj)uu zpJAKIm#i>+f7#r*K5FTEhqWn-gUk~oJetXod8(|$qsEYjYa&hv%s@7%4qYHJT=D}R zHo%iYiagmGH;C$b&a1osKx$p#VIZipKWKIZJBi=?$~q0perQ+l51zw+IZD{_&g^F= z8iHeetMhs+o_mLnHk75>a@Dx3~)C>54bvk4yzZNm{xz((IT<}5je7L zD!^xjn>`IY@G@nDXY7evm}USF=g*S;L)re}N8FyjCWMg9Q99r^$o-*IpI3rSFM&hK zU{9Uo_QQ*!gh~64@+?!+_iK60ylmY-0Qd=VS_;F}h1aLvAeY#2@3{b#-aY%^#*w{L zz;zV;>Siiomz;2%%UdsM&=cOLN+tpz^)XumkiPVb87q+x8KqoT2s7-4EIEIIvZf}s zb0jBlO`!_P!QAc}U2wubR16+E#<;x(5Q*hg@KGu208!q>PoX+qhp7cX*mG|B(oOvF z_R9}ETxECR_2&ZgI@ph+%dE0@f^P|R5rFU>? z*voP=?&5lpM0??%Q&w3z9oy_fTX#wRB8%dX}vq^8+;=fV`N5CN}C^_ z!{!MZR9&{~?&kJNh+Ld?t^3S#EL2V&m`T@AjJk5aT47$CvicYdpl7~v?*xY4z?7Rv z$pqyu&!<#!j{qnqP`zvGkFM7SsSbIX+7f1u#L-}+rmqSzLF%5{Z`-N+aKrpNRMpIT zVTBgj3>kSFf8m6TdT9BjD3dMg{CV)H{s%P271(L$YJ3qQGRfzPY84s!G#{sQQg%r( zS$B;4ldnW&zUMgl=+tA(*jXLsD1Q8;Brf;u^y0Sn&Ej@MyxST%&)GUkW`SwV?3-+> zcP}`7Bb?Q5VZ7WMi;5m5lQLY#n2WnTfT6`y$7&OKFKYJKEe~r>tyemSd)X3#e>$F& zfP(9mkDwcO<=jk3Hp;_N;8tWy%v?( z>|Pb4)?@)JOVb)hcp=k9^XG3Ab*PAG>J!h#eIBi$b-JRqQqQqCKezw=^NT^31EgD~4l!Jt;`tM5 zV-3^|w6pJgfRKa{!B1XRcPVftwsSb2@-AP1!cdP^b;VTD{qPEfqcO=9ctW*^|G--R zUXbLTX5!=(ea5w85!B2hw`N1l1?tlX)sg<->(IVM^pxFGQVNe%0x-%h2C|n!CT_Vk zqVIoUwtxSe|IIlb`ocm}NKqWG9nC9AjuYu=HS&$f!HX%yD%nKAFPmPc)zWhxlWZqF z|Dc-}E!fErcLdJGyA_usEz}4j5Z;;p7~j)SBDQ-g`clRklYpf6X06mbOnrQ1)S~^g zu)N|kf)qcX)j}DKN=R5=O2^}O*5~O6WGLuTD%V+gZ?#Nd!9mG^zHSJ1ELAW=Fb*sx z&ots*o9S{yT#)2AD)OwqlTsT0|Ik{2smixaZ(7`D`DuhWrhr<4->@hv75?-I&+XT< zv}bw$LOx*%-U~OMEEi1bFMd?wG_*K$FBsNYswVsfFO(<-QAp**<0J!|s<68gdHOP& z#SQ?${}Z8T2;XIT}(^jZ-0Ym5E|4i58~1L<#9(? zB5Ks$g~MV?@Hr<;hwPA&#zCS2Q023$1+SmOBY@tpn`cYN=Ci(S zlEd8PFWMjsUF(8VsZ4m(Y&sNDPzwM2=l0AmIguZ=gPzf+;Z2w}BQ>=!vmRKc3Hf#n zF8Nz`Hdtb`;tMD~kGQT_i~q2GPaZQaZjNNWo9(l!czhhcG?RY$^+v(VB~zix87YKK4|<5%E+FY5gdn#N;l?#JPN`|1n; zbGNHuY%PT+RC;2>59M1o_mAC_N9r$mzAoyVpXeN5BzedcKT)>0_( zi@%80ueDp)V4-g`cWB;CFrB4LO#|5e9*H8s?Ny&GQwN$QO|T7~B%~xt@<<^)FD7z} zM3eJYeDmF&pa=KXEZCo=GOt?uJ8o*@W~_C7wk#_D&Y8sfQ*AD;FaTdH$;C^*dJ1{y zd9OD3hQS%Ea*wyAPOOS=Q^a$WWg8lp`Ka=JHR^0Ji-AU_LNH^gJ;lqQe)Cm|Mu6+= z2Q;+(*bnd z=wTNADP(dO$YCQS?elewrpiZDzd7Ka%^H48{IT9FHi+^?I|CuFq77$4h2l)Vl|@>z z=Tqs4ZnAPtm4B3liSlMe8HhE=6`1Jb6|tp3>QC!d2f&ib<&X{NEa9Ne@mVSN;$ZIF z*=ly&z=U-23(?I*W$H(?o$pLs<+rddc_Rg!-^(f=vlXbDUO zoLN7=2G36Qz&1_#<^hor(H2Htv3bvABWI>lP|y8jnQSS&$lHx~HGD&_g`a?I^fBF> zSBiDM&&Gr%7fNxDx4w!f;G@T86qZWkauYf3^5e38ynVqtTd6qTN!kOL2tYo%V#xfs z%1yhnmI#85R_d|wRmt{<^>Sk4q!H3LU|kdYuXOpJ@t-F{+dODTSKJjA`rhbG<0JYh zd2>#Oy*EXiJWC~Xg6qYaRxT(oEWYP9G~vuK$1gi{1kJz|Zk!YsCHd4A;+U+& zscnZ8x#Z{L+bQTr7olT`=xl@@BSe8pu?AZ%-p_7=9MS8rpM09JeIa0Oa6BgP`NuL`DKuSj2wXf6{8IL7Ii;>p{$xi}FglAwQQNI38Qio>I}RO1SsmWu8q zFuCZ)+U_~8OCf1x8EK)zOhV+MEPi%A1S;rwOvDR znao8W>q?~eVx?_?fn8y-B$wz`5@YSH*2)sz7X9kehSFUPmWaVpyz*K>ua5d9m3*<)P{GfQErZeS+sq>P)t&E0~f@YO5F zF&SfZs6^LUeX3M7qkI=`w!Beq^$F-;uJTa$0Ts-;H_UDyiLT>^Jc5k-ZY^cjqUEn>Kf8Wok5`=RPgtVjlBG#Nibirm%NC^~I7~Co~WRf>T?VO7% zG1^D1Wpv;!N`FX=ji{LT8fm*9 zrM{)t#d>Z130TTSJ$?3 zB%UlgV5cmcM_BdR%(yYWc>m%H?y6SX3C80Bul-J^PBWsc@vm7P`qMSDzDu6XAyn;Ln(6}^(g=H7ZD3k=@s2GBk+eqjvu9NS7W z(x^eIdZq2@qBhGern~3+0$LIV2=iaH`2j;y4X04CrUq<(qrwPJd#)4ST6N_OuX@X-&wZDqmYQ;nNykean^{)%f}yaFIpmum66f59bNL@v2Q zxznILkT=fnlGD8HZj__S8+g(s)e4ww7ZMV3YK*c)jT({--+n*0PCI;STjF$a^6Qg; z6VLD_;1olGv8`J?@v~!ZUwC|oC1fILBW>WLLWL`Zj!!Sc$Yt)K?9qLb6es@se#rZe zkR7wStSq3iK1l$WS`W~f>Av5nx5Vfo4h>gl45+UrwXi#7xB#!|Hk&c1*g8t8nW_|% zYX@#!S`xI+dQ_2Hnvfe1nI`({w^mR5C{3bDkfzb1ipY#m5P$K5BE+TC(@oaBh_;`g zsKnq|wdkvXr1RUtf*22z-b)d~SG~fY^|Y-Q^x?NSO&JNfRLOeu-hY7_e?Q{&UTt>D zF7LAmdKq$$kClZ|KE>n#f4R7MUNxcemhUG>I&c~D`>R3ZEmOokA=DLg4b`c{P7!AG ziyXn?;`O&0BVX<@1u;5{-K35r&VR0p&>wBAPwapDAU#MdD!_5`Z98=B{H&e<5is0Y zb1lWwo|k~<3|QM6KN?`rl^odi>9)ea+Z3TZ?u>&Ui%U)%)`5x3iR)_XT(#j-N z_Gb9O4Ih5Z!DokLZm{!!- zc9IiMu>y=SjQP1m+FI$DtRDCE{La^Fh;&U%{6#WtZSodGD1N& zC~L*R!Caw5>xDrNhpj3o{^loj#JPcYxBgdCtitVa*zt4`$wPpkFF^cap#9}K*9)iX65BfuMy-(q$(OzL5fTqsI}AH6S%Qx5 z+Y`R29%Bibf1bG`sF5#=g_1}f!gQQp<`F1rC##eAMBL1#Mm<6yQ0;@>ck&5takED{ z+7gc~w6JWR9g5=oODKOp7!f3pVv1$!p;uSF4)i&#c0eHt4V?@O8)13oqlJLY>zrb z#3~qqm)B_S$9oL@zI)`rz%N+1OnKiy1_-i$<6b|N3S7uM3jMa#p=I%t(#QMx*jqc{ zl$e}b!RpCk`=CT&lf8T@!o%d?(QpxE-!J^ao~upN?MJe9E0)?1R;-buYHySx+w;Fa zDi@+%5vJ>VJw~7SrZP-P=M#re?Cu8A_rZ@3Zf`m*IOgm;@!8YcJ&wimv#k9iLMhs! zwV(=8iq-B%LDs}w}jz`$#RPT@SiD44wMgvaZU}9V~fHmA|>_ zR}A4r7e%)J2zdS|T+=StgPSx3yJn&h2cUrx%O51#+EGat!kG!a<{%Gh#tczcfh=aO z3N`#y#+Ii(neL^HCmK~oKsWH*J}?KPVG9e6+c>qTk5}#Pzmy%p*Z;QQ%sCGc8CUK8 zLHe;PMYw5~q76VbMM~dOv?lzlntx7XW@QrIf$BAm@5U=+BRF~KvuCx>U5eXdYs~_& z&5M6w0`&9>%^X)m(gE_Nf69X%?z~N9)7bkLS8=5}i$e}&b8|YCuTlNN-ZA$qPb{J8 znG;(F*oUDm=|kPgDw*xfZ21@HW1U`vxnYB~3+-I&(C%hHRJq$O(3 zJ=@yk1f$##?qrSj`hoh{1%0Xx^fdPk!niaV+o+BgDfU_BfE}>b#{*!iwuG4SB za?$u=nmzez=j??$8bEh3Fxyl%m})VB3VA=*Hyu(CxY0GH7`O#B|1 z^Pw7*h;2_&s~+uD$z`j6-ek~OyVyV}17 z>?|*G{RW3+dPt>nNxo$ng%xWaS0^M$`EczrY}O`IkEhLEVq3cr(4gHs_t};kqnQwT zV(XqO66Bh17NslPk#zxSELrR2xacZ|uD0yETmQh)6A9tsWq;cNo}Ty|NjPz{?AXP( zFG_~G`%}mS-|NCgd?qnf&{2+uJuqvLUE1WBA!X#VHd7&XNEDlDjlu%EmdkwHtaV7` z5>`jn+eK|z1ItB0r%MP9POX)G7ez9sSdhBE%CS|peVUy1)|+FkhL?wuqdW&-M!wyt zu>{b>@cAK@xow9XPk?!~BPLOLB+2)7QX@4#!LzmO4_5@*$N1^_=4Ff9zlsS|l4;{h zd`OJdDC*S?($*rn`pr}Qi)i$TW_3*kcnUMOe|-=L<~1l{k-mP-NT0lz%nWVaID|}9 z4UiwoHqXHGhaB-%rM|k=C`#&-tx>3mB3^B(Mvks&l@Cw4KU$dP{*j7Z&)6nVB7jDI zS8!0VMr2VHMD|i)EadF+BFEK2WLQCJQ8>;@!M$v;Hd(L@e^$Q1^rpp+yKwijgY;%a z@@@PY&2kc-+VTl=nL8Z}{>6nRb~3WqxBBam^$(^b&jOvPN1g(S1oe@fNKL*k>OVZy z9I0WdvB7XDlfZ4qlbQKITzvY%I}w_-EGj1(Jjw*XxCiG&nW)(|E?5(Q)aeSa;V3x?NpK->Uwt|6a>(EBNl&*2j-N*4e?ClDO=zLRfL5ORBbERx_O& z4NHDVcg#w^K@Q-JiSNe1ON!(3Ja_}eskth}A(nIMuPgxi$~$*z-iIi4T$;Tt5U#{jR4H3ui=+_(k8UR-yrlG zat|O4d2Qxf_@iu9)0wMveAFy!?Au_1JAqWiN#v<|B!3Ebc%Em{2je`LwqA9rwUMpa zrzy+@B&PmE+e)uHn2GWTiEgdm#^}wE`E1TlGiO55sKB9PsxHfH(+im0<5AH_e|C{& z4l%qbKAO~qTiZkOsO-5Qr&HRaXl~qJtprgp0E^IIjFp% z4+ou48iq!9Y5|$uzpW!0${|0;HZ+$E4PF6Q6~lGCTD3b|w_uB#==^9^}hHB_~j7<*EQ%ZK!vu{85N4nWJsks zzd8Jh{#xyy$*OHnXKfXFIdqy= zp;tT<_LB7=+fN=xRwJbMo9S~gq!w<1TNc688$>hkdMj~R*uR2Hh8x{SW;SBGw97PdgNAK>KBm1(7PwJOPX2gz*iiK^g>_#Yaz<7*UR4~>Z%p+m1;By(sHDNS* zfj__Gvua?HuD&t=1BU+-+W)WUKkypaMMH44nTt8~3giAWbA~W;5@3bl$=0$AbYUn0 z7C-bGB8_{JGoihNcjm9nvZewIJ6W`6hum$dFGjc`t8EGwD=~blhHjAhuEUP=Z%HHJ ztrCcP1`RZAhGF$EvcoFm+~?l#|P zL&PIYZxUpqA_YXU`@){X@T(7nCb4Oxc{#E9D3U+mmt=~@URVlh<1`+Kv^)6IoTki_ zC`&jEl4(IR(Nq-}X{MCvaU)@Q*@ccjaz&_v?m7V;B#zEKD)?Ag;(iUz^r@K(7YM`c zdQW7PB!*S1_KL&aJrOrG;E5oya2E8Cb5WhpZe1v5p{)6cDwz%;WArlqYmxi=F<&cy zy15BLA-Ik$*&I}fv4L^T?U2{o_q@vL&4;RXx!~zv>CP1Wqeg8y8Rvii%JaWPprS8C z=VUGruiqevvZpkZch}HGu;<#2yxw?rtv@urn2JN!(8638@*OOebdPH`3CY!zu<#c| z>hA*NZc*p_`7RB_9eEvng=4pX=%wl*6#w(xq2^i`>zN_(EWu=O{PA-nWylsII^9Be zjRw^W0v3e1thI}<2RwF~S8PejS6k=c>NALHWH@9*kz;1b@|ndXI<7w4?LaeJI8GR8 zY_xcE>EoQNG!X1njn$hYR{eM+e{f3XZs`K5sR|`snedE?5;1$Fu8-d_#>XrF3#I3O zqWt{(-_-=2v)mOf=q$3{3ulf|Zj`8EL2(v_P)cZm*-k_2kZ=+Hxhsu$84VMenkPRI z(MC=|(jjtN)o&1%Bu`YF4WRy^7X8<`$m#B&awJoOGZ1mbT+Voi@O(>6t7j)7 zs_WGm8$QPHG0g{u^^dCtMQcl0J*qUF3jSGc;9|hjw@1 z214FRHSrttjo5CbiOc-GWd?d-Wp0Vx)N#?mJrE(%#ieh7F$I>g-j4w~sMNXCUpGr@ zQWwd;LAUn+KW}Lgs7L31c?h;8XgDw?(_W^K*lC?t$SN~l`Eb}qm8Xgs?=+Y&>N zyJJ+U z0_D+VW`(^2`%fq!!HEnsDU9?BG_EIxNcp-KLwq-@l}e+cGOsLvE<=3OdFijBEeoar z2THl{f4z+!UYA&RwufM|kixSbTzy8>!2w)7=X%_fH4J1%&mBq848nGGRH#S^eCvHZ=P0mx;)$``ppV;R3MOYU1xNWkzK;p9 zcj6S7{gGmzouD02p5={9oyXNWu{wQRg%KW<8#CDzmsBQt3vU=Rn>UAGec`ns5B!sg6u5G1Sf>`+d0gu!?o{1XJ-jD z%ZpG{KTN6SB)FW-9SCGAaoz1tF4+z{MYX%+#KE6bC65HYtdN|0&A1+xt$a+jJ~b=l zUt*;X^fby&1et6iR*Bwon7ww-lo~VnB$~MXB~p|^dvKEb+Wwt+&g9~vpyi^rXx4LS z`moldjRcni{&9J*%jMQ555{AW(wyD$*;&1>E2?sA9ellEN?METb+J3>_^S>}EU{wo zWx408kMe=10;o?{z&(WB*+ zNtf(Ny+PWzWBLj7W0ajE+Sd&)Pgj<*7e;hG z!3R|G{}wR*pM;{KDsif^dif@BN7ry!`*JH&N8P%+Gh)_y$i(HyA zinoj7)v-1+UDezqp}cj!2HhbC<{kJuo$Ha6@Re2o(H4Ec$MD)8t#T{RIn+197YyLp zGRV}_5n>>3M3Fa|<7X0YC_N0h5X=MpOtT`nH4n(?$h6cT;ICX_xMj@G*xtT(!B-=^^#o{D z1pzRd@~5!tWU(IQ0HEdN*rvCcCgH*QXM_oz=w9&tQ+} zY1WN^K8Q0-U$CW-qDUixC_Y0$xsI+-a1Wdd=vN1PH%u9d8=3LtfE-((ydde`U>F$m zD+wCuKH9c^$V$8_)-{4sm!(Z4v+(UG!%j9P;x#KsJEL&Onya*4u;&F~=Y$&d`O~EL z;d9q;Q(HRl)%R5b_%d=d_?h0^RyY!YlC$Knvo7)mq1s5LB}4+W6{ax(;=nVD}{BVfKmeU zCTpI)ZoN0C8ypVs6c*W+wM8r6KRI|yYCrw(#lXcXcHjn}QqKzo+xZ(QO0Baiby(Vx zdZpZGsoG1v0o{u~%uq3R;|Zi*aOSfak%p3Rv9@cdZ$|7brYK*| z(guLPNQy38t$|}8XzX*XWpC1zBtf_cQLD1~`z-q@i|Qc>KUHIdB{3+nKj95sCCs`O z3aWb3Mfmn&Zwq_jlZ?BR_0tW?dGKW5yKqcekgOG+X!5?O&bHet~b~zZaKgFx3_iGY>Hus+cxp- zOs-Xx?l#ZEB!!Kr8mLFx_>wU<#}czo>&W$SZSIy(Hop3{jT26F_v##h2{-QK#F2S zin)2NqwzuHfN{^0U4}=>@q^Drt(E4Eb9I)aSo>!A=j@4@1q{8BcZ4OKGVVIp?44rs z{(xHIbGSSexk?}s#$8Wu9<&s3TF6p9h!WuCb|~bHupV#xc7j%j2P` zWEBt*a-@7F^-=aom=R3KwKdHMH2ACFg@+bUt2&`@vih2Qu_p~Sj4(reHw;~*w1ez% zlbaagXdX?Z9{6U`LyB z@_`AREtub@Z1h3K(P&<#*qkVNR%woYAQ5r`Ip&q&<5oc|Err*2(JP@WAtS2B_3|V? zcpc}Ao9PyD2K(Li0s5YRagbR~D^-=3qNDKKj_c&vmW)o~SURKCN8*=WPt`4zYRH>k zlOq8_WnV{!SX-UfW#YtL#KA!A4DTJ)qa4)0gIo!5!|G&O^v_Cx_PFXB>58-BWKCI$ z?H!pCt&w&SDu5Fw5$jo>6JX8x1rb9WP~!cUEq``SfHGr7bVv`UuhK08g!$%u$prGu zi^=RSPhSeXR(AeA=L>WZY=KzlUbX<+mVYlq;-SuobNBPIq-TBMjkWu}5S%)izpJ7A z!}!~r!NUAEKdddN`VB&q1}kf1?;wfkX*mrF=lE*Qr2|(*uybi0_doMyM=OF4^97~M z7-a2xdwBW}gn3Hfslxfd0#6bexqYzi#6lOePHPnXvzkH_iKICI9_CV9e!!-cCdLr<-Ayj#*8UT6!cXZ(YlqLO7ziU#8u6Xiz`NJArP6@1| zQS&dWPoOUWwaDe|6QZ{YKvvIC6!Pd_bLxaWY@YWVxHv#Z3ICAjq({gApWG~Vb&_a8 zrszuv!XEN~tdh>_>Wgo!A$5ilqEMTs|ImRj0F!B^XifllY$nI6J+OYV5}qP=ualpl zLoxy?bvGa7$l5d&bTXQ0<|>sHc&g<6UzELdSXBS|?mx7GlmddpAl==K%Fx|INJ&a} zcXuj7cY{c`(ji^a-O^p-S$_8Z?6dbi-`_dc?~l0_1L$09F|*#!`+4sBb^j0NucW7g z@mWuOo*q3}JMVtrLe#HhufQ+cqV_1{+gIvVE3N=(M86SKUa}p$@>O-6p&O=Ei%J@) zJpJ-M#MXP=n~>3FQffN^qD^qWZ|s&beesct;TQF4j_a4BIrIDTk1_FB_f6AJiPZLo zFYveTc4De7pO0&A&n%wC`M5lI`r!Z2)djdq^7f2Fl+I@S+*npH=d_=9UNowZ&^A$z z_o0h|_9G6C2YQh3jj~6!a?KBwhkao7+u2=DIQO7wB6mV!Oz{PyQV~?B4uAY;UNr0@ zcUZ%`0-=A(+b-5Ajpjz~^V*l3&>uD8jC~XrCVUit?_-^_ubxy-7AwH5PxRz99GvXb z+3X>8+iEJ!=Q+i#2W)M=3(G|0eJEa75v$RWOXyt;c^j{ZgrxUUh)BF=E~fm^Oh#V6 zU#B&iP!l_uXfOWJ>P^jMhKevnzpgZ~6j7(4g23i)kj%s0zFb=<2 z9%SWkSASXW`N$YI^`Oah8}oxO@qXtRd{R!F)>K)*p-3sU)5MLyy*1OT;34_Wz0Tet zGkzS)o#xN`Q21c33GNz3&v9y94bOMEMG=#UuZIpul9djN8`(1iipy2 z5qEXi`BC>Z0m-|@PMSCvdBYy*0hY2n!^g|_?mYi{^0a+h^-KzeNl1^yUF?0v)JMn@{QzA@og$$;Nhee1Rq4ew8ls2VZ6t#Qk+c`b#e1-14c_%m0 z4rD+Nn;4u*g?vcXcLyG6xUfb4x%V2%_b_n!V|3s_n6ZF8Rz}HBLncVIEh_m*kta^y z6Vg(ZKv$Yo1cDMTDoi*+?WnY5!0E z*5B*X-$(UKe$2!2_~LI&UwOR?6v3aNb#fMJ_EYz2G;1v&dc31w+PS6fqf5mvqy#sW z?X?;tGA`vFALzp>^8zP?wyb>T05WUec}qHWL+72~{9vFU-ZDD;OA zOPkG_wl%&fL%ikrmf4Lsd~+g-KA9Ww{ELi&_}^__dZJ{UmM`kc3DVyX6C}0rEJy=# zqY^yPv&(3T-!^4pC{NJnMblRPI*-Xry;J$v*n8LJAGsfjD@~ojoD5Sj!t{#Z8q3ZZ=r{bej${6wk!58>GuN$OUSge>VoIRi*Y zAOE;aedmnsS?9jMHQ1vM|HOL(TMKn7PeNwhR`D*}z`y)`9P%79+E7VtSN4JK5wuNA zBo<|*MW}>R#MjW*3Xs_ka7Y-lQGIj*`FEYfrnwFkb6jqG6=seZB8_+2uJrvsMkF`o z1=c&4_r=b_F%V)?G~RET6PZQ?&39Y-42PUmN7;UayAN|L_hM+W;@C-jU!vqar|~B+ zFSRX%4lqg$v2646rG6WofT-Du?`>8`1j=H`&e& zm9Gy_rm~`0o8;sN$8#arM3jkS**emu(#6%YpA8O*l3POR!ViO+Ft_|rk-ms#I{w)M z9sbI$Gc^wk=t6UfTKNHsu5Hmw>etZgKKkorxt=vih&x(f{#2%OY$%)~@{PxqA@Eg4OrpT zA0UOC%@THf5%LU#$y)JQySj__9<}5H_RcX14~DEOy{fcr>rXDOzLj2Pd$5%45#ro- z^S@vBS!P6tpjK`J8@Vmh4!;X+mV=}6_aYsgL8>SzLSGL}!`l~Pk!tGNwFg$=atTi{ z$XfoGxcN$`Ya`4FUSe0@Mnd^q+ zxw|>&{uL{(gra9F|4FSOfKD4P|KK(AF3`4kHCL*sIdg?U@(H_IuM;Wi%<_=Gi7)@J zu^Ef$%-a7rHsdgWJ_Qj`OM#O`(iri=e>$tv_>oU;xYZ76ZKCKIN*H+JplBB}6k)7(H!eJmGVXRO zi*W9kDbEyJgaLr#sDHNdI=opiWgDtz)1YQN+24pNTFw`-WVzNm9P6Rv=8Gw0W&OT0}mECSK~+Kfm7~;FFf8zyEcvv~EEs z83PL#A5 z7;?5(d06;m(I`puB%{>l!`?-Y#fnAB6_nS%;$o`RQ|dBoQ`I3z3hAYhmVt4i7%4&g z250es>K?BL_feKx{cn&(1pieclY1`&8%?;3wv&u)+SwOpzy1?c?>8upWss61TSx5W zkqEZ#qsR2n&wSCB7XxqDqbyVcZdOSjIn`R3eF+jbY;i3#ON2CeXW`EEhDKjs>+ZM! zELs2ms`(JvzX4cO@q4U^te$ZVh}(>@<4! zOElSTC3W9B{}7UB52d=ez`l8RdHx&3R+e?Yoe0Ne#qk}Z*@54dYBtRJ+B5^H%*}~TNVX&bR5(0(9*px;Z+~aLO5KGoj17CV7nIw;YBC5 zVM25I@)g$6zZ67VE-NhyH8iT7%=jH4F3m2JUHwCQ{wrnZb4CXwc3=S3PXTk!Sk*00fYmSa3-hf+ouI!`Gia_k!f#H*j ztt3DoCR{y-_JMMbl1@)PAb}Sx7Hy@#iD!L( z6**R^DVU zzO>9@_V(fqwCp=v&^}j2t1({ zCp{m7oUMi2gL8gs{gJ`>ncnU0MR!+*AMduL3Hg38($fG$4N4bD)wn@B3CsN*IF$hH zqXRHyd0Wmg9W`B$6Es~=6o0S`ZcaInsDqiYQqpM0dd!kCW}Q?6d&%g6Rd8 z10Btv6%HGzO(PH~hyB9sY_;@#c+Jn;^xWWvhPEvZ8?+7=8=GtA0 z1%0k5$6}#R1)`1hC!H|(jxGh`k)KOZKzZM;R&mQpE6l-<+D#X5&wJ+Vv`6CE7Bfu7>ST3c#jMolEpYK@|Lc2I6 zZJC~jH~iQ@uk1pRToWUUJF3nT{8MdpuOb}iHa|$5)GWDUlx*6bJseX%R4k{RHe43_ z(CNxspPZ|ib6_AxhY90nh(BV9zS=E!I$*S>neTmK%o9%$q?a9lMh*ZdK;^It*7c&X zcdXk5pIgoyc#@eLz|fgW9`G%bEBFfO{UfQmmuT7kOA*lQv1v>4kwL%O{z zxIlO*TNW94YZM|F8N6&A$V#n-B?emcfCYBJW)s&BFh~WprnzMq8#iBy+J^Tf?Q@hD zBpC}u`Cb+yP3%?)pLhxMh0!)mv0e^UTYo4XBHT3}W^)Z~L(Tt@|f`w#EPZ5f_Il4?+ouf>lukw*^1D zzq=@mSDBN3BKSyORKVw2$o)DTVlQvjCnLAh1`?!f<2#Nf5M#rBn_2r~f}NU8y4M_W zlNV78KMeC>-=iP7q<^0gvTV!E=5unOmdgA`)!mIBTg3R@@{>S%>e(dE)gXi|`(gMd z{ucdbZlWd&$Cf-x&fn7u`ma*ekO>i&;(>1i4<(;o6x7m44uJd+qky^`>9n*O+BTKD zea54qdfzC!rMl?RFt*Ew5%az%hP63KV5%z39?`fpe1->=yJ|F0RI zw2xjjJ+!*tyyrdRgVzbG2h43uu~a@KHhqGJl?U3n9YfWO^xf#3gtsT&ay!+f74OCG z$4lT<_ERQFp&dt zy=jnR`i3p^4Au>(i~MCqc79HW3XupF#vJW*5y(3-k}`Iie4(x4~qr>APQ{-)lDSaU2p3QP-rPT+wxux2oB6_5#E-a}g z33rp;rYI4*%&O+z`Z?_Wt8K2r(Ms8_g={`|Wni(EMKe$RhgSCIv$&P0y`v|O@{YbI z5eF+5Pg{U;z_i5Ia$giEA)JBPd)kAAXk8un7RXEnel!f{PA?*Gn#c<)^5iTso+T(RYqP;e){u3xUeQ#~7B3qp5jFJ5|K-6ow1KPB~rS+g!9Hf-pPYg0n$j+LY z;;L}6dOD>poFQvjRdDBV_u0Mb?Ty~7%3aTIP>p7WY1@l6TRqu>m+)crP&ftKu z*~6%6ZqUboOTnQ~HrW>Ka7XQQ1nYMBcl`_2P>CwP$#y9e!2S);y4A~I?f^YliS;Jk{ zh2xpGk8RpTKHI*C8o9nsI3E16eZ+3#r|qpTr}m;(Su?y{VlYBKBo}x2u@J(`c8enQ z?hI>7q@cm^7F}v$jeNn8%V8)nMd}KBi1v2kV=5!_DBmf4ZwGKW{|G-NOkO}UX+=+! zmVCeYUf^nN&IT)c9#5U@d)ZDM{7{w0Y+2lcd5XppY9yRc;-j-kEefiN^mkmK0|L1d z1JRr2bZO%kvGqD3E_L;1OBHh8K!HMt!Yvctc~U@0!Sfq*LvIUbX)Xu;l<)1Q2md-C z)V;q$v3P&O27b`v{bd0J&}Gm92^RpeJ+e&NITsC8M@vtzbT29&E*K-qFz_W&A@WUg z$abeji}k%?oHRd}h4{wKV{8K6vF4xOQFVjTQC;+i=#=$9hz(~cs0}c;Nzjp}ls%sn zFCK}45I?Q(|s(Cg{0zFw+PN-Tk>AS z!&|j82T7sH=&Ea99b}b`rN@tkR%mdlSKxmZ7ZlTVjk7 z{jubgF8D$_RtxP%#vQLd0Hl$*wD6+4+|~Qec*Q!d7Q8f3(UE3Iv&WY>=xj(d>J=w- zhmKleyS)fG;4%ei4|RXT5e!`PX4J`3kanVN^;^=`)d`vZ5S=KJN?3_C`7M(|{uL>f zFCOwlyjOk9{7=TOu6lE${M<_t-WEd21Ek$@3ErKAUMn)ykj>he9mXoRw};IHiG_PF z`i!`S8Y>N0g8P8aN!0nk@Ealea!Zfk^ks^fjh6bF&x)jVZH?hj@oQO<1hI?C&InLR zsYU&KZ>oLKGR?jFSe~Dq{o%20K|^q>x;3(glMfR{kz}wYLEh*S0TuuYM^rf<0oo}z zxg0xf>j+~$#x=gDontX{8gNGbLVm^Hx1|-ns;7@UReNCV^)^p`h^hkpo6vYi>5(wn z?Rv`~9nz;)SWSkx7CcZ$&9mp)Vz1+5ZQJ?3fJSv=GTZj+iu|kB4sAN&7qZUfg3?0c z64kiXz0;#&?$?#Q5unZ3U~Wv=E?SwHI=X^PK-k<|A8P!jUqs`(P}WdM*}QOQxIwGt zbX}TGn$w$HK5Lhk!k^Pme3CmPKt^uH;=b5(dJC-w?3rgeaq9MdJA4m}Hh_$P0YlK= z)eQfeUarJa1AmXA(!2y7LA(TpO|&MuV|oM#_8)yFz@eFw+B7fv>T^1xWnc>dt*`}q zuK3=8m}v6brZ#y>5q_$36=iZH?U6(=vD(CE{4g$~VjXw>>u^rB2qj6IXw5dxee=#O^&c+Nj7$kHOnwVj0Ni}{_ z;U_BKpRtl+HzQr@}{H)h{jNzdLx`M!K7t z#_zTtjG+Dq+V4ttAjG{}FZjP?XEFNS|)7QS5 zeW_3A{8|EfW42x)+v6d;HIr|6{<`sOc2GW#Sp4!jpR*ws(9gHk2j(qWy7~{df?ncA zHBe!pZRjf9jIJ5ksXTao1}YzXF|u$8lU*{ZiB@@&S*TurD$b!ZdD-g=@|ikzV6gq4 zGwnamRq9h9)3$l0)Hss0WPyOZZwgnp{F5ueniN|w)!ioGCV9dwFYi=rn4HV;lp1%H z#F&5QqC#f7Rp&Q|j3DdsB5R(KdGEme&LG?RbSvkFx;IHFh}yxl1^nzB5-ao9w(N|`LBoy9Fm+` zetL0^x;9IO$eK?;)HQoel-LslpIzK(W!$)zbdH;h?td0@*7P+~ zgLXT*e@N7E7v&yZ<_~@;&rc<4SIsB?W;>FnOBRm~PR>h{Mj)I3`(tM08S; zu~$u=nH&BKSnsyhPnH{LqB3YsKwWUHh6=?E8zJN3*sED!<;O3ruzuD*>9)UF8mFy6 z|5Y-3pwhPcRf6T+<<^7w5XsjMNY38~iLSquWaJUEPF`^32qZJo%bH|C8mu~Y&HmJ8 zW_pT$YBPOD*oAGdSH@pYAmE!Y?W+5H`1{oTc<*tURgO3@%H;&n7A<|&rp#H%=+)#6 zV}Ss*)eU4|&AqZvb*9N~&O+1Bjd$?IECn>-0lA+5`x(6?YT{3#t#&%TQ~Z?&pg6J|IyF|*Kbt>#Qmc84CS!IAzSKhkD@Rb;f*^!g8E&?w2!dNJ`r;Ka2`P6 zw2bOHV~)r%ovnw;%{=wZr6}Pd6X=@MbR`bzk24e&2V54FHN)PjSHiqym^Joc-i2 zEMXaK%Nd2x?Lf9ZEQT z3;1s5QQnENz@xSuC?wkPfDj!h3`g;Ul~Y9GLJvd9V5pd#w`76DW2z;~cC&;NOnv@W z48;31-E6s1S*E{$pZNvniej@YcgUfQ(0|hT0E=`)~XK@ z*kKJ41YkkW)a|P~Mo5Y^_q>FcyPXut*Sn~Vvy$M4_vR6((h1Ud97o~R7qob)C`u8Uba%X)jP;g4)W5)q-J6fpp=nUwwWbUHdFH`%W|Uh zk59ztzq<>6KWF^!fGlqPE3*(h6FwUAvD2Sl&@Q-*{xd7}-$GURY;n!og<56`)85S< zS~C%{etH&|ylQrX?R8y6e-jQ4FK7Mr@j;@j%a=HbGxN#Z<%D$ zqa=ZyReL2*S$ zUq*T#4!)i=1aTcd(a{wzlD69u4D}W6BJq!5LlIve#WG)Jh?rSXZatGPZ#Q7?FI{5O z%uL-l%f@=K7W)wFWqk=W`3ow|#AZ=rPl~idcp06&-I&+W-M@=B!gYNpnz2JTx=`~r zsNIv0IzQQ;JJRl``4G5S$xg57$tpE7T)k}B@J~nfO;(T+S@ls1anYy#+C15gu4v_L z&)hQs?fsCT!L$%rLP5lo=Xu4X=Zy#$5Y?f zm(|)-w!BE@2OkhLj)H(?w&p~Q{lK;mqs|>8d<~n1m&AqYR8Ar`VBRXQY=3`%w5}^` z!(aC~oAjnjuN~*Hew{w!$&Z4*?l%1$i3q6+4Q;GNoNNMOv<5G1x!F1;|39U+_NO|Edbhh|3j3PyfY>-BMG1i+BX@565%~d z$j2V^Bes4nZuLyLe)AoAe)=YYzsj_?2ydu-U4(e3l(Low4vH4QuNgsMBthSNuq|J* z5D*wJ{Z5^rOt#Khi=!afftUZQ(mFJcVH%(BXqef!o9C5~#8DCY&%s`P(>wHYYsbEq zcRA)2;dS*whKeIA0BmkpQK*5FtEPWKYB9w)!IEi~>VW^Fx6cduytm7r+E}}e@Y2&0 zhiS~!%?wI0I7vXL(%irz{KTg?`zdtfWgk8B1S59wD1L(cFOL^x3R%6s47L-wTfJTb z71C&L)^Cu1JmA{{pM>teTQmJ)Dhz6s%bJPNcHz8R!rpm5+y8CYcGrh(s#Zg*EA>!( zn;u&nK5+O@hP6NM$ymZ%X=Gj)b!cMP&y6XQ7&$gkAmE%c#O*X{JJzaGWMxi3dk0mmO_45>;>p6A7iQcv2%u@kRSx$#`bc$8OCHU5%!2fUCoImmc%R~r7?ixK zLw<>ZP%R(vl#;`f(lhgPO*HA(M==XKEW@{JRk~#%Kl^v4G@+LCl+Wm87-W7dU_;eR zi_lDCv+AsYNf9KeVv5$(?rRmpO0=nIdmz9&Yz)s!;dU|%CsWa z#}4|0*4e9dahEHWcADYsd)7I5-}!zMI^aqzIc7Tg$npxKSf3uv6g)Ijw%tS)`W0rm zyHIy()AYd#=vUlRu}2rTLrJi^)r$JaDEUST7kwuIOZmE0CO{mzm%e6qgJLdy_wH{g zv219r>m2pwhe_z=MELiuGNf2~$_l0(1P9CjBc0t+&flQ@%6st}w>*=(GFzMWH{c|1 zMc>YJ`jNb`h@UV*t$CpJ*$8rl|cTjT#-O~@x28- zX{|hEcybuoXUe;o-9mXLdk9ogO+VGxA9h&4`?Q34d~GTs9qJ7My6QoAvqX6N^a!D4 z<|#0kbz>L-DT!UzX(finNySlCvy^yakgM`J-8KIH55KABV%V13WuZ}*{QF~3mqL61 zp=R%HH0akQNq^a240ds_CJn7kl#nVDS zN2+YZ#8<}!)5=X*SC1f^mnK{VEH!#5k*m_w3p~X=5Qo=q2kx>?%A!c>S=bzYZhhoh z7*?=lm_UuYrp$d*v^;iFMACsK!yY12{reSH!J!`e<+Zy^Yg!d+QhB8K5QaMlipykI zL75=^+Qf8J$m>_ZN+42D8J?d}O7leZR5Bn_EJXP4yWKyZBfX+qOc>95&gPK4>7mX$ zUM~NoA?C$1!-sFLjXv9cbSk@0vEWGBtp8y9m9OP|=4h2=sgNlkG^RCb=d_fEu^5y3 z)$;m`3l(8xr?FmU5YqSS3Xg!ngQ{_GJ z2}O=AfWS)KIc0_Grkgt#bbf@T-$ys~mtCmVV3}V^s84;ITN8IAw3v00(Lw3^!fpBa zq=%AG$oxkrgSI&Nz3QEEaYi%l5KYg<@vDmTO&IA=6IZ6`&pErNv=fQQ>_4BG=B*sR z3#Ft&-*}MTAaY{G-SdEI=a+d5J`3(={IoC;H`2AJs#Ab2W+2sn#3@aW5;I=s_$?cC z(!5;s`AubC=gf($C&}5<#oRD;=~c7z_#TkWiwFy@9`A2pWtb}zBnRUZ&(B5~mVF+I zC0lw(w0T+VC~qu=KAb4epU;&9s?DHxuqaoZX7j+*!4O@-Fd%=dm;}_ z!f-4qVykJ`*1|^rJLdyG-dL&w!20?B^!-Mxtw-YxHmU6AMLqQR{lSfgY-86#N?L5@ zaL=P2XVAa}^8aVQV#@WG6lEi;V!4LD}u3!u0%4YAw%D;W<;JQcE#y0 z(!w~YC(`*p2F7vr$r)&BO1#cA$Uu0&-2k?pU4gCkLhhwEyIn2UoZ#fI1?~^$H>%FQ!DQf>I;#wsZL3q^ zu21$Pr7uOgtXs!&A2+=heH)FUDH|zaF)`NrxH=Y)YfyFZB z1lMoSvyRZ#CL6A6qme{W=ETghm{oP^8?)6d14uZ5WcgR{BdmFl4zVI6?L)x=h82dC zbq@GDIto}{aJuwg0>A%+0hGq+0-4K;n9=dbjD13ZSz8+WPhd!{0=;PI0QQco4?N?? z{-A}S1qA{9a3BZgtse8cJSGNc$;e5R;QLcNV+(#)pg{l1^>>y2ucJx1%1gs3dWtN0 zhg=@kYdgn_>?h@>R*@JMS;U*+de!@4+<>=qoV%PEg!tSq8wt$9_XwzstsduBMX10x z3E%(bmAIaH&z~QMgU?U^zo{nRH?r zkWIXEL^I5n_Mpa=s>8J5))=X&srpZ``FGv6YrL3z*Gqwk$ibRuhS^Hi&F3ZGSxvZU zi8NihV^Beu*Vl%Yt)**0+XjmcV3M^~^?=WNqrttLn!mIpZRaIX)UCT?!t<3OHXA8o z+ff>(P;o8(3{2T-Iy>O|T|ki-)Vv6ip#~cVUi*0iq9Di7Kbd`jy=ZV6m#oV*0PvQL zzT>E@eE(ze>BAEb-_K2z_iO&Zg`M(UioLC~BdWY!3w`jm1RwQ1%$Ei}uCxCDg28AX zoh8cvBuW0YilRMtaOFjkMB}3MV6US1k>`4fxoLCsVIX0S+sOw=S72t~WYoFFT8N+< zWe7Ep6^XAohLyZ$<0TTQ-!Xe>m@;!ZT|Jmq@@}t!}5kl#N z4(g%SR36ch2cO(v1zO%@^|^n9IB$}%EvKN1ar&K6^C8AJ-cLO=Q%~!I&bMOQyY4hg zeuIpm-Zh85rjdt)eQC8eeKS>(A79oPKBG`La}_3mxYI+XraLM_Ac@&?dvQ;!$+c#i zkW%h4FY8Df^`|+q@g6jdq!}r{mq1lrKbkAiPbtfFGp3z(Jop0yy{h0p=$mGlfm5tc zG*v~+ttt#0gJ9-KLSPlXv7noYDyaKWCNY>MHTEwTYFyOBxEOA&!L;_F$~%TZB1L4} zILph|L?!le@-*&Ob*oxt%q;1hPX#_N9D$1p4EHk8rfdpDKY~Am>!9VB-uXs*3<0!B z@h6q8A(5_ZZf*^ZFQv!+;w*Rmle1ir6oekHgzjxkNS6kA`jLwcZ=bFL{a>G#f7`A8 zAKxn~aL=04ShhL5M?G9}Jl14rOa9*SHDtANlH#b>F#=U97vQC+Ig-5dWk|>cv|1`Y zwIQmsc*}hU65y_zsU%8=!q&X?mk&wcXTUTT43EY?Aa$#vy$J<2fM{KmkH9~BD4(#H%YJVuXr?>fLd- z0LByDlmP1QN}#IVHLAG5^*iB7;v7x#y`U5$BttvZuX3!^-+i^g^hpVokp=`zNwD}t zvS+zZC7hExg7#m0yOO608K(qu0I_pmMd;M{Z_s9)<@=)!ctGt+lrUFTdDcBM$XTDb z{#2Lu=jM4y{_(Y`{e)eLEM=ohb*?V$C!d6HASn7;9$R~hzkMmz1X;Y>Vys_cZ9JR zbxa;D7-ZlfhMtjfj$KuN!`jKGoG^JttOX2-huAf!kxYz*4=B}6-bXq&8iy*+R?x=q zF6Rv`1WpRkT^8Kbv*+&R@lybzxa=|HtLsdTQ|=!gF&Ruymjn|ss1)k$3!#R$nef2d z@%4_EmN0M>;FD8Y)M-WUol~=k4>thujT-8O#H^avgIGWfu^``O#?c2A@tc}l@RcF( z#-8`1o+&te41vx6XqY+eBO^LA6!WU1ZI|Rb9(IP~%`9}2kv4S1t5bh0_xG?tLj#Xw zt=Iep;iXgoAv6iTyEIL{h))%}tm**WnZDO4_0C7Q?vi zC_{YN7sulYG3!Ic0UUfvTA8>`WZcrwdTZDuhDywLL9_#kwX;e);r{ zZ{qzjTG?-cL%{NQ!m|ComSyZm0|ISO$wh#AlH zf6F@lo-h38G42ZgLuk#{05>Z{YzTVV*!Zw`qxvP;}`EB`2OT*_g+( zz;qSF&j+CTQ5h2hMWLo2yQ4;HZL1Gycb3<5C zTAx00_aRS8+VP(gAwObZlp%7H3{Z8X{z28L5>NcYevk#$HWKjVMaLb6hI%`yhqmVZ zl(6rQ^Jl~Rr^6_0a26PO1?{8skYpTGkOdpW{y{CWJ zzuXCQzGXFYt{$w75P9cB@|Bq zPFE0Zx9IsA@B*q2mhQAaCl8!NGrV`-6M}D2=YTxh;10MS5Jl|d!xO$bW4#tjuC5% zikiLmd_tS*8rd4KP6C(s&(+-)(phI*Vz3sJogj~})=`PeC$ksPwM5lkAW8R7LQ|A* z6i~=oUtosNOgRt9%M5%!Pnr+Q{H)dv75lpUwL#mwVJ{q(; zQjKnPA7Yf-Ec=J`fSkG1iG_`N@0HrVG^9CCCo+r@sh}Sbk$MCOju-CFK)*EcsNCkx zyEG)%$00{fA$nZy(;;4}O*vzD^Zb-|=u!G2?w<*CG)gOGc{hA-5hZ|k1RxyGuCsoF zUZC~;*N^>yPAsYA+z1BLzhzmk`H*MP3T_&D1PVW~lv(BMozFwgSd$v$66(7Gqe@8I ztXgfGeUi7@pH6y76uYTNedJEFBBp0CQ;k$PtNP&>!W=sp@m6q{v)koWY{=>?RK30? znKvah;MWfFi^<|1oyj^qQ4PQ0B7Je^=NSb#cHh8nBhEYU_7ron(9B)zzY7Pc^38c{ z8Ko$3wDhAj8KDZm>S2%$L(j?sQL{VwZ;T zPcniI$PHw{iN_`e=XyAkOqZ-tyd5_65vy+tA^Qm|TbM0G->+!=1a~*3bES<9PMbqC z&;qdED&(u9=cs|Qfwctj&(IqXF#NwBIkho_6%;Y3OV2BDcKE?i7@+1Bu1~XlmWLIF z1o8wD6X~+!1YjTr#$aY7gxLxefwZOhT9_KeR^YE6LA{wfR1PA^xh)ZxtEheCBvBL1 z9~v8vOhSY?Wt*yFJ)FkfRpLCH!7{vbp*G9X_saqK$SeL4YeL#<)^BxA_2WzCTQN}5 zfUver_O2s7!i&o35x(MKkipHUWb-Ln$j;>9EAG@KLL$Q8HGg4*5+UBg(Yza%A;l&W zPO&ttoWV=l*pYgzQ{{&Doql{vqMfr>9XLmqdt^u!YzC!-$D0WKy@DRo9V9mZIAAZX zqP&E3sU<~`^XLm@oVTFkp&lPzaJ3joM~G_AsqT}@m9LKpeDy4y7%3ab8}nc5V$m#9 zGRYHlPlgxm6j|iH40Kitdxr_zdCodFCJy5v^jXX-3$;%%!|wJ6Cy?V_M&q%^dDtIZ z;v27H2VY`(jLgqWXG@bO)!deg^|JRORF-kgP-V7`q394o7ZmILPxSeciAgy?_(N9u z1RYaC_C;1~t%&oB5E4$DKC9<;?8gUs(IiSJm^LGNl5g9;1{J5ck#RBEaX|RX0W)2L zK6p$bdIK^MPIUg_Ih*}HiqrdO!GVN#X6n?c$GG!;LRZI~uXCqY_Ra9PgtX0Sa+bNfB8`GRVNKMhuvp6i)Et(?~vt z3{O&0qMgtbyIC&u%p~eS_aRezWAty{B5tB|uEw-AuQ!j!%B0Ij8iU?#HQ4lt%8emY zZKuKPg`DsfV-;uoz^{l*)RfNwcSAE5Zg;T&9b)x`j)>3Hs{c5`@iCOM$H`QiyiqCJ zFxLr~h{cFM3YX;A0N%CY$J{#_=Y$_}2!pLmsB5ur+(dV{I_6Ub$HRlZxQC*fMiq~6 zMrG13VJGNuvy3Zu*<*Gdg_v*Zr$Uf@lBqeM_5XI?{@2Qg$QTqp{;mj}RB8vzW*~VG zky5tYdHyEC?>Tk!D1g+v!2kD&(lC2EIulZO&s*-!cfm`Y#hVFsD2DsX^tE4>NX$ml z?W+|*_pr4~X47*u2eYJG_x@-%WxX3O6dBmiJGtuMEGbevrqHY8N`3hS3u^t6{5 zRcfT7UgX%|M&bo&8LYLVspHddQ)<4=+^$GKnQ0r0$m@0arLX^{X5Wa%TZx+to=+RZ zWh#_yKTdr;Z~AU#tqe<{`#9mug_@*&_Lrn({WU5&ONth3Da#r$;^Rr{rS0z(3aiKA zh&eGOiqe*`X3sDM8m%dN2N#T{K3VMTkgq;U-e?-5OljgW#Y9PovDq~gN`jMbyLOildJ~r3*Q!(yrip*S;RCSuOb>U8ASq=!ez5U7@kEbDMQXv zNEwZ{vj9Cplj>UuIlyYbba#x({WaQ{r=MYduIkEaemzupz~fq3knlA5Cssa^jwTed zU}>s>V3}f4C|tMsX#w5pi*(!=OozGrVQN7}E`}uCf>9#v`32gYsUz!OOxY)wGoP=Q z!71xzSPjvR=e>NZUQNF|V+z0euDyyBG{OOycG1s&_nNv^>!--($Nu488FyC^z#&*p}*Jy1A@O=cae0Z;Pem?j2YA zAT3z$#152kut3BN{rJ;kfG+S4%BUvFh8eu~)HmcoR)BxV9j@$~i57A{`Qz4g$?55w{iAG06v-gADB zGhDKClQ3azG$d79V^)99?yv7z(?E3FLKX;`^)=45fSN>8hoo6pQJxGxV+ewit1d`S zW+}Z2{0XgFkHQFio{IK>L6nWn)au=VCd4WfecxDlIJbDAjs;Pyv%0z49WB0jul9Ay zdgDvXwghhh@>tJnLJb2fLEQ9HK<{$p{OPC2_bWl)>cfRAUnY0Ai-jnoG=fh>-wi%e zRM*RLJYi#!q2xa}+rUHU0rH@(D%*;e7jM!Or%loncpN1xp2$&>VHn2d;P?FeZoiI+ zXwBT^o!8ZDa?q#V`1~PnpMZ6yEw@kZ%f!0*FQ$q^N)@ z%T691pat01Rg}Rm?A3Q0yOr*Pui7m@P_eG3vfR4~eVZ*Vpv%cf0CUI_eA0_&#=ld@ zSdN5*=m$h1?!{Tw2Rt1L*2F?5A&CXHH2USkj_UCKFFLV|KbFYl%t*yWCu;Kxx0`r( zCH^wwyZpn9|Cb^UoNzQ)IZO-ISk}DsiS#Sqz_Bn59qatEcdr zdBI56&Ab?R_9fb)x;$|gRKbrLK3sbS(?xS}aWN2hR!vJbT_FK-99s3oEG*2;HiCcbNJWu4ueP*U@D4xxl2sFY4V1JBPOd z1Z@(=b>OL3JwJr(86X+98Ta9v$VKH~t;X>Yp$%&lMF#Vl6|cs8!XmlBaz34CilzFb zAurpK0@SKF(cD3bY?H+fQ#Uu#70dO?2`foiLK#`LlSa;oGN*jb5&VqJaiVUYzGA}u z{25udin+z-)%CzA54E$oAtEZ4%S(La0TSGZgdic9#eoc#_uhG_M1xgm|G>9hZ#qN@ zJHFykefR7Hk8!al3g&2ds;-XyV$aPYOf7kgENT&W#DS4ZqsNq5n@=t1aXpqh;AE7I{=|R)O2R*OH3xHcJo)^bA4%H4jCxI(jyU52P|Kq5N7(%rF3fEF>iYRKb#E z!TBj+p2vldxgqhgxcxhqdBFUg3B4ckXJ>L3%D|f)kxP#V4T+KgXL{DFD7o+Lqjp8a z3UVeMJCzoBDke{Cm?{mCgH2y+tHF^^k0UxH2(V19-{CGV$Y@dRC4+#@3-;Sl%gh|u z%<@`tVE{dm$4fD(hyA9BHK}(l6Y|!z0fqEfFEi5=Ai~v<9CJ~MOMGdA_V5u_f)Bz4 zQJ6&wHhfp28C?2$-Km+KZ^XL@wb**y$jxY1?#Asl+efzU0JnBQws*qNX8lsvh$@+6 z)o?@|NjL*q^z_ul2Y%GZ9KO0{(m$Ml3Qxu^bPkdiT$Vn;-$ZlDxc`r^p?^4)r4;Bb z5=hW-IC<4(eqGekxI^IMRZPC{ZUSttHE+?ohrLl> zJXK&*wLHuuV8mBZv4c|4bEQ_K$rEhTSFo7g(Yy! z6Z^E_GM4%pP#7})bccga6y#uUtjb3U0A8DyFwi3r?M)9a9bBWVA0r)=P<~2#l6N2? zdkjz|$hu~a{`}8ZpJsVD!z&8S7hTb+rd%s$A*bCOhoQ>Kco{;|_eBSLx>wByBGCo9 zX`XJTaX-KVVdQ)aXfitkxoQ^chVEq?c^XdC=55%HAto?xwJg>SF@D~b{qw}BJL1g2I@6!*mW`$e4?lrNurlCbsR~4x` zh^?R0`KOP44}iYzE~Mpz&wM6vdyYhF@m-08!zGiY$Kg?Nw=B)i7DzgF-%Jgs{P1h; z<2Segwd(O}gDPpQ89$ryfs7Ohsbf8?=52(j{x90zI;^b) z-4_m}NOAW9MN0AF?!}8kaA|ROmmmd-I~0fFuEC`^h2riMC|X>LWZ%W!vuF0qnRAbP z-~A&GVPz#DA$j#D25UA8VZwoJWId=T%)G8b83a@sxT?E=zBuEEKzGSf7nPNJ9s740 z>_ff-e`igGd_o-A;#JZ41uXG4ub?!E7qgrLGn9ceamx9_FPH>CkbdZX@OCa@M%-5i zEyh7=QYlXnSZSvQ4~u%%;?gCax@Y<$SYA8%&xys~e|}A@XMeS?9-vex*Z0Ehxp@4m zCydBh==`(vh|j4c-|dQmX2PqC8OMs26kei!#i=u%_P6Q-;q{A7-@ba1*wEFg$y#|M z+yh2f6=CpkWb&aHm~9p3P-zouRUZOy8hg26ne@(*3t7)9JakniwCdx2H9QnXn)p#e z-)(n+&a@LhqFdW_yh<*?X|JDDlnjP8hEhup)&rO-hZo;i<6j9deE@T+q<%?sWN zYEb|`A->q{)47qbY}8H!AYqS*`;p0VNVOC!j|Ev|3U(8Zr z)EYY66lN;w4(bsMpAD8&%s0Cwo{148(^RqeC-E=<;||hc;Go0{H1fh0{rT0RFa$C4 z_w{q&e>yfX9>KE-KclM4cx48vxgdus9lC2e$Y1f25aS1iv__UzABmD>PbLki*tE%L zF!cf;C85%=>E091G#l~joq0E24f3t5wYR{>6n#=(o+*kwM?ZI7I%|u?aje5?5Ka`3 zKFPte5^?oRQYfDsqtDuc))h|JVS#ven5SV$T+ng?2PW=Q8kH(Zl>i`{UUc;>WRuv4b6ZBK^8VZ6o2v$dnr|5OXi!r2J-->bv`IcwYre8HbVgO zU7UmL_to|{knkzw@$~=w;Q?#lLB@Z7(wap8uvIVe`=cW=vC*xB5$@)w?SB4GQJ#;j z99FT734FAaqrZt6eW6S_Wus|q-H~XO^t6aJL zc8q1VQj>;|Hrq=KA-tW7`_gai^nEJ{y!BAQo<4IJ!?Vs6!!1Uvw1rbkAn1oc9+%#7Cy%oRgmYr4AkD3 z5tKUVgVoG(z3?k?Rkt^{XDL_m^|`|{<+lCa+n~>F-vHvf<9o_|q}AylP3qWZDSoAP z&>}r=LmO%m>g-8wFf)LnBoOU@dNoeq+WRVnsyp%oN2MfH%|Jzz0dsH(Ja$y8Wa%Cw& zQmsL0$36EHJijuMI#}cHV>D0P?<3qGQo!yl$|bMB*#I5bJp3)WCc0Fm_d!Su%C8-M z1NFq@)T>B3rz89gsDi(#3bQ!H^)M@Pc!BuHI83tYU;wb#h87TX8ymt8A1O5zUS082s|2J-8}4#p?n~Zm?42 zGaaDkFZmFVw*!;1w!b@r^f%M#B*`ouZ)N{_{<=UFEhK$HMBP*mn$@k~j537FBWCINv072h54YY-+RJxXYxeM+wT?jczdn zpgJjSYJV?Ni{wkUZRN>3+_g4H{2{EKl)PAV&R1)h4@|X2>JQ~MMl$$~vkCs{vM79~7^)Wis)z-j1_!<9_a@9jW7Kjg z(yI(c)6J|f+zy28as}~!jooQK-q`3K`8!_}shQ}X)|!(B5a%H33aaXKpZHUmAb^Ov zH=_X{(j;b`b{CxOs=8I`<(IyHz>tvDNrJzlFBW|cD4dZ0nJ2`c?$2tK9j=4o{09I* z>^}pt{fFaP9dy%noFmLH8;mL^KhQ*;20{vKHTgDWRuu?dhkx_A+~rsZwhxh=4Nsn9 zuUss88MXN8bKR@oCrX7WPfC|pC2eu#0iU}(+E42!D3N-Zai;lC>bQi=rr!DwyYlz9 z2MA{89P9ZtZeHq-?^(CEc#iT?h^?Jg;_RPoTsaGU8)FJBV;gZEZP9si?chl(mz-qp z>L+r7QKWM^v$DNw1K0TB#PDY9227q_wa>4rw1J81vJ7#CXD1|lIMev4P%3{UOln; zzd=6!m$y;2WGwYZf&}v4>^u|#gv?9)?(V_Q@41gv*&WaANFjRae{7-ERRQ?|dM`EI zu%Djh5i$4bKul`s90X%?HEx^(`&qo-Ku1+)_<;((1{60c7t*6(7)`t4HlOa#lX^lg zU1{dbHYb{EDQ+-O2bcu%72X4)`%^%K>`Gj_*XI_{cr9M7y~jxA<{(RxqQYlpZg}Op zCm8TBh5=a@T>Ea|mOT@_BAc7$?HO-TFae)CNT-q%x@CwD{>o~@^b#7QJfS6{7iwLp zT-{?_vpL7b$*thXE`eu2W=Zy4dSRPbBuS%2K1xC<>qv-IQU%+gc${0Wc-T1uL&$Q^ z{Os@y-TwOeSF}f!p%jVzRdhJv`+k!<&2K8Y4n%u%9UPjfmPcH=q!A+$(lR-T!*of` z@js=W?G%Z9`BJ`z&~0H|3NhU+kSqIiA2KLqo3q1vu*6qZW;T0U5e(f<&1=)d`ILW_ z189<%L@NnNQ&WZMjO{FK^R6EJSlco>cte3<(MuLYI|lmz1uQrgXOTiKlo3JR06r#$ z*?FN#8uP?wZQF6?rbGTr$hj-~jA_A_6tH{Ys^dW4c2rh1{(r8gMO>azu!rMDCFr!jwVUe<|QTv{)FYZII95|9bxC?DIM&C z^*r640bd!#O~x8zt~VPZ(pK!1Ey5+PFu@AlJlImZiLsQo{HZI*qB6FJI}cZ$;m6 z0Ly1+pzPM2Q)W$xaa22CvWriv$burfPyo^W1uJ@+OFW!eRI$>|yrq8{9pvj=YG_sc zF>6LeD~=K<-svcUO>Vq{!xv| zRE+Pscyeg}?hCKS=R1UeV~rWozTuxFP;7 z;huN#{!Lf~8ZaUCkA3!KbKg4QWlNcY@KsM&7Ui93{?(6>jx}!f*6RCB5uL5D%5n~$ zO6Ii`1tG$cD37udTI++GnuRKt`rkn6*HZ6O~Q8_^b~k zR%8$RR)5Z8f2QVk)V#<)lNK@ysbA<4Ug@y0y15t}Q4l2(W@*t?c=5avDqu8)uvR2a zlaR|x85A&JSm0^9U1CocR&HB3BWTE-O~cMP(fKK!10!8SbaO8JGRj$D<`N$1%AjG< zNMY5CdDf7FcVKldl47*!xrF2?%Ke*(inTtpYb8qoY3D0Wa-B#M+g)eT=Y~N?^|_|5 zmVnv2qbH>8ogWS9{4F8fRE8#7kw=V9%7#>lC0B5U=F3@{G}`vDEM;iP(Q~61lzHsor~S=~Y=*dQh&Z+E5p&;x65V+bVxo z?TewowuT31{6=4jNRXnmqrGhOHtKt{hgqxH$C&h}PXEfXe*Wm(LM!EE?iQDJ8eQ&V zhFAH?+KuR?rTemjLS^LE+!Gh}p;zZpk-=J&(4?2jexig#D+d8-7eMzT zS@mXaZHY%!uX{Ag>}-I9SG@T}AP8;@|A+I9M6V8QtM$pkCs)+>*Gdj{MjriATIIS9 z{BGOr96erzm8%4R{1OY3V1iBKtE=5X4Q@MuGso-#knt>x56)JgiVWm*Qje?#3U zegRtsd-@>#mS2HJxnN0T?gV(0?hZL{EB@rnBQ?&J?>lQExZ+_FyQ(jqVm@GD*ae z3u8+?n?|pdH1W}p(6|9XxNOv+FrdKA2}X4q)euL$Bvoi#ji{ER7a5s$9;K$+G4o^1 zm5uS9tqP?xSobu@ypN~oVeA3U8kMUHoS$xS7ukv+mGo*_e$`SST6wffL!ONngcff# zaOHY^|7#htR`?qTWfeME&Y3=p+8X8bsuD}mh05C8h#ejzQ#QFDMN_#sfJ3VGZ*iJa24-w1an4a7+oC(<2r*%tN5rMtgAQ32| z$Ig5ia9cuIa?e;b-a)Cim=vm}CMXfW@Njy0S$>SOqU4!tfxG^U zQKiUo`u4^~flIMGr-hptPs2J&d~((!H*144S?%L^c4|jp=Fj&DUQ{F0?3L`IV@h7R z+g5~e%TjTqI2iLkd~0#{-GTyc(&Ai(jRko)aqmF|rTRc1cLG4`TFdd@JTKK0T&ihWgE*SY1%!1Or#%D)=i58fjLbp%wbrv4`b^h z-wlp%DKIpi?b#K@ee4=e9pe9VP`PLOyp=Pp9(TZ&48yiS13ceU09&1c?A-N=+~7b* z*R=HaraU#3>ur~WFvqV;Kg?P6sKvKHV(#J7mlQ1KF0V7qudaZ9wg?P>tba)=ErH}n zqQwrpY>1PG)exw|b>y`>f0&Xj)v{nthjoZwO?nqR_>9I?-3!l_Sxs7-ttfuSPT~$a zh)xpfXwF?)UDD^U=4fxcEl7J~)Un##EI4Tv8WI7veE{^I5X-n~4d=d%PrG_&N}*c3 zT-aKAQiCAcghV{bpM{_rPR~NCl^c~G*MyQsGYgAaKX{NSPXR6IW;yk2+vflpwHHFv zqP3I8OSZ^pQX~??JkzsWHHpP6T2>?U-}g1#V?Dq_-p`**uKwVb^FPwtA$||3u#Zk6 zv#eK#o74#=M| zw%BsD-=~NS0t8RTMl1ze4hcb9vWOWi!0A~L%71$8dM4;Ol}T3_{FQ423~cqe1O}vt zOfBaFh4`nr7c(#8Yjq6tM9ZDtsNz3`;j3{@S{s_9>I@&fIhVU`&gF)dD&b0U7r4{d zydFGfd+HrI4Zdy2HN}pez1>FsIy(Qul=$)s*W0wW6F6bY|0kdhX9tuNxzth`Wb;SY(?AGz( zZddZOjK0jM**u3A^}#=!7o?R+4h?o}3XGM#{28(`3v?|{kZs>-B~;=8P6V^{6Ap}B z{TmOhvWzrd^Liq+GnW*Sc$!&m2x5531i% z955`Nd`muAw$=VDi?8(>jU!NCCawDv{jx8(pg#GyChfa&hB-A-%w(hGD6^z2z#)!z zvH->r->M(KSbx0~Hi4sp$mpL^6!51qqy$g9GKl6NF3~vZ^pMf9F(60)4B`PUX3grb z^{I;7*ms*@8lkx$crxG~vvL)2l^H;c5Dv!sf6K{3T! z;K)VtOyS^%2-+rFks+*)5fn}QXgfloe1HfdTupy$Z=6)F3Scb13)%&UC!)xBXzOrU ziUPA#HzMK$@2BUFK8V|1)kj0z48KuVUHkJL=q4&7JZF`zov7Ff>8B=Oy?LK`+1;5yd}IizJFc?3=?!$vRG+I+dEld zGK(QV(-ERVcO`WHY3%FEJZ!Z~Qfq3ZP~92;PP6t?d0YPmQlF#N1b5Ej_nvJ)P*u7} zdyF!g0)77Li`}sDGTaNeQfNIlkC#iz_zjo?#cq8cjX3aOBd?@i%1Re9ch9C0sp_V$ zX`iwvnf}SOH3q#aKMG$$3R^xsk?}0viBOPj^w}711(vJ)gS&jzru-cf_Xu@sd$%wT z3wM>^tAQsqrXl^$nYj>8^8F-&ZP3Lcf{laUw~Nw{QCKySrxr#jPL3Y;IKF9Q+S``) zo3t?{W^kMcB~w+pfHgc@98=mpoP#tzcxJ$wARDPC#}AI_0Bc%PC~cQ(>=%I#A0U`w z_8Vv-qKLCMw-a+ zWdM#}LVp`=1A+WMTC2 zv6Jjw`F2@Iu)-KZG9P8^00TS!C76in^UL;h@X2Lz8TryDF{9VDtZ1DQS~~XrOow(P z@+Bm@@MqL$ugGE0pAzi(o1PY9{8|j*U|llBq#VNoOjr!TeCyEttKUEr-R-DvPJE+N z8>9?{H(_49djR4wFK~uhQbV~k4+Q6rpriGrN&xqhVqwG^HS${l|bQ} zy%I)_uUy%Pt6Fx+Q#`LR9FRskLm}PGAw%)Vl+ihJ?O#DcWtp>Ww8mwKZb~oLFOrZ% zJ{}wNQ*i8Q9t$qcvs4Slrmar2(LqX+;-;6D60Vn>`~q76^B}N}rM4M`WfRhi42MoJ z{kOnhTZWxlP{7)z?x1kMK`4E)5*?r26v0kj+sOnWpJ^qdbSu#S6>YRxC7JSga!dxl z>eEI?LE!(>bhI@28b`LoK)l!Hqm;VwG}%l`ApHyL){hgSsQ}CLxf2H8u_&=HeYmWR zEtu1sY7Ya?yrwexvtirsL{sHMNG~<1?C_&#Mcli8WsAQ}3K##$A55dRSE*tAzJ~#h zZch|zUhaHvc1p(S>`nQ=vcG~>aYYuN?YnsVC0wdnG-FUSZ^<7u;a^kN|KvJgcllR+ z@jXTk{mJMmqlOI?Vr}@X$cv{Coh5WGl$ykbw?p-MCG`=&UPw&rF%*|^Jw|1eke!H| z0hmM&jDi@VgU{=!UfRO!!H=r1cf0kam@iSs5%M|Mr=KC z(?!47oF|VWB3Y$C4q#+WL)>l+2QZ|0(`RON>2G5c6ME+gX9aDQetsk8f8uTukl?SN z7okxDo386u!J z5d!biOz49%tgz+N4{7r#U8YaVLVyveJp!PYR`+K_j^6GkosJnb}PLt1M>z9%xud#i5Tui_ zwRuIxQ@7$KE;es87Q+?5<CW?Zv3tl>-72eZ@2FUsiN2H{6wGa zOB>%RBZ)~mw@61+Trw-~X>t>`*yaBC6^6bDw+-NJ0>%1V)c=lo_%q9?=oJ=i+E*XU z=_oXW7VqOMQ3+O9m3~1aCc{me8gG*?@(3T*{+TA}p}26ktq|Y6wqp9zg1AP~VKy5F zeDGFZ-NRWEHbPm`@kul$q zSsJj*O=ZDfq9Y;_gh88irmYvmT<0!cK0E(<3w##;&CHfta*gz*V-t3oE4$4nnttc{ zO$s@XZ8?QmeF*weTk#B!G4Yo^d5!w@gF>BW@JLuWMk~$%88c~r`*cQ*!^tSHcro>Wv?A(O%>)1=CdD|I?Z3ysnbz62kTX9noBeRu6$?2uoqUx#m_dd^HC?Cup?g! zIqN3}Z`z80mv9>wDrE;!Ufc~lB&_|KmMYh+SutejRS6Z)G|-tpuqcjKUfCCQ)*-hB z69A(Hv42e-fb7bKKS7!nO1SQaFjNi%Wp-IXI6bM>Q^dvTdVUK+b^w7QaSbfPbW&xd zor^F(lzmKL=5lU5M|fpq-5nDK4J!6+J)HbCKVXO&)faUGzx}Hg*K1}Veq`kx zvB8outR-8Y-$W+2zdDy*y%2g5UWGm+7rxsCpvjRa!!yWc2Vys7Hzt5DFGF%kiCBTo zvm^LKb7bzw3_z<$L;qh=%@QU8e@(P$i;SzNm$o;n)CvpEJUuW&P&DVIomCq$(Z zUWy6?Y3Ct9^Y0^Km-11H$oIP@i*iM)das@fTpa4j4$_c!BwYYf*mZqQUOPcQp+b{S z&+IVo>&52w1?KQ=xYjt8ioTemu&M7?5Tx*G3rgEM#6FZs)Mm+imTBvc7u8}2Chmb7 zSBEU6**~DVQCwdE%F#J9_keNcQNKk*Pu5FC&C`qWj5)Fb-d35by~$kOa|w;DwO{F- zf4xV-owEY4*0Sq?!A1Z8$}E8;hsq)CgH~tR)cM`tPX_<-@CDFQu7ao`y~P{9e)yl(5DoYx>@I0FFQn_0cEi16kl2_+Bh0u?Yp*IO*G!Zz5kpeha zUYKHPmMscL6%JH&0U6hJfWM}`Tj)Acg2`f@k?R>2fR+HP61hoCxE;!s-^BH|<4Ym9 zsCLVFjY*93ZC?~u>hO2=z@AZra_(`ikk3wn!5#@{nuXTBUg~TE_3D><`SG>F;!tT- zJ0-UlaEWCgvGt(Ul5|D#)qH!uMe<) zuRENNaRggIXM&-dZ_eKkZwTZ$$e0TEIxCYlms7>-%gOk}&da`+TBkV1aJ(F)H&{v< zDmZyq`>{O!IW0QAzgDU%E(Fk-!ah(erF``nP~-yfhgV*!^s5Vo7evo|?N`bvAyD=n z7Y55pQt}n##Qs_C6x%*UwZv-Z@@M@Tl*M3GQMA-vnf(+8%YYL_W)E&Z+0-nOyMcB|C|2wbff}_R5}kAr8RQFW)1t zM{^Mz;aMQ&>Acm}$RnBcLkmJ;$9uVRR^clkQ-9hRE-1;;zCHFlcx=J8!e>@8O!V$X zl~1@+XC?GY^5-3;=GGag?m{^&j_4e2AfiYpsbh4ikjH`Qeilky=S=<#bJZm}`mveK3VPyc^pMc|B+iWw9{$6jf)u{wmfo!uomlmq`Mw=6yuj ze&_q*)9J=okGZZ%EnV7?N$6S%>enA3zX(ORF?dH@vM5g4Q$jl?XxNwaR#skHN0g`w{7J(lio1!)32zr3T(Eh;!D3N3)8&fO;^L$b zKRtMMc2$jJ*1yt3axKY8J+E8o@;_?(%g zsHP!K^IK~4GoRWJjR8@wX&&yydFegWW~QSTAJ2TV=4rI ziyPcgNvc%>?rC7qqTCy2g_FaG#l7)FZHzq{v*k0MGPVO5^HdLe#Z!&z?qcJqOH|~a z zG)f9m4?pMTJ-voADEz#x>o?G+q)u3{CKu*YZGEc*E3oEmNRqn{Y*PX` zTajI5a?>uNWYrZ%_?TlczmXoBY$e27z$c%yXC)OJ5VR!?X3m&TI0)|a9%v`9u@!Q}mYc{H1tkh@()Wp{Z(G zeg4_aUSX0HO_G-tu2p*V@m(d7{0Lz^&r6$QvGPFJF@{#VP;dInDzaSylE?%JvRgH- z!!{=@8p=TBST8&Hq5^wN_$4t{j(Mxa%4}P~5N%sqb5vsE>BvA$p%ZJcKFX{;w$6bq z&6;IH0I=5J#y5_a>36;vM_6JM@Z}#O6_Du#pXA7l_Q-ol52d>WN?ep>#}n)yV@IEkuL@Y%WKP=*J^^bJYeIrZrAt;@*_;z64l9yqpATI z+{{6TaBDj&Mh1EtUCiqTfVqLPnYpmsT4M&#!s0EP^GBTJ>~yo`CD7$Qcv_aB{-Jk8 z$jzULIY1JU2xbhls|Yn0VUIC>K=(3;+E5VDj&LnsufCgTMC%Op09%faF}Dpf;Rrg> z57m-k>vXr}HUHQ+OXGUjy{m<_P)L;pDOJ&r`%%loX>qx-zjWNm+47Z!bhlG0O;@;* zx@OI~q;cHK08rWe%3}4%D`7)?|B4X5+o?|R%SQ@rJumQH{~<6CoA#`{!d$OzqN44f z*)1ru6j6ID2QR(h$5atRyh?bhS;8P;yEDmgWc>rR%e(u#3`ab3fN@eup?5k0E7W0p zySS7ktajcweRa>6L`O%Lpm$z1NjG71rUW$v+GuVYYhgf3qmjzfO>7bGJA^`KARnN) zW`1qgzTn*J&hRuU4+hjBIb_q)lWiA%tdZTW^8G6*MD|+f40b*sZ-xtHP?LMBuCmVgYMB0yxA@x$A~_`RlencBboIJ%O~$*-amsSP07lRyt4CjB~#Z;?z^RbhVqOK zs$#(P8*|k^VEDl<13fnY<%9GKW3JR^v(Q zW7(`12kq?6=*#G&ZZr;S604;k*)PO&)m7e|lg!7t7IyC*{c*c%>&K8R(@eH4D4AdI zp}$zxocGd1t5!;1@uHAW5-R$6%zL*MdJi8kA&Bc+oS1yfJ-d^Eect$e>9k6EQc%de zpqm=%&q~3OrQK23@D2(O)s^wDY|-*iTXOF2H*<9);W3>LWHibv(EekL>OAaZ!v=JB zGJmxA0C^onRcH9=*~*eEQ{-?=o#3a)Y@49^2i`K3!4VXWqU5b7gNkn1Z>J2D+Yi#_ z1mC?Yu!|JQcHlkB6A~_h%3JZ*6(*5Dw{j8OT-5aPt+YQeM9b2FH1R7vu2z>^_&o@5 zf&w3D@Rb~zr{uZi&A7w0WLs}CST_%}`6?|p_}|nLE{(xa!3&C8ppC&CYRUbm zBx~Wb%0ZpM%0N=N0$I<>!mubM(1~jQiOSXXmC1G@aZ6*y!8+%J7KzY|A6N;u&I}Ws_4C~ zrmCZVk*O8~HbOf8H&fdDr#PaNn?Z;2>P&6fhs;XDW^3CyaY~}AI_oh#6mbPk@h$c> zevhx`@57$IkY4_8$24S^w_;SlE2w@@&pzwZz#;L5R~uVqg^;b zVKbP9=YnI8h7&Iy)e#X!UOZlBjMSSni%;OJd@^YkIcZk7&SKqpqqn7JMJ;Fx6o+P2 z!XxgTXqdO)T-Z;@9hapT?39f7a|aG&PTi}`oGM!d5F(Vj7z_3WUe)i=55(p#RXjJz z3n4uZ*D&#Ra-~)S>r=)Dg_yhJ`(RVub@P%$)~jNGC{4VxP+^F+)Z@OPFZ^s=7WW&^ zi(NlxT-xGE0I-T|1^7pmJ-CKjSCSpP2qo9j+2DK za8cKOolS|Hpfku+gguofK9GjTEHGTbvMOAwM;-dynBbSKy>w+4z%fj~sXQU5ZL|mTpMUu)Jqa0yNs= z-a4+hcr}Hm+X>L&M88<8J>F({Of7F`HTnBSyy&{OyQX0^ke@Rt#ONBH~@$73~=?f4^fz82&C_R$;YG1jXk3 z4aD1Qn)ohy`ISftUWm7tsO3{5&1VH3DH^pW=Aq21xUQA^q5~+)Z15Ie&uN4l2rY$1 zt(6o{xehCHA%z~{j9Nz(%zpDP>zRLiCFJ{JC-zhgU9tET9<(cl=wN&=8AjbY^)qjr z&h=rjmGsl5vH#AEl5xQNWtmq>7_{)z2KIcSoS8P&Hr}Kn4-2~KQqH?X&l8`@6b1XM|*MklY*%U1U| z!fbX-_Ban+XGlaX?ubwjvF5#2f(_RVKG>no~A+Y z+Zd8m1+jYkb^P*GqD{E37~CMfke7K6ml-~KLCfNz)=)Y?^Mm)ao|=y;I?unB958=y zWd#EC;3JLie{>0?|LonoA=z6Kyb4f=0C3Bx&M(arLeldc1X9N-3z1DxVsd5xeUGYi zd#kiHGdV-ris~yy9sOONfj1W9I9N90oaVAgK6fvP45eea0-n3(KkC_9$JW%n9`cv{ zC-RUi*=+SN))HxsDN#QhnK~5z&jEP8`Y2ll8bG#K0IVIad$WH%5d-vF7$4=$ywCvi z$LkHv`v6Kn9k1X~sX8vir!H3P>*12?$B}aQRdQsb_f#!+Ev*&z= zT1h3}AHKj!Cd61AlZ1hZEk zzgymKXr7una5~$l0eEuzkj@hmz-G8Gi#CvVl56hLzc^RjH<|^sEBwHEPjdqNF@F(|v}PKEx#J=!49Md*HLF`%8k^JgXS2K^ zmx{Itz*`c>e|KHt6mw~R#;jIm>T-LLGJNQ}9Y4=#rC=r~lowSUc7N_lm#BOp(C9v5 zZtXVPBi58~_Y#$K*jCIod&tcuDpE<+J3w?6Ku_Dgv2Gb`FYr1eg9-{sI%P0)kDt4LM4HwdBpjO>!>(EEUq)$le}k*8HYdJxILIfCO!93mR$; zq~9EMlM4v(3(0)QHr#b zlW_R1_gBa9H@;g9$AZ261giNZgzQxHH%$qhBLgB)^ixd8A4nPBQ*OWb!FqIe-{yFu zQtX`t2@pvq-!^1pZ;Q)H4Dk?0VlSNfA`rsxqG;inX`=R0*h>Tx$Sc#X{bvK5{gW=+ zjk<1t!VR)JlNtUZW-(D8Noe!V4enPe+&ZtLez%>pbNjIDeH)QA$QI*-!RU+~`e4Hc zJ=>-252Q7FSxr@ZH|em#-!pw}#R?kvC~mWkp8*#A}mx^Wj09 zNnOrA7ZtQKN0Qs^-R)ksW{WkZhOLmLdDr>Mk~wP-Y%D2F* zv^npt4Q#qbypVc0*$WFJsHJ2hwhh{K+OD~Fvr+l?AzGbRRvwTIYQd?8Nki6em#7x+ zgLQ|Z)Vv97^N8t6xDqy6mm<(03xNg@O1Od_you^r>EbbooF#=@@&Zxu zwe)3`Jxbo;=K|=Me=pD1myO&&`Tgxr?86ft25G2c7V=4kj^9TSXnn*xKNecwNvY_0 zCb^8rtIEl6(59gK_f%-AOS|}LKeJ@Hi9P#}Cd$jGP)gkKKtu*+>YfHoa7zZ8hvwZg zJKMKU%v@QPYKd%B9gvW!xR%wlCqOJi&6H>vCRx)Vo^BD}-_!@rDNf%b0i#Bn656x3 zS!$IICR;naJ48E+0Q2PK6>FI0ZJt;JG3V}gS$8x-^mw+6i>u1Q-VVhyxNt<3`yk z+*vQ~WUZfp#jd0jK02oCR0=U7-Qjk3UT|mMgW~H`IARohG5I5l`|EBhNVRno=M-;s zkNA8h%~~2x`ePi6*7PhpUfk&=$EK!<)UumkI$6h$I1jN1WEC)+l=&HCP8kBK-w9tj z&o}`Ho!;6nO|G=vdlbk84oU<8BYev{=aC^0*~ARX-q-MNx0ckMwsU%`;0Mk z?|;oNwL4}X|AkNZ*TzbN5qM>|q$fsaqZd6fzbv>h{BpMZo>a~-igy17Qhw=3MNIf? zm7~TbR*A>*`EzO&+c%(`d4?_e*$TLAo0l{{ulu>UV+?&lv44(3%puN0k35c zoz#I9w=cKU0&dfOsRF=HVk}IxsC_~v9uVY;1Ye_g{nDznP8cg=ki5I^B%ob$JMiTR*jtTnuAuV3@a6Jftym>`0JK`v}?bINTt1W^? z>Mf!{C?##tR_o(=KB|)6lOH>|MEjzUOdIE;ZiO6v@aE>W3Fz6lPWLqeLuKB$`j4 z=3fa}`Va9`Wc~@uplmR}lpK%zgxLR^cfZv4DJ~(rkj%`%!!1kOO?TzWA=FoVpljk1 zM&ZFOOJ7H$K+%!(Bs4KSwjKM;rPcaZ5@~gRZytfd9p3P0j$*Uw7XhotI>jx?oDmSW z0g3qMkin`y1NY~mFQY#@AGXQM&IMyQ6H@_KOG4rM<9mwl2bnx-H8Yh*<++W?h_0F$ zNQ=9oy!Y0rvpziDpLNBY9hvK^zxAoCr+5rjtYPiyRF+ugj2OS;JgrPZNtPT$N{E?O zC%KH8&0J?DUp+$#F>OvvbPVK}Y)sT-1TVqhwp1$Uz#KaYUl%Gk<%v>^q zS2xC#vOGElaE>Jh2X#s|taT$OFmDVN_X)yHw1cS8u+M|!fTjErD!PthzWHc+*8Z?O zon0eWy&dS)5^l9JT(V6GzZVYjiwcQvDR_35P_nA`>k{AT;Cxn$JrKp z5)WtXX+Z^{k-|(zPNuj+7rmfheChsid27q>H*`^X$pQ$PQv1k4^y=ZVWwtQmZg4^g zv2)>0OYP+F^j4idU4Y1z5oovDCU%U-`yCpQnWi})p+;0T*DjE z!qDd}y;Hl)(2#9+mF9!Rhma?lADv`YvZpGzs9zt?W^VE{Vfv3I@$ZxS|8B(nFU~_| zS-1Wer|u6{_w&UM5E&{eZ9F>dA(o;{{ftBoNPQLP{6{6?V(m|(MJ2Xj@nTen#uG5H z5Qp6Qs>1O|L@5=np6c@d`tQj6C9xyanXV z8FzdV!ImVu55Jhyz4*5qBPr zd-b?Vm^P(sXSue8Ka{aCW@HgRnA4(=Vx>&wolMQVaHa7J++s=29J$D0hL~+>bDPl2os{iUu@&3e_lGh!bY!^SFwFbKE488aKfs| zZ@Nk+zjznu$IgNo^-KDMdpKgS)l~y@`&y^8&c0^lCd9J>#1mrgkiwx4=e=>1VFt zvnrR#h!)Y)-$0~LLT60!@k(7}|>N%766=s}r$nzU8Xk ziD>~bsy&lWS+Pnp5;rWi8NPPHxAoyKvzT!k8girLSxi!4A)}<2o}JF49FgEojYEyq zi0=j>MuFe6(SK&8fp^8W%SlO>tZ3Fxk?_82kb%CwhpEaxgEv;VOH3_yv?m7guw8xS zOcM}!i-g0)hLJuS#+0ju?zX$`6coAjJ%z*qe2ow<=^x+)$u6-A7R^i36l<(e=cysa zwlIc%4$~}{=Uul2LxNil4KZ~g~SB+KVIk?jMA34N5^>9XB z$KC7S0Y%Z=08m@Wc#hw;nZnZjl85av$^N7UU+#E0sHmuzQKo!qXR%RPPLn_c@K+)vV&s@Yenlr~A_xhe&F4e%HTMH?tb z1wqUNpxFEXHuOJ8NB-VZDkIX99cUyZw2JQ##}X!8%t3o#6Zz{F$FDdoR($J`ONkl! zJY7D~`GEiIkiOS=1XKs|nt=rOpO*DMepf2niMp2jmGoV#$4xX}a74S1B%PCP*Iy|x z=!1TE6D&GJ!iKp^xy7*paQeog6q8RyA~eq`{76-~^uu7yV0wC&Z6gO@QVJ4bi}^?L zM94ok!z4y(=+M`23ZmPx`7O|4iJ@NbED$gmq(k`&gQQkY{y5)H#9s8(^;~4W=t~O>$8{YmALxCY;1E| z@M3K~LpAIYjH`kEby?-5TnUb(!SLaWMpMHJ#+CA)ijP$B#vv+0OBD0@5%6gE47PKG znGxHnX6Xe8ycMbAER&k-X}HvS@q`&=oSIP3^~20=D=U zSYDr)RY%iixp*1c=tcOdP4Q#x^k+tGfogh-Yod<}t%n+Cw9E1P7VwQhc5+YW&#Xrk z*u2H1^;s<{tR_PFyLo=Y#p}y4Qw<+?jZ{Raew4h1BZXE8NXS|}M76B*i-iRQC3DUz zw5NHf^A8kr8&rx%1GxhM;ao?I0?UGaNE+L|!VqAWglr=9xoz9cI+_{F89WhPxm@A=$aP=Dg>6Lo%Z4Ap>QgSB4u-ER0AkQ>FF!s-t^XGe^I$U2)5%#u` zK9x(5r*~`J{*lP)Y{d+(cI41=6#J_G>ON-xqBB{^sq{n?2vTALmS+C_&*+2|7X&*$IW=Z{g9 zRBPTzVJon-Mt}8@?C{-^?GIS6xmj%y+5Ue6kY}CyX5qJKLy{(yhz9M26kR|R2Vz@z zYiW*zu;^z}2!HAg$PJhdobShfCw@1Jj)Wp-Lp1{W=x9%nmU^qOI~2ecbv_3&0LnqT z4iUH-2W2IL+xKksZ+bagu&o@NTf3tc3AmD{&S~Uj*V80$PM!zR7Moiiom|XBDF_bx zX^+6%w#A3pqYG}9glt}Qdw%7=paohz8KH5oZ97L@?F9&Pa_&wAr&&TYTiP@wYtju~ z&z`yy?p==KM~!lS&7A?8H0u=4zTL-~E3MDJ9ByDdW<-MQrr|=R9;(x3`ry#APgWU# z7vd&vz56K?h4uuYA4#WI4lP3QP@6v7qT4y0!(-6Jj%3{M-je(x`16mYRfeD8o9Q{h zpu=OZp(R;7`N5RDjNcjMZ|@EN%Q50K@T$c7{aU5cbeFKo%ga^I7&P0*R&9M{o@`!)$OsS_~ zC^kL=9K=DG0bvKHnt>m$2zMF}iGt2_mUP4k!-|LU`xY%vX^*zzjG#^lu|SZ#W)(s2+jIkG zoBiq;52CUW2UV4+aEU?G7k$NeIQ#u=HfY^9`-bMTvqx6f0t7TyPaJuzy)I-~F}s@t zjE4e*^O@#1I%HEYSq1m`OHBfXp;=^(eQqjwHhd7X*G~%Kmd5o}0bRYVfsimhN_tID zMq*G=+Sh-8A%L(GBWi=_?XNqlL5ddCL9%jEpB0Q{vQby6;JI>?UNVZFQ`ojqK7bof z>grMg+!1aofV&|2y-spjgj!m(>-NEQ7(V>VAr%tR`oLr0p*E>lkbto=MZOGm_-w1- z1}#yqhGk7>etk@#&ih&ms3b4aXqWyn`)9JsN!DXoEjA5|l{^;u{DYek}XOdX}E!QN}u- zj%fcbDnPCZmV;MjVoU>2d&t#LbhhqR!DMIJcS0MOT=;17QMT5A{Km>J+D6to59BK5 zV7P=M@!;D_C(uut9=DUM8+e+2s#(=AUha^F`6y%fMv{p`)BA@3L^ub3p8Xtd-bvlM z<=e7tTgPnEQ%`z+myIZWId?mZv31}HM5P)SPsR)jJwlbAN?mFZMz~v-IrnSLtr%(Z z^>tA@==C5m-Ip&pkmlJg_}As-g(q#$A_}$E2)70G7iq1az3-~gj~#q3+fE6!=ncz3 z8Vmu;LA=o@*-~*Q%txZNB-ZP2tTVWyCyU5J9TOpyFWY7U=BZ7mN60&#*LN(Ex}7{Z zeC!6WDB&AkT+L&%tYTLo?`)}<18fp?zX8JAWe7W9>lZb#j>B~TsZv&XrdWbKWHfvz z-j@>14je{a*UrKM`mmG1!LtM2-n%HxW4Xp?0r7;VF!7`m7x^L}?1&g!}G-BLg{h4AY3V||CoP3B9cF`^nWnPNy4af^R!>gVWX;HIZh@Plj`xHg}?i(!j2 zB>JLFYX$8lit3VLpWeo;vZN6fdsDqE?1Z@3r6x|&NR{GoBWvN5iKwLFKHHS1wtv35 zY=$|ZApsF?6#44g1%ul&Mq2URka*?UNMD1clcfu~UeF9VNbGJvz@-xmxWnw4+GBf} z>8r7ZP8X~3Y+q`ctawr{F^YO-k(7#k+@XPFs~k&*iKpvefgZQbsTFTr78TR;*Wq;U zd>>_|M|c7_A|>FBV4)$dH);z(g_cOjrf=&(LaJLojunCS#ILoL0n3TZB3a@D$ebfE%Qc1uUVQxX!BQb2oDkfB6Vx+?QD%^4NYk+M<$x}G%%1I&351ok<&iSshIH`B z8+<2LyQYf2=Q%aog)Zs?GEE4mRx-S$z;Ito{$|B}6;v$v<^W%#}&*jdsNiUL` zq;d<(T|Fpq+$N|@GNXdRveqnfl=<_mBVBr;<$j_(NdZ`mE!FN@`m($H19L=8zZN%B zi})>{@bexRSp|mf$>sw}s8Qpy@^(u!F%!KeX`v13HdRGaf%m=vjKz*W5Hi1Z9&755 zoJqG=Ik^-)RmeSRF0j1q#uyCe(LXu&_4$Dc-|HAF2b*HL0&1GJv}Ad*TA{Wi?_0G{ z86VcpOPfNWMw^08eciuU9=8*=Avp#KD3$N~9BdH>Pp<1C+j#jP`gYZG9FBawl7l5r ze^p}%sm*7e;>$X`;@&$!W%xw|;iMnRN-@+{DW&_tubpYiC{VbjYO40$$-RjDRe|8! zPj~_YeQtC1!XVprlCzz%BIj&cjoGz+Yhxp2k^o&g$prewKFvGTZ5{V>HK%mAbId$@ zwld-=%N6x#7Z#ff7PRWyIPdLd2kbRt*8OQYSo#u8bD(_b<%lSLwRh}D9i+qBpxzz2 z3$?RmucZm*pUZ2RqT{c2sKpHW*ys3REF}&qCL)1w<`9?$qBUMvx$!yGNB2^dRnwNs zFJk#j<;$7wn`82;$wz-5O%Km~;|F-;WZ5)g2@Uj4L|_4sts!ri>4X4&UZB^}u_L1S z;)tTk3|XD!&7r$}+ZXFo5NPn0Wxo}+K)P5*J7igel3sVXxjNWAa=5=p560!xcf^rJ z4wjSN=W4K(6gH4hGR7Q4sI>Sa4jVrJ8p(jj%(35(mcCYvMIb4>&YxVVJ(e9ylG}9a4ga+#c$&0 zk8Enp_i`WxKK(;&0)ScN&a-pDIM6{djeNNvePugw*b1AOZF@mP0AEi<;~VP~Ust^1 zfks_#D_w;pegmkieHPjh&vp@i*T*)zZb4oEA2#AM--pK9vyr^GsnG^;np+WawagIf zVW%sy08*%xmVq3xFJd_m02hn*F9dgVkh1w9o~6+0U~{OLw=YCACy_*rIw9%w&SdRO z`YREm*mp}DeL%@QkMgIY1YVSU9_Dsc4xoJX@7xk3UL)?#q?&@t_hm8lHx~s}`M;Ll z_hvImRma^Ec=Zo+@O<4VRmNr)EE<7afc6o-^ef~rra(gJ_;@OQqA^SRZD{&$6-@-! z2C#QU$Ki_X6Z9Ox`iQaY#50A0bUf^>~;bLi+qTv;wL&&fr1UDuG0aNFw z%?qa8aEF!0of)mLXC1HAG~ZQqR9#Q!(Kp36*l1bS{W#@#_^EFCSY-n}QmjxdlmQy5 zli+)Cv#wt)GUnznu169y^CqNX{O2ngaUy?^Ay}q1{c`=L2p=MZSR5hzpd9`Qg5Td_ z;Vw`-MJP}itNwhR>%+<<2#deV{j!hOTnP}hG9Uy-_X5*3C){{VShhYbwj7O>4<7^Z z3C=hW86bvxh;rd>uHMcBu0OVzTL+|5qK)AjTG7h|>cJTSI|*6v=?M!j+o5XROkSO$ zyIJ15M8;Q2K5%Pm;j&uS#q?_(ulb7Dav!9So!Fe3M&WtT8aQB=kj7zYVFKw&)@5Or z)paz4i_{iMD+Rx@i?YcJLOX7Ti%QM#YRZME-PvzAlTRF5oR*UJ9DTJ>#;N(tgX$mh#`_RSfQ|yUa#NJq|m}jOw~3_(OP^CAL&HFWFq1r=((7` zW`XFwn(oe#3MBzE%g`q8owB$dgQ=sq>E|FReHXsQn~n%%%UE( z$y8sDfk6%uqJLMLFl{{yOJZubvbIvVHg!kMz$i-d?2GeFz9}E-crA5&(^TzNfYB?b zcw;IQxt8w>yaAL@DR-86zf#y}%Rq1{xWZgB|8xSfJ{GBf)Zk^-uVrUH86IaLeAT0a5^a|G%UFlzrwmr|EXd zEE0+3fVz+U{Y-J5B~3)JuE?+iafHd$0B0`4bZyVfmtcyhNKwidV#hw`Cv%w^R$6J6 z#;mwaV^j&!9~^!5WBVG8io4sYi<%zU5%kP25`!v+{}RBmDbu569{d#M3I_T7#H_Ds z@E)Lj5!_9J!r)b?#j=r@y@aCq_?}{kIYNZ6{Yth7j@;zA-}%uqm_uCgiUs0paD}Y{ z?YcV8_pK$5Bh#k9X?gRnba5#I>9lQm(z#ERki8fpyi(#!{WsJ=o9~XF7e8+F!JS5P zQGHVaDQ7V654l&xRE^Cr<4Z1R;mq5yKoy+Iu8KvDRvcDWrS+fmY~AFiH1iK}seq-^7;e6ravm#>LBrXlkxIY>w_p~QZOPJYPLeH&&W5;U*&>Q>$r4V5 zRg+J8_;}ICD`igmUD9~!w@R<}l95q9Bs-4W)h7%+(oVM;JIG@arGYfFOWMXI1#P!v z>>w^?fIj{>wpoA%6vEOTb0T$wa2#m-G7HXLNK_96#^$iFdXv_n^`JDT`eph9gDlR%gmkWLLjVdF<0-8374Lz=#Lq9U39;+JuW)A zP*~6L#X`6SmpMAqO88pa(gDftqKL12wN={imKvTUj(r}YQk?yDAhlwR`qbq7G};n^ zye5_B!`A`vt8!RqaLTc3uI9)cw`I~`jv zZ{J$>KkVJ??yDS7@ENs#qSW9iO4L1zTm=e!kdM#z*3abiERWxO z##tGR-aZ9i8P=aL{64J>s@ce*6Qt$=Q(S8g5WW7e-zgm+IIElyPLwYItcrh2`_B? z!+dQ^pi9?1Q_zbBTZ%NdzQ3cVfhQH2h?kRKSH5A5aVuTXSRO=jWnDTbfc&Hw@Suk~ zk)iNL>UU%R4TNqJU9e}Se&Y9rrv1}}RsRsK)#q!BH>rv(Vb2$NFf%b#AuvsDtUb2% zfiAc$Ag!XV#|vtQ5|9jYcvsTPQVjBOuD^-rZF*4pP!yOb`nP51Pk4WoZ6BJ^g6F=D z&Dzow`AzT}JkhVe{UU3b8LNu&Z$%CzDTWKONyNnNoRGD26~ZOODdtIb%!xTmu(PQR zf@Q$3=J-J|^x^VZ*{%epG|M{Wy<)WM(Ah`&_tCSH;?b~au?8Y(8ciWjcHmM~{&}o3 zM5jxF`g(-T9oX>1XXU9y-H;>+U^&t;H>&{#lG8Yi%1MY--4f@DT6v-Z4JEN0-+JV7DT5bcWy#{1H6g;DFhRFzQqbusyLseqXm# zAFoMK9gCgINV3=;Dd#>3*>D-c|r>Hg~kKPoE&Ptox{5Q~RPDN9@ z)g1s!()H2vH;@40>Em|CUGjWYvS!PtWJwp=`I^M71J2wKMbzP{r|@fbd@E-$r~}hm z)vj5A45Q{3Uq;(i?D+1zN#81))Mv8mxSzQ3MUMJ*Bq0(_O$tq`*ktY;FvTcubd8?{ z{x;1mH(58bwJvB^V+l38;G+13t^*<9vqGRa<7u-~%{r+$ba#682ixA?kr=8N!kXgX zbRMfYacv)AF?~vYzZD!R;HVgIi?5Q}oEU5rapY7{yJ;sR#{W@KYZ=i%<$@x?wvR-* z$KC85NAKfA$BI(s%4i>New~ZGBR+lhau)!SH002=j|7m+gLoW5y@KyV6_2Iso3R*K z(m$Oab1YI>QtVM-v%cdQBKmcT=5#I&kHDAzeU!;5)biF(Z*pd-|DRTZlhpKy^{&az z{xYhpc7I8A-hxDCq zb;oGaa-<1r6Ob5#Hn)-i{Odogv?g;`y0lnLtzPfcA;NJp_USGu{YQ*Ly-m9=iHvU# z3jSikFV+$+7vn0iYBR!iV*dCwTJuAh8XKDggKURcgi=T26u5&zHvQDYejD=ZlMS*q z;LVG3J9%1KgkOBB&z>xlB;d@Kz}4il{DKMvgyt9fi}DwInz}kWC}1+6I&=jBplIy? zv(@*qAypvr!uwK{-7!B%vt_XmO8MuX1hwPlGn|Hc_C57QW`Aw z>0qU+bV5Qg#7Vwk<*l#8$kLAI`nwJQpa1Ii>0%WuZDQ)`-^AI*Y%hsh9;k z1OJjhwHDVrp){Ri)>*ipT#&SwCmo8^dopV;C|vp_j@zBTqz!{Z`-Y6Z0W{l&L1nws z5}sD~q4Q$lA$9DZpU58K2(%rGB_5ZLd~-!r3A$pM*wA`dyM?^3W=kS_^T=}9VmD!! z6IX@!TN%84FEb9-#d#~zuv+dO6+Of_4qcD933;XBuGuZHT3c#`hjr&$3_bWh_mT|j zH@YyyCRhcqk7Y04UQ$?!N`xQX`u5p37H|Gn&s3de$zlb$Hu=H4&5OhI$W-xPiq_N+ zXA-z%LJFEHai>~F&*Ny)78$C~kuz1VN%|+#&dXcXGDCcq+~p?Zr$2(dd^LbkB&>DN zSwg9~GZ@B6;Y1CNN-0{A{fxk)qNt5&fdOoa9?a^V|FG9Jn|%-}MXk;9Oo11Y-lul& zrN+r?sTI$yk6upU43~l10oo1nX2QC90cu)@Jo|PAu?HJuiwQ-XUWpTSZD3C846ZpV z?!@S8fHdgeT;Qs}aB#0gG_&ut()8bE)A|}+Z}w!D-?3~((4I^@TSubs*Xv@Nl}*SH zZL5oo1C9*g*6-St+Og~IqrwhAV5af4fnuZgXxr`51J1vj%%W5B4g8M-^9*1Pd>;SW zN2lZ!5uze`@xZHloPup>p_c55O&yIU+kiJwqWd@i2fG+awS9FlzrZuGC~h+pDoR8) zv+#kl_vZoE*J(3kYWAYxe{$b5Q*^r>-nsEV%~e$T=0)IdcQJB=m4HbV!Mv~5ho>m5 zxW#eJyY5RTW!S%5J{|p*DYIG*QM!632IPVFAlw0h#|8i_tj&tPt^%(Pz=PRP3&>CM ztfQ$k#NUsU+Vh|watww&RLs@@Yx&^kUN>fpqg^J{jtD&L1x)>3VdzGl6JGg3?Ak)L zF-tpfI}OA*y%$CK)QbfPUf+pZoc^fOEn zBSt9#sqp{v!dTo(H_=z?6H8{}x%s{BS>!L)zY+FqVds}V+9#7xxTM<}!j@udh7O68 z>9v}O!Ixvt8di~pk=sDqh(gC0b6s+!U?0JH?{Hi=O+;JqFLOORRc_Q?cWGD~Ki}}S zTHg1%41uaZ0aYc`^3tFWRaRa1gvn7_Xj9gCmVj&H(1tA0`<*ATIsdNWJRC1Q; z-1tXa$451}mRUNPfb^ZB_vvJ9S@fE&E)Ir-wJv3ab_xo7}SecgN~e*XAvY zRY=X!Gu4qVOC4nxVJW-T(X`GGr8lYAPFCFmuEdcn{-# zj1P|?gSVuoDk%Jk0=wlW`{U18JPmIA>-q*4-eFt5?=GkWu>8rUS1H+j{`F^ z%G6DYlfG4F5oB8JQIk8LNB)byw$hSht0G5tn+eIhrG-MR)89h}l@W~p6ID9df!|6z zm|D^jnjGgg8upP!M4RLNv+;sx($+oAR~;>r8Pe`Gw9H*0+8D@CpG zf3}cGO_|j7AwlSY3ROXWI6hJw#NBf$FYbXsumN^y;g{L`YnMijuX1vH*`>9Al+B7N z`af(Tw9kE#bix%Hd*4irp;Hkl26a(#twU`PezD>BMMo|xVG6W)Kf&4CQn+{u*O_N@ zVt=k-hP#vZs`sg?uBL%Io}8bVz0DC_UZzY{VL_cXQV4<2637UsWByC#{{K=r_%H8O zHZOT}V^dB_#l*qWH+mMB%4!YRSS|=l>}wjN{BeFHVgl((m5Q5}H{3;;F0`Bf#gQlp zJFjv2*wTr5)W~rLXd)T8*;xjexy@gS^sPosYaNvUrSP_R;d* zo4-P*<;>y}nBlTb5z~{tPkR`A@uHJg+MS`L&3_r4z!t3%3{V2nZZT+L<9hqG|n*(C5*Zi8%fHFK5a&veAsHXS3cy z=HebOsAH!Z*#?Qf$0p>hN(Q9|7g-lAEK6>Gn#Ah!FiG=N_(1W;&=-FW4bsZaOuoQ# zb4(ZcjHeGxiZ)h>lM4)e#^{}ReAvvUyYmXDQWfTx8Iuj6wx;|##_|6F5X;k!W?35@ z)G+&WlUi7;4&VZlBS8PoT(%Czni^-cZ)`hs`s+em-BP+1&308rGP&+_FepHmWJoo9 zecORuPp}3@#dd(NABXVnrVRJz3@fF+k4X+^OQ=;S&+DO9J5H$U5|IZEi}my^CTsb~ zVqNIaO)pd0q4*;HDBwxWULf`w`6v2wa7QKFd&~8gs1H%~M3CQbynMOoU;`|Z;s!4N zx)i^pRK^#p*gS*DxEbIZyeS*m+T{E-e;A%Pwl9D-p=?=)Xx@Y%G^&P_Hc@?k=Pi|> zQWK!^eMR8F#uhQ^-dh06q>#>q(S0r8(*+s%7 z>SIj3cmvwuFrRJsnLgZdh1KQya3*!X&4?$ro`w>@EG$IcBAGfCPWjnqU%6Y(rO&cQ z_qjRZ8!Ao6K|vl!@^8q{|1o~=e|i5a^Z9f*`4}8#kwDTa85n-EiGBYDkQ50xk zY*-EAVdMYMN&kgID$+>euchya^n-ZmR5q^!I+eRGfSTX{MB#y^F&$D-6AHM-n%4Q@ zZSAu|(jOg5f9Ci9`j9`tOfT=DQ<4x$tjH>JG7YBX1!6e_zpfu%U!_#p_~jp?>zIN{ zrHy+YJc9j}Mv`pfzH=IZxjk6B4?Er%H!Z)8&&M8vF(P7ocsT2AFm&6 z4nHd?mVSdm7Tb34KnHMo5EkWr6RK>F?fsfRGI+0^LM7UCWL_EW=m`Bra8LN#dGf-< zH|4^;P|OcJiymhKcKj$3iF42TIapDBlF0!PKnTjb)Hy;Hellk zwbCpc$?8xLqM@_}~BMr>u1Sj=C3#(Hc@+nIMK!c`GJrDxV*>NxA$atY(o? z?%TefF>e4oVB!C3qC#qBS%41iNZX%!$dK7%P$VqUzT)NDU;VY2Sy z0+%vAj6(zF@)y?Szx43`5BCT@pj;IlpEgH4mel-Lzoyu1N*%`(=<%2vEGOP!0Q@^MrG_&xkw2-)G(dSp<2?QC} z(=C90JHRjbuPnnK!WV`4ikIrq$CZ@ld!2pz&osCfO^0@en_xuNUl>#`Tb?9N6&o)r zC|q>wH-Fqf)rq=#PMz={mUwbiB(J53QWV`fOJU&isFKWe04xmJ%jHG%0j;m{S5414 zZ&I4JP+Pw@MgpY6LdBk4Kh7z@j{x19*Dlz^R`RPv&uogvD8gV}X<2<*I7hN6>o5Ku z-8UjO=L<#rD_#+Yvga1kC2D)Pekvt5k9$9xyAoICu{Y0)Y^B+fB+*ouL(MwLPK%x9 zb*nild)^2Vhx@61&iW?MJ{8_u!_vEqPgeXy=m*bLbm)WK)E-c3eQ)r<8wxy(6;x+*LJ4 zMr%Sk12HVSa4wGHD6v*vSp6r44ypCckT)R@m_Fs6pkuaFS&deQR_J6cQbo^O;D8Ol z@`E(~1DJ{5i=BmZDljHI7ZB=#5fnJzi1w4yi***;x);#PiC0p`x4ZEZ+Eg=s=9(hG7mhJM?p zx%bM{dAG-Y&jYz-#-T_r+F2VNEl@`bDwW9ff(XhCD`!J%A-}3s8&ADFZ>e>yx7BvP zHWWolQST#4XW5qr86x=^c@a1NZcpCTIFMVQ|FtQrETXA~|6yMPmMt~@x2(jiHI%NH z-i3oZ>#o~{BtukD!gt7E1wwTF4*s955o+R&PozHxaqB1y#!IW;a6p~xokap&M(+R-xjNS$|!*kqA8u)OtK zyLbK{bM98<2wE#kiDwP~|voBFKmsXA-HLdz$4EU``8AiJSIL?pnSVYc&)p5i--x1sMN6(A>W z>1l5aofXVPRSv()Nme;lXXk3|a{?CK!0;q6uax|j<7&#NMR&$^k$J}WG%;2N;ugEB zbD{r^>8|o?!P)9MiPkWhG?u#0=`{+k>n7jKVU#5P1X&eVt5sH9>=pwr9P4(ZHeJW& zh-N2OC}zK4y?5vv8i@cBHocP9f_Pz=9;oLLevV?BXMH6YCoyDRELc(~vAGu#yA8#W zvH;$#%%+(rl$BO=L#JYWKYB@BgOtTkE|7zIdY53#?B`vKr~7&bnzMZmBG1lo}OYVbAZPu$fqBeu~;i$ia%PMPQlnk<7IU8oI`B(DHfGp`pGJ zTk1}Y$!MmoX=(^RS*fnAEAPvUnOLGswe3_=Y!LWA{&C*hN#hEj#{wL*?(=pt4nW(osFk4}dQszwhvF zqf7~H^mF_?R`r7sq2HK*5)Y%^zQEjQQwO7$T}$Iv2#Dyo>?m zik{p&$AX)2#1wkDIb7`&4<^vrQ=sKJr}FHmmYjSCTr9m@7?td__FeOT4D1SDInUP( zY{xaXk=i(srGZGTzwIZ|n0%hN16U;Z`0rm))7=xw2I}C7Er}dE5v$UA6}Vld&zL{I z9YX`ESQ9`d%6mj}`KoZWn9A7m&qKDFG;9>^%2Gs+l#~Df!Qp%~r2(UxZOfSqIrqnHPYZ z1_EKog=i_56(C7*0Wg!m?(xKTY(s?1zol*caA&Tr4g;?Y+TCT7CnS#2U9DK zBIH=ogq7&_0oCjfvvgnLoeE{=@_5am5Sv_Vq3D$sZ~jT3g!&&cHD&JmtpLe)czWVC zZ`=B2Ii6l=719|8V|t0Tghu2cjjS!+WQnS9C|w9$w9GGO1?Z^I5i6k z*lwY-5x#sxrtNQ3(+tepMC8BIUDlo_~=o)qVTXaZR;;7r}R#h_3 zt##2S7tdp^tHna;-rRATFq~*Mfx{U)#wZ0vZ2eQiGwO)wvD)IU#r^qy+I;5g zud+z$cQu=QEd{I6_UIB}l;&R%<{@AeQ1It+omJOw64nv-Pmbs+@}o__^;k^QASM)S z`7w;){xi#sR<{ALYT^5#P?n#GUkP`=x*?2L-kG`^7iuoEhq8*t<6sQS$PmGD@Uwpu zAm9%Mvzl*=ysaH7!X;y(@%aR*j&w6#Bt5U-IHOHA{SAa&*Fw3x!tJJyS{q0sbOc2) z7kt1YebypzF490(-&h)PC*O?q1YL(R!r$e^8G(2wG}rq~aZZDk zpxBFCpSP2^NotYNY9k0{f;f)RISQ)E&Zbn7d+93OAv()(pnrfjBTDx4|4R7wEG)yf zcK@h!H`yRrmnEqx(gybPu>h`XsqIs&Hfzi1P1tTSZ{#LHR4I(xLoG=n#N-_`gQz|H1zu%#F8>_f>^Pu~@kr;iEku)F@ZvJHHEyTuaLN z*#BjXX#6jAhW``YQ>B$cazEY+4YZqQaW^xwRDk7ABw6FU*BysU7^s z7NX*WgjJ(Z7rD0K(hWv@wY5!t#^<-;J0ZVJ*^WX`hw$IBR5$0EFb(&E5DFUd2mf}f#8FPoDALGsYTiGH}N$~eyIq>+S=yor1{zPn=RCS(&q;Z z#b*qlb}-(V>$!Tc$*k>IUbN;=>u=?NHzN>61a~8hgjEXH>BaqEP~%ln^z-8dP-NCo|X3 zf>9!Ee(I9C8!QV}c5Qfa2TpNWxC0}yo-X8Bp0+M@&@ls(3y}iox!v;HX1>q~Ab)?kMAECv$jfyyT}6<9_T>LEENMDfX$5u)056 zSod|x(5F$2yLS{6dPaJewKOQR>o_1wdad!D63|Lw$g-TuUG?ylgYzt*zZb7c4Fzqz zJ>op{vIkO2|K`B>?+%gw-T$cCMhctEztT1g#)?msLtsCd^~z79ibnVJl?pBS{33vv z-FkEY@`e9!j!xDWdj(Yqo;0dt%|PE@p!yAzE7`0#Nwy6%sf`w~Z5_{dT=HacQ zE}Lvm+&rlQISPzM8}%45K0J!`{yL>BK3mEiARtf|8=$g7mU(S9DvH_gU+9Uvv^^Vn zAp~i5(S;3!y7WR~ohadN#N~oiFzYtjxP=uc62AS~z`obNz5<)F#h1>;QN_IooQh6Qv{F;nGB7sXQ}Wj6I{r(P|J?Q zpPa$({BvtnF3)q`tx@7Ym9A^+>*F6rsF9bZu^ohL-cFY;>i<}qv4#Bq_v{-qJE}0g znUVHS17UpQ9U9P+t)db;+ixJ#FvYJxW?~oTvGg^+MDpMD8;*!fLI_MYUf9ZuGi8#c zLa5>HhB!Q7qesg!eX~U}rZ~TIrYze#mlPhoqo;)2fL4Xb~XO`W?e4qVWqJpR!~aAC*}5fW>mqb$xuZ)L;534 z_hcYF?I|FQr9s%4<-906Q{PMKp1gIwJ>aZ=Z^ zKGuzB&sjQO=pab)XEN3I!Ae$z$NgZWKMpZHqnUC+nna_oSyDKlh}sAtzTbF*?{2DJ zHFCH-#uClk_vVx4tqI2{?6;`t$&N46mZbsjdq*xc#!LWl-XSqVA%cDZ5HG}GjH0@l zrs+A$*9kwQ-e0@#6K}~bq}8)S;D;n>eO{Pw6$zXGbTs5wChOX}@+{~4FoUoFgvtTd z-Q?5m(>Au)MH%KT&b23$ySb8TU*)X^BrX;E0-Q1#Fdbhx!3xs-`OgxKTGGv?r<= zK|9(Z!QD*~xi5qKp0E!_Kx+N>?ie9k0YqtI$jrv(@D;XbRV85@ntqTfY&rO2Fz@)j z#Cs3Hr2e0LzHL(ZIZbl`oijZW({uL(@p+}{`;j>1yJ9i*vJ`vVbE$_JZ|KTzKjxQc z_Kpv%etY7jj%jUgo~B@49=#ZFtJ=T1DxNP_pS9NCKXc)w;=7i0d4^hE5v3=^{9>mb zE}m}$uuYX(x$g8uY)FfKvb`~F5KgV7|CwW}~8skaINcP z=s;s6JqaTD#NoS}!G(u!n{D%H566@Pm%?|=tUu<=O}8CBaZiA?4p~=df z7KxSW?RI`Cow=^aIbBXR$0JWm)~E*7w(Ok;Mp&|tnNso$u2KO))OK<+Z;ar1c}B_c z_mrbsiU_KYb5BzM<^1pNg<}_EdQXRYnkBn(DaOeHMTDO#LVtD7JR3Van$Hs_>Zz3b zo`2$Z@3OZ-I(1#>v><~MxDwXr_z=9HGUAY*UUX(I8M>r+q%)e=``(L+E|6e`>!x6Lt2d?b7KSyhr zavs}PDMl^3E$=vx>u|jIgD}jWQQdSOuvju4Z#?^|>Ju!k3p6CY zMTQ-<j%MG&ji7$k~;>n}C@??rb)>K1CVfevzr3KKc_L*RjWXMXh0Yj-Z8Q&cu z`PH*>m>8B#1$kHeyHHx1PcCNE&&CtD9yykUi!?Vexf4ViACpC~8tjB71}r~^EAAA@ z=?I`;^MZIDHzym%0%*fv);y=CJon&ryaGwuuqD$!WT1s)S6*+!9U3tqn$X6@!^JZU zYuAUDx{y6i0}MHKY%8TeFa`ZrrQu5?Qx!1-$J*LeUM38S-i%W{Y@KEfI(qJeAT5S0 z!Yg$#p_?LGN#TH-JfJ~6hnXb6 zq#OAsijb(59CYkUSx5y>CHVPZt&&8~3q?9J;!veHtYpB^?fOd}>st%h%r&5`-t|9q zm?>V-*NDJ1P%8Q3I^(R2u49j0|2}ze4otx3tJh#>h8a_2lR~QBl40FdlpnXGdVR@h zI+`XR|KBh=hTG+w(mQXvu*YMQ%-nTDK7bt_Vo)@x3wEvyrX2=2xM&DDA32nEFezd;3})z7b$W4bLZA zjH&RrgU-i7@FNxm?xbW3_!m&@kRSfjEQP7{R3n^s<(e~kRM{%HQ=IE9BKRqPLOMUh z=(O2*DC$se0(l_}?OQMu02$WkYPpqlBMEj~bnh7G9x>a;m14h{OK@`PFsQ48Z|gA< zdH)>*V%!4~Xl;2JcR66e=j)2+fSDnJvAiA$`M~DmuL&!YSdZM@8CMLzLCOo5|6T=8 zV`uy40Gy69h>pAB-AnOgt)a>`zu!Q+n_&Kdnc3RdDZU{ZETNr+1A3+pZ0H=LaKu-o zrE?!QfaD=6KcIR#m*cr-)HFPq7BlW_DxowL(=vBvi75WU)Hu4cRjDOy$ut680r-aU zKxoyLJG&Fj5rjUM)o;~8rN;-hIEVg)3Rq4bZe_Q%IaE(soYk)s^RO(f9|$P- zg^BkiwfhHO3EFZ7Xc{1(q|tS!uL9X(#c4$vaxtV_E0o0hXW9ZFhIs#+V=)aqD2)pP|r#CdeE z0-^CC^jv~1x`qOctJciE-zfUA;@Job{BGeE{Qs4A)^SnxYyKZvS`Z`!6%Zr@q`Rc0 zy9Vi!lJ1o5RFDvc98zMC5T!x7C8cLTx@+7UpYuF>cK12I-QS*b_K)2^cnvR@xbJ)J z@ArFsKiB7aU+3&dbfCRcr*>@DTMx(?@d4HJqyWtcuNEuF1m3QZqYP`w z*xZyGp%_Y~tUPs|64*j$0VXy2u~xX=SO6ceI*3dst%0H1I`T&!W+&clKeEdM(hBLy zz}DMJ>1y%H)=tDx{!>fvXaN2m{ zGtv0k2LrlQ!5$HuyLAym2rVwX7H&a02KtOm@0@n_a}+@92IhSha5(LJrSO><;2LF# zzqoL`#;_Y+xvbk%MN*2=0rIeSPUSh_jr#jXydzV>omQ1oNbtVsWi^whgO zM%Mk?XxsM&K~PG^_}UgT)%p)(c{b-nV8RDh*?!Dk z6}G?rHaIpt*^(1cJ3#nFQ21njK{=fh;;!AXn{6s1d0}-=MMC#3>kG$-4BzS=*i+%D zTLpvzRI*>NTC6rHExzrA2fK++jTq=kVvOmI-+3}3gi;(D(t`XH~`NYAx;JT zt|4HbnW5kT+S8PfVE#_ioT$6u%Hf(ycQox;x9=F8zo38i&iiUw#JN*z@47zT$E{@3 zowB~BWUe4Y(xOGG#-?`$TP^7pVpmi6ZNO4ab0yo=P|fu~k=T|W6PjaZHhb%+uj2b} z-*mx-5<*<9$&|1e9h0{ABHidm6@!CI6=k^%p7byqRe> zsas7ySQ>;sV>Mg64N4H`lJ;=dN!YxrIzL-&Z7B{{NRSilP87!*uf)tLm|v*sfxTX% zo3c&5W+D7M`DnIX)s~Fk?ph9awnRnSiUJLe0wS1zl>)(uwGCOlUiZv>&l==G;7vv3)Z1 z6BpBm3mcQ2Smr~{k``B!7S@Ff^7s$gR_!6QhMejwDf?K#$40nq+UW^)Iv%n4!aBFV zy%}asrQ^SE6{zI;iK$iT)jc%1+OJvao(>T5HMZeMTv}zxI6rH&+MCIvbl(Wu(ZRm{ zMceJPA*0VZ2yNzO)o1DHcj(sjPPq!LY?00#g3JW#cQ#EGj=2pu-uYeJu~PWan$*SR8;{nW6G$=k{@?FWs{ffEz23ujyL7JLAlf& z*oiex>t^^2=7#7Bx!PGyf%mZgrYIW4-7S>~q~&YUY==4(W@?*i3d5`Kb61J+6?4f) zw6Vg5i&T-aC!V(-UR7?y4*H=Ub$@(VvB5`oa5>^0HE;=ro>-U_bZ^v{eI=8!jn}qs z@eAZ(pJ7Li-}!;Nit$x(BPJORjq`^@J)w^Ox+^`yBDC#Y^bL}Luvy>faE?ywIW~(S zZ08ZyFsj|}X3NVX`P%a#45bD1nX#3h#E=@O=?}l>e5&MG6f<Hd>@w^AgXNdj?G1DeU6+rAMU5e2+ZW43WgagdA01i zC#SEz&G-4i;o|r1sUtzP(X<5Df=cmoQ0XZL_n3a;3Xx(<4WcgmnAEg%zHfiXvUr-1 zck+~q{3nRxe_)qdS>S0Bo6rBqdi)w_J0+!U%Mxi8#bcxM>MfBh#cCDW@x#A(1oP8( z##5;54SbN`BL2v0iz7OZFh6F2&KxKieu( z@%GXHjdATor`w^;J9pcKq=02NVBt3=0xBjX8%z2*pQ7(6^i!Y_M?3K*31}paYc`r3 zx+!WJquq*34e(sB#vWSeU5Tqr74f*D(C7ja&cl)8zE^`f9aczYdjn+aBVd*ru(Yh) z8ig!89AAqKkvV;S3iDva z_?)V;6(DG%PGZ^xbj^8wx)l2n0LL{vvFj_oKJgC;MWTz4ttvU*k6UMSY^=b(+8XsW zUQ&|nn1Kiurkora$fE{6e}l-`uVf$4uWfA(gm4-U+27$9>?KFZJ|mH|VWeQ|-{)pl zc7`g*^UvE>lmUTiTqcsVD57;EtMwX50_-7$fuL7-8|bO9SDu(}(VmAAN&OM z2AtpFlO5xRs+A~ORZ4rYpSXQKNShx{tU65YbQY+H+Uh{utDC6Ef#^=xZknW7<8nQ< zO28H&V96XXQCEBxFNKd2*{3Bq>tigvmiw{NeJ}nh+S~Ekr|6&(YrtnH6u2)!?SMgD z>59~NhtDMjubd9<|d z)JJ zYs0k-u%NZL+ej0z!Up-u9?v>tY9#qfvkui?INNq7J|RPILc%WMj(hb(lGh`TK04Up zIBAx$k!kb-JNdDRE3snhq3B{43VuC}RI#PANo~6@`65d{5=M#&>!!TUy5sriwA#k( z`8O}#K$w7?{BxSeW1Y>WJ~>3SUt|s%!%#%_w+$Vv2Z)MSsITsrtg^RB5Ah&p3#M3}L7>v=`>Id8`ycSz;1N2SuR@B@?l*PbhfPlN{U zfAyzH)r2d1|A?v9i=`G#Z~CEg=22*bn4v14W4qHUkf_zTJ(HiK9M%Lus7eux$UF0N z+>u%{@EWe}h$#0n2#kXH6FgNoh3}Q!VCZI|%eg1x-`6VcqT7M3xn)%gF5cNhS zgm%*7dpRW*-??whvEB8GKwx*FOv~E-xy}@y(BTI9O;;~EAVZV!_he=M`nACuKQ40* z_j9=4e`$;#Qh#ZT&cXaw@ZZGqr_wz|BjS_coE2vd-MY^WKl8;mG4HkS zS8`5XQ5D-rLn5d$ov-9XEohcoI#=+RA(QWema9u-xQ;~(X{@xvn|vy|2UFfw8cj75 znU(CMFQd9>0^uY=c#J9h5GxMUj~y9C6(ll29RR$8 zBxZTVowl+d@Wi|#F8LOl-l1pzvKu?4H+zSD?L&H;QV<#lB}VJL9Oh%Yvb_S9CZN~d&28$0UG+zgtd%1rMx!;MI;x-!o2+a7la`!VfEy8YP>ydwF z#!FV$aGywAuRzQw?UeIJ4Pqv2q`{%bJkxM7pt=IMhV~Rg3E`EO-B)6QM+W%J3w;=2 z3nWoI@KO$z((JqHlln9=?0iLv^F`1rvG4D~!;!Qz`Xo83o#WqEpNP4)h6i*XREonw zWr8$8pwDP^g8Zm)sr=*>XBsi2dGT*LO*c&$yqbVeD5@rgxqL=Q#axs4u5Y~%K41hQ zwasnFdY|?UgsuoEeeHJt6TVQ4x%CBlw_ivTS5FtXnI07t9&_%Io~y!qWFSX3IwLGw)OBAoOktG?jKQXT<-<=XsECWH}5)ks{Ww%42fVMy3o5c4#^#k1WrV7?j*cq@r~K~^xqQNB zd(L@un7K=vyRG)Pc*n!UiL{!1PTvFWelZnU#%Bx4fMCkO*yw#!>YraN!0Q*Rzu{yi?M=OIh4c4;_ zo8`y%wnn&VBksa7?~jA(-|e@akzf1xi)DE^*g(d+^5eSB$}p%EPA6L~a-^jNd)}u8 zp_||K9{(HyCe8D#R3HAP4HPFiPhu0uE+N2~xo6$Vlfhj{UVQW}c;Q%kB3p%|`D}tf zVz>`#a=ljOQ#rnAT}T&3axs07al`NiX;B$-U4nt+;4VAS%OT}(e&~cgRVDAm`mCjJ zLb$v4&adda=06E6Q2wj`*Q~=fk5jxIqbbs(-R)f0aLv3e;qt0}8#R?}LxGO`hm&%E z0#J+i7bjmr%;<>t?Pg%OymvF9?&*P7#BgYZNtEl`sM_d`l2U`i)3#a(mfzIQ7~C@d zHE6=?Ol(9!QC@K|jyuNs2cvS@V(J4vA%(F(>)*DQ* zET?y0s-CbG`jX8C@kG;T&g5(VkpO+Mfsu(o^1v_n!hX2Eao7J$lGFT)Odn_v=&cDQ zzgKEA9LmevY3T-q&!?M9kT!rPEL3sanabmNdaD5Gkp3pBXQl{!Bqu!QK}ulbnjf1c51bzE(i0<%sk(J zd_e|6hW&NFQ}Zn#L+{IHM|}}mhFAW9DPR3SVIeBNTyx~g*bZt-r(!RpS=DI%l-^^q zP-Igu;gzg62yUHMvbdR+VW!VE-h@BjHY@c-2=el~Gl2ZE&gEWY^43gI6{>zOUi2r3 zcA``xg%4pG<3tIzZ^u#@vzKRdf^E|ALsEO-?%86jmK7rk?do=B!bbD@1&v^db)l?y zwgv{xi^Orl!Lt5KiIUB%k#i-Cu2CNvsml zAVNKi6_;5g@D+Synn+cG_8}&L?~`0{YmF};U`Tx3y*&I0nx1TYnRK45BfRFN;Ig1N zucI&IZl3ck`>)>PL$hM8RQ`3+df)E0HeUpo0%xh=hwO^h@mD{Bx%TT=Kat5F=h?RQ zvt#7neWrBSAbcmH*mVs`dwqIFE-^82%&w^uiABQ24VoLt%BSkEXNwlohjYW^P)v0R z>R=(QZTA@#wgA<-Aoq6C_Pi%9f#gAY-zq%vs}XGq&gw=g=6jg=ZhlMOr!=@Ll0INM zC=X)_>`pc@tm>fbjRSck;l<;<#U35s9QPJMfW^VE-03w|DZ=cUKO`0OWa_=uKdP(D#Thxun+A^~9F@@pxEn^bj z@reg;iBq!s+1zWJ?R7&{o~N?`nVq>6DwgPdDV{|f%rVc;v2b(JRFEafjy4RSEuDmT zEj1a$st;|$P7_%V=lizTxvJ(9zO7JfBQ$K`bY}%ia#KRuqj0=;*>@%b1-I-jg}zzE z&1_O+&!0T6ZZMAMx?X2#Z+|d{w$&*DUT{TuyR2zWcd&O_~ z6cbc>ATNLjmU1U@c!kVYy}3$ z<4EV7iu1DNS)B`M2Ex2BgO_!*hphL|`yJu&+bhn6`X^UX<%?TW7mnfY$AWE^q&rSK z_YOD)J8@(s#xp=$@Cr)8dvi*5OJ8fONSrqLV$ED}iA_?7L0EGkljXW+BNfeV#n$oY zHWsL2sV>RsNgRdZ{+aP>;`jVWdl29UQ*J}Ix}i2Fca3ec-F1^}^oUIH#NCCHJmJjs zk;?<%4Wrg!$0>yjq>zTQBTs0|2q*Q+7s?X7Bq*~ZhI0FJ;Y(wl;Xg*MTMT+G+4&Do zw`aF@qkfe4cg@f_ky|U)1LeWXIhUxC}Annq}MY`re zI7t@CFHVHyktrx_|ENLqH{OTH@Ogqv*;WGu5!N^$4D+x_xqupCRjZBusIx8p9UqGp z+Cnt6U!)v&`etbqtjOb#ZS#se-tXhpYwLhEt>P~$LLxYqk_MiYc#Bp|WKowBm@ZZ9 z6f40#6T8Ho;MopEdpbiED?jVb?TYO|nup%k5bX`FaHLL&Ou$DR~2>#S|D9T<8X5UO0;O64` zVbRc_n<>gP>M0~mRghPH9Y(b@7rcOMTkPPgzfhX(eNZDewq~`-XU5<%+hSu2CQ#fZ zKzN($9L&zy#FL~=SqE0RlB0)o1Ej+Kvqoo=Qh4@V{4%A&2pXRt>j8$2@5H2vs01j0 zw_K|}MC0S$MpW%3>Et%+Qj|~@Po)Q>_%kt_{9S^=9@mxDw5=#nx_a#xBwe>b$@Ft| zv|1dGwoqem%PqPXAMLo<0`T+T86Hkt@?T;>Bu`VabzYcxqyOUq|N@9@No^EL% zE;VFP`~wBdq%Jj`j{z z+e73JOhSS;yT=n6atWZHC)3lii9QI%0KK@J3YUTAQ};j4k>!YsS41UhGQU;}#0332 zjzP)1--rTUR9AXLgkfzwT={#|^DR4dZ{UhnPxRD1uj=sm*K>Qu^}mttbMB zkj8`$R#ai9JwvwPmo8rxk63yENtg}E!*&%**zQR1Jc_*Ajm{)YM(X32LV*9&HxU4* z0Fp1x5Rbmz) zLlT`i76b`HeU6(nBZ`;w#;@iG+RMQcuJcA$W=noXFDKn#ak`G^>Y#^Davi9u6hdh21H80&d1E_548H?V!7IN7iY5- z@Y1&2_0*>NT2ev7V5NS`vhM&JjlWVNFOXB1MKte%^|r0PW`^(N2!!8D?P{PDh0cbb z+M~SjPimqXTM%?$XVX*vmCJzkv>)z*-TaiJ2( zZF&hHg1~hEJU*j5ySnh~+HDK}@iB|d(Y_^ux|d33=@jjdC^4#cyqSJdlzF@kZOO;a z|EsD+3Th7nEScQoaE00XQU@|3POS`E`ndavrY za*}N~^!Tiq#l+3RymFaPbkiWBd6k?D=S$eKlkLQ>Wjk@#=$L0% zp6UTTCb~H_kvNUv4ELz7p5SxV@`AFh3WdPyUiXyl@p=Lgfl7_CEV6cQ_uwgFeb!26 zCy9*ZW$h$+&N0@x$+}%m~t<*z`*>+9psRIcqmZk5uFF>XU0LTol z%lN%Y-U)8IYZ{|;r&RPMb84s`zL%Sg0>Q4?&fc3%{)hsyN;4^${jicey-Y)d11myM-3mI`2&zKR6x}BjH3jn3{p-o+J zJil>*GD9-RA{~5{OrTpj+ANONpO@&{^5P|;4gilv$&`vK@+asF6PGQ;@hcM)>MOYQ z6XZwRvyH z^k$Cn=PBkV-5iT&)zsT3pXsZ!QF1dKktVge4~X@?(5=j@^TRg$21G5?6+f z4lfKdko_NZQ)>CVouMdK6Yu!&0D*)@i4aUsWff>*uJEQz1SG{KRqVBJ$LK5 z-NuUJn>RzJztmaVN-s3SXAuz84_zCgQJ-_xwEzDuDuj-^Ru!FClB&)MY*TI6F)~0b z7dxSAPB~qeikU2vP`tbo&p72zb1-J3RC~-Ju(Bt%Vn{ks-uZ4Dzn`5XdP3LqQ*7EC z&{cJ&GQ6x#*B9F4mO$7zk8@3Ey9#}+J}F3pBos{Xn`x}mpZ#nnNKlNPgv?OI zKXL*we&tNK^3hGRz0G4L9L={^(>4RZ&dO8{ODHVILj}NY9=PqCRo^Av8r5!|O??d)`WKRuJfiZm)BW zEx>Ab)y4IRs0S!c)_nl1-8vUXY{m{i%$xl}%>TM!SkubcuDEJ*nqDi9qd{q&1`uul z&-;~c{avvBCp_Z74uqX#)S{Aw6`bLQXctrXv+F;)o~lUNb{2n35mMGB?BK6e zQ^&*s^g;5%6wEAX5QhwwtrK}EnczTqVVzll{5n(iDkaY^KircXfT8SAdQ#0!j}?7}J~?a`JRF8216OQW<)y+ibI0hH)&t~z&fZjUnA z@6_Ex)2yy~S8VW+NT0K5Cpjd6z>h^mcaojk-sicOFKlGjP`?^CEX=HrQ)K+8+u^2n z*NxBC{bW?O1gt#$jVXp*_@;%qVX5|5?<1%mF0WaPY?Ze;^)SZFUnjc%5B>h2;k8w) z)^ss3U5qyr5VMrD99O(v#HuM02|ss+0{{fA(*L0E{jT%<+2fM1rj{s!r$EL2iSQgc z+v&4enYqgi2a&BtdQ=oT#sbT&M$DXL5wRcoG0%I*1qFGhV#8%LrY9ZJzxS~6@Vnt= z8EcPM+(#F8bnv+Kg`6LRmn4`hPMwy}pF=48s!yS+@zec~U{U=L&F1V4#XXvMhL-uY ztodL?XGh2TIt?tu36M0fKrh95lddqCnWJ6B48z36H@DzzR)Z-bGIUO5{z0FO+!A(S z+9EK#(c#^wVVCQ;bZujlQq40h$zXCkE09%;k17^Rq3)thNQa$${(_A+eWQ!8>YPIP zT0aWb3%qG`Y9#3p*jl@O5xcBeHEI5yElHSe#mrK#%DX4ST!9VSQOCIK1h{s%vj$l@ z>Yw6Pm63C~og1K?kQDk3a(bHjC}8ehyip#8syEiaoCeg2pd1K<)c|&yg6DlZ&EO)2j$X zeCE-B`o7s0_O{t`Hs=%fv7qRCyxZj0ETw7O8H`cVcyR@KDw2e1hV${SDaCLX&Kyp* zA!9kN+C#L&5XQVD2@2{!=P?qLPCLqg$jr~YI((;TWcqB)9CJ!GIOLEd22fD*Mq+oN zvyo2Rj{50Rf3ktO$S{mIH-^(a5$A>XXneT#Q-e-BpE5g-NzQH5(Pg;TGj?&w;vRBD z#`w4^1&@fw^K6?$*8#E9ky)m-b$CIOiLAtyI92UUumXO(3@8q2&h#c8@7#L$p`>6I zHPY>Y!K=5yzeUqPXOh36SN_c;!T*xylkPIwc_t>H>gx_~jJ!d++U%5eUX7R<>RROF z%-MCI3NZYWX5;_e*k6lEGr{)sM_(H+(Mx(KV9x?Btuo?q_4C^FR$K_{TB% z{&cbX2knsl3Ga>CvWo9a{4fFME7c*q3>&Fs8daF_s`JU2g9Dw>Y>deljq{NBHUI&v zwZoR}t`5^^4;mF|M!pzJ!!$6%Zb;3s^D`5n;W{#I6Q^}wEbs-e`lo#L z(Fv9u@N(wp;_Zdef6mjJi>v~8Ch0Svjgu39$RU>iOl14u_cOEc$RYO{{X zyPz_|fFFOH|NA*tI=&{I@zfl_Ta>~pzTv@)Ok|;4t&94 zgUI*Yo+pRLJ={`gQg`SK6(5UrUA_{1gBtiKuT}Why5rzt7plf*7%7xic;q0t1MzoO%ua7(|z6S@$q-*f1Qz%}4 zf}^_BzU&^`8He576`hB1NyVRUz;Y@iaTcEbpxP0HLVx5Nfc;x+x_{MAMCr~d68wSY3e{r#M@$RnNDIn+$grt*=VZ_ zukR1CdgRGz3Vi%)YYecrJJ?xsozt{u296)*;Bn5jRX+9sjq_{{L6c JkM`%ce*p^~en$WR literal 0 HcmV?d00001 From 2d9af2231e51a59f5e5f994ed8cfe4401b7f34ca Mon Sep 17 00:00:00 2001 From: huanghaiquan Date: Tue, 27 Aug 2019 03:22:34 +0800 Subject: [PATCH 16/23] Updated readme; --- README.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 8f272d14..fc8e42b1 100644 --- a/README.md +++ b/README.md @@ -55,15 +55,16 @@ JD Chain 主要部署组件包括以下几种： ## 三、编译源代码 1. 安装 Maven 环境 + JD Chain 当前版本以 Java 语言开发，需要安装配置 JVM 和 Maven，JDK 版本不低于1.8 。没有特殊的安装要求，请另行搜索安装方法，此处不赘述。 2. 安装 Git 工具 为了能够执行 git clone 命令获取代码仓库。没有特殊的安装要求，请另行搜索安装方法，此处不赘述。 - 3. 编译过程 + 3. 工程代码 - JD Chain 项目包括 3 个代码仓库 + JD Chain 源代码包括 3 个代码仓库 - jdchain - 这是当前仓库，也是核心仓库，包含了共识节点、网关节点、SDK等一切部署组件。依赖于 explorer 和 bftsmart 这两个仓库先进行编译安装； @@ -73,7 +74,7 @@ JD Chain 主要部署组件包括以下几种： - 地址：git@github.com:blockchain-jd-com/explorer.git - bftsmart - - 这是bftsmart共识协议的工程，需要 + - 这是bftsmart共识协议的工程，需要先编译安装到本地 maven 仓库； 4. 命令操作 From 8142c6aaac6efc09d61199ee3cb460b37bfd2867 Mon Sep 17 00:00:00 2001 From: huanghaiquan Date: Tue, 27 Aug 2019 03:30:07 +0800 Subject: [PATCH 17/23] Update readme; --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index fc8e42b1..675472d0 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ ------------------------------------------------------------------------ -## 一、项目简介 +## 一、项目介绍 JD Chain 的目标是实现一个面向企业应用场景的通用区块链框架系统，能够作为企业级基础设施，为业务创新提供高效、灵活和安全的解决方案。 @@ -56,11 +56,11 @@ JD Chain 主要部署组件包括以下几种： 1. 安装 Maven 环境 - JD Chain 当前版本以 Java 语言开发，需要安装配置 JVM 和 Maven，JDK 版本不低于1.8 。没有特殊的安装要求，请另行搜索安装方法，此处不赘述。 + JD Chain 当前版本以 Java 语言开发，需要安装配置 JVM 和 Maven，JDK 版本不低于1.8 。(没有特殊要求，请按标准方法安装，此处不赘述) 2. 安装 Git 工具 - 为了能够执行 git clone 命令获取代码仓库。没有特殊的安装要求，请另行搜索安装方法，此处不赘述。 + 为了能够执行 git clone 命令获取代码仓库。 (没有特殊要求，请按标准方法安装，此处不赘述) 3. 工程代码 From 81c52e4750fb636479ff7732f69fede2586ae918 Mon Sep 17 00:00:00 2001 From: zhanglin33 Date: Wed, 28 Aug 2019 16:32:05 +0800 Subject: [PATCH 18/23] replace invoked curves api in both ecdsa and sm2, and modify junit tests in crypto-pki --- .../crypto/utils/classic/ECDSAUtils.java | 12 +- .../blockchain/crypto/utils/CSRBuilder.java | 75 +++++-- .../blockchain/crypto/utils/CertParser.java | 16 ++ .../SHA1WITHRSA2048SignatureFunctionTest.java | 145 ++++++++++++++ .../SHA1WITHRSA4096SignatureFunctionTest.java | 186 ++++++++++++++++++ .../pki/SM3WITHSM2SignatureFunctionTest.java | 80 ++++++++ .../crypto/utils/CertParserTest.java | 12 +- .../blockchain/crypto/utils/sm/SM2Utils.java | 19 +- 8 files changed, 509 insertions(+), 36 deletions(-) diff --git a/source/crypto/crypto-classic/src/main/java/com/jd/blockchain/crypto/utils/classic/ECDSAUtils.java b/source/crypto/crypto-classic/src/main/java/com/jd/blockchain/crypto/utils/classic/ECDSAUtils.java index 097ce957..73b9e7b3 100644 --- a/source/crypto/crypto-classic/src/main/java/com/jd/blockchain/crypto/utils/classic/ECDSAUtils.java +++ b/source/crypto/crypto-classic/src/main/java/com/jd/blockchain/crypto/utils/classic/ECDSAUtils.java @@ -7,6 +7,8 @@ import org.bouncycastle.crypto.CipherParameters; import org.bouncycastle.crypto.generators.ECKeyPairGenerator; import org.bouncycastle.crypto.params.*; import org.bouncycastle.crypto.signers.ECDSASigner; +import org.bouncycastle.jce.ECNamedCurveTable; +import org.bouncycastle.jce.spec.ECNamedCurveParameterSpec; import org.bouncycastle.math.ec.ECCurve; import org.bouncycastle.math.ec.ECMultiplier; import org.bouncycastle.math.ec.ECPoint; @@ -28,12 +30,10 @@ public class ECDSAUtils { // p = 2^256 - 2^32 - 2^9 - 2^8 - 2^7 - 2^6 - 2^4 - 1 // the curve equation is y^2 = x^3 + 7. - private static final X9ECParameters X9_PARAMS = SECNamedCurves.getByName("secp256k1"); - private static final ECCurve CURVE = X9_PARAMS.getCurve(); - private static final ECPoint ECDSA_G = X9_PARAMS.getG(); - private static final BigInteger ECDSA_H = X9_PARAMS.getH(); - private static final BigInteger ECDSA_N = X9_PARAMS.getN(); - private static final ECDomainParameters DOMAIN_PARAMS = new ECDomainParameters(CURVE, ECDSA_G,ECDSA_N,ECDSA_H); + private static final ECNamedCurveParameterSpec PARAMS = ECNamedCurveTable.getParameterSpec("secp256k1"); + private static final ECCurve CURVE = PARAMS.getCurve(); + private static final ECDomainParameters DOMAIN_PARAMS = new ECDomainParameters( + CURVE, PARAMS.getG(), PARAMS.getN(), PARAMS.getH()); //-----------------Key Generation Algorithm----------------- diff --git a/source/crypto/crypto-pki/src/main/java/com/jd/blockchain/crypto/utils/CSRBuilder.java b/source/crypto/crypto-pki/src/main/java/com/jd/blockchain/crypto/utils/CSRBuilder.java index 790cb7db..3de606db 100644 --- a/source/crypto/crypto-pki/src/main/java/com/jd/blockchain/crypto/utils/CSRBuilder.java +++ b/source/crypto/crypto-pki/src/main/java/com/jd/blockchain/crypto/utils/CSRBuilder.java @@ -16,6 +16,9 @@ import org.bouncycastle.util.encoders.Base64; import java.io.IOException; import java.security.*; +import java.security.spec.InvalidKeySpecException; +import java.security.spec.PKCS8EncodedKeySpec; +import java.security.spec.X509EncodedKeySpec; /** * @author zhanglin33 @@ -25,16 +28,18 @@ import java.security.*; */ public class CSRBuilder { - private String BC = BouncyCastleProvider.PROVIDER_NAME; + private final String BC = BouncyCastleProvider.PROVIDER_NAME; private PublicKey pubKey; private PrivateKey privKey; private String algoName; + private int keyLength; public void init() { Security.addProvider(new org.bouncycastle.jce.provider.BouncyCastleProvider()); algoName = "SHA1withRSA"; + keyLength = 2048; KeyPairGenerator generator; try { generator = KeyPairGenerator.getInstance("RSA", BC); @@ -47,10 +52,11 @@ public class CSRBuilder { } } - public void init(String algoName, int KeyLength) { + public void init(String algoName, int keyLength) { Security.addProvider(new org.bouncycastle.jce.provider.BouncyCastleProvider()); - this.algoName = algoName; + this.algoName = algoName; + this.keyLength = keyLength; KeyPairGenerator generator; KeyPair keyPair; @@ -60,34 +66,69 @@ public class CSRBuilder { switch (hashAndSignature[1]) { case "RSA": { generator = KeyPairGenerator.getInstance("RSA", BC); - generator.initialize(KeyLength); - keyPair = generator.generateKeyPair(); - pubKey = keyPair.getPublic(); - privKey = keyPair.getPrivate(); + generator.initialize(keyLength); break; } case "SM2": { generator = KeyPairGenerator.getInstance("EC", BC); - if (KeyLength != 256) { + if (keyLength != 256) { throw new CryptoException("SM3withSM2 with unsupported key length [" + - KeyLength +"] in CSR!"); + keyLength +"] in CSR!"); } generator.initialize(new ECNamedCurveGenParameterSpec("sm2p256v1")); - keyPair = generator.generateKeyPair(); - pubKey = keyPair.getPublic(); - privKey = keyPair.getPrivate(); break; } default: throw new CryptoException("Unsupported algorithm [" + algoName + "] with key length [" + - KeyLength +"] in CSR!"); + keyLength +"] in CSR!"); } + keyPair = generator.generateKeyPair(); + pubKey = keyPair.getPublic(); + privKey = keyPair.getPrivate(); } catch (NoSuchAlgorithmException | NoSuchProviderException | InvalidAlgorithmParameterException e) { throw new CryptoException(e.getMessage(), e); } } + public void init(String algoName, byte[] pubKeyBytes, byte[] privKeyBytes) { + + Security.addProvider(new org.bouncycastle.jce.provider.BouncyCastleProvider()); + this.algoName = algoName; + String[] hashAndSignature = algoName.split("with"); + + X509EncodedKeySpec pubKeySpec = new X509EncodedKeySpec(pubKeyBytes); + PKCS8EncodedKeySpec privKeySpec = new PKCS8EncodedKeySpec(privKeyBytes); + + KeyFactory keyFactory; + + try { + switch (hashAndSignature[1]) { + case "RSA": { + keyFactory = KeyFactory.getInstance("RSA"); + privKey = keyFactory.generatePrivate(privKeySpec); + pubKey = keyFactory.generatePublic(pubKeySpec); + keyLength = (pubKey.getEncoded().length < 4096 / 8)? 2048: 4096; + break; + } + + case "SM2": { + keyFactory = KeyFactory.getInstance("EC", BouncyCastleProvider.PROVIDER_NAME); + privKey = keyFactory.generatePrivate(privKeySpec); + pubKey = keyFactory.generatePublic(pubKeySpec); + keyLength = 256; + break; + } + + default: throw new CryptoException("Unsupported algorithm [" + algoName + "] with the given key pair!"); + } + } catch (InvalidKeySpecException | NoSuchAlgorithmException | NoSuchProviderException e) { + throw new CryptoException(e.getMessage(), e); + } + + + } + public String buildRequest(String countryName, String stateName, String cityName, String organizationName, String departmentName, String domainName, String emailName) { @@ -126,4 +167,12 @@ public class CSRBuilder { public PrivateKey getPrivKey() { return privKey; } + + public String getAlgoName() { + return algoName; + } + + public int getKeyLength() { + return keyLength; + } } diff --git a/source/crypto/crypto-pki/src/main/java/com/jd/blockchain/crypto/utils/CertParser.java b/source/crypto/crypto-pki/src/main/java/com/jd/blockchain/crypto/utils/CertParser.java index 8267d28b..e54c17db 100644 --- a/source/crypto/crypto-pki/src/main/java/com/jd/blockchain/crypto/utils/CertParser.java +++ b/source/crypto/crypto-pki/src/main/java/com/jd/blockchain/crypto/utils/CertParser.java @@ -25,6 +25,7 @@ public class CertParser { private String sigAlgName; private String userName; private String issuerName; + private int keyLength; private Date startTime; private Date endTime; @@ -71,6 +72,17 @@ public class CertParser { sigAlgName = userCert.getSigAlgName(); issuerName = userCert.getIssuerX500Principal().getName(); userName = userCert.getSubjectX500Principal().getName(); + + switch (sigAlgName) { + case "SM3WITHSM2": { + keyLength = 256; + break; + } + case "SHA1WITHRSA": { + keyLength = (pubKey.getEncoded().length < 4096 / 8)? 2048: 4096; + break; + } + } } // certificate string in Base64 format @@ -121,6 +133,10 @@ public class CertParser { return issuerName; } + public int getKeyLength() { + return keyLength; + } + public Date getStartTime() { return startTime; } diff --git a/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SHA1WITHRSA2048SignatureFunctionTest.java b/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SHA1WITHRSA2048SignatureFunctionTest.java index b7c7d831..64ca7eb5 100644 --- a/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SHA1WITHRSA2048SignatureFunctionTest.java +++ b/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SHA1WITHRSA2048SignatureFunctionTest.java @@ -1,9 +1,13 @@ package com.jd.blockchain.crypto.service.pki; import com.jd.blockchain.crypto.*; +import com.jd.blockchain.crypto.utils.CSRBuilder; +import com.jd.blockchain.crypto.utils.CertParser; import com.jd.blockchain.utils.io.BytesUtils; +import org.bouncycastle.util.encoders.Hex; import org.junit.Test; +import java.security.*; import java.util.Random; import static com.jd.blockchain.crypto.CryptoAlgorithm.*; @@ -125,4 +129,145 @@ public class SHA1WITHRSA2048SignatureFunctionTest { resolvedSignatureDigest.getAlgorithm()); assertArrayEquals(signatureDigestBytes, resolvedSignatureDigest.toBytes()); } + + @Test + public void testWithCSRAndCert() { + + String countryName = "CN"; + String stateName = "Beijing"; + String cityName = "Beijing"; + String organizationName = "JD.com"; + String departmentName = "Blockchain Department"; + String domainName = "ledger.jd.com"; + String emailName = "zhanglin33@jd.com"; + + + String publicKeyStr = "30820122300d06092a864886f70d01010105000382010f003082010a0282010100c91e978897a36b" + + "30a57d265807441b0eff40c5572ecf029cd0cb2999b715edd2d5345c7b60c003075b1352629d03b943d08b25bfc5245" + + "a400f9ecbc1757394eac452d6316bf90cfcff5edfc427e277aa5266e89b1b2daa2e69dad5575515f49417c9ff332c83" + + "0dcd5537381f08e00b11123ad947bb11b18666d264ab5d8cdc92d0967fd7e0e6677746e2f01270d0594f74cda4e9d77" + + "4c6f3824499896bfb6424684af260d71b57a1366b741104fc647d9e38de055568daad60c116686e4afa1e9c83e9e30c" + + "7216e61353da2f75b2dde2c0ae870cf0ccc90490d1e22ecccbf3985d30933689847e6faf946993f930f83ac5b816075" + + "793a9a6df20727552a21be30203010001"; + + String privateKeyStr = "308204bd020100300d06092a864886f70d0101010500048204a7308204a30201000282010100c91e" + + "978897a36b30a57d265807441b0eff40c5572ecf029cd0cb2999b715edd2d5345c7b60c003075b1352629d03b943d08" + + "b25bfc5245a400f9ecbc1757394eac452d6316bf90cfcff5edfc427e277aa5266e89b1b2daa2e69dad5575515f49417" + + "c9ff332c830dcd5537381f08e00b11123ad947bb11b18666d264ab5d8cdc92d0967fd7e0e6677746e2f01270d0594f7" + + "4cda4e9d774c6f3824499896bfb6424684af260d71b57a1366b741104fc647d9e38de055568daad60c116686e4afa1e" + + "9c83e9e30c7216e61353da2f75b2dde2c0ae870cf0ccc90490d1e22ecccbf3985d30933689847e6faf946993f930f83" + + "ac5b816075793a9a6df20727552a21be30203010001028201003975637e93300d8a2ee573e47762f6461117cca96d46" + + "982cfc1be6ed3318f142a845d6dc2ad680a703d69fd56b9d6a3b1d23fbeb6f63c4e303736f2bfca5c2585631825f494" + + "534783d6f3a07bd0b5efbcaa1faf7814ac9118c8d8820f4be9a8b0ac6db819fc86b538bf284369d9f009a667668a82d" + + "224f7122041eddb492ef5b02d462aa11bc550bf3785a5d7538043586cfb0cd5c313a4746f22a5d4a89a412b279a7517" + + "176b1858a9677a1a60605aa0b2a7d260cf2e9e23a0e67c4a23ac046c62973239e84874c3695cc3f34073a62bd50b597" + + "ee06092a93fa6e41303ab4d2293ffad4c8db06e6516ae0a26a4d681305c3b7d535b540a638ca6cff1ce483750281810" + + "0e39967c5b287bd319b448255a1033591c74f4d688eb71f89a674cdb1be999e9abcf40e6b7f0bb3054262d7625002da" + + "7d34e56055ee130b66d682a0b9f8ea240a7e2dd1ff3f4b32f3bd352ba0a5dffc0315da34922493c267597787222213b" + + "f87d99fbd2a809c2647a1937cd1e303d746373db7c409a2ef33f8c06bb838bc612702818100e2374c71db5f0b4a199f" + + "f9d646a1785a84383a14aceb506f515b380c69ff45b51d0e941f55f0a234d8a3ee30bed656142bb5b985e462c44d234" + + "cfd424ecd6ca5fc70503862978ffe42b45bd698a99091d6fc65e2d85652e0ef56c52e8e05a6c5e879922c1d794e22f3" + + "51998217b5c6637a6abb716bf90cd1f23a2eedcdfface50281805d28a872224e2f2183e539d7e4ccd47b73f240c4004" + + "e72493c69e8dbcd2141eb22565f249edee20ad00e770c95a5655b0470b2cad964d030eab293292bfa62802cff824a10" + + "d52de8d8545024346106dd186fb53ef05bcea1d0dbfce2fac1cc8ec583fdc0ccdd9d498a983cea081ac55dc734aae84" + + "1ed802d6caf0e285c88b6d702818068b2a752daf1364c6967bd3e0b1a98956c3489cd1feb19232c4847bc97226aa4d4" + + "79f6dc39ee51649c0fe321f471470db6dd38ac5b73caded8c3bd437f2d5c67c65a450693bb0a0de7d989d7dc783e4d0" + + "16f77c871d02233b1123bd8bc2aa97157934cafd6445a819a93ddb4743cd141215b5cbdb5f7629398c48d0bcb17d671" + + "028181009282554329b89bcb2236a7e2a5bff53627e3ca7cc792d65236085741bc62a3f5767654722af561eff175664" + + "1af60e3d3959f63f0fec00cb29443ffca4ff751a76ecc6fa192ebe08ec9f643b9bb0d11bc90c1e850f0528ef223ea5f" + + "e4b4c107cc3a9eb26e6b84d74d87acbf7cc760cd788cbc30f95f8399077b25cdd924604c01"; + + String expectedCSR = "MIIC4jCCAcoCAQAwgZwxCzAJBgNVBAYTAkNOMRAwDgYDVQQIDAdCZWlqaW5nMRAwDgYDVQQHDAdCZWlqaW" + + "5nMQ8wDQYDVQQKDAZKRC5jb20xHjAcBgNVBAsMFUJsb2NrY2hhaW4gRGVwYXJ0bWVudDEWMBQGA1UEAwwNbGVkZ2VyLmpkL" + + "mNvbTEgMB4GCSqGSIb3DQEJARYRemhhbmdsaW4zM0BqZC5jb20wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDJ" + + "HpeIl6NrMKV9JlgHRBsO/0DFVy7PApzQyymZtxXt0tU0XHtgwAMHWxNSYp0DuUPQiyW/xSRaQA+ey8F1c5TqxFLWMWv5DPz" + + "/Xt/EJ+J3qlJm6JsbLaouadrVV1UV9JQXyf8zLIMNzVU3OB8I4AsREjrZR7sRsYZm0mSrXYzcktCWf9fg5md3RuLwEnDQWU" + + "90zaTp13TG84JEmYlr+2QkaEryYNcbV6E2a3QRBPxkfZ443gVVaNqtYMEWaG5K+h6cg+njDHIW5hNT2i91st3iwK6HDPDMy" + + "QSQ0eIuzMvzmF0wkzaJhH5vr5Rpk/kw+DrFuBYHV5Oppt8gcnVSohvjAgMBAAGgADANBgkqhkiG9w0BAQUFAAOCAQEALKHw" + + "BrlppbN+CSJwHxO99rv2XVD7L8lwwiMqdMzoNHxZUoob4AcGS3Iyxy6obX8fZh7DCA4nN0AmvrJCmWD3hCLclWKlwXTwvFe" + + "WIeB4xEB9MVPV6/Hs/QaI9Rjhd+O/Alfzov8y+KyYHEWmwxHj2RtQm1ZeulELzMvRjsqP+m5tOM1hLnPMU+AF1tZ9Fc7Jbm" + + "7Dwh6TAPpmaH1aVbHsnlZyCp8K4nMozVogcXJqg3qsbeJ6c/TofL0fURqiTJxLKMC0aD0TwVcNwDWEmc8cpqGheG1g6UF5l" + + "QBpeR2Br4f3LXJgr1Op1RxRy6I+X7h1IL38Q3jAOoU4y04O/+an7g=="; + + String expectedUserCert = "MIIERjCCAy6gAwIBAgIFIChmYJgwDQYJKoZIhvcNAQEFBQAwWTELMAkGA1UEBhMCQ04xMDAuBgNVB" + + "AoTJ0NoaW5hIEZpbmFuY2lhbCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEYMBYGA1UEAxMPQ0ZDQSBURVNUIE9DQTExMB4X" + + "DTE5MDgyODA2MzEyNVoXDTIxMDgyODA2MzEyNVoweDELMAkGA1UEBhMCQ04xGDAWBgNVBAoTD0NGQ0EgVEVTVCBPQ0ExMTE" + + "RMA8GA1UECxMITG9jYWwgUkExFTATBgNVBAsTDEluZGl2aWR1YWwtMTElMCMGA1UEAxQcMDUxQHpoYW5nbGluIUBaMTg2MT" + + "IyMjkyOTVANTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMkel4iXo2swpX0mWAdEGw7/QMVXLs8CnNDLKZm3F" + + "e3S1TRce2DAAwdbE1JinQO5Q9CLJb/FJFpAD57LwXVzlOrEUtYxa/kM/P9e38Qn4neqUmbomxstqi5p2tVXVRX0lBfJ/zMs" + + "gw3NVTc4HwjgCxESOtlHuxGxhmbSZKtdjNyS0JZ/1+DmZ3dG4vAScNBZT3TNpOnXdMbzgkSZiWv7ZCRoSvJg1xtXoTZrdBE" + + "E/GR9njjeBVVo2q1gwRZobkr6HpyD6eMMchbmE1PaL3Wy3eLArocM8MzJBJDR4i7My/OYXTCTNomEfm+vlGmT+TD4OsW4Fg" + + "dXk6mm3yBydVKiG+MCAwEAAaOB9TCB8jAfBgNVHSMEGDAWgBT8C7xEmg4xoYOpgYcnHgVCxr9W+DBIBgNVHSAEQTA/MD0GC" + + "GCBHIbvKgECMDEwLwYIKwYBBQUHAgEWI2h0dHA6Ly93d3cuY2ZjYS5jb20uY24vdXMvdXMtMTUuaHRtMDoGA1UdHwQzMDEw" + + "L6AtoCuGKWh0dHA6Ly8yMTAuNzQuNDIuMy9PQ0ExMS9SU0EvY3JsMjY2NTAuY3JsMAsGA1UdDwQEAwID6DAdBgNVHQ4EFgQ" + + "UOTy45HymVDivPwA83lRoMpShasQwHQYDVR0lBBYwFAYIKwYBBQUHAwIGCCsGAQUFBwMEMA0GCSqGSIb3DQEBBQUAA4IBAQ" + + "A7NFkDMV1mRV/07DJUdZJzvkm+QihhpLp7D2dUblCCEt0jjY5RdLiWG7HvJnlPTThiSkiejEO0Fy1cQzA5jYRhwp+70X8X9" + + "bt5jEBP/V4PyRXKKEvKZMdppLIeVI6rZk/gJzPh2FQYv3qWaINilxLOBP8Qa0kdMBwo6D6/MYwnSGv5zP4NLFUysLUJiKoM" + + "lAzEQSPNnkYRX6nogpkdN91/xgH3GA7fiihrjm5oxMAupCli9LQqvlUvRtv5EKIN9c+ixCAYFagG9IIjMDXbDne77n15i01" + + "420N8sjfTlr9v3W0v1gBSzjzFOT+TTTUtrjfO/Vm8iqq+z22QKIXgYjSF"; + + String issuerCert = + "-----BEGIN CERTIFICATE-----\n" + + "MIIDzzCCAregAwIBAgIKUalCR1Mt5ZSK8jANBgkqhkiG9w0BAQUFADBZMQswCQYD\n" + + "VQQGEwJDTjEwMC4GA1UEChMnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24g\n" + + "QXV0aG9yaXR5MRgwFgYDVQQDEw9DRkNBIFRFU1QgQ1MgQ0EwHhcNMTIwODI5MDU1\n" + + "NDM2WhcNMzIwODI0MDU1NDM2WjBZMQswCQYDVQQGEwJDTjEwMC4GA1UEChMnQ2hp\n" + + "bmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRgwFgYDVQQDEw9D\n" + + "RkNBIFRFU1QgT0NBMTEwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC8\n" + + "jn0n8Fp6hcRdACdn1+Y6GAkC6KGgNdKyHPrmsdmhCjnd/i4qUFwnG8cp3D4lFw1G\n" + + "jmjSO5yVYbik/NbS6lbNpRgTK3fDfMFvLJpRIC+IFhG9SdAC2hwjsH9qTpL9cK2M\n" + + "bSdrC6pBdDgnbzaM9AGBF4Y6vXhj5nah4ZMsBvDp19LzXjlGuTPLuAgv9ZlWknsd\n" + + "RN70PIAmvomd10uqX4GIJ4Jq/FdKXOLZ2DNK/NhRyN6Yq71L3ham6tutXeZow5t5\n" + + "0254AnUlo1u6SeH9F8itER653o/oMLFwp+63qXAcqrHUlOQPX+JI8fkumSqZ4F2F\n" + + "t/HfVMnqdtFNCnh5+eIBAgMBAAGjgZgwgZUwHwYDVR0jBBgwFoAUdN7FjQp9EBqq\n" + + "aYNbTSHOhpvMcTgwDAYDVR0TBAUwAwEB/zA4BgNVHR8EMTAvMC2gK6AphidodHRw\n" + + "Oi8vMjEwLjc0LjQyLjMvdGVzdHJjYS9SU0EvY3JsMS5jcmwwCwYDVR0PBAQDAgEG\n" + + "MB0GA1UdDgQWBBT8C7xEmg4xoYOpgYcnHgVCxr9W+DANBgkqhkiG9w0BAQUFAAOC\n" + + "AQEAb7W0K9fZPA+JPw6lRiMDaUJ0oh052yEXreMBfoPulxkBj439qombDiFggRLc\n" + + "3g8wIEKzMOzOKXTWtnzYwN3y/JQSuJb/M1QqOEEM2PZwCxI4AkBuH6jg03RjlkHg\n" + + "/kTtuIFp9ItBCC2/KkKlp0ENfn4XgVg2KtAjZ7lpyVU0LPnhEqqUVY/xthjlCSa7\n" + + "/XHNStRxsfCTIBUWJ8n2FZyQhfV/UkMNHDBIiJR0v6C4Ai0/290WvbPEIAq+03Si\n" + + "fsHzBeA0C8lP5VzfAr6wWePaZMCpStpLaoXNcAqReKxQllElOqAhRxC5VKH+rnIQ\n" + + "OMRZvB7FRyE9IfwKApngcZbA5g==\n" + + "-----END CERTIFICATE-----"; + + byte[] rawPublicKeyBytes = Hex.decode(publicKeyStr); + byte[] rawPrivateKeyBytes = Hex.decode(privateKeyStr); + + CSRBuilder builder = new CSRBuilder(); + builder.init("SHA1withRSA", rawPublicKeyBytes, rawPrivateKeyBytes); + + String csr = builder.buildRequest(countryName,stateName,cityName, + organizationName,departmentName,domainName, + emailName); + + assertEquals(expectedCSR,csr); + + CertParser parser = new CertParser(); + parser.parse(expectedUserCert,issuerCert); + + PublicKey rawPublicKeyInCert = parser.getPubKey(); + // check that the public key in inputs and the public key in certificate are consistent + assertArrayEquals(rawPublicKeyBytes, rawPublicKeyInCert.getEncoded()); + + String algoName = parser.getSigAlgName(); + int keyLength = parser.getKeyLength(); + String length = String.valueOf(keyLength); + String algo = (algoName.contains("RSA")? (algoName + length).toUpperCase(): algoName.toUpperCase()); + + CryptoAlgorithm algorithm = Crypto.getAlgorithm(algo); + assertNotNull(algorithm); + SignatureFunction signatureFunction = Crypto.getSignatureFunction(algorithm); + + PubKey pubKey = new PubKey(algorithm, rawPublicKeyBytes); + PrivKey privKey = new PrivKey(algorithm, rawPrivateKeyBytes); + + // signTest + byte[] data = new byte[1024]; + Random random = new Random(); + random.nextBytes(data); + + SignatureDigest signature = signatureFunction.sign(privKey, data); + assertTrue(signatureFunction.verify(signature, pubKey, data)); + } } diff --git a/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SHA1WITHRSA4096SignatureFunctionTest.java b/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SHA1WITHRSA4096SignatureFunctionTest.java index 9444771b..466e245d 100644 --- a/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SHA1WITHRSA4096SignatureFunctionTest.java +++ b/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SHA1WITHRSA4096SignatureFunctionTest.java @@ -1,9 +1,13 @@ package com.jd.blockchain.crypto.service.pki; import com.jd.blockchain.crypto.*; +import com.jd.blockchain.crypto.utils.CSRBuilder; +import com.jd.blockchain.crypto.utils.CertParser; import com.jd.blockchain.utils.io.BytesUtils; +import org.bouncycastle.util.encoders.Hex; import org.junit.Test; +import java.security.PublicKey; import java.util.Random; import static com.jd.blockchain.crypto.CryptoAlgorithm.ASYMMETRIC_KEY; @@ -125,4 +129,186 @@ public class SHA1WITHRSA4096SignatureFunctionTest { resolvedSignatureDigest.getAlgorithm()); assertArrayEquals(signatureDigestBytes, resolvedSignatureDigest.toBytes()); } + + @Test + public void testWithCSRAndCert() { + + String countryName = "CN"; + String stateName = "Beijing"; + String cityName = "Beijing"; + String organizationName = "JD.com"; + String departmentName = "Blockchain Department"; + String domainName = "ledger.jd.com"; + String emailName = "zhanglin33@jd.com"; + + + String publicKeyStr = "30820222300d06092a864886f70d01010105000382020f003082020a0282020100b40edee83b609e" + + "aa001f2496f95d2f3302513306ec9a8e7fce0d2e141fce7ee357a7465314c3f5f4b08cb6c95803c368ddbfedba483cb" + + "5c45914037ceee5783fc971a12ef9b0e4158dc379b59499eee629324a9beb350c4c10e50837345be128b91f43a03381" + + "758bbefe41c45712e4b5fdd5bde780167283706b24e37dd753db65b4c6b3e49cd8be825665d9a29a24b77e76473df02" + + "2327873555aa33ba2ffcc766cbefedc46ec868d10f817822540eaf5754c074dd6d428355ce24a058a4c9ce41e48aad5" + + "92e7955cf93d779d03d3acf25ae271346a9e4255e4ed902ae016032b04efbee98f43cd767653e089b37540e537aede9" + + "dbc04f8f1a858b2764b9eedac80b6a8da5ff02aab4be94e071c70718fde7227cdefec31600a1c55bac16f4de9dea8ab" + + "7824c1ec783b818dfe005f040a3f6872b1c7a6c31a66c1b06eb8d872a23d1b4fdadf9eed58f93b2a2bc145638a79a81" + + "904d39b22128ced18a2556c21888ed1ec8ad59bd6764f1ea16eb7f3574c53166f0827b5072d23017bd725adeb63eeb2" + + "29a4e78d4d7426e936753902bb51e3cd90630314f4ab41272a9e36cb668b2ba9c2ebc02e9ef0c377c88482e839f2f4d" + + "5c8efcfbe1280e52c6bdf80aa487ae03ff9dd9fd981f78172bc1141ce6031b0b8915658d830c696662507d3cf4ddba8" + + "7daabf97c15cbef58b15e84f16f879328c7c65076d94fc6b4514549831850203010001"; + + String privateKeyStr = "30820942020100300d06092a864886f70d01010105000482092c308209280201000282020100b40e" + + "dee83b609eaa001f2496f95d2f3302513306ec9a8e7fce0d2e141fce7ee357a7465314c3f5f4b08cb6c95803c368ddb" + + "fedba483cb5c45914037ceee5783fc971a12ef9b0e4158dc379b59499eee629324a9beb350c4c10e50837345be128b9" + + "1f43a03381758bbefe41c45712e4b5fdd5bde780167283706b24e37dd753db65b4c6b3e49cd8be825665d9a29a24b77" + + "e76473df022327873555aa33ba2ffcc766cbefedc46ec868d10f817822540eaf5754c074dd6d428355ce24a058a4c9c" + + "e41e48aad592e7955cf93d779d03d3acf25ae271346a9e4255e4ed902ae016032b04efbee98f43cd767653e089b3754" + + "0e537aede9dbc04f8f1a858b2764b9eedac80b6a8da5ff02aab4be94e071c70718fde7227cdefec31600a1c55bac16f" + + "4de9dea8ab7824c1ec783b818dfe005f040a3f6872b1c7a6c31a66c1b06eb8d872a23d1b4fdadf9eed58f93b2a2bc14" + + "5638a79a81904d39b22128ced18a2556c21888ed1ec8ad59bd6764f1ea16eb7f3574c53166f0827b5072d23017bd725" + + "adeb63eeb229a4e78d4d7426e936753902bb51e3cd90630314f4ab41272a9e36cb668b2ba9c2ebc02e9ef0c377c8848" + + "2e839f2f4d5c8efcfbe1280e52c6bdf80aa487ae03ff9dd9fd981f78172bc1141ce6031b0b8915658d830c696662507" + + "d3cf4ddba87daabf97c15cbef58b15e84f16f879328c7c65076d94fc6b451454983185020301000102820200063fece" + + "3452a579f817513454d3efb842afcac077dbf689a4d89de13533e4cdfb1bb6be0b6dc0d65b29a13bf1dd7b598e67782" + + "b6204b4128e149a54c59136c6ed45c661296169a78180d54a46595c939c26ccd33a7c095de6f08b01610726ef885a26" + + "cebbad5efc14bbe1204d15be5c5de5b64a5cc279b4e6e20bded4a8126973b2ac0e9de11c6a1282f7d060693909a30e0" + + "c49cc500bedd38ed99c18830a26dd39f772aabf527410d54ed338db022d674f21f1332d3b5d5f67234a58a97300d130" + + "aed0d46effc2b4e4895665934188d0c75749e26ca5b97645957989530657b332b4ef202b3d70fe2e07d0d526240fbe1" + + "68e320357be0f54e18008a233a8137e23ca1c54074b31c57eebee49bf2f1c66ea97a2c846a8d26680b97e1240d6763e" + + "60bcd8d696c806362b18bf0504a39e4d465a9548091dbe97c36f6d8e038d95a72c0a88ff524dc81fe0ed2afd69f4251" + + "1a90687a4c632c812234a19a7312b2dea3fcd4515800eca700733b0f83509184fe8d3cd21385f0ef0cec37c433d354f" + + "aed61662a62902c8708c81e2af20898f649c1bafd600baa0409c943cf82bc90ea20a8972da7ab3a252f4f08df2509de" + + "e1dacfe787eef4d60c0c92ec7a3c6277d7be39deed7704ac721d8efd138a410d632a32535142cf977b09d9fb680bc96" + + "c538c00440d5e1ed71f8510e6524e564d69a24d03f1a9a0c326b421e32550801c890282010100e8d72f8f1fbeada724" + + "3e6df25337a2e7fc43e3d4f39877f89abb3b5e453f20f339a1f35e0a2847122f0bd835e6b43fd276f447da04f85cfca" + + "0fa8bf49b313239e36f9595ef1bfb9b8247bf01cc407dfc444421161a5b2e96d4d1d90cea185945e9447d21a2d8a461" + + "f43dff9ba58043feeb49552a3bf2472eea59b2aa8631048c76a15898065be0ef957d4802c827e30339d66ad7aed5851" + + "a5896f12d33f45800dcb10859531c590af7a75e9fa81f1d937a287fb6b066d58720584af2ae161e083681655ae77f48" + + "34bfe0accf1d12bbdd8c2644f78b207cfcb2dedf9fe7d29e1ae5c2a5623f5a1770db27d2636450c79fd39bce39f009b" + + "598e0298e1f77bf8d3d0282010100c5f7af9258a42da93204cecb71c544397bc16691cf0d41308fbd3b88eca7d101d1" + + "377dfe3b7e66707d3e5543b21033ab6c5b0de577740c6e335f512eeb2a839c3f2baeca4ce80e3fbd8fb93fa983e1719" + + "5c5fee63bc163df334a80f2767871e3434adc0bc7030dea44fce414a08da7e918e6f030cfb20b2d29033e9ef1be3e08" + + "ef1f50df0c9325a20ff01d0b7a06761403ae3498aea8bad93110d61a6386d470e630990029e2cb098de40fafa330911" + + "6c3c6de180b7fa41ae14553e891148ab53e970ce372b1777826983baaccac08290e343761d8daa2505f1dc45b8511a3" + + "6e2d0909237be9ae7ebbaa00b31de1224f32959e4e6f3428140ca8e1e5580789e902820100674075609c8d2be880940" + + "6a17cf1a1160ab1f8684895862e023fa0f60ef30da38e1d1914cca04bd3ee74ec2e0ade47a70705108fc7c0734bbbff" + + "1eed1b9cd74f00624d0d2df954bc032bd9b1ec6774f6d736f70d1c26ef2407bffee65130f6f59f99b57ba3013af40d2" + + "12926565fe8c734835276e61a6c228bddb6f3138acd1f94c3bbcbbe9623cb5a9931c3ba0aa60a9a2d5137cfd9f3aa59" + + "3aa63c8b5b8162f07ab8df1391f092827bffe400e3bb73d8a9f8e88495357f3482b2c9a7153bc01c9b88dca4e7b6975" + + "db73e2aa213daa7462cfa4c63afc67d30bcd0a1d2657da323dc0b06e45d09240cab3e0ac1436922a0ede8a79ca0519d" + + "375a7621d23269690282010100bbc1299716d2bf2b94f0d260494ada65da6596adfb3d8af24fa11d71c36175eccf4c5" + + "e065cce88c16f474afea546907aa88dc3243aa2a9976ac99fe96bc82a8269b738534d9558ce432ea87724829bb26a66" + + "1a56a99dc4e6cf727dd17762cc40ca759934e24e9747f49e14832bb2ade97960adb4dd86f2eaa5d719f10d3d6d00742" + + "9b33d98638671a9c40507f9775f4da41ff86a465c68b9ccbb371458086c3b9755c8064bb378f55ac94dc73a72b96869" + + "cd969e1f69b36e7af091a024d8e2a4faf3af999811904937f171c58fd028fd272786cf1a286180f074fee1fdd6b8b5a" + + "9a8c42e0f3b95ef4474fbace54dbc887865467b0524e64dfda3be7b117e34e1028201001a7e846231c34400c1f704e7" + + "fec6e46c87d61f269b71942bc9cc72005ba30eea3db5d0e5b0b754f7a00b96c883399982b5b3a9916765c5ed9129e44" + + "a791ce6892f85758c637bc040da132b8f0cd0ac36ba3aae9334414a77f0b50c0aa03643bfd59b9a621342a4807e46fc" + + "52a5a12fd3ff6762e181c40c2baf3653043c836b14700463af5d68a2a2897897edb5f217d655d5bcd24e7910062f40e" + + "00f19e2f94b45efbbf60cbf734830756baf72dcfca8d2858ca5df63336999474945f3744a96e4ce23f9067bbca849ef" + + "1048cba3a4aad73ed73b0fcd8c2e9f6d06aa768548d7107aa58d9d296f853543f6569e4dd33270540d983460773794f" + + "e9196fc5a54cd"; + + String expectedCSR = "MIIE4jCCAsoCAQAwgZwxCzAJBgNVBAYTAkNOMRAwDgYDVQQIDAdCZWlqaW5nMRAwDgYDVQQHDAdCZWlqaW" + + "5nMQ8wDQYDVQQKDAZKRC5jb20xHjAcBgNVBAsMFUJsb2NrY2hhaW4gRGVwYXJ0bWVudDEWMBQGA1UEAwwNbGVkZ2VyLmpkL" + + "mNvbTEgMB4GCSqGSIb3DQEJARYRemhhbmdsaW4zM0BqZC5jb20wggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC0" + + "Dt7oO2CeqgAfJJb5XS8zAlEzBuyajn/ODS4UH85+41enRlMUw/X0sIy2yVgDw2jdv+26SDy1xFkUA3zu5Xg/yXGhLvmw5BW" + + "Nw3m1lJnu5ikySpvrNQxMEOUINzRb4Si5H0OgM4F1i77+QcRXEuS1/dW954AWcoNwayTjfddT22W0xrPknNi+glZl2aKaJL" + + "d+dkc98CIyeHNVWqM7ov/Mdmy+/txG7IaNEPgXgiVA6vV1TAdN1tQoNVziSgWKTJzkHkiq1ZLnlVz5PXedA9Os8lricTRqn" + + "kJV5O2QKuAWAysE777pj0PNdnZT4ImzdUDlN67enbwE+PGoWLJ2S57trIC2qNpf8CqrS+lOBxxwcY/ecifN7+wxYAocVbrB" + + "b03p3qireCTB7Hg7gY3+AF8ECj9ocrHHpsMaZsGwbrjYcqI9G0/a357tWPk7KivBRWOKeagZBNObIhKM7RiiVWwhiI7R7Ir" + + "Vm9Z2Tx6hbrfzV0xTFm8IJ7UHLSMBe9clretj7rIppOeNTXQm6TZ1OQK7UePNkGMDFPSrQScqnjbLZosrqcLrwC6e8MN3yI" + + "SC6Dny9NXI78++EoDlLGvfgKpIeuA/+d2f2YH3gXK8EUHOYDGwuJFWWNgwxpZmJQfTz03bqH2qv5fBXL71ixXoTxb4eTKMf" + + "GUHbZT8a0UUVJgxhQIDAQABoAAwDQYJKoZIhvcNAQEFBQADggIBAKowJTG9mZLbDHRndmDUd7PWrq1AiCdk6DStV39B/REF" + + "OrMYcW9X4Ak69fhXQDtD4gu2lKtumDY0oJ8xleM2FHUSzdooTWb7P/QtCIBy27sH6nvlefRWi7ngSTNJlDmwgr0l07UzZU1" + + "Yl/ZULn0XlNAFal+qt+4ZNdiulNwkL6IofXV/8vqOeQw5iICDBYHItyY/mqD8IIaClVd8yNpEuE/W9GdJIDNXQjpug+BxL/" + + "FbjAs6P3ZzJboedJE5urbru2jjb7atl3w/eDo4r6+XNSD8d1PgVmVhzN2WpUWsZNeH2jd9AA6436GjsBssgSRKEc3FTJ+lO" + + "0Jw2d8GewXXkIv8CT4L3BFwqZhGQt27wlb87+W4dIC05JIaJx52869dvu1ky1CL73GROXeS8rVYJsPwVmK2xy3QTaeHGEQh" + + "kiVNeV1cc3mll2z7fgbkjPD8zDNBWUdzSXQMzecY1CBD02iz6LaHfvkI7gXXoiIf1cJrnLtYhv3lG45jKr0E45/Wn7oXmYk" + + "RM4/zHO4KnY7Pp3b3QTgkRJaPnZiG7aiCrdnTIopDSGpTWSPWDLjgwgaCPPz5Pd2Fk+SAE98o7Cu8O0vxMASpd4liaedASE" + + "n6hnrvcTkFLLG2ecZzJZ0aEqPi4es0FqlqVZrLPH2UYpECgfhkGQQKAx4eRTAZFhz1GSkd"; + + String expectedUserCert = "MIIFRjCCBC6gAwIBAgIFIChmYWIwDQYJKoZIhvcNAQEFBQAwWTELMAkGA1UEBhMCQ04xMDAuBgNVB" + + "AoTJ0NoaW5hIEZpbmFuY2lhbCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEYMBYGA1UEAxMPQ0ZDQSBURVNUIE9DQTExMB4X" + + "DTE5MDgyODA4MDAxMVoXDTIxMDgyODA4MDAxMVoweDELMAkGA1UEBhMCQ04xGDAWBgNVBAoTD0NGQ0EgVEVTVCBPQ0ExMTE" + + "RMA8GA1UECxMITG9jYWwgUkExFTATBgNVBAsTDEluZGl2aWR1YWwtMTElMCMGA1UEAxQcMDUxQHpoYW5nbGluIUBaMTg2MT" + + "IyMjkyOTVANzCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALQO3ug7YJ6qAB8klvldLzMCUTMG7JqOf84NLhQfz" + + "n7jV6dGUxTD9fSwjLbJWAPDaN2/7bpIPLXEWRQDfO7leD/JcaEu+bDkFY3DebWUme7mKTJKm+s1DEwQ5Qg3NFvhKLkfQ6Az" + + "gXWLvv5BxFcS5LX91b3ngBZyg3BrJON911PbZbTGs+Sc2L6CVmXZopokt352Rz3wIjJ4c1Vaozui/8x2bL7+3Ebsho0Q+Be" + + "CJUDq9XVMB03W1Cg1XOJKBYpMnOQeSKrVkueVXPk9d50D06zyWuJxNGqeQlXk7ZAq4BYDKwTvvumPQ812dlPgibN1QOU3rt" + + "6dvAT48ahYsnZLnu2sgLao2l/wKqtL6U4HHHBxj95yJ83v7DFgChxVusFvTeneqKt4JMHseDuBjf4AXwQKP2hyscemwxpmw" + + "bBuuNhyoj0bT9rfnu1Y+TsqK8FFY4p5qBkE05siEoztGKJVbCGIjtHsitWb1nZPHqFut/NXTFMWbwgntQctIwF71yWt62Pu" + + "simk541NdCbpNnU5ArtR482QYwMU9KtBJyqeNstmiyupwuvALp7ww3fIhILoOfL01cjvz74SgOUsa9+Aqkh64D/53Z/Zgfe" + + "BcrwRQc5gMbC4kVZY2DDGlmYlB9PPTduofaq/l8FcvvWLFehPFvh5Mox8ZQdtlPxrRRRUmDGFAgMBAAGjgfUwgfIwHwYDVR" + + "0jBBgwFoAU/Au8RJoOMaGDqYGHJx4FQsa/VvgwSAYDVR0gBEEwPzA9BghggRyG7yoBAjAxMC8GCCsGAQUFBwIBFiNodHRwO" + + "i8vd3d3LmNmY2EuY29tLmNuL3VzL3VzLTE1Lmh0bTA6BgNVHR8EMzAxMC+gLaArhilodHRwOi8vMjEwLjc0LjQyLjMvT0NB" + + "MTEvUlNBL2NybDI2NjU1LmNybDALBgNVHQ8EBAMCA+gwHQYDVR0OBBYEFBl1Gmb89bqbEKyFcTU3eOY/5NmKMB0GA1UdJQQ" + + "WMBQGCCsGAQUFBwMCBggrBgEFBQcDBDANBgkqhkiG9w0BAQUFAAOCAQEADEU//9rnWN1s3/ariMHIUmgzRUdz3fWYiDRzGC" + + "mcnnETlXDstGmoYmwCM+QwHw6cyKXkwkg9zV7c7CgM471ZuF00gq115d432Ps3RXGCpfQ2fn3gs+91ky/YqJOOyBb8KL0IP" + + "r/Zh56/y3XX0gORn4GLqaj+oVZrFcmKrPtVhySlXNiD5BRMq39mUbuLBweGsgNVQ9VxiWc8ZBGjlJ6OVsngbvWrtl3zgkKb" + + "X9lhr8Bxq3G+jOV8jvr1Dkn4a65g2TWcFquxmPvRc5UwN29CimbC7RViCL3Jp+zrGasqbjycuqu5eSXb6gG4/aV0/K9yn5k" + + "YlZMIBlbsXSEi5J26pg=="; + + String issuerCert = + "-----BEGIN CERTIFICATE-----\n" + + "MIIDzzCCAregAwIBAgIKUalCR1Mt5ZSK8jANBgkqhkiG9w0BAQUFADBZMQswCQYD\n" + + "VQQGEwJDTjEwMC4GA1UEChMnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24g\n" + + "QXV0aG9yaXR5MRgwFgYDVQQDEw9DRkNBIFRFU1QgQ1MgQ0EwHhcNMTIwODI5MDU1\n" + + "NDM2WhcNMzIwODI0MDU1NDM2WjBZMQswCQYDVQQGEwJDTjEwMC4GA1UEChMnQ2hp\n" + + "bmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRgwFgYDVQQDEw9D\n" + + "RkNBIFRFU1QgT0NBMTEwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC8\n" + + "jn0n8Fp6hcRdACdn1+Y6GAkC6KGgNdKyHPrmsdmhCjnd/i4qUFwnG8cp3D4lFw1G\n" + + "jmjSO5yVYbik/NbS6lbNpRgTK3fDfMFvLJpRIC+IFhG9SdAC2hwjsH9qTpL9cK2M\n" + + "bSdrC6pBdDgnbzaM9AGBF4Y6vXhj5nah4ZMsBvDp19LzXjlGuTPLuAgv9ZlWknsd\n" + + "RN70PIAmvomd10uqX4GIJ4Jq/FdKXOLZ2DNK/NhRyN6Yq71L3ham6tutXeZow5t5\n" + + "0254AnUlo1u6SeH9F8itER653o/oMLFwp+63qXAcqrHUlOQPX+JI8fkumSqZ4F2F\n" + + "t/HfVMnqdtFNCnh5+eIBAgMBAAGjgZgwgZUwHwYDVR0jBBgwFoAUdN7FjQp9EBqq\n" + + "aYNbTSHOhpvMcTgwDAYDVR0TBAUwAwEB/zA4BgNVHR8EMTAvMC2gK6AphidodHRw\n" + + "Oi8vMjEwLjc0LjQyLjMvdGVzdHJjYS9SU0EvY3JsMS5jcmwwCwYDVR0PBAQDAgEG\n" + + "MB0GA1UdDgQWBBT8C7xEmg4xoYOpgYcnHgVCxr9W+DANBgkqhkiG9w0BAQUFAAOC\n" + + "AQEAb7W0K9fZPA+JPw6lRiMDaUJ0oh052yEXreMBfoPulxkBj439qombDiFggRLc\n" + + "3g8wIEKzMOzOKXTWtnzYwN3y/JQSuJb/M1QqOEEM2PZwCxI4AkBuH6jg03RjlkHg\n" + + "/kTtuIFp9ItBCC2/KkKlp0ENfn4XgVg2KtAjZ7lpyVU0LPnhEqqUVY/xthjlCSa7\n" + + "/XHNStRxsfCTIBUWJ8n2FZyQhfV/UkMNHDBIiJR0v6C4Ai0/290WvbPEIAq+03Si\n" + + "fsHzBeA0C8lP5VzfAr6wWePaZMCpStpLaoXNcAqReKxQllElOqAhRxC5VKH+rnIQ\n" + + "OMRZvB7FRyE9IfwKApngcZbA5g==\n" + + "-----END CERTIFICATE-----"; + + byte[] rawPublicKeyBytes = Hex.decode(publicKeyStr); + byte[] rawPrivateKeyBytes = Hex.decode(privateKeyStr); + + CSRBuilder builder = new CSRBuilder(); + builder.init("SHA1withRSA", rawPublicKeyBytes, rawPrivateKeyBytes); + + String csr = builder.buildRequest(countryName,stateName,cityName, + organizationName,departmentName,domainName, + emailName); + + assertEquals(expectedCSR,csr); + + CertParser parser = new CertParser(); + parser.parse(expectedUserCert,issuerCert); + + PublicKey rawPublicKeyInCert = parser.getPubKey(); + // check that the public key in inputs and the public key in certificate are consistent + assertArrayEquals(rawPublicKeyBytes, rawPublicKeyInCert.getEncoded()); + + String algoName = parser.getSigAlgName(); + int keyLength = parser.getKeyLength(); + String length = String.valueOf(keyLength); + String algo = (algoName.contains("RSA")? (algoName + length).toUpperCase(): algoName.toUpperCase()); + + CryptoAlgorithm algorithm = Crypto.getAlgorithm(algo); + assertNotNull(algorithm); + SignatureFunction signatureFunction = Crypto.getSignatureFunction(algorithm); + + PubKey pubKey = new PubKey(algorithm, rawPublicKeyBytes); + PrivKey privKey = new PrivKey(algorithm, rawPrivateKeyBytes); + + // signTest + byte[] data = new byte[1024]; + Random random = new Random(); + random.nextBytes(data); + + SignatureDigest signature = signatureFunction.sign(privKey, data); + assertTrue(signatureFunction.verify(signature, pubKey, data)); + } } diff --git a/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SM3WITHSM2SignatureFunctionTest.java b/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SM3WITHSM2SignatureFunctionTest.java index 0b8063a9..54969745 100644 --- a/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SM3WITHSM2SignatureFunctionTest.java +++ b/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/service/pki/SM3WITHSM2SignatureFunctionTest.java @@ -1,9 +1,13 @@ package com.jd.blockchain.crypto.service.pki; import com.jd.blockchain.crypto.*; +import com.jd.blockchain.crypto.utils.CSRBuilder; +import com.jd.blockchain.crypto.utils.CertParser; import com.jd.blockchain.utils.io.BytesUtils; +import org.bouncycastle.util.encoders.Hex; import org.junit.Test; +import java.security.PublicKey; import java.util.Random; import static com.jd.blockchain.crypto.CryptoAlgorithm.ASYMMETRIC_KEY; @@ -270,4 +274,80 @@ public class SM3WITHSM2SignatureFunctionTest { resolvedSignatureDigest.getAlgorithm()); assertArrayEquals(signatureDigestBytes, resolvedSignatureDigest.toBytes()); } + + + @Test + public void testWithCSRAndCert() { + + String publicKeyStr = "3059301306072a8648ce3d020106082a811ccf5501822d03420004aa6586478be879504fdd02892f" + + "b4cf2bdb3d96a316f41ff7bcadfabef4ea836678984f9ba6931a609391426ca7164592f5fccd062be56fc32b3eec3a5" + + "0400971"; + + String privateKeyStr = "308193020100301306072a8648ce3d020106082a811ccf5501822d0479307702010104207abd2953" + + "84f193abe4f3715c26bc15225061f007131755d94ca12c7e0ce0b3a0a00a06082a811ccf5501822da14403420004aa6" + + "586478be879504fdd02892fb4cf2bdb3d96a316f41ff7bcadfabef4ea836678984f9ba6931a609391426ca7164592f5" + + "fccd062be56fc32b3eec3a50400971"; + + String expectedUserCert = "MIICwjCCAmWgAwIBAgIFIChnMlIwDAYIKoEcz1UBg3UFADBdMQswCQYDVQQGEwJDTjEwMC4GA1UEC" + + "gwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRwwGgYDVQQDDBNDRkNBIFRFU1QgU00yIE9DQTEx" + + "MB4XDTE5MDgyODA4MTUzNloXDTIxMDgyODA4MTUzNloweDELMAkGA1UEBhMCQ04xGDAWBgNVBAoMD0NGQ0EgVEVTVCBPQ0E" + + "xMTERMA8GA1UECwwITG9jYWwgUkExFTATBgNVBAsMDEluZGl2aWR1YWwtMTElMCMGA1UEAwwcMDUxQHpoYW5nbGluIUBaMT" + + "g2MTIyMjkyOTVAODBZMBMGByqGSM49AgEGCCqBHM9VAYItA0IABKplhkeL6HlQT90CiS+0zyvbPZajFvQf97yt+r706oNme" + + "JhPm6aTGmCTkUJspxZFkvX8zQYr5W/DKz7sOlBACXGjgfQwgfEwHwYDVR0jBBgwFoAUvqZ+TT18j6BV5sEvCS4sIEOzQn8w" + + "SAYDVR0gBEEwPzA9BghggRyG7yoBAjAxMC8GCCsGAQUFBwIBFiNodHRwOi8vd3d3LmNmY2EuY29tLmNuL3VzL3VzLTE1Lmh" + + "0bTA5BgNVHR8EMjAwMC6gLKAqhihodHRwOi8vMjEwLjc0LjQyLjMvT0NBMTEvU00yL2NybDI0OTkuY3JsMAsGA1UdDwQEAw" + + "ID6DAdBgNVHQ4EFgQU07tMtbs5PWkwN33OQVH116xd1kowHQYDVR0lBBYwFAYIKwYBBQUHAwIGCCsGAQUFBwMEMAwGCCqBH" + + "M9VAYN1BQADSQAwRgIhAPuuInppVhugw6EIG4wgkouxX/MX2dTLe478wx7LFXSQAiEAneiz51vrurICNCfeecaBHgzaj7+3" + + "kmrdIZJBoxYGbso="; + + String issuerCert = + "-----BEGIN CERTIFICATE-----\n" + + "MIICTzCCAfOgAwIBAgIKJFSZ4SRVDndYUTAMBggqgRzPVQGDdQUAMF0xCzAJBgNV\n" + + "BAYTAkNOMTAwLgYDVQQKDCdDaGluYSBGaW5hbmNpYWwgQ2VydGlmaWNhdGlvbiBB\n" + + "dXRob3JpdHkxHDAaBgNVBAMME0NGQ0EgVEVTVCBDUyBTTTIgQ0EwHhcNMTIwODI5\n" + + "MDU0ODQ3WhcNMzIwODI0MDU0ODQ3WjBdMQswCQYDVQQGEwJDTjEwMC4GA1UECgwn\n" + + "Q2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRwwGgYDVQQD\n" + + "DBNDRkNBIFRFU1QgU00yIE9DQTExMFkwEwYHKoZIzj0CAQYIKoEcz1UBgi0DQgAE\n" + + "L1mx4wriQUojGsIkNL14kslv9nwiqsiVpELOZauzghrbccNlPYKNYKZOCvXwIIqU\n" + + "9QY02d4weqKqo/JMcNsKEaOBmDCBlTAfBgNVHSMEGDAWgBS12JBvXPDYM9JjvX6y\n" + + "w43GTxJ6YTAMBgNVHRMEBTADAQH/MDgGA1UdHwQxMC8wLaAroCmGJ2h0dHA6Ly8y\n" + + "MTAuNzQuNDIuMy90ZXN0cmNhL1NNMi9jcmwxLmNybDALBgNVHQ8EBAMCAQYwHQYD\n" + + "VR0OBBYEFL6mfk09fI+gVebBLwkuLCBDs0J/MAwGCCqBHM9VAYN1BQADSAAwRQIh\n" + + "AKuk7s3eYCZDck5NWU0eNQmLhBN/1zmKs517qFrDrkJWAiAP4cVfLtdza/OkwU9P\n" + + "PrIDl+E4aL3FypntFXHG3T+Keg==\n" + + "-----END CERTIFICATE-----"; + + byte[] rawPublicKeyBytes = Hex.decode(publicKeyStr); + byte[] rawPrivateKeyBytes = Hex.decode(privateKeyStr); + + CSRBuilder builder = new CSRBuilder(); + builder.init("SM3withSM2", rawPublicKeyBytes, rawPrivateKeyBytes); + + CertParser parser = new CertParser(); + parser.parse(expectedUserCert,issuerCert); + + PublicKey rawPublicKeyInCert = parser.getPubKey(); + // check that the public key in inputs and the public key in certificate are consistent + assertArrayEquals(rawPublicKeyBytes, rawPublicKeyInCert.getEncoded()); + + String algoName = parser.getSigAlgName(); + int keyLength = parser.getKeyLength(); + String length = String.valueOf(keyLength); + String algo = (algoName.contains("RSA")? (algoName + length).toUpperCase(): algoName.toUpperCase()); + + CryptoAlgorithm algorithm = Crypto.getAlgorithm(algo); + assertNotNull(algorithm); + SignatureFunction signatureFunction = Crypto.getSignatureFunction(algorithm); + + PubKey pubKey = new PubKey(algorithm, rawPublicKeyBytes); + PrivKey privKey = new PrivKey(algorithm, rawPrivateKeyBytes); + + // signTest + byte[] data = new byte[1024]; + Random random = new Random(); + random.nextBytes(data); + + SignatureDigest signature = signatureFunction.sign(privKey, data); + assertTrue(signatureFunction.verify(signature, pubKey, data)); + } } diff --git a/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/utils/CertParserTest.java b/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/utils/CertParserTest.java index 24cdc414..263d3e88 100644 --- a/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/utils/CertParserTest.java +++ b/source/crypto/crypto-pki/src/test/java/com/jd/blockchain/crypto/utils/CertParserTest.java @@ -43,7 +43,8 @@ public class CertParserTest { String userCert = "MIIEQDCCAyigAwIBAgIFICdVYzEwDQYJKoZIhvcNAQEFBQAwWTELMAkGA1UEBhMCQ04xMDAuBgNVBAoTJ0NoaW5hIEZpbmFuY2lhbCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEYMBYGA1UEAxMPQ0ZDQSBURVNUIE9DQTExMB4XDTE5MDUxMDExMjAyNFoXDTIxMDUxMDExMjAyNFowcjELMAkGA1UEBhMCQ04xGDAWBgNVBAoTD0NGQ0EgVEVTVCBPQ0ExMTERMA8GA1UECxMITG9jYWwgUkExFTATBgNVBAsTDEluZGl2aWR1YWwtMTEfMB0GA1UEAxQWMDUxQGFhYWFhQFpIMDkzNTgwMjhAMzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJx3F2WD1dJPzK/nRHO7d1TJ1hTjzGTmv0PQ7ECsJAh3U3BtnGTpCB+b4+JMI4LO8nHkKIBQ3P9XnF+Bf1iXdWNAQ4aWCxa2nV7lCp4w0GliPu/EMgIfmsSDUtgqbM3cr8sR8r9m1xG3gt2TIQJ+jT7sAiguU/kyNzpjaccOUIgUFa8IDFq9UeB76MXtCuhlERRZQCl47e+9w7ZoxmE7e6IZORxPp7rQWVBHlR9ntWjJfNDTm3gMP5ehP+yIZnKx1LudxkBLQxpMmspzOyH1zqx5nkKe49AfWWpDxxRvYkriyYC3aE81qLsU/bhLwNEKOju7BGDF/mhJLZUedojM0gMCAwEAAaOB9TCB8jAfBgNVHSMEGDAWgBT8C7xEmg4xoYOpgYcnHgVCxr9W+DBIBgNVHSAEQTA/MD0GCGCBHIbvKgECMDEwLwYIKwYBBQUHAgEWI2h0dHA6Ly93d3cuY2ZjYS5jb20uY24vdXMvdXMtMTUuaHRtMDoGA1UdHwQzMDEwL6AtoCuGKWh0dHA6Ly8yMTAuNzQuNDIuMy9PQ0ExMS9SU0EvY3JsMjU2OTMuY3JsMAsGA1UdDwQEAwID6DAdBgNVHQ4EFgQU5oKGaQs7Jt5Gfbt1XhFTWAySEKswHQYDVR0lBBYwFAYIKwYBBQUHAwIGCCsGAQUFBwMEMA0GCSqGSIb3DQEBBQUAA4IBAQAlmPRaImZV51iKjtpMKuyLMw7dX8L0lY3tl+pVZZSxHuwsN4GCCtV0Ej50up+/6EbfL4NUTiuHVAjCroKKvb+94CrdEwdnQGM5IbGSjT78nQpeASXbIWuUwA+ImjvZOzvq/0b56AzonNzBxOMGko/bj5smM6X8jrgJ0NQppo2KNSVNC4JbuoNWI4FM94SE4DUi9H7EYl4JdOtDaDtCsq49o/A1CZyYrmoOPCgxpQQXmuB3lGq/jyoOlW2aW8uee/hYG1JJcSHLBjF0WBwdxssgbBotA5f1PebiIMSbFgjk57bd4M80hhU/rI4Hkn9pcp5R7NsX95TtyDIg90LboBnW"; parser.parse(userCert, issuerCert); - assertEquals("SHA1WITHRSA",parser.getSigAlgName()); + assertEquals("SHA1WITHRSA", parser.getSigAlgName()); + assertEquals(2048, parser.getKeyLength()); } @Test @@ -77,7 +78,8 @@ public class CertParserTest { String userCert = "MIIFRjCCBC6gAwIBAgIFICdWiDMwDQYJKoZIhvcNAQEFBQAwWTELMAkGA1UEBhMCQ04xMDAuBgNVBAoTJ0NoaW5hIEZpbmFuY2lhbCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eTEYMBYGA1UEAxMPQ0ZDQSBURVNUIE9DQTExMB4XDTE5MDUxNjA3MDcyMloXDTIxMDUxNjA3MDcyMloweDELMAkGA1UEBhMCQ04xGDAWBgNVBAoTD0NGQ0EgVEVTVCBPQ0ExMTERMA8GA1UECxMITG9jYWwgUkExFTATBgNVBAsTDEluZGl2aWR1YWwtMTElMCMGA1UEAxQcMDUxQHpoYW5nbGluIUBaMTg2MTIyMjkyOTVAMjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAL0rTOxd8rsjPtFJ0aGVh9bZPy5Xo0SADaP7BbJsG4+ykLQMZHg9hTf/6fv1OsD2HEKFoMpIkW2gwCJW2nvicHcVql/shCoktc6ZBW6Dr/DxOgbO9tpoGxZ50xdI4Q0NsrxqtbCldW4ozPHdjgRJ83i1KSFh7evNrVByN/mB+jchrVGLWyJ1uIRgUUgpRZmZPoOHaizVJqrqWJGGk6xbDLR2gUQ1hTzetQaz1OeKtelHDk9FY08XSmNGssSMpuSjrxn78S888VW5WIxyo4cwrXSXFk3J7LNTy70Oga16HZjJD/vLTM6a4riPa8+uivPinKxK38/++nlBPNwhx6n46uYkd9Zvw+SJiJgpnuPJLtMZpKpJx7V1BDVEydKPUthilTdsmJtkBFSlFw0G1aKfuciBGzzJ3SKngJF/JqJAWIonVAFBGb6Gokp1Sw+T4KqXrdbjxYxiyyjZ++8O1vydgFAkx/NjsuwJnpKETiRKFJmY7YawcUvC4ixF7XQc0luFWRDYcbxOppir+ieMqhGXyaFhLUuB4WXv+rFxfa3NmkBW8q5TPzt/PwWcXpITsYTZYla/E/grB+OeZLYgjigT5YlgytPHG6Gt1ySCCd8WXFWpkBbQfXzqcvtU27RCcAUgfXk5NLb7NZCQg7heGjgzOdYJCPsa1d3m7l04+VIKGCZdAgMBAAGjgfUwgfIwHwYDVR0jBBgwFoAU/Au8RJoOMaGDqYGHJx4FQsa/VvgwSAYDVR0gBEEwPzA9BghggRyG7yoBAjAxMC8GCCsGAQUFBwIBFiNodHRwOi8vd3d3LmNmY2EuY29tLmNuL3VzL3VzLTE1Lmh0bTA6BgNVHR8EMzAxMC+gLaArhilodHRwOi8vMjEwLjc0LjQyLjMvT0NBMTEvUlNBL2NybDI1NzE3LmNybDALBgNVHQ8EBAMCA+gwHQYDVR0OBBYEFMjh6AzDCuNkD+pqQfiS6bqPGpI4MB0GA1UdJQQWMBQGCCsGAQUFBwMCBggrBgEFBQcDBDANBgkqhkiG9w0BAQUFAAOCAQEApZaLXS6/6FudPA3l2xom5U7nJUOpQ1E6DO/ic9dFGtLE0WgyAqB3JVPvXEntppX55x/dAV7rvvz9NaEdiAe8DAj7qyoPDvC8ZWQK8U4n9l8N78QwALOURxzQNs+CBatJQzbu2w1RKVwkfE6xEIVnu+wjiAtymfwdLHMagHxDIC/eOPbTnbbtITJk2ukFfoc0WJ6Awg5lW+x7nGokEn/XAjKyRHCpkRUFGQm4ww41zlrqCqQqnVGVABJtjbdtFf7nh33QHl0fkj19nfMox9eGuntPyM0bNA0XqPMA+FWSCqeDT6uLbyaOKWxlhv53U/NCJl76U3tssMEWsm9amEDDQg=="; parser.parse(userCert, issuerCert); - assertEquals("SHA1WITHRSA",parser.getSigAlgName()); + assertEquals("SHA1WITHRSA", parser.getSigAlgName()); + assertEquals(4096, parser.getKeyLength()); } @Test @@ -103,7 +105,8 @@ public class CertParserTest { String userCert = "MIICwDCCAmWgAwIBAgIFICdWkWgwDAYIKoEcz1UBg3UFADBdMQswCQYDVQQGEwJDTjEwMC4GA1UECgwnQ2hpbmEgRmluYW5jaWFsIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRwwGgYDVQQDDBNDRkNBIFRFU1QgU00yIE9DQTExMB4XDTE5MDUxNjA4MTA1MVoXDTIxMDUxNjA4MTA1MVoweDELMAkGA1UEBhMCQ04xGDAWBgNVBAoMD0NGQ0EgVEVTVCBPQ0ExMTERMA8GA1UECwwITG9jYWwgUkExFTATBgNVBAsMDEluZGl2aWR1YWwtMTElMCMGA1UEAwwcMDUxQHpoYW5nbGluIUBaMTg2MTIyMjkyOTVAMzBZMBMGByqGSM49AgEGCCqBHM9VAYItA0IABPvNXpdZ4/4g+wx5qKS94CPkMqpEDhlnXYYW7ZzsbNI4d28sVBz5Ji6dTT1Zx627Kvw4tdUaUt7BVMvZsu3BFlyjgfQwgfEwHwYDVR0jBBgwFoAUvqZ+TT18j6BV5sEvCS4sIEOzQn8wSAYDVR0gBEEwPzA9BghggRyG7yoBAjAxMC8GCCsGAQUFBwIBFiNodHRwOi8vd3d3LmNmY2EuY29tLmNuL3VzL3VzLTE1Lmh0bTA5BgNVHR8EMjAwMC6gLKAqhihodHRwOi8vMjEwLjc0LjQyLjMvT0NBMTEvU00yL2NybDIxMDkuY3JsMAsGA1UdDwQEAwID6DAdBgNVHQ4EFgQUxR5C/VjASus5zrAAFS4ulMpRjKgwHQYDVR0lBBYwFAYIKwYBBQUHAwIGCCsGAQUFBwMEMAwGCCqBHM9VAYN1BQADRwAwRAIgVBzVi/fgkknr+2BH2wXeGMXC+Pa6p7rbldUsYMOYoyUCIAmQ4KEk2U1xJZSBpOPy5jN9kmRb+0YH6x04O/2tqCgq"; parser.parse(userCert, issuerCert); - assertEquals("SM3WITHSM2",parser.getSigAlgName()); + assertEquals("SM3WITHSM2", parser.getSigAlgName()); + assertEquals(256, parser.getKeyLength()); } @Test @@ -141,6 +144,7 @@ public class CertParserTest { "PrIDl+E4aL3FypntFXHG3T+Keg==\n" + "-----END CERTIFICATE-----"; parser.parse(issuerCert, CACert); - assertEquals("SM3WITHSM2",parser.getSigAlgName()); + assertEquals("SM3WITHSM2", parser.getSigAlgName()); + assertEquals(256, parser.getKeyLength()); } } diff --git a/source/crypto/crypto-sm/src/main/java/com/jd/blockchain/crypto/utils/sm/SM2Utils.java b/source/crypto/crypto-sm/src/main/java/com/jd/blockchain/crypto/utils/sm/SM2Utils.java index 94c0cf32..b3a65b18 100644 --- a/source/crypto/crypto-sm/src/main/java/com/jd/blockchain/crypto/utils/sm/SM2Utils.java +++ b/source/crypto/crypto-sm/src/main/java/com/jd/blockchain/crypto/utils/sm/SM2Utils.java @@ -13,6 +13,8 @@ import org.bouncycastle.crypto.engines.SM2Engine; import org.bouncycastle.crypto.generators.ECKeyPairGenerator; import org.bouncycastle.crypto.params.*; import org.bouncycastle.crypto.signers.SM2Signer; +import org.bouncycastle.jce.ECNamedCurveTable; +import org.bouncycastle.jce.spec.ECNamedCurveParameterSpec; import org.bouncycastle.math.ec.*; import java.io.IOException; @@ -29,19 +31,10 @@ public class SM2Utils { // The length of sm3 output is 32 bytes private static final int SM3DIGEST_LENGTH = 32; - private static final BigInteger SM2_P = new BigInteger("FFFFFFFEFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000FFFFFFFFFFFFFFFF", 16); - private static final BigInteger SM2_A = new BigInteger("FFFFFFFEFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF00000000FFFFFFFFFFFFFFFC", 16); - private static final BigInteger SM2_B = new BigInteger("28E9FA9E9D9F5E344D5A9E4BCF6509A7F39789F515AB8F92DDBCBD414D940E93", 16); - private static final BigInteger SM2_N = new BigInteger("FFFFFFFEFFFFFFFFFFFFFFFFFFFFFFFF7203DF6B21C6052B53BBF40939D54123", 16); - private static final BigInteger SM2_H = ECConstants.ONE; - private static final BigInteger SM2_GX = new BigInteger("32C4AE2C1F1981195F9904466A39C9948FE30BBFF2660BE1715A4589334C74C7", 16); - private static final BigInteger SM2_GY = new BigInteger("BC3736A2F4F6779C59BDCEE36B692153D0A9877CC62A474002DF32E52139F0A0", 16); - - // To get the curve from the equation y^2=x^3+ax+b according the coefficient a and b, - // with the big prime p, the order n, the cofactor h, and obtain the generator g and the domain's parameters - private static final ECCurve CURVE = new ECCurve.Fp(SM2_P, SM2_A, SM2_B, SM2_N, SM2_H); - private static final ECPoint G = CURVE.createPoint(SM2_GX, SM2_GY); - private static final ECDomainParameters DOMAIN_PARAMS = new ECDomainParameters(CURVE, G, SM2_N); + private static final ECNamedCurveParameterSpec PARAMS = ECNamedCurveTable.getParameterSpec("sm2p256v1"); + private static final ECCurve CURVE = PARAMS.getCurve(); + private static final ECDomainParameters DOMAIN_PARAMS = new ECDomainParameters( + CURVE, PARAMS.getG(), PARAMS.getN(), PARAMS.getH()); //-----------------Key Generation Algorithm----------------- From 47ac7af85de74dece8965a0ed34b7fdb34cf7679 Mon Sep 17 00:00:00 2001 From: huanghaiquan Date: Tue, 3 Sep 2019 23:25:40 +0800 Subject: [PATCH 19/23] Fixed bugs about contract invoking; --- .../jvm/InstantiatedContractCode.java | 25 ++++ .../ledger/core/impl/LedgerQueryService.java | 6 +- .../ledger/ContractInvokingHandle.java | 26 +--- .../ledger/ContractInvokingTest.java | 137 ++++++++++++++++-- .../ledger/TransactionBatchProcessorTest.java | 16 +- .../jd/blockchain/ledger/TxTestContract.java | 18 +++ .../blockchain/ledger/TxTestContractImpl.java | 79 ++++++++++ .../blockchain/ledger/BytesValueEncoding.java | 48 +++--- .../resolver/BooleanToBytesValueResolver.java | 58 ++++++++ .../ledger/resolver/BytesValueResolver.java | 124 ++++++++-------- source/test/test-contract/pom.xml | 34 +++++ .../ContractTransactionRollbackTest.java | 14 ++ 12 files changed, 461 insertions(+), 124 deletions(-) create mode 100644 source/contract/contract-jvm/src/main/java/com/jd/blockchain/contract/jvm/InstantiatedContractCode.java create mode 100644 source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContract.java create mode 100644 source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContractImpl.java create mode 100644 source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/resolver/BooleanToBytesValueResolver.java create mode 100644 source/test/test-contract/pom.xml create mode 100644 source/test/test-contract/src/test/java/test/com/jd/blockchain/contract/ContractTransactionRollbackTest.java diff --git a/source/contract/contract-jvm/src/main/java/com/jd/blockchain/contract/jvm/InstantiatedContractCode.java b/source/contract/contract-jvm/src/main/java/com/jd/blockchain/contract/jvm/InstantiatedContractCode.java new file mode 100644 index 00000000..94adc3a7 --- /dev/null +++ b/source/contract/contract-jvm/src/main/java/com/jd/blockchain/contract/jvm/InstantiatedContractCode.java @@ -0,0 +1,25 @@ +package com.jd.blockchain.contract.jvm; + +import com.jd.blockchain.contract.ContractType; +import com.jd.blockchain.utils.Bytes; + +public class InstantiatedContractCode extends AbstractContractCode { + + private T instance; + + public InstantiatedContractCode(Bytes address, long version, Class delaredInterface, T instance) { + super(address, version, resolveContractDefinition(delaredInterface, instance.getClass())); + this.instance = instance; + } + + private static ContractDefinition resolveContractDefinition(Class declaredIntf, Class implementedClass) { + ContractType contractType = ContractType.resolve(declaredIntf); + return new ContractDefinition(contractType, implementedClass); + } + + @Override + protected T getContractInstance() { + return instance; + } + + } \ No newline at end of file diff --git a/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/impl/LedgerQueryService.java b/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/impl/LedgerQueryService.java index 5696ded7..226be047 100644 --- a/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/impl/LedgerQueryService.java +++ b/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/impl/LedgerQueryService.java @@ -20,6 +20,8 @@ import com.jd.blockchain.utils.QueryUtil; public class LedgerQueryService implements BlockchainQueryService { + private static final KVDataEntry[] EMPTY_ENTRIES = new KVDataEntry[0]; + private LedgerService ledgerService; public LedgerQueryService(LedgerService ledgerService) { @@ -254,7 +256,7 @@ public class LedgerQueryService implements BlockchainQueryService { @Override public KVDataEntry[] getDataEntries(HashDigest ledgerHash, String address, String... keys) { if (keys == null || keys.length == 0) { - return null; + return EMPTY_ENTRIES; } LedgerRepository ledger = ledgerService.getLedger(ledgerHash); LedgerBlock block = ledger.getLatestBlock(); @@ -266,7 +268,7 @@ public class LedgerQueryService implements BlockchainQueryService { for (int i = 0; i < entries.length; i++) { final String currKey = keys[i]; - ver = dataAccount.getDataVersion(Bytes.fromString(currKey)); + ver = dataAccount == null ? -1 : dataAccount.getDataVersion(Bytes.fromString(currKey)); if (ver < 0) { entries[i] = new KVDataObject(currKey, -1, null); diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingHandle.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingHandle.java index c0a31321..ef354223 100644 --- a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingHandle.java +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingHandle.java @@ -3,10 +3,8 @@ package test.com.jd.blockchain.ledger; import java.util.Map; import java.util.concurrent.ConcurrentHashMap; -import com.jd.blockchain.contract.ContractType; import com.jd.blockchain.contract.engine.ContractCode; -import com.jd.blockchain.contract.jvm.AbstractContractCode; -import com.jd.blockchain.contract.jvm.ContractDefinition; +import com.jd.blockchain.contract.jvm.InstantiatedContractCode; import com.jd.blockchain.ledger.core.ContractAccount; import com.jd.blockchain.ledger.core.impl.handles.AbtractContractEventHandle; import com.jd.blockchain.utils.Bytes; @@ -21,30 +19,10 @@ public class ContractInvokingHandle extends AbtractContractEventHandle { } public ContractCode setup(Bytes address, Class contractIntf, T instance) { - ContractCodeInstance contract = new ContractCodeInstance(address, 0, contractIntf, instance); + InstantiatedContractCode contract = new InstantiatedContractCode(address, 0, contractIntf, instance); contractInstances.put(address, contract); return contract; } - private static class ContractCodeInstance extends AbstractContractCode { - - private T instance; - - public ContractCodeInstance(Bytes address, long version, Class delaredInterface, T instance) { - super(address, version, resolveContractDefinition(delaredInterface, instance.getClass())); - this.instance = instance; - } - - private static ContractDefinition resolveContractDefinition(Class declaredIntf, Class implementedClass) { - ContractType contractType = ContractType.resolve(declaredIntf); - return new ContractDefinition(contractType, implementedClass); - } - - @Override - protected T getContractInstance() { - return instance; - } - - } } diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingTest.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingTest.java index fd9df2d4..15bf2671 100644 --- a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingTest.java +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingTest.java @@ -1,27 +1,57 @@ package test.com.jd.blockchain.ledger; +import static org.junit.Assert.assertArrayEquals; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNotNull; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertTrue; +import static org.mockito.Matchers.anyLong; +import static org.mockito.Matchers.anyString; +import static org.mockito.Mockito.times; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +import java.util.Random; + +import org.junit.Test; +import org.mockito.Mockito; + import com.jd.blockchain.binaryproto.BinaryProtocol; import com.jd.blockchain.binaryproto.DataContractRegistry; import com.jd.blockchain.crypto.HashDigest; -import com.jd.blockchain.ledger.*; -import com.jd.blockchain.ledger.core.*; +import com.jd.blockchain.ledger.BlockchainKeyGenerator; +import com.jd.blockchain.ledger.BlockchainKeypair; +import com.jd.blockchain.ledger.BytesData; +import com.jd.blockchain.ledger.BytesValue; +import com.jd.blockchain.ledger.DataAccountRegisterOperation; +import com.jd.blockchain.ledger.EndpointRequest; +import com.jd.blockchain.ledger.LedgerBlock; +import com.jd.blockchain.ledger.LedgerInitSetting; +import com.jd.blockchain.ledger.LedgerTransaction; +import com.jd.blockchain.ledger.NodeRequest; +import com.jd.blockchain.ledger.OperationResult; +import com.jd.blockchain.ledger.TransactionContent; +import com.jd.blockchain.ledger.TransactionContentBody; +import com.jd.blockchain.ledger.TransactionRequest; +import com.jd.blockchain.ledger.TransactionRequestBuilder; +import com.jd.blockchain.ledger.TransactionResponse; +import com.jd.blockchain.ledger.TransactionState; +import com.jd.blockchain.ledger.UserRegisterOperation; +import com.jd.blockchain.ledger.core.LedgerDataSet; +import com.jd.blockchain.ledger.core.LedgerEditor; +import com.jd.blockchain.ledger.core.LedgerRepository; +import com.jd.blockchain.ledger.core.LedgerTransactionContext; +import com.jd.blockchain.ledger.core.UserAccount; import com.jd.blockchain.ledger.core.impl.DefaultOperationHandleRegisteration; import com.jd.blockchain.ledger.core.impl.LedgerManager; import com.jd.blockchain.ledger.core.impl.LedgerTransactionalEditor; import com.jd.blockchain.ledger.core.impl.TransactionBatchProcessor; import com.jd.blockchain.service.TransactionBatchResultHandle; import com.jd.blockchain.storage.service.utils.MemoryKVStorage; +import com.jd.blockchain.transaction.BooleanValueHolder; +import static com.jd.blockchain.transaction.ContractReturnValue.*; import com.jd.blockchain.transaction.TxBuilder; import com.jd.blockchain.utils.Bytes; -import org.junit.Test; -import org.mockito.Mockito; - -import java.util.Random; - -import static org.junit.Assert.*; -import static org.mockito.Matchers.anyLong; -import static org.mockito.Matchers.anyString; -import static org.mockito.Mockito.*; public class ContractInvokingTest { static { @@ -32,6 +62,7 @@ public class ContractInvokingTest { DataContractRegistry.register(EndpointRequest.class); DataContractRegistry.register(TransactionResponse.class); DataContractRegistry.register(UserRegisterOperation.class); + DataContractRegistry.register(DataAccountRegisterOperation.class); } private static final String LEDGER_KEY_PREFIX = "LDG://"; @@ -45,7 +76,7 @@ public class ContractInvokingTest { private MemoryKVStorage storage = new MemoryKVStorage(); @Test - public void test() { + public void testNormal() { // 初始化账本到指定的存储库； HashDigest ledgerHash = initLedger(storage, parti0, parti1, parti2, parti3); @@ -69,7 +100,6 @@ public class ContractInvokingTest { // 发布指定地址合约 deploy(ledgerRepo, ledgerManager, opReg, ledgerHash, contractKey); - // 创建新区块的交易处理器； LedgerBlock preBlock = ledgerRepo.getLatestBlock(); LedgerDataSet previousBlockDataset = ledgerRepo.getDataSet(preBlock); @@ -122,9 +152,86 @@ public class ContractInvokingTest { } + @Test + public void testReadNewWritting() { + // 初始化账本到指定的存储库； + HashDigest ledgerHash = initLedger(storage, parti0, parti1, parti2, parti3); + + // 重新加载账本； + LedgerManager ledgerManager = new LedgerManager(); + LedgerRepository ledgerRepo = ledgerManager.register(ledgerHash, storage); + + // 创建合约处理器； + ContractInvokingHandle contractInvokingHandle = new ContractInvokingHandle(); + + // 创建和加载合约实例； + BlockchainKeypair contractKey = BlockchainKeyGenerator.getInstance().generate(); + Bytes contractAddress = contractKey.getAddress(); + TxTestContractImpl contractInstance = new TxTestContractImpl(); + contractInvokingHandle.setup(contractAddress, TxTestContract.class, contractInstance); + + // 注册合约处理器； + DefaultOperationHandleRegisteration opReg = new DefaultOperationHandleRegisteration(); + opReg.insertAsTopPriority(contractInvokingHandle); + + // 发布指定地址合约 + deploy(ledgerRepo, ledgerManager, opReg, ledgerHash, contractKey); + + // 创建新区块的交易处理器； + LedgerBlock preBlock = ledgerRepo.getLatestBlock(); + LedgerDataSet previousBlockDataset = ledgerRepo.getDataSet(preBlock); + + // 加载合约 + LedgerEditor newBlockEditor = ledgerRepo.createNextBlock(); + TransactionBatchProcessor txbatchProcessor = new TransactionBatchProcessor(newBlockEditor, previousBlockDataset, + opReg, ledgerManager); + + String key = TxTestContractImpl.KEY; + String value = "VAL"; + + TxBuilder txBuilder = new TxBuilder(ledgerHash); + BlockchainKeypair kpDataAccount = BlockchainKeyGenerator.getInstance().generate(); + contractInstance.setDataAddress(kpDataAccount.getAddress()); + + txBuilder.dataAccounts().register(kpDataAccount.getIdentity()); + TransactionRequestBuilder txReqBuilder1 = txBuilder.prepareRequest(); + txReqBuilder1.signAsEndpoint(parti0); + txReqBuilder1.signAsNode(parti0); + TransactionRequest txReq1 = txReqBuilder1.buildRequest(); + + // 构建基于接口调用合约的交易请求，用于测试合约调用； + txBuilder = new TxBuilder(ledgerHash); + TxTestContract contractProxy = txBuilder.contract(contractAddress, TxTestContract.class); + BooleanValueHolder readableHolder = decode(contractProxy.testReadable()); + + TransactionRequestBuilder txReqBuilder2 = txBuilder.prepareRequest(); + txReqBuilder2.signAsEndpoint(parti0); + txReqBuilder2.signAsNode(parti0); + TransactionRequest txReq2 = txReqBuilder2.buildRequest(); + + TransactionResponse resp1 = txbatchProcessor.schedule(txReq1); + TransactionResponse resp2 = txbatchProcessor.schedule(txReq2); + + // 提交区块； + TransactionBatchResultHandle txResultHandle = txbatchProcessor.prepare(); + txResultHandle.commit(); + + BytesValue latestValue = ledgerRepo.getDataAccountSet().getDataAccount(kpDataAccount.getAddress()).getBytes(key, + -1); + System.out.printf("latest value=[%s] %s \r\n", latestValue.getType(), latestValue.getValue().toUTF8String()); + + + boolean readable = readableHolder.get(); + assertTrue(readable); + + LedgerBlock latestBlock = ledgerRepo.getLatestBlock(); + assertEquals(preBlock.getHeight() + 1, latestBlock.getHeight()); + assertEquals(resp1.getBlockHeight(), latestBlock.getHeight()); + assertEquals(resp1.getBlockHash(), latestBlock.getHash()); + } + private void deploy(LedgerRepository ledgerRepo, LedgerManager ledgerManager, - DefaultOperationHandleRegisteration opReg, HashDigest ledgerHash, - BlockchainKeypair contractKey) { + DefaultOperationHandleRegisteration opReg, HashDigest ledgerHash, BlockchainKeypair contractKey) { // 创建新区块的交易处理器； LedgerBlock preBlock = ledgerRepo.getLatestBlock(); LedgerDataSet previousBlockDataset = ledgerRepo.getDataSet(preBlock); diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TransactionBatchProcessorTest.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TransactionBatchProcessorTest.java index f857a6ad..39665bde 100644 --- a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TransactionBatchProcessorTest.java +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TransactionBatchProcessorTest.java @@ -288,6 +288,8 @@ public class TransactionBatchProcessorTest { "K2", "V-2-1", -1, ledgerHash, parti0, parti0); TransactionRequest txreq3 = LedgerTestUtils.createTxRequest_DataAccountWrite(dataAccountKeypair.getAddress(), "K3", "V-3-1", -1, ledgerHash, parti0, parti0); + + // 连续写 K1，K1的版本将变为1； TransactionRequest txreq4 = LedgerTestUtils.createTxRequest_DataAccountWrite(dataAccountKeypair.getAddress(), "K1", "V-1-2", 0, ledgerHash, parti0, parti0); @@ -316,14 +318,14 @@ public class TransactionBatchProcessorTest { assertNotNull(v1_1); assertNotNull(v2); assertNotNull(v3); - + assertEquals("V-1-1", v1_0.getValue().toUTF8String()); assertEquals("V-1-2", v1_1.getValue().toUTF8String()); assertEquals("V-2-1", v2.getValue().toUTF8String()); assertEquals("V-3-1", v3.getValue().toUTF8String()); // 提交多笔数据写入的交易，包含存在数据版本冲突的交易，验证交易是否正确回滚； - + // 先写一笔正确的交易； k3 的版本将变为 1 ； TransactionRequest txreq5 = LedgerTestUtils.createTxRequest_DataAccountWrite(dataAccountKeypair.getAddress(), "K3", "V-3-2", 0, ledgerHash, parti0, parti0); // 指定冲突的版本号，正确的应该是版本1； @@ -343,11 +345,15 @@ public class TransactionBatchProcessorTest { BytesValue v1 = ledgerRepo.getDataAccountSet().getDataAccount(dataAccountKeypair.getAddress()).getBytes("K1"); v3 = ledgerRepo.getDataAccountSet().getDataAccount(dataAccountKeypair.getAddress()).getBytes("K3"); - long k1_version = ledgerRepo.getDataAccountSet().getDataAccount(dataAccountKeypair.getAddress()).getDataVersion("K1"); + // k1 的版本仍然为1，没有更新； + long k1_version = ledgerRepo.getDataAccountSet().getDataAccount(dataAccountKeypair.getAddress()) + .getDataVersion("K1"); assertEquals(1, k1_version); - long k3_version = ledgerRepo.getDataAccountSet().getDataAccount(dataAccountKeypair.getAddress()).getDataVersion("K3"); + + long k3_version = ledgerRepo.getDataAccountSet().getDataAccount(dataAccountKeypair.getAddress()) + .getDataVersion("K3"); assertEquals(1, k3_version); - + assertNotNull(v1); assertNotNull(v3); assertEquals("V-1-2", v1.getValue().toUTF8String()); diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContract.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContract.java new file mode 100644 index 00000000..80df9803 --- /dev/null +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContract.java @@ -0,0 +1,18 @@ +package test.com.jd.blockchain.ledger; + +import com.jd.blockchain.contract.Contract; +import com.jd.blockchain.contract.ContractEvent; + +@Contract +public interface TxTestContract { + + @ContractEvent(name = "testReadable") + boolean testReadable(); + +// @ContractEvent(name = "prepareData") +// String[] prepareData(String address); +// +// @ContractEvent(name = "doVersionConflictedWritting") +// void doVersionConflictedWritting(String key, String value, long version); + +} diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContractImpl.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContractImpl.java new file mode 100644 index 00000000..bd9137d4 --- /dev/null +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContractImpl.java @@ -0,0 +1,79 @@ +package test.com.jd.blockchain.ledger; + +import com.jd.blockchain.contract.ContractEventContext; +import com.jd.blockchain.contract.ContractLifecycleAware; +import com.jd.blockchain.contract.EventProcessingAware; +import com.jd.blockchain.ledger.KVDataEntry; +import com.jd.blockchain.utils.Bytes; + +public class TxTestContractImpl implements TxTestContract, ContractLifecycleAware, EventProcessingAware { + + private ContractEventContext eventContext; + + private Bytes dataAddress; + + public static String KEY = "k1"; + + @Override + public boolean testReadable() { + KVDataEntry v1 = eventContext.getLedger().getDataEntries(eventContext.getCurrentLedgerHash(), + dataAddress.toBase58(), KEY)[0]; + String text1 = (String) v1.getValue(); + System.out.printf("k1=%s, version=%s \r\n", text1, v1.getVersion()); + + text1 = null == text1 ? "v" : text1; + String newValue = text1 + "-" + (v1.getVersion() + 1); + System.out.printf("new value = %s\r\n", newValue); + eventContext.getLedger().dataAccount(dataAddress).setText(KEY, newValue, v1.getVersion()); + + KVDataEntry v2 = eventContext.getLedger().getDataEntries(eventContext.getCurrentLedgerHash(), + dataAddress.toBase58(), KEY)[0]; + System.out.printf("---- read new value ----\r\nk1=%s, version=%s \r\n", v2.getValue(), v2.getVersion()); + + String text2 = (String) v2.getValue(); + return text1.equals(text2); + } + +// @Override +// public String[] prepareData(String address) { +// // TODO Auto-generated method stub +// return null; +// } +// +// @Override +// public void doVersionConflictedWritting(String key, String value, long version) { +// // TODO Auto-generated method stub +// +// } + + @Override + public void postConstruct() { + // TODO Auto-generated method stub + + } + + @Override + public void beforeDestroy() { + // TODO Auto-generated method stub + + } + + @Override + public void beforeEvent(ContractEventContext eventContext) { + this.eventContext = eventContext; + } + + @Override + public void postEvent(ContractEventContext eventContext, Exception error) { + this.eventContext = null; + } + + public Bytes getDataAddress() { + return dataAddress; + } + + public void setDataAddress(Bytes dataAddress) { + this.dataAddress = dataAddress; + } + +} diff --git a/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/BytesValueEncoding.java b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/BytesValueEncoding.java index af67719e..66a9eee2 100644 --- a/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/BytesValueEncoding.java +++ b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/BytesValueEncoding.java @@ -1,32 +1,36 @@ package com.jd.blockchain.ledger; -import com.jd.blockchain.binaryproto.BinaryProtocol; -import com.jd.blockchain.binaryproto.DataContract; -import com.jd.blockchain.ledger.resolver.*; - import java.util.ArrayList; import java.util.List; import java.util.Map; import java.util.concurrent.ConcurrentHashMap; +import com.jd.blockchain.binaryproto.BinaryProtocol; +import com.jd.blockchain.binaryproto.DataContract; +import com.jd.blockchain.ledger.resolver.BooleanToBytesValueResolver; +import com.jd.blockchain.ledger.resolver.BytesToBytesValueResolver; +import com.jd.blockchain.ledger.resolver.BytesValueResolver; +import com.jd.blockchain.ledger.resolver.IntegerToBytesValueResolver; +import com.jd.blockchain.ledger.resolver.LongToBytesValueResolver; +import com.jd.blockchain.ledger.resolver.ShortToBytesValueResolver; +import com.jd.blockchain.ledger.resolver.StringToBytesValueResolver; + public class BytesValueEncoding { private static final Map, BytesValueResolver> CLASS_RESOLVER_MAP = new ConcurrentHashMap<>(); private static final Map DATA_TYPE_RESOLVER_MAP = new ConcurrentHashMap<>(); + private static final Object[] EMPTY_OBJECTS = {}; + static { init(); } private static void init() { - BytesValueResolver[] resolvers = new BytesValueResolver[]{ - new BytesToBytesValueResolver(), - new IntegerToBytesValueResolver(), - new LongToBytesValueResolver(), - new ShortToBytesValueResolver(), - new StringToBytesValueResolver() - }; + BytesValueResolver[] resolvers = new BytesValueResolver[] { new BooleanToBytesValueResolver(), + new BytesToBytesValueResolver(), new IntegerToBytesValueResolver(), new LongToBytesValueResolver(), + new ShortToBytesValueResolver(), new StringToBytesValueResolver() }; for (BytesValueResolver currResolver : resolvers) { // 填充classMAP @@ -47,7 +51,6 @@ public class BytesValueEncoding { } } - public static BytesValue encodeSingle(Object value, Class type) { if (value == null) { return null; @@ -60,7 +63,8 @@ public class BytesValueEncoding { if (type.isInterface()) { // 判断是否含有DataContract注解 if (!type.isAnnotationPresent(DataContract.class)) { - throw new IllegalStateException(String.format("Interface[%s] can not be serialize !!!", type.getName())); + throw new IllegalStateException( + String.format("Interface[%s] can not be serialize !!!", type.getName())); } // 将对象序列化 byte[] serialBytes = BinaryProtocol.encode(value, type); @@ -72,7 +76,7 @@ public class BytesValueEncoding { } return bytesValueResolver.encode(value, type); } - + public static BytesValueList encodeArray(Object[] values, Class[] types) { if (values == null || values.length == 0) { return null; @@ -101,11 +105,14 @@ public class BytesValueEncoding { } return type == null ? valueResolver.decode(value) : valueResolver.decode(value, type); } - + public static Object[] decode(BytesValueList values, Class[] types) { + if (values == null) { + return EMPTY_OBJECTS; + } BytesValue[] bytesValues = values.getValues(); if (bytesValues == null || bytesValues.length == 0) { - return null; + return EMPTY_OBJECTS; } // 允许types为null，此时每个BytesValue按照当前的对象来处理 // 若types不为null，则types's长度必须和bytesValues一致 @@ -120,7 +127,8 @@ public class BytesValueEncoding { DataType dataType = bytesValue.getType(); BytesValueResolver valueResolver = DATA_TYPE_RESOLVER_MAP.get(dataType); if (valueResolver == null) { - throw new IllegalStateException(String.format("DataType[%s] can not find encoder !!!", dataType.name())); + throw new IllegalStateException( + String.format("DataType[%s] can not find encoder !!!", dataType.name())); } resolveObjs[i] = valueResolver.decode(bytesValue); } @@ -132,7 +140,7 @@ public class BytesValueEncoding { } return resolveObjs; } - + public static Object getDefaultValue(Class type) { if (type == void.class || type == Void.class) { return null; @@ -174,14 +182,14 @@ public class BytesValueEncoding { if (currParamType.isInterface()) { // 接口序列化必须实现DataContract注解 if (!currParamType.isAnnotationPresent(DataContract.class)) { - throw new IllegalStateException(String.format("Interface[%s] can not be serialize !!!", currParamType.getName())); + throw new IllegalStateException( + String.format("Interface[%s] can not be serialize !!!", currParamType.getName())); } return true; } return CLASS_RESOLVER_MAP.containsKey(currParamType); } - public static class BytesValueListData implements BytesValueList { private List bytesValues = new ArrayList<>(); diff --git a/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/resolver/BooleanToBytesValueResolver.java b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/resolver/BooleanToBytesValueResolver.java new file mode 100644 index 00000000..0664fdb9 --- /dev/null +++ b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/resolver/BooleanToBytesValueResolver.java @@ -0,0 +1,58 @@ +package com.jd.blockchain.ledger.resolver; + +import com.jd.blockchain.ledger.BytesData; +import com.jd.blockchain.ledger.BytesValue; +import com.jd.blockchain.ledger.DataType; +import com.jd.blockchain.utils.Bytes; +import com.jd.blockchain.utils.io.BytesUtils; + +import java.util.Set; + +public class BooleanToBytesValueResolver extends AbstractBytesValueResolver { + + private final Class[] supportClasses = { Boolean.class, boolean.class }; + + private final DataType[] supportDataTypes = { DataType.BOOLEAN }; + + private final Set> convertClasses = initBooleanConvertSet(); + + @Override + public BytesValue encode(Object value, Class type) { + if (!isSupport(type)) { + throw new IllegalStateException(String.format("Un-support encode Class[%s] Object !!!", type.getName())); + } + return BytesData.fromBoolean((boolean) value); + } + + @Override + public Class[] supportClasses() { + return supportClasses; + } + + @Override + public DataType[] supportDataTypes() { + return supportDataTypes; + } + + @Override + protected Object decode(Bytes value) { + return BytesUtils.toInt(value.toBytes()); + } + + @Override + public Object decode(BytesValue value, Class clazz) { + // 支持转换为short、int、long + int intVal = (int) decode(value); + if (convertClasses.contains(clazz)) { + // 对于short和Short需要强制类型转换 + if (clazz.equals(short.class) || clazz.equals(Short.class)) { + return (short) intVal; + } else if (clazz.equals(long.class) || clazz.equals(Long.class)) { + return (long) intVal; + } + return intVal; + } else { + throw new IllegalStateException(String.format("Un-Support decode value to class[%s] !!!", clazz.getName())); + } + } +} diff --git a/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/resolver/BytesValueResolver.java b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/resolver/BytesValueResolver.java index 08e48658..4c659567 100644 --- a/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/resolver/BytesValueResolver.java +++ b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/resolver/BytesValueResolver.java @@ -10,71 +10,79 @@ import java.util.Set; public interface BytesValueResolver { - /** - * Int相关的可转换Class集合 - */ - Class[] supportIntConvertClasses = { - short.class, Short.class, int.class, Integer.class, long.class, Long.class}; + /** + * Boolean相关的可转换Class集合 + */ + Class[] supportBooleanConvertClasses = { boolean.class, Boolean.class }; - /** - * 字节数组（字符串）相关可转换的Class集合 - */ - Class[] supportByteConvertClasses = { - String.class, Bytes.class, byte[].class}; + /** + * Int相关的可转换Class集合 + */ + Class[] supportIntConvertClasses = { short.class, Short.class, int.class, Integer.class, long.class, + Long.class }; - default Set> initIntConvertSet() { - return new HashSet<>(Arrays.asList(supportIntConvertClasses)); - } + /** + * 字节数组（字符串）相关可转换的Class集合 + */ + Class[] supportByteConvertClasses = { String.class, Bytes.class, byte[].class }; + + default Set> initBooleanConvertSet() { + return new HashSet<>(Arrays.asList(supportBooleanConvertClasses)); + } - default Set> initByteConvertSet() { - return new HashSet<>(Arrays.asList(supportByteConvertClasses)); - } + default Set> initIntConvertSet() { + return new HashSet<>(Arrays.asList(supportIntConvertClasses)); + } - /** - * 将对象转换为BytesValue - * - * @param value - * @return - */ - BytesValue encode(Object value); + default Set> initByteConvertSet() { + return new HashSet<>(Arrays.asList(supportByteConvertClasses)); + } - /** - * 将对象转换为BytesValue - * - * @param value - * @param type - * @return - */ - BytesValue encode(Object value, Class type); + /** + * 将对象转换为BytesValue + * + * @param value + * @return + */ + BytesValue encode(Object value); - /** - * 当前解析器支持的Class列表 - * - * @return - */ - Class[] supportClasses(); + /** + * 将对象转换为BytesValue + * + * @param value + * @param type + * @return + */ + BytesValue encode(Object value, Class type); - /** - * 当前解析器支持的DataType列表 - * - * @return - */ - DataType[] supportDataTypes(); + /** + * 当前解析器支持的Class列表 + * + * @return + */ + Class[] supportClasses(); - /** - * 将BytesValue解析为对应的Object - * - * @param value - * @return - */ - Object decode(BytesValue value); + /** + * 当前解析器支持的DataType列表 + * + * @return + */ + DataType[] supportDataTypes(); - /** - * 将BytesValue转换为指定Class的Object - * - * @param value - * @param clazz - * @return - */ - Object decode(BytesValue value, Class clazz); + /** + * 将BytesValue解析为对应的Object + * + * @param value + * @return + */ + Object decode(BytesValue value); + + /** + * 将BytesValue转换为指定Class的Object + * + * @param value + * @param clazz + * @return + */ + Object decode(BytesValue value, Class clazz); } diff --git a/source/test/test-contract/pom.xml b/source/test/test-contract/pom.xml new file mode 100644 index 00000000..a9c59ddf --- /dev/null +++ b/source/test/test-contract/pom.xml @@ -0,0 +1,34 @@ + + 4.0.0 + + com.jd.blockchain + test + 1.0.1.RELEASE + + test-contract + + + + com.jd.blockchain + contract-jvm + ${project.version} + + + com.jd.blockchain + ledger-core + ${project.version} + + + com.jd.blockchain + storage-rocksdb + ${project.version} + + + com.jd.blockchain + crypto-classic + ${project.version} + + + \ No newline at end of file diff --git a/source/test/test-contract/src/test/java/test/com/jd/blockchain/contract/ContractTransactionRollbackTest.java b/source/test/test-contract/src/test/java/test/com/jd/blockchain/contract/ContractTransactionRollbackTest.java new file mode 100644 index 00000000..bda44aed --- /dev/null +++ b/source/test/test-contract/src/test/java/test/com/jd/blockchain/contract/ContractTransactionRollbackTest.java @@ -0,0 +1,14 @@ +package test.com.jd.blockchain.contract; + +import static org.junit.Assert.*; + +import org.junit.Test; + +public class ContractTransactionRollbackTest { + + @Test + public void test() { + + } + +} From ef6c4049d2d11f5e85ed66be9aa59ca90f862611 Mon Sep 17 00:00:00 2001 From: huanghaiquan Date: Thu, 5 Sep 2019 01:28:27 +0800 Subject: [PATCH 20/23] Fixed bugs: (1)unsupported no-parameter contract function; (2) doesn't rollback when kv-writting version conflict occurs; --- .../blockchain/ledger/core/DataAccount.java | 97 +++++++++- .../blockchain/ledger/core/MerkleDataSet.java | 2 +- .../DataAccountKVSetOperationHandle.java | 7 +- .../ledger/ContractInvokingTest.java | 172 +++++++++++++++++- .../jd/blockchain/ledger/KeyValueEntry.java | 19 ++ .../jd/blockchain/ledger/KeyValueObject.java | 47 +++++ .../blockchain/ledger/MerkleDataSetTest.java | 33 ++++ .../ledger/TransactionBatchProcessorTest.java | 12 +- .../jd/blockchain/ledger/TxTestContract.java | 9 +- .../blockchain/ledger/TxTestContractImpl.java | 17 +- .../blockchain/ledger/BytesValueEncoding.java | 15 +- .../ledger/DataVersionConflictException.java | 27 +++ .../blockchain/ledger/TransactionState.java | 5 + .../jd/blockchain/runtime/RuntimeContext.java | 2 +- 14 files changed, 435 insertions(+), 29 deletions(-) create mode 100644 source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/KeyValueEntry.java create mode 100644 source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/KeyValueObject.java create mode 100644 source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/DataVersionConflictException.java diff --git a/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/DataAccount.java b/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/DataAccount.java index 792ca704..93286676 100644 --- a/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/DataAccount.java +++ b/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/DataAccount.java @@ -1,12 +1,11 @@ package com.jd.blockchain.ledger.core; import com.jd.blockchain.binaryproto.BinaryProtocol; -import com.jd.blockchain.binaryproto.PrimitiveType; import com.jd.blockchain.crypto.HashDigest; import com.jd.blockchain.crypto.PubKey; import com.jd.blockchain.ledger.AccountHeader; -import com.jd.blockchain.ledger.BytesValue; import com.jd.blockchain.ledger.BytesData; +import com.jd.blockchain.ledger.BytesValue; import com.jd.blockchain.ledger.KVDataEntry; import com.jd.blockchain.ledger.KVDataObject; import com.jd.blockchain.utils.Bytes; @@ -43,16 +42,85 @@ public class DataAccount implements AccountHeader, MerkleProvable { } + /** + * Create or update the value associated the specified key if the version + * checking is passed.
+ * + * The value of the key will be updated only if it's latest version equals the + * specified version argument.
+ * If the key doesn't exist, the version checking will be ignored, and key will + * be created with a new sequence number as id.
+ * It also could specify the version argument to -1 to ignore the version + * checking. + *

+ * If updating is performed, the version of the key increase by 1.
+ * If creating is performed, the version of the key initialize by 0.
+ * + * @param key The key of data; + * @param value The value of data; + * @param version The expected version of the key. + * @return The new version of the key.
+ * If the key is new created success, then return 0;
+ * If the key is updated success, then return the new version;
+ * If this operation fail by version checking or other reason, then + * return -1; + */ public long setBytes(Bytes key, BytesValue value, long version) { return baseAccount.setBytes(key, value, version); } + /** + * Create or update the value associated the specified key if the version + * checking is passed.
+ * + * The value of the key will be updated only if it's latest version equals the + * specified version argument.
+ * If the key doesn't exist, the version checking will be ignored, and key will + * be created with a new sequence number as id.
+ * It also could specify the version argument to -1 to ignore the version + * checking. + *

+ * If updating is performed, the version of the key increase by 1.
+ * If creating is performed, the version of the key initialize by 0.
+ * + * @param key The key of data; + * @param value The value of data; + * @param version The expected version of the key. + * @return The new version of the key.
+ * If the key is new created success, then return 0;
+ * If the key is updated success, then return the new version;
+ * If this operation fail by version checking or other reason, then + * return -1; + */ public long setBytes(Bytes key, String value, long version) { BytesValue bytesValue = BytesData.fromText(value); return baseAccount.setBytes(key, bytesValue, version); } + /** + * Create or update the value associated the specified key if the version + * checking is passed.
+ * + * The value of the key will be updated only if it's latest version equals the + * specified version argument.
+ * If the key doesn't exist, the version checking will be ignored, and key will + * be created with a new sequence number as id.
+ * It also could specify the version argument to -1 to ignore the version + * checking. + *

+ * If updating is performed, the version of the key increase by 1.
+ * If creating is performed, the version of the key initialize by 0.
+ * + * @param key The key of data; + * @param value The value of data; + * @param version The expected version of the key. + * @return The new version of the key.
+ * If the key is new created success, then return 0;
+ * If the key is updated success, then return the new version;
+ * If this operation fail by version checking or other reason, then + * return -1; + */ public long setBytes(Bytes key, byte[] value, long version) { BytesValue bytesValue = BytesData.fromBytes(value); return baseAccount.setBytes(key, bytesValue, version); @@ -121,6 +189,29 @@ public class DataAccount implements AccountHeader, MerkleProvable { public BytesValue getBytes(Bytes key, long version) { return baseAccount.getBytes(key, version); } + + /** + * @param key + * @param version + * @return + */ + public KVDataEntry getDataEntry(String key, long version) { + return getDataEntry(Bytes.fromString(key), version); + } + + /** + * @param key + * @param version + * @return + */ + public KVDataEntry getDataEntry(Bytes key, long version) { + BytesValue value = baseAccount.getBytes(key, version); + if (value == null) { + return new KVDataObject(key.toUTF8String(), -1, null); + }else { + return new KVDataObject(key.toUTF8String(), version, value); + } + } /** * return the specified index's KVDataEntry; @@ -131,7 +222,7 @@ public class DataAccount implements AccountHeader, MerkleProvable { */ public KVDataEntry[] getDataEntries(int fromIndex, int count) { - if (getDataEntriesTotalCount() == 0 || count == 0) { + if (count == 0 || getDataEntriesTotalCount() == 0) { return null; } diff --git a/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/MerkleDataSet.java b/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/MerkleDataSet.java index b8dd170b..59ebd13f 100644 --- a/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/MerkleDataSet.java +++ b/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/MerkleDataSet.java @@ -168,7 +168,7 @@ public class MerkleDataSet implements Transactional, MerkleProvable { */ public String getKeyAtIndex(int fromIndex) { MerkleDataNode dataNode = merkleTree.getData(fromIndex); - return new String(dataNode.getKey().toBytes()); + return dataNode.getKey().toUTF8String(); } diff --git a/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/impl/handles/DataAccountKVSetOperationHandle.java b/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/impl/handles/DataAccountKVSetOperationHandle.java index 2745a377..75607b51 100644 --- a/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/impl/handles/DataAccountKVSetOperationHandle.java +++ b/source/ledger/ledger-core/src/main/java/com/jd/blockchain/ledger/core/impl/handles/DataAccountKVSetOperationHandle.java @@ -7,6 +7,7 @@ import com.jd.blockchain.ledger.BytesValue; import com.jd.blockchain.ledger.DataAccountDoesNotExistException; import com.jd.blockchain.ledger.DataAccountKVSetOperation; import com.jd.blockchain.ledger.DataAccountKVSetOperation.KVWriteEntry; +import com.jd.blockchain.ledger.DataVersionConflictException; import com.jd.blockchain.ledger.Operation; import com.jd.blockchain.ledger.core.DataAccount; import com.jd.blockchain.ledger.core.LedgerDataSet; @@ -31,8 +32,12 @@ public class DataAccountKVSetOperationHandle implements OperationHandle { throw new DataAccountDoesNotExistException("DataAccount doesn't exist!"); } KVWriteEntry[] writeSet = kvWriteOp.getWriteSet(); + long v = -1; for (KVWriteEntry kvw : writeSet) { - account.setBytes(Bytes.fromString(kvw.getKey()), kvw.getValue(), kvw.getExpectedVersion()); + v = account.setBytes(Bytes.fromString(kvw.getKey()), kvw.getValue(), kvw.getExpectedVersion()); + if (v < 0) { + throw new DataVersionConflictException(); + } } return null; } diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingTest.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingTest.java index 15bf2671..73287b04 100644 --- a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingTest.java +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/ContractInvokingTest.java @@ -1,5 +1,6 @@ package test.com.jd.blockchain.ledger; +import static com.jd.blockchain.transaction.ContractReturnValue.decode; import static org.junit.Assert.assertArrayEquals; import static org.junit.Assert.assertEquals; import static org.junit.Assert.assertNotNull; @@ -25,6 +26,7 @@ import com.jd.blockchain.ledger.BytesData; import com.jd.blockchain.ledger.BytesValue; import com.jd.blockchain.ledger.DataAccountRegisterOperation; import com.jd.blockchain.ledger.EndpointRequest; +import com.jd.blockchain.ledger.KVDataEntry; import com.jd.blockchain.ledger.LedgerBlock; import com.jd.blockchain.ledger.LedgerInitSetting; import com.jd.blockchain.ledger.LedgerTransaction; @@ -40,16 +42,17 @@ import com.jd.blockchain.ledger.UserRegisterOperation; import com.jd.blockchain.ledger.core.LedgerDataSet; import com.jd.blockchain.ledger.core.LedgerEditor; import com.jd.blockchain.ledger.core.LedgerRepository; +import com.jd.blockchain.ledger.core.LedgerService; import com.jd.blockchain.ledger.core.LedgerTransactionContext; import com.jd.blockchain.ledger.core.UserAccount; import com.jd.blockchain.ledger.core.impl.DefaultOperationHandleRegisteration; import com.jd.blockchain.ledger.core.impl.LedgerManager; import com.jd.blockchain.ledger.core.impl.LedgerTransactionalEditor; +import com.jd.blockchain.ledger.core.impl.OperationHandleRegisteration; import com.jd.blockchain.ledger.core.impl.TransactionBatchProcessor; import com.jd.blockchain.service.TransactionBatchResultHandle; import com.jd.blockchain.storage.service.utils.MemoryKVStorage; import com.jd.blockchain.transaction.BooleanValueHolder; -import static com.jd.blockchain.transaction.ContractReturnValue.*; import com.jd.blockchain.transaction.TxBuilder; import com.jd.blockchain.utils.Bytes; @@ -152,7 +155,7 @@ public class ContractInvokingTest { } - @Test +// @Test public void testReadNewWritting() { // 初始化账本到指定的存储库； HashDigest ledgerHash = initLedger(storage, parti0, parti1, parti2, parti3); @@ -219,7 +222,6 @@ public class ContractInvokingTest { BytesValue latestValue = ledgerRepo.getDataAccountSet().getDataAccount(kpDataAccount.getAddress()).getBytes(key, -1); System.out.printf("latest value=[%s] %s \r\n", latestValue.getType(), latestValue.getValue().toUTF8String()); - boolean readable = readableHolder.get(); assertTrue(readable); @@ -230,6 +232,164 @@ public class ContractInvokingTest { assertEquals(resp1.getBlockHash(), latestBlock.getHash()); } + /** + * 验证在合约方法中写入数据账户时，如果版本校验失败是否会引发异常而导致回滚；
+ * 期待正确的表现是引发异常而回滚当前交易； + */ + @Test + public void testRollbackWhileVersionConfliction() { + // 初始化账本到指定的存储库； + HashDigest ledgerHash = initLedger(storage, parti0, parti1, parti2, parti3); + + // 重新加载账本； + LedgerManager ledgerManager = new LedgerManager(); + LedgerRepository ledgerRepo = ledgerManager.register(ledgerHash, storage); + + // 创建合约处理器； + ContractInvokingHandle contractInvokingHandle = new ContractInvokingHandle(); + + // 创建和加载合约实例； + BlockchainKeypair contractKey = BlockchainKeyGenerator.getInstance().generate(); + Bytes contractAddress = contractKey.getAddress(); + TxTestContractImpl contractInstance = new TxTestContractImpl(); + contractInvokingHandle.setup(contractAddress, TxTestContract.class, contractInstance); + + // 注册合约处理器； + DefaultOperationHandleRegisteration opReg = new DefaultOperationHandleRegisteration(); + opReg.insertAsTopPriority(contractInvokingHandle); + + // 发布指定地址合约 + deploy(ledgerRepo, ledgerManager, opReg, ledgerHash, contractKey); + + // 注册数据账户； + BlockchainKeypair kpDataAccount = BlockchainKeyGenerator.getInstance().generate(); + contractInstance.setDataAddress(kpDataAccount.getAddress()); + registerDataAccount(ledgerRepo, ledgerManager, opReg, ledgerHash, kpDataAccount); + + // 调用合约 + // 构建基于接口调用合约的交易请求，用于测试合约调用； + buildBlock(ledgerRepo, ledgerManager, opReg, new TxDefinitor() { + @Override + public void buildTx(TxBuilder txBuilder) { + TxTestContract contractProxy = txBuilder.contract(contractAddress, TxTestContract.class); + contractProxy.testRollbackWhileVersionConfliction(kpDataAccount.getAddress().toBase58(), "K1", "V1-0", + -1); + contractProxy.testRollbackWhileVersionConfliction(kpDataAccount.getAddress().toBase58(), "K2", "V2-0", + -1); + } + }); + // 预期数据都能够正常写入； + KVDataEntry kv1 = ledgerRepo.getDataAccountSet().getDataAccount(kpDataAccount.getAddress()).getDataEntry("K1", + 0); + KVDataEntry kv2 = ledgerRepo.getDataAccountSet().getDataAccount(kpDataAccount.getAddress()).getDataEntry("K2", + 0); + assertEquals(0, kv1.getVersion()); + assertEquals(0, kv2.getVersion()); + assertEquals("V1-0", kv1.getValue()); + assertEquals("V2-0", kv2.getValue()); + + // 构建基于接口调用合约的交易请求，用于测试合约调用； + buildBlock(ledgerRepo, ledgerManager, opReg, new TxDefinitor() { + @Override + public void buildTx(TxBuilder txBuilder) { + TxTestContract contractProxy = txBuilder.contract(contractAddress, TxTestContract.class); + contractProxy.testRollbackWhileVersionConfliction(kpDataAccount.getAddress().toBase58(), "K1", "V1-1", + 0); + contractProxy.testRollbackWhileVersionConfliction(kpDataAccount.getAddress().toBase58(), "K2", "V2-1", + 0); + } + }); + // 预期数据都能够正常写入； + kv1 = ledgerRepo.getDataAccountSet().getDataAccount(kpDataAccount.getAddress()).getDataEntry("K1", 1); + kv2 = ledgerRepo.getDataAccountSet().getDataAccount(kpDataAccount.getAddress()).getDataEntry("K2", 1); + assertEquals(1, kv1.getVersion()); + assertEquals(1, kv2.getVersion()); + assertEquals("V1-1", kv1.getValue()); + assertEquals("V2-1", kv2.getValue()); + + // 构建基于接口调用合约的交易请求，用于测试合约调用； + buildBlock(ledgerRepo, ledgerManager, opReg, new TxDefinitor() { + @Override + public void buildTx(TxBuilder txBuilder) { + TxTestContract contractProxy = txBuilder.contract(contractAddress, TxTestContract.class); + contractProxy.testRollbackWhileVersionConfliction(kpDataAccount.getAddress().toBase58(), "K1", "V1-2", + 1); + contractProxy.testRollbackWhileVersionConfliction(kpDataAccount.getAddress().toBase58(), "K2", "V2-2", + 0); + } + }); + // 预期数据都能够正常写入； + kv1 = ledgerRepo.getDataAccountSet().getDataAccount(kpDataAccount.getAddress()).getDataEntry("K1", 1); + assertEquals(1, kv1.getVersion()); + assertEquals("V1-1", kv1.getValue()); + kv1 = ledgerRepo.getDataAccountSet().getDataAccount(kpDataAccount.getAddress()).getDataEntry("K1", 2); + assertEquals(-1, kv1.getVersion()); + assertEquals(null, kv1.getValue()); + + } + + private LedgerBlock buildBlock(LedgerRepository ledgerRepo, LedgerService ledgerService, + OperationHandleRegisteration opReg, TxDefinitor txDefinitor) { + LedgerBlock preBlock = ledgerRepo.getLatestBlock(); + LedgerDataSet previousBlockDataset = ledgerRepo.getDataSet(preBlock); + LedgerEditor newBlockEditor = ledgerRepo.createNextBlock(); + TransactionBatchProcessor txbatchProcessor = new TransactionBatchProcessor(newBlockEditor, previousBlockDataset, + opReg, ledgerService); + + TxBuilder txBuilder = new TxBuilder(ledgerRepo.getHash()); + txDefinitor.buildTx(txBuilder); + + TransactionRequest txReq = buildAndSignRequest(txBuilder, parti0, parti0); + TransactionResponse resp = txbatchProcessor.schedule(txReq); + + // 提交区块； + TransactionBatchResultHandle txResultHandle = txbatchProcessor.prepare(); + txResultHandle.commit(); + + LedgerBlock latestBlock = ledgerRepo.getLatestBlock(); + assertNotNull(resp.getBlockHash()); + assertEquals(preBlock.getHeight() + 1, resp.getBlockHeight()); + return latestBlock; + } + + private TransactionRequest buildAndSignRequest(TxBuilder txBuilder, BlockchainKeypair endpointKey, + BlockchainKeypair nodeKey) { + TransactionRequestBuilder txReqBuilder = txBuilder.prepareRequest(); + txReqBuilder.signAsEndpoint(endpointKey); + txReqBuilder.signAsNode(nodeKey); + TransactionRequest txReq = txReqBuilder.buildRequest(); + return txReq; + } + + private void registerDataAccount(LedgerRepository ledgerRepo, LedgerManager ledgerManager, + DefaultOperationHandleRegisteration opReg, HashDigest ledgerHash, BlockchainKeypair kpDataAccount) { + LedgerBlock preBlock = ledgerRepo.getLatestBlock(); + LedgerDataSet previousBlockDataset = ledgerRepo.getDataSet(preBlock); + + // 加载合约 + LedgerEditor newBlockEditor = ledgerRepo.createNextBlock(); + TransactionBatchProcessor txbatchProcessor = new TransactionBatchProcessor(newBlockEditor, previousBlockDataset, + opReg, ledgerManager); + + // 注册数据账户； + TxBuilder txBuilder = new TxBuilder(ledgerHash); + + txBuilder.dataAccounts().register(kpDataAccount.getIdentity()); + TransactionRequestBuilder txReqBuilder1 = txBuilder.prepareRequest(); + txReqBuilder1.signAsEndpoint(parti0); + txReqBuilder1.signAsNode(parti0); + TransactionRequest txReq = txReqBuilder1.buildRequest(); + + TransactionResponse resp = txbatchProcessor.schedule(txReq); + + TransactionBatchResultHandle txResultHandle = txbatchProcessor.prepare(); + txResultHandle.commit(); + + assertNotNull(resp.getBlockHash()); + assertEquals(TransactionState.SUCCESS, resp.getExecutionState()); + assertEquals(preBlock.getHeight() + 1, resp.getBlockHeight()); + } + private void deploy(LedgerRepository ledgerRepo, LedgerManager ledgerManager, DefaultOperationHandleRegisteration opReg, HashDigest ledgerHash, BlockchainKeypair contractKey) { // 创建新区块的交易处理器； @@ -300,4 +460,10 @@ public class ContractInvokingTest { new Random().nextBytes(chainCode); return chainCode; } + + public static interface TxDefinitor { + + void buildTx(TxBuilder txBuilder); + + } } diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/KeyValueEntry.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/KeyValueEntry.java new file mode 100644 index 00000000..c4b40d59 --- /dev/null +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/KeyValueEntry.java @@ -0,0 +1,19 @@ +package test.com.jd.blockchain.ledger; + +import com.jd.blockchain.binaryproto.DataContract; +import com.jd.blockchain.binaryproto.DataField; +import com.jd.blockchain.binaryproto.PrimitiveType; + +@DataContract(code = 0x4010) +public interface KeyValueEntry { + + @DataField(order = 1, primitiveType = PrimitiveType.TEXT) + String getKey(); + + @DataField(order = 2, primitiveType = PrimitiveType.TEXT) + String getValue(); + + @DataField(order = 3, primitiveType = PrimitiveType.INT64) + long getVersion(); + +} diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/KeyValueObject.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/KeyValueObject.java new file mode 100644 index 00000000..24215ea7 --- /dev/null +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/KeyValueObject.java @@ -0,0 +1,47 @@ +package test.com.jd.blockchain.ledger; + +public class KeyValueObject implements KeyValueEntry { + + private String key; + + private String value; + + private long version; + + public KeyValueObject() { + } + + public KeyValueObject(String key, String value, long version) { + this.key = key; + this.value = value; + this.version = version; + } + + @Override + public String getKey() { + return key; + } + + @Override + public String getValue() { + return value; + } + + @Override + public long getVersion() { + return version; + } + + public void setKey(String key) { + this.key = key; + } + + public void setValue(String value) { + this.value = value; + } + + public void setVersion(long version) { + this.version = version; + } + +} diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/MerkleDataSetTest.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/MerkleDataSetTest.java index ce571d71..7bbe7682 100644 --- a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/MerkleDataSetTest.java +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/MerkleDataSetTest.java @@ -32,6 +32,38 @@ public class MerkleDataSetTest { private static final String[] SUPPORTED_PROVIDERS = { ClassicCryptoService.class.getName(), SMCryptoService.class.getName() }; + + /** + * 测试存储的增长； + */ + @Test + public void testKeyIndex() { + + CryptoProvider[] supportedProviders = new CryptoProvider[SUPPORTED_PROVIDERS.length]; + for (int i = 0; i < SUPPORTED_PROVIDERS.length; i++) { + supportedProviders[i] = Crypto.getProvider(SUPPORTED_PROVIDERS[i]); + } + + String keyPrefix = ""; + CryptoConfig cryptoConfig = new CryptoConfig(); + cryptoConfig.setSupportedProviders(supportedProviders); + cryptoConfig.setHashAlgorithm(ClassicAlgorithm.SHA256); + cryptoConfig.setAutoVerifyHash(true); + + MemoryKVStorage storage = new MemoryKVStorage(); + + MerkleDataSet mds = new MerkleDataSet(cryptoConfig, keyPrefix, storage, storage); + mds.setValue("A", "A".getBytes(), -1); + mds.setValue("B", "B".getBytes(), -1); + mds.setValue("C", "C".getBytes(), -1); + + mds.commit(); + + //校验 Key 的正确性； + assertEquals("A", mds.getKeyAtIndex(0)); + assertEquals("B", mds.getKeyAtIndex(1)); + assertEquals("C", mds.getKeyAtIndex(2)); + } /** * 测试存储的增长； @@ -59,6 +91,7 @@ public class MerkleDataSetTest { mds.commit(); HashDigest root1 = mds.getRootHash(); + // 1个KV项的存储KEY的数量= 1 + 1(保存SN) + Merkle节点数量; // 所以：3 项; diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TransactionBatchProcessorTest.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TransactionBatchProcessorTest.java index 39665bde..f51f211d 100644 --- a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TransactionBatchProcessorTest.java +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TransactionBatchProcessorTest.java @@ -14,6 +14,7 @@ import com.jd.blockchain.ledger.BlockchainKeyGenerator; import com.jd.blockchain.ledger.BlockchainKeypair; import com.jd.blockchain.ledger.BytesValue; import com.jd.blockchain.ledger.DataAccountRegisterOperation; +import com.jd.blockchain.ledger.DataVersionConflictException; import com.jd.blockchain.ledger.EndpointRequest; import com.jd.blockchain.ledger.LedgerBlock; import com.jd.blockchain.ledger.LedgerInitSetting; @@ -245,7 +246,7 @@ public class TransactionBatchProcessorTest { } @Test - public void testTxRollbackByVersionsConfliction() { + public void testTxRollbackByVersionsConflict() { final MemoryKVStorage STORAGE = new MemoryKVStorage(); // 初始化账本到指定的存储库； @@ -337,7 +338,14 @@ public class TransactionBatchProcessorTest { txbatchProcessor = new TransactionBatchProcessor(newBlockEditor, previousBlockDataset, opReg, ledgerManager); txbatchProcessor.schedule(txreq5); - txbatchProcessor.schedule(txreq6); + // 预期会产生版本冲突异常； DataVersionConflictionException; + DataVersionConflictException versionConflictionException = null; + try { + txbatchProcessor.schedule(txreq6); + } catch (DataVersionConflictException e) { + versionConflictionException = e; + } + assertNotNull(versionConflictionException); newBlock = newBlockEditor.prepare(); newBlockEditor.commit(); diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContract.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContract.java index 80df9803..80ee477f 100644 --- a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContract.java +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContract.java @@ -5,14 +5,11 @@ import com.jd.blockchain.contract.ContractEvent; @Contract public interface TxTestContract { - + @ContractEvent(name = "testReadable") boolean testReadable(); -// @ContractEvent(name = "prepareData") -// String[] prepareData(String address); -// -// @ContractEvent(name = "doVersionConflictedWritting") -// void doVersionConflictedWritting(String key, String value, long version); + @ContractEvent(name = "testRollbackWhileVersionConfliction") + void testRollbackWhileVersionConfliction(String address, String key, String value, long version); } diff --git a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContractImpl.java b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContractImpl.java index bd9137d4..60ee6864 100644 --- a/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContractImpl.java +++ b/source/ledger/ledger-core/src/test/java/test/com/jd/blockchain/ledger/TxTestContractImpl.java @@ -33,18 +33,12 @@ public class TxTestContractImpl implements TxTestContract, ContractLifecycleAwar String text2 = (String) v2.getValue(); return text1.equals(text2); } + + @Override + public void testRollbackWhileVersionConfliction(String address, String key, String value, long version) { + eventContext.getLedger().dataAccount(address).setText(key, value, version); + } -// @Override -// public String[] prepareData(String address) { -// // TODO Auto-generated method stub -// return null; -// } -// -// @Override -// public void doVersionConflictedWritting(String key, String value, long version) { -// // TODO Auto-generated method stub -// -// } @Override public void postConstruct() { @@ -76,4 +70,5 @@ public class TxTestContractImpl implements TxTestContract, ContractLifecycleAwar this.dataAddress = dataAddress; } + } diff --git a/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/BytesValueEncoding.java b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/BytesValueEncoding.java index 66a9eee2..baee5868 100644 --- a/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/BytesValueEncoding.java +++ b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/BytesValueEncoding.java @@ -183,10 +183,23 @@ public class BytesValueEncoding { // 接口序列化必须实现DataContract注解 if (!currParamType.isAnnotationPresent(DataContract.class)) { throw new IllegalStateException( - String.format("Interface[%s] can not be serialize !!!", currParamType.getName())); + String.format("Interface[%s] can not be annotated as a DataContract!!!", currParamType.getName())); } return true; } + + if (currParamType.isArray() ) { + Class componentType = currParamType.getComponentType(); + if (componentType.isInterface()) { + // 接口序列化必须实现DataContract注解 + if (!componentType.isAnnotationPresent(DataContract.class)) { + throw new IllegalStateException( + String.format("Interface[%s] can not be annotated as a DataContract!!!", currParamType.getName())); + } + return true; + } + } + return CLASS_RESOLVER_MAP.containsKey(currParamType); } diff --git a/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/DataVersionConflictException.java b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/DataVersionConflictException.java new file mode 100644 index 00000000..8af67d01 --- /dev/null +++ b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/DataVersionConflictException.java @@ -0,0 +1,27 @@ +package com.jd.blockchain.ledger; + +public class DataVersionConflictException extends BlockRollbackException { + + private static final long serialVersionUID = 3583192000738807503L; + + private TransactionState state; + + public DataVersionConflictException() { + this(TransactionState.DATA_VERSION_CONFLICT, null); + } + + public DataVersionConflictException(String message) { + this(TransactionState.DATA_VERSION_CONFLICT, message); + } + + private DataVersionConflictException(TransactionState state, String message) { + super(message); + assert TransactionState.SUCCESS != state; + this.state = state; + } + + public TransactionState getState() { + return state; + } + +} diff --git a/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/TransactionState.java b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/TransactionState.java index 6955eb94..55390655 100644 --- a/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/TransactionState.java +++ b/source/ledger/ledger-model/src/main/java/com/jd/blockchain/ledger/TransactionState.java @@ -38,6 +38,11 @@ public enum TransactionState { * 合约不存在； */ CONTRACT_DOES_NOT_EXIST((byte) 0x04), + + /** + * 数据写入时版本冲突； + */ + DATA_VERSION_CONFLICT((byte) 0x05), /** * 由于在错误的账本上执行交易而被丢弃； diff --git a/source/runtime/runtime-context/src/main/java/com/jd/blockchain/runtime/RuntimeContext.java b/source/runtime/runtime-context/src/main/java/com/jd/blockchain/runtime/RuntimeContext.java index 569a95a5..04bc55cd 100644 --- a/source/runtime/runtime-context/src/main/java/com/jd/blockchain/runtime/RuntimeContext.java +++ b/source/runtime/runtime-context/src/main/java/com/jd/blockchain/runtime/RuntimeContext.java @@ -81,7 +81,7 @@ public abstract class RuntimeContext { if (jarFile.isFile()) { FileUtils.deleteFile(jarFile); } else { - throw new IllegalStateException("Code storage confliction! --" + jarFile.getAbsolutePath()); + throw new IllegalStateException("Code storage conflict! --" + jarFile.getAbsolutePath()); } } FileUtils.writeBytes(jarBytes, jarFile); From 3378c0321b2fcffa5b91eb9739001784751742c5 Mon Sep 17 00:00:00 2001 From: huanghaiquan Date: Thu, 5 Sep 2019 01:51:15 +0800 Subject: [PATCH 21/23] Upgrade version to 1.0.2.RELEASE; --- source/base/pom.xml | 2 +- source/binary-proto/pom.xml | 2 +- source/consensus/consensus-bftsmart/pom.xml | 2 +- source/consensus/consensus-framework/pom.xml | 2 +- source/consensus/consensus-mq/pom.xml | 2 +- source/consensus/pom.xml | 2 +- source/contract/contract-framework/pom.xml | 2 +- source/contract/contract-jvm/pom.xml | 2 +- source/contract/contract-maven-plugin/pom.xml | 2 +- source/contract/contract-samples/pom.xml | 2 +- source/contract/pom.xml | 2 +- source/crypto/crypto-adv/pom.xml | 2 +- source/crypto/crypto-classic/pom.xml | 2 +- source/crypto/crypto-framework/pom.xml | 2 +- source/crypto/crypto-pki/pom.xml | 2 +- source/crypto/crypto-sm/pom.xml | 2 +- source/crypto/pom.xml | 2 +- source/deployment/deployment-gateway/pom.xml | 2 +- source/deployment/deployment-peer/pom.xml | 2 +- source/deployment/pom.xml | 2 +- source/gateway/pom.xml | 2 +- source/ledger/ledger-core/pom.xml | 2 +- source/ledger/ledger-model/pom.xml | 2 +- source/ledger/ledger-rpc/pom.xml | 2 +- source/ledger/pom.xml | 2 +- source/peer/pom.xml | 2 +- source/pom.xml | 2 +- source/runtime/pom.xml | 2 +- source/runtime/runtime-context/pom.xml | 2 +- source/runtime/runtime-modular-booter/pom.xml | 2 +- source/runtime/runtime-modular/pom.xml | 2 +- source/sdk/pom.xml | 2 +- source/sdk/sdk-base/pom.xml | 2 +- source/sdk/sdk-client/pom.xml | 2 +- source/sdk/sdk-samples/pom.xml | 2 +- source/storage/pom.xml | 2 +- source/storage/storage-composite/pom.xml | 2 +- source/storage/storage-redis/pom.xml | 2 +- source/storage/storage-rocksdb/pom.xml | 2 +- source/storage/storage-service/pom.xml | 2 +- source/test/pom.xml | 2 +- source/test/test-consensus-client/pom.xml | 2 +- source/test/test-consensus-node/pom.xml | 4 ++-- source/test/test-integration/pom.xml | 2 +- source/test/test-ledger-core/pom.xml | 2 +- source/tools/pom.xml | 2 +- source/tools/tools-capability/pom.xml | 2 +- source/tools/tools-initializer-booter/pom.xml | 2 +- source/tools/tools-initializer/pom.xml | 2 +- source/tools/tools-keygen-booter/pom.xml | 2 +- source/tools/tools-keygen/pom.xml | 2 +- source/tools/tools-mocker/pom.xml | 2 +- source/utils/pom.xml | 2 +- source/utils/utils-common/pom.xml | 2 +- source/utils/utils-http/pom.xml | 2 +- source/utils/utils-serialize/pom.xml | 2 +- source/utils/utils-test/pom.xml | 2 +- source/utils/utils-web-server/pom.xml | 2 +- source/utils/utils-web/pom.xml | 2 +- 59 files changed, 60 insertions(+), 60 deletions(-) diff --git a/source/base/pom.xml b/source/base/pom.xml index 739e3013..8a683041 100644 --- a/source/base/pom.xml +++ b/source/base/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE base diff --git a/source/binary-proto/pom.xml b/source/binary-proto/pom.xml index eababa0e..d44b88f2 100644 --- a/source/binary-proto/pom.xml +++ b/source/binary-proto/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE binary-proto diff --git a/source/consensus/consensus-bftsmart/pom.xml b/source/consensus/consensus-bftsmart/pom.xml index d2b7b9fe..5dd4e1ca 100644 --- a/source/consensus/consensus-bftsmart/pom.xml +++ b/source/consensus/consensus-bftsmart/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain consensus - 1.0.1.RELEASE + 1.0.2.RELEASE consensus-bftsmart diff --git a/source/consensus/consensus-framework/pom.xml b/source/consensus/consensus-framework/pom.xml index 288a6c72..d2b1b8a5 100644 --- a/source/consensus/consensus-framework/pom.xml +++ b/source/consensus/consensus-framework/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain consensus - 1.0.1.RELEASE + 1.0.2.RELEASE consensus-framework diff --git a/source/consensus/consensus-mq/pom.xml b/source/consensus/consensus-mq/pom.xml index 1b1bcc8c..f3b67eef 100644 --- a/source/consensus/consensus-mq/pom.xml +++ b/source/consensus/consensus-mq/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain consensus - 1.0.1.RELEASE + 1.0.2.RELEASE consensus-mq diff --git a/source/consensus/pom.xml b/source/consensus/pom.xml index de3bf418..a6a819d8 100644 --- a/source/consensus/pom.xml +++ b/source/consensus/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE consensus pom diff --git a/source/contract/contract-framework/pom.xml b/source/contract/contract-framework/pom.xml index fc6522d3..59138327 100644 --- a/source/contract/contract-framework/pom.xml +++ b/source/contract/contract-framework/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain contract - 1.0.1.RELEASE + 1.0.2.RELEASE contract-framework diff --git a/source/contract/contract-jvm/pom.xml b/source/contract/contract-jvm/pom.xml index c90fb8f7..d7c088f3 100644 --- a/source/contract/contract-jvm/pom.xml +++ b/source/contract/contract-jvm/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain contract - 1.0.1.RELEASE + 1.0.2.RELEASE contract-jvm diff --git a/source/contract/contract-maven-plugin/pom.xml b/source/contract/contract-maven-plugin/pom.xml index f8c15327..3e31cd35 100644 --- a/source/contract/contract-maven-plugin/pom.xml +++ b/source/contract/contract-maven-plugin/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain contract - 1.0.1.RELEASE + 1.0.2.RELEASE contract-maven-plugin maven-plugin diff --git a/source/contract/contract-samples/pom.xml b/source/contract/contract-samples/pom.xml index 1421e60c..8bb1a913 100644 --- a/source/contract/contract-samples/pom.xml +++ b/source/contract/contract-samples/pom.xml @@ -5,7 +5,7 @@ contract com.jd.blockchain - 1.0.1.RELEASE + 1.0.2.RELEASE 4.0.0 diff --git a/source/contract/pom.xml b/source/contract/pom.xml index f8213546..135f759d 100644 --- a/source/contract/pom.xml +++ b/source/contract/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE contract pom diff --git a/source/crypto/crypto-adv/pom.xml b/source/crypto/crypto-adv/pom.xml index b375250c..86277d4f 100644 --- a/source/crypto/crypto-adv/pom.xml +++ b/source/crypto/crypto-adv/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain crypto - 1.0.1.RELEASE + 1.0.2.RELEASE crypto-adv diff --git a/source/crypto/crypto-classic/pom.xml b/source/crypto/crypto-classic/pom.xml index 6b48f130..4bd0ad62 100644 --- a/source/crypto/crypto-classic/pom.xml +++ b/source/crypto/crypto-classic/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain crypto - 1.0.1.RELEASE + 1.0.2.RELEASE crypto-classic diff --git a/source/crypto/crypto-framework/pom.xml b/source/crypto/crypto-framework/pom.xml index e1fed396..99d153e3 100644 --- a/source/crypto/crypto-framework/pom.xml +++ b/source/crypto/crypto-framework/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain crypto - 1.0.1.RELEASE + 1.0.2.RELEASE crypto-framework diff --git a/source/crypto/crypto-pki/pom.xml b/source/crypto/crypto-pki/pom.xml index ed9719cd..d86f9e8f 100644 --- a/source/crypto/crypto-pki/pom.xml +++ b/source/crypto/crypto-pki/pom.xml @@ -5,7 +5,7 @@ crypto com.jd.blockchain - 1.0.1.RELEASE + 1.0.2.RELEASE 4.0.0 diff --git a/source/crypto/crypto-sm/pom.xml b/source/crypto/crypto-sm/pom.xml index 6243bb9d..8c5623ba 100644 --- a/source/crypto/crypto-sm/pom.xml +++ b/source/crypto/crypto-sm/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain crypto - 1.0.1.RELEASE + 1.0.2.RELEASE crypto-sm diff --git a/source/crypto/pom.xml b/source/crypto/pom.xml index 7cb0bcb3..b8b3135f 100644 --- a/source/crypto/pom.xml +++ b/source/crypto/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE crypto pom diff --git a/source/deployment/deployment-gateway/pom.xml b/source/deployment/deployment-gateway/pom.xml index 90a14bae..7fdd6ea4 100644 --- a/source/deployment/deployment-gateway/pom.xml +++ b/source/deployment/deployment-gateway/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain deployment - 1.0.1.RELEASE + 1.0.2.RELEASE deployment-gateway diff --git a/source/deployment/deployment-peer/pom.xml b/source/deployment/deployment-peer/pom.xml index 09590768..6239b042 100644 --- a/source/deployment/deployment-peer/pom.xml +++ b/source/deployment/deployment-peer/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain deployment - 1.0.1.RELEASE + 1.0.2.RELEASE deployment-peer diff --git a/source/deployment/pom.xml b/source/deployment/pom.xml index 6894c623..3568713d 100644 --- a/source/deployment/pom.xml +++ b/source/deployment/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE deployment pom diff --git a/source/gateway/pom.xml b/source/gateway/pom.xml index 7edc2c85..cdcf26e0 100644 --- a/source/gateway/pom.xml +++ b/source/gateway/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE gateway diff --git a/source/ledger/ledger-core/pom.xml b/source/ledger/ledger-core/pom.xml index 4f23477e..b3d64c0d 100644 --- a/source/ledger/ledger-core/pom.xml +++ b/source/ledger/ledger-core/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain ledger - 1.0.1.RELEASE + 1.0.2.RELEASE ledger-core diff --git a/source/ledger/ledger-model/pom.xml b/source/ledger/ledger-model/pom.xml index 28dd7cae..88e1d7ee 100644 --- a/source/ledger/ledger-model/pom.xml +++ b/source/ledger/ledger-model/pom.xml @@ -6,7 +6,7 @@ com.jd.blockchain ledger - 1.0.1.RELEASE + 1.0.2.RELEASE ledger-model diff --git a/source/ledger/ledger-rpc/pom.xml b/source/ledger/ledger-rpc/pom.xml index b6793681..db16126c 100644 --- a/source/ledger/ledger-rpc/pom.xml +++ b/source/ledger/ledger-rpc/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain ledger - 1.0.1.RELEASE + 1.0.2.RELEASE ledger-rpc diff --git a/source/ledger/pom.xml b/source/ledger/pom.xml index 0876a46c..002c1383 100644 --- a/source/ledger/pom.xml +++ b/source/ledger/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE ledger pom diff --git a/source/peer/pom.xml b/source/peer/pom.xml index 9998f6db..4cb8110e 100644 --- a/source/peer/pom.xml +++ b/source/peer/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE peer diff --git a/source/pom.xml b/source/pom.xml index 1633c32e..bfd75f7e 100644 --- a/source/pom.xml +++ b/source/pom.xml @@ -16,7 +16,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE pom jdchain diff --git a/source/runtime/pom.xml b/source/runtime/pom.xml index b3f33611..df4e3eb0 100644 --- a/source/runtime/pom.xml +++ b/source/runtime/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE runtime pom diff --git a/source/runtime/runtime-context/pom.xml b/source/runtime/runtime-context/pom.xml index e2819040..4dec8d19 100644 --- a/source/runtime/runtime-context/pom.xml +++ b/source/runtime/runtime-context/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain runtime - 1.0.1.RELEASE + 1.0.2.RELEASE runtime-context diff --git a/source/runtime/runtime-modular-booter/pom.xml b/source/runtime/runtime-modular-booter/pom.xml index 95ad8b44..2c68f286 100644 --- a/source/runtime/runtime-modular-booter/pom.xml +++ b/source/runtime/runtime-modular-booter/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain runtime - 1.0.1.RELEASE + 1.0.2.RELEASE runtime-modular-booter \ No newline at end of file diff --git a/source/runtime/runtime-modular/pom.xml b/source/runtime/runtime-modular/pom.xml index 4bf67684..0b2d4ab0 100644 --- a/source/runtime/runtime-modular/pom.xml +++ b/source/runtime/runtime-modular/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain runtime - 1.0.1.RELEASE + 1.0.2.RELEASE runtime-modular diff --git a/source/sdk/pom.xml b/source/sdk/pom.xml index e5da5929..af743c62 100644 --- a/source/sdk/pom.xml +++ b/source/sdk/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE sdk pom diff --git a/source/sdk/sdk-base/pom.xml b/source/sdk/sdk-base/pom.xml index cd23f963..a0436d70 100644 --- a/source/sdk/sdk-base/pom.xml +++ b/source/sdk/sdk-base/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain sdk - 1.0.1.RELEASE + 1.0.2.RELEASE sdk-base diff --git a/source/sdk/sdk-client/pom.xml b/source/sdk/sdk-client/pom.xml index 857d8c67..99ef7fb9 100644 --- a/source/sdk/sdk-client/pom.xml +++ b/source/sdk/sdk-client/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain sdk - 1.0.1.RELEASE + 1.0.2.RELEASE sdk-client diff --git a/source/sdk/sdk-samples/pom.xml b/source/sdk/sdk-samples/pom.xml index 1a7e0777..81bfceac 100644 --- a/source/sdk/sdk-samples/pom.xml +++ b/source/sdk/sdk-samples/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain sdk - 1.0.1.RELEASE + 1.0.2.RELEASE sdk-samples diff --git a/source/storage/pom.xml b/source/storage/pom.xml index 9aa84865..b99ec87f 100644 --- a/source/storage/pom.xml +++ b/source/storage/pom.xml @@ -3,7 +3,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE storage pom diff --git a/source/storage/storage-composite/pom.xml b/source/storage/storage-composite/pom.xml index 338d4535..80235eab 100644 --- a/source/storage/storage-composite/pom.xml +++ b/source/storage/storage-composite/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain storage - 1.0.1.RELEASE + 1.0.2.RELEASE storage-composite diff --git a/source/storage/storage-redis/pom.xml b/source/storage/storage-redis/pom.xml index 7be3b3c9..ee82955c 100644 --- a/source/storage/storage-redis/pom.xml +++ b/source/storage/storage-redis/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain storage - 1.0.1.RELEASE + 1.0.2.RELEASE storage-redis diff --git a/source/storage/storage-rocksdb/pom.xml b/source/storage/storage-rocksdb/pom.xml index a6156f3b..ae15aa88 100644 --- a/source/storage/storage-rocksdb/pom.xml +++ b/source/storage/storage-rocksdb/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain storage - 1.0.1.RELEASE + 1.0.2.RELEASE storage-rocksdb diff --git a/source/storage/storage-service/pom.xml b/source/storage/storage-service/pom.xml index bfd5edd9..51ada89e 100644 --- a/source/storage/storage-service/pom.xml +++ b/source/storage/storage-service/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain storage - 1.0.1.RELEASE + 1.0.2.RELEASE storage-service diff --git a/source/test/pom.xml b/source/test/pom.xml index 2980a2ad..57d3bbe4 100644 --- a/source/test/pom.xml +++ b/source/test/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE test pom diff --git a/source/test/test-consensus-client/pom.xml b/source/test/test-consensus-client/pom.xml index ccf014c4..21d48f85 100644 --- a/source/test/test-consensus-client/pom.xml +++ b/source/test/test-consensus-client/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain test - 1.0.1.RELEASE + 1.0.2.RELEASE test-consensus-client diff --git a/source/test/test-consensus-node/pom.xml b/source/test/test-consensus-node/pom.xml index 4c587833..2357ade8 100644 --- a/source/test/test-consensus-node/pom.xml +++ b/source/test/test-consensus-node/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain test - 1.0.1.RELEASE + 1.0.2.RELEASE test-consensus-node @@ -26,7 +26,7 @@ com.jd.blockchain consensus-bftsmart - 1.0.1.RELEASE + 1.0.2.RELEASE org.springframework.boot diff --git a/source/test/test-integration/pom.xml b/source/test/test-integration/pom.xml index 9c231504..623d65b3 100644 --- a/source/test/test-integration/pom.xml +++ b/source/test/test-integration/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain test - 1.0.1.RELEASE + 1.0.2.RELEASE test-integration diff --git a/source/test/test-ledger-core/pom.xml b/source/test/test-ledger-core/pom.xml index e5ea99a3..fbb10661 100644 --- a/source/test/test-ledger-core/pom.xml +++ b/source/test/test-ledger-core/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain test - 1.0.1.RELEASE + 1.0.2.RELEASE test-ledger-core diff --git a/source/tools/pom.xml b/source/tools/pom.xml index 2a52e854..4db6a1e9 100644 --- a/source/tools/pom.xml +++ b/source/tools/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE tools pom diff --git a/source/tools/tools-capability/pom.xml b/source/tools/tools-capability/pom.xml index 294fa416..2c6cafbe 100644 --- a/source/tools/tools-capability/pom.xml +++ b/source/tools/tools-capability/pom.xml @@ -5,7 +5,7 @@ tools com.jd.blockchain - 1.0.1.RELEASE + 1.0.2.RELEASE 4.0.0 diff --git a/source/tools/tools-initializer-booter/pom.xml b/source/tools/tools-initializer-booter/pom.xml index 958388a7..a5ac62a5 100644 --- a/source/tools/tools-initializer-booter/pom.xml +++ b/source/tools/tools-initializer-booter/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain tools - 1.0.1.RELEASE + 1.0.2.RELEASE tools-initializer-booter diff --git a/source/tools/tools-initializer/pom.xml b/source/tools/tools-initializer/pom.xml index ddee1b3d..877e4a43 100644 --- a/source/tools/tools-initializer/pom.xml +++ b/source/tools/tools-initializer/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain tools - 1.0.1.RELEASE + 1.0.2.RELEASE tools-initializer diff --git a/source/tools/tools-keygen-booter/pom.xml b/source/tools/tools-keygen-booter/pom.xml index 0000d7d7..c5308384 100644 --- a/source/tools/tools-keygen-booter/pom.xml +++ b/source/tools/tools-keygen-booter/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain tools - 1.0.1.RELEASE + 1.0.2.RELEASE tools-keygen-booter diff --git a/source/tools/tools-keygen/pom.xml b/source/tools/tools-keygen/pom.xml index 79e20dd0..66b1183d 100644 --- a/source/tools/tools-keygen/pom.xml +++ b/source/tools/tools-keygen/pom.xml @@ -5,7 +5,7 @@ com.jd.blockchain tools - 1.0.1.RELEASE + 1.0.2.RELEASE tools-keygen diff --git a/source/tools/tools-mocker/pom.xml b/source/tools/tools-mocker/pom.xml index badb7dae..c185efe2 100644 --- a/source/tools/tools-mocker/pom.xml +++ b/source/tools/tools-mocker/pom.xml @@ -5,7 +5,7 @@ tools com.jd.blockchain - 1.0.1.RELEASE + 1.0.2.RELEASE 4.0.0 diff --git a/source/utils/pom.xml b/source/utils/pom.xml index 0804470c..416ed922 100644 --- a/source/utils/pom.xml +++ b/source/utils/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain jdchain-root - 1.0.1.RELEASE + 1.0.2.RELEASE utils pom diff --git a/source/utils/utils-common/pom.xml b/source/utils/utils-common/pom.xml index c01ef466..0a391efe 100644 --- a/source/utils/utils-common/pom.xml +++ b/source/utils/utils-common/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain utils - 1.0.1.RELEASE + 1.0.2.RELEASE utils-common diff --git a/source/utils/utils-http/pom.xml b/source/utils/utils-http/pom.xml index cf3a6ed7..23a18762 100644 --- a/source/utils/utils-http/pom.xml +++ b/source/utils/utils-http/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain utils - 1.0.1.RELEASE + 1.0.2.RELEASE diff --git a/source/utils/utils-serialize/pom.xml b/source/utils/utils-serialize/pom.xml index 67501bfa..eab12a7f 100644 --- a/source/utils/utils-serialize/pom.xml +++ b/source/utils/utils-serialize/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain utils - 1.0.1.RELEASE + 1.0.2.RELEASE utils-serialize diff --git a/source/utils/utils-test/pom.xml b/source/utils/utils-test/pom.xml index f01f6404..24920b00 100644 --- a/source/utils/utils-test/pom.xml +++ b/source/utils/utils-test/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain utils - 1.0.1.RELEASE + 1.0.2.RELEASE utils-test diff --git a/source/utils/utils-web-server/pom.xml b/source/utils/utils-web-server/pom.xml index 70e3dc55..f7fe8e7d 100644 --- a/source/utils/utils-web-server/pom.xml +++ b/source/utils/utils-web-server/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain utils - 1.0.1.RELEASE + 1.0.2.RELEASE utils-web-server diff --git a/source/utils/utils-web/pom.xml b/source/utils/utils-web/pom.xml index 2979485f..84cb71b1 100644 --- a/source/utils/utils-web/pom.xml +++ b/source/utils/utils-web/pom.xml @@ -4,7 +4,7 @@ com.jd.blockchain utils - 1.0.1.RELEASE + 1.0.2.RELEASE utils-web From 9cdb13c6284eb4ce670424b7c8ead5fb3949b32c Mon Sep 17 00:00:00 2001 From: huanghaiquan Date: Thu, 5 Sep 2019 09:27:12 +0800 Subject: [PATCH 22/23] Fixed errors of ledger binding test cases; --- .../tools-initializer/src/test/resources/ledger-binding.conf | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/tools/tools-initializer/src/test/resources/ledger-binding.conf b/source/tools/tools-initializer/src/test/resources/ledger-binding.conf index e4cf6c2b..99df03d0 100644 --- a/source/tools/tools-initializer/src/test/resources/ledger-binding.conf +++ b/source/tools/tools-initializer/src/test/resources/ledger-binding.conf @@ -6,7 +6,9 @@ j5kLUENMvcUooZjKfz2bEYU6zoK9DAqbdDDU8aZEZFR4qf #第1个账本[j5ptBmn67B2p3yki3ji1j2ZMjnJhrUvP4kFpGmcXgvrhmk]的配置； #账本的当前共识参与方的ID； +binding.j5ptBmn67B2p3yki3ji1j2ZMjnJhrUvP4kFpGmcXgvrhmk.name = Test-Ledger-01 binding.j5ptBmn67B2p3yki3ji1j2ZMjnJhrUvP4kFpGmcXgvrhmk.parti.address=1 +binding.j5ptBmn67B2p3yki3ji1j2ZMjnJhrUvP4kFpGmcXgvrhmk.parti.name=parti-1 #账本的当前共识参与方的私钥文件的保存路径； binding.j5ptBmn67B2p3yki3ji1j2ZMjnJhrUvP4kFpGmcXgvrhmk.parti.pk-path=keys/jd-com.priv #账本的当前共识参与方的私钥内容（Base58编码）；如果指定了，优先选用此属性，其次是 pk-path 属性； @@ -21,7 +23,9 @@ binding.j5ptBmn67B2p3yki3ji1j2ZMjnJhrUvP4kFpGmcXgvrhmk.db.pwd=kksfweffj #第2个账本[j5kLUENMvcUooZjKfz2bEYU6zoK9DAqbdDDU8aZEZFR4qf]的配置； #账本的当前共识参与方的ID； +binding.j5kLUENMvcUooZjKfz2bEYU6zoK9DAqbdDDU8aZEZFR4qf.name=Test-Ledger-02 binding.j5kLUENMvcUooZjKfz2bEYU6zoK9DAqbdDDU8aZEZFR4qf.parti.address=2 +binding.j5kLUENMvcUooZjKfz2bEYU6zoK9DAqbdDDU8aZEZFR4qf.parti.name=parti-2 #账本的当前共识参与方的私钥文件的保存路径； binding.j5kLUENMvcUooZjKfz2bEYU6zoK9DAqbdDDU8aZEZFR4qf.parti.pk-path=keys/jd-com-1.priv #账本的当前共识参与方的私钥内容（Base58编码）；如果指定了，优先选用此属性，其次是 pk-path 属性； From 03284140d3c93dd0599109f8cf9d410b5ded78cb Mon Sep 17 00:00:00 2001 From: huanghaiquan Date: Thu, 5 Sep 2019 09:31:54 +0800 Subject: [PATCH 23/23] Fixed errors of ledger initialization test cases; --- .../test-integration/src/test/resources/ledger_init_test.init | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/test/test-integration/src/test/resources/ledger_init_test.init b/source/test/test-integration/src/test/resources/ledger_init_test.init index a1dde11f..7b303e35 100644 --- a/source/test/test-integration/src/test/resources/ledger_init_test.init +++ b/source/test/test-integration/src/test/resources/ledger_init_test.init @@ -3,7 +3,7 @@ ledger.seed=932dfe23-fe23232f-283f32fa-dd32aa76-8322ca2f-56236cda-7136b322-cb323ffe #账本的描述名称；此属性不参与共识，仅仅在当前参与方的本地节点用于描述用途； -ledger.name= +ledger.name=test-ledger #声明的账本创建时间；格式为 “yyyy-MM-dd HH:mm:ss.SSSZ”，表示”年-月-日 时:分:秒:毫秒时区“；例如：“2019-08-01 14:26:58.069+0800”，其中，+0800 表示时区是东8区 created-time=2019-08-01 14:26:58.069+0800