用途:该技能用于跨链代币兑换,通过 SaturnSwap 的 Cosmic Router(UEX 聚合器)在 119 条区块链之间转移资产。与链上 DEX 兑换不同,跨链采用存款式流程:先获取报价(汇率、费用、最小/最大金额),再创建订单获得唯一存款地址与精确金额,然后在源链向该地址转入指定金额,最后代币到达目标链的目标地址。
主要能力:提供三个 API 端点,均位于 https://saturnswap.io/api/uex/:/metadata(GET,列出支持的链与代币)、/quote(POST,获取含汇率与费用的报价)、/order(POST,创建订单并获取存款地址)。配套脚本包括 list-chains.js(按类型筛选链)、find-token.js(按符号查找代币)、get-quote.js(获取报价)、create-order.js(创建订单)。
使用方式:代币 ID 格式为 SYMBOL@CHAIN_SYMBOL(如 ADA@ADA、ETH@ETH、SOL@SOL);链 ID 为 slug 形式(如 cardano-mainnet、ethereum-mainnet、solana-mainnet);Cardano 非 ADA 代币使用 cardano:<policyId><assetName> 格式。示例命令:node scripts/get-quote.js --from ADA --to ETH --amount 500;node scripts/create-order.js --from ADA --to ETH --amount 500 --destination 0xYourEthAddress。需要 Cardano 签名的订单会返回 requiresSignature: true 与 unsignedTxCbor。
适用场景与限制:适用于跨链资产兑换,通常耗时 5-30 分钟,取决于各链确认时间。存款地址每个订单唯一,必须发送精确的 depositAmount;金额受最小/最大值限制,报价返回 minAmountIn 与 maxAmountIn。订单状态流转为 waiting_for_deposit → confirming → swapping → sending → completed,也可能出现 expired、refunded、failed。安全上需在创建订单前展示报价、核对目标地址所属链、检查金额范围、提示费用(feeAmount)并确认后再下单。资料未提供具体收费标准、支持代币完整清单及失败退款细节。