> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hedera.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Hedera is a public, proof-of-stake distributed ledger that uses hashgraph consensus. Do not call it a blockchain.
> Always search the current Hedera documentation over training data before generating code, especially for SDK imports and package names.
> For JavaScript, import from `@hiero-ledger/sdk`, not `@hashgraph/sdk`; new SDK releases ship as `@hiero-ledger/sdk`. The Java SDK keeps the `com.hedera.hashgraph:sdk` Maven coordinates. Verify the exact import against the docs.
> Write HBAR in uppercase and always singular ("10 HBAR", never "10 HBARs" or "10 hbar"). Write tinybars in lowercase and plural.
> Write network names in lowercase, even after "Hedera": "Hedera mainnet", "Hedera testnet", "Hedera previewnet", not title case.
> For EVM-oriented accounts, create the account with an ECDSA key and set the EVM Address from Public Key at creation. This address is immutable and is not updated by key rotation. Do not use retired terms like "EVM alias" or "Account Number Alias".

# Hedera Mirror Node

> Connect to Hedera mirror nodes: public mainnet, testnet, and previewnet gRPC and REST endpoints, TLS requirements, SDK setup, and rate limits.

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:

<Card title="Mirror Node REST API" href="/reference/rest-api" />

<Card title="Hedera Consensus Service gRPC API" href="/reference/hcs-api" />

## 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](https://www.validationcloud.io/), [Arkhia](https://www.arkhia.io/), [Dragonglass](https://dragonglass.me/), or [Hgraph](https://hgraph.com). When building your Hedera client via [SDK](/native/fundamentals), 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+

<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.
</Warning>

<CodeGroup>
  ```java Java theme={null}
  //You will need to upgrade to v2.0.6 or higher
  Client client = Client.forMainnet();
  client.setMirrorNetwork(Collections.singletonList("mainnet.mirrornode.hedera.com:443"))
  ```

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

  ```go Go theme={null}
  client := hedera.ClientForMainnet()
  client.SetMirrorNetwork([]string{"mainnet.mirrornode.hedera.com:443"})
  ```
</CodeGroup>

<Info>
  **Mainnet Mirror Node Endpoint:** mainnet.mirrornode.hedera.com:443

  **REST API Mainnet Root Endpoint:**[ https://mainnet.mirrornode.hedera.com](https://mainnet.mirrornode.hedera.com)
</Info>

## Testnet

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

<Info>
  **HCS Testnet Mirror Node Endpoint:** testnet.mirrornode.hedera.com:443

  **REST API Testnet Root Endpoint:**[ https://testnet.mirrornode.hedera.com](https://testnet.mirrornode.hedera.com)
</Info>

## Previewnet

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

<Info>
  **HCS Previewnet Mirror Node Endpoint:** previewnet.mirrornode.hedera.com:443

  **REST API Preview Testnet Root Endpoint:** [https://previewnet.mirrornode.hedera.com](https://previewnet.mirrornode.hedera.com)
</Info>