Additional method on VaultService to add notes to a transaction

node/src/main/kotlin/com/r3corda/node/services/vault/NodeVaultService.kt

@@ -4,6 +4,7 @@ import com.google.common.collect.Sets
 import com.r3corda.core.ThreadBox
 import com.r3corda.core.bufferUntilSubscribed
 import com.r3corda.core.contracts.*
+import com.r3corda.core.crypto.SecureHash
 import com.r3corda.core.node.ServiceHub
 import com.r3corda.core.node.services.Vault
 import com.r3corda.core.node.services.VaultService
@@ -11,10 +12,7 @@ import com.r3corda.core.serialization.SingletonSerializeAsToken
 import com.r3corda.core.transactions.WireTransaction
 import com.r3corda.core.utilities.loggerFor
 import com.r3corda.core.utilities.trace
-import com.r3corda.node.utilities.AbstractJDBCHashSet
-import com.r3corda.node.utilities.JDBCHashedTable
-import com.r3corda.node.utilities.NODE_DATABASE_PREFIX
-import com.r3corda.node.utilities.stateRef
+import com.r3corda.node.utilities.*
 import org.jetbrains.exposed.sql.ResultRow
 import org.jetbrains.exposed.sql.statements.InsertStatement
 import rx.Observable
@@ -42,6 +40,11 @@ class NodeVaultService(private val services: ServiceHub) : SingletonSerializeAsT
         val stateRef = stateRef("transaction_id", "output_index")
     }
 
+    private object TransactionNotesTable : JDBCHashedTable("${NODE_DATABASE_PREFIX}vault_txn_notes") {
+        val txnId = secureHash("txnId")
+        val notes = blob("notes")
+    }
+
     private val mutex = ThreadBox(object {
         val unconsumedStates = object : AbstractJDBCHashSet<StateRef, StatesSetTable>(StatesSetTable) {
             override fun elementFromRow(row: ResultRow): StateRef = StateRef(row[table.stateRef.txId], row[table.stateRef.index])
@@ -52,6 +55,28 @@ class NodeVaultService(private val services: ServiceHub) : SingletonSerializeAsT
             }
         }
 
+        val transactionNotes = object : AbstractJDBCHashMap<SecureHash, Set<String>, TransactionNotesTable>(TransactionNotesTable, loadOnInit = false) {
+            override fun keyFromRow(row: ResultRow): SecureHash {
+                return row[table.txnId]
+            }
+
+            override fun valueFromRow(row: ResultRow): Set<String> {
+                return deserializeFromBlob(row[table.notes])
+            }
+
+            override fun addKeyToInsert(insert: InsertStatement, entry: Map.Entry<SecureHash, Set<String>>, finalizables: MutableList<() -> Unit>) {
+                insert[table.txnId] = entry.key
+            }
+
+            override fun addValueToInsert(insert: InsertStatement, entry: Map.Entry<SecureHash, Set<String>>, finalizables: MutableList<() -> Unit>) {
+                insert[table.notes] = serializeToBlob(entry.value, finalizables)
+            }
+        }
+
+        fun allTransactionNotes(): Map<SecureHash,Set<String>> {
+            return transactionNotes
+        }
+
         val _updatesPublisher = PublishSubject.create<Vault.Update>()
 
         fun allUnconsumedStates(): Iterable<StateAndRef<ContractState>> {
@@ -75,14 +100,14 @@ class NodeVaultService(private val services: ServiceHub) : SingletonSerializeAsT
         }
     })
 
-    override val currentVault: Vault get() = mutex.locked { Vault(allUnconsumedStates()) }
+    override val currentVault: Vault get() = mutex.locked { Vault(allUnconsumedStates(), allTransactionNotes()) }
 
     override val updates: Observable<Vault.Update>
         get() = mutex.locked { _updatesPublisher }
 
     override fun track(): Pair<Vault, Observable<Vault.Update>> {
         return mutex.locked {
-            Pair(Vault(allUnconsumedStates()), _updatesPublisher.bufferUntilSubscribed())
+            Pair(Vault(allUnconsumedStates(), allTransactionNotes()), _updatesPublisher.bufferUntilSubscribed())
         }
     }
 
