corda / net.corda.node.services.vault / NodeVaultService

NodeVaultService

class NodeVaultService : SingletonSerializeAsToken, VaultService

Currently, the node vault service is a very simple RDBMS backed implementation. It will change significantly when we add further functionality as the design for the vault and vault service matures.

This class needs database transactions to be in-flight during method calls and init, and will throw exceptions if this is not the case.

TODO: move query / filter criteria into the database query. TODO: keep an audit trail with time stamps of previously unconsumed states "as of" a particular point in time. TODO: have transaction storage do some caching.

Constructors

<init> NodeVaultService(services: ServiceHub, dataSourceProperties: Properties)

Currently, the node vault service is a very simple RDBMS backed implementation. It will change significantly when we add further functionality as the design for the vault and vault service matures.

Properties

cashBalances val cashBalances: Map<Currency, Amount<Currency>>

Returns a map of how much cash we have in each currency, ignoring details like issuer. Note: currencies for which we have no cash evaluate to null (not present in map), not 0.

configuration val configuration: RequeryConfiguration
rawUpdates val rawUpdates: Observable<Update>

Prefer the use of updates unless you know why you want to use this instead.

session val session: KotlinEntityDataStore<Persistable>
updates val updates: Observable<Update>

Get a synchronous Observable of updates. When observations are pushed to the Observer, the Vault will already incorporate the update, and the database transaction associated with the update will have been committed and closed.

Functions

addNoteToTransaction fun addNoteToTransaction(txnId: SecureHash, noteText: String): Unit

Add a note to an existing LedgerTransaction given by its unique SecureHash id Multiple notes may be attached to the same LedgerTransaction. These are additively and immutably persisted within the node local vault database in a single textual field using a semi-colon separator

authoriseContractUpgrade fun authoriseContractUpgrade(stateAndRef: StateAndRef<*>, upgradedContractClass: Class<out UpgradedContract<*, *>>): Unit

Authorise a contract state upgrade. This will store the upgrade authorisation in the vault, and will be queried by ContractUpgradeFlow.Acceptor during contract upgrade process. Invoking this method indicate the node is willing to upgrade the state using the upgradedContractClass. This method will NOT initiate the upgrade process. To start the upgrade process, see ContractUpgradeFlow.Instigator.

deauthoriseContractUpgrade fun deauthoriseContractUpgrade(stateAndRef: StateAndRef<*>): Unit

Authorise a contract state upgrade. This will remove the upgrade authorisation from the vault.

generateSpend fun generateSpend(tx: TransactionBuilder, amount: Amount<Currency>, to: CompositeKey, onlyFromParties: Set<AbstractParty>?): Pair<TransactionBuilder, List<CompositeKey>>

Generate a transaction that moves an amount of currency to the given pubkey.

getAuthorisedContractUpgrade fun getAuthorisedContractUpgrade(ref: StateRef): Class<out UpgradedContract<*, *>>?

Get contracts we would be willing to upgrade the suggested contract to.

getTransactionNotes fun getTransactionNotes(txnId: SecureHash): Iterable<String>
notifyAll fun notifyAll(txns: Iterable<WireTransaction>): Unit

Possibly update the vault by marking as spent states that these transactions consume, and adding any relevant new states that they create. You should only insert transactions that have been successfully verified here!

states fun <T : ContractState> states(clazzes: Set<Class<T>>, statuses: EnumSet<StateStatus>): List<StateAndRef<T>>

Return ContractStates of a given Contract type and list of Vault.StateStatus

statesForRefs fun statesForRefs(refs: List<StateRef>): Map<StateRef, TransactionState<*>?>

Return unconsumed ContractStates for a given set of StateRefs TODO: revisit and generalize this exposed API function.

track fun track(): Pair<Vault<ContractState>, Observable<Update>>

Atomically get the current vault and a stream of updates. Note that the Observable buffers updates until the first subscriber is registered so as to avoid racing with early updates.

Inherited Functions

notify open fun notify(tx: WireTransaction): Unit

Same as notifyAll but with a single transaction.

toToken open fun toToken(context: SerializeAsTokenContext): SerializationToken
whenConsumed open fun whenConsumed(ref: StateRef): ListenableFuture<Update>

Provide a Future for when a StateRef is consumed, which can be very useful in building tests.

Companion Object Properties

log val log: Logger

Extension Functions

consumedStates fun <T : ContractState> VaultService.consumedStates(): List<StateAndRef<T>>
dealsWith fun <T : DealState> VaultService.dealsWith(party: AbstractParty): List<StateAndRef<T>>
linearHeadsOfType fun <T : LinearState> VaultService.linearHeadsOfType(): Map<UniqueIdentifier, StateAndRef<T>>

Returns the linearState heads only when the type of the state would be considered an 'instanceof' the given type.

unconsumedStates fun <T : ContractState> VaultService.unconsumedStates(): List<StateAndRef<T>>