快速上手指南

本指南将帮助你在几分钟内完成 CatFee TRON Node 的接入与调用。

一、获取访问凭证

在使用服务前，你需要获取 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）

• 在生产环境中启用监控与告警

---

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