corda /


Services which run within a Corda node and provide various pieces of functionality such as identity management, transaction storage, etc.



interface AttachmentStorage

An attachment store records potentially large binary objects, identified by their hash.


interface ContractUpgradeService

The ContractUpgradeService is responsible for securely upgrading contract state objects according to a specified and mutually agreed (amongst participants) contract version. See also ContractUpgradeFlow to understand the workflow associated with contract upgrades.


interface IdentityService

An identity service maintains a directory of parties by their associated distinguished name/public keys and thus supports lookup of a party given its key, or name. The service also manages the certificates linking confidential identities back to the well known identity.


interface KeyManagementService

The KMS is responsible for storing and using private keys to sign things. An implementation of this may, for example, call out to a hardware security module that enforces various auditing and frequency-of-use requirements.


interface NetworkMapCache : NetworkMapCacheBase

A network map contains lists of nodes on the network along with information about their identity keys, services they provide and host names or IP addresses where they can be connected to. The cache wraps around a map fetched from an authoritative service, and adds easy lookup of the data stored within it. Generally it would be initialised with a specified network map service, which it fetches data from and then subscribes to updates of.


interface NetworkMapCacheBase

Subset of NetworkMapCache that doesn't depend on an IdentityService.


interface NetworkParametersService

Service for retrieving network parameters used for resolving transactions according to parameters that were historically in force in the network.


sealed class PartyInfo

Holds information about a Party, which may refer to either a specific node or a service.


class TimeWindowChecker

Checks if the current instant provided by the input clock falls within the provided time-window.


interface TransactionStorage

Thread-safe storage of transactions.


class Vault<out T : ContractState>

A vault (name may be temporary) wraps a set of states that are useful for us to keep track of, for instance, because we own them. This class represents an immutable, stable state of a vault: it is guaranteed not to change out from underneath you, even though the canonical currently-best-known vault may change as we learn about new transactions from our peers and generate new transactions that consume states ourselves.


interface VaultService

A VaultService is responsible for securely and safely persisting the current state of a vault to storage. The vault service vends immutable snapshots of the current vault for working with: if you build a transaction based on a vault that isn't current, be aware that it may end up being invalid if the states that were used have been consumed by someone else first!



annotation class CordaService

Annotate any class that needs to be a long-lived service within the node, such as an oracle, with this annotation. Such a class needs to have a constructor with a single parameter of type AppServiceHub. This constructor will be invoked during node start to initialise the service. The service hub provided can be used to get information about the node that may be necessary for the service. Corda services are created as singletons within the node and are available to flows via ServiceHub.cordaService.



class StatesNotAvailableException : FlowException


class UnknownAnonymousPartyException : CordaException


class VaultQueryException : FlowException

Type Aliases


typealias AttachmentId = SecureHash




The maximum permissible size of contract constraint type data (for storage in vault states database table).



fun <T : ContractState> VaultService.queryBy(): Page<T>
fun <T : ContractState> VaultService.queryBy(criteria: QueryCriteria): Page<T>
fun <T : ContractState> VaultService.queryBy(paging: PageSpecification): Page<T>
fun <T : ContractState> VaultService.queryBy(criteria: QueryCriteria, paging: PageSpecification): Page<T>
fun <T : ContractState> VaultService.queryBy(criteria: QueryCriteria, sorting: Sort): Page<T>
fun <T : ContractState> VaultService.queryBy(criteria: QueryCriteria, paging: PageSpecification, sorting: Sort): Page<T>


fun <T : ContractState> VaultService.trackBy(): DataFeed<Page<T>, Update<T>>
fun <T : ContractState> VaultService.trackBy(paging: PageSpecification): DataFeed<Page<T>, Update<T>>
fun <T : ContractState> VaultService.trackBy(criteria: QueryCriteria): DataFeed<Page<T>, Update<T>>
fun <T : ContractState> VaultService.trackBy(criteria: QueryCriteria, paging: PageSpecification): DataFeed<Page<T>, Update<T>>
fun <T : ContractState> VaultService.trackBy(criteria: QueryCriteria, sorting: Sort): DataFeed<Page<T>, Update<T>>
fun <T : ContractState> VaultService.trackBy(criteria: QueryCriteria, paging: PageSpecification, sorting: Sort): DataFeed<Page<T>, Update<T>>