docs/net.corda.finance.flows/TwoPartyTradeFlow

TwoPartyTradeFlow

This asset trading flow implements a "delivery vs payment" type swap. It has two parties (B and S for buyer and seller) and the following steps:

S sends the StateAndRef pointing to what they want to sell to B, along with info about the price they require B to pay. For example this has probably been agreed on an exchange.
B sends to S a SignedTransaction that includes the state as input, B's cash as input, the state with the new owner key as output, and any change cash as output. It contains a single signature from B but isn't valid because it lacks a signature from S authorising movement of the asset.
S signs it and commits it to the ledger, notarising it and distributing the final signed transaction back to B.

Assuming no malicious termination, they both end the flow being in possession of a valid, signed transaction that represents an atomic asset swap.

Note that it's the seller who initiates contact with the buyer, not vice-versa as you might imagine.

Types

AssetMismatchException

class AssetMismatchException(val expectedTypeName: String, val typeName: String)

Buyer

open class Buyer(sellerSession: <Error class: unknown class>, notary: <Error class: unknown class>, acceptablePrice: <Error class: unknown class><Currency>, typeToBuy: Class<out <Error class: unknown class>>, anonymous: Boolean)

Seller

open class Seller(otherSideSession: <Error class: unknown class>, assetToSell: <Error class: unknown class><<Error class: unknown class>>, price: <Error class: unknown class><Currency>, myParty: <Error class: unknown class>, val progressTracker: <Error class: unknown class> = Seller.tracker())

SellerTradeInfo

data class SellerTradeInfo(val price: <Error class: unknown class><Currency>, val payToIdentity: <Error class: unknown class>)

This object is serialised to the network and is the first flow message the seller sends to the buyer.

UnacceptablePriceException

class UnacceptablePriceException(givenPrice: <Error class: unknown class><Currency>)