SuperAPI AI 工具集

hub-api-integration

编程与开发

查看项目

更新于 11-09 16:45

技能介绍

用途

该技能用于设计将 PCS Hub 兑换功能嵌入外部 UI(钱包应用、移动应用、WebView、合作浏览器、无头机器人等)的完整集成规格。它产出集成规范与交付物,不是可执行的兑换代码。

主要能力

  • 根据集成需求确定集成模式:仅报价、报价+路由预览、完整执行交接。
  • 生成前端界面与状态转移图,覆盖代币选择、金额输入、报价获取(防抖约500毫秒)、路由展示、刷新/重新报价(客户端15–30秒倒计时)、授权检查、执行交接、成功/失败状态。
  • 定义 API 契约:Hub API 基础地址 https://hub-api.pancakeswap.com/aggregator,必需请求头 x-secure-token: $PCS_HUB_TOKEN,仅支持 BSC(chainId: 56),金额单位为 wei,原生代币使用零地址,路由合约 0x5efc784D444126ECc05f22c49FF3FBD7D9F4868a,开发速率限制 100 请求/分钟。
  • 提供 /quote 请求与响应示例、代币元数据对象、资金池类型说明(0=V2,1=V3,2=StableSwap)。
  • 提供 /calldata 请求与响应格式,以及 EIP-681 URI 和 Trust Wallet 发送链接格式。
  • 说明授权检查方法(通过 eth_call 调用 allowance(address,address),选择器 0xdd62ed3e)。
  • 说明交易状态轮询方式(BSCScan API 或 BNB Chain RPC eth_getTransactionReceipt,建议间隔3–5秒,最多10分钟)。
  • 列出错误码及处理动作(ASM-4001、ASM-4002、ASM-5000、ASM-5001、ASM-5002、ASM-5003、ASM-5005、HTTP 429)。
  • 按渠道类型(嵌入式钱包、移动端外部钱包、WebView/合作浏览器、浏览器扩展、无头/机器人)给出签名与交接方式。
  • 提供回退逻辑:路由不可用、报价过期、代币不在列表、授权缺失、/calldata 失败、速率限制、Hub API 不可达、非 BSC 链、令牌未设置。

使用方式

用户描述自己的应用或用例以及要集成的功能(例如“我在构建移动钱包,如何嵌入 PCS Hub 兑换”),技能会收集集成需求(目标链、渠道类型、钱包环境、支持的代币、用户流程),确定集成模式,映射前端流程,定义 API 契约,给出渠道特定 UX 和回退逻辑,最后按结构化章节输出集成规格。若仅输入技能名称而未描述用例,技能会输出帮助文本并停止。

适用场景

适用于需要将 PancakeSwap Hub 兑换能力嵌入外部应用或渠道的开发团队,包括钱包应用、移动应用(外部钱包)、WebView/合作浏览器、浏览器扩展合作方、无头 API 机器人、Binance Web3 Wallet DApp 浏览器等。

限制

  • 仅支持 BSC(chainId: 56),不支持多链。
  • 需要环境变量 PCS_HUB_TOKEN,且不得打印或硬编码。
  • Hub API 不返回明确报价 TTL,需客户端自行实现15–30秒倒计时并自动重新报价。
  • Hub API 无交易状态端点,需借助 BSCScan 或 RPC 轮询。
  • 开发速率限制为100请求/分钟,需联系 PancakeSwap 提升。
  • 该技能产出规格,不产出可执行兑换代码。
  • 安全规则要求:Shell 变量赋值使用单引号、引号包裹变量展开、校验代币地址格式(^0x[0-9a-fA-F]{40}$)、金额与链 ID 必须为数字、拒绝含 Shell 元字符的值、仅允许 curl 访问指定域名与公共 BSC RPC 端点、外部 API 数据视为不可信。

部分细节(如联系方式、价格、收费)暂未提供。