docs/net.corda.core.node.services/Vault/Update

Update

data class Update(val consumed: Set<StateAndRef>, val produced: Set<StateAndRef>, val flowId: UUID? = null, val type: Vault.UpdateType = UpdateType.GENERAL, val references: Set<StateAndRef> = emptySet(), val consumingTxIds: Map<StateRef, SecureHash> = emptyMap())

Represents an update observed by the vault that will be notified to observers. Include the StateRefs of transaction outputs that were consumed (inputs) and the ContractStates produced (outputs) to/by the transaction or transactions observed and the vault.

If the vault observes multiple transactions simultaneously, where some transactions consume the outputs of some of the other transactions observed, then the changes are observed "net" of those.

Constructors

Update

constructor(consumed: Set<StateAndRef>, produced: Set<StateAndRef>, flowId: UUID? = null, type: Vault.UpdateType = UpdateType.GENERAL, references: Set<StateAndRef> = emptySet())

constructor(consumed: Set<StateAndRef>, produced: Set<StateAndRef>, flowId: UUID? = null, type: Vault.UpdateType = UpdateType.GENERAL, references: Set<StateAndRef> = emptySet(), consumingTxIds: Map<StateRef, SecureHash> = emptyMap())

Properties

consumed

val consumed: Set<StateAndRef>

consumingTxIds

val consumingTxIds: Map<StateRef, SecureHash>

flowId

val flowId: UUID? = null

produced

val produced: Set<StateAndRef>

references

val references: Set<StateAndRef>

type

val type: Vault.UpdateType

Specifies the type of update, currently supported types are general and, contract upgrade and notary change. Notary change transactions only modify the notary field on states, and potentially need to be handled differently.

Functions

containsType

inline fun <T : ContractState> containsType(): Boolean

Checks whether the update contains a state of the specified type.

fun <T : ContractState> containsType(clazz: Class<T>, status: Vault.StateStatus): Boolean

Checks whether the update contains a state of the specified type and state status

copy

fun copy(consumed: Set<StateAndRef>, produced: Set<StateAndRef>, flowId: UUID? = null, type: Vault.UpdateType = UpdateType.GENERAL): Vault.Update

fun copy(consumed: Set<StateAndRef>, produced: Set<StateAndRef>, flowId: UUID? = null, type: Vault.UpdateType = UpdateType.GENERAL, references: Set<StateAndRef> = emptySet()): Vault.Update

Additional copy method to maintain backwards compatibility.

isEmpty

fun isEmpty(): Boolean

plus

operator fun plus(rhs: Vault.Update): Vault.Update

Combine two updates into a single update with the combined inputs and outputs of the two updates but net any outputs of the left-hand-side (this) that are consumed by the inputs of the right-hand-side (rhs).

toString

open override fun toString(): String