@@ -106,6 +131,15 @@ class NodeVaultService(private val services: ServiceHub) : SingletonSerializeAsT
         return currentVault
     }
 
+
+    override fun addNoteToTransaction(txnId: SecureHash, noteText: String) {
+        mutex.locked {
+            transactionNotes.getOrPut(key = txnId, defaultValue = {
+                setOf(noteText)
+            }).plus(noteText)
+        }
+    }
+
     private fun makeUpdate(tx: WireTransaction, netDelta: Vault.Update, ourKeys: Set<PublicKey>): Vault.Update {
         val ourNewStates = tx.outputs.
                 filter { isRelevant(it.data, ourKeys) }.

node/src/test/kotlin/com/r3corda/node/services/NodeVaultServiceTest.kt

@@ -1,15 +1,21 @@
 package com.r3corda.node.services
 
+import com.r3corda.contracts.asset.Cash
 import com.r3corda.contracts.testing.fillWithSomeTestCash
 import com.r3corda.core.contracts.DOLLARS
+import com.r3corda.core.contracts.TransactionType
+import com.r3corda.core.contracts.`issued by`
 import com.r3corda.core.node.services.TxWritableStorageService
 import com.r3corda.core.node.services.VaultService
 import com.r3corda.core.transactions.SignedTransaction
 import com.r3corda.core.utilities.DUMMY_NOTARY
 import com.r3corda.core.utilities.LogHelper
+import com.r3corda.node.services.schema.NodeSchemaService
 import com.r3corda.node.services.vault.NodeVaultService
 import com.r3corda.node.utilities.configureDatabase
 import com.r3corda.node.utilities.databaseTransaction
+import com.r3corda.testing.MEGA_CORP
+import com.r3corda.testing.MEGA_CORP_KEY
 import com.r3corda.testing.node.MockServices
 import com.r3corda.testing.node.makeTestDataSourceProperties
 import org.assertj.core.api.Assertions.assertThat
@@ -19,6 +25,7 @@ import org.junit.Before
 import org.junit.Test
 import java.io.Closeable
 import java.util.*
+import kotlin.test.assertEquals
 
 class NodeVaultServiceTest {
     lateinit var dataSource: Closeable
@@ -75,4 +82,36 @@ class NodeVaultServiceTest {
             assertThat(w2.states).hasSize(3)
         }
     }
+
+    @Test
+    fun addNoteToTransaction() {
+
+        databaseTransaction(database) {
+            val services = object : MockServices() {
+                override val vaultService: VaultService = NodeVaultService(this)
+
+                override fun recordTransactions(txs: Iterable<SignedTransaction>) {
+                    for (stx in txs) {
+                        storageService.validatedTransactions.addTransaction(stx)
+                    }
+                    // Refactored to use notifyAll() as we have no other unit test for that method with multiple transactions.
+                    vaultService.notifyAll(txs.map { it.tx })
+                }
+            }
+
+            val freshKey = services.legalIdentityKey
+
+            // Issue a txn to Send us some Money
+            val usefulTX = TransactionType.General.Builder(null).apply {
+                Cash().generateIssue(this, 100.DOLLARS `issued by` MEGA_CORP.ref(1), freshKey.public, DUMMY_NOTARY)
+                signWith(MEGA_CORP_KEY)
+            }.toSignedTransaction()
+
+            services.recordTransactions(listOf(usefulTX))
+
+            services.vaultService.addNoteToTransaction(usefulTX.id, "Sample Note 1")
+            assertEquals(1, services.vaultService.currentVault.transactionNotes.toList().size)
+
+        }
+    }
 }