Merge pull request #13 from onix-labs/feature-v3

feature-v3

Author: MrMatthewLayton

.idea/runConfigurations/Release__Local_.xml

@@ -40,8 +40,8 @@ buildscript {
     }
 }
 
-group 'io.onixlabs'
-version '2.1.2'
+group getProperty('group')
+version getProperty('version')
 
 subprojects {
     repositories {
@@ -73,6 +73,11 @@ subprojects {
         }
     }
 
+    task sourceJar(type: Jar) {
+        from sourceSets.main.allSource
+        archiveClassifier = "sources"
+    }
+
     jar {
         exclude '**/log4j2*.xml'
     }

.idea/runConfigurations/Release__Public_.xml

@@ -50,4 +50,3 @@ In this version the property is declared using the `open` modifier, allowing der
 
 ---
 
-### 

.idea/runConfigurations/Run_Contract_Tests.xml

@@ -0,0 +1,51 @@
+![ONIX Labs](https://raw.githubusercontent.com/onix-labs/onix-labs.github.io/master/content/logo/master_full_md.png)
+
+# Change Log - Version 3.0.0
+
+This document serves as the change log for the ONIXLabs Corda Core API.
+
+## Release Notes
+
+This release publishes source code along with the compiled dependencies, enabling developers debug into the ONIXLabs APIs and understand what's going on under the hood.
+
+---
+
+### sortAndReduce _Extension Function_
+
+**Module:** onixlabs-corda-core-contract
+
+**Package:** io.onixlabs.corda.core.contract
+
+Sorts and reduces an `Iterable` of `SecureHash` into a single hash.
+
+```kotlin
+fun Iterable<SecureHash>.sortAndReduce(): SecureHash
+```
+
+---
+
+### SignatureData *Class*
+
+**Module:** onixlabs-corda-core-contract
+
+**Package:** io.onixlabs.corda.core.contract
+
+#### Description
+
+Represents an array of unsigned bytes, and its signed equivalent.
+
+```kotlin
+@CordaSerializable
+data class SignatureData(
+    val content: ByteArray, 
+    val signature: DigitalSignature
+)
+```
+
+>   🔵  **INFORMATION**
+>
+>   This API exists in version 1.2.0 however in version 3.0.0 the `verify` function no longer returns `Boolean`. Instead, the `isValid` function replaces the `verify` function, and the `verify` function now returns `Unit`, or throws a `SignatureException` if the digital signature could not be verified by the specified public key.
+
+---
+
+### 

.idea/runConfigurations/Run_Workflow_Tests.xml

@@ -1,9 +1,5 @@
 name=onixlabs-corda-core
 group=io.onixlabs
-version=2.1.2
-
-kotlin.incremental=false
-kotlin.code.style=official
-
+version=3.0.0
 onixlabs.development.jarsign.keystore=../lib/onixlabs.development.pkcs12
-onixlabs.development.jarsign.password=5891f47942424d2acbe108691fdb5ba258712fca7e4762be4327241ebf3dbfa3
+onixlabs.development.jarsign.password=5891f47942424d2acbe108691fdb5ba258712fca7e4762be4327241ebf3dbfa3

build.gradle

@@ -49,6 +49,7 @@ publishing {
             groupId = project.parent.group
             version = project.parent.version
             artifactId = 'onixlabs-corda-core-contract'
+            artifact sourceJar
             from components.java
         }
     }

docs/CHANGELOG-2.1.2.md

@@ -34,4 +34,4 @@ val Iterable<AbstractParty>.owningKeys: Set<PublicKey>
  * @return Returns a [SecureHash] representing the participants of the initial [Iterable].
  */
 val Iterable<AbstractParty>.participantHash: SecureHash
-    get() = SecureHash.sha256(map { SecureHash.sha256(it.toString()) }.toSortedSet().joinToString())
+    get() = map { SecureHash.sha256(it.toString()) }.sortAndReduce()

docs/CHANGELOG-3.0.0.md

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2020-2021 ONIXLabs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.onixlabs.corda.core.contract
+
+import net.corda.core.crypto.SecureHash
+
+/**
+ * Sorts and reduces an [Iterable] of [SecureHash] into a single hash.
+ *
+ * @return Returns a single hash representing the sorted and reduced input hashes.
+ */
+fun Iterable<SecureHash>.sortAndReduce(): SecureHash {
+    return sorted().reduce { lhs, rhs -> lhs.concatenate(rhs) }
+}

gradle.properties

@@ -22,6 +22,7 @@ import net.corda.core.crypto.sign
 import net.corda.core.node.ServiceHub
 import net.corda.core.node.services.KeyManagementService
 import net.corda.core.serialization.CordaSerializable
+import net.corda.core.utilities.toBase58String
 import net.corda.core.utilities.toBase64
 import java.security.PrivateKey
 import java.security.PublicKey
@@ -81,14 +82,26 @@ data class SignatureData(val content: ByteArray, val signature: DigitalSignature
         }
     }
 
