📦 Gasless Crosschain Executor — 无 Gas 跨链执行器

无Gas跨链执行器概览 在本地保管密钥的前提下，完成EVM链上/跨链兑换的计划、验证、签名、提交与监控。同链与跨链路径被打包处理。这不是交易策略，而是面向1inch Fusion+（跨链无Gas）、1inch Fusion（同链无Gas）及1inch Aggregation Router v6（同链付费）的执行安全流。若用户提供已审计合约，可启用custom模式作为逃生舱。

环境前置 Helpers未全局安装。运行scripts/或examples/前：

• 必须在./.venv存在Python venv，含eth-account与web3
• 若脚本报ModuleNotFoundError，请用户在skill根目录执行./scripts/setup.sh
• 通过.venv/bin/python或先source .venv/bin/activate调用脚本；禁止向系统Python pip install
• .mjs helpers需Node 20+及examples/node_modules/；setup.sh在Node可用时自动处理；无Node时仅Python工具可用（足以完成钱包初始化、验证、签名）

不可妥协的安全模型

• 禁止让用户在聊天中粘贴私钥、助记词、keystore密码、钱包备份或一次性验证码
• 禁止打印、记录、存储或回显任何私钥材料
• 使用本地环境变量、本地密钥库、硬件钱包或对话外管理的钱包连接器
• 未经用户审阅并明确授权精确执行计划，不得执行真实交易
• 禁止对未检查的calldata或typed data签名；必须核对provider、chain id、代币地址、spender/settler地址、数量、接收方、deadline、nonce、滑点、取消或退款路径
• 视审批为高风险；优先使用定额许可、permit签名或资源锁定方案；除非用户明确承担风险，否则禁止无限额度授权
• 若流程需源链审批交易且无permit路径，需说明该钱包-代币对并非完全无Gas
• 若代理无法访问安全本地签名运行时，仅输出实施方案与命令，不得模拟持有密钥

开放式买币请求处理 当用户说“买PEPE”或“把USDC换成ETH”而未给出精确地址/链/数量时，先展开请求，禁止静默推断：

• 目标代币：仅给符号时，运行examples/resolve_token.mjs --chain {--symbol |--address }；若结果含警告（无验证匹配、多验证候选），展示列表并询问；未经用户明确选择，拒用未验证地址
• 目标链：使用用户命名的链；未命名则询问；本skill无流动性比较工具，禁止猜测
• 源端：用户未指定时，运行examples/portfolio_scan.py --owner ，选稳定币或最大验证持仓于可抵达目标链的链，与用户确认
• 路径：跨链→1inch-fusion-plus；同链→通过preflight.py检查源链原生余额：零/ dust → 1inch-fusion，否则→1inch-aggregator
• 数量：计划数量为最小单位十进制字符串，按源代币decimals转换；法币计价需外部价格源，本skill不提供，请用户给出代币单位数量或注明所用oracle

标准执行工作流 分类请求 → 设计/审阅、仅报价、执行、监控/恢复、钱包初始化 按可观察状态选provider模式，不询问用户：

• 跨链（source_chain_id != destination_chain_id）→ 1inch-fusion-plus

流程：build_order_fusion_plus.mjs → local_signer.py（typed-data）→ submit_fusion_plus.mjs → status_fusion_plus.mjs → submit_secret.mjs

• 同链（source_chain_id == destination_chain_id）

读取源链原生余额：examples/preflight.py --rpc-url --token native --owner --spender 低于单笔gas成本（ETH类链≈0.001 native视为零）→ 1inch-fusion 流程：build_order_fusion.mjs → local_signer.py（typed-data）