> 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/quick-start.md).

# 快速入门

本指南适合第一次接入 CatFee 无感能量的开发者。目标是在最少步骤内完成节点申请、鉴权配置、广播入口替换和首次广播验证。

## 这页适合谁看

* 适合：后端开发者、钱包服务商、DApp 开发者、交易中继服务
* 也适合：需要判断钱包配置和服务端接入边界的产品或技术负责人
* 不太适合：只想手动配置 TronLink 的普通钱包用户

如果您只想手动配置钱包，可以直接看[钱包设置](/getting-started/seamless-energy/wallet-settings.md)。

## 3 分钟跑通版本

如果您想先验证功能是否能跑通，可以按这个最短路径操作：

1. 在“用户中心 -> 无感能量”申请节点。
2. 找到您系统中已签名交易的广播入口。
3. 开发者优先选择 API KEY 鉴权，并把 AccessKey 放在服务端环境变量中。
4. 只把广播域名切到无感能量节点域名，保持原广播路径和请求体不变。
5. 发起一笔小额 TRC20 转账或授权交易验证结果。

跑通后，再回来看余额不足策略、安全说明和更完整的集成细节。

## 前置条件

* 已拥有 CatFee 会员账号
* 已有可发起 TRON 交易的钱包或后端服务
* 已了解自己的接入方式：后端直接调用、应用内集成、钱包手动配置，或自建中间层
* 如果使用 API KEY 模式，已准备好安全保存 AccessKey 的位置

> 无感能量只处理已签名交易的广播链路。如果您当前只是在查询链上数据，或交易广播并不由您控制，请先看[应用集成](/getting-started/seamless-energy/application-integration.md)确认边界。

## 操作步骤

### 1. 申请无感能量节点

登录 CatFee 网站，在“用户中心 -> 无感能量”申请节点。申请成功后，系统会生成一个专属访问域名：

```
https://{NodeSlug}.catfee.vip
```

示例：

```
https://bright-blue-river.catfee.vip
```

### 2. 找到广播入口

无感能量只增强已签名交易的广播阶段。接入前先确认代码里哪一段最终调用 TRON 广播接口。

常见关键词包括：

```
broadcasttransaction
broadcasthex
BroadcastTransaction
sendRawTransaction
tronWeb.trx.sendRawTransaction
```

如果您希望用 AI 辅助定位代码，可以参考[AI 辅助接入](/getting-started/seamless-energy/ai-assisted-integration.md)里的提示词。给 AI 的代码和日志应先脱敏，不要包含私钥、助记词、keystore、真实 AccessKey 或生产节点域名。

### 3. 选择鉴权方式

根据使用场景选择一种鉴权方式：

* 开发者或钱包服务商：优先使用 API KEY。请求必须在 HTTP header 或 gRPC metadata 中传递 `CF-NODE-KEY: {AccessKey}`
* 普通钱包用户或不支持自定义 Header 的客户端：优先使用绑定地址。请求里的第一笔交易发起地址必须已绑定到该节点
* 临时测试：可使用不鉴权，但不建议长期公开使用

如果使用 API KEY，后续请求需要传递：

```http
CF-NODE-KEY: {AccessKey}
```

### 4. 替换广播节点

把原先用于**广播已签名交易**的节点域名替换为无感能量节点域名。请求路径和请求体保持 TRON 原格式不变。

HTTP 常见广播路径：

```http
POST https://{NodeSlug}.catfee.vip/wallet/broadcasthex
POST https://{NodeSlug}.catfee.vip/wallet/broadcasttransaction
```

gRPC 常见广播配置：

```
服务器：{NodeSlug}.catfee.vip
端口：443
SSL/TLS：开启
广播路径：/protocol.Wallet/BroadcastTransaction
```

### 5. 配置余额不足策略

在 CatFee 用户中心选择会员余额不足时的处理方式：

* 继续广播：跳过能量购买，继续转发原交易
* 停止广播：返回 `402 PAYMENT_REQUIRED`，不继续广播

### 6. 完成首次验证

建议先使用小额 TRC20 转账、授权或低风险合约调用完成端到端验证。优先验证以下结果：

* 节点域名可以正常访问
* 鉴权方式配置正确
* 合约交易会触发 ENERGY 预估和资源准备
* 广播响应格式与原 TRON 节点兼容

不要用普通 TRX 转账做第一笔测试，因为这类非合约交易不会触发资源准备。

## 验证结果

首次验证完成后，通常应能确认以下几点：

* 钱包或后端仍在本地签名，不需要改签名流程
* CatFee 会在广播前为支持的合约交易准备资源
* 非合约交易会被直接转发，不会额外购买 ENERGY
* 原有广播接口和响应格式保持兼容，只是在广播前多了一步资源准备

## 常见问题

* 如果提示节点不存在，通常是域名填写错误或节点已删除
* 如果提示节点已停用，需要先在用户中心重新启用
* 如果提示余额不足，请充值或检查是否允许继续广播
* 如果请求被限频，请降低发送速率

## 下一步

* 开发接入细节参考[应用集成](/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/wallet-settings/other-wallets-and-apps.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/quick-start.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.