+    /**
+     * Determines whether the signature data was signed by the specified key.
+     *
+     * @param publicKey The public key to verify against the signature.
+     * @return Returns true if the signature data was signed by the specified key; otherwise, false.
+     */
+    fun isValid(publicKey: PublicKey): Boolean {
+        return Crypto.isValid(publicKey, signature.bytes, content)
+    }
+
     /**
      * Verifies the signature data using the specified public key.
      *
      * @param publicKey The public key to verify against the signature.
      * @return Returns true if the public key was used to sign the data; otherwise, false.
      */
-    fun verify(publicKey: PublicKey): Boolean {
-        return Crypto.isValid(publicKey, signature.bytes, content)
+    fun verify(publicKey: PublicKey) {
+        if (!isValid(publicKey)) {
+            throw SignatureException("Signature was not signed by the specified key: ${publicKey.toBase58String()}")
+        }
     }
 
     /**

onixlabs-corda-core-contract/build.gradle

@@ -32,6 +32,7 @@ publishing {
             groupId = project.parent.group
             version = project.parent.version
             artifactId = 'onixlabs-corda-core-integration'
+            artifact sourceJar
             from components.java
         }
     }

onixlabs-corda-core-contract/src/main/kotlin/io/onixlabs/corda/core/contract/Extensions.AbstractParty.kt

@@ -52,6 +52,7 @@ publishing {
             groupId = project.parent.group
             version = project.parent.version
             artifactId = 'onixlabs-corda-core-workflow'
+            artifact sourceJar
             from components.java
         }
     }

onixlabs-corda-core-contract/src/main/kotlin/io/onixlabs/corda/core/contract/Extensions.SecureHash.kt

@@ -410,6 +410,16 @@ class QueryDsl<T : ContractState> internal constructor(
         criteria = criteria.and(criteriaToAdd.updateQueryCriteria())
     }
 
+    /**
+     * Applies a sub-query to the current query criteria using logical AND.
+     *
+     * @param queryCriteria The sub-query criteria which will be appended to the current query criteria.
+     */
+    @QueryDslContext
+    fun and(queryCriteria: QueryCriteria) {
+        criteria = criteria.and(queryCriteria)
+    }
+
     /**
      * Applies a sub-query to the current query criteria using logical AND.
      *
@@ -419,7 +429,17 @@ class QueryDsl<T : ContractState> internal constructor(
     fun and(action: QueryDsl<T>.() -> Unit) {
         val query = QueryDsl<T>(VaultQueryCriteria().updateQueryCriteria(), paging, sorting)
         action(query)
-        criteria = criteria.and(query.criteria)
+        and(query.criteria)
+    }
+
+    /**
+     * Applies a sub-query to the current query criteria using logical OR.
+     *
+     * @param queryCriteria The sub-query criteria which will be appended to the current query criteria.
+     */
+    @QueryDslContext
+    fun or(queryCriteria: QueryCriteria) {
+        criteria = criteria.or(queryCriteria)
     }
 
     /**
@@ -431,7 +451,7 @@ class QueryDsl<T : ContractState> internal constructor(
     fun or(action: QueryDsl<T>.() -> Unit) {
         val query = QueryDsl<T>(VaultQueryCriteria().updateQueryCriteria(), paging, sorting)
         action(query)
-        criteria = criteria.or(query.criteria)
+        or(query.criteria)
     }
 
     /**

onixlabs-corda-core-contract/src/main/kotlin/io/onixlabs/corda/core/contract/SignatureData.kt

@@ -53,7 +53,7 @@ fun FlowLogic<*>.getPreferredNotary(
     defaultSelector: (ServiceHub) -> Party = { firstNotary }
 ): Party {
     val cordappContext: CordappContext = serviceHub.getAppContext()
-    logger.info("Using the specified cordapp for notary selection: ${cordappContext.cordapp.name}")
+    logger.info("Using the specified CorDapp for notary selection: ${cordappContext.cordapp.name}")
     return if (serviceHub.getAppContext().config.exists("notary")) {
         val name = CordaX500Name.parse(serviceHub.getAppContext().config.getString("notary"))
         serviceHub.networkMapCache.getNotary(name) ?: throw IllegalArgumentException(

onixlabs-corda-core-integration/build.gradle

@@ -70,7 +70,7 @@ class RewardContract : Contract {
 
             CONTRACT_RULE_OWNER using (rewardOutput.owner == customerReference.owner)
             CONTRACT_RULE_SIGNATURE_DATA using (rewardOutput.hash().bytes.contentEquals(signature.content))
-            CONTRACT_RULE_SIGNATURE_SIGNER using (signature.verify(rewardOutput.issuer.owningKey))
+            CONTRACT_RULE_SIGNATURE_SIGNER using (signature.isValid(rewardOutput.issuer.owningKey))
             CONTRACT_RULE_SIGNERS using (rewardOutput.participants.owningKeys.all { it in signers })
         }
     }
@@ -114,7 +114,7 @@ class RewardContract : Contract {
 
             CONTRACT_RULE_OWNER using (rewardInput.owner == customerReference.owner)
             CONTRACT_RULE_SIGNATURE_DATA using (rewardInput.hash().bytes.contentEquals(signature.content))
-            CONTRACT_RULE_SIGNATURE_SIGNER using (signature.verify(rewardInput.owner.owningKey))
+            CONTRACT_RULE_SIGNATURE_SIGNER using (signature.isValid(rewardInput.owner.owningKey))
             CONTRACT_RULE_SIGNERS using (rewardInput.participants.owningKeys.all { it in signers })
         }
     }

onixlabs-corda-core-workflow/build.gradle

@@ -14,8 +14,11 @@
  * limitations under the License.
  */
 
-package io.onixlabs.corda.test.contract
+package io.onixlabs.corda.test
 
+import io.onixlabs.corda.test.contract.Customer
+import io.onixlabs.corda.test.contract.CustomerContract
+import io.onixlabs.corda.test.contract.RewardContract
 import net.corda.core.contracts.StateAndRef
 import net.corda.core.contracts.StateRef
 import net.corda.core.crypto.SecureHash

onixlabs-corda-core-workflow/src/main/kotlin/io/onixlabs/corda/core/services/QueryDsl.kt

@@ -14,8 +14,10 @@
  * limitations under the License.
  */
 
-package io.onixlabs.corda.test.contract
+package io.onixlabs.corda.test
 
+import io.onixlabs.corda.test.contract.Customer
+import io.onixlabs.corda.test.contract.Reward
 import net.corda.core.contracts.StateRef
 import net.corda.core.crypto.SecureHash
 import net.corda.core.identity.CordaX500Name

onixlabs-corda-core-workflow/src/main/kotlin/io/onixlabs/corda/core/workflow/Extensions.FlowLogic.Notaries.kt

@@ -16,6 +16,7 @@
 
 package io.onixlabs.corda.test.contract
 
+import io.onixlabs.corda.test.*
 import net.corda.testing.node.ledger
 import org.junit.jupiter.api.Test
 

onixlabs-corda-test-contract/src/main/kotlin/io/onixlabs/corda/test/contract/RewardContract.kt

@@ -16,6 +16,7 @@
 
 package io.onixlabs.corda.test.contract
 
+import io.onixlabs.corda.test.*
 import net.corda.testing.node.ledger
 import org.junit.jupiter.api.Test
 

onixlabs-corda-test-contract/src/test/kotlin/io/onixlabs/corda/test/contract/ContractTest.kt renamed to onixlabs-corda-test-contract/src/test/kotlin/io/onixlabs/corda/test/ContractTest.kt

@@ -16,6 +16,7 @@
 
 package io.onixlabs.corda.test.contract
 
+import io.onixlabs.corda.test.*
 import net.corda.testing.node.ledger
 import org.junit.jupiter.api.Test
 

onixlabs-corda-test-contract/src/test/kotlin/io/onixlabs/corda/test/contract/MockData.kt renamed to onixlabs-corda-test-contract/src/test/kotlin/io/onixlabs/corda/test/MockData.kt

@@ -17,6 +17,7 @@
 package io.onixlabs.corda.test.contract
 
 import io.onixlabs.corda.core.contract.SignatureData
+import io.onixlabs.corda.test.*
 import net.corda.core.contracts.hash
 import net.corda.testing.node.ledger
 import org.junit.jupiter.api.Test

onixlabs-corda-test-contract/src/test/kotlin/io/onixlabs/corda/test/contract/CustomerContractAmendCommandTests.kt

@@ -17,6 +17,7 @@
 package io.onixlabs.corda.test.contract
 
 import io.onixlabs.corda.core.contract.SignatureData
+import io.onixlabs.corda.test.*
 import net.corda.core.contracts.hash
 import net.corda.testing.node.ledger
 import org.junit.jupiter.api.Test