> For the complete documentation index, see [llms.txt](https://docs.catfee.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catfee.io/seamless-energy/faq.md).

# 常见问题

## 我需要替换整个 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 只处理已签名交易的广播链路，不托管用户私钥，也不具备替用户签名的能力。

## 下一步

* 了解产品原理参考[简介](/seamless-energy/introduction.md)
* 开发接入参考[API 接入](/seamless-energy/api-integration.md)
* 钱包配置参考[钱包接入](/seamless-energy/wallet-integration.md)
* 风险边界参考[安全说明](/seamless-energy/security.md)
