corda / net.corda.core.node.services

Package net.corda.core.node.services

Types

AttachmentStorage

interface AttachmentStorage

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

ContractUpgradeService

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.

IdentityService

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.

KeyManagementService

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.

NetworkMapCache

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.

NetworkMapCacheBase

interface NetworkMapCacheBase

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

NetworkParametersService

interface NetworkParametersService

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

PartyInfo

sealed class PartyInfo

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

ServiceLifecycleEvent

enum class ServiceLifecycleEvent

ServiceLifecycleObserver

interface ServiceLifecycleObserver

Specifies that given CordaService is interested to know about important milestones of Corda Node lifecycle and potentially react to them. Subscription can be performed using net.corda.core.node.AppServiceHub.register method from a constructor of CordaService.

TimeWindowChecker

class TimeWindowChecker

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

TransactionStorage

interface TransactionStorage

Thread-safe storage of transactions.

Vault

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.

VaultService

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!

Annotations

CordaService

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.

Exceptions

CordaServiceCriticalFailureException

class CordaServiceCriticalFailureException : Exception

Please see ServiceLifecycleEvent.STATE_MACHINE_STARTED for the purpose of this exception.

StatesNotAvailableException

class StatesNotAvailableException : FlowException

UnknownAnonymousPartyException

class UnknownAnonymousPartyException : CordaException

VaultQueryException

class VaultQueryException : FlowException

Type Aliases

AttachmentFixup

typealias AttachmentFixup = <ERROR CLASS><Set<AttachmentId>, Set<AttachmentId>>

AttachmentId

typealias AttachmentId = SecureHash

Properties

MAX_CONSTRAINT_DATA_SIZE

const val MAX_CONSTRAINT_DATA_SIZE: Int

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

Functions

queryBy

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>

trackBy

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>>