SuperAPI AI 工具集

zerion-0x

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

用途:该技能用于在 Zerion Agent 环境中,指导用户通过 0x API(Swap API v2 与 Gasless API v2)完成代币兑换,包括获取指示性价格、获取正式报价以及执行标准兑换(用户自付 Gas)或免 Gas 兑换(费用从卖出代币中扣除)。适合构建集成、编写 dApp 代码、使用 0x 特有功能(AllowanceHolder、Permit2、Gasless API、多签)的场景;若只需在支持链上快速兑换,可改用 zerion-trading。

主要能力:支持 AllowanceHolder(默认,approve 后发交易,无需类型化数据签名,兼容无法签 eth_signTypedData_v4 的智能合约钱包)、Permit2(限时授权、批量、已有 Permit2 授权)与 Gasless(仅 ERC-20 卖出、用户无 Gas)三种流程。API 基础地址为 https://api.0x.org,每次调用需带 0x-api-key 与 0x-version: v2 请求头,密钥环境变量为 ZERO_EX_API_KEY。支持 Ethereum、Arbitrum、Base、Optimism、Polygon、BNB、Avalanche、Blast、Mantle、Scroll、Sonic、Abstract、Berachain、HyperEVM、Ink、Linea、Mode、Monad、Unichain、World Chain 等链。

使用方式:先收集 sellToken、buyToken(ERC-20 合约地址,不接受符号)、sellAmount 或 buyAmount(代币基础单位)、chainId、taker(报价必填)。可用 zerion wallet list --json 获取 Zerion 钱包地址。随后调用 /swap/allowance-holder/price 或 /gasless/price 查看价格,确认后用 /quote 获取正式报价。执行时 AllowanceHolder 需先 approve 响应中的 spender 再发送交易;Permit2 需 approve Permit2 合约、签 EIP-712、拼接签名后发送;Gasless 需签 approval 与 trade 两个 EIP-712 并 POST 到 /gasless/submit,再轮询 /gasless/status/{tradeHash}。

限制与安全:报价约 30 秒过期,需立即提交;切勿 approve Settler 合约或硬编码 spender,只能使用响应中的 issues.allowance.spender;需检查 liquidityAvailable、simulationIncomplete 与 issues.balance。Gasless 不支持原生代币卖出,需回退到 Swap API v2。遇到未知代币地址、链或错误码,应先用 mcp__0x-mcp__searchDocs 查询实时文档。该技能本身不能签名或提交交易,需由用户在自己的代码或钱包中完成。