corda / net.corda.core.node / NodeInfo

NodeInfo

data class NodeInfo

Information about a network node that acts on behalf of some party. NodeInfos can be found via the network map cache, accessible from a net.corda.core.node.services.NetworkMapCache. They are also available via RPC using the net.corda.core.messaging.CordaRPCOps.networkMapSnapshot method.

Constructors

<init>

Information about a network node that acts on behalf of some party. NodeInfos can be found via the network map cache, accessible from a net.corda.core.node.services.NetworkMapCache. They are also available via RPC using the net.corda.core.messaging.CordaRPCOps.networkMapSnapshot method.

NodeInfo(addresses: List<NetworkHostAndPort>, legalIdentitiesAndCerts: List<PartyAndCertificate>, platformVersion: Int, serial: Long)

Properties

addresses

An ordered list of IP addresses/hostnames where the node can be contacted.

val addresses: List<NetworkHostAndPort>

legalIdentities

An ordered list of legal identities supported by this node. The node will always have at least one, so if you are porting code from earlier versions of Corda that expected a single party per node, just use the first item in the returned list.

val legalIdentities: List<Party>

legalIdentitiesAndCerts

A non-empty list, where the first identity is assumed to be the default identity of the node.

val legalIdentitiesAndCerts: List<PartyAndCertificate>

platformVersion

An integer representing the set of protocol features the node supports. See the docsite for information on how the platform is versioned.

val platformVersion: Int

serial

An arbitrary number incremented each time the NodeInfo is changed. This is analogous to the same concept in DNS.

val serial: Long

Functions

identityAndCertFromX500Name

Get a legal identity and certificate of this node from the X.500 name. This is intended for use in cases where the node is expected to have a matching identity, and will throw an exception if no match is found.

fun identityAndCertFromX500Name(name: CordaX500Name): PartyAndCertificate

identityFromX500Name

Get a legal identity of this node from the X.500 name. This is intended for use in cases where the node is expected to have a matching identity, and will throw an exception if no match is found.

fun identityFromX500Name(name: CordaX500Name): Party

isLegalIdentity

Returns true if party is one of the identities of this node, else false.

fun isLegalIdentity(party: Party): Boolean

Returns true if name matches one of the identities of this node, else false.

fun isLegalIdentity(name: CordaX500Name): Boolean