专属 TRON 广播节点 / 已签名交易增强

无感能量 把能量准备放进广播链路

开发者把已签名交易提交到 CatFee 专属无感能量节点后，节点会检测此次交易所需资源，并在资源准备成功后将原交易原样转发到 CatFee 的 TRON 节点。

申请专属节点
CatFee 无感能量服务标志CATFEE

只需替换你的广播 API

CatFee 会在转发已签名的 TRON 交易前，自动准备能量和带宽。

已签名交易

CatFee 无感能量广播层

CatFee

广播层

无感能量

自动购买能量和带宽

帮助降低转账成本

TRON 网络标志

TRON 节点

  • 支持 HTTP / gRPC
  • 无需私钥
  • 原交易不变
专属广播节点CF-NODE-KEY业务侧完成签名多种策略代理成功后转发处理结果可追溯

开发者为什么需要它

为什么需要无感能量

它解决的不是单次买能量，而是让业务广播、资源准备和安全边界在同一条链路里成立。

业务不应被 ENERGY 流程打断

TRC20 转账、授权或合约交互不应在广播前额外创建能量订单和等待资源到账。

签名权限必须留在业务侧

交易构造和签名留在开发者自己的安全环境中，广播增强不接触私钥或修改原交易。

广播前需要先准备资源

TRON 没有 nonce 排队和 bundle 机制，资源交易需要尽量先于原交易到账。

节点域名不能当唯一凭证

域名只负责节点定位，生产环境还需要通过 CF-NODE-KEY 完成节点鉴权，避免访问密钥被滥用。

产品能力

核心能力

把 CatFee 的节点服务、资源处理和上游转发能力，包装成开发者可直接接入的广播节点。

专属节点域名，直接替换广播入口

开发者可申请专属无感能量节点，例如 https://{NodeSlug}.catfee.vip，只需替换原广播域名。

兼容 TRON 原广播接口

保持 /wallet/broadcasttransaction、/wallet/broadcasthex 等原路径和请求体格式。

只处理已签名交易，不触碰私钥

业务系统自行构造并签名交易，CatFee 不替开发者签名，也不修改原始交易内容。

节点级密钥，隔离不同业务环境

通过 CF-NODE-KEY 完成节点鉴权，可为测试与生产环境分别管理专属节点和访问密钥。

广播前预估 ENERGY 并准备资源

命中支持的合约调用后，检测此次交易所需 ENERGY，并在资源代理成功后转发原交易。

失败策略与处理结果可追溯

可配置资源准备失败后的广播策略，并通过节点记录定位鉴权、限流、资源准备和转发问题。

接入流程

交易广播流程

业务系统保留交易构造与签名权限，CatFee 只增强已签名交易的广播链路。

1. 业务侧完成签名

应用或服务在自己的安全环境中构造并签名 TRON 交易，私钥和签名权限始终由开发者管理。

2. 提交广播

后端服务把已签名交易发送到专属无感能量节点，接口路径与请求体保持 TRON 原格式。

3. 识别节点

CatFee 根据 {NodeSlug}.catfee.vip 定位对应会员的无感能量节点和节点状态。

4. 完成鉴权

节点校验请求中的 CF-NODE-KEY，确认当前服务有权使用对应的专属节点。

5. 准备资源

当前针对第一笔 TriggerSmartContract 调用检测所需 ENERGY，并发起资源代理。

6. 代理成功后转发

资源代理成功后，CatFee 将原交易原样转发到 CatFee 的 TRON 节点。

7. 链上确认

CatFee 保持 TRON 广播响应格式；资源到账和原交易链上确认仍可能受 TRON 网络状态影响。

8. 完成

交易确认后，本次无感能量广播流程完成，业务系统可继续处理结果通知、记录和后续任务。

业务场景

适用场景

适合能够控制交易广播入口，并希望自动处理 ENERGY 准备的开发者与服务商。

钱包服务商

把 CatFee 节点作为广播增强入口，减少用户因 ENERGY 不足导致的转账失败。

