# 简介 CatFee.IO：您的波场能量首选服务商
在区块链行业迅速发展的今天，波场（TRON）以其高性能和低交易费用吸引了越来越多的开发者和用户。而作为一家专业的波场能量提供商，**CatFee.IO** 凭借优质资源、自建节点和全球化部署，为用户提供了一站式的能量解决方案。
{% embed url="" %} #### **CatFee.IO 的核心优势** 1. **优质资源整合，服务覆盖全面**\ CatFee.IO 网罗了波场链上大量优质资源，确保用户能够获得稳定、高效的能量支持，无论是个人开发者还是大型项目都可以轻松对接，降低使用门槛。 2. **自建节点，提供稳定可靠的 API 调用**\ CatFee.IO 自建波场节点，拥有高度稳定的 API 接口服务，无缝支持开发者的各种调用需求。相比其他第三方服务商，自建节点的方式进一步提升了服务的稳定性和安全性。 3. **全球化部署，确保服务高可用性**\ CatFee.IO 在全球多个地区部署了服务器，保证了 7×24 小时全天候在线服务。无论用户身处哪个地区，都能快速访问，享受低延迟、高效率的能量支持。 4. **极具竞争力的价格**\ 为了帮助用户节省成本，CatFee.IO 致力于提供业内最优的价格方案，使用户能够以更低的成本获取更高的价值。同时，其灵活的计费模式也满足了不同用户的预算需求。 5. **7×24 小时技术支持**\ CatFee.IO 提供全天候的技术支持，确保任何问题都能在第一时间得到解决。不论是初学者还是资深开发者，都可以通过客服团队获得专业指导。 6. **高效、便捷的服务体验**\ 用户通过 CatFee.IO 的平台可以轻松管理和分配能量资源。其直观的界面和清晰的操作流程，让能量管理变得更加简单、快捷。 #### **为什么选择 CatFee.IO？** 在波场链上开发一些应用时，稳定的能量支持是项目顺利运行的关键。而 CatFee.IO 不仅提供优质的资源支持，还以其高效、安全和全球化的服务赢得了用户的信赖。如果您正在寻找一个稳定、经济、高效的波场能量解决方案，CatFee.IO 是您的不二选择。\ \ **CatFee 从不提供能量发送黑名单保护，不提供反撸功能，从实际行动上为维护一个清朗、安全的交易环境贡献一份力量。🎉**\ \ CatFee 始终致力于真实可靠的能量业务，始终倡导诚信与信誉。我们帮助用户在 TRC20 链上实现 USDT 正常转账，以节约手续费。我们坚决拒绝为任何涉及 0 U攻击（0.0001 USDT 的地址尾随）、钓鱼、恐怖诈骗等不法行业提供服务。一旦发现此类行为，将立即中止合作。 如果您发现我们的能量地址疑似被用于上述不法行业，敬请及时反馈给我们。数字无国界，人间正道为本，让我们将共同维护一个清朗、安全的交易环境！🤝 让 CatFee.IO 成为您的区块链开发旅程中的坚实后盾！访问 [CatFee.IO](https://catfee.io/) 了解更多信息，开启便捷的能量管理之旅。 # 快速开始指南 \ CatFee.IO 提供了三种不同的能量购买方式，满足不同用户的需求。从初学者到开发者，都能找到适合自己的购买方式。无论你是需要快速购买少量能量，还是想要批量购买或进行灵活的 API 集成，CatFee.IO 都提供了便捷的解决方案。
#### **一、直接转账购买能量（适合新手）** 这种方式最为简单，用户只需向指定地址转账一定数量的 TRX，系统将自动为您分配相应数量的能量。此方式完全匿名，操作简单，非常适合没有技术背景的新手。 **操作步骤：** 1. 打开您的 钱包（如 TronLink、TokenPocket、TronWallet 等）。 2. 向以下地址转账： `TPCowmfeFG9NmGQ3qbWBcYvHUvhBZzzzzz` 3. 转账金额：每次转账 3 TRX，将获得 65000 能量。\ 如果需要更多能量，可以转大于 3 TRX 的金额进行转账（例如：6TRX = 131000 能量）。 4. 完成转账后，系统会自动将能量分配到您转账的账户。 如果想给他其他地址购买能量，请在备注中写上能量接受的地址。\ 这种方式无需复杂的操作，非常适合新手用户，简单方便。 #### **二、DApp 购买能量（适合 DApp 用户）** 如果您已经熟悉 DApp 和钱包的使用，您可以通过 DApp 进行批量购买能量。CatFee.IO 支持多种主流钱包，如 TronLink、TokenPocket、IMToken 等。 **操作步骤：** 1. 打开您的钱包（TronLink、TokenPocket、IMToken 等）。 2. 访问 提供的 DApp 页面。 3. 根据需要选择购买的能量数量。 4. 以及能量接受地址。 5. 按照提示完成支付，系统会为您自动分配相应的能量。 此方式适合熟悉 DApp 操作的用户，能够批量购买能量，操作简单，快速。 #### **三、通过 API 购买能量（适合开发者）** 对于开发者来说，CatFee.IO 提供了更灵活、更便宜的能量购买方式。通过 API，您可以自定义购买的能量数量，满足各种业务需求。此方式适合具备开发能力的用户，能够根据需求灵活调配能量。 **操作步骤：** 1. 登录 CatFee.IO 的官方网站并获取 API Key。 2. 阅读 API 调用文档，了解如何通过 API 请求购买能量。 3. 根据业务需求调用 API 请求，灵活配置购买的能量数量。 4. 使用 API 返回的结果获取购买成功的信息。 **优点：** * 灵活：您可以根据需求自定义能量的购买量。 * 便宜：通过 API 购买能量，比传统的方式更具成本效益。 * 高效：适合大规模或自动化购买，节省时间和精力。 **注意事项：** * 需要具备一定的开发能力。 * 在调用 API 时，需要预先充值。 #### **总结：** * **直接转账购买**：操作简单、完全匿名，适合新手。 * **DApp 购买**：适合有一定 DApp 操作经验的用户，支持批量购买。 * **API 购买**：适合开发者，灵活性高，适合定制化需求和自动化操作。 无论您是新手还是开发者，CatFee.IO 提供的三种购买方式都能满足您的需求。选择适合您的方式，快速开始您的能量购买之旅！ # 直接转账购买能量 CatFee.IO直接转账购买能量 指南 CatFee.IO 提供了简单高效的直接转账方式购买能量服务。您只需向指定地址转账 TRX，系统将自动分配相应数量的能量。如果需要为其他地址购买能量，请在转账时 **备注中直接填写目标地址**，否则能量将分配到您转账使用的地址。 *** ### **操作指南** #### **1. 转账购买地址** 将 TRX 转账至以下指定地址：\ **购买地址**: `TPCowmfeFG9NmGQ3qbWBcYvHUvhBZzzzzz` *** #### **2. 转账金额和能量分配规则** * **3 TRX = 65,000 能量** * 如果需要更多能量，可以转 3 的倍数。例如： * 转账 3 TRX → 获取 65,000 能量 * 转账 6 TRX → 获取 131,000 能量(特殊，为对方无U所需能量数) * 转账 9 TRX → 获取 195,000 能量 * 转账 12 TRX → 获取 260,000 能量 * 以此类推。 **注意**：转账金额必须大于等于 3 TRX，其他金额无效。 *** #### **3. 为其他地址购买能量** 如果您希望为其他地址购买能量，请在转账时的 **备注信息中直接填写目标地址**。例如： **示例：** * 转账 3 TRX 到 `TPCowmfeFG9NmGQ3qbWBcYvHUvhBZzzzzz` * **转账备注填写**：`TQf6J2Q9q7T9HxF7GwFLK3tF3E6Afb9rpo`（目标地址） 系统会将购买的能量分配到备注中指定的地址，而非转账源地址。 *** #### **4. 具体操作示例** **示例 1：为自己购买能量** * 转账金额：`3 TRX` * 转账备注：**留空** * 系统自动分配 65,000 单位能量到您的转账地址。 **示例 2：为其他地址购买能量** 假设您希望为目标地址 `TQf6J2Q9q7T9HxF7GwFLK3tF3E6Afb9rpo` 购买能量： 1. 转账金额：`3 TRX` 2. 转账备注：`TQf6J2Q9q7T9HxF7GwFLK3tF3E6Afb9rpo` 3. 系统会将购买的 65,000 能量分配到地址 `TQf6J2Q9q7T9HxF7GwFLK3tF3E6Afb9rpo`。 *** #### **5. 注意事项** 1. **备注格式** * 如果需要为其他地址购买能量，备注必须为目标地址本身，不需要任何额外格式。 * 如果备注为空，则默认将能量分配到转账的来源地址。 2. **转账金额** * 必须大于3 TRX，例如 3、6、9……。 * 小于3 TRX 金额将无法获得能量。 3. **等待时间** * 转账完成后，能量分配通常会在几秒钟内完成，请耐心等待。 4. **错误操作** * 如果您忘记填写备注或者填写了错误的目标地址，能量将默认分配到您的转账地址或错误地址，系统不支持自动修正。 *** #### **6. 常见问题解答** **Q1: 忘记备注目标地址怎么办？** A: 如果备注为空，系统会将能量分配到您的转账地址。 **Q2: 转账后能量多久到达？** A: 通常几秒内完成分配。如果长时间未到账，请检查您的转账记录是否符合要求（金额为大于3 TRX，备注填写正确）。 **Q3: 可以一次为多个地址购买能量吗？** A: 每次转账只能为一个地址购买能量。如果需要为多个地址购买，请分多次操作，并在每次备注中填写正确的目标地址。 **Q4: 是否支持退款？** A: 如果转账金额错误（如小于 3 TRX）或目标地址填写错误，能量可能无法正确分配。CatFee.IO 不支持退款，但您可以通过客服联系争取协助。 *** 通过直接转账的方式，您可以快速便捷地获取所需的能量，尤其适合初次使用的用户。立即尝试，体验 CatFee.IO 高效的能量购买服务！ # DApp购买能量 在 CatFee.IO 通过 DApp 购买能量的指南 CatFee.IO 提供了一种便捷的方式，支持用户通过钱包内的 DApp 浏览器直接购买能量。只需打开 [https://catfee.io](https://catfee.io/)，即可快速完成能量购买，无论是为自己还是为其他地址提供能量。以下是详细的操作指南： *** ### 第一步：打开 DApp 浏览器 1. 打开您常用的钱包应用（如 **TronLink**、**TokenPocket** 或 **IMToken**）。 2. 找到并进入 **DApp 浏览器** 功能。 3. 在浏览器中输入地址：[https://catfee.io](https://catfee.io/)，按下 **Enter** 键加载 CatFee.IO 的 DApp 页面。 *** ### 第二步：选择购买方式 CatFee.IO 的 DApp 提供 **两种购买方式**，您可以根据需求自由选择： #### **方式一：按能量数量购买** 如果您知道每个目标地址所需的具体能量数，可以选择此方式。 1. **输入目标钱包地址：** * 输入您希望购买能量的目标钱包地址。 * 支持输入 **多个钱包地址**，每个地址用 **换行** 或 **空格** 分隔。 2. **输入能量数量：** * 输入每个地址需要购买的具体能量数量。 * 或者，点击 **快捷能量按钮** 选择常用的能量数量（如 65000、130000 等）。 3. **完成支付：** * 点击 **购买** 按钮确认购买操作。 * 在您的钱包中完成交易签名确认。 4. **分配能量：** * 支付完成后，稍等片刻，购买的能量将自动分配到您指定的目标地址。 *** #### **方式二：按交易笔数购买** 如果您需要根据转账笔数购买能量（例如转 USDT），可以选择此方式。 1. **输入目标钱包地址：** * 输入您希望购买能量的目标钱包地址。 * 支持输入 **多个钱包地址**，每个地址用 **换行** 或 **空格** 分隔。 2. **输入需要购买的交易笔数：** * 输入每个地址您计划执行的转账交易笔数。 * **注意：** * 如果转账的目标地址 **没有 USDT**，需要购买 **2 笔能量** 才能完成转账。 * 如果转账的目标地址 **已有 USDT**，只需购买 **1 笔能量** 即可完成转账。 * 或者，点击 **快捷能量按钮** 选择常用的交易笔数。 3. **完成支付：** * 点击 **购买** 按钮确认购买操作。 * 在您的钱包中完成交易签名确认。 4. **分配能量：** * 支付完成后，稍等片刻，购买的能量将自动分配到您指定的目标地址。 *** ### 第三步：确认能量分配 交易完成后，您可以检查目标钱包地址，确保能量已经成功分配。 *** ### 小贴士 * **仔细检查钱包地址：** 确保输入的目标地址正确，以免能量分配错误。 * **清楚能量需求：** 如果知道具体能量数量，选择方式一；如果按转账交易笔数购买，选择方式二。 * **钱包兼容性：** 确保您的钱包支持 DApp 浏览器功能（如 TronLink、TokenPocket、IMToken 等）。 *** 通过 CatFee.IO 的 DApp，您可以根据需求灵活购买能量，高效又便捷。立即访问 [https://catfee.io](https://catfee.io/) 开始体验吧！ ### 教学视频 1. 波场官方钱包Dapp购买能量教学视频 {% embed url="" %} # 通过 API购买能量 # API概览 CatFee.IO Rest API 调用指南 ### **1. 介绍** CatFee.IO 提供了一套安全、标准化的 API，支持高效的资源访问。通过该 API，用户可以进行诸如订单创建、账户查询等多种操作。所有请求都需要通过签名验证机制，确保请求的安全性和有效性。 ### **2. 如何申请并查看 API 信息** 注册并登录 CatFee 后，进入用户中心页面，点击右侧菜单中的 **“API”**，然后选择 **“API 配置”**。在该页面，您可以： * 查看您的 **API Key** 和 **API Secret**； * 设置 **IP 白名单**，限制 API 的访问来源，增强安全性，防止 API 信息泄露带来的潜在损失。 请妥善保管您的 API 信息，并务必开启 IP 白名单功能，保障账户和资产安全。 ### **3. Base URL 说明** CatFee 提供 **生产环境** 和 **Nile 测试环境**，供开发者根据实际需要选择使用。请注意，两者的账号体系和 API Key 不互通，需分别注册获取。 | 项目 | 生产环境 | 测试环境（Nile） | | -------------------- | --------------------------------------------- | ------------------------------------------------------- | | **网站地址** | [https://catfee.io](https://catfee.io/) | [https://nile.catfee.io](https://nile.catfee.io/) | | **API Base URL** | `https://api.catfee.io` | `https://nile.catfee.io` | | **API Key / Secret** | 注册生产环境账号后在【个人中心】⟶【API】获取 | 注册测试环境账号后在【个人中心】⟶【API】获取 | | **波场区块链浏览器** | [https://tronscan.org](https://tronscan.org/) | [https://nile.tronscan.org](https://nile.tronscan.org/) | | **测试币领取地址** | ❌ 无需 | 每天可领取 2000 TRX | *** #### 🔧 使用说明与注意事项 1. **调用环境选择** * 正式上线或主网部署时，请使用生产环境接口 `https://api.catfee.io`； * 本地开发或功能测试时，请使用测试环境 `https://nile.catfee.io`。 2. **账号和密钥注册说明** * **生产环境和测试环境需分别注册账号**，两者的数据、API Key 不通用； * 注册后在对应网站的【个人中心】中获取 API Key 与 Secret。 3. **测试币领取方式** * 前往 [Nile Faucet](https://nileex.io/join/getJoinPage) 领取波场测试币 TRX； * 每天可免费领取最高 2000 个 TRX； * 测试币到账后可在 [nile.tronscan.org](https://nile.tronscan.org/) 上进行余额查询和交易验证。 ### **4. 签名机制** 为了确保 API 调用的安全性，CatFee.IO 使用 HMAC-SHA256 签名机制对请求进行身份验证。请求需要提供正确的签名，以确保请求未被篡改，并且有效。 ### **5. 签名生成规则** #### **5.1 签名字符串拼接规则** 签名字符串是由以下部分拼接而成： ``` sign = timestamp + method + requestPath ``` * **timestamp**：请求的时间戳，格式为 ISO 8601，例如：`2023-08-26T12:34:56.789Z`。 * **method**：HTTP 方法，例如 `GET`、`POST`、`PUT` 或 `DELETE`。 * **requestPath**：API 请求路径，包含查询参数（如果有）。例如： * `/v1/order?quantity=65000&receiver=TRON_ADDRESS&duration=1h` * 注意：query parameters 应包括在 requestPath 中。 #### **5.2 签名生成流程** 签名的生成步骤如下： 1. 拼接签名字符串：`timestamp + method + requestPath`。 2. 使用 HMAC-SHA256 算法，对拼接后的字符串进行加密，使用您的 API Secret 作为密钥。 3. 对加密结果进行 Base64 编码，生成最终的签名。 #### **5.3 示例** 假设我们有以下信息： * `timestamp = 2023-08-26T12:34:56.789Z` * `method = POST` * `requestPath = /v1/order?quantity=65000&receiver=TRON_ADDRESS&duration=1h` 拼接后的签名字符串为： ``` 2023-08-26T12:34:56.789ZPOST/v1/order?quantity=65000&receiver=TRON_ADDRESS&duration=1h ``` 然后，使用 HMAC-SHA256 算法和 API Secret 对该字符串进行加密，最后对结果进行 Base64 编码，得到最终的签名。 ### **6. 请求头参数** 每次请求都必须包含以下 HTTP 请求头： * **Content-Type**：请求的内容类型，一般为 `application/json`。 * **CF-ACCESS-KEY**：您的 API Key。 * **CF-ACCESS-SIGN**：请求的签名值。 * **CF-ACCESS-TIMESTAMP**：请求的 UTC 时间戳。 ### **7. 示例请求** #### **7.1 示例 POST 请求** 假设您要创建一个订单，API 请求的路径为 `/v1/order`，并且包含以下查询参数： * `quantity=65000` * `receiver=TRON_ADDRESS` * `duration=1h` 生成请求 URL： ``` https://api.catfee.io/v1/order?quantity=65000&receiver=TRON_ADDRESS&duration=1h ``` 请求头应包含以下内容： ``` Content-Type: application/json CF-ACCESS-KEY: your_api_key CF-ACCESS-SIGN: generated_signature CF-ACCESS-TIMESTAMP: 2023-08-26T12:34:56.789Z ``` #### **7.2 示例 GET 请求** 假设您要查询账户信息，API 请求的路径为 `/v1/account`，并且没有查询参数。生成请求 URL： ``` https://api.catfee.io/v1/account ``` 请求头应包含以下内容： ``` Content-Type: application/json CF-ACCESS-KEY: your_api_key CF-ACCESS-SIGN: generated_signature CF-ACCESS-TIMESTAMP: 2023-08-26T12:34:56.789Z ``` [更多API](/api-reference/account) ### **8. 响应数据格式** 所有请求的响应数据通常包含以下结构： ```json { "code": "0", "msg": "", "data": { "key": "value" } } ``` * **code**：响应代码，`0` 表示请求成功。 * **msg**：响应消息，可能包含错误信息或说明。 * **data**：返回的实际数据，通常是一个包含键值对的 JSON 对象。 ### **9. 并发** 每个API\_KEY支持30r/s,如果不能满足您的需求，请联系客服 [@CatFee\_James](https://t.me/CatFee_James).
Java调用示例Java调用示例/pages/tqIgogIjDEmIt74oKvnI
Python调用示例Python调用示例/pages/PGSuvmlyCuxlgvsJFg8I
PHP调用示例PHP调用示例/pages/WMp2gXetyAuuiriNh4JB
Node.js调用示例Node.js调用示例/pages/qamgfBos2Gw6RdZyM6az
Go调用示例Go 调用示例/pages/zk0gyGzC5bQZgsIRpH0X
# Java调用示例 Java 调用 CatFee.IO Rest API 的指南 ### **前提条件** 1. [您需要一个有效的 API Key 和 API Secret](/getting-started/buy-energy-via-api-on-catfee/api-overview#apply-api-info)。 2. 确保您的环境已安装 Java 8 及以上版本，并导入以下依赖： * `java.net.http.HttpClient` * `java.security.MessageDigest` * `javax.crypto.Mac` * `javax.crypto.spec.SecretKeySpec` ### **示例代码** ```java import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; import javax.crypto.Mac; import javax.crypto.spec.SecretKeySpec; import java.util.Base64; import java.nio.charset.StandardCharsets; import java.time.Instant; import java.util.HashMap; import java.util.Map; import java.util.stream.Collectors; public class CatFeeAPIExample { private static final String API_KEY = "your_api_key"; // 请替换为您的API Key private static final String API_SECRET = "your_api_secret"; // 请替换为您的API Secret private static final String BASE_URL = "https://api.catfee.io"; public static void main(String[] args) throws Exception { // 请求方法 String method = "POST"; // 可以根据需要修改为 "GET", "PUT", "DELETE" 等 // 示例：创建订单 String path = "/v1/order"; Map queryParams = new HashMap<>(); queryParams.put("quantity", "65000"); queryParams.put("receiver", "TRON_ADDRESS"); queryParams.put("duration", "1h"); // 生成请求头 String timestamp = generateTimestamp(); String requestPath = buildRequestPath(path, queryParams); String signature = generateSignature(timestamp, method, requestPath); // 创建HTTP请求 String url = BASE_URL + requestPath; HttpRequest request = createRequest(url, method, timestamp, signature); // 发送请求并获取响应 HttpClient client = HttpClient.newHttpClient(); HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); // 打印响应 System.out.println("Response Code: " + response.statusCode()); System.out.println("Response Body: " + response.body()); // 处理可能的错误信息 if (response.statusCode() != 200) { System.out.println("Error: " + response.body()); } } // 生成当前 UTC 时间戳（ISO 8601格式） public static String generateTimestamp() { return Instant.now().toString(); } // 构建请求路径，包括查询参数 public static String buildRequestPath(String path, Map queryParams) { if (queryParams == null || queryParams.isEmpty()) { return path; } String queryString = queryParams.entrySet().stream() .map(entry -> entry.getKey() + "=" + entry.getValue()) .collect(Collectors.joining("&", "?", "")); return path + queryString; } // 生成签名 public static String generateSignature(String timestamp, String method, String requestPath) throws Exception { String signString = timestamp + method + requestPath; return hmacSHA256(signString, API_SECRET); } // 使用 HMAC-SHA256 算法生成签名 public static String hmacSHA256(String data, String secret) throws Exception { Mac sha256Hmac = Mac.getInstance("HmacSHA256"); SecretKeySpec secretKey = new SecretKeySpec(secret.getBytes(StandardCharsets.UTF_8), "HmacSHA256"); sha256Hmac.init(secretKey); byte[] hash = sha256Hmac.doFinal(data.getBytes(StandardCharsets.UTF_8)); return Base64.getEncoder().encodeToString(hash); } // 创建 HTTP 请求，支持 GET, POST, PUT, DELETE public static HttpRequest createRequest(String url, String method, String timestamp, String signature) { HttpRequest.Builder requestBuilder = HttpRequest.newBuilder() .uri(URI.create(url)) .header("Content-Type", "application/json") .header("CF-ACCESS-KEY", API_KEY) .header("CF-ACCESS-SIGN", signature) .header("CF-ACCESS-TIMESTAMP", timestamp); switch (method.toUpperCase()) { case "POST": requestBuilder.POST(HttpRequest.BodyPublishers.noBody()); break; case "PUT": requestBuilder.PUT(HttpRequest.BodyPublishers.noBody()); break; case "DELETE": requestBuilder.DELETE(); break; case "GET": requestBuilder.GET(); break; default: throw new UnsupportedOperationException("Unsupported HTTP method: " + method); } return requestBuilder.build(); } } ``` ### **代码解析** 1. **`method` 变量**：\ 在 `main` 函数中，使用 `String method = "POST";` 来定义请求方法。这可以根据需要修改为 `"GET"`、`"PUT"` 或 `"DELETE"` 等。 2. **生成当前时间戳**：\ `generateTimestamp()` 函数使用 `Instant.now().toString()` 获取当前 UTC 时间，并以 ISO 8601 格式返回时间戳。 3. **构建请求路径**：\ `buildRequestPath()` 函数根据传入的查询参数（`queryParams`）构建完整的 URL 路径，并将查询参数拼接到请求路径后。该函数返回一个带有查询参数的完整路径。 4. **生成签名**：\ `generateSignature()` 函数将 `timestamp`、`method` 和 `requestPath` 拼接成签名字符串，并通过 `hmacSHA256()` 方法进行加密，使用 API Secret 作为密钥，生成签名。 5. **HMAC-SHA256 加密**：\ `hmacSHA256()` 函数实现了 HMAC-SHA256 签名算法，用于生成请求的签名。 6. **创建请求**：\ `createRequest()` 函数根据不同的 HTTP 方法（`GET`、`POST`、`PUT`、`DELETE`）动态构建 HTTP 请求。如果是 `POST` 或 `PUT` 请求，使用 `HttpRequest.BodyPublishers.noBody()`，如果是 `DELETE` 或 `GET` 请求，则使用对应的 `DELETE()` 和 `GET()` 方法。 7. **发送请求并获取响应**：\ 使用 `HttpClient` 发送 HTTP 请求，并通过 `HttpResponse.BodyHandlers.ofString()` 获取响应内容。 8. **错误处理**：\ 示例代码中通过 `if (response.statusCode() != 200)` 判断响应状态码，如果响应失败，打印错误信息。 ### **注意事项** * **API Key 和 Secret**：\ 请确保将 `API_KEY` 和 `API_SECRET` 替换为您从 CatFee.IO 获取的实际值。 * **签名的作用**：\ 签名用于验证请求的合法性，确保请求未被篡改。签名是通过将 `timestamp`、`HTTP 方法`、`请求路径` 和 `查询字符串` 拼接在一起计算得到的。 * **查询参数的顺序**：\ 查询参数应按照原始顺序传递，不需要特别排序。 * **请求的 HTTP 方法**：\ 当前示例支持 `POST`、`PUT`、`GET` 和 `DELETE` 方法，查询参数仍然通过 URL 中传递。 * **响应处理**：\ 示例中直接打印响应内容。如果需要进一步处理响应数据，可以将其解析为 JSON 或其他格式。 ### **总结** 此示例展示了如何在 Java 中使用 CatFee.IO Rest API 进行安全的 API 调用。通过使用 HMAC-SHA256 签名和正确的查询参数处理，确保请求的有效性和安全性。您可以根据需要调整代码，进行不同的操作，支持 `GET`、`POST`、`PUT` 和 `DELETE` 方法。 如有任何问题或需要进一步的帮助，欢迎联系 CatFee.IO 支持团队！ # Python 调用示例 Python 调用 CatFee.IO Rest API 示例 ### **前提条件** 1. [您需要一个有效的 API Key 和 API Secret](/getting-started/buy-energy-via-api-on-catfee/api-overview#apply-api-info)。 2. 确保您的环境已安装 `requests` 库，可以使用以下命令安装： ``` pip install requests ``` 3. 使用 Python 3.6 及以上版本。 ### **示例代码** ```python import hashlib import hmac import base64 import time import requests from urllib.parse import urlencode API_KEY = "your_api_key" # 请替换为您的API Key API_SECRET = "your_api_secret" # 请替换为您的API Secret BASE_URL = "https://api.catfee.io" def generate_timestamp(): """生成当前的时间戳（ISO 8601格式）""" return time.strftime('%Y-%m-%dT%H:%M:%S.000Z', time.gmtime()) def build_request_path(path, query_params): """构建请求路径，包括查询参数""" if not query_params: return path query_string = urlencode(query_params) return f"{path}?{query_string}" def generate_signature(timestamp, method, request_path): """生成签名""" sign_string = timestamp + method + request_path return hmac_sha256(sign_string, API_SECRET) def hmac_sha256(data, secret): """使用 HMAC-SHA256 算法生成签名""" return base64.b64encode(hmac.new(secret.encode('utf-8'), data.encode('utf-8'), hashlib.sha256).digest()).decode() def create_request(url, method, timestamp, signature): """创建 HTTP 请求""" headers = { "Content-Type": "application/json", "CF-ACCESS-KEY": API_KEY, "CF-ACCESS-SIGN": signature, "CF-ACCESS-TIMESTAMP": timestamp, } if method == "POST": response = requests.post(url, headers=headers) elif method == "GET": response = requests.get(url, headers=headers) elif method == "PUT": response = requests.put(url, headers=headers) elif method == "DELETE": response = requests.delete(url, headers=headers) else: raise ValueError(f"Unsupported HTTP method: {method}") return response def main(): method = "POST" # 可以修改为 "GET", "PUT", "DELETE" 等方法 path = "/v1/order" # 示例：创建订单 query_params = { "quantity": "65000", "receiver": "TRON_ADDRESS", "duration": "1h" } # 生成请求头 timestamp = generate_timestamp() request_path = build_request_path(path, query_params) signature = generate_signature(timestamp, method, request_path) # 创建请求 URL url = BASE_URL + request_path # 发送请求 response = create_request(url, method, timestamp, signature) # 打印响应 print("Response Code:", response.status_code) print("Response Body:", response.text) # 处理可能的错误信息 if response.status_code != 200: print("Error:", response.json()) if __name__ == "__main__": main() ``` ### **代码解析** 1. **`generate_timestamp()`**：\ 生成当前的 UTC 时间戳（ISO 8601 格式）。使用 `time.strftime('%Y-%m-%dT%H:%M:%S.000Z', time.gmtime())` 生成时间戳。 2. **`build_request_path()`**：\ 该函数接收 `path` 和查询参数（`query_params`），并构建包含查询参数的完整请求路径。如果没有查询参数，直接返回 `path`。 3. **`generate_signature()`**：\ 使用 `timestamp`、`method` 和 `request_path` 拼接成签名字符串，然后调用 `hmac_sha256()` 来生成签名。 4. **`hmac_sha256()`**：\ 使用 HMAC-SHA256 算法生成签名，使用 API Secret 作为密钥进行加密，并对结果进行 Base64 编码。 5. **`create_request()`**：\ 根据 HTTP 方法（`POST`、`GET`、`PUT`、`DELETE`）发送请求。通过 `requests` 库创建 HTTP 请求并返回响应。 6. **`main()`**：\ 在 `main()` 函数中，设置请求方法为 `POST`，构建查询参数，生成时间戳、签名和请求路径，最终发送请求并打印响应。 ### **注意事项** * **API Key 和 Secret**：\ 请确保将 `API_KEY` 和 `API_SECRET` 替换为您从 CatFee.IO 获取的实际值。 * **错误处理**：\ 示例代码中处理了请求失败的情况，如果响应码不为 `200`，会打印错误信息。 * **请求方法**：\ 支持 `POST`、`GET`、`PUT` 和 `DELETE` 请求，您可以根据实际需求修改请求方法。 ### **总结** 此示例展示了如何使用 Python 调用 CatFee.IO Rest API，利用 HMAC-SHA256 签名确保请求的安全性。您可以根据需要调整代码，支持 `GET`、`POST`、`PUT` 和 `DELETE` 等 HTTP 方法。 # PHP 调用示例 PHP 调用 CatFee.IO Rest API 示例 ### **前提条件** 1. [您需要一个有效的 API Key 和 API Secret](/getting-started/buy-energy-via-api-on-catfee/api-overview#apply-api-info)。 2. 确保您的环境已安装 `cURL` 扩展（大多数 PHP 安装默认包含该扩展）。 ### **示例代码** ```php "65000", "receiver" => "TRON_ADDRESS", "duration" => "1h" ]; // 生成请求头 $timestamp = generateTimestamp(); $requestPath = buildRequestPath($path, $queryParams); $signature = generateSignature($timestamp, $method, $requestPath); // 创建请求 URL $url = $BASE_URL . $requestPath; // 发送请求 try { $response = createRequest($url, $method, $timestamp, $signature); echo "Response Code: 200\n"; echo "Response Body: $response\n"; } catch (Exception $e) { echo "Error: " . $e->getMessage() . "\n"; } } // 执行主函数 main(); ?> ``` ### **代码解析** 1. **`generateTimestamp()`**：\ 该函数返回当前 UTC 时间戳（ISO 8601 格式）。我们使用 `gmdate("Y-m-d\TH:i:s.000\Z")` 来生成时间戳。 2. **`buildRequestPath()`**：\ 该函数构建请求路径，包括查询参数（如果有）。查询参数通过 `http_build_query()` 来构建 URL 编码字符串，不进行排序。 3. **`generateSignature()`**：\ 使用 `timestamp`、`method` 和 `requestPath` 拼接成签名字符串，并通过 `hash_hmac()` 方法使用 HMAC-SHA256 算法对其进行加密，最后对结果进行 Base64 编码。 4. **`createRequest()`**：\ 根据请求方法（`POST`、`GET`、`PUT`、`DELETE`）构建并发送 HTTP 请求。通过 `curl_setopt()` 设置相应的 HTTP 请求类型，并设置请求头。`curl_exec()` 发送请求并返回响应。 5. **`main()`**：\ 在 `main()` 函数中，设置请求方法为 `POST`，并构建查询参数。生成时间戳、签名和请求路径后，调用 `createRequest()` 函数发送请求并打印响应。 ### **注意事项** * **API Key 和 Secret**：\ 请确保将 `API_KEY` 和 `API_SECRET` 替换为您从 CatFee.IO 获取的实际值。 * **错误处理**：\ 使用 `try-catch` 捕获并打印可能出现的异常，如 `cURL` 错误。 * **请求方法**：\ 当前示例支持 `POST`、`GET`、`PUT` 和 `DELETE` 方法，您可以根据实际需求修改请求方法。 * **响应处理**：\ `curl_exec()` 会返回响应体，您可以根据实际情况进一步解析响应数据（如 JSON 格式）。 ### **总结** 此示例展示了如何使用 PHP 调用 CatFee.IO Rest API，利用 HMAC-SHA256 签名确保请求的安全性。通过 `cURL` 发送请求，支持 `GET`、`POST`、`PUT` 和 `DELETE` 等 HTTP 方法，您可以根据需要调整代码。 # Node.js 调用示例 Node.js 调用 CatFee.IO Rest API 示例 ### **前提条件** 1. [您需要一个有效的 API Key 和 API Secret](/getting-started/buy-energy-via-api-on-catfee/api-overview#apply-api-info)。 2. 请确保您的 Node.js 环境已安装 `axios` 库。可以通过 `npm install axios` 安装。 ### **示例代码** ```javascript const axios = require('axios'); const crypto = require('crypto'); const API_KEY = 'your_api_key'; // 请替换为您的API Key const API_SECRET = 'your_api_secret'; // 请替换为您的API Secret const BASE_URL = 'https://api.catfee.io'; // 生成当前的时间戳（ISO 8601格式） function generateTimestamp() { return new Date().toISOString(); } // 构建请求路径，包括查询参数 function buildRequestPath(path, queryParams) { if (!queryParams || Object.keys(queryParams).length === 0) { return path; } const queryString = new URLSearchParams(queryParams).toString(); return `${path}?${queryString}`; } // 使用 HMAC-SHA256 算法生成签名 function generateSignature(timestamp, method, requestPath) { const signString = timestamp + method + requestPath; return crypto.createHmac('sha256', API_SECRET) .update(signString) .digest('base64'); } // 创建 HTTP 请求 async function createRequest(url, method, timestamp, signature) { const headers = { 'Content-Type': 'application/json', 'CF-ACCESS-KEY': API_KEY, 'CF-ACCESS-SIGN': signature, 'CF-ACCESS-TIMESTAMP': timestamp }; try { const response = await axios({ url, method, headers, }); return response.data; } catch (error) { console.error('Error: ', error.response ? error.response.data : error.message); throw error; } } async function main() { const method = 'POST'; // 可以修改为 "GET", "PUT", "DELETE" const path = '/v1/order'; // 示例：创建订单 const queryParams = { quantity: '65000', receiver: 'TRON_ADDRESS', duration: '1h' }; // 生成请求头 const timestamp = generateTimestamp(); const requestPath = buildRequestPath(path, queryParams); const signature = generateSignature(timestamp, method, requestPath); // 创建请求 URL const url = BASE_URL + requestPath; // 发送请求 try { const response = await createRequest(url, method, timestamp, signature); console.log('Response Data: ', response); } catch (error) { console.error('Request failed', error); } } // 执行主函数 main(); ``` ### **代码解析** 1. **`generateTimestamp()`**：\ 返回当前 UTC 时间戳，使用 JavaScript 的 `toISOString()` 方法生成 ISO 8601 格式的时间戳。 2. **`buildRequestPath()`**：\ 该函数根据传入的查询参数（`queryParams`）构建完整的 URL 路径。`URLSearchParams` 类用于将查询参数转为 URL 编码的查询字符串。 3. **`generateSignature()`**：\ 该函数使用 `HMAC-SHA256` 算法对 `timestamp`、`method` 和 `requestPath` 拼接后的字符串进行签名，使用 API Secret 作为密钥。通过 `crypto` 模块生成签名，并返回 Base64 编码的签名。 4. **`createRequest()`**：\ 使用 `axios` 库发送 HTTP 请求。根据不同的请求方法（`GET`、`POST`、`PUT`、`DELETE`）构建请求，并设置请求头，包括 `CF-ACCESS-KEY`、`CF-ACCESS-SIGN` 和 `CF-ACCESS-TIMESTAMP`。 5. **`main()`**：\ 在 `main()` 函数中，设置请求方法为 `POST`，并构建查询参数。生成时间戳、签名和请求路径后，调用 `createRequest()` 函数发送请求并打印响应。 ### **注意事项** * **API Key 和 Secret**：\ 请确保将 `API_KEY` 和 `API_SECRET` 替换为您从 CatFee.IO 获取的实际值。 * **查询参数的顺序**：\ 在此示例中，我们直接通过 `URLSearchParams` 创建查询字符串，不对查询参数进行排序。 * **错误处理**：\ 使用 `try-catch` 捕获并打印可能出现的异常。通过 `error.response` 可以获取服务器的错误响应。 * **请求方法**：\ 当前示例支持 `POST`、`GET`、`PUT` 和 `DELETE` 方法，您可以根据实际需求修改请求方法。 * **响应处理**：\ 如果请求成功，`axios` 会返回 `response.data`，即响应体数据，您可以根据实际情况进一步解析响应数据（如 JSON 格式）。 ### **总结** 此示例展示了如何在 Node.js 中使用 CatFee.IO Rest API，确保请求的安全性，并通过 HMAC-SHA256 签名验证请求。您可以根据需求调整代码，支持不同的 HTTP 方法（`GET`、`POST`、`PUT`、`DELETE`）。 # Go 调用示例 Golang 调用 CatFee.IO Rest API 示例 ### **前提条件** 1. [您需要一个有效的 API Key 和 API Secret](/getting-started/buy-energy-via-api-on-catfee/api-overview#apply-api-info)。 2. 请确保您的 Go 环境已经安装了 `net/http` 和 `crypto/hmac` 等标准库。 ### **示例代码** ```go package main import ( "crypto/hmac" "crypto/sha256" "encoding/base64" "fmt" "net/http" "net/url" "time" "io/ioutil" "log" ) const ( APIKey = "your_api_key" // 请替换为您的API Key APISecret = "your_api_secret" // 请替换为您的API Secret BaseURL = "https://api.catfee.io" ) // 生成当前的时间戳（ISO 8601格式） func generateTimestamp() string { return time.Now().UTC().Format("2006-01-02T15:04:05.000Z") } // 构建请求路径，包括查询参数 func buildRequestPath(path string, queryParams map[string]string) string { if len(queryParams) == 0 { return path } queryString := "?" for key, value := range queryParams { queryString += fmt.Sprintf("%s=%s&", key, value) } // 去掉最后的"&"符号 queryString = queryString[:len(queryString)-1] return path + queryString } // 使用 HMAC-SHA256 算法生成签名 func generateSignature(timestamp, method, requestPath string) string { signString := timestamp + method + requestPath mac := hmac.New(sha256.New, []byte(APISecret)) mac.Write([]byte(signString)) signature := mac.Sum(nil) return base64.StdEncoding.EncodeToString(signature) } // 创建 HTTP 请求 func createRequest(url, method, timestamp, signature string) (*http.Response, error) { client := &http.Client{} req, err := http.NewRequest(method, url, nil) if err != nil { return nil, err } // 设置请求头 req.Header.Add("Content-Type", "application/json") req.Header.Add("CF-ACCESS-KEY", APIKey) req.Header.Add("CF-ACCESS-SIGN", signature) req.Header.Add("CF-ACCESS-TIMESTAMP", timestamp) return client.Do(req) } func main() { method := "POST" // 可以修改为 "GET", "PUT", "DELETE" path := "/v1/order" // 示例：创建订单 queryParams := map[string]string{ "quantity": "65000", "receiver": "TRON_ADDRESS", "duration": "1h", } // 生成请求头 timestamp := generateTimestamp() requestPath := buildRequestPath(path, queryParams) signature := generateSignature(timestamp, method, requestPath) // 创建请求 URL url := BaseURL + requestPath // 发送请求 resp, err := createRequest(url, method, timestamp, signature) if err != nil { log.Fatal("Error making request:", err) } // 读取并输出响应 body, err := ioutil.ReadAll(resp.Body) if err != nil { log.Fatal("Error reading response:", err) } // 打印响应数据 fmt.Println("Response Status:", resp.Status) fmt.Println("Response Body:", string(body)) } ``` ### **代码解析** 1. **`generateTimestamp()`**：\ 使用 `time.Now().UTC().Format("2006-01-02T15:04:05.000Z")` 获取当前 UTC 时间，并格式化为 ISO 8601 时间戳。 2. **`buildRequestPath()`**：\ 该函数将传入的查询参数（`queryParams`）构建成 URL 查询字符串。每个查询参数用 `&` 连接，最后返回完整的请求路径。 3. **`generateSignature()`**：\ 通过 `timestamp`、`method` 和 `requestPath` 拼接生成签名字符串，然后使用 HMAC-SHA256 算法进行签名，并将结果进行 Base64 编码。最终返回签名。 4. **`createRequest()`**：\ 创建一个 HTTP 请求，使用 `http.NewRequest()` 创建请求对象，并通过 `req.Header.Add()` 添加必要的请求头，包括 `CF-ACCESS-KEY`、`CF-ACCESS-SIGN` 和 `CF-ACCESS-TIMESTAMP`。然后，发送请求并返回响应。 5. **`main()`**：\ 在 `main()` 函数中，设置请求方法为 `POST`，并传入需要的查询参数。调用 `generateTimestamp()`、`buildRequestPath()` 和 `generateSignature()` 来生成请求头信息。最后，使用 `createRequest()` 发送请求并打印响应内容。 ### **注意事项** * **API Key 和 Secret**：\ 请确保将 `APIKey` 和 `APISecret` 替换为您从 CatFee.IO 获取的实际值。 * **查询参数的顺序**：\ 本示例中，我们直接将查询参数拼接到请求路径中，并没有排序查询参数。如果需要对查询参数排序，请使用适当的排序方法。 * **响应处理**：\ 响应通过 `ioutil.ReadAll()` 读取并打印。如果响应体为 JSON 格式，您可以使用 `encoding/json` 库来解析 JSON 数据。 * **请求方法**：\ 当前示例支持 `POST`、`GET`、`PUT` 和 `DELETE` 方法，您可以根据实际需求修改请求方法。 ### **总结** 这个示例展示了如何在 Go 中使用 CatFee.IO Rest API，通过 HMAC-SHA256 签名验证来确保请求的安全性。您可以根据实际需求修改代码，支持不同的 HTTP 方法（`GET`、`POST`、`PUT`、`DELETE`），并处理不同的 API 响应。 # API支持幂等请求 CatFee 购买能量 API 支持幂等请求，交易更稳定可靠！ 🚀 **CatFee 购买能量 API 现已支持幂等性！** 通过新增可选参数 `client_order_id`，用户可确保相同请求不会被重复执行，有效避免**重复扣款**、**订单状态不一致**等问题，让交易更加安全可靠！ *** ### **🔍 什么是幂等性？为什么重要？** 幂等性（Idempotency）指的是**无论同一个请求被提交多少次，最终的结果都是一致的，不会导致重复执行**。这对于支付类、购买类的 API 尤其重要，能够有效防止： * **网络超时导致的重复扣费** * **系统异常引发的状态不一致** * **用户误操作的多次提交** **🚀 现在，CatFee 购买能量 API 通过 `client_order_id` 实现幂等性，确保相同请求不会被重复执行，交易更安全可靠！** *** ### **🛠 如何使用 CatFee 购买能量 API 进行幂等请求？** #### **📌 请求示例** 根据 CatFee.IO Rest API 规则，**所有请求参数通过 query parameter 方式传递**，签名计算方式**不包含 query parameters**，请求示例如下： **示例 POST 请求** 假设用户希望购买 65000 能量，并使用 `client_order_id=abc123` 实现幂等性，完整请求如下： ```http POST https://api.catfee.io/v1/order?quantity=65000&receiver=TRON_ADDRESS&duration=1h&client_order_id=abc123 ``` #### **📌 请求头** ```http Content-Type: application/json CF-ACCESS-KEY: your_api_key CF-ACCESS-SIGN: generated_signature CF-ACCESS-TIMESTAMP: 2023-08-26T12:34:56.789Z ``` #### **📌 参数说明** | 参数名 | 类型 | 是否必填 | 说明 | | --------------------- | ------ | ---- | ------------------- | | `quantity` | int | 是 | 购买的能量数量（单位：Energy） | | `receiver` | string | 是 | 接收能量的 TRON 地址 | | `duration` | string | 是 | 能量租赁时长，例如 `1h` | | `client_order_id` | string | 否 | 客户端自定义的订单 ID，用于幂等请求 | | `CF-ACCESS-KEY` | string | 是 | API 访问密钥 | | `CF-ACCESS-SIGN` | string | 是 | 请求签名，确保请求安全性 | | `CF-ACCESS-TIMESTAMP` | string | 是 | 当前 UTC 时间戳（用于签名） | **🔹 幂等性逻辑** * **如果 `client_order_id` 是第一次提交**，则系统创建新的能量购买订单，并返回订单详情。 * **如果 `client_order_id` 已提交过**，系统会直接返回之前的订单结果，而不会重新扣款或创建新订单。 *** ### **📄 返回示例** #### **🎯 第一次请求成功** ```json { "code": 0, "data": { "id": "xyz987", "client_order_id":"abc123", "pay_timestamp": 1700000000, "receiver": "TRON_ADDRESS", "delegate_hash": "abc123def456", "delegate_timestamp": 1700000050, "reclaim_hash": "ghi789jkl012", "reclaim_timestamp": 1700000100, "pay_amount_sun": 10500000, "activate_amount_sun": 10500000, "quantity": 65000, "staked_sun": 10000000, "duration": 1, "expired_timestamp": 1700003600, "balance": 65000, "resource_type": "ENERGY", "billing_type": "TRANSFER", "status": "PAYMENT_SUCCESS", "activate_status": "DEACTIVATE", "confirm_status": "UNCONFIRMED" } } ``` #### **🔄 相同 `client_order_id` 再次提交** 如果用户因网络问题或超时而重复提交相同 `client_order_id`，API 会返回**相同的订单信息**，避免重复购买： ```json { "code": 0 "sub_code": "SUCCESS", "sub_msg": "Duplicate order request, returning existing order", "data": { "id": "xyz987", "client_order_id":"abc123", "pay_timestamp": 1700000000, "receiver": "TRON_ADDRESS", "delegate_hash": "abc123def456", "delegate_timestamp": 1700000050, "reclaim_hash": "ghi789jkl012", "reclaim_timestamp": 1700000100, "pay_amount_sun": 10500000, "activate_amount_sun": 10500000, "quantity": 65000, "staked_sun": 10000000, "duration": 1, "expired_timestamp": 1700003600, "balance": 65000, "resource_type": "ENERGY", "billing_type": "TRANSFER", "status": "PAYMENT_SUCCESS", "activate_status": "DEACTIVATE", "confirm_status": "UNCONFIRMED" }, } ``` **✅ 这样可以有效避免因误操作或网络抖动导致的重复扣款问题！** *** ### **🎯 适用场景：幂等 API 如何提高交易安全性？** #### **📌 1. 解决网络超时导致的重复提交** * 用户调用 API 购买能量，但因网络波动未及时收到响应，误以为交易失败并再次提交请求。 * **使用 `client_order_id`，即使请求重复提交，也不会执行重复购买。** #### **📌 2. 避免批量交易时的异常扣费** * 自动化脚本或程序批量购买能量时，可能因异常中断导致部分请求未完成。 * **通过 `client_order_id` 追踪请求状态，防止某些订单被重复执行，确保交易准确性。** #### **📌 3. 提高 API 调用的可靠性** * 许多支付系统、交易所 API 都要求请求具备幂等性，以确保交易安全。 * **CatFee 现在支持幂等性，适用于各种业务场景，提高系统的可靠性和稳定性。** *** ### **🚀 CatFee 让能量交易更高效、更安全！** CatFee 一直致力于优化用户体验，现在**购买能量 API 已支持幂等性**，通过 `client_order_id` 让交易更安全、避免重复扣费，让 API 调用更加稳定可靠！ 立即体验 **CatFee 购买能量 API**，让您的波场（TRON）交易更加顺畅无忧！🚀 # 回调（Webhook） 适用对象：集成平台事件推送的第三方开发者。本文档说明回调结构、事件类型、返回要求、重试策略与接入配置。 ### 概览 当平台发生事件时，会通过 HTTP `POST` 调用你配置的回调地址（callbackUrl）。你需要： 1. 接收并解析 JSON 数据； 2. 根据 `X-EVENT-TYPE` 识别事件类型； 3. 成功处理后 **返回 `HTTP 200`** ； 4. 否则平台将按重试策略重新通知。 *** ### 配置回调地址 * **入口位置**：进入 **用户中心 → API 设置** 页面。 * **配置项**：填写 `callbackUrl` 并勾选要订阅的事件类型。 * **协议**：支持 **HTTP** 或 **HTTPS**。 * **路径**：平台通过请求头 `X-EVENT-TYPE` 标识事件类型。 * **不可通过 API 动态订阅**。 *** ### 请求头说明 平台每次回调都会附带以下 HTTP 头： | Header 名称 | 描述 | | ----------------- | ------------------ | | `X-EVENT-ID` | 事件唯一 ID（幂等键） | | `X-EVENT-TYPE` | 事件类型（枚举 EventType） | | `X-EVENT-VERSION` | 事件版本号 | *** ### 事件结构（JSON） 平台推送的回调请求体为 **JSON**，顶层字段采用 **snake\_case**： ```json { "event_type": "EVENT_BALANCE", "event_id": "aabbccdd-1122-3344-5566-77889900", "data": { /* 事件对应的数据体 */ } } ``` #### 事件类型（EventType） 当前有效事件类型：`EVENT_BALANCE`、`EVENT_TRON_MATE_SUBSCRIPTION`、`EVENT_DELEGATION`（如收到未知类型，请记录并忽略）。
事件类型事件名称触发场景回调数据结构说明与处理
EVENT_BALANCE余额变动事件（Balance Changed）当用户账户余额发生变化（充值、提现、质押收益、消费、能量支出等）BalanceChangeEventPayload包含字段：payment_hash、balance_type、billing_type、coin_type、amount_sun、balance、balance_usdt、timestamp、remark用于通知账户余额的实时变化；可据此更新资金记录或展示统计。
EVENT_TRON_MATE_SUBSCRIPTION波场伴侣订阅事件（Tron Mate Subscription）订阅 CatFee Tron Mate 服务（BASIC / PRO 等）成功时触发TronMateSubscriptionEventPayload包含字段：payment_hash、payment_amount_sun、payment_timestamp、subscribe_type、address通知有新订阅发生；每个地址每24小时触发一次。
EVENT_DELEGATION代理确认事件（Delegation Confirmed）用户能量(或带宽)代理确认上链后触发DelegationEventPayload包含字段：order_id、resource_type、delegation_type、receiver、payment_amount_sun、payment_timestamp、duration、quantity、staked_sun、delegation_hash、delegation_timestamp通知能量(或带宽)代理确认成功，可用于账单记录同步。
#### 示例：余额变动（EVENT\_BALANCE） ```json { "event_type": "EVENT_BALANCE", "event_id": "aabbccdd-1122-3344-5566-77889900", "data": { "balance_type": "BALANCE_CHANGE_TRANSFER", "billing_type": "BILLING_ENERGY", "coin_type": "USDT", "amount_sun": 1000000, "balance": 500000000, "balance_usdt": 2000000, "timestamp": 1760505600, "remark": "transfer in" } } ``` #### 示例：订阅（EVENT\_TRON\_MATE\_SUBSCRIPTION） ```json { "event_type": "EVENT_TRON_MATE_SUBSCRIPTION", "event_id": "22334455-6677-8899-aabb-ccddeeff", "data": { "payment_amount_sun": 5000000, "payment_timestamp": 1760505600, "subscribe_type": "SUBSCRIBE_PRO", "address": "TGxxx..." } } ``` *** ### 回调请求格式 * **方法**：`POST` * **Content-Type**：`application/json; charset=utf-8` * **请求头**：包含 `X-EVENT-ID`、`X-EVENT-TYPE`、`X-EVENT-VERSION` #### 示例请求 ```http POST /callback HTTP/1.1 Host: example.com Content-Type: application/json X-EVENT-ID: aabbccdd-1122-3344-5566-77889900 X-EVENT-TYPE: EVENT_BALANCE X-EVENT-VERSION: 2025-01-01 { "event_type": "EVENT_BALANCE", "event_id": "aabbccdd-1122-3344-5566-77889900", "data": { "balance_type": "BALANCE_CHANGE_TRANSFER", "billing_type": "BILLING_ENERGY", "coin_type": "USDT", "amount_sun": 1000000, "balance": 500000000, "balance_usdt": 2000000, "timestamp": 1760505600, "remark": "transfer in" } } ``` ### 事件数据定义： ## The BalanceEvent object ```json {"openapi":"3.1.0","info":{"title":"Notifier API","version":"0.1#@BUILD_ID@"},"components":{"schemas":{"BalanceEvent":{"description":"余额变动事件","properties":{"event_type":{"type":"string","description":"事件类型","enum":["EVENT_UNKNOWN","EVENT_BALANCE","EVENT_TRON_MATE_SUBSCRIPTION","EVENT_DELEGATION","EVENT_ADDRESS_MONITOR","EVENT_EMAIL_MESSAGE","EVENT_TELEGRAM_MESSAGE","EVENT_INTERNAL_MESSAGE","UNRECOGNIZED"]},"event_id":{"type":"string","description":"订单ID，幂等"},"data":{"$ref":"#/components/schemas/BalanceEventData"}}},"BalanceEventData":{"description":"账户变动信息","properties":{"balance_type":{"type":"string","description":"余额类型","enum":["BALANCE_CHANGE_RECHARGE","BALANCE_CHANGE_TRANSFER","BALANCE_CHANGE_DAPP","BALANCE_CHANGE_BALANCE","BALANCE_CHANGE_API","BALANCE_CHANGE_BOT","BALANCE_CHANGE_WITHDRAW","BALANCE_CHANGE_REFUND","UNRECOGNIZED"]},"billing_type":{"type":"string","description":"业务计费类型","enum":["UNKNOWN_BILLING_TYPE","BILLING_ENERGY","BILLING_BANDWIDTH","BILLING_PREMIUM","BILLING_NODE","BILLING_MONITOR","BILLING_DAY_ENERGY","BILLING_MULTIDAY_ENERGY","BILLING_FLASH","BILLING_SUBSCRIBE","BILLING_PERMISSION","BILLING_MARGIN","BILLING_SECURITY","BILLING_SWAP","BILLING_REALTIME","UNRECOGNIZED"]},"coin_type":{"type":"string","description":"币种","enum":["USDT","TRX","ETH","BTC","BNB","BUSD"]},"amount_sun":{"type":"integer","format":"int64","description":"金额sun"},"balance":{"type":"integer","format":"int64","description":"trx余额"},"balance_usdt":{"type":"integer","format":"int64","description":"usdt余额"},"timestamp":{"type":"integer","format":"int64","description":"时间"},"remark":{"type":"string","description":"备注"}}}}}} ``` ## The DelegationEvent object ```json {"openapi":"3.1.0","info":{"title":"Notifier API","version":"0.1#@BUILD_ID@"},"components":{"schemas":{"DelegationEvent":{"properties":{"event_type":{"type":"string","description":"事件类型","enum":["EVENT_UNKNOWN","EVENT_BALANCE","EVENT_TRON_MATE_SUBSCRIPTION","EVENT_DELEGATION","EVENT_ADDRESS_MONITOR","EVENT_EMAIL_MESSAGE","EVENT_TELEGRAM_MESSAGE","EVENT_INTERNAL_MESSAGE","UNRECOGNIZED"]},"event_id":{"type":"string","description":"订单ID，幂等"},"data":{"$ref":"#/components/schemas/DelegationEventData"}}},"DelegationEventData":{"description":"代理详细数据","properties":{"resource_type":{"type":"string","description":"资源类型：ENERGY | BANDWIDTH","enum":["ENERGY","BANDWIDTH","UNRECOGNIZED"]},"delegation_type":{"type":"string","description":"代理类型","enum":["DELEGATION_UNKNOWN","DELEGATION_NORMAL","DELEGATION_MATE_SLOT","DELEGATION_MATE_REPLENISH","UNRECOGNIZED"]},"receiver":{"type":"string","description":"接收地址"},"payment_amount_sun":{"type":"integer","format":"int64","description":"付款金额"},"payment_timestamp":{"type":"integer","format":"int64","description":"付款时间"},"duration":{"type":"integer","format":"int32","description":"周期（分钟）"},"quantity":{"type":"integer","format":"int32","description":"数量"},"staked_sun":{"type":"integer","format":"int64","description":"质押的trx"},"delegation_hash":{"type":"string","description":"代理hash"},"delegation_timestamp":{"type":"integer","format":"int64","description":"代理时间"}}}}}} ``` ## The TronMateSubscriptionEvent object ```json {"openapi":"3.1.0","info":{"title":"Notifier API","version":"0.1#@BUILD_ID@"},"components":{"schemas":{"TronMateSubscriptionEvent":{"description":"波场伴侣订阅事件","properties":{"event_type":{"type":"string","description":"事件类型","enum":["EVENT_UNKNOWN","EVENT_BALANCE","EVENT_TRON_MATE_SUBSCRIPTION","EVENT_DELEGATION","EVENT_ADDRESS_MONITOR","EVENT_EMAIL_MESSAGE","EVENT_TELEGRAM_MESSAGE","EVENT_INTERNAL_MESSAGE","UNRECOGNIZED"]},"event_id":{"type":"string","description":"订单ID，幂等"},"data":{"$ref":"#/components/schemas/TronMateSubscriptionEventData"}}},"TronMateSubscriptionEventData":{"description":"订阅详细数据","properties":{"payment_amount_sun":{"type":"integer","format":"int64","description":"支付金额"},"payment_timestamp":{"type":"integer","format":"int64","description":"支付时间"},"subscribe_type":{"type":"string","description":"订阅类型(BASIC|PRO)","enum":["SUBSCRIBE_UNKNOWN","SUBSCRIBE_BASIC","SUBSCRIBE_PRO","UNRECOGNIZED"]},"address":{"type":"string","description":"地址"}}}}}} ``` ## The AddressMonitorEvent object ```json {"openapi":"3.1.0","info":{"title":"Notifier API","version":"0.1#@BUILD_ID@"},"components":{"schemas":{"AddressMonitorEvent":{"description":"地址监控事件","properties":{"event_type":{"type":"string","description":"事件类型","enum":["EVENT_UNKNOWN","EVENT_BALANCE","EVENT_TRON_MATE_SUBSCRIPTION","EVENT_DELEGATION","EVENT_ADDRESS_MONITOR","EVENT_EMAIL_MESSAGE","EVENT_TELEGRAM_MESSAGE","EVENT_INTERNAL_MESSAGE","UNRECOGNIZED"]},"event_id":{"type":"string","description":"订单ID，幂等"},"data":{"$ref":"#/components/schemas/AddressMonitorEventData"}}},"AddressMonitorEventData":{"description":"地址监控详细数据","properties":{"txn_hash":{"type":"string","description":"交易哈希"},"block_id":{"type":"integer","format":"int64","description":"区块号"},"name":{"type":"string","description":"监控地址昵称"},"address":{"type":"string","description":"监控地址"},"from_address":{"type":"string","description":"转账付款地址"},"contract_address":{"type":"string","description":"合约地址"},"to_address":{"type":"string","description":"转账收款地址"},"amount":{"type":"integer","format":"int64","description":"转账金额"},"decimals":{"type":"integer","format":"int32","description":"转账金额精度"},"currency":{"type":"string","description":"货币类型","enum":["USDT","TRX","ETH","BTC","BNB","BUSD"]},"chain":{"type":"string","description":"区块链类型","enum":["TRON","ETH","BTC","UNRECOGNIZED"]},"paid_at":{"type":"integer","format":"int64","description":"支付时间"}}}}}} ``` *** ### 返回要求 > ⚠️ **NOTICE:** Please return success to notify the notification server after successfully receiving the callback request. After the notification server receives success, the notification stops. * 成功接收后，**必须**返回： ```http HTTP/1.1 200 OK Content-Type: text/plain; charset=utf-8 ``` * 平台以返回 `200` 为成功，否则将重试。 *** ### 重试机制 若响应非 200 ，系统会进行重试。 #### 重试次数与间隔 共 **10 次通知**，间隔如下： ``` 0s / 15s / 30s / 3m / 10m / 20m / 30m / 60m / 3h / 6h ``` 若连续 10 次均失败，则系统放弃并记录。 *** ### 幂等处理建议 * 请使用 `X-EVENT-ID` 作为幂等键。 * 对于已处理事件，应直接返回 `200` 。 *** ### 示例代码 #### Node.js (Express) ```js import express from 'express'; const app = express(); app.use(express.json()); const processed = new Set(); app.post('/callback', (req, res) => { const eventId = req.header('X-EVENT-ID'); if (processed.has(eventId)) return res.status(200).type('text/plain').send('success'); processed.add(eventId); const evt = req.body; // { event_type, data } // TODO: 处理事件 res.status(200).type('text/plain').send('success'); }); app.listen(8080); ``` #### Java (Spring Boot) ```java @RestController public class WebhookController { private final Set processed = Collections.synchronizedSet(new HashSet<>()); @PostMapping(value = "/callback", consumes = MediaType.APPLICATION_JSON_VALUE, produces = MediaType.TEXT_PLAIN_VALUE) public ResponseEntity handle(@RequestHeader("X-EVENT-ID") String id, @RequestBody Map evt) { synchronized (processed) { if (processed.contains(id)) return ResponseEntity.ok("success"); processed.add(id); } // TODO: 事件处理逻辑 return ResponseEntity.ok("success"); } } ``` #### Python (FastAPI) ```python from fastapi import FastAPI, Request, Header, Response app = FastAPI() processed = set() @app.post("/callback") async def webhook(req: Request, x_event_id: str = Header(None)): if x_event_id in processed: return Response(content="success", media_type="text/plain") processed.add(x_event_id) evt = await req.json() # TODO: 事件处理 return Response(content="success", media_type="text/plain") ``` *** ### FAQ **Q1：返回 JSON 可以吗？** 可以。只要返回的HTTP状态为200即可。 **Q2：HTTP 支持吗？** 支持 HTTP 与 HTTPS。 **Q3：可否动态订阅？** 不支持，仅能在用户中心配置。 **Q4：如何分发不同事件？** 根据请求头 `X-EVENT-TYPE` 实现逻辑分支。 **Q5：事件会乱序吗？** 系统尽量保证同类事件顺序，但不作绝对保证。 **Q6：事件版本如何处理？** 根据 `X-EVENT-VERSION` 选择解析方式，未知字段请忽略。 *** **版本：v1.1.1（2025-10-21）** # 能量转租服务 CatFee.IO 提供的 **能量转租服务** 是一种全新的资源共享模式，让您通过租赁能量赚取差价，快速实现高效的能量业务。以下是具体的服务运作流程： *** #### 服务机制 1. **私域用户发起需求**：\ 您的用户通过向您的指定钱包地址转入一定数量的 **TRX**（例如 5 TRX），表示购买能量的需求。 2. **CatFee 代扣与能量发放**： * 当用户的 TRX 转账到达您的钱包时，CatFee.IO 系统会自动从您的账户余额中扣除相应费用（例如 2 TRX）。 * CatFee.IO 会立即将对应数量的能量（例如 65,000 能量）发放至用户地址。 3. **差价收益**：\ 在整个交易中，您通过差价获利。例如： * 用户支付 5 TRX。 * CatFee.IO 扣除 2 TRX 为成本。 * 您每笔交易赚取 **3 TRX** 的纯收益。 *** #### 服务优势 1. **零门槛开展业务**：\ 您无需复杂的操作，只需在 CatFee.IO 开通服务并设置好钱包地址，即可轻松开展能量转租业务。 2. **实时能量发放**：\ CatFee.IO 系统支持自动化操作，确保能量在用户支付后立即发放，提供流畅的用户体验。 3. **稳定的收益模式**：\ 您可以根据每笔交易赚取稳定的差价收益，轻松实现盈利。 4. **灵活可控**：\ 您可以自由设置可用余额，用于控制能量业务的规模和风险。 5. **高安全性**：\ CatFee.IO 平台采用顶级安全机制，确保交易和资金的安全可靠，避免转错资金等意外。 *** #### 示例 假设用户向您的指定地址支付 5 TRX： * **用户支付金额**：5 TRX * **CatFee 扣费**：2 TRX（从您的账户余额中扣除） * **发放能量**：65,000 能量（由 CatFee 发放到用户地址） * **您赚取差价**：3 TRX（5 TRX - 2 TRX = 3 TRX）
*** #### 应用场景 1. **智能合约操作**：\ 用户需要大量能量来执行智能合约，可以通过向您的钱包支付 TRX 快速获取。 2. **私域用户运营**：\ 面向您已有的用户群体，提供便捷的能量租赁服务，并从中获利。 3. **能量转租业务**：\ 您可以通过积累能量资源，将其出租给更多用户，打造持续稳定的盈利模式。 *** #### 如何开启能量转租服务？ 1. **注册并激活账户**：\ 在 CatFee.IO 平台注册账户，并完成认证流程。 2. **充值 TRX 作为账户余额**：\ 确保账户中有足够的 TRX 余额，用于支付 CatFee 扣除的成本。 3. **设置钱包地址**：\ 配置用户支付的指定钱包地址，CatFee.IO 将自动监控该地址的收款情况。 4. **开始盈利**：\ 用户支付后，系统自动完成扣费和能量发放，您即可获得差价收益。 {% embed url="" %} *** CatFee.IO 的能量转租服务为用户和能量提供者搭建了一个高效、安全、低成本的平台，帮助您快速开展能量生意，实现可观的收益。如果您有更多问题或需求，请访问 [CatFee.IO 官网](https://catfee.io/) 或联系我们的客服团队！ # 速充能量服务 CatFee的速充能量服务旨在为用户提供全新、高效、灵活的能量恢复体验。无论您是需要及时完成交易，还是需要迅速补充钱包能量，CatFee的速充能量服务都能为您提供最便捷的解决方案。 **服务前提** 在使用速充能量服务之前，用户的地址必须已经拥有以下两种之一的能量来源： 1. **代理能量**：通过CatFee或者其他平台购买了代理能量，用户的地址已经代理了相应的能量资源。 2. **质押能量**：用户在波场已经进行质押并获得了相应的能量。 速充能量服务依赖于以上前提，确保您的地址能够具备足够的能量基础，快速恢复交易能力。 **服务流程：** 1. **代理与立即回收**： 通过CatFee平台的能量代理系统，用户购买的能量会立即被代理到您的钱包地址，并且平台会立即进行能量回收操作。与传统的能量购买不同，您无需等待能量消耗完毕再进行回收，能够即刻恢复所需能量。 2. **按剩余能量计费**： 在完成能量回收后，用户钱包中留下的能量将作为计费的基础，确保您只为实际使用的能量支付费用。这种按需计费的方式，让用户不必为多余的能量付费，确保服务的高效性和灵活性。 **服务特点：** * **极速恢复**：相比传统能量购买方式，CatFee速充能量服务可以实时恢复您的能量，避免因能量不足而导致的操作延迟。无论您是进行大额交易，还是需要处理紧急转账，速充能量都能确保您的交易顺利进行。 * **按需计费，透明公正**：用户支付的费用是基于实际消耗的能量数量，不会产生任何不必要的额外费用。 * **创新的能量回收机制**：CatFee的速充能量服务采用创新的即时回收机制，确保用户购买的能量能够迅速恢复至钱包账户，并能按实际使用情况进行精确计费。这种机制不仅提升了用户的体验感，也增强了平台的灵活性与高效性。 **适用场景：** 1. **高频操作用户**：对于那些进行高频交易、频繁操作的用户，速充能量服务提供了一个灵活的选择。无论是交易所、钱包管理，还是其他基于 TRX 的业务，速充能量都能确保您不受能量限制的困扰，保持高效的业务运作。 2. **稳定运营**：对于需要保持稳定能量供应的业务，速充能量服务提供了一种灵活高效的解决方案。无论是运营中小型应用，还是大型区块链平台，确保能量的持续供应能够帮助您的业务保持正常运作，避免因能量不足带来的系统中断或交易延迟。 3. **流动性管理**：对于需要管理大量流动资金和能量的用户或机构，速充能量服务帮助您在保证业务流动性的同时，实现低成本、高效的能量管理。用户可以随时购买和回收能量，灵活调整资金和能量的分配，确保运营不受能量不足的影响。 **为什么选择CatFee速充能量？** * **更高效的交易保障**：通过快速恢复能量，用户无需担心因能量不足导致交易失败或延迟，确保交易过程高效无忧。 * **更灵活的资金运作**：即使在高峰时段或突发紧急情况下，用户也能快速恢复能量，避免错失良机。 * **用户至上，服务贴心**：CatFee始终以用户需求为核心，为用户提供高效、安全、透明的服务体验。 通过CatFee的速充能量服务，您将能够轻松应对任何交易需求，无需担心能量不足的问题，享受便捷、高效的区块链交易体验。 CatFee的速充能量服务不仅仅是能量的购买，更是一次全新的交易体验提升。通过智能代理和创新回收机制，我们为每位用户提供快速、安全、灵活的能量恢复方案，让您的交易不再受限于能量不足的烦恼。立即体验CatFee速充能量服务，让您的交易无忧、高效进行！ # 实时归集 实时归集是 CatFee 面向 TRON 多地址收款、USDT 归集和热钱包整理场景提供的自动补能服务。 当您的收款地址达到归集条件时，CatFee 会按照预设规则为目标地址补充 TRON 能量，帮助后续 USDT 转账或归集脚本稳定执行。实时归集只负责补充能量，不接触私钥，不托管钱包，也不会替您转移 USDT、TRX 或其他资产。 ## 适合谁使用 实时归集适合需要管理多个 TRON 收款地址，并希望降低人工补能、人工值守和归集失败成本的用户。 **商户收款归集** 适合电商、支付团队、OTC 商户等多地址收款场景。多个收款地址陆续收到 USDT 后，系统可在达到归集阈值时自动补能，减少人工判断能量和手动补能带来的处理延迟。 **钱包与交易所运营** 适合钱包、交易所和资金运营团队。热钱包整理、充值地址处理和内部地址池归集通常需要稳定执行，实时归集可帮助运营团队保留补能记录、费用记录和失败状态，方便后续核对。 **DApp 与链上工具** 适合支付工具、链上工具和内部系统开发者。当业务地址能量状态不稳定时，用户转账可能失败，自研监控和补能系统也会增加开发维护成本。实时归集可作为地址监控和补能执行层，降低接入复杂度。 **小额高频收款** 适合个人或小型团队管理大量小额收款地址的场景。地址数量多时，逐个检查余额和能量效率较低，使用规则触发补能可以减少重复操作。 > **已有归集脚本？** > > 通常不需要大幅改造。实时归集可以作为现有归集流程前的一层能量保障：CatFee 负责在规则命中时补能，归集转账仍由您的钱包、脚本或业务系统发起。 ## 核心能力 * **规则监控**：按地址池配置触发条件，例如 USDT 余额达到指定阈值。 * **批量地址管理**：支持将多个收款地址放入同一规则统一管理，后续可按业务需要增删地址。 * **自动补能**：规则命中后为目标地址补充 TRON 能量，减少 USDT 转账因能量不足失败的概率。 * **预算控制**：可通过规则启停、单次补能数量和预算限制控制成本。 * **执行记录**：每次补能都会生成目标地址、能量数量、费用明细和执行状态，便于运营复盘和财务核对。 * **非托管边界**：不需要私钥，不控制钱包权限，不代转资产。 ## 工作流程 ### 1. 创建归集补能规则 在 CatFee Dashboard 中创建归集补能配置。创建配置时先设置基础规则，创建完成后再添加需要监控的收款地址。 常见配置项包括： * **余额阈值（Balance Threshold）**：当监控地址的 USDT 余额大于或等于该阈值时，系统触发补能。例如设置为 `10`，表示地址余额达到 10 USDT 后触发补能。 * **补能数量（Energy Quantity）**：每次触发时补充的能量数量，最低为 65,000 Energy，可根据归集转账需要设置。 * **带宽保护（Bandwidth Protection）**：开启后会预留带宽，降低归集转账因带宽不足失败的概率。 * **备注（Remark）**：用于标记规则用途，例如主钱包归集、商户地址池或某个业务线。 创建配置后，需要继续添加监控地址。如果新增地址尚未激活，系统会自动激活该地址，并按 Dashboard 实际展示收取地址激活费用。 ### 2. 导入收款地址 将需要监控的 TRON 收款地址导入规则。适合按业务线、商户、钱包地址池或归集批次分组管理。 导入后，系统会持续检查地址状态。您也可以根据业务变化新增、删除或调整地址。 ### 3. 系统自动监控 规则启用后，CatFee 会持续检查地址是否达到触发条件。例如： * 地址 USDT 余额达到 30 USDT、100 USDT 或其他自定义阈值。 * 地址进入需要归集的运营状态。 * 地址池中某个地址符合补能规则。 当前主要支持基于地址余额的触发条件。更多触发方式，例如时间触发、手动触发和组合规则，会以后续 Dashboard 实际能力为准。 ### 4. 命中规则后自动补能 当地址满足条件时，系统会按照规则补充 TRON 能量。规则触发后，通常会在 1 个 TRON 区块内执行补能，约 3 秒。 补能完成后，您的归集脚本、钱包操作或内部系统即可继续发起 USDT 归集转账。 ### 5. 查看记录和费用 每次补能都会生成执行记录，通常包含： * 执行时间 * 目标地址 * 补能数量 * 补能费用 * 交易 Hash 或执行状态 * 成功、失败、余额不足等结果说明 规则未命中前不会产生补能订单。补能失败不会扣费，失败状态会保留在记录中，方便排查地址、余额、规则或网络状态。 ## 配置示例 以下示例只用于理解配置思路，真实配置项和价格以 CatFee Dashboard 实际展示为准。 | 场景 | 触发条件 | 补能策略 | 地址范围 | 余额要求 | | ----- | ------------- | ------------------------ | ------- | ---------------- | | 小额收款 | USDT 余额 ≥ 30 | 自定义补能数量，最低 65,000 Energy | 32 个地址 | 确保 CatFee 账户余额充足 | | 商户归集 | USDT 余额 ≥ 100 | 自定义补能数量，最低 65,000 Energy | 128 个地址 | 确保 CatFee 账户余额充足 | | 热钱包运营 | 业务余额达到运营阈值 | 自定义补能数量，最低 65,000 Energy | 500+ 地址 | 确保 CatFee 账户余额充足 | ## 费用与控制 实时归集按实际补能执行计费。规则命中前不会产生补能订单，规则暂停后也不会产生新的补能订单。 您可以通过以下方式控制成本： * **暂停规则**：运营调整、活动结束或预算收紧时，可直接暂停规则。 * **控制单次补能数量**：根据转账类型选择合适的能量数量，避免过度补能。 * **查看执行记录**：通过目标地址、能量数量和费用明细核对成本。 * **关注账户余额**：账户余额不足时，Dashboard 会显示余额预警，建议及时充值，避免归集流程中断。 ## 安全边界 实时归集只解决能量准备问题，不负责资产归集本身。 | 边界 | 说明 | | ------- | ------------------------------------------- | | 不需要私钥 | CatFee 不要求用户提交私钥，也不要求托管钱包 | | 不代转资产 | CatFee 只补充 TRON 能量，不代替用户发起 USDT、TRX 或其他资产转账 | | 用户保留控制权 | 用户可以随时暂停、修改或删除规则，也可以调整地址列表和补能策略 | | 记录可审计 | 补能结果和费用明细可用于运营复盘、财务核对和问题排查 | ## 操作建议 1. 先梳理需要监控的收款地址，并按业务线或用途分组。 2. 根据归集策略设置 USDT 余额阈值，例如小额收款使用较低阈值，商户归集使用较高阈值。 3. 根据目标转账类型选择补能数量，例如 65,000 Energy 或 131,000 Energy。 4. 设置预算限制和余额提醒，避免账户余额不足导致补能失败。 5. 先用少量地址验证规则，再逐步扩大到完整地址池。 6. 定期导出或查看执行记录，用于运营复盘和成本核对。 ## 常见问题 ### 什么是 TRON 实时归集？ TRON 实时归集是 CatFee 面向 USDT 多地址收款和资金归集场景提供的自动补能能力。用户配置监控地址、余额阈值和补能规则后，当地址达到归集条件时，系统会为目标地址补充 TRON 能量，减少 USDT 转账因能量不足而失败或中断。 ### CatFee 会控制我的钱包吗？ 不会。实时归集是非托管服务，不需要私钥，也不会控制您的钱包权限。CatFee 只在规则命中时为目标地址补充 TRON 能量。 ### 补能后会自动帮我归集 USDT 吗？ 不会。实时归集只解决 TRON 能量准备问题，不负责转移资产。补能完成后，仍由您的钱包操作、归集脚本或内部系统发起 USDT 归集转账。 ### 什么情况下会自动补能？ 当您配置的 TRON 地址满足触发条件时会自动补能，例如 USDT 余额达到指定归集阈值。您可以在 Dashboard 中配置监控条件和补能策略。 ### 补能需要多长时间？ 规则触发后，系统通常会在 1 个 TRON 区块内执行补能，约 3 秒。能量到账后，您的 USDT 归集脚本或转账流程即可继续执行。 ### 如果补能失败会怎样？ 如果自动补能失败，系统会记录失败状态，并在 Dashboard 中展示执行结果，方便您排查地址、余额、规则或网络状态等问题。补能失败不会扣费。 ### 是否支持批量导入地址？ 支持。实时归集适合商户、钱包和交易所管理大量 TRON 收款地址。您可以通过 Dashboard 批量导入地址列表，并统一配置补能规则。 ### 可以随时修改或删除规则吗？ 可以。您可以随时暂停、修改或删除归集补能规则，也可以调整地址列表、USDT 余额阈值和补能数量。规则暂停后不会产生新的补能订单。 ### 我已经有归集脚本，还需要改造吗？ 通常不需要大幅改造。CatFee 归集补能可以作为现有 USDT 归集流程前的一层能量保障。补能完成后，继续由原有脚本、钱包或内部系统发起归集。如果需要 API 对接，请联系 CatFee 技术支持确认方案。 # 电报会员转卖 CatFee 全新上线 **电报会员转卖功能**！让您可以快速搭建属于自己的 Telegram Premium 代理销售渠道，实现利润变现。该功能与能量转租功能类似，**无需开发，即可对接私域用户实现自动开通 Premium 服务**。
*** ### 🚀 功能概述 您可以在 CatFee 平台设置 Telegram Premium 的转卖价格，例如设置为： | 时长 | 官方成本价 | 可设定售价 | 单笔利润 | | ---- | --------- | ------- | -------- | | 3个月 | 12.5 USDT | 15 USDT | 2.5 USDT | | 6个月 | 16.5 USDT | 20 USDT | 3.5 USDT | | 12个月 | 29.5 USDT | 35 USDT | 5.5 USDT | 当您的私域用户向您指定的收款地址转账，并在**备注中填写 Telegram 用户名（ID）**，CatFee 会自动处理订单，完成会员开通。 *** ### 🛠️ 使用步骤 #### 1. 进入 [CatFee 用户中心](https://dashboard.catfeee.io) 前往 CatFee 用户中心，登录您的账户。 #### 2. 设置会员价格与收款地址 在菜单中选择： ``` Telegram 高级会员 → 转卖 ``` 设置： * 收款地址（您的 USDT 地址） * 售价（您对用户收取的价格） #### 3. 用户转账 + 添加备注 您私域的客户按照您提供的价格进行转账： * 向指定地址转账 USDT（如：15 USDT） * 在转账备注中填写电报账号 ID，例如 `aaa` CatFee 系统会自动识别该转账并完成如下流程： 1. 核对金额和备注 2. 从您账户中扣除成本价（如：12.5 USDT） 3. 为指定电报账号开通对应时长的会员服务 您将**自动获得差价利润**！ *** ### ⚠️ 注意事项 * 💬 **备注必须填写电报用户名或用户 ID**，否则系统无法识别。 * ❗ 用户所提交的 Telegram 账号**不得在 App Store、Google Play 或其他渠道订阅过 Premium**，否则将无法开通。 * 💸 CatFee 只在您账户余额充足的情况下处理订单，请确保余额足够覆盖成本。 * 🛡️ 本服务由 CatFee 官方渠道授权购买，不涉及破解或非法方式。 *** ### 📞 联系我们 * 客服 Telegram：[@CatFee\_James](https://t.me/CatFee_James) * 官网地址： *** 开始您的电报会员转卖业务，从此开启盈利之路！✨ # TRX闪兑业务 TRX 闪兑服务使用指南 CatFee 提供全自动的 USDT 兑换 TRX 服务。本文中的“您”指 CatFee 用户，也就是在 CatFee 开通并使用 TRX 兑换服务的人；“终端用户”指向您的收款地址打款、最终需要收到 TRX 的人。 您需要提前在 CatFee 账户中充值 TRX，并在 CatFee 用户中心设置自己的 USDT 收款地址和佣金率。之后，终端用户向您的收款地址打入 USDT，CatFee 会自动识别这笔转账、按实时汇率扣除您的 CatFee TRX 余额，并自动向终端用户转出 TRX。 整个过程不需要您手动给终端用户转 TRX，也不用人工计算实时汇率。您的收益按 USDT 佣金率计算，终端用户打款后，您直接赚取 USDT。 ### 角色说明 为了避免混淆，本文统一使用下面两个称呼： | 称呼 | 含义 | | ----------- | -------------------------------------------------- | | CatFee 用户、您 | 使用 CatFee TRX 兑换服务的人，需要在 CatFee 充值 TRX、设置收款地址和佣金率。 | | 终端用户 | 您服务的用户。他向您的 USDT 收款地址打款，并等待 CatFee 自动转出 TRX。 | ### 核心模式 CatFee 用户模式可以理解为： ``` 终端用户 -> 向您的 USDT 收款地址打款 CatFee -> 按实时汇率自动扣除您的 CatFee TRX 余额 CatFee -> 自动给终端用户转 TRX 您 -> 收到终端用户打来的 USDT，并赚取佣金差额 ``` 您需要做的事情只有三件： 1. 在 CatFee 提前充值 TRX 余额。 2. 在 CatFee 用户中心设置您的 USDT 收款地址。 3. 设置您的佣金率。 完成设置后，后续兑换流程全部由 CatFee 自动完成。 ### 使用步骤 #### 1. 在 CatFee 充值 TRX 您需要先在 CatFee 账户中准备足够的 TRX 余额。终端用户每发起一笔兑换，CatFee 会按当时的 TRX/USDT 实时价格，从您的账户余额中扣除本次兑换需要支付的 TRX。 扣款会先按 USDT 成本计算，再折算成 TRX： ``` 扣款 TRX = (终端用户转入 USDT - 您的佣金) / 实时 TRX 价格 ``` 所以，您的 CatFee 账户余额越充足，终端用户的兑换体验越稳定。 #### 2. 设置您的 USDT 收款地址 在 CatFee 用户中心设置一个 TRON 链 USDT 收款地址。这个地址是您自己的地址，终端用户会把 USDT 直接打到这个地址。 CatFee 会监控这个收款地址的链上入账。一旦发现终端用户打款，CatFee 会自动生成兑换订单。 默认情况下，CatFee 会把 TRX 转回终端用户付款的钱包地址。如果终端用户希望 TRX 转到另一个地址，可以在转账备注中填写目标 TRON 地址，CatFee 会优先向备注中的地址转出 TRX。 #### 3. 设置佣金率 佣金率是您赚取 USDT 的比例。 例如： | 佣金率 | 含义 | | ---- | -------------------------- | | `1%` | 终端用户每兑换 100 USDT，您赚 1 USDT | | `2%` | 终端用户每兑换 100 USDT，您赚 2 USDT | | `3%` | 终端用户每兑换 100 USDT，您赚 3 USDT | 如果通过接口设置，佣金率使用万分比： ``` 100 = 1% 200 = 2% 300 = 3% ``` ### 自动兑换流程 终端用户实际使用时，流程如下： ``` 1. 终端用户向您的 USDT 收款地址转入 USDT 2. 您的收款地址收到终端用户打来的 USDT 3. CatFee 自动识别这笔链上转账 4. CatFee 根据您的佣金率和实时价格计算应扣 TRX 5. CatFee 从您的 CatFee 账户扣除 TRX 余额 6. CatFee 自动把 TRX 转给终端用户 ``` 对终端用户来说，他只需要打 USDT，然后等待 TRX 到账。对您来说，整个过程不需要人工处理。 ### 收益举例 #### 示例 1：佣金率 1%，终端用户兑换 100 USDT 假设您设置的佣金率是 `1%`，终端用户向您的收款地址打入 `100 USDT`。 ``` 终端用户打款金额 = 100 USDT 您的佣金 = 100 * 1% = 1 USDT 扣款对应 USDT 成本 = 100 - 1 = 99 USDT 如果实时价格为 1 TRX = 0.1 USDT CatFee 扣您的余额 = 99 / 0.1 = 990 TRX ``` 结果： ``` 您的收款地址收到 100 USDT 您的 CatFee 余额扣除 990 TRX 您的实际收益 = 1 USDT CatFee 自动给终端用户转出 TRX ``` 这 1 USDT 是按 USDT 金额计算的，不会因为 TRX 实时价格波动而变少。 #### 示例 2：佣金率 2%，终端用户兑换 50 USDT 假设您设置的佣金率是 `2%`，终端用户向您的收款地址打入 `50 USDT`。 ``` 终端用户打款金额 = 50 USDT 您的佣金 = 50 * 2% = 1 USDT 扣款对应 USDT 成本 = 50 - 1 = 49 USDT 如果实时价格为 1 TRX = 0.1 USDT CatFee 扣您的余额 = 49 / 0.1 = 490 TRX ``` 结果： ``` 您的收款地址收到 50 USDT 您的 CatFee 余额扣除 490 TRX 您的实际收益 = 1 USDT CatFee 自动给终端用户转出 TRX ``` #### 示例 3：佣金率 3%，终端用户兑换 200 USDT 假设您设置的佣金率是 `3%`，终端用户向您的收款地址打入 `200 USDT`。 ``` 终端用户打款金额 = 200 USDT 您的佣金 = 200 * 3% = 6 USDT 扣款对应 USDT 成本 = 200 - 6 = 194 USDT 如果实时价格为 1 TRX = 0.1 USDT CatFee 扣您的余额 = 194 / 0.1 = 1940 TRX ``` 结果： ``` 您的收款地址收到 200 USDT 您的 CatFee 余额扣除 1940 TRX 您的实际收益 = 6 USDT CatFee 自动给终端用户转出 TRX ``` ### 为什么不用担心 TRX 价格变化 传统做法里，您可能需要自己判断价格、自己计算应该转多少 TRX、自己处理出款。如果 TRX 价格变化，利润可能会被波动吃掉。 CatFee 的用户模式不同： * 您的收益按 USDT 佣金率计算。 * 终端用户把 USDT 打到您的地址。 * CatFee 自动处理 TRX 出款。 * 您只需要保证 CatFee 账户中有足够 TRX。 * 您不需要手动操作兑换。 * 您不需要承担因为人工处理慢导致的价格波动风险。 简单说，您负责收 USDT、设置佣金率并保持 TRX 余额充足，TRX 出款交给 CatFee 自动完成。 ### 余额不足时会发生什么 如果您的 CatFee TRX 余额不足，CatFee 无法完成扣款，订单会进入失败状态，终端用户可能无法及时收到 TRX。 为了保证终端用户体验，建议您： * 保持 CatFee 账户 TRX 余额充足。 * 根据日常兑换量提前充值。 * 在活动或高峰时段前检查余额。 例如您设置 `1%` 佣金率，预计终端用户当天会兑换 `1,000 USDT`，且实时价格按 `1 TRX = 0.1 USDT` 估算，那么 CatFee 账户至少需要准备约 `9,900 TRX` 可用余额。 ### 推荐设置 新 CatFee 用户可以从较低佣金率开始，例如： ``` 1% - 2% ``` 如果终端用户对到账速度、稳定性和自动化体验更敏感，您可以根据服务价值适当提高佣金率。 ### 常见问题 #### 终端用户需要注册 CatFee 吗？ 不需要。终端用户只需要向您的收款地址转 USDT，CatFee 会根据链上入账自动处理。 #### 我需要给终端用户手动转 TRX 吗？ 不需要。CatFee 会自动给终端用户转 TRX。 #### 我需要提前准备 TRX 吗？ 需要。您需要在 CatFee 充值 TRX 余额，但不需要手动给终端用户转账。 #### 终端用户把 USDT 打到我的地址，为什么还要扣我的 CatFee 余额？ 因为终端用户的 USDT 是直接打到您的收款地址，CatFee 负责向终端用户支付 TRX。CatFee 扣除您的 TRX 余额，相当于您向 CatFee 支付本次 TRX 出款成本；终端用户打给您的 USDT 扣除这笔成本对应的 USDT 后，差额就是您的佣金收益。 #### 终端用户可以指定 TRX 接收地址吗？ 可以。如果终端用户转账备注中填写合法 TRON 地址，CatFee 会优先把 TRX 转到备注中的地址。否则，CatFee 默认把 TRX 转回终端用户付款地址。 # 区块链监控 CatFee 区块链监控服务可以帮助用户实时获取区块链数据的变化，如交易、余额、区块等。 🔗 该服务基于 CatFee 区块链网络，提供了多种接口和工具，支持BTC，ETH，TRON链，专业级监控服务，方便用户进行区块链数据的查询和分析。 ### 支持 URL接收回执 与 Telegram bot 通知
您可以通过以下方式接收 CatFee 区块链监控服务的回执通知： 1\. 您可以将您的回调 URL 发送给我们，我们将在区块链数据变化时向您发送通知。 2\. 您可以将您的 Telegram bot 与我们的服务绑定，我们将在区块链数据变化时向您发送通知。 **URL通知：** 当监测到区块链交易（如 USDT、ETH 等币种）的金额变动时，我们会通过您提供的回调 URL 向您推送通知信息。通知内容包含：交易哈希、区块编号、监测地址、付款地址、合约地址、收款地址、交易金额、币种、公链等重要信息。我们采用可靠的重发机制，确保通知送达： * 首次通知失败后，将按照特定时间间隔重新发送 * **🔔通知规则说明** ✅成功接收回调请求后，请返回 success 以通知服务器 🛑服务器收到 success 后，通知将立即停止 ⏱️未收到 success 时，将按以下频率发送10次通知： 0秒 → 15秒 → 30秒 → 3分钟 → 10分钟 → 20分钟 → 30分钟 → 60分钟 → 3小时 → 6小时 * 收到成功响应后立即终止重发 接收方只需返回字符串 'success' 即可确认收到通知，建议异步处理业务逻辑并使用 chain+txn\_hash 作为主键防重。\ \ API 使用示例 **请求方式** POST {您的回调URL} **请求参数（JSON）** ``` { "txn_hash": "0x1a2b3c4d5e...", // 交易哈希 "block_id": 123456789, // 区块编号 "name","我的钱包", // 地址昵称 "address": "T123456...", // 监测地址 "from_address": "T123456...", // 付款地址 "to_address": "T654321...", // 收款地址 "contract_address": "T888888...", // 合约地址 "amount": 1000000, // 原始金额 "decimals": 6, // 金额精度 "currency": "USDT", // 币种 "chain": "TRON", // 公链 "paid_at": 1684789012 // 交易时间戳 } ``` **响应示例** ``` "success" ``` **Node.js 接收示例** ``` const express = require('express'); const app = express(); app.use(express.json()); app.post('/webhook', async (req, res) => { try { const notification = req.body; // 使用 chain+txn_hash 作为主键防重 const key = `${notification.chain}-${notification.txn_hash}`; // 异步处理业务逻辑 process.nextTick(() => { processNotification(notification); }); // 立即返回成功响应 res.send('success'); } catch (error) { console.error('处理通知失败:', error); res.status(500).send('error'); } }); app.listen(3000, () => { console.log('Webhook 服务已启动'); }); ``` Telegram bot 通知\ 当监测到区块链交易（如 USDT、ETH 等币种）的金额变动时，我们将通过您的 Telegram bot 向您发送通知信息。\ \\
#### 使用步骤 1. 1 **申请机器人** * 打开Telegram，搜索并添加[【@BotFather】](https://t.me/BotFather) * 输入命令 /newbot 开始创建新机器人 * 按照提示设置机器人的名称和用户名 * 记录下生成的机器人token，这是后续绑定的关键 2. 2 **绑定机器人到Catfee** * 登录Catfee.io个人中心，选择机器人设置页面输入机器人的token * 点击"绑定"按钮，完成机器人绑定 * 绑定后同步开通能量售卖机器人，免费使用哦！ 3. 3 **配置机器人接收通知** * 将机器人添加到需要接收钱包监控变更消息的会话中 * 在Catfee.io个人中心中，选择"添加监控钱包" * 输入会话ID，确保机器人能正确接收通知 4. 4 **设置监控参数** * 在监控钱包页面，选择需要监听的区块链类型 * 输入需要监控的钱包地址 * 选择 \[Telegram bot] 类型，设置需要监听的区块链类型（BTC | ETH | TRON） * 设置会话ID，可以选择频道、群组或个人会话 \ **什么是 telegram 会话ID？** 会话ID 是用于标识 Telegram 用户、群组或频道的唯一数字标识符。个人用户的会话ID为正整数（如：8090000000），群组的会话ID为负整数（如：-4980000000）。 **会话ID 获取方法：** 1. 访问 Telegram 机器人：[@CatFeeProBot](https://t.me/CatFeeProBot) 2. 向机器人发送 `"/tools"` 命令 3. 在弹出的工具列表中选择会话ID查询工具 4. 机器人将返回当前会话的ID，例如： * 用户ID返回格式：用户ID:8090000000 （其中 8090000000 即为用户会话ID） * 群组ID返回格式：群组ID:-4980000000 （其中 -4980000000 即为群组会话ID） 通过以上步骤，您可以轻松实现区块链钱包的实时监控，确保不错过任何重要的余额变动。 区块链地址监控api的帮助教程可以点击这里查阅： # 波场节点连接指南 CatFee 提供稳定高效的 **TRON 节点租用服务**，支持通过 **gRPC + SSL 加密协议** 与 TRON 网络交互。\ 为开发者提供高可用、低延迟的基础设施支持，用于构建 DApp、钱包、或链上服务。 *** ### 📍 节点信息 | 项目 | 说明 | | ------------------- | ------------------------------------------- | | **节点域名（Node Host）** | 示例：`tron-demo-yourNodeId.catblockchain.com` | | **端口（Port）** | `443` | | **协议** | `gRPC over SSL (TLS 1.2+)` | | **认证方式** | HTTP Header `X-CATFEE-TOKEN: YOUR_API_KEY` | | **支持服务** | `wallet`、`walletsolidity`（均走同一端口） | > 💡 购买套餐后，可在控制面板 **【波场节点】 → 【套餐】** 中查看节点地址与密钥。\ > 💡 所有节点均启用 **TLS 加密**，默认监听端口 `443`。\ > 💡 支持自动续费功能，到期当天系统会自动续期，续费失败需手动操作。\ > ![](/files/hC7Ox8hQgRnTsQi4hbOt) *** ### ### 🌐 通信方式概览 CatFee 节点提供 TRON 官方标准的 gRPC 接口服务： | 服务名 | 用途 | | ------------------ | -------------------- | | **wallet** | 用于发起或查询未上链交易（未确认状态） | | **walletSolidity** | 用于读取已上链区块中的数据（已确认状态） | *** ### 🔒 SSL 加密通信说明 CatFee 节点 **仅支持加密连接**，要求客户端启用 **HTTP/2 + TLS**。\ 连接特性如下： | 特性 | 说明 | | -------------- | -------------------- | | **传输协议** | gRPC over HTTP/2 | | **加密标准** | TLS v1.2 / v1.3 | | **端口** | 443 | | **证书颁发机构（CA）** | 标准 CA 签发，无需自定义信任 | | **双向认证** | 默认单向认证（可选启用双向） | | **Header 认证** | 需携带 `X-CATFEE-TOKEN` | #### 客户端配置建议 1. **启用 SSL 验证**（不要使用 `createInsecure()` 或 `secure=False` 等参数） 2. **确认支持 HTTP/2**（旧版本 gRPC 库可能默认关闭） 3. **设置连接超时** 建议为 5–10 秒，避免 TLS 握手重试过多 4. **正确传递 Header**： * Key：`X-CATFEE-TOKEN` * Value：节点分配的 API 密钥 *** ### 📦 支持的主要接口 CatFee 节点支持 TRON 全部标准 gRPC 接口，包括但不限于： * `GetAccount` * `GetTransactionById` * `CreateTransaction` * `BroadcastTransaction` * `TriggerSmartContract` * `GetNow` * `GetBlockByNum` * 以及 TRON Protocol 中定义的所有常规服务接口。 参考官方文档：\ 🔗 *** ### ⚙️ 连接性能与限制 | 项目 | 限制 / 说明 | | ------------------ | --------------------- | | **协议要求** | gRPC over SSL（HTTP/2） | | **端口号** | 443 | | **Header 认证** | `X-CATFEE-TOKEN` | | **并发限制（标准版）** | 默认 20 req/s | | **延迟表现** | 平均 < 100ms（亚洲区域） | | **walletsolidity** | 仅返回已上链数据 | *** ### 💬 常见问题（FAQ） **Q1：是否支持非加密连接（明文 gRPC）？**\ A1：不支持。为保证数据安全与防止中间人攻击，所有节点均强制要求 SSL 加密通信。 *** **Q2：如何确认客户端是否启用了 SSL？**\ A2： * Python 客户端需传入 `secure=True` 或使用 `create_ssl_channel_credentials()` * Node.js 需使用 `grpc.credentials.createSsl()` * Java 需调用 `.useTransportSecurity()` 如果仍能使用明文端口连接，说明未启用 SSL，连接将被节点拒绝。 *** **Q3：使用自签名证书是否可行？**\ A3：无需自签名。CatFee 所有节点均采用有效的 CA 签发证书，可直接信任系统根证书链。 *** **Q4：gRPC over SSL 与 HTTPS 有何区别？**\ A4： * HTTPS 是基于 HTTP/1.1 的 REST 风格； * gRPC over SSL 是基于 HTTP/2 的二进制流通信； * gRPC 拥有更高的并发与更低延迟，适合持续数据交互场景。 *** **Q5：wallet 与 walletSolidity 有什么区别？**\ A5： * `wallet` 查询的是实时未确认交易（类似 mempool）； * `walletSolidity` 查询的是已经写入区块的数据，稳定性高。 一般建议： > 发起交易 → 使用 `wallet`\ > 查询结果 / 历史记录 → 使用 `walletSolidity` *** **Q6：连接返回 429 是什么意思？**\ A6：代表当前请求频率超出配额，请降低并发或升级节点套餐。 *** **Q7：是否支持双向 TLS 或 IP 白名单？**\ A7： * 默认启用单向 TLS，客户端验证服务端证书； * 如需双向 TLS 或 IP 限制访问，可联系 CatFee 技术团队定制。 *** **Q8：节点是否具备负载均衡与高可用？**\ A8：是的。`*.catblockchain.com` 域名下节点均由多台后端实例组成，自动负载均衡并具备多区域冗余。 *** ### 🧰 技术支持与联系方式 如需企业定制接入、提高并发额度或启用双向认证，请联系： * Telegram 技术支持：[**@CatFee\_James**](https://t.me/CatFee_James) * 官方网站：[https://catfee.io](https://catfee.io/) * 技术主页：[https://catfee.io/blockchain/tron-node](https://catfee.io/blockchain/tron-node/) *** ### ✅ 总结 **CatFee 波场节点服务**现全面升级至 `*.catblockchain.com` 域名体系，\ 统一采用 **gRPC over SSL (HTTP/2)** 安全通信。 它是 TRON 开发者首选的节点方案，具备： * 🔐 企业级安全（TLS 加密、认证接入） * ⚡ 低延迟访问（多地负载均衡） * 🧩 标准化接口（完全兼容 TRON Protocol） > 构建波场应用，从稳定安全的节点开始。 # 快速上手指南 本指南将帮助你在几分钟内完成 CatFee TRON Node 的接入与调用。 ### 一、获取访问凭证 在使用服务前，你需要获取 **TRON 节点专用的 API Key**（⚠️ 注意：不同于平台其他服务的 API Key）： #### 获取路径： **用户中心 → 波场节点 → 套餐 → 在列表中获取对应节点的 API 秘钥** > 📌 请确保使用的是“节点对应的 API Key”，否则会导致认证失败。 *** ### 二、连接节点 CatFee 提供基于 **gRPC + TLS（HTTPS/2）** 的安全连接方式： * **协议**：gRPC（HTTP/2） * **端口**：443 * **安全要求**：必须启用 TLS（SSL） * **请求头认证**： ``` X-CATFEE-TOKEN: YOUR_API_KEY ``` *** ### 三、选择服务接口 TRON 节点提供两个核心服务： * **wallet** * 用于查询未确认交易 * 实时性更高 * **walletSolidity** * 用于查询已确认链上数据 * 数据更稳定可靠 👉 一般建议： * 查余额 / 状态 → 使用 `walletSolidity` * 发送交易 / 实时查询 → 使用 `wallet` *** ### 四、发起第一个请求 以下是一个示例流程（以查询账户为例）： #### 1. 建立 gRPC 连接 * 使用支持 HTTP/2 的 gRPC 客户端 * 启用 TLS * 设置请求头 `X-CATFEE-TOKEN` #### 2. 调用接口 常用方法： * `GetAccount` → 查询账户信息 * `CreateTransaction` → 创建交易 * `BroadcastTransaction` → 广播交易 * `TriggerSmartContract` → 调用智能合约 *** ### 五、最佳实践 * ⏱ **超时设置**：建议 5–10 秒 * 🔐 **安全性**：不要暴露 API Key，建议配合 IP 白名单使用 * 🚀 **性能优化**： * 合理控制请求频率（RPS） * 根据业务选择合适套餐 * 🔁 **重试机制**： * 对偶发失败请求进行指数退避重试 *** ### 六、常见问题排查 * ❌ **连接失败** * 检查是否启用 TLS * 确认客户端支持 HTTP/2 * ❌ **认证错误** * 确认 `X-CATFEE-TOKEN` 是否正确 * 确认是否使用了“节点对应的 API Key”（不是其他服务的 Key） * 检查是否启用了 IP 白名单限制 * ❌ **请求超时** * 调整 timeout 设置 * 检查网络延迟或节点负载 *** ### 七、下一步 * 查看完整 API 文档 * 根据业务选择合适[套餐（Pricing Plans）](/getting-started/tron-node-guide/pricing-plan) * 在生产环境中启用监控与告警 *** 完成以上步骤后，你就可以开始构建基于 TRON 的 DApp 或区块链服务了 🚀 # 套餐价格 本页面介绍 CatFee TRON Node 服务的套餐价格与资源配置，适用于不同规模的 DApp 和区块链应用。 ### 套餐总览 我们提供六种套餐，覆盖从初创项目到企业级业务的不同需求，均包含以下基础能力： * 支持 **gRPC 协议** * 支持 **IP 白名单** * 提供 **7×24 技术支持** *** ### 套餐详情 #### **Build** 适合早期项目或轻量级使用场景 * **$19.9 / 月** * **$0.66 / 百万次调用** * 每月 30M 次 API 调用 * 20 RPS *** #### **Accelerate** 适合增长中的应用与中等流量需求 * **$49.9 / 月** * **$0.59 / 百万次调用** * 每月 85M 次 API 调用 * 50 RPS *** #### **Scale** 适合需要更高吞吐量的扩展型应用 * **$149.9 / 月** * **$0.56 / 百万次调用** * 每月 270M 次 API 调用 * 100 RPS *** #### **Business** 适合生产环境与成熟平台 * **$399.9 / 月** * **$0.53 / 百万次调用** * 每月 750M 次 API 调用 * 200 RPS *** #### **Premium** 适合高并发、高性能需求的应用 * **$499.9 / 月** * **$0.50 / 百万次调用** * 每月 1000M 次 API 调用 * 300 RPS *** #### **Enterprise** 适合大规模系统与企业级业务 * **$999.9 / 月** * **$0.40 / 百万次调用** * 每月 2500M 次 API 调用 * 500 RPS *** ### 选择建议 * **Build / Accelerate**：适合开发测试、早期 DApp 或低流量应用 * **Scale / Business**：适合进入增长期、对稳定性和吞吐有更高要求的项目 * **Premium / Enterprise**：适合高并发、大规模生产环境或企业级业务 *** ### 说明 * 超出套餐调用量后，将按对应单价计费 * 如需更高定制化能力（如专属节点、私有部署等），请联系商务支持 # API常见问题 #### **1. 账户与权限相关问题** **1.1 为什么我的 API 密钥无法使用？** * **原因**： * API 密钥可能已被禁用或删除。 * **解决方案**： 1. 登录 CatFee官网，检查您的 API 密钥状态是否有效。 **1.2 如何为 API 密钥启用仅特定 IP 访问？** * **解决方案**： 在创建或编辑 API 密钥时，填写您想绑定的 IP 地址。这样，API 密钥仅允许来自该 IP 地址的请求，提升安全性。 *** #### **2. 签名与身份验证问题** **2.1 为什么返回 `401 Unauthorized`？** * **原因**： * `CF-ACCESS-KEY`、`CF-ACCESS-SIGN` 错误。 * 签名生成不正确。 * 时间戳偏差超过 5 秒。 * **解决方案**： 1. 确保 `CF-ACCESS-KEY`、`CF-ACCESS-PASSPHRASE` 与创建 API 密钥时一致。 2. 确保签名按照 CatFee 签名规则 生成，并验证生成逻辑。 3. 确保 `CF-ACCESS-TIMESTAMP` 是标准的 UTC 时间戳，且与服务器时间偏差小于 5 秒。 **2.2 签名生成如何检查？** * **解决方案**： 1. 打印拼接的待签名字符串（`timestamp + method + requestPath`）。 2. 对比生成的签名和本地手动计算的签名是否一致。 3. 如果有疑问，可以使用 Postman 或 Curl 手动测试签名。 *** #### **3. 请求与响应问题** **3.1 为什么返回 `400 Bad Request`？** * **原因**： * 请求参数错误（如缺少必填字段或字段值不正确）。 * 接口路径错误。 * **解决方案**： 1. 检查接口文档，确保请求参数和路径准确。 2. 验证请求头中的 `Content-Type` 是否设置为 `application/json`。 3. 检查提交的数据格式是否为 JSON 格式。 **3.2 为什么返回 `429 Too Many Requests`？** * **原因**： * 请求频率超过了 API 限制。 * **解决方案**： 1. 阅读 API 文档，了解接口的速率限制（如每秒请求次数上限）。 2. 在代码中实现请求节流（例如每秒发送的请求数控制在限制范围内）。 3. 使用分布式请求时，确保所有请求的总频率不超过限制。 **3.3 为什么返回 `500 Internal Server Error`？** * **原因**： * API 服务端可能存在临时问题。 * **解决方案**： 1. 检查网络连接，确保请求已成功发送。 2. 稍等几秒后重试。 3. 如果问题持续，请联系 CatFee 技术支持。 *** #### **4. 特定接口问题** **4.1 为什么无法成功下单？** * **原因**： * 账户余额不足。 * 订单参数不正确（如价格或数量）。 * 账户未启用对应交易权限。 * **解决方案**： 1. 检查账户余额是否充足。 2. 确保订单参数（如数量、周期）符合最小下单规则（参考文档中 "创建订单" 部分）。 *** **4.2 如何确定购买能量成功到账** 1. **购买能量**之后记录返回值**id（支付哈希/订单 ID），其中**status=TRANSFER\_SUCCESS表示下单成功，通常下单成功之后6秒内能量到账 2. **通过订单详情`/v1/order/{id}`**查询该获取订单状态status，值通常如下 * TRANSFER\_SUCCESS 下单成功 * DELEGATE\_SUCCESS 代理成功 * RECLAIM\_SUCCESS 回收成功 当 `status` 为 `DELEGATE_SUCCESS` 时，表示能量交易已成功提交到波场区块链。注意：存在极小概率（约 0.1%）交易未能上链的情况 3. **链上确认状态**通过订单的详细信息**`/v1/order/{id}`**查询该获取订单确认状态**confirm\_status** 当 `confirm_status` 为 `DELEGATION_CONFIRMED` 时，表示能量已100%成功发送并在链上确认 **4.3 为什么有些订单完成时间会比较长** * 波场存在极小概率（约 0.1%）交易未能上链的情况，平台检测到交易未能上链会自动补发能量 * 当平台能量极度紧张的时候，平台发送能量会有一定延迟 #### **5. 开发与调试问题** **5.1 如何处理超时问题？** * **原因**： * 网络延迟或连接不稳定。 * **解决方案**： 1. 设置较长的请求超时时间（如 `timeout=30`）。 2. 对重要操作实现重试机制（如重试 2-3 次）。 3. 检查本地网络与 CatFee API 的连通性。 **5.2 如何解析 API 响应？** * **解决方案**： CatFee API 响应通常为 JSON 格式，结构如下： ```json json复制代码{ "code": "0", "msg": "", "data": { "key": "value" } } ``` * `code: 0` 表示成功，非 0 表示错误。 * `data` 是返回的主要内容，通过解析 JSON 获取具体数据。 *** #### **6. 其他问题** **6.1 为什么时间戳经常出错？** * **原因**： 本地时间与 UTC 时间不同步。 * **解决方案**： 使用 Python 的 `datetime.utcnow()` **6.2 如何处理 API 升级？** * **解决方案**： 1. 订阅 CatFee 的开发者公告，了解 API 的最新变化。 2. 定期更新您的代码以适配新版本 API。 3. 使用版本控制（如 `v1`）避免因升级导致兼容性问题。 *** #### **7. 联系支持** 如果您无法解决问题，请通过以下方式联系 CatFee 技术支持： * 提交工单：CatFee支持中心 * 开发者文档：[API 官方文档](/getting-started/buy-energy-via-api-on-catfee/api-overview) *** 通过本 FAQ，希望能帮助您快速解决 CatFee API 使用中的常见问题！ # 服务条款
欢迎使用 CatFee.IO（以下简称“本网站”或“我们”）提供的服务。在访问或使用我们的服务前，请仔细阅读以下服务条款（以下简称“本条款”）。您访问、使用本网站即表示您同意受本条款的约束。如果您不同意这些条款，请勿使用我们的服务。 ### 1. 接受条款 通过访问或使用本网站提供的服务，您确认您已年满18周岁，并具有完全的法律行为能力签订具有约束力的协议。同时，您承认并同意接受本条款及我们的 **隐私政策** 的约束。 ### 2. 服务内容 CatFee.IO 提供了一套用于资源访问和加密资产交易的 API 和其他相关服务，包括但不限于购买能量、资源租赁等功能（统称“服务”）。 * 我们保留随时修改、暂停或终止服务的权利，无需提前通知您。 * 本网站提供的服务仅用于合法用途，用户不得使用本服务从事任何非法活动。 ### 3. 用户责任 * **注册和账户安全**\ 您有责任保护您的账户信息，包括但不限于 API 密钥和密码。任何通过您的账户发生的操作均视为您本人行为，您应承担全部责任。 * **合法合规**\ 您承诺仅在法律允许的范围内使用我们的服务，不得使用服务从事任何欺诈、洗钱、数据盗窃等违法活动。 * **准确性**\ 您需确保您在使用服务时提供的所有信息真实、准确且完整。 ### 4. 风险声明 使用 CatFee.IO 服务涉及一定风险，包括但不限于： * 加密资产价格波动导致的损失； * 技术故障、黑客攻击或其他不可控因素造成的服务中断； * 用户操作失误（如输入错误地址）导致的资产损失。\ 我们强烈建议您在操作前充分了解相关风险，并在能力范围内谨慎操作。 ### 5. 费用及支付 * CatFee.IO 将收取一定的费用作为提供服务的成本，具体收费标准以我们官网或公告为准。 * 您在使用服务时需自行承担区块链网络手续费（如 TRX 燃烧费用）。 * 付款下单一旦能量成功发出交易完成后，不支持退款与撤回交易。 ### 6. 知识产权 * CatFee.IO 平台及其提供的所有内容、服务和技术均受知识产权法律保护，您不得未经授权使用、复制、修改或分发。 * 用户对通过我们的服务生成的自定义数据和内容享有所有权，但授权我们为提供服务之目的使用该内容。 ### 7. 限制责任 在法律允许的最大范围内，CatFee.IO 对于因以下情况造成的直接或间接损失不承担责任： * 服务中断或不可用； * 因用户提供的错误信息导致的交易失败； * 第三方未经授权访问或使用用户账户。 ### 8. 终止服务 我们保留在任何时间暂停或终止向任何用户提供服务的权利，尤其在您违反本条款或适用法律时。 ### 9. 条款的修改 我们可能会不时更新本条款，并通过在本网站上发布修订后的版本通知您。修订后的条款自发布之日起生效。若您在条款更新后继续使用服务，则视为您接受修订后的条款。 ### 10. 适用法律和争议解决 本条款受相关国家或地区的法律管辖。如发生争议，双方应友好协商解决；协商不成时，可提交至我们所在地的仲裁机构处理。 ### 11. 联系我们 如有任何疑问或需进一步了解，请通过以下方式联系我们： * **官网地址**：[https://catfee.io](https://catfee.io/) * **电报：**[https://t.me/CatFee\_James](https://t.me/CatFee_james) * **Whatsapp：** * **支持邮箱**： * **客服投诉：**\ # 简介 快速了解 CatFee 无感能量是什么、如何工作，以及使用中的常见问题。 ## 什么是无感能量？ 无感能量是 CatFee 提供的 **TRON 交易广播增强服务**，支持自动准备 **ENERGY（能量）** 和 **BANDWIDTH（带宽）**。 钱包或应用只需将已签名交易发送到无感能量节点，系统便会根据交易需要准备相应资源，再将原交易广播到 TRON 网络。 简单来说：**您照常发起交易，系统自动准备能量或带宽。** * 不需要提供私钥或助记词 * 不会修改交易地址、金额或合约参数 * 不会改变原有签名流程 * 支持合约交易和需要带宽的交易 {% hint style="info" %} 无感能量不是钱包或代签服务，而是一个能够在广播前自动准备能量和带宽的 TRON 节点。 {% endhint %} ## 工作原理 1. **本地签名**：钱包或应用在本地构造并签名交易。 2. **发送交易**：将已签名交易发送到 CatFee 无感能量节点。 3. **准备资源**：节点识别交易所需资源，为交易发起地址准备 ENERGY 或 BANDWIDTH。 4. **广播上链**：资源准备完成后，节点将原交易原样广播到 TRON 网络。 5. **返回结果**：应用按照原有方式接收交易广播结果。 接入时通常只需替换交易的**广播节点域名**，原有交易内容、签名方式和广播接口保持不变。 ## 常见问题 * **支持哪些资源？**\ 支持 ENERGY（能量）和 BANDWIDTH（带宽），系统会根据交易类型和资源需求进行处理。 * **需要提供私钥吗？**\ 不需要。交易仍由您的钱包或应用在本地签名，CatFee 只接收和处理已签名交易。 * **CatFee 会修改交易吗？**\ 不会。已签名交易一旦被修改，签名就会失效，CatFee 会原样转发交易。 * **能量和带宽有什么区别？**\ ENERGY 主要用于执行 TRC20 转账、授权等智能合约交易；BANDWIDTH 主要用于支付交易数据上链所需的网络资源。 * **所有 TRON 请求都要使用无感能量节点吗？**\ 不需要。无感能量主要作用于**已签名交易的广播阶段**，查询余额、区块和交易等请求不会准备资源。 * **CatFee 余额不足时会怎样？**\ 可选择跳过资源准备并继续广播，或停止广播并返回余额不足错误。 * **资源准备完成后，交易一定成功吗？**\ 不一定。交易仍可能因账户余额不足、授权额度不足、合约执行失败或网络波动等原因失败。 * **如何开始使用？**\ 开发者可查看[API 接入](/seamless-energy/api-integration)，钱包用户可查看[钱包接入](/seamless-energy/wallet-integration)。 更多信息请查看[安全说明](/seamless-energy/security)和[常见问题](/seamless-energy/faq)。 # API 接入 只需更换 TRON 交易广播节点域名，即可接入 CatFee 无感能量。 接入无感能量很简单：**将原 TRON 广播节点的域名替换为 CatFee 无感能量节点域名。** 交易签名、接口路径、请求方式和请求体都不需要修改。 ## 一眼看懂 假设原广播地址是： ```http https://api.trongrid.io/wallet/broadcasttransaction ``` 接入后改为： ```http https://{NodeSlug}.catfee.vip/wallet/broadcasttransaction ``` 只更换前面的节点域名： ```diff - https://api.trongrid.io + https://{NodeSlug}.catfee.vip ``` 后面的广播路径保持不变： ``` /wallet/broadcasttransaction ``` {% hint style="info" %} 如果您的系统可以单独配置广播节点，只需更换广播节点域名；查询余额、区块和交易等接口可以继续使用原节点。 {% endhint %} ## 接入步骤 1. 在 CatFee 用户中心申请无感能量节点。 2. 获取专属节点域名，例如 `https://{NodeSlug}.catfee.vip`。 3. 将已签名交易的广播节点域名替换为该域名。 4. 发起一笔小额交易进行验证。 完成以上步骤后，无感能量节点会根据交易需要自动准备 ENERGY（能量）或 BANDWIDTH（带宽），再将原交易广播到 TRON 网络。 ## HTTP 接入 ### JSON 格式交易 ```http POST https://{NodeSlug}.catfee.vip/wallet/broadcasttransaction ``` ### Hex 格式交易 ```http POST https://{NodeSlug}.catfee.vip/wallet/broadcasthex ``` 接口路径和请求体均保持 TRON 原格式。 ## 请求示例 ```bash curl -X POST "https://{NodeSlug}.catfee.vip/wallet/broadcasttransaction" \ -H "Content-Type: application/json" \ -H "CF-NODE-KEY: {AccessKey}" \ -d '{ "raw_data_hex": "...", "signature": ["..."] }' ``` 使用 API KEY 鉴权时，需要增加以下请求头： ```http CF-NODE-KEY: {AccessKey} ``` 如果使用绑定地址或不鉴权模式，则不需要添加该请求头。 ## gRPC 接入 gRPC 的接入方式同样简单：**将原 TRON gRPC 服务地址替换为无感能量节点地址**，原有 Protobuf 定义、交易签名和广播方法保持不变。 {% hint style="warning" %} 标准无感能量 gRPC API 节点 `{NodeSlug}.catfee.vip:443` 只能通过 SSL/TLS 调用。TronLink App 手机版使用专用的明文 gRPC 节点 `{NodeSlug}.catfee.pro:50051`，请参考[钱包接入](/seamless-energy/wallet-integration)。 {% endhint %} ``` 服务器：{NodeSlug}.catfee.vip 端口：443 SSL/TLS：开启 广播方法：/protocol.Wallet/BroadcastTransaction ``` 配置示例： ```yaml target: "{NodeSlug}.catfee.vip:443" tls: true method: "/protocol.Wallet/BroadcastTransaction" ``` 使用 API KEY 鉴权时，在 gRPC metadata 中增加： ``` CF-NODE-KEY: {AccessKey} ``` 如果使用绑定地址或不鉴权模式，则不需要添加该 metadata。 接入前后只有服务地址发生变化： ```diff - 原 TRON gRPC 服务地址 + {NodeSlug}.catfee.vip:443 ``` 已有的 Stub、已签名交易对象和 `BroadcastTransaction` 调用逻辑可以继续使用。 ## 接入前后对比 | 项目 | 接入前 | 接入后 | | --------- | -------------- | --------------------------- | | 节点域名 | 原 TRON 节点域名 | `{NodeSlug}.catfee.vip` | | gRPC 服务地址 | 原 TRON gRPC 地址 | `{NodeSlug}.catfee.vip:443` | | HTTP 广播路径 | 保持原样 | 保持原样 | | gRPC 广播方法 | 保持原样 | 保持原样 | | 请求体 | 保持原样 | 保持原样 | | 交易签名 | 本地完成 | 本地完成 | | 资源准备 | 自行处理 | 自动准备能量或带宽 | ## 注意事项 * 发送给无感能量节点的交易必须已经签名。 * CatFee 不需要也不会获取您的私钥或助记词。 * 请勿修改原交易的地址、金额、签名或合约参数。 * 建议先用小额交易完成验证，再切换正式流量。 需要了解异常处理，请查看[常见问题](/seamless-energy/faq)。 # 钱包接入 了解钱包如何接入 CatFee 无感能量，以及不同钱包应如何选择节点和鉴权方式。 ## 整体说明 只要钱包支持自定义 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) * 使用 TokenPocket App 手机版：查看[TokenPocket App 设置](/seamless-energy/wallet-integration/tokenpocket-setup) * 使用其他支持自定义节点的钱包：参照本页的节点和鉴权说明进行配置 * 通过后端统一广播：查看[API 接入](/seamless-energy/api-integration) * 需要了解安全边界：查看[安全说明](/seamless-energy/security) # TronLink App 设置 在 TronLink App 手机版中配置 CatFee 无感能量明文 gRPC 节点，并完成首次交易验证。 TronLink App 手机版支持配置自定义 TRON 节点。将 CatFee 无感能量节点设为当前节点后，钱包仍在本地签名，节点会根据交易需要准备 ENERGY（能量）或 BANDWIDTH（带宽），再广播原交易。 {% hint style="warning" %} TronLink App 手机版仅支持明文 gRPC 节点。请使用 `{NodeSlug}.catfee.pro` 和端口 `50051`，不要开启 SSL/TLS。 {% endhint %} ## 设置前准备 在 CatFee 用户中心打开“无感能量”，确认： * 节点已经启用 * 已取得节点标识 `{NodeSlug}` * 已选择“绑定地址”鉴权 * 当前 TronLink 钱包地址已经绑定到该节点 普通钱包用户建议使用绑定地址鉴权，因为 TronLink App 无需额外传递 `CF-NODE-KEY`。 ## 设置步骤 ### 1. 打开“我的” 打开 TronLink App，点击底部的**我的**，然后点击**偏好设置**。
TronLink App 我的页面

