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.

Note

The same data as the NodeConfig and NodeOwner gRPC methods return, can be obtained using the REST methods of the node group.

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 value of the average_block_delay parameter is displayed (the average block creation delay time, in seconds); this parameter is set in the node configuration file;

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

  • crlChecksEnabled – the certificate revocation list (CRL) check mode during certificate validation.

Note

The same data as the NodeConfig gRPC method returns, can be obtained using the REST methods of the node group.

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.

Note

The same data as the NodeOwner gRPC method returns, can be retrieved using the GET /node/owner REST method.

See also