CORE-7288 Add digest service for flows (#691)

* Adds sandbox digest service (sandbox singleton) to be used in all sandbox types.

* Updates name of platform digest service (platform singleton).

Author: kyriathar-r3

application/src/main/kotlin/net/corda/v5/application/crypto/DigestService.kt

@@ -0,0 +1,39 @@
+package net.corda.v5.application.crypto
+
+import net.corda.v5.base.annotations.DoNotImplement
+import net.corda.v5.base.annotations.Suspendable
+import net.corda.v5.crypto.DigestAlgorithmName
+import net.corda.v5.crypto.SecureHash
+import java.io.InputStream
+
+/**
+ * Provides hashing capabilities to be used in all sandbox types.
+ */
+@DoNotImplement
+interface DigestService {
+    /**
+     * Computes the digest of the [ByteArray].
+     *
+     * @param bytes The [ByteArray] to hash.
+     * @param digestName The digest algorithm to be used for hashing.
+     */
+    @Suspendable
+    fun hash(bytes: ByteArray, digestName: DigestAlgorithmName): SecureHash
+
+    /**
+     * Computes the digest of the [InputStream].
+     *
+     * @param inputStream The [InputStream] to hash.
+     * @param digestName The digest algorithm to be used for hashing.
+     */
+    @Suspendable
+    fun hash(inputStream : InputStream, digestName: DigestAlgorithmName): SecureHash
+
+    /**
+     * Returns the [DigestAlgorithmName] digest length in bytes.
+     *
+     * @param digestName The digest algorithm to get the digest length for.
+     */
+    @Suspendable
+    fun digestLength(digestName: DigestAlgorithmName): Int
+}

cipher-suite/src/main/kotlin/net/corda/v5/cipher/suite/DigestService.kt

@@ -0,0 +1,41 @@
+package net.corda.v5.cipher.suite
+
+import net.corda.v5.crypto.DigestAlgorithmName
+import net.corda.v5.crypto.SecureHash
+import java.io.InputStream
+
+/**
+ * The platform digest calculation service. Holds a list of supported digest algorithms to be used for hashing.
+ */
+interface PlatformDigestService {
+
+    /**
+     * Computes the digest of the [ByteArray].
+     *
+     * @param bytes The [ByteArray] to hash.
+     * @param platformDigestName The digest algorithm to be used for hashing, looked up in platform supported digest algorithms.
+     *
+     * @throws [IllegalArgumentException] if the digest algorithm is not supported.
+     */
+    fun hash(bytes: ByteArray, platformDigestName: DigestAlgorithmName): SecureHash
+
+    /**
+     * Computes the digest of the [InputStream].
+     *
+     * @param inputStream The [InputStream] to hash.
+     * @param platformDigestName The digest algorithm to be used for hashing, looked up in platform supported digest algorithms.
+     *
+     * @throws [IllegalArgumentException] if the digest algorithm is not supported.
+     */
+    fun hash(inputStream : InputStream, platformDigestName: DigestAlgorithmName): SecureHash
+
+    /**
+     * Returns the [DigestAlgorithmName] digest length in bytes.
+     *
+     * @param platformDigestName The digest algorithm to get the digest length for, looked up in platform supported
+     * digest algorithms.
+     *
+     * @throws [IllegalArgumentException] if the digest algorithm is not supported.
+     */
+    fun digestLength(platformDigestName: DigestAlgorithmName): Int
+}

cipher-suite/src/main/kotlin/net/corda/v5/cipher/suite/PlatformDigestService.kt

@@ -7,7 +7,7 @@ cordaProductVersion = 5.0.0
 # NOTE: update this each time this module contains a breaking change
 ## NOTE: currently this is a top level revision, so all API versions will line up, but this could be moved to
 ##   a per module property in which case module versions can change independently.
-cordaApiRevision = 505
+cordaApiRevision = 506
 
 # Main
 kotlinVersion = 1.7.21