进入“我的”，点击“偏好设置”

### 2. 打开“切换节点” 在偏好设置页面找到“网络设置”，点击**切换节点**。
TronLink App 偏好设置中的切换节点入口

在“网络设置”中点击“切换节点”

{% hint style="info" %} 请确认当前操作的是 TRON 网络节点，不要误选 Ethereum、BSC、BTTC 等 EVM 网络配置。 {% endhint %} ### 3. 添加自定义节点 进入节点列表后，点击页面底部的**添加自定义节点**。
TronLink App 首次进入切换节点页面

首次进入时没有 CatFee 节点，点击底部的“添加自定义节点”

### 4. 填写节点信息 在“添加自定义节点”页面填写： ``` 节点 IP 或域名：{NodeSlug}.catfee.pro 节点端口：50051 ``` 域名不要添加 `http://` 或 `https://`，端口单独填写 `50051`。
TronLink App 添加自定义节点页面

填写节点域名和端口，然后点击“确认”

### 5. 选择自定义节点 点击**确认**后返回节点列表，找到刚刚添加的 `.catfee.pro` 自定义节点，点击右侧的选择按钮完成切换。 被选中的节点右侧会显示选中标记。可以通过列表中的域名和端口 `50051` 确认当前节点。
TronLink App 添加 CatFee 节点后的列表

