# 波场节点连接指南

CatFee 提供稳定高效的 **TRON 节点租用服务**，支持通过 **gRPC + SSL 加密协议** 与 TRON 网络交互。\
为开发者提供高可用、低延迟的基础设施支持，用于构建 DApp、钱包、或链上服务。

***

### 📍 节点信息

| 项目                  | 说明                                          |
| ------------------- | ------------------------------------------- |
| **节点域名（Node Host）** | 示例：`tron-demo-yourNodeId.catblockchain.com` |
| **端口（Port）**        | `443`                                       |
| **协议**              | `gRPC over SSL (TLS 1.2+)`                  |
| **认证方式**            | HTTP Header `X-CATFEE-TOKEN: YOUR_API_KEY`  |
| **支持服务**            | `wallet`、`walletsolidity`（均走同一端口）           |

> 💡 购买套餐后，可在控制面板 **【波场节点】 → 【套餐】** 中查看节点地址与密钥。\
> 💡 所有节点均启用 **TLS 加密**，默认监听端口 `443`。\
> 💡 支持自动续费功能，到期当天系统会自动续期，续费失败需手动操作。\
> ![](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-527c1b4419857d665a0fafcc76a54747b444bcde%2Fimage.png?alt=media)

***

###

### 🌐 通信方式概览

CatFee 节点提供 TRON 官方标准的 gRPC 接口服务：

| 服务名                | 用途                   |
| ------------------ | -------------------- |
| **wallet**         | 用于发起或查询未上链交易（未确认状态）  |
| **walletSolidity** | 用于读取已上链区块中的数据（已确认状态） |

***

### 🔒 SSL 加密通信说明

CatFee 节点 **仅支持加密连接**，要求客户端启用 **HTTP/2 + TLS**。\
连接特性如下：

| 特性             | 说明                   |
| -------------- | -------------------- |
| **传输协议**       | gRPC over HTTP/2     |
| **加密标准**       | TLS v1.2 / v1.3      |
| **端口**         | 443                  |
| **证书颁发机构（CA）** | 标准 CA 签发，无需自定义信任     |
| **双向认证**       | 默认单向认证（可选启用双向）       |
| **Header 认证**  | 需携带 `X-CATFEE-TOKEN` |

#### 客户端配置建议

1. **启用 SSL 验证**（不要使用 `createInsecure()` 或 `secure=False` 等参数）
2. **确认支持 HTTP/2**（旧版本 gRPC 库可能默认关闭）
3. **设置连接超时** 建议为 5–10 秒，避免 TLS 握手重试过多
4. **正确传递 Header**：
   * Key：`X-CATFEE-TOKEN`
   * Value：节点分配的 API 密钥

***

### 📦 支持的主要接口

CatFee 节点支持 TRON 全部标准 gRPC 接口，包括但不限于：

* `GetAccount`
* `GetTransactionById`
* `CreateTransaction`
* `BroadcastTransaction`
* `TriggerSmartContract`
* `GetNow`
* `GetBlockByNum`
* 以及 TRON Protocol 中定义的所有常规服务接口。

参考官方文档：\
🔗 <https://developers.tron.network/reference/installation>

***

### ⚙️ 连接性能与限制

| 项目                 | 限制 / 说明               |
| ------------------ | --------------------- |
| **协议要求**           | gRPC over SSL（HTTP/2） |
| **端口号**            | 443                   |
| **Header 认证**      | `X-CATFEE-TOKEN`      |
| **并发限制（标准版）**      | 默认 20 req/s           |
| **延迟表现**           | 平均 < 100ms（亚洲区域）      |
| **walletsolidity** | 仅返回已上链数据              |

***

### 💬 常见问题（FAQ）

**Q1：是否支持非加密连接（明文 gRPC）？**\
A1：不支持。为保证数据安全与防止中间人攻击，所有节点均强制要求 SSL 加密通信。

***

**Q2：如何确认客户端是否启用了 SSL？**\
A2：

* Python 客户端需传入 `secure=True` 或使用 `create_ssl_channel_credentials()`
* Node.js 需使用 `grpc.credentials.createSsl()`
* Java 需调用 `.useTransportSecurity()`

如果仍能使用明文端口连接，说明未启用 SSL，连接将被节点拒绝。

***

**Q3：使用自签名证书是否可行？**\
A3：无需自签名。CatFee 所有节点均采用有效的 CA 签发证书，可直接信任系统根证书链。

***

**Q4：gRPC over SSL 与 HTTPS 有何区别？**\
A4：

* HTTPS 是基于 HTTP/1.1 的 REST 风格；
* gRPC over SSL 是基于 HTTP/2 的二进制流通信；
* gRPC 拥有更高的并发与更低延迟，适合持续数据交互场景。

***

**Q5：wallet 与 walletSolidity 有什么区别？**\
A5：

* `wallet` 查询的是实时未确认交易（类似 mempool）；
* `walletSolidity` 查询的是已经写入区块的数据，稳定性高。

一般建议：

> 发起交易 → 使用 `wallet`\
> 查询结果 / 历史记录 → 使用 `walletSolidity`

***

**Q6：连接返回 429 是什么意思？**\
A6：代表当前请求频率超出配额，请降低并发或升级节点套餐。

***

**Q7：是否支持双向 TLS 或 IP 白名单？**\
A7：

* 默认启用单向 TLS，客户端验证服务端证书；
* 如需双向 TLS 或 IP 限制访问，可联系 CatFee 技术团队定制。

***

**Q8：节点是否具备负载均衡与高可用？**\
A8：是的。`*.catblockchain.com` 域名下节点均由多台后端实例组成，自动负载均衡并具备多区域冗余。

***

### 🧰 技术支持与联系方式

如需企业定制接入、提高并发额度或启用双向认证，请联系：

* Telegram 技术支持：[**@CatFee\_James**](https://t.me/CatFee_James)
* 官方网站：[https://catfee.io](https://catfee.io/)
* 技术主页：[https://catfee.io/blockchain/tron-node](https://catfee.io/blockchain/tron-node/)

***

### ✅ 总结

**CatFee 波场节点服务**现全面升级至 `*.catblockchain.com` 域名体系，\
统一采用 **gRPC over SSL (HTTP/2)** 安全通信。

它是 TRON 开发者首选的节点方案，具备：

* 🔐 企业级安全（TLS 加密、认证接入）
* ⚡ 低延迟访问（多地负载均衡）
* 🧩 标准化接口（完全兼容 TRON Protocol）

> 构建波场应用，从稳定安全的节点开始。