SignTransactionFlow

The SignTransactionFlow should be called in response to the CollectSignaturesFlow. It automates the signing of a transaction providing the transaction:

1. Should actually be signed by the Party invoking this flow
2. Is valid as per the contracts referenced in the transaction
3. Has been, at least, signed by the counterparty which created it
4. Conforms to custom checking provided in the checkTransaction method of the SignTransactionFlow

Usage:

• Subclass SignTransactionFlow - this can be done inside an existing flow (as shown below)
• Override the checkTransaction method to add some custom verification logic
• Call the flow via FlowLogic.subFlow
• The flow returns the transaction signed with the additional signature.

Example - checking and signing a transaction involving a net.corda.core.contracts.DummyContract, see CollectSignaturesFlowTests.kt for further examples:

    class Responder(val otherPartySession: FlowSession): FlowLogic<SignedTransaction>() {
         @Suspendable override fun call(): SignedTransaction {
             // [SignTransactionFlow] sub-classed as a singleton object.
             val flow = object : SignTransactionFlow(otherPartySession) {
                 @Suspendable override fun checkTransaction(stx: SignedTransaction) = requireThat {
                     val tx = stx.tx
                     val magicNumberState = tx.outputs.single().data as DummyContract.MultiOwnerState
                     "Must be 1337 or greater" using (magicNumberState.magicNumber >= 1337)
                 }
             }

             // Invoke the subFlow, in response to the counterparty calling [CollectSignaturesFlow].
             val expectedTxId = subFlow(flow).id

             return subFlow(ReceiveFinalityFlow(otherPartySession, expectedTxId))
         }
     }

Parameters

otherSideSession - The session which is providing you a transaction to sign.

Types

Constructors

Properties

Functions

Companion Object Functions

Extension Functions