SuperAPI AI 工具集

swap-integration

通用与其它

查看项目

更新于 10-16 07:21

技能介绍

用途:把 Uniswap 兑换功能集成进应用,适用于前端(React/Next.js)、后端脚本或机器人、智能合约集成,以及需要完全控制路由的场景。前置要求:需熟悉 viem 基础(客户端、账户、合约交互、交易签名),可安装 uniswap-viem 插件获取 viem/wagmi 指导:claude plugin add @uniswap/uniswap-viem。

主要能力与方式:1) Trading API(推荐):基址 https://trade-api.gateway.uniswap.org/v1,需 x-api-key 头,并在所有请求中发送 x-agent-info(含 integration_name、decision_origin、version 三字段,1KB 内、纯 ASCII)。请求流程为 /permissions(仅权限池)→ /check_approval → /quote → /swap。2) Universal Router SDK:npm install @uniswap/universal-router-sdk @uniswap/sdk-core @uniswap/v3-sdk,用 SwapRouter.swapCallParameters 生成 calldata。3) 智能合约:直接调用 Universal Router 的 execute() 并编码命令。

路由类型:CLASSIC、DUTCH_V2/V3、PRIORITY、DUTCH_LIMIT、LIMIT_ORDER、WRAP、UNWRAP、BRIDGE、QUICKROUTE。UniswapX V2 支持 Ethereum、Arbitrum、Base、Unichain。

限制与注意:涉及权限代币需 x-universal-router-version 2.2.0 或更高;/swap 请求体需展开报价响应而非包在 quote 字段中;permitData 为 null 会被拒绝,CLASSIC 下 signature 与 permitData 必须同时存在或同时省略,UniswapX 下不得发送 permitData;UniswapX 响应无 quote.output.amount,应使用 orderInfo.outputs[0].startAmount;执行任何消耗 gas 或转账的交易前必须用 AskUserQuestion 向用户确认;API 密钥不得硬编码,须用环境变量;输入需按地址、链 ID、金额规则校验并拒绝含 shell 元字符的输入。支持链列表、完整路由类型与类型定义等细节暂未在资料中完整提供。