The gRPC API provides a protobuf defined interface for interacting with the mirror node.
The Hedera Consensus Service (HCS) provides decentralized consensus on the validity and order of messages submitted to a
topic on the network and transparency into the history of these events over time. The subscribeTopic
API allows a
client to subscribe to a topic and stream messages asynchronously as they arrive at the mirror node. See the protobuf
definition.
Example invocation using grpcurl:
grpcurl -plaintext -d '{"topicID": {"topicNum": 41110}, "limit": 0}' localhost:5600 com.hedera.mirror.api.proto.ConsensusService/subscribeTopic
HIP-21 describes a need for clients to retrieve address book information without
incurring the costs of multiple queries to get the network file's contents. The getNode
API will return the list of
nodes associated with the latest address book file. See the protobuf
definition.
Example invocation using grpcurl
:
grpcurl -plaintext -d '{"file_id": {"fileNum": 102}, "limit": 0}' localhost:5600 com.hedera.mirror.api.proto.NetworkService/getNodes