开发者与后端服务

通过 CF-NODE-KEY 接入 HTTP Header 或 gRPC metadata，适合管理大量地址。

支付与交易系统

为收付款、商户结算和高频链上操作提供稳定的 ENERGY 准备与交易广播链路。

DApp、Bot 与自动化系统

适合 TRC20 转账、授权、兑换、合约交互等依赖 ENERGY 的链上任务。

安全与边界

安全与接入摘要

无感能量把安全边界拆成三层：业务侧保留签名、专属节点完成鉴权、广播链路返回明确处理结果。

接入要点

签名边界

交易由开发者的应用或后端服务构造并签名。CatFee 不接触私钥、助记词或 keystore，也不会修改原始交易内容。

业务侧签名不托管私钥不修改交易

接入要点

节点鉴权

开发者通过 HTTP Header 或 gRPC metadata 传递 CF-NODE-KEY。AccessKey 归属于专属节点，可在用户中心查看或重置。

CF-NODE-KEY节点级 AccessKey可重置密钥

接入要点

支持范围

节点兼容 TRON 原广播路径，当前主要检测包含 TriggerSmartContract 的已签名交易；其他交易会按节点策略处理。

原广播路径已签名交易明确处理范围

接入要点

失败策略

资源准备失败或余额不足时，可根据业务要求选择停止广播或继续广播，并结合返回结果完成重试、告警和问题定位。

停止或继续广播结果可追溯业务侧重试

开始接入

申请与接入方式

开发者和服务商通过专属节点域名与 CF-NODE-KEY 完成 HTTP 或 gRPC 接入。

开发者与服务商

适合 HTTP、gRPC 和自动化业务系统

  • HTTP Header 或 gRPC metadata 传递 CF-NODE-KEY。
  • AccessKey 是节点级 41 位随机访问密钥，可在用户中心查看或重置。
  • 广播路径保持 TRON 原接口格式，只替换域名和补充鉴权信息。
CF-NODE-KEY: {AccessKey}
POST /wallet/broadcasttransaction

接入前须知

常见问题

集中说明产品差异、安全边界、支持范围、节点鉴权和失败处理方式。

无感能量和普通购买能量有什么区别？

普通购买能量需要先创建订单并指定接收地址；无感能量把资源准备放进交易广播链路，业务系统只需把已签名交易提交到专属节点。

广播增强自动准备资源无需预创建订单
CatFee 会接触私钥或修改原交易吗？

不会。交易由业务系统自行构造并签名，CatFee 只读取已签名交易以判断资源需求，并在资源准备成功后原样转发。

不托管私钥业务侧签名原样转发
目前支持哪些广播接口和交易类型？

当前兼容 /wallet/broadcasttransaction 和 /wallet/broadcasthex，主要处理包含 TriggerSmartContract 的已签名交易。正式接入前建议使用测试交易验证具体合约调用。

broadcasttransactionbroadcasthexTriggerSmartContract
如何保护专属节点不被其他人使用？

每个节点配有独立 AccessKey。业务请求通过 HTTP Header 或 gRPC metadata 传递 CF-NODE-KEY，密钥可在用户中心查看或重置。

CF-NODE-KEYAccessKey节点鉴权
资源准备失败后，原交易会怎样处理？

节点可配置余额不足或资源准备失败时继续广播或停止广播。生产环境应根据业务容错要求选择策略，并记录返回结果用于重试和告警。

失败策略停止广播继续广播
如何申请并完成首次接入？

进入用户中心申请专属节点，获取节点域名和 AccessKey，替换广播域名并添加 CF-NODE-KEY，最后通过一笔小额或测试网交易完成端到端验证。

申请节点配置密钥测试交易

准备开始

用一个专属广播节点接入无感能量

申请节点、获取 AccessKey、替换广播域名并添加 CF-NODE-KEY，再用一笔小额或测试网交易完成端到端验证。

申请专属节点
查看接入文档