用途:帮助开发者把新的 DEX 聚合器、兑换器或跨链桥接入 ShapeShift Web。ShapeShift Web 通过 packages/swapper/src/swappers/ 下的统一 swapper 接口支持多个聚合器,各 swapper 遵循一致模式,但会因类型(EVM、Solana、跨链、无 gas 等)而不同。
主要能力:技能按阶段引导完整集成流程。第一阶段收集 API 文档、Swagger/OpenAPI 规范、基础 URL、认证方式、限流、支持网络、滑点格式、地址校验和、原生代币表示、品牌资产等信息。第二阶段研究 API 与现有 swapper,判断类型(EVM 单跳、无 gas/订单、Solana、跨链/多跳、桥接),并参考 BebopSwapper、ZrxSwapper、PortalsSwapper、CowSwapper、JupiterSwapper、ThorchainSwapper 等实现。第三阶段按顺序实现 types.ts、constants.ts、helpers、service、fetch、getTradeQuote、getTradeRate、endpoints、主类与 index,并注册到 constants.ts、index.ts、types.ts,配置 CSP、图标、功能开关、测试 mock 与环境变量。第四阶段运行 yarn type-check、yarn lint、yarn build:swapper 并手动测试。第五阶段编写 INTEGRATION.md。
使用方式:当用户提出“集成某 swapper”“添加某协议支持”等需求时激活。需先收集全部信息再编码,复制相似 swapper 的模式,避免猜测实现细节。
适用场景:为 ShapeShift Web 新增同链聚合、无 gas 订单、Solana 或跨链桥接类兑换支持。
限制:资料未提供具体 API 端点、密钥、价格或效果保证;缺失信息需向用户确认,否则易产生 bug。部分 swapper 需要元数据跟踪(如存款地址、订单 ID),部分不需要,需按类型判断。