波场节点连接指南

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

支持服务

walletwalletsolidity(均走同一端口)

💡 购买套餐后,可在控制面板 【波场节点】 → 【套餐】 中查看节点地址与密钥。 💡 所有节点均启用 TLS 加密,默认监听端口 443。 💡 支持自动续费功能,到期当天系统会自动续期,续费失败需手动操作。


🌐 通信方式概览

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 域名下节点均由多台后端实例组成,自动负载均衡并具备多区域冗余。


🧰 技术支持与联系方式

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


✅ 总结

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

它是 TRON 开发者首选的节点方案,具备:

  • 🔐 企业级安全(TLS 加密、认证接入)

  • ⚡ 低延迟访问(多地负载均衡)

  • 🧩 标准化接口(完全兼容 TRON Protocol)

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

Last updated

Was this helpful?