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

# Wallet Integration

Learn how wallets integrate CatFee Seamless Energy and how to choose the appropriate node and authentication method.

## Overview

Any wallet that supports custom TRON nodes can integrate CatFee Seamless Energy.

Simply replace the wallet's TRON node or broadcast node with the dedicated node address provided by CatFee. The wallet continues to construct and sign transactions locally. After receiving a signed transaction, the Seamless Energy node automatically prepares ENERGY or BANDWIDTH as needed, then broadcasts the original transaction to the TRON network.

{% hint style="info" %}
CatFee does not need your private key or mnemonic phrase and does not modify transaction addresses, amounts, signatures, or contract parameters.
{% endhint %}

## Requirements

* A Seamless Energy node has been created and enabled in the CatFee User Center
* You have obtained the dedicated node address
* The wallet supports a custom TRON node or broadcast node
* You have selected an appropriate authentication method

## Choose a node address

Wallets may support different connection methods:

| Integration method                                              | Node address                    | Connection     |
| --------------------------------------------------------------- | ------------------------------- | -------------- |
| TokenPocket and other wallets or applications that support HTTP | `https://{NodeSlug}.catfee.vip` | HTTPS          |
| TronLink mobile app                                             | `{NodeSlug}.catfee.pro:50051`   | Plaintext gRPC |

{% hint style="warning" %}
Choose the node according to the connection method supported by the wallet. The HTTPS node and the dedicated plaintext gRPC node for the TronLink mobile app are not interchangeable.
{% endhint %}

## Choose an authentication method

| Scenario                                            | Recommended method | Description                                                   |
| --------------------------------------------------- | ------------------ | ------------------------------------------------------------- |
| TokenPocket, TronLink, and similar consumer wallets | Bound address      | The wallet does not need to send an additional request header |
| Wallets that support custom headers                 | API KEY            | Requests must include `CF-NODE-KEY`                           |
| Temporary testing                                   | No authentication  | Not recommended for long-term use                             |

Bound address authentication is recommended for ordinary wallet users. Bind the wallet address that will initiate transactions in the CatFee User Center before configuring the node.

## Workflow

1. The wallet constructs and signs the transaction locally.
2. The wallet sends the signed transaction to the Seamless Energy node.
3. The node prepares Energy or Bandwidth according to the transaction's requirements.
4. The node broadcasts the original transaction to the TRON network.
5. The wallet displays the transaction result through its existing flow.

## Choose an integration guide

* For the TronLink mobile app, see [TronLink App Setup](/en/seamless-energy/wallet-integration/tronlink-setup.md).
* For the TokenPocket mobile app, see [TokenPocket App Setup](/en/seamless-energy/wallet-integration/tokenpocket-setup.md).
* For another wallet that supports custom nodes, follow the node and authentication guidance on this page.
* For centralized broadcasting through a backend, see [API Integration](/en/seamless-energy/api-integration.md).
* To understand the security boundaries, see [Security](/en/seamless-energy/security.md).