常见问题
汇总 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