LI.FI Cross-chain

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install galleon-lifi-cross-chain
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 galleon-lifi-cross-chain。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

LI.FI Cross-chain 帮助 Openclaw Skills 用户评估桥接报价、准备未签名的转账条款，并根据来源证据核对已提交的转账及其目标链结果。它会记录路由成本和最低输出量，然后核实实际接收链、代币、收款人和金额，而不是将来源交易回执或服务提供方的状态标签当作交付证明。
此技能旨在配合只读 EVM RPC 和官方 LI.FI API 或 UI 使用，并可选用 Node.js 辅助工具进行离线分类。技能不包含签名器：执行必须使用获授权的钱包或官方 SDK/UI；对收款人、支出、路由、滑点或有效期的任何变更都需要重新审核。

应用场景

比较相同来源和目标资产、金额、收款人及报价时段的 LI.FI 桥接路由。
在准备转账前检查目标链最低输出量、费用、执行时长和额外原生 Gas 需求。
审核未签名的交易交接信息，包括链、代币、收款人、交易目标、value、data 和授权额度相关事项。
当目标链仍在处理中时，根据来源哈希追踪先前提交的转账；不要将发起替代转账作为恢复操作。
使用来源和目标链证据调查已完成、部分完成、已退款、失败或尚未编入索引的结果。
使用可选的结算辅助工具离线分类已保存的 LI.FI 响应。
使用 Openclaw Skills 进行跨链研究和规划，而不将签名权限委托给该技能。

工作原理

明确一项精确的转账意图：来源和目标链 ID、代币地址、原始输入金额、发送方、收款人、滑点比例、最高成本和截止时间。将目标链原生 Gas 需求与桥接代币分开确定。
对单个可执行步骤请求官方 /v1/quote，或比较范围更广的 /advanced/routes 结果。选定高级路由后，准备就绪时通过 /advanced/stepTransaction 获取交易数据；不要将路由列表视为可执行 calldata。
记录报价 ID、工具或桥、步骤、操作、预估及最低输出量、费用和 Gas 成本，以及执行时长。仅当目标代币身份和小数位数一致时才比较最低原始金额，并避免重复计算费用。
检查交接信息：核实操作地址、代币和链身份、交易目标/value/data、链 ID、原生 Gas 余额、模拟结果和报价授权额度。将 estimate.approvalAddress 视为需要核实的 spender 提示，而非无限授权许可。
若请求执行，请使用获授权的钱包或官方 SDK/UI。确认授权范围涵盖收款人、支出、路由、滑点和有效期；若交易构建或授权改变这些条款，则重新评估。等待前保存来源哈希或路由 ID。
对现有转账，使用其来源哈希和链 ID 查询 /v1/status。遵守速率限制和 retry-after 指引；使用有界次数的检查，如果任务无法等待，则报告待处理状态及下次检查时间。
根据目标链证据核对最终结果。核实链、确切资产、收款人及原始到账金额是否达到已保存的最低值；分别核算来源扣款以及来源链/目标链 Gas。将部分到账和退款视为不同结果，不要视为目标链转账成功完成。

配置指南

此技能需要只读 EVM RPC 访问权限，以及访问官方 LI.FI 协议 API 或 UI 的权限。Node.js 20 为可选项，仅在使用离线结算辅助工具时需要。技能不包含签名器，也不提供签名权限。
按照该 AI 编程代理的标准技能设置流程，将此技能安装到其技能目录，或以其他方式提供给代理使用。
查阅 references/recipes.md，了解具体的官方 API 调用和来源参考。准备金融操作前，重新核实协议部署和 API 架构。
配置对只读 EVM RPC 端点以及研究相关链所需的官方 LI.FI API 或 UI 的访问权限。
制定未签名转账计划时，收集准确的意图字段，并核实目标链的原生 Gas 需求。如果明确要求执行，请另行使用获授权的钱包或官方 SDK/UI。
若要离线分类已保存的响应，请从已安装的技能目录运行辅助工具：
node scripts/settlement.mjs '{"status":"DONE","substatus":"PARTIAL"}'
若要进行 COMPLETED 分类，请提供正数 expectedChain 和 receivedChain、EVM 格式的 expectedToken 和 receivedToken，以及整数字符串形式的 minimumRaw 和 receivedRaw。辅助工具会精确比较大额金额，但不会独立证明链上观测结果。

数据架构

此技能围绕转账意图、报价记录、交易交接信息和结算证据组织工作。来源文档没有规定持久化存储格式；请保留以下字段并关联转账的来源哈希或路由 ID，以便后续状态检查能够指向同一笔转账。
记录 关键字段
转账意图 来源和目标链 ID；确切代币地址；原始输入金额；发送方；收款人；滑点比例；最高成本；截止时间
报价和路由 报价 ID；工具/桥；包含的步骤；操作；estimate.toAmount；toAmountMin；费用；Gas 成本；执行时长
交接信息 action.fromAddress；action.toAddress；代币和链身份；交易目标、value 和 data；链 ID；Gas 余额；模拟结果；报价授权额度和 spender 提示
转账身份 在等待结算前保存的来源交易哈希和路由 ID
状态和证据 服务提供方状态和子状态；来源链和目标链阶段；目标链哈希；接收链、代币、收款人和原始金额；如适用，退款链、资产、收款人、哈希和净金额；来源扣款和 Gas 成本
离线分类器输入 状态/子状态；对于 COMPLETED，提供预期和实际接收链、预期和实际接收的 EVM 代币身份，以及整数字符串形式的最低和实际接收原始金额
只有在链、代币身份和小数位数一致后，才能将 receiving.amount 与已保存的 toAmountMin 比较。待处理期间显示的服务提供方报价只是预估，并非到账证据。退款是独立结果，不满足原始目标链交付义务。

高级特性

比较路由最低输出量和成本，同时区分桥接代币输出与额外的来源链或目标链原生 Gas 需求。
支持单步
/v1/quote
工作流，也支持高级路由比较，并可稍后通过
/advanced/stepTransaction
获取交易数据。
区分 PENDING、DONE/COMPLETED、DONE/PARTIAL、DONE/REFUNDED、FAILED 和 NOT_FOUND/INVALID 等服务提供方生命周期状态，并提供针对不同结果的核实指南。
遵循服务提供方的速率限制或 retry-after 指引，进行有界状态检查，而非无限轮询。
包含用于已保存响应的离线 Node.js 分类器；它能精确比较大额原始金额，并且有意仅支持 EVM 代币身份。
将签名操作排除在技能之外；若交易构建或授权改变获授权的转账条款，则必须重新审核。
提供以证据为依据的核对流程：仅凭来源回执或 DONE 标签，不视为目标资产已到达收款人的证明。

name: lifi-cross-chain description: "Use when comparing LI.FI bridge quotes, preparing an unsigned cross-chain transfer, or diagnosing source-confirmed destination-pending, partial or refunded transfers. Reconciles actual destination asset and amount rather than declaring success from a source receipt." license: MIT
compatibility: "Read-only EVM RPC and official protocol APIs or UI. Optional Node.js 20 for offline helpers. No signer included."