docs/net.corda.testing.internal.vault/VaultFiller

VaultFiller

class VaultFiller constructor(services: ServiceHub, defaultNotary: <Error class: unknown class>, altNotary: Party = defaultNotary.party, rngFactory: () -> Random = { Random(0L) })

The service hub should provide at least a key management service and a storage service.

Parameters

defaultNotary

used in fillWithSomeTestDeals and fillWithSomeTestLinearStates.

altNotary

used in fillWithSomeTestCash, fillWithSomeTestCommodity and consume/evolve methods. If not specified, same as defaultNotary.

rngFactory

used by fillWithSomeTestCash if no custom Random provided.

Constructors

VaultFiller

constructor(services: ServiceHub, defaultNotary: <Error class: unknown class>, altNotary: Party = defaultNotary.party, rngFactory: () -> Random = { Random(0L) })

Types

Companion

object Companion

Functions

consumeCash

fun consumeCash(amount: Amount<Currency>, to: AbstractParty): Vault.Update<ContractState>

Consume cash, sending any change to the default identity for this node. Only suitable for use in test scenarios, where nodes have a default identity.

consumeDeals

fun consumeDeals(dealStates: List<StateAndRef<DealState>>)

consumeLinearStates

fun consumeLinearStates(linearStates: List<StateAndRef<LinearState>>)

consumeStates

fun consumeStates(states: Iterable<StateAndRef<*>>)

evolveLinearState

fun evolveLinearState(linearState: StateAndRef<LinearState>): StateAndRef<LinearState>

evolveLinearStates

fun evolveLinearStates(linearStates: List<StateAndRef<LinearState>>)

fillWithDummyState

fun fillWithDummyState(participants: List<AbstractParty> = listOf(services.myInfo.singleIdentity())): Vault<<Error class: unknown class>>

Records a dummy state in the Vault (useful for creating random states when testing vault queries)

fillWithSomeTestCash

fun fillWithSomeTestCash(howMuch: Amount<Currency>, issuerServices: ServiceHub, atLeastThisManyStates: Int, issuedBy: PartyAndReference, owner: AbstractParty? = null, rng: Random? = null, statesToRecord: StatesToRecord = StatesToRecord.ONLY_RELEVANT, atMostThisManyStates: Int = atLeastThisManyStates): Vault<Cash.State>

Creates a random set of between (by default) 3 and 10 cash states that add up to the given amount and adds them to the vault. This is intended for unit tests. By default the cash is owned by the legal identity key from the storage service.

fillWithSomeTestCommodity

fun fillWithSomeTestCommodity(amount: Amount<Commodity>, issuerServices: ServiceHub, issuedBy: PartyAndReference): Vault<CommodityState>

fillWithSomeTestDeals

fun fillWithSomeTestDeals(dealIds: List<String>, issuerServices: ServiceHub = services, participants: List<AbstractParty> = emptyList(), includeMe: Boolean = true): Vault<DealState>

fillWithSomeTestLinearAndDealStates

fun fillWithSomeTestLinearAndDealStates(txCount: Int, externalId: String? = null, participants: List<AbstractParty> = emptyList(), linearString: String = "", linearNumber: Long = 0, linearBoolean: Boolean = false, linearTimestamp: Instant = now()): Vault<ContractState>

fillWithSomeTestLinearStates

fun fillWithSomeTestLinearStates(txCount: Int, externalId: String? = null, participants: List<AbstractParty> = emptyList(), uniqueIdentifier: UniqueIdentifier? = null, linearString: String = "", linearNumber: Long = 0, linearBoolean: Boolean = false, linearTimestamp: Instant = now(), constraint: AttachmentConstraint = AutomaticPlaceholderConstraint, includeMe: Boolean = true): Vault<LinearState>

fillWithTestStates

fun <T : ContractState> fillWithTestStates(txCount: Int = 1, statesPerTx: Int = 1, participants: List<AbstractParty> = emptyList(), constraint: AttachmentConstraint = AutomaticPlaceholderConstraint, includeMe: Boolean = true, services: ServiceHub = this.services, genOutputState: (participantsToUse: List<AbstractParty>, txIndex: Int, stateIndex: Int) -> T): Vault<T>