corda/docs/source/api-service-hub.rst
Ross Nicoll f0c7d7665a Remove deprecated signing functions
* Remove TransactionBuilder.signWith()
* Remove TransactionBuilder.addSignatureUnchecked()
* Rename signInitialTransaction to toSignedTransaction
* Remove checkAndAddSignature()
* Require all unit tests sign transactions via services
2017-08-11 17:37:50 +01:00

1.6 KiB
Raw Blame History

API: ServiceHub

Within FlowLogic.call, the flow developer has access to the node's ServiceHub, which provides access to the various services the node provides. The services offered by the ServiceHub are split into the following categories:

  • ServiceHub.networkMapCache
    • Provides information on other nodes on the network (e.g. notaries…)
  • ServiceHub.identityService
    • Allows you to resolve anonymous identities to well-known identities if you have the required certificates
  • ServiceHub.attachments
    • Gives you access to the node's attachments
  • ServiceHub.validatedTransactions
    • Gives you access to the transactions stored in the node
  • ServiceHub.vaultService
    • Stores the nodes current and historic states
  • ServiceHub.keyManagementService
    • Manages signing transactions and generating fresh public keys
  • ServiceHub.myInfo
    • Other information about the node
  • ServiceHub.clock
    • Provides access to the nodes internal time and date

Additional, ServiceHub exposes the following properties:

  • ServiceHub.loadState and ServiceHub.toStateAndRef to resolve a StateRef into a TransactionState or a StateAndRef
  • ServiceHub.toSignedTransaction to sign a TransactionBuilder and convert it into a SignedTransaction
  • ServiceHub.createSignature and ServiceHub.addSignature to create and add signatures to a SignedTransaction

Finally, ServiceHub exposes the node's legal identity key (via ServiceHub.legalIdentityKey) and its notary identity key (via ServiceHub.notaryIdentityKey).