1inch Cross Chain Swap

🚀 1inch跨链兑换工具

1inch跨链兑换工具是一款借助 1inch Fusion+ 和 Model Context Protocol (MCP) 实现跨链代币兑换的实用工具，能帮助用户轻松在不同区块链间完成代币兑换。

🚀 快速开始

此工具可助力用户在不同区块链（如 Arbitrum、Base、Polygon 等）之间进行代币兑换。它借助 1inch Fusion+ API 大规模管理兑换流程，涵盖从订单初始化到执行状态的后台追踪。

🎥 预展影片

📦 安装指南

需使用 pnpm 或 yarn 安装依赖，而不使用 npm：

pnpm install
# 或
yarn install

⚙️ 配置说明

项目需设定为 CommonJS 格式，目前的库设计无法在 ESM 形式下正常运行。

1. 在根目录下创建一个 .env 文件，并填入以下变量：

DEV_PORTAL_KEY=请更换为开发者门户API密钥
WALLET_ADDRESS=请更换为钱包地址
WALLET_KEY=请更换为钱包私钥
RPC_URL_ETHEREUM=请更换为Ethereum_rpc网址
RPC_URL_BASE=请更换为Base_rpc网址
INCH_API_KEY=请更换为1inchAPI密钥

💻 使用示例

启动MCP服务器

npm start

此命令将启动 Model Context Protocol 服务器，公开跨链兑换和组合管理的工具。

可用的MCP工具

本工具提供以下MCP功能，可用于Claude或其他MCP兼容助手中：

跨链兑换

• swap：初始化跨链代币兑换

  参数:
  - srcChainId: 源链ID (默认: 8453/Base)
  - dstChainId: 目标链ID (默认: 42161/Arbitrum)
  - srcTokenAddress: 源代币地址
  - dstTokenAddress: 目标代币地址
  - amount: 兑换金额 (基底单位或人类可读格式)
  - invert: 兑换方向切换 (默认: false)
  

订单管理

• swap-status：检查兑换订单状态

  参数:
  - txHash: 交易哈希值
  

组合投资组合管理

• portfolio：管理多条目 инвестици 组合

  参数:
  - operation: 操作类型 (create, read, update, delete)
  - portfolioId: 投资组合ID
  - data: 相关数据
  

🔧 技术细节

环境变量安全

所有敏感信息均存储于.env文件，需避免泄露。建议将此文件加入.gitignore中，防止版本控制系统意外公开。

错误处理

后台追踪订单的.worker.js 要定期检查其健康状态，并在发现错误时进行重启或报警。这可通过添加日志记录和错误捕捉来实现。

安全措施

实施身份验证和授权机制，确保只有经过授权的用户才能访问MCP服务器和相关服务。此外，加密敏感数据如私钥，防止未授权存取。

性能优化

若交易量大，可考虑使用负载平衡和分式化架构来分散请求流量，提升整体系统稳定性和处理能力。

📚 详细文档

常见问答

Q：如何开始使用此工具？ A：遵循安装与配置步骤，启动MCP服务器后即可通过提供的API进行操作。

Q：支持哪些区块链？ A：目前主要支持Arbitrum、Base和Polygon，未来将扩展更多链的支持。

Q：如何处理错误或故障？ A：可通过追踪日志和实施错误捕捉来检测问题，并设计适当的错误恢复机制。

额外资源

• 1inch Fusion+ 文档
• Model Context Protocol 视频教程

此工具为跨链金融交易提供了一个安全且高效的解决方案，结合了先进的API和后台追踪系统，帮助用户轻松管理复杂的代币兑换流程。