Skip to content

Latest commit

 

History

History
74 lines (55 loc) · 3.08 KB

hedera-mirror-node.md

File metadata and controls

74 lines (55 loc) · 3.08 KB

Hedera Mirror Node

The Hedera Consensus Service (HCS) is a gRPC API endpoint on the mirror node to stream HCS messages. It offers the ability to subscribe to HCS topics and receive messages for the topic subscribed to. API docs for the mirror nodes can be found here:

{% content-ref url="../../sdks-and-apis/rest-api.md" %} rest-api.md {% endcontent-ref %}

{% content-ref url="../../sdks-and-apis/hedera-consensus-service-api.md" %} hedera-consensus-service-api.md {% endcontent-ref %}

Mainnet

The non-production public mainnet mirror node serves to help developers build their applications without having to run their own mirror node. For production-ready mainnet mirror nodes, please check out Validation Cloud, Arkhia, Dragonglass, Hgraph, or Ledger Works. When building your Hedera client via SDK, you can use setMirrorNetwork() and enter the public mainnet mirror node endpoint. The gRPC API requires TLS. The following SDK versions support TLS:

  • Java: v2.0.6+
  • JavaScript: v2.0.23+
  • Go: v2.1.9+

{% hint style="warning" %} Public mainnet mirror node requests per second (RPS) are currently throttled at 50 per IP address. These configurations may change in the future depending on performance or security considerations. At this time, no authentication is required. {% endhint %}

{% tabs %} {% tab title="Java" %}

//You will need to upgrade to v2.0.6 or higher
Client client = Client.forMainnet();
client.setMirrorNetwork(Collections.singletonList("mainnet.mirrornode.hedera.com:443"))

{% endtab %}

{% tab title="JavaScript" %}

//You will need to upgrade to v2.0.23 or higher
const client = Client.forMainnet()
client.setMirrorNetwork("mainnet.mirrornode.hedera.com:443")

{% endtab %}

{% tab title="Go" %}

client := hedera.ClientForMainnet()
client.SetMirrorNetwork([]string{"mainnet.mirrornode.hedera.com:443"})

{% endtab %} {% endtabs %}

{% hint style="info" %} Mainnet Mirror Node Endpoint: mainnet.mirrornode.hedera.com:443

REST API Mainnet Root Endpoint: https://mainnet.mirrornode.hedera.com {% endhint %}

Testnet

The endpoints provided below allow developers to access the testnet mirror node, which contains testnet transaction data.

{% hint style="info" %} HCS Testnet Mirror Node Endpoint: testnet.mirrornode.hedera.com:443

REST API Testnet Root Endpoint: https://testnet.mirrornode.hedera.com {% endhint %}

Previewnet

The endpoints provided below allow developers to access the previewnet mirror node, which contains previewnet transaction data.

{% hint style="info" %} HCS Previewnet Mirror Node Endpoint: previewnet.mirrornode.hedera.com:443

REST API Preview Testnet Root Endpoint: https://previewnet.mirrornode.hedera.com {% endhint %}