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和後臺追蹤系統，幫助用戶輕鬆管理複雜的代幣兌換流程。