无感能量

面向开发者了解 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 地址:交易发起地址,也就是这笔交易实际从哪个钱包地址发出

工作流程

  1. 钱包或后端在本地构造并签名交易。

  2. 客户端把已签名交易广播到无感能量节点。

  3. CatFee 根据节点域名识别对应会员节点,并执行鉴权。

  4. 如果交易是支持的合约调用,CatFee 会估算 ENERGY 并创建资源订单。

  5. 能量交易广播成功后,CatFee 会等待约 2 秒再转发原交易。

  6. 原交易被原样转发到 CatFee 的 TRON 节点。

  7. 客户端收到的响应保持 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