> 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/wallet-integration.md).

# 钱包接入

## 整体说明

只要钱包支持自定义 TRON 节点，就可以接入 CatFee 无感能量。

接入时只需将钱包的 TRON 节点或广播节点替换为 CatFee 提供的专属节点地址。钱包仍在本地完成交易构造和签名；无感能量节点收到已签名交易后，会根据交易需要自动准备 ENERGY（能量）或 BANDWIDTH（带宽），再将原交易广播到 TRON 网络。

{% hint style="info" %}
CatFee 不需要您的私钥或助记词，也不会修改交易地址、金额、签名或合约参数。
{% endhint %}

## 接入条件

* 已在 CatFee 用户中心申请并启用无感能量节点
* 已取得专属节点地址
* 钱包支持自定义 TRON 节点或广播节点
* 已选择合适的鉴权方式

## 选择节点地址

不同钱包支持的连接方式可能不同：

| 接入方式                        | 节点地址                            | 连接方式    |
| --------------------------- | ------------------------------- | ------- |
| TokenPocket 等支持 HTTP 的钱包或应用 | `https://{NodeSlug}.catfee.vip` | HTTPS   |
| TronLink App（手机版）           | `{NodeSlug}.catfee.pro:50051`   | 明文 gRPC |

{% hint style="warning" %}
请根据钱包实际支持的连接方式选择节点。HTTPS 节点和 TronLink App 专用明文 gRPC 节点不能混用。
{% endhint %}

## 选择鉴权方式

| 使用场景                       | 推荐方式    | 说明                   |
| -------------------------- | ------- | -------------------- |
| TokenPocket、TronLink 等普通钱包 | 绑定地址    | 无需钱包发送额外请求头          |
| 支持自定义 Header 的钱包           | API KEY | 请求头需携带 `CF-NODE-KEY` |
| 临时测试                       | 不鉴权     | 不建议长期使用              |

普通钱包用户建议使用**绑定地址**。请先在 CatFee 用户中心绑定实际发起交易的钱包地址，再配置节点。

## 工作流程

1. 钱包在本地构造并签名交易。
2. 钱包将已签名交易发送到无感能量节点。
3. 节点根据交易需要准备能量或带宽。
4. 节点将原交易广播到 TRON 网络。
5. 钱包按照原有方式显示交易结果。

## 选择接入指南

* 使用 TronLink App 手机版：查看[TronLink App 设置](/seamless-energy/wallet-integration/tronlink-setup.md)
* 使用 TokenPocket App 手机版：查看[TokenPocket App 设置](/seamless-energy/wallet-integration/tokenpocket-setup.md)
* 使用其他支持自定义节点的钱包：参照本页的节点和鉴权说明进行配置
* 通过后端统一广播：查看[API 接入](/seamless-energy/api-integration.md)
* 需要了解安全边界：查看[安全说明](/seamless-energy/security.md)