> 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/getting-started/tron-node-guide/quick-start.md).

# 快速上手指南

### 一、获取访问凭证

在使用服务前，你需要获取 **TRON 节点专用的 API Key**（⚠️ 注意：不同于平台其他服务的 API Key）：

#### 获取路径：

**用户中心 → 波场节点 → 套餐 → 在列表中获取对应节点的 API 秘钥**

> 📌 请确保使用的是“节点对应的 API Key”，否则会导致认证失败。

***

### 二、连接节点

CatFee 提供基于 **gRPC + TLS（HTTPS/2）** 的安全连接方式：

* **协议**：gRPC（HTTP/2）
* **端口**：443
* **安全要求**：必须启用 TLS（SSL）
* **请求头认证**：

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

***

### 三、选择服务接口

TRON 节点提供两个核心服务：

* **wallet**
  * 用于查询未确认交易
  * 实时性更高
* **walletSolidity**
  * 用于查询已确认链上数据
  * 数据更稳定可靠

👉 一般建议：

* 查余额 / 状态 → 使用 `walletSolidity`
* 发送交易 / 实时查询 → 使用 `wallet`

***

### 四、发起第一个请求

以下是一个示例流程（以查询账户为例）：

#### 1. 建立 gRPC 连接

* 使用支持 HTTP/2 的 gRPC 客户端
* 启用 TLS
* 设置请求头 `X-CATFEE-TOKEN`

#### 2. 调用接口

常用方法：

* `GetAccount` → 查询账户信息
* `CreateTransaction` → 创建交易
* `BroadcastTransaction` → 广播交易
* `TriggerSmartContract` → 调用智能合约

***

### 五、最佳实践

* ⏱ **超时设置**：建议 5–10 秒
* 🔐 **安全性**：不要暴露 API Key，建议配合 IP 白名单使用
* 🚀 **性能优化**：
  * 合理控制请求频率（RPS）
  * 根据业务选择合适套餐
* 🔁 **重试机制**：
  * 对偶发失败请求进行指数退避重试

***

### 六、常见问题排查

* ❌ **连接失败**
  * 检查是否启用 TLS
  * 确认客户端支持 HTTP/2
* ❌ **认证错误**
  * 确认 `X-CATFEE-TOKEN` 是否正确
  * 确认是否使用了“节点对应的 API Key”（不是其他服务的 Key）
  * 检查是否启用了 IP 白名单限制
* ❌ **请求超时**
  * 调整 timeout 设置
  * 检查网络延迟或节点负载

***

### 七、下一步

* 查看完整 API 文档
* 根据业务选择合适[套餐（Pricing Plans）](/getting-started/tron-node-guide/pricing-plan.md)
* 在生产环境中启用监控与告警

***

完成以上步骤后，你就可以开始构建基于 TRON 的 DApp 或区块链服务了 🚀