添加完成后，选择新出现的 CatFee 自定义节点

切换节点不会改变钱包地址和资产，交易仍由 TronLink App 在本地签名。 ### 6. 发起小额测试交易 建议先进行一笔小额交易： * 小额 TRC20 转账，用于验证 ENERGY 准备 * 小额 TRX 转账，用于验证 BANDWIDTH 准备 确认交易可以正常签名、广播并上链后，再用于日常交易。 ## 如何确认设置成功 * TronLink App 当前使用的是 CatFee 无感能量节点 * 钱包签名流程与原来一致 * 交易可以正常广播并返回结果 * CatFee 用户中心可以看到对应的资源处理或消耗记录 ## 常见问题 * **节点地址应该填写 `https://` 吗？**\ 不需要。TronLink App 使用明文 gRPC，请填写 `{NodeSlug}.catfee.pro` 和端口 `50051`。 * **需要开启 SSL/TLS 吗？**\ 不需要，也不能开启。TronLink App 专用节点使用明文 gRPC。 * **需要填写 API KEY 吗？**\ 使用绑定地址鉴权时不需要，请确保当前钱包地址已在 CatFee 用户中心绑定。 * **切换节点会泄露私钥吗？**\ 不会。私钥仍保存在 TronLink App 中，发送给节点的是已经签名的交易。 * **交易测试失败怎么办？**\ 检查节点是否启用、域名和端口是否正确、SSL/TLS 是否关闭、钱包地址是否已绑定，以及 CatFee 余额是否充足。 返回查看[钱包接入](/seamless-energy/wallet-integration)，或查看[安全说明](/seamless-energy/security)了解私钥和交易安全边界。 # TokenPocket App 设置 在 TokenPocket 手机版中配置 CatFee 无感能量 HTTPS 节点，并完成首次交易验证。 TokenPocket 手机版支持配置自定义 TRON 节点。选择 CatFee 无感能量节点后，钱包仍在本地签名，节点会根据交易需要准备 ENERGY（能量）或 BANDWIDTH（带宽），再广播原交易。 {% hint style="warning" %} TokenPocket 使用无感能量 HTTPS 节点。请填写完整地址 `https://{NodeSlug}.catfee.vip`，不要使用为 TronLink 手机版提供的明文 gRPC 地址。 {% endhint %} ## 设置前准备 在 CatFee 用户中心打开“无感能量”，确认： * 节点已经启用 * 已取得 HTTPS 节点地址 `https://{NodeSlug}.catfee.vip` * 已选择“绑定地址”鉴权 * 当前 TokenPocket 钱包地址已经绑定到该节点 建议使用绑定地址鉴权，因为 TokenPocket 的自定义节点页面只需要填写节点名称和 URL，没有填写 `CF-NODE-KEY` 的位置。 ## 设置步骤 ### 1. 打开“我的” 打开 TokenPocket App，点击底部的**我的**，然后点击**使用设置**。
TokenPocket App 我的页面

