> For the complete documentation index, see [llms.txt](https://docs.catfee.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catfee.io/en/getting-started/tron-node-guide/quick-start.md).

# Quick Start Guide

### 1. Get Access Credentials

Before using the service, you need to obtain the **TRON Node-specific API Key**. This is different from API keys used by other CatFee platform services.

#### Where to Get It:

**User Center → TRON Node → Plan → get the API key for the corresponding node from the list**

> Please make sure you use the API Key that belongs to the node. Otherwise, authentication will fail.

***

### 2. Connect to the Node

CatFee provides a secure connection based on **gRPC + TLS (HTTP/2)**:

* **Protocol**: gRPC (HTTP/2)
* **Port**: 443
* **Security Requirement**: TLS (SSL) must be enabled
* **Request Header Authentication**:

  ```
  X-CATFEE-TOKEN: YOUR_API_KEY
  ```

***

### 3. Choose a Service Interface

TRON Node provides two core services:

* **wallet**
  * Used to query unconfirmed transactions
  * Higher real-time performance
* **walletSolidity**
  * Used to query confirmed on-chain data
  * More stable and reliable data

General recommendation:

* Balance / status queries → use `walletSolidity`
* Send transactions / real-time queries → use `wallet`

***

### 4. Send Your First Request

The following is an example flow, using account query as an example:

#### 1. Establish a gRPC Connection

* Use a gRPC client that supports HTTP/2
* Enable TLS
* Set the `X-CATFEE-TOKEN` request header

#### 2. Call an Interface

Common methods:

* `GetAccount` → query account information
* `CreateTransaction` → create a transaction
* `BroadcastTransaction` → broadcast a transaction
* `TriggerSmartContract` → call a smart contract

***

### 5. Best Practices

* **Timeout Settings**: 5-10 seconds is recommended
* **Security**: do not expose the API Key; use it together with an IP allowlist when possible
* **Performance Optimization**:
  * Control request frequency (RPS) reasonably
  * Choose the right plan for your business
* **Retry Mechanism**:
  * Use exponential backoff for occasional failed requests

***

### 6. Troubleshooting

* **Connection Failure**
  * Check whether TLS is enabled
  * Confirm that the client supports HTTP/2
* **Authentication Error**
  * Confirm that `X-CATFEE-TOKEN` is correct
  * Confirm that you are using the node-specific API Key, not a key for another service
  * Check whether IP allowlist restrictions are enabled
* **Request Timeout**
  * Adjust the timeout setting
  * Check network latency or node load

***

### 7. Next Steps

* View the full API documentation
* Choose a suitable [Pricing Plan](/en/getting-started/tron-node-guide/pricing-plan.md) for your business
* Enable monitoring and alerts in production

***

After completing these steps, you can start building TRON-based DApps or blockchain services.