docs/net.corda.core.flows/AbstractStateReplacementFlow

AbstractStateReplacementFlow

abstract class AbstractStateReplacementFlow

Abstract flow to be used for replacing one state with another, for example when changing the notary of a state. Notably this requires a one to one replacement of states, states cannot be split, merged or issued as part of these flows.

Constructors

constructor()

Types

Acceptor

abstract class Acceptor<in T>(val initiatingSession: FlowSession, val progressTracker: ProgressTracker = Acceptor.tracker()) : FlowLogic<Void?>

Instigator

abstract class Instigator<out S : ContractState, out T : ContractState, out M>(val originalState: StateAndRef<S>, val modification: M, val progressTracker: ProgressTracker = Instigator.tracker()) : FlowLogic<StateAndRef<T>>

The Instigator assembles the transaction for state replacement and sends out change proposals to all participants (Acceptor) of that state. If participants agree to the proposed change, they each sign the transaction. Finally, Instigator sends the transaction containing all participants' signatures to the notary for signature, and then back to each participant so they can record it and use the new updated state for future transactions.

Proposal

data class Proposal<out M>(val stateRef: StateRef, val modification: M)

The Proposal contains the details of proposed state modification. This is the message sent by the Instigator to all participants(Acceptor) during the state replacement process.

UpgradeTx

data class UpgradeTx(val stx: SignedTransaction)

The assembled transaction for upgrading a contract.