corda / net.corda.core.transactions / NotaryChangeLedgerTransaction

NotaryChangeLedgerTransaction

class NotaryChangeLedgerTransaction : FullTransaction, TransactionWithSignatures

A notary change transaction with fully resolved inputs and signatures. In contrast with a regular transaction, signatures are checked against the signers specified by input states' participants fields, so full resolution is needed for signature verification.

Constructors

<init>

NotaryChangeLedgerTransaction(inputs: List<StateAndRef<ContractState>>, notary: Party, newNotary: Party, id: SecureHash, sigs: List<TransactionSignature>)

Properties

id	`val id: SecureHash`
inputs	`val inputs: List<StateAndRef<ContractState>>` The inputs of this transaction. Note that in BaseTransaction subclasses the type of this list may change!
networkParameters	`val networkParameters: NetworkParameters?` Network parameters that were in force when this transaction was created. Resolved from the hash of network parameters on the corresponding wire transaction.
newNotary	`val newNotary: Party`
notary	`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	`val outputs: List<TransactionState<ContractState>>` We compute the outputs on demand by applying the notary field modification to the inputs.
references	`val references: List<StateAndRef<ContractState>>` A list of reusable reference data states which can be referred to by other contracts in this transaction.
requiredSigningKeys	`val requiredSigningKeys: Set<PublicKey>` Specifies all the public keys that require signatures for the transaction to be valid.
sigs	`val sigs: List<TransactionSignature>` List of signatures on this transaction.

Functions

component1	`operator fun component1(): List<StateAndRef<ContractState>>`
component2	`operator fun component2(): Party`
component3	`operator fun component3(): Party`
component4	`operator fun component4(): SecureHash`
component5	`operator fun component5(): List<TransactionSignature>`
component6	`operator fun component6(): NetworkParameters?`
copy	`fun copy(inputs: List<StateAndRef<ContractState>> = this.inputs, notary: Party = this.notary, newNotary: Party = this.newNotary, id: SecureHash = this.id, sigs: List<TransactionSignature> = this.sigs): NotaryChangeLedgerTransaction`
equals	`fun equals(other: Any?): Boolean`
getKeyDescriptions	`fun getKeyDescriptions(keys: Set<PublicKey>): List<String>` Get a human readable description of where signatures are required from, and are missing, to assist in debugging the underlying cause.
hashCode	`fun hashCode(): Int`
toString	`fun toString(): String`

Inherited Functions

checkBaseInvariants	`open fun checkBaseInvariants(): Unit`
checkNotaryWhitelisted	`fun checkNotaryWhitelisted(): Unit` Make sure the assigned notary is part of the network parameter whitelist.
checkSignaturesAreValid	`open fun checkSignaturesAreValid(): Unit` Mathematically validates the signatures that are present on this transaction. This does not imply that the signatures are by the right keys, or that there are sufficient signatures, just that they aren't corrupt. If you use this function directly you'll need to do the other checks yourself. Probably you want verifyRequiredSignatures instead.
getMissingSigners	`open fun getMissingSigners(): Set<PublicKey>` Return the PublicKeys for which we still need signatures.
verifyRequiredSignatures	`open fun verifyRequiredSignatures(): <ERROR CLASS>` Verifies the signatures on this transaction and throws if any are missing. In this context, "verifying" means checking they are valid signatures and that their public keys are in the requiredSigningKeys set.
verifySignaturesExcept	`open fun verifySignaturesExcept(vararg allowedToBeMissing: PublicKey): Unit` `open fun verifySignaturesExcept(allowedToBeMissing: Collection<PublicKey>): Unit` Verifies the signatures on this transaction and throws if any are missing which aren't passed as parameters. In this context, "verifying" means checking they are valid signatures and that their public keys are in the requiredSigningKeys set.

Extension Functions

contextLogger

fun Any.contextLogger(): <ERROR CLASS>

When called from a companion object, returns the logger for the enclosing class.