进入“我的”，点击“使用设置”

### 2. 打开“节点设置” 在使用设置页面点击**节点设置**。
TokenPocket App 使用设置中的节点设置入口

在“使用设置”页面点击“节点设置”

### 3. 添加自定义 TRON 节点 确认页面标题为**波场**，然后点击底部的**添加自定义节点**。
TokenPocket App 添加自定义节点前的波场节点页面

在“波场”节点页面点击“添加自定义节点”

{% hint style="info" %} 请确认添加的是 TRON（波场）网络节点。其他网络的自定义节点不能用于广播 TRON 交易。 {% endhint %} ### 4. 填写节点信息 在“添加自定义节点”窗口填写： ``` 节点名称：CatFee 节点 URL：https://{NodeSlug}.catfee.vip ``` 必须填写包含 `https://` 的完整 URL。TokenPocket 使用该 HTTPS 地址时，不需要单独填写端口。 阅读 TokenPocket 的安全提醒，并确认 URL 与 CatFee 用户中心显示的节点地址一致，然后点击**确定添加**。
TokenPocket App 添加自定义节点窗口

填写节点名称和完整的 CatFee HTTPS 节点地址，然后点击“确定添加”

### 5. 选择自定义节点 添加完成后，在“自定义节点”中找到 **CatFee**。当前节点右侧会显示选中标记；如果尚未选中，请点击该节点完成切换。 还可以通过列表中的节点名称和 `.catfee.vip` 地址确认所选节点。
TokenPocket App 添加 CatFee 节点后的波场节点页面

