docs/net.corda.core.transactions/NotaryChangeWireTransaction

NotaryChangeWireTransaction

data class NotaryChangeWireTransaction(val serializedComponents: List<OpaqueBytes>, val digestService: DigestService) : CoreTransaction

A special transaction for changing the notary of a state. It only needs specifying the state(s) as input(s), old and new notaries. Output states can be computed by applying the notary modification to corresponding inputs on the fly.

Constructors

constructor(serializedComponents: List<OpaqueBytes>)

Old version of NotaryChangeWireTransaction constructor for ABI compatibility.

constructor(inputs: List<StateRef>, notary: Party, newNotary: Party)

constructor(serializedComponents: List<OpaqueBytes>, digestService: DigestService)

Types

Component

enum Component : Enum<NotaryChangeWireTransaction.Component>

Properties

digestService

val digestService: DigestService

open override val id: SecureHash

A privacy salt is not really required in this case, because we already used nonces in normal transactions and thus input state refs will always be unique. Also, filtering doesn't apply on this type of transactions.

inputs

open override val inputs: List<StateRef>

The inputs of this transaction, containing state references only.

networkParametersHash

open override val networkParametersHash: SecureHash?

Hash of the network parameters that were in force when the transaction was notarised. Null means, that the transaction was created on older version of Corda (before 4), resolution will default to initial parameters.

newNotary

val newNotary: Party

Identity of the notary service to reassign the states to.

notary

open override val notary: Party

If present, the notary for this transaction. If absent then the transaction is not notarised at all. This is intended for issuance/genesis transactions that don't consume any other states and thus can't double spend anything.

outputs

open override val outputs: List<TransactionState<ContractState>>

This transaction does not contain any output states, outputs can be obtained by resolving a NotaryChangeLedgerTransaction and applying the notary modification to inputs.

outputStates

val outputStates: List<ContractState>

Helper property to return a list of ContractState objects, rather than the often less convenient TransactionState

references

open override val references: List<StateRef>

The reference inputs of this transaction, containing the state references only.

serializedComponents

val serializedComponents: List<OpaqueBytes>

Contains all of the transaction components in serialized form. This is used for calculating the transaction id in a deterministic fashion, since re-serializing properties may result in a different byte sequence depending on the serialization context.

Functions

copy

fun copy(serializedComponents: List<OpaqueBytes>): NotaryChangeWireTransaction

Old version of NotaryChangeWireTransaction.copy for ABI compatibility.

filterOutputs

inline fun <T : ContractState> filterOutputs(crossinline predicate: (T) -> Boolean): List<T>

fun <T : ContractState> filterOutputs(clazz: Class<T>, predicate: Predicate<T>): List<T>

Helper to simplify filtering outputs according to a Predicate.

filterOutRefs

inline fun <T : ContractState> filterOutRefs(crossinline predicate: (T) -> Boolean): List<StateAndRef<T>>

fun <T : ContractState> filterOutRefs(clazz: Class<T>, predicate: Predicate<T>): List<StateAndRef<T>>

Helper to simplify filtering output StateAndRef items according to a Predicate.

findOutput

inline fun <T : ContractState> findOutput(crossinline predicate: (T) -> Boolean): T

fun <T : ContractState> findOutput(clazz: Class<T>, predicate: Predicate<T>): T

Helper to simplify finding a single output matching a Predicate.

findOutRef

inline fun <T : ContractState> findOutRef(crossinline predicate: (T) -> Boolean): StateAndRef<T>

fun <T : ContractState> findOutRef(clazz: Class<T>, predicate: Predicate<T>): StateAndRef<T>

Helper to simplify finding a single output StateAndRef matching a Predicate.

getOutput

fun getOutput(index: Int): ContractState

Helper to simplify getting an indexed output.

outputsOfType

inline fun <T : ContractState> outputsOfType(): List<T>

fun <T : ContractState> outputsOfType(clazz: Class<T>): List<T>

Helper to simplify getting all output states of a particular class, interface, or base class.

outRef

fun <T : ContractState> outRef(index: Int): StateAndRef<T>

Returns a StateAndRef for the given output index.

fun <T : ContractState> outRef(state: ContractState): StateAndRef<T>

Returns a StateAndRef for the requested output state, or throws IllegalArgumentException if not found.

outRefsOfType

inline fun <T : ContractState> outRefsOfType(): List<StateAndRef<T>>

fun <T : ContractState> outRefsOfType(clazz: Class<T>): List<StateAndRef<T>>

Helper to simplify getting all output StateAndRef items of a particular state class, interface, or base class.

resolve

fun resolve(services: ServiceHub, sigs: List<TransactionSignature>): NotaryChangeLedgerTransaction

Resolves input states and builds a NotaryChangeLedgerTransaction.

fun resolve(services: ServicesForResolution, sigs: List<TransactionSignature>): NotaryChangeLedgerTransaction

Resolves input states and network parameters and builds a NotaryChangeLedgerTransaction.

toSimpleString

fun NamedByHash.toSimpleString(): String