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

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

钱包或服务商把已签名交易广播到 CatFee 专属无感能量节点后，节点会检测此次交易所需资源，并在资源代理成功后把原交易原样转发到 CatFee 的 TRON 节点。

立即体验

节点形态

https://{NodeSlug}.catfee.vip

兼容接口

broadcasttransaction / broadcasthex

安全边界

不托管私钥 / 不修改原交易

处理范围

首个 TriggerSmartContract

专属广播节点CF-NODE-KEY绑定 owner 地址余额不足策略代理成功后转发

chapter 1

为什么需要无感能量

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

用户不想先理解 ENERGY

用户只是想完成 TRC20 转账、授权或合约交互，不想在最后一步处理资源不足。

钱包需要保留本地签名

交易构造和签名必须留在钱包侧，广播增强不应碰用户私钥和原始交易内容。

广播前需要先准备资源

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

节点域名不能当唯一凭证

域名只负责节点定位，生产环境还需要绑定地址或 AccessKey 防止盗刷。

chapter 2

核心能力

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

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

每个会员账号可生成 1 个专属无感能量节点，例如 https://{NodeSlug}.catfee.vip。

兼容 TRON 原广播接口

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

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

钱包本地构造并签名交易，CatFee 不替用户签名，也不修改原始交易内容。

三种鉴权方式，覆盖测试到生产

支持不鉴权、绑定 owner 地址、API KEY。生产环境建议优先使用绑定地址或 AccessKey。

广播前预估 ENERGY 并准备资源

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

余额策略与状态记录可追溯

余额不足可选择继续广播或停止广播，节点状态、请求频率和处理结果都可收口。

chapter 3

交易广播流程

用户仍在钱包本地签名，CatFee 只增强已签名交易的广播链路。

1. 本地签名

钱包在用户本地构造并签名 TRON 交易，私钥、助记词和 keystore 不会上传给 CatFee。

2. 提交广播

钱包或后端把已签名交易发送到专属无感能量节点域名，接口路径保持 TRON 原格式。

3. 识别节点

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

4. 完成鉴权

按节点配置校验不鉴权、绑定地址或 CF-NODE-KEY，确认请求有权使用该节点。

5. 准备资源

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

6. 代理成功后转发

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

7. 链上确认

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

chapter 4

适用场景

只要交易需要 ENERGY，且广播链路可配置节点域名，就可以接入无感能量。

普通钱包用户

钱包支持自定义 TRON 节点时，配置专属域名并绑定 owner 地址即可使用。

钱包服务商

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

开发者与后端服务

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

DApp、Bot 与自动化系统

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

chapter 5

安全与接入摘要

无感能量把安全边界拆成三层：钱包侧保留签名，API 侧要求鉴权，订单侧支持幂等与状态确认。

document summary

钱包侧

TronLink、TokenPocket、IMToken 等主流钱包可通过 DApp Browser 接入；签名始终留在钱包本地，CatFee 不接触私钥、助记词或 keystore。

本地签名DApp Browser不托管私钥

document summary

API 鉴权

开发者请求需要同时携带 `CF-ACCESS-KEY`、`CF-ACCESS-SIGN` 和 `CF-ACCESS-TIMESTAMP`；生产环境建议开启 IP 白名单。

Key / Sign / TimestampIP 白名单UTC 时间戳

document summary

时间与签名

时间戳必须使用 UTC，且与服务器时间偏差不超过 5 秒；401 通常意味着签名、密钥或时间戳存在问题。

偏差 < 5 秒401 常见原因签名规则一致

document summary

订单边界

`client_order_id` 可用于幂等控制；创建订单后请通过 `/v1/order/{id}` 结合 `confirm_status` 或状态字段确认交付结果。

幂等控制订单详情查询状态确认

chapter 6

申请与接入方式

普通钱包用户可以走绑定地址，开发者和钱包服务商可以使用 API KEY 或 gRPC metadata 接入。

钱包用户

适合自定义节点和绑定地址使用

  • 在用户中心申请无感能量节点，获取专属访问域名。
  • 把钱包的 TRON 节点或广播节点配置为 https://{NodeSlug}.catfee.vip。
  • 建议使用绑定地址模式，只允许确认归属自己的 owner 地址使用节点。

开发者与服务商

适合 HTTP、gRPC 和大量地址管理

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

chapter 7

常见问题

以下问题按文档顺序整理，优先覆盖 API Key、签名、限流、订单确认与幂等。

faq

API Key 为什么不能用？

先登录 CatFee 官网检查 API Key 是否仍然有效；如果密钥被禁用、删除，或者被绑定到错误的环境，接口会直接失败。

API Key 状态账号检查密钥有效性

faq

如何限制 API Key 只允许特定 IP 访问？

在创建或编辑 API Key 时配置 IP 白名单即可。生产环境建议默认开启白名单，避免密钥泄露后被直接滥用。

IP 白名单访问控制生产安全

faq

为什么会返回 401 Unauthorized？

通常是 `CF-ACCESS-KEY`、`CF-ACCESS-SIGN` 不正确，或者 `CF-ACCESS-TIMESTAMP` 偏差超过 5 秒。优先检查签名串、UTC 时间戳和请求头。

401签名时间戳

faq

为什么会返回 400 或 429？

400 说明参数、路径或 JSON 结构有问题；429 表示请求频率超过限制。前者先对照文档参数，后者需要降低并发或加退避重试。

400429限流

faq

如何确认能量是否已经交付？

创建订单后记录返回的 `id`，然后用 `/v1/order/{id}` 查询状态。一般从 `TRANSFER_SUCCESS` 到 `DELEGATE_SUCCESS` 再到 `DELEGATION_CONFIRMED` 逐步确认。

订单详情confirm_status状态查询

faq

同一请求会不会重复创建订单？

`client_order_id` 可用于幂等控制。相同的请求标识再次提交时，不会被当作新订单重复处理，更适合自动化和重试场景。

client_order_id幂等重复保护

final chapter

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

申请节点、选择鉴权方式、替换广播域名，再用一笔小额 TRC20 转账或测试网合约调用完成端到端验证。

进入用户中心申请
快速入门