Quick Start Guide

This guide helps you complete CatFee TRON Node integration and calls within minutes.

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 for your business

• Enable monitoring and alerts in production

---

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