SuperAPI AI 工具集

layerzero-value-transfer

通用与其它

查看项目

更新于 10-16 01:50

技能介绍

用途:调用 LayerZero Value Transfer API 完成跨链资产转移,一次调用整合多种桥接/兑换协议,覆盖 170 条链、850 种代币,支持 OFT、STARGATE_V2_TAXI、STARGATE_V2_BUS、CCTP、AORI 等路由,API 通常自动选最优路线。接口基址 https://transfer.layerzero-api.com/v1。

主要能力与用法:先用 GET /chains、/tokens、/metadata 发现路由(这些端点无需鉴权,可直接 curl);再 POST /quotes 获取 quote.id、feeUsd、userSteps,amount 为代币本地精度字符串。执行时 EVM 按顺序签名并发送每个 userStep 交易,ERC-20 通常先 approve 再桥接;Solana 因 blockhash 约 60 秒过期,需先 POST /build-user-steps 重新生成;意图类 AORI 路由需签 EIP-712 并 POST /submit-signature。之后每约 4 秒 GET /status/{quoteId} 轮询,终态为 SUCCEEDED、FAILED、UNKNOWN,非终态为 PENDING、PROCESSING,并向用户提供 explorerUrl。鉴权方面:Starchild 环境下密钥由 sc-proxy 注入,不要自行设置 LAYERZERO_API_KEY;需走转发的 transfer 调用应通过 core.http_client 的 proxied_post、proxied_get,直接 curl 转账端点会返回 Unauthorized。

限制与安全:不要将 LZMulticall(Wrapper)合约批准为代币花费者,API 生成的 calldata 已使用 TransferDelegate 处理授权,应按返回步骤执行而非手工构造授权。报价会过期,执行延迟须重新获取,不可复用旧报价。签名或发送真实资产交易前必须与用户确认源/目标链、代币、金额和 feeUsd,并核对目标地址。失败或未知状态时报告 explorerUrl,不要盲目重试。列表端点分页需传 pagination[nextToken] 直至无 nextToken。原生代币地址为 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE;chainType 为大写,如 EVM、SOLANA、APTOS、SUI、TON、TRON、STARKNET、IOTAMOVE。