# 波场节点连接指南

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`。\
> 💡 支持自动续费功能，到期当天系统会自动续期，续费失败需手动操作。\
> ![](/files/hC7Ox8hQgRnTsQi4hbOt)

***

###

### 🌐 通信方式概览

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）

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.catfee.io/getting-started/tron-node-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.