> 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/getting-started/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 只处理已签名交易的广播链路，不托管用户私钥，也不具备替用户签名的能力。

## 下一步

* 首次接入参考[快速入门](/getting-started/seamless-energy/quick-start.md)
* 服务端集成参考[应用集成](/getting-started/seamless-energy/application-integration.md)
* AI 辅助改造参考[AI 辅助接入](/getting-started/seamless-energy/ai-assisted-integration.md)
* 钱包手动配置参考[钱包设置](/getting-started/seamless-energy/wallet-settings.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.catfee.io/getting-started/seamless-energy/faq.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.