> 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.md).

# 无感能量

无感能量是由 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
* 余额策略可配：余额不足时可选择继续广播或停止广播

## 我该先看哪一页

* 我是开发者或后端接入方：先看[快速入门](/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/application-integration.md)，再看[钱包设置](/getting-started/seamless-energy/wallet-settings.md)
* 我是普通钱包用户：直接看[钱包设置](/getting-started/seamless-energy/wallet-settings.md)
* 我最关心私钥和安全边界：看[安全说明](/getting-started/seamless-energy/security.md)

## 核心概念

* 节点域名：每个无感能量节点的专属访问域名，例如 `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 不具备替用户签名或修改用户原始交易的能力
* 节点域名是路由标识，不应作为唯一安全凭证
* 不鉴权模式会开放该节点给任何知道节点域名的调用方

## 下一步

* 想尽快完成接入：查看[快速入门](/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)
* 需要排查常见错误：查看[常见问题](/getting-started/seamless-energy/faq.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.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.