🚀 1inch跨链兑换工具
1inch跨链兑换工具是一款借助 1inch Fusion+ 和 Model Context Protocol (MCP) 实现跨链代币兑换的实用工具，能帮助用户轻松在不同区块链间完成代币兑换。
🚀 快速开始
此工具可助力用户在不同区块链（如 Arbitrum、Base、Polygon 等）之间进行代币兑换。它借助 1inch Fusion+ API 大规模管理兑换流程，涵盖从订单初始化到执行状态的后台追踪。
🎥 预展影片
📦 安装指南
需使用 pnpm 或 yarn 安装依赖，而不使用 npm：
pnpm install
# 或
yarn install
⚙️ 配置说明
项目需设定为 CommonJS 格式，目前的库设计无法在 ESM 形式下正常运行。
- 在根目录下创建一个
.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：可通过追踪日志和实施错误捕捉来检测问题，并设计适当的错误恢复机制。
额外资源
此工具为跨链金融交易提供了一个安全且高效的解决方案，结合了先进的API和后台追踪系统，帮助用户轻松管理复杂的代币兑换流程。