用途
该技能用于设计将 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 数据视为不可信。
部分细节(如联系方式、价格、收费)暂未提供。