Installation and usage of the platform

gRPC: obtaining node information

The NodeInfoService gRPC service is provided to obtain node configuration parameters and data about its owner.

The NodeInfoService has the following methods described in the util_node_info_service.proto protobuf file:

  • NodeConfig;

  • NodeOwner.

Important

The field data types for the request and response are specified in the protobuf files.

gRPC: obtaining node configuration parameters

Use the NodeConfig method to retrieve node configuration parameters. The NodeConfig method does not require any additional query parameters. The following configuration parameters for the node that was queried are displayed in the response:

  • version – version of the blockchain platform in use;

  • crypto_type – cryptographic algorithm in use;

  • chain_id – identifying byte of the network;

  • consensus – consensus algorithm in use;

  • minimum_fee – minimum transaction fee;

  • minimum_fee – additional transaction fee;

  • max-transactions-in-micro-block – the maximum number of transactions in a microblock;

  • min_micro_block_age – the minimum time of microblock existence (in seconds);

  • micro-block-interval – the interval between microblocks (in seconds);

  • pos_round info– when using the PoS consensus algorithm, the average_block_delay parameter is displayed (the average block creation delay time, in seconds);

  • poa_round info – when using the PoA consensus algorithm, the following parameters are displayed:

    • round_duration – block mining round length, in seconds and

    • sync_duration – block mining synchronization period, in seconds.

gRPC: retrieving data about the node owner

Use the NodeOwner method to get data about the owner of a node. The method NodeOwner does not require any additional query parameters. The following information on the node that was queried is displayed in the response:

  • address – node address;

  • public_key – node public key.

See also