常见问题

汇总 CatFee 无感能量接入中的常见状态、报错原因、资源处理边界和广播行为,便于钱包与开发者快速排查问题。

我需要替换整个 TRON 节点,还是只替换广播节点?

大多数情况下,您最需要确认的是已签名交易最终广播到哪里。无感能量的核心作用发生在广播阶段。

如果您的钱包或应用把查询、构造交易、广播交易都绑定在同一个节点配置里,也可以整体切到无感能量节点;但从理解上说,真正关键的是广播入口。

为什么我已经换了节点,普通 TRX 转账还是看不出变化?

这是正常现象。普通 TRX 转账不会触发 ENERGY 准备,无感能量主要处理的是合约交易,例如 TRC20 转账、授权和其他合约调用。

节点域名不存在,是什么意思?

通常表示节点访问域名填写错误,或该节点已经被删除。请先核对域名拼写,并确认节点仍存在于 CatFee 用户中心。

节点已停用,怎么办?

该节点域名暂时不能继续广播交易。需要先在 CatFee 用户中心重新启用,再重新发起请求。

会员余额不足时会发生什么?

取决于您配置的余额不足策略:

  • 继续广播:跳过能量购买,继续转发原交易

  • 停止广播:返回 402 PAYMENT_REQUIRED,不继续广播原交易

为什么能量购买失败后,原交易没有继续广播?

如果能量预估、资源下单或能量交易广播失败,CatFee 不会继续转发原交易,避免在资源没有准备好的情况下直接上链失败。

唯一的例外是:会员余额不足且您明确配置为“继续广播”。

为什么普通 TRX 转账不会购买 ENERGY?

普通 TRX 转账、账户操作等非合约交易不会购买 ENERGY,会直接转发到 CatFee 的 TRON 节点。

普通查询请求会自动购买 ENERGY 吗?

不会。查询账户、查询区块、查询交易等读请求不会触发资源准备。无感能量的增强逻辑发生在已签名交易广播时。

当前支持哪些交易?

当前能量处理只针对交易里的第一笔 TriggerSmartContract 合约调用。

为什么资源准备成功了,交易还是可能失败?

资源准备成功只代表 ENERGY 已尽量补齐,不代表合约执行一定成功。合约仍可能因为以下原因失败:

  • 业务条件不满足

  • 账户余额不足

  • 授权额度不足

  • 合约自身逻辑回滚

  • TRON 网络状态波动

为什么 CatFee 要等待约 2 秒再转发原交易?

因为 TRON 不支持 nonce 排队语义,也没有 bundle 打包交易机制。这段等待是为了尽量让资源先到账,再广播原交易。

请求过快是什么意思?

节点存在请求频率限制。超过限制时,请求会被拒绝。应降低并发或发送速率,并根据业务规模评估是否需要更合适的节点方案。

能不能把私钥交给 CatFee 由平台代签?

不能。CatFee 只处理已签名交易的广播链路,不托管用户私钥,也不具备替用户签名的能力。

下一步

Last updated