选择新添加的 CatFee 自定义节点

切换节点不会改变钱包地址和资产，交易仍由 TokenPocket 在本地签名。 ### 6. 发起小额测试交易 建议先进行一笔小额交易： * 小额 TRC20 转账，用于验证 ENERGY 准备 * 小额 TRX 转账，用于验证 BANDWIDTH 准备 确认交易可以正常签名、广播并上链后，再用于日常交易。 ## 如何确认设置成功 * TokenPocket 中的 CatFee 自定义节点显示为已选中 * 钱包签名流程与原来一致 * 交易可以正常广播并返回结果 * CatFee 用户中心可以看到对应的资源处理或消耗记录 ## 常见问题 * **节点地址需要包含 `https://` 吗？**\ 需要。请填写完整地址：`https://{NodeSlug}.catfee.vip`。 * **需要填写端口吗？**\ 不需要。TokenPocket 直接使用完整的 HTTPS URL，不需要为该节点单独填写端口。 * **需要填写 API KEY 吗？**\ 使用绑定地址鉴权时不需要，请确保当前 TokenPocket 钱包地址已在 CatFee 用户中心绑定。 * **TokenPocket 的安全提醒是什么意思？**\ 自定义节点可以看到通过它发送的公开交易内容。请只使用从 CatFee 用户中心取得的节点地址，并在添加前核对 URL。 * **切换节点会泄露私钥吗？**\ 不会。私钥仍保存在 TokenPocket 中，发送给节点的是已经签名的交易。 * **交易测试失败怎么办？**\ 检查节点是否启用、HTTPS 地址是否完整、CatFee 节点是否已选中、钱包地址是否已绑定，以及 CatFee 余额是否充足。 返回查看[钱包接入](/seamless-energy/wallet-integration)，或查看[安全说明](/seamless-energy/security)了解私钥和交易安全边界。 # 安全说明 了解 CatFee 无感能量节点的安全模型、节点能看到什么、节点无法做什么，以及节点域名和 AccessKey 的保护方式。 您的钱包本身仍然是安全的。\ 最常见的问题是：“我是不是把资金访问权交给了第三方？” 答案是否定的。 这不是“你要不要信任 CatFee”的问题，而是 TRON 加密签名机制本身决定的：**无论是谁运行自定义节点，都无法直接拿到您的私钥，也不能在不破坏签名的前提下修改您的交易。** ## TRON 交易实际是怎么工作的 这一点值得理解一次，因为它适用于您以后使用的每一个 TRON 节点： 1. 您的钱包先构造一笔交易，包括收款人、金额、合约调用等信息。 2. 您的钱包在本地使用保存在设备上的私钥对交易进行签名。 3. 签名后的交易才会被发送到节点，由节点继续广播到 TRON 网络。 4. TRON 网络会验证签名；如果签名被篡改，交易会被直接拒绝。 关键点在这里：**签名发生在交易到达任何节点之前。** 当无感能量节点看到您的交易时，这笔交易已经带有只能由您的私钥生成的加密签名。节点拿到的是“已经签完名的交易”，而不是您的私钥。 ## 可以把它理解成一份已经盖章的指令单 您先在本地写好一份指令单，也就是交易内容；\ 然后用只有您自己持有的私钥完成签名，这相当于盖上一个只能由您本人生成的电子印章；\ 最后再把这份已经盖章的指令单交给节点去广播。 节点负责把这份指令单送到 TRON 网络，但不能替您重写内容，也不能自己重新盖章。\ 如果节点擅自改动收款人、金额或合约参数，原有签名就会立刻失效，网络也不会接受这份交易。 ## 节点能看到什么，不能看到什么 | 内容 | 节点是否可见 | 原因 | | ----------------- | ------ | -------------------------------- | | 您的公开地址 | 是 | 节点需要知道交易由哪个地址发起，并据此进行资源准备或绑定地址校验 | | 交易详情（收款人、金额、合约调用） | 是 | 它们本来就是已签名交易数据的一部分 | | 您的私钥 | 否 | 私钥不会被传输，签名在本地完成 | | 您的助记词 | 否 | 助记词不会被传输，只保存在您的钱包或设备中 | | 您钱包里的其他账户 | 否 | 节点只会看到您实际广播的那笔交易涉及的地址 | ## 节点无法做什么 ### 提取您的私钥 您的私钥不会发送给无感能量节点。\ 无论是 CatFee，还是其他任何 TRON 节点服务，只要走正常广播流程，都不会看到您的私钥。这是 TRON 以及其他区块链共同的基本工作方式。 ### 修改您的交易 节点不能在不破坏签名的前提下修改您的原交易。\ 哪怕只改动已签名交易中的一个关键字节，加密签名都会失效，TRON 网络也会拒绝该交易。 ### 代表您发送交易 节点不能代表您创建一笔属于您账户的有效交易。\ 要让交易以您的地址发出，必须重新使用您的私钥签名，而节点没有您的私钥。 ### 访问您的其他代币或余额 无感能量节点只处理您明确广播出去的那笔已签名交易。\ 它没有机制去“顺带”访问您账户中的其他代币、TRX 余额或额外权限，也不能脱离您的签名对账户发起其他操作。 ## 无感能量节点和默认节点相比，有什么区别 从安全模型上看，无感能量节点和任何公共 TRON 节点本质上是一样的。\ 区别只在于：**原交易被转发之前，CatFee 会先为符合条件的交易准备 ENERGY。** | 能力或属性 | 默认节点 | 无感能量节点 | | --------------- | ------------------- | -------------------------- | | 可以看到您已签名的交易 | 是 | 是 | | 可以访问您的私钥 | 否 | 否 | | 可以修改您的交易 | 否 | 否 | | 可以代替您发起新交易 | 否 | 否 | | 可以在广播前准备 ENERGY | 否 | 是 | | 通信方式 | HTTPS / TRON 标准节点协议 | HTTPS / gRPC / TRON 标准广播接口 | 相同的安全模型，相同的加密边界。\ 无感能量只是比默认节点多了一步：在转发原交易之前，先为您的地址准备资源。 ## 内置保护措施 ### 节点域名和 AccessKey 应该保密 无感能量节点的访问域名和 AccessKey 都与您的会员余额和节点权限相关，应当按凭证管理。 请把它们当作 API 密钥来对待： * 不要在公开渠道、公开仓库或截图中分享 * 不要写死在前端源码或浏览器包中 * 后端服务建议放在环境变量或密钥管理系统里 * 如果怀疑泄露，应立即停用节点或重置 AccessKey 如果您使用的是 API KEY 模式，调用时会使用： ```http CF-NODE-KEY: {AccessKey} ``` ### 绑定地址可以降低被盗刷风险 如果您发送交易的地址范围相对固定，建议启用绑定地址模式。\ 这样即使节点域名暴露，也不是任何地址都能继续触发资源准备。 这类模式尤其适合： * 普通钱包用户 * 不支持自定义 Header 的钱包 * 仅使用固定 owner 地址的一体化应用 ### 不鉴权模式只适合临时测试 不鉴权模式配置最简单，但风险也最高。\ 只要知道节点域名且节点已启用，请求就有机会继续处理。 因此它只适合： * 临时联调 * 受控测试环境 * 明确接受开放访问风险的内部场景 ## 如果节点域名或 AccessKey 泄露了怎么办 如果怀疑节点域名或 AccessKey 已暴露，建议按下面顺序处理： 1. 立即在 CatFee 用户中心停用该节点。 2. 确认泄露的是节点域名、AccessKey，还是两者都已泄露。 3. 如果使用绑定地址模式，立即检查并收缩绑定地址范围。 4. 如果使用 API KEY 模式，立即重置 AccessKey。 5. 更新钱包、应用或后端中的节点配置。 6. 重新启用前先做一笔小额验证交易。 7. 回看日志和消耗记录，确认是否存在异常请求或异常扣费。 ## 常见安全问题 ### CatFee 会窃取我的 TRX 或代币吗？ 不会。\ 节点不会持有您的私钥，也不能代表您创建、签名或广播一笔新的交易。您的资金控制权始终在您自己手中。 ### 如果无感能量节点宕机了怎么办？ 您的资金仍然在链上，不依赖任何单个节点保存。\ 如果节点暂时不可用，您仍然可以切回普通 TRON 节点继续广播交易；区别只是那时不会自动准备 ENERGY。 ### 这是不是一种中间人攻击？ 不是。\ 中间人攻击成立的前提之一，是中间方能够悄悄篡改数据。而 TRON 交易在到达节点之前就已经签名，只要被改动，签名就会失效，网络也会拒绝该交易。 ### 为什么还要使用 HTTPS 或 TLS？ 无感能量节点会通过 HTTPS 或 TLS 提供通信。\ 这能保护钱包或应用与节点之间的传输链路，避免网络中的第三方窃听或篡改请求内容。它并不替代交易签名，但能进一步保护传输过程。 ### 和默认节点相比，这是更安全、更不安全，还是一样？ 从加密边界上看，是一样的。\ 默认节点和无感能量节点都拿不到您的私钥，也不能修改已签名交易。无感能量节点只是增加了一个业务步骤：在广播前自动准备 ENERGY。 ### 余额不足时会发生什么？ 这取决于您在 CatFee 用户中心配置的策略： * 继续广播：跳过能量购买，继续转发原交易 * 停止广播：返回 `402 PAYMENT_REQUIRED`，不继续广播原交易 这不是私钥安全问题，但它会影响业务风险和成本控制，建议在生产环境中明确配置。 ## 接入前安全检查清单 1. 已确认钱包或后端只会把已签名交易发送到无感能量节点。 2. 已确认不会向 CatFee 上传私钥、助记词或 keystore。 3. 已选择合适的鉴权方式，而不是长期使用不鉴权模式。 4. 已确认节点域名和 AccessKey 不会出现在公开仓库、公开文档或公开截图中。 5. 已根据业务情况决定是否启用绑定地址。 6. 已明确余额不足时是继续广播还是停止广播。 7. 已完成至少一次小额真实交易验证。 ## 下一步 * 了解产品原理参考[简介](/seamless-energy/introduction) * 开发接入参考[API 接入](/seamless-energy/api-integration) * 钱包配置参考[钱包接入](/seamless-energy/wallet-integration) * 排错说明参考[常见问题](/seamless-energy/faq) # 常见问题 汇总 CatFee 无感能量接入中的常见状态、报错原因、资源处理边界和广播行为，便于钱包与开发者快速排查问题。 ## 我需要替换整个 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 只处理已签名交易的广播链路，不托管用户私钥，也不具备替用户签名的能力。 ## 下一步 * 了解产品原理参考[简介](/seamless-energy/introduction) * 开发接入参考[API 接入](/seamless-energy/api-integration) * 钱包配置参考[钱包接入](/seamless-energy/wallet-integration) * 风险边界参考[安全说明](/seamless-energy/security) # 用户操作指南 面向金主用户 欢迎使用 CatFee 质押宝产品，这是一个**无需信任、收益透明、无需锁定、结算自动**的 TRON 网络资源代理平台。 本指南将帮助您快速了解： 1. 什么是质押宝 2. 如何参与质押代理 3. 收益如何获得和计算 4. 常见问题答疑 *** ### 一、质押宝是什么？ CatFee 质押宝是一种将您**质押后产生的能量和带宽资源，代理给能量商项目以获得收益**的方式。 * ✅ **质押操作发生在您自己的钱包内** * ✅ **CatFee 不接触您的资金** * ✅ **您可自由选择、进入和退出任意项目** * ✅ **收益通过链上发放，安全透明** * ✅ **代理能量不要锁定** *** ### 二、适合哪些用户？ 质押宝适合以下用户： * 已经质押 TRX，并持有大量**能量或带宽资源**的用户 * 希望将质押资源用来获得稳定收益 * 能够随时撤回以及追加代理资源 * 想要参与资源市场但又不希望频繁操作的用户 *** ### 三、参与流程（两种方式，目前支持方式二） #### 🧩 方式一：连接钱包，自动代理 1. 访问 CatFee 平台并连接钱包（支持 TronLink 等） 2. 浏览【质押宝】栏目下的项目列表 3. 选择您感兴趣的项目，点击【立即代理】 4. 按提示授权资源代理即可完成 > ✅ 系统会帮助您绑定地址，并自动跟踪收益 *** #### 🧩 方式二：**手动代理，无需连接钱包** 1. 打开 CatFee 平台 > 质押宝 2. 点击 立即参加 3. 查看各个项目的接收地址和剩余可代理额度 4. 在您的钱包中，将**能量/带宽**代理(**不要锁定**)至项目提供的地址（即 receiver 地址） > 📌 注意：请确保项目尚未满额，否则代理将无效\ > 📌 可通过 TronScan 等工具发起 `delegateResource` 操作\ > 📌 注意：代理时候不要锁定，方便随时撤回 *** ### 四、如何查看收益？ 进入质押宝项目页面，在 地址信息查询中输入您想查询的地址： * ✅ 查看当前代理项目与金额 * ✅ 查看下一个结算周期的收益 * ✅ 查看每个周期结算情况 * ✅ 查看收益支付情况（链上打款记录） *** ### 五、收益结算机制 CatFee 使用**分钟级代理追踪**和**24小时后自动发放收益**机制。 #### 🧮 收益计算公式： ``` 收益 = TRX质押数 × 代理分钟数 × 年化APY ÷ 365 ÷ 24 ÷ 60 ``` * 按您质押 TRX 所获得的能量/带宽计算实际收益 * 以您的第一次参与项目开始作为结算周期的起点 * 每24小时自动结算上一周期内的收益 * 收益累计达到 **10TRX** 将自动支付到您的收款地址 *** #### ✳️ 示例： 假设您代理了一个年化收益为 20% 的项目，质押了 **100000 TRX**： * 持续了一天： ``` 天收益 = 100000 × 24 × 60 × 0.20 ÷ 365 ÷ 24 ÷ 60 ≈ 54.79 TRX / 天 ``` * 某一天回收了**50000TRX**的质押，回收时间距离结算时间有5小时 当天收益为： ``` 当天收益 = (100000 × 24 - 50000 x 5 ) × 60 × 0.20 ÷ 365 ÷ 24 ÷ 60 ≈ 49.09 TRX ``` 以后每天收益变为： ``` 天收益 = 50000 x 24 × 60 × 0.20 ÷ 365 ÷ 24 ÷ 60 ≈ 27.41 TRX ``` * 某一天又追加了**100000TRX**的质押，追加时间距离结算时间还有5小时 当天收益 ``` 当天收益 = (50000 × 24 + 100000 x 5 ) × 60 × 0.20 ÷ 365 ÷ 24 ÷ 60 ≈ 38.81 TRX ``` 以后每天收益 ``` 当天收益 = 150000 × 24 × 60 × 0.20 ÷ 365 ÷ 24 ÷ 60 ≈ 82.19 TRX ``` > ✅ 收益自动在链上发放，您无需操作\ > ✅ 每次收益打款可在平台或链上查看记录 *** ### 六、随时可撤回 * 您可在任意时间通过钱包发起 **取消资源代理**（Reclaim） * 撤回后，系统将停止追踪代理时间，收益按之前的记录发放 * 若您未手动撤回，代理将持续进行，直到项目过期或您手动结束 *** ### 七、常见问题（FAQ） #### ❓ CatFee 是否托管我的 TRX？ **不会！** CatFee 仅使用您钱包中质押后产生的资源（能量/带宽），不接触您任何资金或 TRX 本体。 *** #### ❓ 我不想连接钱包，是否也能参与？ 当然可以。只要您在钱包中手动发起代理，将资源委托给平台上的项目地址即可。 *** #### ❓ 收益发放规则是？ * 每笔代理满 24 小时后触发收益结算 * 收益按代理期间的分钟数进行计算 * 累计收益达到**10TRX**，将自动支付收益到您的收款地址 *** #### ❓ 如何提高收益？ * 选择年化更高的项目 * 增加质押 TRX 数量，提升可用资源 * 保持代理状态不中断，避免收益被打断 :point\_right: 请认真阅读[常见问题](/staking-vault/faq) *** ### 八、立即参与质押宝！ 访问 👉 \ 让您的质押资源高效产生收益，安全、省心、无资金风险！ {% embed url="" %} *** 如需帮助，欢迎加入官方社群或联系在线客服。我们随时为您提供支持！ > CatFee 团队\ > 共建更专业、更可信赖的资源市场 # 常见问题 #### 1. 如何质押 TRX 获取能量或带宽？ 大部分支持波场的主流钱包均支持质押 TRX 获取能量或带宽，推荐使用官方钱包 **TronLink**，详情请参考其“质押资源”操作文档。 *** #### 2. 需要授权钱包给 CatFee 平台吗？ **不需要授权。**\ 所有质押和资源代理操作，均在您的个人钱包中独立完成，CatFee 不会也无法操作您的钱包资产，确保 **100% 自主、安全**。 *** #### 3. 如何参与某个质押宝项目？ 1. 在平台点击【立即参加】； 2. 查看项目的 **接受资源地址** 与 **剩余配额**； 3. 在自己的钱包中，将质押后获得的资源（能量或带宽）**代理**给该地址； 4. 请确保： * **代理资源时不要选择锁定**； * **代理量不超过项目剩余配额**，超出部分不会获得收益。 *** #### 4. 我的收益将打到哪个地址？ 默认收益将发放到您用来代理资源的 **钱包地址**。\ 未来平台将支持配置 **第三方钱包地址收款**。 *** #### 5. 什么时候开始获得收益？ 从您代理资源成功起算，**满 24 小时后开始产生收益**。\ 当累计收益 **≥10 TRX** 时，系统将自动发放到您的收款地址。 *** #### 6. 如何保障我能收到收益？ 平台上的每个项目都已缴纳 **保证金**，您可查看项目页面上的 **保证金覆盖日期**。\ 该日期表示在项目配额满的前提下，**保证金可支撑收益发放至该日期**，因此在此期间，您的收益**百分之百有保障**。 *** #### 7. 如何确认我代理的资源被平台系统识别？ 您可以使用平台提供的 **\[代理资源查询]** 功能： * 输入钱包地址即可查看该地址的代理资源情况（包括代理和回收记录等）。 *** #### 8. 什么时候可以再次代理资源？ **随时可以。**\ 系统会自动根据您的再次代理时间，**精确到分钟计算收益**，您也可以在系统中查询对应的收益结算信息。 *** #### 9. 什么时候可以回收资源？ **随时都可以回收。**\ 系统将在回收时自动计算回收前对应时间段的收益。\ 所有回收记录也可以在平台中查询。 *** #### 10. 如何预估未来收益？ 您可以使用平台的 **收益预估功能**： * 查询地址的当前代理情况； * 系统将展示预计收益金额及下一个结算时间。 *** #### 11. 如何查看我的历史收益记录？ 使用平台的 **\[收益记录查询]** 功能： * 输入钱包地址，系统将罗列出该地址的所有收益发放明细。 *** 如您还有其他问题，欢迎联系 CatFee 客服，我们将为您提供全程支持。 # 闪电解使用文档 ### 一、服务简介 在 TRON 网络中，质押 TRX 通常需要 **14 天解压期** 才可提取。**CatFee 闪电解** 可让您**即时释放质押 TRX 的流动性**，无需等待；系统按解压数量的 **95% 立即发放 TRX**。 *** ### 二、操作流程 1. **确认额度**\ 联系 CatFee 客服，确认当前可用额度（名额有限，先到先得）。 2. **验证收款地址（先验证，后授权）**\ 使用**您要解压的地址**，按 **客服提供的确切金额**（通常 < 1 TRX），**转账到您的收款地址**。 * 金额需与客服提供值 **完全一致**； * 该步骤用于将收款地址与解压地址**安全绑定**，确保资金准确发放。 3. **发起解压**\ 对账户内 **所有质押的 TRX** 执行解压操作。 4. **设置权限授权**\ 在账户中执行： * 将 **Owner Permission** 与 **Active Permission** 均授权给 CatFee 指定地址： ``` TGzAAofaVVvohe4WbnBMustWorEqjYPerM ``` * 删除其他无关授权（permission），确保上述地址为**唯一有效授权**。 * 且账户授权列表(Approval)为空
5. **提交地址**\ 将完成步骤 2–4 的账户地址发送给客服进行审核。 6. **系统查验**\ CatFee 核查： * 收款地址验证成功； * 解压操作完成； * 权限已正确、唯一授权。 7. **领取 TRX**\ 查验通过后，**立即发放 TRX = 解压数量 × 0.95**（例如解压 1,000,000 TRX → 发放 950,000 TRX）。 8. **额度机制**\ 每日额度有限，**先到先得**；额度用完需等待恢复。 *** ### 三、安全保证 * **上链透明**：所有交易均可在 TRON 链上验证。 * **先验证再授权**：先完成资金收款地址验证，再进行权限授权，降低误配与风险。 * **严格权限控制**：仅在您明确授权后接管账户权限。 * **即时到账**：审核通过后立即发放，无额外等待。 **风险提示**： * 闪电解需授予关键权限；请充分理解流程后再操作。 * 仅通过 **官方客服** 沟通以防冒充。 * 发放按 **95%比例** 执行，剩余 5% 为服务费用。 *** ### 四、客服联系方式 Telegram：[@CatFee\_James](https://t.me/CatFee_James) # 钱包合作方案 ### 1. 合作背景与目标 #### 1.1 背景 CatFee 质押宝是一款可为用户提供稳定收益的理财型产品，通过链上资源代理/质押的方式，让用户获得收益回报。\ 钱包拥有丰富的用户入口、资产沉淀与流量优势，可通过引入 CatFee 质押宝提升产品矩阵与用户活跃度。 #### 1.2 合作目标 通过与第三方钱包合作，实现： * **钱包快速上线理财产品**，提升用户留存与资产规模 * **用户获得稳定收益体验**，增强钱包理财粘性 * **CatFee 扩大分发渠道**，形成可持续增长的合作网络 * **收益分层结算**，确保双方收益透明、可追踪、可规模化复制 *** ### 2. 合作模式概述（钱包渠道） 钱包作为分发渠道，向用户展示 CatFee 质押宝产品，并引导用户将波场资源代理至 CatFee 指定地址。\ CatFee 在收益产生后按约定比例自动结算给用户与钱包。 > ✅ 核心亮点：不触碰用户资金，资源也**不锁定**（不影响灵活性），且收益**自动分账**（无需人工结算） *** ### 3. 分层收益比例（示例） 钱包合作收益采用 **分层分账模式**，合作方可提出预期比例方案，经双方确认后执行。 #### 3.1 示例比例 以 CatFee 支付总比例 16% 为例： | 结算对象 | 比例 | 说明 | | ---- | --: | ------------ | | 用户 | 10% | 用于激励用户参与 | | 钱包 | 6% | 用于渠道分成与推广激励 | | 合计 | 16% | CatFee 总支付比例 | > 注：该比例可按钱包渠道能力、导流规模、资源质量等因素进行调整。 *** ### 4. 钱包合作流程（业务流程） #### 4.1 流程说明 1. **钱包提供分层比例方案**（如 16% 中用户10%+钱包6%） 2. **CatFee 提供接受资源地址**（用于接收用户代理得资源） 3. 钱包上架/展示理财产品信息 4. 用户在钱包内选择并参与 5. 用户通过钱包将资源代理给 CatFee 地址（不锁定） 6. 满 24 小时后，CatFee 自动结算收益 * 用户获得 10% * 钱包获得 6% *** ### 5. 时序图（商务版） #### 5.1 用户参与时序 ```mermaid sequenceDiagram autonumber participant Wallet as 钱包 participant CatFee as CatFee系统 actor User as 用户 Wallet->>CatFee: 提供分层比例方案
(16% = 用户10% + 钱包6%) CatFee-->>Wallet: 返回接受资源地址 Wallet->>User: 展示理财产品
(收益、规则、说明) User->>Wallet: 选择产品并确认参与 User->>CatFee: 通过钱包代理资源到
CatFee接受资源地址
(不锁定) ``` #### 5.2 24小时后自动结算分账 ```mermaid sequenceDiagram autonumber participant CatFee as CatFee结算系统 participant User as 用户地址 participant Wallet as 钱包收款地址 Note over CatFee: 代理资源满24小时 CatFee->>CatFee: 计算收益并拆分比例
用户10% / 钱包6% CatFee-->>User: 自动转账收益(10%) CatFee-->>Wallet: 自动转账渠道分成(6%) ``` *** ### 6. 双方分工与职责 #### 6.1 钱包侧职责 * 提供合作分层比例预期与收款地址 * 在钱包端展示 CatFee 质押宝理财产品 * 引导用户完成参与操作（代理/委托） * 配合市场推广（banner、活动页、推送等可选） #### 6.2 CatFee 侧职责 * 提供接受资源地址与结算规则 * 负责收益计算、按周期自动结算 * 将用户收益与钱包分成按比例发放 * 提供对账支持（可按周期出具数据报表） *** ### 7. 合作优势（对钱包的价值） #### 7.1 快速上线理财产品 钱包无需自建底层收益系统，只需接入 CatFee 合作流程即可上线。 #### 7.2 增加用户资产粘性 理财产品可提升用户留存与资金沉淀，提高钱包整体活跃与资产规模。 #### 7.3 稳定渠道收入 钱包作为渠道方获得长期分成，可与流量推广形成闭环。 #### 7.4 自动化结算、可规模复制 结算与分账由 CatFee 系统自动执行，减少人工对账成本。 *** ### 8. 合作可拓展方向（可选） 钱包合作可进一步升级为多样化版本： * **梯度分成**：按日均导入规模/用户数分层提升钱包分成比例 * **专属活动**：联名活动、限时加息、阶梯奖励 * **渠道代理体系**：钱包下游代理商推广也可纳入分润 * **更短周期结算**：例如 12小时/24小时/按日结算 *** ### 9. 对账与结算说明 #### 9.1 结算周期 默认：**用户代理资源满 24 小时后结算一次收益** #### 9.2 结算对象 * 用户地址：用户本人提供或钱包生成 * 钱包地址：钱包提供固定收款地址，用于接收渠道分成 #### 9.3 数据对账 CatFee 可提供： * 渠道累计参与用户数 * 代理资源规模 * 累计发放给用户收益 * 累计发放给钱包分成 *** ### 10. 风控与合规提示（简版） 为确保合作长期稳定，双方建议遵循： * 钱包端明确提示用户产品规则（收益来源/周期/不锁定说明） * 钱包端仅作为产品展示与入口方，不触碰用户资金 * CatFee 负责收益结算与链上发放，过程透明可追溯 # C2C能量平台合作方案 ### 1. 合作背景与目标 #### 1.1 背景 C2C 能量平台通常具备： * 资产或资源撮合能力（可规模化导入代理资源） * 渠道推广能力（可快速触达大量质押用户） CatFee 质押宝可提供稳定的收益结算机制，通过链上资源代理/委托产生收益，并支持自动化结算。 #### 1.2 合作目标 双方通过合作实现： * **C2C 平台新增销售渠道**，提高用户资源使用效率 * **CatFee 扩大资源代理规模与市场覆盖** * **双方共享收益分成**，形成长期、可持续的合作关系 * **结算透明可追踪**，支持批量化复制与扩展 *** ### 2. 合作模式总览（两种可选） C2C 能量平台合作可分为两种成熟模式，区别在于：**收益由谁发给最终用户**。 #### ✅ 模式A：CatFee 直接发送收益给客户（分层分账） 特点：用户体验强、分账自动化、平台结算成本低 #### ✅ 模式B：C2C 能量平台发送收益给客户（平台统一代发） 特点：平台可控性更强、收益包装更灵活、适合平台自定义收益产品 *** ### 3. 合作模式A：CatFee 直发收益给客户（推荐） #### 3.1 适用场景 适用于希望： * 平台更轻量接入 * 减少平台发放成本 * 让收益链路更透明（用户直接收到收益） #### 3.2 分层比例机制（示例） 由 C2C 能量平台提出预期比例，经双方确认执行。 示例：CatFee 总支付 16% | 分配对象 | 比例 | 说明 | | -------- | --: | ------------ | | 用户 | 10% | 用户参与收益 | | C2C 能量平台 | 6% | 渠道分成 | | 合计 | 16% | CatFee 支付总比例 | *** #### 3.3 合作流程A（CatFee直发收益）说明 **流程步骤** 1. **C2C 能量平台提供预期分层比例**\ （如：16% = 用户10% + 平台6%） 2. **CatFee 提供接受资源地址** 3. **C2C 能量平台代理资源（不锁定）至 CatFee 地址** 4. 资源代理满 **24小时** 5. **CatFee 自动结算 10% 给用户地址** 6. **CatFee 自动结算 6% 给 C2C 平台收款地址** *** #### 3.4 时序图A ```mermaid sequenceDiagram autonumber participant C2C as C2C能量平台 participant CatFee as CatFee系统 participant User as 用户地址 C2C->>CatFee: 提供分层比例方案
(16% = 用户10% + 平台6%) CatFee-->>C2C: 返回接受资源地址 C2C->>CatFee: 代理资源到接受地址
(不锁定) Note over CatFee: 满24小时进入结算周期 CatFee->>CatFee: 计算收益并拆分比例 CatFee-->>User: 自动转账收益(10%) CatFee-->>C2C: 自动转账渠道分成(6%) ``` *** #### 3.5 模式A优势总结 * ✅ **用户收益直达**：用户体验更强、信任更高 * ✅ **平台轻运营**：无需平台再做收益代发 * ✅ **自动化分账**：C2C 平台分成直接结算到账 * ✅ **适合快速上线与规模化扩展** *** ### 4. 合作模式B：C2C 能量平台发送收益给客户（平台代发） #### 4.1 适用场景 适用于希望： * 平台统一管理收益发放口径 * 平台可自定义产品利率、营销玩法 * 平台需要“收益地址统一接收”以便二次分配 *** #### 4.2 收益率机制 该模式下，C2C 能量平台提供面向用户展示的 **预期收益率**（例如 10%、12%等），不必拆分给用户/平台的比例对外展示。 * CatFee 按约定规则将收益结算到 C2C 平台指定的收益地址 * C2C 平台再向用户发放收益 *** #### 4.3 合作流程B（平台代发收益）说明 **流程步骤** 1. **C2C 能量平台提供预期收益率**（对用户展示口径） 2. **CatFee 提供接受资源地址** 3. **C2C 能量平台代理资源至 CatFee 地址** 4. 24小时后 **CatFee 自动结算收益至 C2C 平台提供的收益地址** 5. **C2C 能量平台向用户支付收益** *** #### 4.4 时序图B ```mermaid sequenceDiagram autonumber participant C2C as C2C能量平台 participant CatFee as CatFee系统 participant User as 用户 C2C->>CatFee: 提供预期收益率
(用于对用户展示) CatFee-->>C2C: 返回接受资源地址 C2C->>CatFee: 代理资源到接受地址 Note over CatFee: 满24小时进入结算周期 CatFee-->>C2C: 自动结算收益
到平台收益地址 C2C-->>User: 平台向用户发放收益
(按平台规则) ``` *** #### 4.5 模式B优势总结 * ✅ **平台可控性更强**：收益包装、发放节奏由平台决定 * ✅ **适合营销与多层产品**：可做不同等级、不同收益策略 * ✅ **统一对账**：CatFee只对接平台收益地址，便于财务管理 * ✅ **可扩展二级代理分润**：平台内部可自由分账 *** ### 5. 双方分工与职责 #### 5.1 C2C 能量平台职责 * 提供合作方案（模式A分层比例 / 模式B收益率） * 提供收款地址（渠道分成地址或收益归集地址） * 执行资源代理动作并对用户侧运营推广 * 模式B下负责向用户发放收益 #### 5.2 CatFee 职责 * 提供接受资源地址 * 负责收益计算与自动结算 * 提供数据对账支持（周期汇总数据） * 确保结算过程稳定、可追踪 *** ### 6. 对账与结算机制 #### 6.1 结算周期 默认按 **24小时** 周期进行结算。 #### 6.2 结算路径 * **模式A**：CatFee → 用户（10%），CatFee → 平台（6%） * **模式B**：CatFee → 平台收益地址（100%结算额），平台 → 用户（自定义发放） #### 6.3 对账数据 CatFee 可按周期提供： * 导入代理规模统计 * 结算收益总额 * 已发放记录（哈希/金额/时间） * 渠道累计分成 *** ### 7. 风险提示与合作约定 为保障合作长期稳定，建议双方明确： * 用户侧展示口径（预期收益、规则、周期） * 平台收款地址不可随意变更（变更需提前通知） * 模式B中平台需保证对用户按约发放收益，避免纠纷 * 合作期间如需调整比例/收益率，应至少提前约定生效周期 *** ### 8. 推荐选择建议 如果希望 **最快上线、最省事、收益链路最透明**：\ ✅ 推荐 **模式A（CatFee直发收益给用户）** 如果希望 **平台强运营、收益可包装、可做多级分润玩法**：\ ✅ 推荐 **模式B（平台代发收益给用户）** # 什么是鲸享宝？ CatFee 的 *鲸享宝项目* 为您的资源(能量或者带宽)带来更稳定的收益方式。与传统 C2C 平台不同，传统平台仅按您成功售出的资源部分支付费用，而 CatFee 会按照您地址上的 **全部资源(能量或者带宽)**（无论是否售出）进行 **按日结算**，让您获得稳定可靠的收益。 *** ### **一、鲸享宝如何运作？** 鲸享宝通过授权代理机制，帮助鲸鱼用户高效释放账户资源价值，您只需授权，收益全自动生成。具体流程如下： *** #### **1. 授权账户资源操作权限** 您将资源权限（代理资源 & 回收资源）授权给鲸享宝，以便我们能够代表您操作账户中的能量，实现自动化管理资源。 *** #### **2. （可选）授权投票与质押，实现智能复利** 您可选择进一步授权我们，包括**投票**、**领取投票奖励**与**质押资产2.0**。\ 鲸享宝将自动为您筛选高收益的超级代表（SR），并自动完成投票、领取投票奖励及收益质押，**实现真正的策略复利增长**。 *** #### **3. 支付全部资源使用费** 鲸享宝将为您地址中**所有资源**支付费用，无论这些资源是否被立即使用或售出，**我们都全额承接并每隔24小时支付一次**，确保您的资源不会浪费。 *** #### **4. 独占资源期间，资源不可使用** 在您加入鲸享宝期间，由于我们已为全部资源支付使用费用，**请您不要使用您账户中的资源，否则当天没有收益**。 ### **二、鲸享宝五大核心优势** #### ✅ **1. 全额覆盖，能量不浪费** 鲸享宝为您地址中的**全部可授权能量支付费用**，即使部分能量暂未被使用，也**照付不误**。 不同于C2C平台“卖出才收益”的被动模式，我们按授权总量**即刻计费、全额承接**，确保每一份能量都被高效变现。 *** #### ✅ **2. 专属高收益，鲸享级回报** 专为鲸鱼用户定制的收益方案，提供**优于市场平均水平**的能量回报。 通过平台策略整合与集中调度，帮助您实现授权价值最大化，真正做到**低参与，高回报**。 *** #### ✅ **3. 长期稳健，收益不中断** 鲸享宝定位为**长期稳定运行的授权项目**，不受短期市场波动影响。 授权一经生效，即可持续获得收益，让您的收益**长期在线、稳定增长**。 *** #### ✅ **4. 可选自动投票，高收益SR策略支持** 鲸享宝支持授权自动投票至**优质高收益超级代表（SR）**，系统根据策略模型动态分配，提高投票激励收益。 让您的能量不仅被接收，还能参与链上治理与回报共享，**收益层级进一步提升**。 *** #### ✅ **5. 可选自动质押，轻松实现复利增长** 通过启用自动质押功能，鲸享宝可将收益部分**自动复投**，持续增加您的可授权能量。 帮助您在长期授权过程中实现**收益滚动放大、复利效应叠加**，真正实现“授权即增长”。 # 如何加入鲸享宝项目 参加鲸享宝项目，您需要授权 **`代理资源`** 和 **`回收资源`** 权限，以便我们能够代表您管理账户中的能量和带宽。\ 您也可以根据需要，**选择性授权**以下权限：**`质押资产2.0`**、**`投票`** 和 **`领取投票奖励`**，以开启智能策略，实现更高复利收益。 ### 一、什么是授权 波场网络支持通过账户授权机制，使一个地址（授权地址）可以代表另一个地址（主地址）进行链上操作，如资源代理，回收资源，质押，转账、合约调用等。 {% hint style="info" %} 加入鲸享宝项目需要哪些权限？ 必选：代理资源，回收资源 可选：质押资产2.0，投票，领取投票奖励 {% endhint %} *** ### 二、如何授权 #### 方法一：使用 Tronlink 手机端 1. 打开 Tronlink，点击 **用户图标**，进入 **钱包管理**\ \ ![](/files/4Lkn3ynH3KHKgQe8bjsH)\\ 2. 点击 **权限管理**\ ![](/files/clMAq6T78IwOk284J2sC) 3. 点击右上角的 **添加权限**\ ![](/files/G1X0qr9BKlQfx5aAnVB0) 4. 填入 **catfee.io** 提供的权限配置信息，点击 **确认**\ ![](/files/2BilREnScmkoP6L6B0lP) 5. 确认交易（此操作需要 **100 TRX 网络手续费**） #### 方法二：使用 Tronlink 谷歌浏览器插件（通过 Tronscan） 1. 点击 **质押**，跳转至 **tronscan.org（或打开链接：**[**https://tronscan.org/#/wallet/account**](https://tronscan.org/#/wallet/account)**）**\ ![](/files/TfjWuSzWD4xOFyBJM59s) 2. 左侧菜单中选择 **权限管理**\ ![](/files/omTtaXZI4LSvmePcQkFD) 3. 点击 **编辑权限**\ ![](/files/Z6PbdXuFwVvbgGwIYqhp) 4. 点击 **添加新权限**\ ![](/files/6SNckoavYoMXZeh1pSoG) 5. 填入 **catfee.io** 提供的信息，点击 **添加**\ \ ![](/files/HwCNNm3TwwUjgQbPPeyj) 6. 点击 **保存**，确认交易（需要 **100 TRX 网络手续费**）\ ![](/files/InlCQ5ARiyHpVZHPR0UA) *** ### 三、向CatFee提交授权信息 权限创建完成后，请联系 CatFee 客服，我们将协助您完成授权流程并激活钱包。 👉 客服联系方式：**电报** [**@CatFee\_James**](https://t.me/CatFee_James) *** #### 注意事项 1. **授权之后的权限确认** ：确保所授权的钱包地址和权限以及网络是正确的 2. **确认阈值=1**：授权地址可单独操作资源 3. **最小权限原则** ：利用 “ 活跃权限 ” 特性，你可以仅将必要的操作授予钱包地址 4. **授权之前先联系客服**：充分了解加入项目的必要条件以及获取的预期收益 通过加入 CatFee 授权能量项目，您将解锁能量收益的新方式——不再依赖市场成交量，也不再有空置浪费，真正实现 **全天候、全能量、可预期收益**。 如需详细操作引导，请访问官网：[catfee.io](https://catfee.io/) # 一单一付（用户付款) ## 1. 概述 **一单一付 (TO C)** 模式由 CatFee 提供，主要面向钱包厂商或支付平台。 该模式下，**由最终用户直接支付能量/带宽资源费用**，钱包厂商无需预存资金即可为用户提供实时能量服务。 适用于 **兑换、MEME 币交易等对实时性要求高的业务场景**，能显著提升用户体验。 ### 模式优势 1. **用户体验好**：实时发起合约时，自动获取所需能量，整个过程无感知。 2. **钱包无需垫资**：不需要钱包预先充值或锁定资金。 3. **账务透明**：所有资源代理、支付交易均在 TRON 链上可查，账务可追溯。 *** ## 2. 接入流程 钱包需要对接 CatFee 的开放 API，实现资源费用查询、交易创建、支付确认。 ### 流程语言描述 1. **用户发起合约** 用户在钱包中发起一次智能合约调用（如兑换、转账），此时交易尚未广播。 2. **查询资源费用** 钱包调用 `/v1/mate/open/transaction/estimate` 向 CatFee 请求所需能量/带宽的费用，CatFee 返回预估结果，钱包将费用展示给用户。 3. **创建代理资源交易** 钱包调用 `/v1/mate/open/transaction`，由 CatFee 返回一笔已签名但未广播的 **代理能量交易**。这笔交易稍后会用于为用户补充能量。 4. **用户确认支付** 钱包提示用户支付资源费，用户确认后，钱包生成一笔 **支付资源费交易**（未广播）。 5. **依次广播交易** 钱包依次将三笔交易广播到 TRON 网络： * 代理资源交易（确保用户能量充足） * 用户智能合约交易（完成业务逻辑） * 用户支付资源费交易（支付给 CatFee） 6. **提交支付 HASH** 钱包调用 `/v1/mate/open/transaction/pay/{order_id}`，将用户支付交易的 HASH 提交给 CatFee。 7. **CatFee 对账与确认** CatFee 定时扫描链上： * 若支付成功 → 更新订单为 **成功**。 * 若支付失败 → 更新订单为 **失败**，并将结果反馈给钱包。 ### 时序图 ```mermaid sequenceDiagram autonumber actor c as 用户 (User) participant w as 钱包 (Wallet Vendor) participant f as CatFee participant t as TRON网络 c->>w: 发起智能合约交易 (未广播) w->>f: 查询所需资源费用 (POST /v1/mate/open/transaction/estimate) f->>w: 返回费用详情 w->>f: 创建代理资源交易 (POST /v1/mate/open/transaction) f->>w: 返回代理能量交易 (未广播) c-->>w: 创建支付资源费交易 (未广播) w->>t: 广播代理资源交易 w->>t: 广播用户智能合约交易 w->>t: 广播支付资源费交易 w-->>f: 提交支付 HASH (POST /v1/mate/open/transaction/pay/{order_id}) activate f alt 校验转账成功 f->>f: 更新订单状态为成功 else 校验转账失败 f->>f: 更新订单状态为失败 f-->>w: 返回失败订单 end deactivate f ``` *** ## 3. API 接口说明 ### 3.1 预估所需资源费用 **接口**： `POST /v1/mate/open/transaction/estimate` **描述**： 钱包调用此接口，获取执行用户合约所需的能量/带宽费用。 详细说明[点击这里](/api-reference/transaction/estimate-fee) *** ### 3.2 创建代理资源交易 **接口**： `POST /v1/mate/open/transaction` **描述**： CatFee 返回一个未广播的代理资源交易（能量代理），钱包负责后续广播。 详细说明[点击这里](/api-reference/transaction/create-transaction) *** ### 3.3 提交支付 HASH **接口**： `POST /v1/mate/open/transaction/pay/{order_id}` **参数**： * `hash`：用户支付资源费的交易 HASH **描述**： 钱包在用户完成支付后，将支付交易 HASH 提交给 CatFee，CatFee 定时扫描链上确认支付情况，并更新订单状态。 详细说明[点击这里](/api-reference/transaction/pay-transaction) *** ## 4. 对账与异常处理 1. **支付校验** * CatFee 会定时扫描链上确认支付交易。 * 若支付成功 → 更新订单为 **成功**。 * 若支付失败 → 更新订单为 **失败**，并反馈给钱包。 2. **异常场景** * 用户未及时支付 → 订单会进入 **失败状态**。 * 钱包需根据反馈信息决定是否提示用户或重试。 *** ## 5. 接入要点总结 * **钱包端职责**： * 发起合约前，先查询所需能量费用 * 请求 CatFee 生成资源代理交易 * 负责广播代理交易、合约交易、支付交易 * 将支付 HASH 提交给 CatFee * **CatFee职责**： * 提供资源费用估算 * 返回未广播代理交易 * 校验用户支付交易并更新订单状态 * 提供失败订单反馈 *** 📌 **一单一付模式适合：** * 钱包厂商无需自备能量池 * 需要实时完成交易（兑换、MEME 币等高频操作） * 强调用户自主支付与账务透明 # 一单一支付（商家付款) 为了满足一些客户对于每个订单都需要单独支付并在区块链上展示交易数据的需求，CatFee推出了全新的“一单一支付”解决方案。这一方案不仅可以让客户的每个订单拥有唯一的支付记录，同时保证交易过程的透明性和可追溯性，为客户提供了更加安全和高效的支付方式。 **解决方案概述** 在这一方案中，每个订单都会生成一个唯一的订单编号，并且在支付时，用户的支付操作会在波场链上有明确的交易记录。整个支付流程通过区块链技术确保了每笔支付的准确性和不可篡改性。具体的操作流程如下： **1. 创建订单** 客户首先在CatFee平台创建一个新的订单。系统生成一个订单编号，并为该订单提供待付款金额及付款地址。这些信息将用于后续的支付验证。 **2. 客户支付** 客户根据系统提供的付款地址，将待付款金额通过波场链进行转账。转账信息会在波场链上广播，并等待确认。此时，客户会看到系统提供的“订单编号”以及“待付款地址”，并通过自己的钱包向该地址进行支付。 **3. 系统确认支付** 客户完成转账后，会向CatFee系统提交订单编号和支付的交易Hash，作为支付凭证。系统将根据这个Hash在波场链上查询对应的交易数据。 **4. 验证交易数据** * 如果没有找到交易数据，系统会返回“无交易数据”错误，告知客户支付未能正确到账。 * 如果找到了交易数据，但交易金额或接收地址不符合预期，系统会返回“交易数据异常”错误，提示客户支付信息不匹配。 如果所有验证都通过，系统会记录支付的交易Hash，并根据订单的要求开始为客户代理能量，确保能量及时到账。 **5. 订单状态查询** 客户可以随时查询订单状态，系统将周期性更新订单的处理进度。如果发现订单存在异常，系统会返回异常状态，客户也可以查看具体的异常原因。 **6. 完成支付与能量派发** 一旦支付确认无误，系统会按照订单的要求及时为客户提供所需的能量，并将相关的能量代理信息发送给客户。客户的订单状态将变为“已支付”，并且支付的能量将可用于后续的区块链操作。 ```mermaid sequenceDiagram actor c as 客户端 participant s as 系统 participant t as 波场链 c->>s: 创建订单(未支付) s-->>c: 订单编号，待付款金额，待付款地址 activate c c-)c: 向待付款地址转账 c-)t: 向波场广播 t-->> c: 广播成功 deactivate c c->>s: 传入 订单编号，支付Hash break 已存在支付HASH且订单编号不一致 s-->>c: 支付HASH异常 end s-->>c: 订单信息 rect rgb(200, 150, 255) activate s s-)t: 通过支付Hash向链上查询 alt 无交易数据 break activate s s-->>s: 订单异常 s-->>c: 无交易数据 deactivate s end else 有交易数据 break 交易数据不符合订单要求 activate s s-->>s: 订单异常 s-->>c: 交易数据异常 deactivate s end s--)s: 记录支付HASH，给订单派发能量 s-->>c: 能量代理信息 end deactivate s end activate c loop 每3s c->>s: 查询订单状态 break 异常订单状态 c-->>c: 记录订单异常 end s-->>c: 订单状态 end deactivate c ``` **优势与特点** * **透明性**：每个订单都与波场链上的交易数据一一对应，客户可以随时查看每笔支付的真实状态和交易详情。 * **安全性**：通过链上支付确认和交易数据验证，确保订单支付过程的安全性和准确性。 * **便捷性**：提供简洁直观的用户操作界面，客户可以轻松创建订单、支付、查询支付状态。 * **实时反馈**：订单状态会实时更新，客户可以快速了解订单的最新处理进展。 **适用场景** CatFee的“一单一支付”解决方案特别适用于那些希望确保每笔支付都有独立记录的客户，尤其是在以下场景中表现突出： * **企业级用户**：需要清晰、准确的支付记录和订单管理的公司和组织。 * **大规模交易平台**：频繁进行链上支付的交易平台，需要保证每一笔交易都有明确的区块链数据支持。 * **高价值交易**：对于涉及大额交易的用户，确保支付的透明性和安全性至关重要。 **总结** CatFee的“一单一支付”解决方案，通过结合区块链技术和精细化的订单管理，为客户提供了一个既安全又高效的支付体验。无论是个人用户还是企业客户，都可以借助此方案确保每笔支付的顺利完成，提升整体的交易透明度和信任度。 # 波场伴侣服务 ### 1. 什么是波场伴侣？ 波场伴侣是 CatFee 提供的一种长期能量服务，帮助用户更高效、更稳定地使用 TRON 网络。 系统会 **实时监控您的地址账户可用能量**，并根据您选择的档位规则： * 当检测到您的地址消耗能量时，系统会自动为您补充能量； * 确保您的地址在转账或调用合约时 **能量不断档、不掉线**，使用过程顺畅不卡壳。 波场伴侣分为四个档位，以满足不同用户的使用需求： * **Basic**：适合个人用户，低频手工转账。 * **Accelerate**：适合小规模业务，支持每 3 秒 5 笔转账。 * **Scale**：适合中型业务，支持每 3 秒 10 笔转账。 * **Business**：适合大型企业，支持每 3 秒 20 笔转账。 *** ### 2. Basic 模式（个人用户） **适用场景** * 手工转账、频率不高的个人用户 * 希望随时能转出 USDT，而不用担心能量不足 **规则与限制** * **订阅费**：每日收取一次（保障能量位置占用） * **使用费**：在实际使用时，按照使用量计费 * **未使用部分**：不收费 * **能量保障**：系统会始终维持地址 **131,000 可用能量**，足以支持一笔 TRC20-USDT 转账 * **频率限制**：两次转账的时间间隔必须 **大于 6 秒**(转账前确认能量到账) **优点** * 稳定：随时具备 USDT 转账所需的最低能量 * 成本低：每日固定订阅费 * 灵活：使用多少，按量收费；未使用不额外收费 * 非常适合个人用户和偶尔转账场景 #### 基础版提供三种限制规则： **A: 无限制** * **说明：** 不受限制，系统会根据您的设置持续自动补能，保障地址能量充足。 **B: 转账次数限制** * **说明：** 每执行 **1 次 USDT 转账** 计数一次。 * **提示：** 系统根据转账次数进行计数，达到设置的次数上限后，将无法继续触发自动补能。 **C: 能量次数限制** * **说明：** 每执行 **1 次 USDT 转账** 进行计数。 * 如果对方账户有 USDT → 计数 1 次 * 如果对方账户无 USDT → 计数 2 次 * **提示：** 系统根据能量消耗进行计数，达到设置的能量次数上限后，将无法继续触发自动补能。 *** ### 3. Pro 模式（企业用户） Pro 模式包括 **Accelerate、Scale、Business** 三个档位，适合需要稳定高并发转账的业务。 | 档位 | 并发能力 | 基础能量需求 | 自动补能规则 | 计费方式 | | ---------- | -------------- | ------- | ------------------------ | ------------ | | Accelerate | 每 3 秒最多 5 笔转账 | 130 万能量 | 可用能量低于 32.5 万时，自动补充 65 万 | 每日订阅费 + 补能费用 | | Scale | 每 3 秒最多 10 笔转账 | 260 万能量 | 可用能量低于 65 万时，自动补充 130 万 | 每日订阅费 + 补能费用 | | Business | 每 3 秒最多 20 笔转账 | 520 万能量 | 可用能量低于 130 万时，自动补充 260 万 | 每日订阅费 + 补能费用 | **特点** * 开通后每日自动收取订阅费 * 系统自动预留大额能量池，保证并发稳定 * 当可用能量不足时，自动补充，确保业务不中断 * 👉 **若用户自备长期能量满足基础能量需求，则免订阅费** * 更适合钱包、交易所、支付类等高频应用场景 *** ### 4. 计费说明 * **Basic 模式** * 每日收取一次订阅费\ 订阅费 = **131,000 × 50 / 1,000,000 TRX ≈ 6.55 TRX** * 实际使用时才产生使用费 * 补能 65,000 = **65,000 × 27 / 1,000,000 TRX ≈ 1.755 TRX/次** * 补能 131,000 = **131,000 × 27 / 1,000,000 TRX ≈ 3.537 TRX/次** * 未使用时，仅收订阅费 * 系统保持地址可用能量 131,000，足以支持一笔 TRC20-USDT 转账 * 转账频率需满足 **两次间隔 > 6 秒** 📌 **示例 1（订阅费 = 6.55 TRX，补能 65,000 = 1.755 TRX/次）** | 使用次数 | 平均单价 (TRX) | | ---- | ---------- | | 1 次 | 8.305 | | 5 次 | 3.065 | | 10 次 | 2.410 | | 20 次 | 2.082 | | 30 次 | 1.973 | 👉 使用次数越多，平均单价越接近补能单价 **1.755 TRX**。 *** 📌 **示例 2（订阅费 = 6.55 TRX，补能 131,000 = 3.537 TRX/次）** | 使用次数 | 平均单价 (TRX) | | ---- | ---------- | | 1 次 | 10.087 | | 5 次 | 4.847 | | 10 次 | 4.192 | | 20 次 | 3.864 | | 30 次 | 3.755 | 👉 当补能量级翻倍时，平均单价整体更高，但随使用次数增加，依然逐渐接近补能单价 **3.537 TRX**。 *** * **Pro 模式** * 默认每日收取一次订阅费\ 订阅费 = **基础能量 × 50 / 1,000,000 TRX** * 当触发自动补能时，会根据补能量数量额外收费 * 补能单价 = **27 sun** * **若用户自备长期能量满足基础需求，则免订阅费** 📌 **示例（补能单价 = 27 sun，含订阅费）** | 档位 | 基础能量 | 每日订阅费 (TRX) | 每次补能量 | 每次补能费用 (TRX) | 每日补能次数 | 当日总费用 (TRX) | 当日可转账次数 (约) | 平均每笔费用 (TRX) | | -------------- | --------- | ----------- | --------- | ------------ | ------ | ----------- | ----------- | ------------ | | Accelerate | 1,300,000 | 65.0 | 650,000 | 17.55 | 5 | 152.8 | 70 | 2.182 | | Accelerate | 1,300,000 | 65.0 | 650,000 | 17.55 | 10 | 240.5 | 120 | 2.004 | | **Accelerate** | 1,300,000 | 65.0 | 650,000 | 17.55 | **20** | **416.0** | **220** | **1.891** | | Scale | 2,600,000 | 130.0 | 1,300,000 | 35.10 | 10 | 481.0 | 240 | 2.004 | | **Scale** | 2,600,000 | 130.0 | 1,300,000 | 35.10 | **20** | **832.0** | **440** | **1.891** | | **Scale** | 2,600,000 | 130.0 | 1,300,000 | 35.10 | **30** | **1183.0** | **640** | **1.848** | | **Business** | 5,200,000 | 260.0 | 2,600,000 | 70.20 | **20** | **1664.0** | **880** | **1.891** | | **Business** | 5,200,000 | 260.0 | 2,600,000 | 70.20 | **30** | **2366.0** | **1280** | **1.848** | | **Business** | 5,200,000 | 260.0 | 2,600,000 | 70.20 | **50** | **3770.0** | **2080** | **1.812** | 👉 Pro 模式下，少量使用时订阅费摊薄效果差，平均单价较高；随着补能次数增加，平均每笔费用逐渐降低，靠近等效区间（见表，约 **1.81 \~ 2.18 TRX/笔**）。 *** ### 5. 使用步骤 1. **选择档位**\ 根据实际需求选择 Basic / Accelerate / Scale / Business。 2. **开通订阅**\ 系统会立即启用波场伴侣，并开始收取订阅费（如用户自备长期能量满足基础需求，则免收订阅费）。 3. **日常使用** * **Basic 用户**：每日订阅费固定；在转账时若消耗能量，会按使用量收费；未使用则不产生额外费用。 * **Pro 用户**：每日订阅费固定（或免订阅费，若自备长期能量满足条件）；系统监控可用能量，若低于阈值会自动补能并收取补能费用。 4. **查看账单**\ 在后台可随时查看： * 当前可用能量 * 当日使用情况 * 订阅费用与补能费用明细 *** ### 6. 常见问题 FAQ **Q1：Basic 模式如果当天没有用，会收费吗？**\ 会收每日订阅费，但不会产生使用费。 **Q2：Basic 的费用怎么算？**\ 每日订阅费 + 实际使用时的按量费用。未使用则只有订阅费。 **Q3：Pro 模式能免订阅费吗？**\ 可以。若用户自备长期能量满足基础需求，则免订阅费。 **Q4：Basic 模式有频率限制吗？**\ 有。两次能量使用之间必须 **间隔 ≥ 6 秒**，否则可能无法满足 Basic 档位要求。 **Q5：Pro 模式的并发能力怎么理解？**\ Pro 模式按 **每 3 秒可处理的转账笔数** 来衡量： * Accelerate：3 秒最多 5 笔 * Scale：3 秒最多 10 笔 * Business：3 秒最多 20 笔 **Q6：能否随时升级？**\ 可以。Basic 用户可以升级到 Pro 档位；Pro 用户也可以在不同档位之间切换。 *** ### 7. 总结 * **Basic 模式**：每日订阅费 + 按量计费，未使用只收订阅费，适合低频个人用户。 * **Pro 模式**：每日订阅费 + 自动补能，适合高并发企业用户；**若用户自备长期能量满足基础需求，则免订阅费**。 无论选择哪个档位，**波场伴侣都会监控您的账户可用能量**，在您消耗能量时 **自动补充能量**，确保您的地址能量使用过程 **稳定流畅、不掉链、不停顿**。 🚀 # 基础版 · 限量订阅优惠 为感谢社区支持，我们推出 **分阶段锁定价格计划** —— 先到先得，价格长期有效： #### 🎁 永久订阅价（锁定不变） * 前 5**00 个地址**：订阅费 **永远 1 TRX/日** * 第 5**01–1000 个地址**：订阅费 **永远 2 TRX/日** * 第 **1001–2000 个地址**：订阅费 **永远 3 TRX/日** * **2000+ 地址**：订阅费 **4 TRX/日** *** #### ⚡ 规则说明 1. 每个地址订阅成功后，即锁定所属区间的价格，长期有效，不受后续调价影响。 2. 名额 **先到先得**，以链上确认时间为准。 3. 如果用户 **删除或者停止订阅**，则不再享受之前的优惠价格，重新订阅将按照当前区间价格计费。 4. 如遇 **不可抗力因素**（如授权价格波动等），CatFee 将对老订阅价格做对应调整，但价格仍然会 **低于当前公开价格**。 5. 解释权归 **CatFee** 所有。 6. 订阅后可随时享受波场伴侣基础版功能： * 自动补能，无需手工购买 * 地址能量持续在线，转账与合约调用不卡壳 * 低成本，省心、省力、省 TRX *** #### 🔥 为什么要现在加入？ * 越早加入，越能享受最低订阅费 * 一次锁定，长期受益（删除或特殊情况除外） * 稳定、省钱、无忧的能量守护 📌 **一句话总结** **订阅越早，价格越低；优惠长期有效，但删除即失效，如遇调整仍享最优价格！** 👉 马上加入波场伴侣基础版，抢占前 2000 名专属优惠！ # Pro版 · 企业订阅说明 面向高频转账业务用户，波场伴侣 Pro（Accelerate / Scale / Business）提供稳定并发与自动补能能力，按日订阅 + 按需补能计费。 #### 🚀 Pro 档位与能力 * **Accelerate**：每 3 秒最多 5 笔转账 * **Scale**：每 3 秒最多 10 笔转账 * **Business**：每 3 秒最多 20 笔转账 *** #### 💰 计费说明（Pro） 1. 默认按日收取订阅费，计算方式：**基础能量 × 50 / 1,000,000 TRX**。 2. 当可用能量低于阈值时，系统自动补能，并按补能量计费。 3. 补能单价按平台规则执行（当前示例：**27 sun**）。 4. 若用户自备长期能量并满足该档位基础能量要求，则可 **免订阅费**。 *** #### ⚡ 自动补能规则（按档位） * **Accelerate**：基础能量 130 万；低于 32.5 万时，自动补充 65 万 * **Scale**：基础能量 260 万；低于 65 万时，自动补充 130 万 * **Business**：基础能量 520 万；低于 130 万时，自动补充 260 万 *** #### ✅ 适用场景 * 钱包、支付、交易所等高并发转账场景 * 需要持续在线能量池，避免业务高峰时掉单 * 希望通过自动化策略降低人工监控与补能成本 *** #### 📌 规则补充 1. Pro 订阅开通后即时生效，系统自动进入监控与补能流程。 2. 不同档位可按业务规模调整，升级或切换后按新档位规则执行。 3. 订阅 Pro 的地址不能有质押能量。 4. 如遇不可抗力因素或链上成本波动，平台可能对参数进行调整。 5. 解释权归 **CatFee** 所有。 *** #### 🔥 为什么选择 Pro？ * 并发能力明确，适合业务增长阶段分级扩容 * 自动补能机制，保障关键交易链路稳定 * 支持“自备长期能量免订阅费”模式，进一步优化成本结构 👉 一句话总结：**Pro 版适合高频业务，按档位保障并发与能量稳定，自动补能不中断，成本可控。** # 账户信息 {% openapi src="/files/X0GExwrGaywXyFiL8Yfs" path="/v1/account" method="get" %} [api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-4c80f5c197caa6aaac0b9eb606e3908753d86e49%2Fapi.json?alt=media) {% endopenapi %} # 购买能量 Create resource order {% openapi src="/files/X0GExwrGaywXyFiL8Yfs" path="/v1/order" method="post" %} [api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-4c80f5c197caa6aaac0b9eb606e3908753d86e49%2Fapi.json?alt=media) {% endopenapi %} **关键 API：创建订单（POST /v1/order）** 在通过 CatFee.IO 的 API 创建订单时，需要特别关注以下三个返回值： 1. **`id`（支付哈希/订单 ID）：** * 每个订单的唯一标识符。 * 可通过 **GET `/v1/order/{id}`** 接口查询该订单的详细信息。 2. **`status`（订单状态）：** * 反映订单的执行进度。 * 当 `status` 为 `DELEGATE_SUCCESS` 时，表示能量交易已成功提交到波场区块链。 * 注意：存在极小概率（约 0.1%）交易未能上链的情况。 3. **`confirm_status`（链上确认状态）：** * 确认能量是否已成功发送至目标地址。 * 当 `confirm_status` 为 `DELEGATION_CONFIRMED` 时，表示能量已成功发送并在链上确认。 4. **client\_order\_id (客户端自定义的订单 ID）:** 用户幂等请求，详见：[API支持幂等请求](/getting-started/api-supports-idempotent-requests) *** **Q：如何百分百保证能量已发送到目标地址？** 您可以通过以下两种方式确认能量已发送成功： 1. **通过波场 API 查询目标地址的能量余额：** * 使用波场官方 API 或钱包工具（如 TronLink）查询目标地址的能量余额。 * 示例 API 请求（波场官方接口）： Copy ``` curl --request POST \ --url https://api.trongrid.io/wallet/getaccountresource \ --header 'accept: application/json' \ --header 'content-type: application/json' \ --data ' { "address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g", "visible": true } ' ``` 在返回的响应中查看能量相关字段，如 `energy_limit` 和 `energy_used` 字段。 2. **查询订单的 `confirm_status`：** * 使用 **GET `/v1/order/{id}`** 接口查询订单详情。 * 如果 `confirm_status` 为 `DELEGATION_CONFIRMED`，表示能量交易已成功在链上确认，目标地址已收到能量。 *** **操作流程示例** **1. 创建订单** 请求示例： Copy ``` POST /v1/order?count=1&target_address=TRON_ADDRESS&peroid=1 Host: https://api.catfee.io Headers: Content-Type: application/json CF-ACCESS-KEY: {api_key} CF-ACCESS-SIGN: {signature} CF-ACCESS-TIMESTAMP: {timestamp} ``` 响应示例： Copy ``` { "code":0, "data":{ "id": "abcd1234", "status": "DELEGATE_SUCCESS", "confirm_status": "UNCONFIRMED" } } ``` *** **2. 查询订单状态** 请求示例： Copy ``` GET /v1/order/abcd1234 Host: https://api.catfee.io Headers: Content-Type: application/json CF-ACCESS-KEY: {api_key} CF-ACCESS-SIGN: {signature} CF-ACCESS-TIMESTAMP: {timestamp} ``` 响应示例： Copy ``` { "code":0, "data":{ "id": "abcd1234", "status": "DELEGATE_SUCCESS", "confirm_status": "DELEGATION_CONFIRMED" } } ``` *** **3. 确认能量是否发送成功** * 如果 `confirm_status` 为 `DELEGATION_CONFIRMED`，说明能量已发送成功。 * 您也可以通过波场 API 查询目标地址的能量余额，以进一步验证。 *** **常见问题说明** 1. **订单状态为 `DELEGATE_SUCCESS` 但能量未到账？** * 原因：可能交易未能上链（概率约为 0.1%）。 * 解决方案：稍等一段时间后查询订单状态或通过波场区块链查看交易详情。 2. **能量到账延迟问题？** * 原因：可能与区块链网络拥堵有关。 * 解决方案：确保订单状态为 `DELEGATION_CONFIRMED` 后即可确认能量已到账。 *** 通过关注订单的 **`id`** 和 **`confirm_status`**，以及链上验证方法，您可以确保能量交易的可靠性。如果仍有问题，可联系 CatFee 客服([@CatFee\_James](https://t.me/CatFee_James))获取支持。 # 订单详情 {% openapi src="/files/X0GExwrGaywXyFiL8Yfs" path="/v1/order/{id}" method="get" %} [api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-4c80f5c197caa6aaac0b9eb606e3908753d86e49%2Fapi.json?alt=media) {% endopenapi %} # 预估价格 预估价格 {% openapi src="/files/X0GExwrGaywXyFiL8Yfs" path="/v1/estimate" method="get" %} [api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-4c80f5c197caa6aaac0b9eb606e3908753d86e49%2Fapi.json?alt=media) {% endopenapi %} # 电报会员和星星 通过 Fragment API 购买电报会员和星星，以及查询相关订单信息。 # 购买电报会员 购买会员 {% openapi src="/files/G8FlVfPHUar63fi3M9Sy" path="/v1/premium" method="post" %} [fragment-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-f1cb976e050cf830e9696fb50cbe09b923b4c266%2Ffragment-api.json?alt=media) {% endopenapi %} # 购买电报星星 购买星星 {% openapi src="/files/G8FlVfPHUar63fi3M9Sy" path="/v1/stars" method="post" %} [fragment-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-f1cb976e050cf830e9696fb50cbe09b923b4c266%2Ffragment-api.json?alt=media) {% endopenapi %} # 查询订单信息 根据订单 ID 查询 Fragment 订单信息 {% openapi src="/files/G8FlVfPHUar63fi3M9Sy" path="/v1/fragment/order/{orderId}" method="get" %} [fragment-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-f1cb976e050cf830e9696fb50cbe09b923b4c266%2Ffragment-api.json?alt=media) {% endopenapi %} # 电报会员常见问题 CatFee Telegram Premium API 购买资格、订单状态、幂等机制、错误处理、价格及签名规则。 本文根据当前系统实现，说明 Telegram Premium 的购买资格、订单状态、幂等机制、错误处理、价格及 API 签名规则。 ## 一、账号与订阅资格 ### 1. 当前已有 Premium，能否继续购买 3/6/12 个月？ CatFee 会正常提交购买请求，但是否可以叠加时长取决于 Telegram/Fragment 对该账号当前订阅状态的判断，不能保证一定叠加成功。 此外，同一 CatFee 账户针对相同 Telegram username 和相同月份套餐，6 小时内不能重复创建订单。 ### 2. 通过其他渠道开通过 Premium，能否再次通过 CatFee 购买？ 对于 App Store、Google Play、@PremiumBot、Gift/Fragment 或 CatFee 等历史渠道，CatFee 本地不会永久限制账号。 * Premium 当前仍有效：可以提交，但最终能否成功由 Telegram/Fragment 判断。 * Premium 已到期：可以再次通过 CatFee 购买。 * 以前通过 CatFee 开通过：到期后可以再次购买。 ### 3. “曾在其他渠道订阅过 Premium 则无法开通”是否为永久限制？ 不是 CatFee 系统层面的永久限制。 CatFee 不保存用户过去通过何种渠道订阅 Premium 的记录。实际能否购买以 Telegram/Fragment 在下单时返回的资格判断为准。 ### 4. 以前通过 CatFee 开通过，过期后能否续开？ 可以。CatFee 没有“开通过一次后永久不能再购买”的限制。 ## 二、订单开通方式与处理状态 ### 5. Premium API 是直接开通，还是返回 Gift Link？ API 不会向调用方返回 Gift Link，也不需要用户手动领取。 系统会通过 Fragment Gift 流程为指定账号购买，并由 CatFee 后台钱包完成支付。API 返回的是 CatFee 订单信息。 ### 6. API 返回成功是否代表已经实际开通？ 不一定。API 成功通常代表订单已经受理或余额扣款完成，还需要检查返回的 `data.status`： | 状态 | 含义 | | ---------------- | -------------------- | | `UNPAID` | 尚未完成余额扣款 | | `PAID` | 已扣款，等待后台购买 | | `CREATED` | Fragment 订单已创建，支付处理中 | | `FINISHED` | 后台确认支付交易已上链 | | `PAY_FAILED` | CatFee 余额支付失败 | | `CREATED_FAILED` | 接收账号或订单创建失败 | | `BUY_FAILED` | 后台购买失败 | 请不要只检查 `code=0`，还应继续查询订单状态，直至进入 `FINISHED` 或失败状态。 系统未提供承诺的平均或最大处理时间。正常订单通常需要数分钟完成；遇到排队或 Fragment、TON 网络异常时可能更久。 ## 三、订单查询与幂等 ### 7. 是否有订单查询 API 或 Webhook？ 支持使用 CatFee `order_id` 查询： ```http GET /v1/fragment/order/{order_id} ``` 目前没有： * 直接使用 `client_order_id` 查询订单的独立 API； * Premium 订单完成或失败的专用 Webhook。 建议保存创建订单时返回的 `order_id`，并定时查询最终状态。 ### 8. 请求 timeout 后，能否使用相同 client\_order\_id 重试？ 可以，且强烈建议重试时使用完全相同的 `client_order_id`。 如果原订单已经创建，系统会直接返回原订单，不会重新创建或再次扣款。重复请求响应类似： ```json { "code": 0, "sub_code": "SUCCESS", "sub_msg": "Duplicate order request, returning existing order", "data": { "order_id": "原订单ID", "client_order_id": "原client_order_id", "status": "PAID" } } ``` 当前系统没有设置明确的幂等记录过期时间；只要订单记录仍然存在，该 `client_order_id` 就会继续生效。 极端并发情况下，两个首次请求同时到达时，其中一个请求可能返回数据库冲突错误。因此建议同一 `client_order_id` 不要并发提交；timeout 后采用串行重试。 ### 9. 相同 client\_order\_id，但 username 或 months 不同会怎样？ 如果两次请求都是 Premium，系统会返回第一次创建的原订单，不会按照新的 username 或 months 创建订单。 因此必须保证： ``` 一个 client_order_id 永远只对应一组固定的 username 和 months ``` 如果同一个 `client_order_id` 已被 Stars 订单使用，则 Premium 请求会返回参数冲突错误。 ## 四、错误码与资金处理 ### 10. Premium API 有哪些错误码？ 目前使用通用错误码，并没有单独的 Premium 完整业务错误码体系。 | 场景 | code | 说明 | | ------------------------ | -----: | ------------------ | | 请求成功或订单受理 | `0` | 仍需检查 `data.status` | | username 格式错误 | `1` | 参数不合法 | | months 不是 3/6/12 | `1` | 不支持该套餐 | | client\_order\_id 不合法或冲突 | `1` | 参数错误 | | Telegram 账号不存在 | `3` | 未找到用户 | | USDT 余额不足 | `4` | 无法完成余额支付 | | 6 小时内重复提交相同套餐 | `4` | 重复订单限制 | | Fragment 返回异常 | `5` | 下游服务拒绝或返回异常 | | 未分类系统异常 | `9999` | 请联系客服处理 | “已有 Premium”“历史订阅渠道不支持”“地区限制”等目前没有独立 `sub_code`。如果这些问题发生在后台异步购买阶段，订单通常会变成 `BUY_FAILED`。 ### 11. Premium 开通失败是否扣余额？ 需要按失败阶段区分： * 参数错误、账号不存在、余额不足：发生在扣款前，不扣余额。 * `PAY_FAILED`：通常表示余额支付没有成功。 * 已进入 `PAID` 后发生 `CREATED_FAILED` 或 `BUY_FAILED`：余额可能已经扣除。 目前没有可对外承诺的自动退款流程或退款时限。对于扣款后购买失败的订单，需要提交订单信息，由客服人工核查或重新处理。 ## 五、未到账处理 ### 12. API 成功但用户未收到 Premium，如何处理？ 请先查询： ```http GET /v1/fragment/order/{order_id} ``` 如果订单仍为 `PAID` 或 `CREATED`，请继续等待并查询。 如果订单已经是 `BUY_FAILED`、`CREATED_FAILED`，或者显示 `FINISHED` 但用户仍未收到，请联系客服，并提供： * `order_id` * `client_order_id` * Telegram username * 购买月份 * 订单创建时间 * 当前订单状态 * 创建订单时的完整响应 * 用户未到账截图 * CatFee 会员 ID 或 API Key 标识 请勿提供 API Secret。 客服 Telegram：`@CatFee_James` ## 六、username 要求 ### 13. 必须有公开 username 吗？支持 numeric user ID 吗？ 当前 API 必须提交有效 Telegram username，支持以下格式： ``` username @username https://t.me/username ``` username 长度必须为 5～32 位，只能包含字母、数字和下划线。 目前不支持 Telegram numeric user ID。因此用户需要设置可被 Fragment 查询到的公开 username。 ### 14. 提交后用户修改 username，会影响订单吗？ 通常不会。 创建订单时，系统会根据原 username 查询并保存 Telegram/Fragment 接收人标识，后续购买优先使用该标识。但为避免异常，建议用户在订单完成前不要修改或删除 username。 ## 七、价格说明 ### 15. Premium API 价格在哪里获取？ 可通过以下接口查询： ```http GET /public/premium_price ``` 示例响应： ```json { "code": 0, "data": { "months3_usdt_sun": 12500000, "months6_usdt_sun": 16500000, "months12_usdt_sun": 29500000 } } ``` 金额单位为 USDT Sun： ``` 1 USDT = 1,000,000 Sun ``` 即上述示例分别为： * 3 个月：12.5 USDT * 6 个月：16.5 USDT * 12 个月：29.5 USDT API 价格由 CatFee 系统配置。系统目前没有价格变更 Webhook，建议在展示价格或下单前查询最新价格。 ## 八、API 签名 ### 16. `/v1/premium` 完整签名示例 假设使用以下参数： ``` API Secret: demo_api_secret Timestamp: 2026-08-25T08:08:08.888Z Method: POST ``` 最终 URL： ``` https://api.catfee.io/v1/premium?client_order_id=demo-20260825-001&months=3&username=alice_123 ``` 原始待签字符串： ``` 2026-08-25T08:08:08.888ZPOST/v1/premium?client_order_id=demo-20260825-001&months=3&username=alice_123 ``` 计算方式： ``` Base64(HMAC-SHA256(原始待签字符串, API Secret)) ``` 示例签名结果： ``` rYghhRU7GfvBX5zhdc8Kv5+jmy4GcvNBmh/CBQHa2S0= ``` 完整请求： ```bash curl -X POST \ 'https://api.catfee.io/v1/premium?client_order_id=demo-20260825-001&months=3&username=alice_123' \ -H 'CF-ACCESS-KEY: YOUR_API_KEY' \ -H 'CF-ACCESS-TIMESTAMP: 2026-08-25T08:08:08.888Z' \ -H 'CF-ACCESS-SIGN: rYghhRU7GfvBX5zhdc8Kv5+jmy4GcvNBmh/CBQHa2S0=' ``` 注意事项： * query string 参与签名； * 参数顺序必须与最终发送 URL 完全一致； * HTTP 方法必须使用大写 `POST`； * 签名字符串之间没有换行或分隔符； * 时间戳使用 UTC ISO-8601 格式； * 客户端与服务器时间偏差应控制在 30 秒以内。 ## 九、测试环境与安全限制 ### 17. 是否有 sandbox/test 环境？ 系统内部存在 Nile 测试模式，但当前公开文档没有提供正式的 Premium Sandbox 服务协议。 Nile 模式不会真实为 Telegram 账号开通 Premium，只用于验证鉴权、参数、扣款及订单流程，不能用于验证真实到账。 如需进行生产环境真实测试，当前最小套餐为 3 个月。建议使用专门的测试账号、唯一 `client_order_id`，并在测试前确认账户余额及最新价格。 ### 18. 是否建议设置 IP whitelist？Rate Limit 是多少？ Premium API 当前使用： * API Key； * API Secret； * HMAC-SHA256 签名； * UTC 时间戳防重放。 建议在账户或网关支持的情况下启用固定出口 IP 白名单，并妥善保管 API Secret。 目前没有公开的 Premium 专属 Rate Limit 数值。调用方应： * 避免并发重复提交相同订单； * 为每笔业务生成唯一 `client_order_id`； * timeout 后使用相同参数和相同 `client_order_id` 串行重试； * 查询订单时采用合理轮询间隔，例如 5～10 秒一次，并设置退避策略。 # 质押宝(草稿) # 项目信息 {% openapi src="/files/39So7Di4Gj96w9cvWMzr" path="/v1/stake/public/project/{id}" method="get" %} [stake-public.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-cb3f639bdffdade9f145095926d4299144bed006%2Fstake-public.json?alt=media) {% endopenapi %} # 代理列表 {% openapi src="/files/39So7Di4Gj96w9cvWMzr" path="/v1/stake/public/transaction" method="get" %} [stake-public.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-cb3f639bdffdade9f145095926d4299144bed006%2Fstake-public.json?alt=media) {% endopenapi %} # 结算列表 {% openapi src="/files/39So7Di4Gj96w9cvWMzr" path="/v1/stake/public/daily\_bill" method="get" %} [stake-public.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-cb3f639bdffdade9f145095926d4299144bed006%2Fstake-public.json?alt=media) {% endopenapi %} # 结算详情 {% openapi src="/files/39So7Di4Gj96w9cvWMzr" path="/v1/stake/public/daily\_bill/{id}" method="get" %} [stake-public.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-cb3f639bdffdade9f145095926d4299144bed006%2Fstake-public.json?alt=media) {% endopenapi %} # 付款列表 {% openapi src="/files/39So7Di4Gj96w9cvWMzr" path="/v1/stake/public/payout" method="get" %} [stake-public.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-cb3f639bdffdade9f145095926d4299144bed006%2Fstake-public.json?alt=media) {% endopenapi %} # 未来收益 {% openapi src="/files/39So7Di4Gj96w9cvWMzr" path="/v1/stake/public/future" method="get" %} [stake-public.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-cb3f639bdffdade9f145095926d4299144bed006%2Fstake-public.json?alt=media) {% endopenapi %} # 波场伴侣 # 增加基础版地址 {% openapi src="/files/pVhJ0ykL2sLwX1iytBqK" path="/v1/mate/open/basic" method="post" %} [mate-basic-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-dee6d58223d1e73fc44512929669aa780ab6dee8%2Fmate-basic-api.json?alt=media) {% endopenapi %} # 查询基础版地址信息 {% openapi src="/files/pVhJ0ykL2sLwX1iytBqK" path="/v1/mate/open/basic/{address}" method="get" %} [mate-basic-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-dee6d58223d1e73fc44512929669aa780ab6dee8%2Fmate-basic-api.json?alt=media) {% endopenapi %} # 启动/关闭基础版地址 {% openapi src="/files/pVhJ0ykL2sLwX1iytBqK" path="/v1/mate/open/basic/{address}/enable" method="patch" %} [mate-basic-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-dee6d58223d1e73fc44512929669aa780ab6dee8%2Fmate-basic-api.json?alt=media) {% endopenapi %} # 设置配额基础版地址信息 {% openapi src="/files/pVhJ0ykL2sLwX1iytBqK" path="/v1/mate/open/basic/{address}/quota" method="patch" %} [mate-basic-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-dee6d58223d1e73fc44512929669aa780ab6dee8%2Fmate-basic-api.json?alt=media) {% endopenapi %} # 增加或减少基础版地址配额数量 {% openapi src="/files/pVhJ0ykL2sLwX1iytBqK" path="/v1/mate/open/basic/{address}/quota/increment" method="patch" %} [mate-basic-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-dee6d58223d1e73fc44512929669aa780ab6dee8%2Fmate-basic-api.json?alt=media) {% endopenapi %} # 设置自动关闭基础版地址 {% openapi src="/files/pVhJ0ykL2sLwX1iytBqK" path="/v1/mate/open/basic/{address}/auto-close" method="patch" %} [mate-basic-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-dee6d58223d1e73fc44512929669aa780ab6dee8%2Fmate-basic-api.json?alt=media) {% endopenapi %} # 设置过期时间基础版地址 {% openapi src="/files/pVhJ0ykL2sLwX1iytBqK" path="/v1/mate/open/basic/{address}/expire" method="patch" %} [mate-basic-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-dee6d58223d1e73fc44512929669aa780ab6dee8%2Fmate-basic-api.json?alt=media) {% endopenapi %} # 设置备注基础版地址 {% openapi src="/files/pVhJ0ykL2sLwX1iytBqK" path="/v1/mate/open/basic/{address}/remark" method="patch" %} [mate-basic-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-dee6d58223d1e73fc44512929669aa780ab6dee8%2Fmate-basic-api.json?alt=media) {% endopenapi %} # 设置基础版地址 {% openapi src="/files/pVhJ0ykL2sLwX1iytBqK" path="/v1/mate/open/basic/{address}" method="put" %} [mate-basic-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-dee6d58223d1e73fc44512929669aa780ab6dee8%2Fmate-basic-api.json?alt=media) {% endopenapi %} # 删除基础版地址 {% openapi src="/files/pVhJ0ykL2sLwX1iytBqK" path="/v1/mate/open/basic/{address}" method="delete" %} [mate-basic-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-dee6d58223d1e73fc44512929669aa780ab6dee8%2Fmate-basic-api.json?alt=media) {% endopenapi %} # 带宽保护 {% openapi src="/files/pVhJ0ykL2sLwX1iytBqK" path="/v1/mate/open/basic/{address}/bandwidth-guarantee" method="patch" %} [mate-basic-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-dee6d58223d1e73fc44512929669aa780ab6dee8%2Fmate-basic-api.json?alt=media) {% endopenapi %} # 波场伴侣Pro # 添加Pro地址 {% openapi src="/files/p5wrAmV13XvhchMW9QpO" path="/v1/mate/open/pro" method="post" %} [mate-pro-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-2c8c9165cc26b6c8b8b772387f94c32e54fc6a5c%2Fmate-pro-api.json?alt=media) {% endopenapi %} # 得到Pro地址信息 {% openapi src="/files/p5wrAmV13XvhchMW9QpO" path="/v1/mate/open/pro/{address}" method="get" %} [mate-pro-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-2c8c9165cc26b6c8b8b772387f94c32e54fc6a5c%2Fmate-pro-api.json?alt=media) {% endopenapi %} # 启动/暂停Pro地址 {% openapi src="/files/p5wrAmV13XvhchMW9QpO" path="/v1/mate/open/pro/{address}/enable" method="patch" %} [mate-pro-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-2c8c9165cc26b6c8b8b772387f94c32e54fc6a5c%2Fmate-pro-api.json?alt=media) {% endopenapi %} # 修改Pro配额模式与数量 {% openapi src="/files/p5wrAmV13XvhchMW9QpO" path="/v1/mate/open/pro/{address}/quota" method="patch" %} [mate-pro-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-2c8c9165cc26b6c8b8b772387f94c32e54fc6a5c%2Fmate-pro-api.json?alt=media) {% endopenapi %} # 自动关闭Pro地址 {% openapi src="/files/p5wrAmV13XvhchMW9QpO" path="/v1/mate/open/pro/{address}/auto-close" method="patch" %} [mate-pro-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-2c8c9165cc26b6c8b8b772387f94c32e54fc6a5c%2Fmate-pro-api.json?alt=media) {% endopenapi %} # 设置/取消Pro过期时间 {% openapi src="/files/p5wrAmV13XvhchMW9QpO" path="/v1/mate/open/pro/{address}/expire" method="patch" %} [mate-pro-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-2c8c9165cc26b6c8b8b772387f94c32e54fc6a5c%2Fmate-pro-api.json?alt=media) {% endopenapi %} # 设置Pro备注 {% openapi src="/files/p5wrAmV13XvhchMW9QpO" path="/v1/mate/open/pro/{address}/remark" method="patch" %} [mate-pro-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-2c8c9165cc26b6c8b8b772387f94c32e54fc6a5c%2Fmate-pro-api.json?alt=media) {% endopenapi %} # 删除Pro地址 {% openapi src="/files/p5wrAmV13XvhchMW9QpO" path="/v1/mate/open/pro/{address}" method="delete" %} [mate-pro-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-2c8c9165cc26b6c8b8b772387f94c32e54fc6a5c%2Fmate-pro-api.json?alt=media) {% endopenapi %} # 一单一付 # 预估资源费用 {% openapi src="/files/mASYqPqYbNkoFrs0gDaT" path="/v1/mate/open/transaction/estimate" method="post" %} [mate-transaction-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-791ee6e458fc7d9e9792f9ece9b84a0e6e0cb654%2Fmate-transaction-api.json?alt=media) {% endopenapi %} # 创建代理资源交易 {% openapi src="/files/mASYqPqYbNkoFrs0gDaT" path="/v1/mate/open/transaction" method="post" %} [mate-transaction-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-791ee6e458fc7d9e9792f9ece9b84a0e6e0cb654%2Fmate-transaction-api.json?alt=media) {% endopenapi %} # 更新支付资源费哈希 {% openapi src="/files/mASYqPqYbNkoFrs0gDaT" path="/v1/mate/open/transaction/pay/{order\_id}" method="post" %} [mate-transaction-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-791ee6e458fc7d9e9792f9ece9b84a0e6e0cb654%2Fmate-transaction-api.json?alt=media) {% endopenapi %} # 得到交易订单信息 {% openapi src="/files/mASYqPqYbNkoFrs0gDaT" path="/v1/mate/open/transaction/{order\_id}" method="get" %} [mate-transaction-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-791ee6e458fc7d9e9792f9ece9b84a0e6e0cb654%2Fmate-transaction-api.json?alt=media) {% endopenapi %} # 资源速充 # 预估速充资源 {% openapi src="/files/ewf4Gdd868hrqmjBY8nB" path="/v1/flash/open/estimate" method="get" %} [mate-flash-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-bb46eeddf64758de115d1ebf15e7578380c81278%2Fmate-flash-api.json?alt=media) {% endopenapi %} # 创建速充订单 {% openapi src="/files/ewf4Gdd868hrqmjBY8nB" path="/v1/flash/open/order" method="post" %} [mate-flash-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-bb46eeddf64758de115d1ebf15e7578380c81278%2Fmate-flash-api.json?alt=media) {% endopenapi %} # 查询速充订单 {% openapi src="/files/ewf4Gdd868hrqmjBY8nB" path="/v1/flash/open/order/{order\_id}" method="get" %} [mate-flash-api.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-bb46eeddf64758de115d1ebf15e7578380c81278%2Fmate-flash-api.json?alt=media) {% endopenapi %} # 实时归集 # 添加地址 {% openapi src="/files/wQKSZAbqnH7mCorHuykX" path="/v1/sweep/open/address" method="post" %} [sweep.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-c7493eb7a99af8864dc0089153917a3baf99c774%2Fsweep.json?alt=media) {% endopenapi %} # 删除地址 {% openapi src="/files/wQKSZAbqnH7mCorHuykX" path="/v1/sweep/open/address" method="delete" %} [sweep.json](https://1836196186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6OSDuieZV2PmhnU7qYgh%2Fuploads%2Fgit-blob-c7493eb7a99af8864dc0089153917a3baf99c774%2Fsweep.json?alt=media) {% endopenapi %} # 什么是波场能量？ **波场能量（Energy）** 是波场（TRON）区块链上的一种特殊资源，主要用于执行智能合约交易。波场通过能量和带宽的双资源模型，优化了链上操作的成本和效率。能量的存在使得用户可以降低或完全免除某些操作（如转账 TRC-20 代币）中产生的手续费。 在波场上，所有的智能合约操作都会消耗 **能量（Energy）**，而简单交易（如 TRX 转账）则主要消耗 **带宽（Bandwidth）**。通过冻结 TRX，用户可以获得一定量的能量或带宽，从而更经济地进行链上操作。 *** #### 波场能量的作用 能量在波场区块链的以下场景中非常关键： 1. **智能合约执行**：调用 TRC-20 或 TRC-721 合约（例如转账 USDT 或创建 NFT）需要能量。 2. **减少手续费**：如果账户中有足够的能量，交易可以免除 TRX 手续费。 3. **提高资源利用率**：通过能量和带宽的设计，波场为开发者和用户提供了更灵活的资源分配方式。 *** #### 波场能量如何获取？ 能量的获取方式主要有以下几种： 1. **冻结 TRX**\ 通过冻结一定数量的 TRX，用户可以获得相应数量的能量。冻结的 TRX 会根据一定规则生成能量，冻结的时间越长，获得的能量越多。冻结的 TRX 仍属于用户，但在冻结期内无法进行转账或消费。解冻后，冻结的 TRX 会恢复正常，但能量会失效。 2. **从 CatFee.IO 购买能量**\ 除了冻结 TRX，用户还可以通过 **CatFee.IO** 平台购买能量。这为用户提供了一个更加灵活的方式，特别适合那些不希望冻结大量 TRX 或者短期内需要大量能量的用户。购买的能量可以直接用于链上操作，无需等待冻结期。 *** #### 转 USDT 的示例：波场能量的实际应用 假设你需要在波场链上转账 USDT（TRC-20 代币），以下是具体操作及能量的应用： **1. 转账前准备** * **目标**：将 100 USDT 转账给朋友。 * **资源需求**：USDT 是 TRC-20 标准代币，转账会调用智能合约的 `transfer()` 方法，因此需要消耗 **能量** 和 **带宽**。 **2. 查询账户资源** * 在波场钱包中检查账户是否有足够的能量和带宽： * 如果能量不足，需要冻结 TRX 或从 CatFee.IO 购买能量。 * 如果既没有能量也没有足够的 TRX，则转账时会直接扣除 TRX 手续费。 **3. 冻结 TRX 或购买能量** 假如你的账户中没有足够的能量，你可以通过以下方式获取： * **冻结 500 TRX**，用于生成能量（冻结后不会扣除 TRX，但在冻结期内无法解冻使用）。 * **通过 CatFee.IO 购买能量**，这种方式适合那些不希望冻结大量 TRX 或需要快速获得能量的用户。 * 你可以在 CatFee.IO 上支付 TRX 或其他波场链支持的代币来购买所需的能量。 **4. 发起 USDT 转账** 在钱包中输入接收方地址和金额（例如 100 USDT），确认交易。 系统会根据以下规则消耗资源： * **能量**：用于合约计算逻辑，比如执行 USDT 合约的 `transfer()` 函数。 * **带宽**：用于存储和广播交易信息。 如果账户中的能量充足，则无需支付 TRX 手续费。 **5. 实际消耗** * 假设此次交易消耗了 20,000 能量，而你的账户通过冻结或购买能量生成了 30,000 能量，则交易完成后 **不会扣除 TRX**。 * 如果能量不足，比如仅剩 10,000 能量，则系统会额外扣除部分 TRX（例如 1 TRX）作为手续费。 *** #### 波场能量的优点 1. **降低交易成本**：对于频繁使用 TRC-20 代币的用户，冻结 TRX 获得能量比直接支付手续费更经济，而通过 CatFee.IO 购买能量则提供了更灵活的选择。 2. **灵活资源分配**：用户可以根据需求选择获取能量或带宽，满足不同场景需求。 3. **激励机制**：冻结 TRX 不会损失资产，既为用户提供了资源，又增强了网络的安全性和去中心化。 *** #### 总结 波场能量是波场区块链独特的资源优化设计，为用户和开发者提供了低成本、高效率的链上操作体验。在涉及智能合约的场景（如转账 USDT、借贷 DeFi、创建 NFT 等）时，能量的合理使用不仅能减少手续费，还能提升交易效率。对于频繁交互波场生态的用户来说，冻结 TRX 或从 CatFee.IO 购买能量是一个值得考虑的策略。 如果你计划使用波场链，了解能量的获取和消耗规则将帮助你更好地管理资源，降低链上操作成本！ # 为什么要租赁能量？ 节省资源、提高效率、安全可靠 在 **TRON**（波场）网络中，进行 **TRC-20 代币**（如 **USDT**）转账时，需要消耗 **能量** 资源。用户有两种主要方式获取能量：一种是通过 **燃烧 TRX**，另一种是 **租赁能量**。虽然燃烧 TRX 可以直接获得能量，但租赁能量尤其是在 **CatFee.IO** 这样的知名平台上租赁，提供了诸多优势，包括节省资金、提高转账效率以及保障资金安全。 以下是为什么要选择 **租赁能量** 的几个重要原因： #### 1. **节省资金和优化资金流动性** * **避免冻结 TRX**：如果你选择通过燃烧 TRX 来获取能量，你需要将 TRX 冻结一定时间。冻结的 TRX 在冻结期内不能随时使用，限制了你的资金流动。而通过租赁能量，你不需要冻结 TRX，能够保持 **资金流动性**，在需要时随时使用。 * **低成本获取能量**：与直接燃烧 TRX 相比，租赁能量的成本大幅降低。例如，若目标地址没有 **USDT**，通过租赁能量转账可能仅需要 **6 TRX**，而燃烧 TRX 则需要 **26 TRX**。即使目标地址有 **USDT**，租赁能量也比燃烧 TRX 更为经济（租赁仅需要 **3 TRX**，燃烧则需要 **13 TRX**）。 #### 2. **提高转账效率** * **即时获得能量**：通过 **CatFee.IO** 这样的能量租赁平台，用户可以在 **短时间内** 获得所需的能量，避免等待冻结期或处理其他繁琐操作。对于频繁进行 **TRC-20 代币转账** 的用户，租赁能量可以大大提高交易的效率。 * **灵活性和按需购买**：租赁能量使得用户可以根据实际需求购买精确数量的能量，而不是预先冻结大量的 TRX，这样更加 **灵活** 和 **高效**。 #### 3. **保障资金安全** * **防止钓鱼平台的风险**：目前市场上存在许多低价能量租赁平台，其中一些平台可能是 **钓鱼地址**，它们通过提供看似便宜的价格，诱使用户转账 **USDT** 到错误地址，造成资金损失。相比之下，像 **CatFee.IO** 这样的知名平台，提供了 **资金返还机制**，如果用户转错了地址，平台会 **百分百退还** 转错的资金，确保用户资产的安全。 * **信誉保障**：选择信誉良好的平台，如 **CatFee.IO**，可以避免遭遇不正规平台的欺诈风险，保障资金的安全性。 #### 4. **灵活的支付方式和透明的费用** * **多种支付方式**：像 **CatFee.IO** 这样的正规平台通常提供多种支付方式，用户可以使用 **TRX、USDT** 等方式支付租赁费用，选择更加便捷的支付方式。 * **透明定价**：正规平台的能量租赁费用通常是透明且固定的，不会出现额外的隐藏费用。用户能够明确了解所需费用，避免因不清楚的费用结构而产生不必要的支出。 #### 5. **避免不必要的损失** * **燃烧 TRX 无法回收**：通过燃烧 TRX 来获取能量，虽然可以获得能量，但所燃烧的 TRX 是无法回收的。而通过租赁能量，用户只支付实际使用的费用，并且 **不需要冻结大量 TRX**，有效减少资金损失的风险。 * **低风险操作**：租赁能量不涉及冻结和解冻操作，避免了由于操作错误导致的资金流动性问题。 #### 6. **专注于交易，不必担心资源问题** * **自动化分配资源**：当你在 **CatFee.IO** 上租赁能量时，平台会根据你的转账需求自动分配所需的资源，避免了因资源不足导致的交易失败。 * **省时省力**：不需要去手动操作冻结 TRX，也不需要时刻关注 TRON 网络资源的变化。平台会根据市场的需求自动进行调整，确保你能够顺利进行转账。 #### 总结 选择租赁能量，特别是在像 **CatFee.IO** 这样的知名平台上租赁，提供了诸多优势： 1. **节省资金**，避免冻结大量 TRX。 2. **提高转账效率**，确保及时完成交易。 3. **资金安全保障**，避免因选择低价平台而遭受损失。 4. **灵活便捷的支付方式**，透明费用结构。 5. **低风险操作**，减少因操作失误带来的损失。 6. **无需冻结 TRX，保障资金流动性**，灵活应对转账需求。 通过租赁能量，用户能够更加高效、安全、经济地完成 **TRON** 网络上的交易，尤其对于频繁转账的用户，租赁能量是一个更加优选的解决方案。如果你有更多问题或需要进一步帮助，随时告诉我！ # 如何解决“OUT OF ENERGY” 错误？ 在使用波场（TRON）网络进行 TRC20 合约调用（如转账 USDT）时，不少用户可能遇到过这样的提示： > ❌ **FAILED - OUT OF ENERGY** 这是一种非常常见的错误提示，意味着你此次合约调用所需的 **能量（Energy）不足**。本文将深入剖析这个问题的成因以及快速有效的解决办法。 *** ### 常见原因分析： #### 1. 地址中没有足够的能量 波场的合约调用（例如转账 USDT）并非免费。它依赖网络资源——**能量（Energy）**。如果你的地址中没有质押 TRX 以获取能量，也没有从其他渠道获取能量，就会触发 `OUT OF ENERGY` 错误。 *** #### 2. 地址中没有足够的 TRX 支付调用费用 当地址缺少能量时，系统将自动用 **TRX 来“燃烧”购买能量**。例如： * 向一个 **没有 USDT 的地址转账 USDT**，合约调用需要 **130,285 点能量**，折合大约 **27.74 TRX**； * 向一个 **已有 USDT 的地址转账 USDT**，只需要 **64,285 点能量**，约 **13.7 TRX**。 如果你的账户中 TRX 不足，也会导致合约调用失败，出现 OUT OF ENERGY 错误。 *** #### 3. 程序调用中手续费设置不足 很多开发者在使用程序（如 Node.js、Python 脚本）调用合约时，会自定义设置最大消耗的手续费上限。如果设置得过低，例如设置为 `maxFeeLimit: 10 TRX`，但实际需要 27.74 TRX，则调用同样会失败。 *** ### 如何解决这个问题？ #### ✅ 方式一：存入足够的 TRX 确保钱包中有足够的 TRX 来支付燃烧能量的费用。虽然这是最直接的办法，但长期依赖燃烧 TRX 的方式进行交易，成本较高，且不可控。 *** #### ✅ 方式二：在 **CatFee.IO** 购买稳定、即时的波场能量 如果你不希望质押大量 TRX 或者手动调整手续费，推荐使用专业能量供应平台 [**CatFee.IO**](https://catfee.io/)。 **CatFee 的优势：** * ⚡ **实时到账**：下单后数秒内即获得能量； * 🛡️ **100% 安全保障**：即使转错 USDT 也会原路退还； * 💸 **超低费用**：转 USDT 的总手续费最低仅需 **2 TRX 起**； * 🔌 **支持 API 自动租赁**：支持开发者集成能量调用流程，适合批量转账、交易所钱包等场景； * 🤝 **专业团队运维**：技术团队来自国内一线区块链公司，稳定性极强。 *** #### ✅ 方式三：编程设置合理的手续费上限 在你使用 SDK 或编程调用时，例如使用 `tronWeb` 或 `tronpy`，建议设置 `feeLimit` 至少为 `30 TRX` 以上，以确保足够支付最复杂的 USDT 转账。 *** ### “OUT OF ENERGY” 是波场网络中的资源限制错误，主要由能量不足或 TRX 不足导致。通过存入足够 TRX 或直接在 [CatFee.IO](https://catfee.io/) 购买所需能量，可以快速、高效地解决这一问题。对于开发者或批量调用需求，CatFee 提供的 API 能量服务将大大简化流程，节约成本。 # 为什么不能用中心化交易所的钱包购买能量？ 使用 **中心化交易所**（CEX）的钱包购买 **TRON 能量** 之所以不可行，主要有以下几个原因： #### 1. **钱包控制权问题** 中心化交易所的钱包是由交易所管理和控制的，而不是由你直接控制。交易所钱包中的资产并不属于用户单独所有，而是由交易所作为一个整体进行管理和托管。这意味着你无法直接访问该钱包的私钥或进行自主操作（如冻结 TRX 或购买能量）。而 **TRON 能量的购买和冻结** 操作需要用户控制自己的钱包，进行资产冻结或购买能量，交易所钱包无法提供这种功能。 #### 2. **TRON 能量的获取与冻结机制** TRON 的能量是通过 **冻结 TRX** 获得的，而冻结 TRX 是一种链上操作，需要用户在 **自己控制的钱包** 中执行。冻结的 TRX 会在链上生成能量，并且在冻结期内，用户无法转移这些 TRX。因此，冻结操作需要通过用户的私钥进行签名和授权，而这一过程只有 **用户控制的钱包** 才能执行。中心化交易所的 **钱包并不支持冻结 TRX**，也无法参与这些链上的资源获取操作。 #### 3. **CatFee.IO 提供的购买能量方式** CatFee.IO 提供了一种从 **第三方平台**购买能量的方式，允许用户 **使用波场链的资产** 或其他支付方式，直接购买所需的能量。这个操作是通过 CatFee.IO API 或服务进行的，并且是针对用户的自主钱包地址的，而非交易所的托管钱包。只有当你有自己的钱包并能够控制该钱包地址时，才能购买到适用于你的链上操作的能量。 #### 4. **交易所的资金流动限制** 中心化交易所的钱包通常只支持常规的转账和交易操作，如**提现、存入和交易**，它并不具备进行复杂的链上操作（如冻结资产、购买链上资源等）的能力。由于 TRON 能量的获取涉及到 **链上冻结** 和 **签名认证**，这些操作通常只能在用户拥有完全控制权限的钱包中进行。 #### 5. **安全性和去中心化** 通过自有的钱包操作 TRON 能量获取，能够增强用户的安全性和去中心化性。用户通过自己的私钥和钱包来管理资产和操作，而不是将资产托管在中心化平台上，从而避免了中心化交易所可能带来的风险（如平台冻结、资产丢失等问题）。 #### 结论 因此，中心化交易所的钱包无法直接用来购买 TRON 能量，原因在于交易所钱包是由平台控制的，不具备 **冻结 TRX** 或 **购买链上资源** 等操作功能。要购买或获取 TRON 能量，你需要使用 **自己的控制钱包**，并通过 **冻结 TRX** 或从 **CatFee.IO 等平台购买** 能量。 如果你有更多问题或需要进一步了解，请随时告诉我！ # 什么是中心化交易所？ **中心化交易所**（Centralized Exchange，简称 CEX）是一个由第三方公司或机构管理的加密货币交易平台。在这些平台上，用户将加密货币存储在由交易所控制的钱包中，并通过该平台进行买卖、交易、兑换等操作。与去中心化交易所（DEX）不同，中心化交易所提供了更高的流动性和用户友好的界面，但也伴随着一些风险和局限性。 #### 中心化交易所的特点 1. **托管式钱包** * 在中心化交易所中，用户的加密资产存放在由交易所管理的钱包中，而不是用户自己的私有钱包。这意味着用户没有控制自己的私钥。 * 交易所负责保管用户的资产，提供存储安全性。然而，这也意味着用户如果想提现或交易，必须依赖平台的操作。 2. **订单撮合和流动性** * 中心化交易所通过自己的订单撮合系统来匹配买卖订单。用户发布买单或卖单，平台通过匹配这些订单来完成交易。 * 这些交易所通常具有非常高的流动性，允许用户快速执行交易，不必担心找不到对手方。 3. **交易对种类丰富** * 许多中心化交易所提供多种交易对，用户可以进行不同种类的加密货币交易。例如，常见的交易对包括 **BTC/USDT**、**ETH/BTC**、**TRX/USDT** 等。 * 同时，也支持传统法币与加密货币之间的交易（如 **USDT/USD**），使用户可以更方便地将加密资产兑换成法币，反之亦然。 4. **更高的交易速度** * 由于交易所管理订单撮合系统，交易的执行速度非常快。相比去中心化交易所（DEX），CEX 通常能够提供更低的延迟和更高的效率。 5. **客户支持和易用性** * 大多数中心化交易所都提供全天候的客户服务和详细的交易指导，帮助新用户入门和解决技术问题。 * 用户界面通常更为简洁和友好，使新手更容易使用这些平台。 6. **KYC（身份验证）和合规性** * 大多数中心化交易所要求用户进行 KYC（身份验证）过程。这是为了符合相关的法律法规，尤其是在反洗钱（AML）和打击恐怖主义融资（CFT）方面。 * 用户需要提供身份证明、住址证明等信息来完成身份验证。 *** #### 中心化交易所的优缺点 **优点：** 1. **高流动性**：交易所拥有大量的买卖订单，可以确保市场的流动性，交易更为顺畅。 2. **用户友好**：界面设计直观，适合没有经验的用户，交易过程简便。 3. **交易速度快**：由于交易所控制订单撮合系统，交易执行非常迅速。 4. **多种交易工具**：支持多种交易对，提供期货、杠杆交易等高级功能，适合不同的交易需求。 **缺点：** 1. **资产安全问题**：由于用户资产存放在交易所的托管钱包中，交易所若遭到黑客攻击或内部操作不当，用户的资产可能面临风险。 2. **中心化控制**：交易所作为中心化平台，控制用户的资金和交易。一旦平台出现问题，用户可能失去对资产的控制。 3. **隐私问题**：大多数中心化交易所需要进行KYC身份验证，可能暴露用户的隐私信息。 4. **监管风险**：如果交易所所在国家或地区的监管政策发生变化，可能会对用户的账户、资金和交易产生影响。 *** #### 常见的中心化交易所示例 * **Binance（币安）**\ 世界领先的加密货币交易平台之一，提供丰富的交易对和高级交易工具。\ 网址：[www.binance.com](https://www.binance.com/) * **Coinbase**\ 主要面向美国市场的交易所，简单易用，适合新手。\ 网址：[www.coinbase.com](https://www.coinbase.com/) * **Kraken**\ 提供多种加密货币交易，并且具有较高的安全性和流动性。\ 网址：[www.kraken.com](https://www.kraken.com/) * **OKX**\ 提供广泛的加密资产交易和衍生品交易，同时支持期货、杠杆交易等。\ 网址：[www.okx.com](https://www.okx.com/) *** #### 总结 中心化交易所（CEX）为用户提供了便捷、安全、流动性高的交易环境，但它们也带来了潜在的风险，特别是在资产安全和隐私方面。选择合适的交易所时，用户应根据自身需求、平台的信誉、交易费用、安全措施等多个因素做出决策。并且，许多用户也逐渐意识到去中心化交易所（DEX）带来的更多自主控制和隐私保护优势，因此，一些用户可能会选择使用去中心化交易所进行交易，以避免资产和个人信息暴露给第三方平台。 # 波场上转USDT需要多少能量？ #### 转USDT需要多少能量和带宽？ 在 **TRON**（波场）网络中，转账 **USDT**（TRC-20 代币）会消耗两种主要资源：**能量（Energy）** 和 **带宽（Bandwidth）**。这些资源用于支付交易的计算和存储费用。具体的资源消耗会根据转账的目的地址是否已经包含USDT而有所不同。 #### 1. **如果转出的目的地址已有USDT**： * **能量需求**：**64,285 能量(无能量需要燃烧大约13.5TRX)** * **带宽需求**：**350 带宽** #### 2. **如果转出的目的地址没有USDT**： * **能量需求**：**130,285 能量(无能量需要燃烧大约27.7TRX)** * **带宽需求**：**350 带宽** #### 为什么会有这种差异？ TRC-20 代币是通过 **智能合约** 实现的，而 **转账 USDT** 本质上是对 TRC-20 合约的 `transfer()` 方法调用。不同的转账场景可能会消耗不同的能量： * **如果目标地址已有 USDT**，TRON 网络能够更高效地处理转账操作，因此所需的能量较少。 * **如果目标地址没有 USDT**，网络需要进行更多的初始化操作，导致消耗更多的能量。 #### 推荐购买的能量 由于波场的资源模型是动态变化的，推荐购买 **稍微多一点的能量**，以确保能应对网络资源变化，避免因资源不足导致转账失败： * **如果目的地址已有 USDT**，建议购买 **65,000 能量**。 * **如果目的地址没有 USDT**，建议购买 **131,000 能量**。 这样做可以确保即使在网络拥堵或其他因素影响下，你的转账也能顺利完成。 *** #### TRON 网络的资源模型 TRON 的资源模型基于 **能量（Energy）** 和 **带宽（Bandwidth）**，其中： * **能量（Energy）**：主要用于支付智能合约调用和执行所需的计算资源。每次调用 TRC-20 合约（如转账 USDT）都会消耗一定的能量。 * **带宽（Bandwidth）**：用于支付交易数据的存储和传输费用。简单的 TRX 转账一般消耗带宽，而 TRC-20 代币的转账则可能同时消耗能量和带宽。 #### 如何获取能量？ **1. 冻结 TRX 获取能量** 在 TRON 网络中，用户可以通过 **冻结 TRX** 来获取 **能量** 和 **带宽**。冻结的 TRX 会产生相应的资源，冻结期内，用户不能随意转移这些 TRX，但可以获得资源。 * **冻结 TRX** 是一种长期持有的方式。冻结的 TRX 一旦解冻，能量和带宽也会随之消失，但冻结期间的资源是有效的。 * 用户冻结一定数量的 TRX 后，系统会自动分配能量和带宽。冻结的 TRX 越多，能量和带宽越高。 **2. 购买能量** 如果你不希望冻结 TRX，或者冻结的 TRX 产生的能量不足，可以选择从 **CatFee.IO** 等平台购买能量。购买能量的好处是灵活且即时，不需要等待冻结期的到来。 在 **CatFee.IO** 等平台上，你可以： * 直接购买所需的能量，以支付智能合约操作的费用。 * 购买的能量可以立即用于转账、调用智能合约等操作。 *** #### 相关知识：TRC-20 和 TRON 网络 **TRC-20** 是 TRON 网络上的一种代币标准，类似于以太坊的 **ERC-20** 标准。TRC-20 代币是通过 TRON 的 **智能合约** 来发行和管理的，广泛应用于 DeFi、NFT 以及其他区块链项目中。转账 TRC-20 代币（如 USDT）需要消耗 **能量**，而简单的 TRX 转账只需消耗 **带宽**。 * **TRC-20代币** 需要消耗 **能量** 来执行智能合约。每当用户进行转账时，实际上是在调用 TRC-20 合约的 `transfer()` 方法。 * **TRX 转账** 则仅消耗 **带宽**，带宽用于支付交易的存储和传输费用。 #### 结论 **转USDT**所需的 **能量** 和 **带宽** 资源如下： * **目的地址已有USDT**：消耗 **64,285 能量** 和 **350 带宽**。 * **目的地址没有USDT**：消耗 **130,285 能量** 和 **350 带宽**。 推荐购买能量如下： * **如果目的地址已有 USDT**，建议购买 **65,000 能量**。 * **如果目的地址没有 USDT**，建议购买 **131,000 能量**。 如果你的账户没有足够的能量，可以选择 **冻结 TRX** 或 **通过 CatFee.IO 等平台购买能量** 来补充能量和带宽，确保交易顺利进行。 # 已经租赁了能量，为什么转账还是失败？ 即使你已经租赁了能量，转账依然可能失败。以下是一些可能的原因，帮助你排查和解决问题： #### 1. **能量不足** 虽然你已经租赁了能量，但实际的转账可能需要更多的能量，尤其是当： * **目标地址没有USDT**，或者 * **网络拥堵或资源需求高**时，转账可能会消耗更多的能量。 例如，转账至没有USDT的地址通常需要 **130,285 能量**，如果你租赁的能量少于这个数，转账就会失败。 **解决方案：** * 检查你的租赁能量是否足够，特别是在目标地址没有USDT时。 * 可以通过平台如 **CatFee.IO** 增加租赁的能量量，确保能够完成交易。 #### 2. **带宽不足** TRON 网络还要求一定的 **带宽** 资源来处理交易。如果带宽不足，交易也可能失败，尤其是 **TRC-20 代币** 转账（如 USDT）时，它们会消耗带宽和能量。 **解决方案：** * 确保你有足够的带宽资源。如果带宽不足，可以通过 **冻结 TRX** 来获得带宽，或者购买更多带宽。 #### 3. **智能合约执行失败** 如果你在转账时调用了智能合约（例如，转账 TRC-20 代币），且智能合约出现错误（如目标地址无效、转账金额错误等），交易会失败。智能合约在执行时消耗的能量较多，如果合约执行失败，已经消耗的能量不会退还。 **解决方案：** * 检查转账的 **地址** 是否有效，**金额** 是否正确。 * 确保目标地址能够接收 USDT（即该地址必须支持 TRC-20 代币）。 #### 4. **账户的冻结资源问题** 在 TRON 网络上，用户可以通过 **冻结 TRX** 来获得 **带宽** 和 **能量**。如果你冻结的 TRX 数量不够，可能无法提供足够的带宽或能量来完成转账。即使你租赁了能量，如果账户中没有足够的带宽，交易也会失败。 **解决方案：** * 通过 **冻结 TRX** 获取更多带宽和能量。 * 确保冻结的 TRX 足够支付转账的能量和带宽费用。 #### 5. **TRON 网络拥堵** 当 TRON 网络出现 **高负载** 或 **拥堵** 时，交易可能会因为资源不足或交易队列过长而失败。即使你有足够的能量和带宽，网络的高拥堵也可能导致交易无法及时处理。 **解决方案：** * 尝试等待网络拥堵缓解后再进行交易。 * 在高峰期尽量避免进行频繁的转账，或通过一些平台购买额外资源，提升交易的优先级。 #### 6. **交易签名或网络问题** 如果交易的 **签名** 错误，或者在发送交易时遇到 **网络问题**，也可能导致交易失败。这类问题通常出现在请求签名时，或者网络连接不稳定时。 **解决方案：** * 确保交易的 **签名** 正确并符合网络要求。 * 检查网络连接是否稳定，避免网络问题导致交易提交失败。 *** #### 总结 即使你已经租赁了能量，转账失败可能是由于以下几个原因： * 能量不足（特别是目标地址没有USDT时）。 * 带宽不足。 * 智能合约执行失败或参数错误。 * 冻结的 TRX 资源不够。 * 网络拥堵。 * 交易签名错误或网络问题。 解决方案是增加能量或带宽，检查转账参数，并确保 TRON 网络没有拥堵。如果问题依然存在，建议联系能量租赁平台（如 CatFee.IO）获取帮助，或者咨询 **TRON 官方支持**。 # 为什么有些能量租赁特别便宜？ 为什么有些能量租赁特别便宜？——警惕背后的风险 在 **TRON**（波场）网络中，能量是进行 TRC-20 代币转账（如 USDT）的关键资源。为了进行交易，用户需要消耗一定的能量，而有些平台或地址提供的能量租赁价格异常便宜，例如 **转0.1 TRX 获得 65,000 能量**。看似很优惠，但背后往往隐藏着极大的风险，特别是一些 **钓鱼地址**，它们以低价吸引用户，将用户引导到错误的地址，从而骗取用户的 **USDT** 或其他资产。 #### 1. **低价能量租赁的诱惑** 很多用户为了节省成本，可能会看到一些提供 **低价能量** 的地址，譬如 **转0.1 TRX 获得 65,000 能量**，这听起来非常诱人，远低于市场价格。这个价格看似非常优惠，吸引了大量用户尝试。然而，实际情况往往并非如此简单，这类地址很可能是 **钓鱼地址**，其真正的目的是诱使用户进行 **USDT** 转账。 #### 2. **钓鱼地址的操作手法** 这些低价能量租赁地址通常不提供真实的能量租赁服务。它们通过以下方式实施欺诈： * **假冒能量租赁平台**：这些钓鱼地址看起来与合法的能量供应商相似，但它们并不提供实际的能量租赁服务。相反，它们通过诱人的价格吸引用户，将 **USDT** 或其他加密货币转到这些地址。 * **资金无法追回**：一旦用户转账，资金会迅速消失，而这些钓鱼地址不会退还任何转错的 **USDT**，即使是转错地址的用户也无法找回资产，造成严重的资金损失。 #### 3. **CatFee.IO的保障：安全与透明** 相比之下，像 **CatFee.IO** 这样的正规能量供应商则提供了更高的保障。在 **CatFee.IO** 平台上购买能量，用户可以享受到： * **真实透明的服务**：CatFee.IO 提供的能量租赁服务是合法、透明且经过验证的，用户可以安心使用。 * **资金安全保障**：如果用户在不小心将 **USDT** 转错到能量租赁地址时，CatFee.IO 会百分百退还用户的 **USDT**，保证用户资金的安全。而不像那些钓鱼平台，用户的资金一旦转账便无法追回。 #### 4. **低价能量的风险与谨慎选择** 虽然 **低价能量** 看起来非常吸引人，但用户一定要警惕这背后可能存在的风险。选择能量租赁服务时，千万不要只看价格，更要考虑 **平台的信誉** 和 **安全性**。一些看似便宜的服务往往可能付出巨大的代价，特别是如果不小心将资产转入了错误的地址。 #### 5. **如何避免钓鱼风险** 为了避免因小失大，用户在选择能量租赁平台时应该注意以下几点： * **选择信誉良好的平台**：选择像 **CatFee.IO** 这样的知名平台，它们有保障的资金返还机制，可以最大限度地确保用户资金的安全。 * **避免不明地址**：如果一个能量租赁地址看起来过于便宜或者是未知的平台，务必保持警惕，避免轻易相信过于吸引的价格。 * **确认地址的合法性**：在进行转账前，一定要确保地址的合法性和真实性，最好先进行一些调查或询问有经验的用户。 #### 6. **总结：千万不能因小失大** 总之，虽然低价能量租赁可能看起来非常诱人，但其背后很可能隐藏着巨大的风险。通过钓鱼地址，骗子能够骗取用户的 **USDT** 和其他资产，而一旦发生转错地址的情况，用户将无法追回资金。为了保护自己的资产安全，选择 **CatFee.IO** 这样信誉良好、提供资金保障的能量供应平台是非常重要的。 切记：**不要为了便宜的能量而冒险，千万不要因小失大**。 --- [Next Page](/llms-full.txt/1)