无感能量
面向开发者了解 CatFee 无感能量是什么、适合哪些广播链路,以及它如何在不改原交易的前提下为 TRON 合约交易自动准备 ENERGY。
无感能量是由 CatFee 开发并运营的 TRON 交易广播增强服务。开发者只需要把已签名交易广播到 CatFee 提供的专属无感能量节点,CatFee 会在广播原交易前自动估算合约调用所需 ENERGY,为交易发起地址准备资源,再把原交易原样转发到 CatFee 的 TRON 节点。
无感能量建立在 CatFee 自有 TRON 节点服务之上,对开发者呈现为一个兼容 TRON 原广播接口的专属节点:多数场景下只替换广播域名,路径和请求体保持原格式,同时在广播前自动完成 ENERGY 预估和资源准备。
CatFee 不托管用户私钥,不具备替用户签名的能力,也不具备修改用户原始交易的能力。无感能量只处理已签名交易的广播链路。
如果您是第一次接触这个产品,可以先这样理解:它不是签名服务,也不是钱包托管服务,而是一个带自动补 ENERGY 能力的 TRON 广播入口。
适合谁使用
需要为 TRC20 转账、授权、兑换等合约交易自动准备资源的开发者
希望继续沿用原 TRON 广播接口、在多数场景下只替换广播域名的后端服务
需要把 ENERGY 购买逻辑从客户端移除的 DApp 或钱包团队
希望降低 TRON 合约交易失败率的钱包服务商、支付系统或交易中继服务
核心能力
专属节点域名:每个节点都有独立访问域名,例如
https://{NodeSlug}.catfee.vip原接口兼容:继续使用 TRON 原广播路径和请求体
广播前补资源:识别支持的合约交易后自动预估 ENERGY 并准备资源
原交易原样转发:不会改交易内容、不会重签名、不会替换发起地址
多种鉴权模式:支持不鉴权、绑定地址、API KEY
余额策略可配:余额不足时可选择继续广播或停止广播
我该先看哪一页
核心概念
节点域名:每个无感能量节点的专属访问域名,例如
https://{NodeSlug}.catfee.vip无感能量节点:CatFee 为会员账号生成的专属广播接入节点
AccessKey:节点生成的 41 位随机访问密钥,通过
CF-NODE-KEY传递原交易:钱包本地签名后的 TRON 交易,CatFee 只转发不修改
能量交易:CatFee 为原交易发起地址准备 ENERGY 时广播的资源交易
余额不足策略:余额不足时可选择继续转发原交易,或直接返回余额不足错误
owner 地址:交易发起地址,也就是这笔交易实际从哪个钱包地址发出
工作流程
钱包或后端在本地构造并签名交易。
客户端把已签名交易广播到无感能量节点。
CatFee 根据节点域名识别对应会员节点,并执行鉴权。
如果交易是支持的合约调用,CatFee 会估算 ENERGY 并创建资源订单。
能量交易广播成功后,CatFee 会等待约 2 秒再转发原交易。
原交易被原样转发到 CatFee 的 TRON 节点。
客户端收到的响应保持 TRON 广播接口格式。
它会处理什么,不会处理什么
会处理:已签名交易的广播阶段
会自动准备 ENERGY:符合条件的合约广播交易
不会处理:您的私钥、助记词和签名过程
不会自动购买 ENERGY:普通 TRX 转账、账户类操作和其他非合约交易
不会修改:原交易里的地址、金额和合约参数
鉴权方式
无感能量节点支持三种鉴权方式:
API KEY:适合开发者、钱包服务商或地址规模较大的业务方。请求必须在 HTTP header 或 gRPC metadata 中传递
CF-NODE-KEY: {AccessKey},且传入值必须与该节点保存的 41 位随机AccessKey一致绑定地址:适合普通钱包用户或不支持自定义 Header 的客户端。请求里的第一笔交易发起地址必须已绑定到该节点
不鉴权:适合临时测试或明确需要开放访问的场景
其中,节点域名只负责定位节点;绑定地址或 API KEY 负责确认请求是否有权使用该节点。
费用与限制
每个会员账号最多创建 1 个无感能量节点
节点可在用户中心启用、停用或重新创建
只有支持的合约交易才会触发 ENERGY 预估和资源准备
非合约交易不会购买 ENERGY,会直接转发到 CatFee 的 TRON 节点
可变费用、速率限制和资源价格以 CatFee 控制台实际展示为准
安全边界
CatFee 只接收已签名交易,不需要钱包助记词、私钥或 keystore
CatFee 不具备替用户签名或修改用户原始交易的能力
节点域名是路由标识,不应作为唯一安全凭证
不鉴权模式会开放该节点给任何知道节点域名的调用方
下一步
Last updated