SuperAPI AI 工具集

swapper-integration

通用与其它

查看项目

更新于 10-16 02:30

技能介绍

用途:该技能用于把新的 DEX 聚合器、兑换器或跨链桥协议(如 Bebop、Portals、Jupiter、0x、1inch 等)集成进 ShapeShift Web。ShapeShift Web 是去中心化加密兑换聚合器,通过统一接口支持多个兑换提供方,每个 swapper 实现标准化的 TypeScript 接口(Swapper 与 SwapperApi),并按链类型(EVM、UTXO、Solana、Sui、Tron)和兑换模型(直接交易、充值地址、无 Gas 订单)有所差异。

主要能力:技能按阶段引导完整流程。阶段 0 先用 WebFetch/WebSearch 主动调研官方文档、Swagger/OpenAPI、支持链与已有集成;阶段 1 用 AskUserQuestion 收集 API 密钥、链支持、滑点格式、地址格式、原生代币标记、品牌资产等缺失信息;阶段 2 分析现有 swapper 模式,判断属于 EVM 直接交易、充值地址、无 Gas 订单、Solana 专用还是特定链类型,并研读 2-3 个相似实现;阶段 3 按固定顺序创建目录并实现 types、constants、helpers、HTTP 服务、API 封装、报价与费率逻辑。

使用方式:核心代码位于 packages/swapper/src/swappers/。实现遵循既有模式,例如用 @sniptt/monads 的 Result<T, SwapErrorRight> 做单子式错误处理,用 createCache 与 makeSwapperAxiosServiceMonadic 构建带缓存的 HTTP 服务,用 PQueue 做限流,用 getInputOutputRate 计算汇率。所有 swapper 通过运行时特性开关逐步上线。

适用场景:需要为 ShapeShift Web 新增兑换或跨链桥提供方时使用。

限制:资料未提供具体 API 端点、密钥配置、收费与价格信息,也未给出完整实现代码;实际集成需以目标协议官方文档为准,并确认滑点、地址校验和原生代币处理等细节。