docs/net.corda.core.flows/ContractUpgradeFlow

ContractUpgradeFlow

A flow to be used for authorising and upgrading state objects of an old contract to a new contract.

This assembles the transaction for contract upgrade and sends out change proposals to all participants of that state. If participants agree to the proposed change, they each sign the transaction. Finally, the transaction containing all signatures is sent back to each participant so they can record it and use the new updated state for future transactions.

Types

Authorise

@StartableByRPC

class Authorise(val stateAndRef: StateAndRef<*>, upgradedContractClass: Class<out UpgradedContract<*, *>>) : FlowLogic<Void?>

Authorise a contract state upgrade.

Deauthorise

@StartableByRPC

class Deauthorise(val stateRef: StateRef) : FlowLogic<Void?>

Deauthorise a contract state upgrade. This will remove the upgrade authorisation from persistent store (and prevent any further upgrade)

Initiate

@InitiatingFlow

@StartableByRPC

class Initiate<OldState : ContractState, out NewState : ContractState>(originalState: StateAndRef<OldState>, newContractClass: Class<out UpgradedContract<OldState, NewState>>) : AbstractStateReplacementFlow.Instigator<OldState, NewState, Class<out UpgradedContract<OldState, NewState>>>

This flow begins the contract upgrade process.