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);

  • pki_mode – when GOST cryptography with PKI is used, the PKI mode in use is output:

    • ON – PKI is used,

    • OFF – PKI is not used,

    • TEST – test mode.

  • required-oids – when GOST cryptography with PKI is used, a list of OID strings of users who have been issued the OIDs by the Certification Authority for use with the blockchain platform specifically is output.

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

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.