1英寸跨链交换工具

使用 1inch Fusion+ 和模型上下文协议 (MCP) 执行跨链代币交换的工具。

演示视频

Related MCP server: Armor Crypto MCP

概述

该工具使用 1inch Fusion+ API 实现不同区块链（Arbitrum、Base、Polygon 等）之间的跨链代币兑换。它处理整个兑换流程，从发起订单到通过后台工作系统监控执行状态。

安装

必须使用pnpm或yarn而不是npm安装依赖项：

pnpm install
# or
yarn install

配置

该项目必须设置为 CommonJS 项目。如果将其导入为 ESM，则库的设计将无法以当前形式运行。

1. 在根目录中创建一个.env文件并使用以下变量填充它：

DEV_PORTAL_KEY=replace_with_developer_portal_api_key
WALLET_ADDRESS=replace_with_wallet_address
WALLET_KEY=replace_with_wallet_private_key
RPC_URL_ETHEREUM=replace_with_ethereum_rpc_url
RPC_URL_BASE=replace_with_base_rpc_url
INCH_API_KEY=replace_with_1inch_api_key

用法

启动 MCP 服务器

npm start

这将启动模型上下文协议服务器，该服务器公开用于跨链交换和投资组合管理的工具。

可用的 MCP 工具

该工具提供以下 MCP 功能，可与 Claude 或其他兼容 MCP 的助手一起使用：

跨链交换

• swap ：发起跨链代币交换

  Parameters:
  - srcChainId: Source chain ID (default: 8453/Base)
  - dstChainId: Destination chain ID (default: 42161/Arbitrum)
  - srcTokenAddress: Source token address
  - dstTokenAddress: Destination token address
  - amount: Amount to swap (in base units or human-readable format)
  - invert: Swap direction toggle (default: false)

订单管理

• swap-status ：检查掉期订单的状态

  Parameters:
  - orderHash: (Optional) Specific order hash to check

投资组合管理

• portfolio-protocols-value ：获取投资组合中协议的价值

  Parameters:
  - chainId: Blockchain ID (default: 1/Ethereum)

• portfolio-tokens-details ：获取有关你的投资组合中代币的详细信息

  Parameters:
  - chainId: Blockchain ID (default: 1/Ethereum)
  - closed: Include closed positions (default: true)
  - closedThreshold: Threshold for considering positions closed (default: 1)

• portfolio-general-value ：获取投资组合的总体价值

  Parameters:
  - chainId: Blockchain ID (default: 1/Ethereum)

• portfolio-value-chart ：获取投资组合价值随时间变化的图表数据

  Parameters:
  - chainId: Blockchain ID (default: 1/Ethereum)

监控系统

该应用程序包括一个监控和处理掉期订单的后台工作系统：

监控命令

# Start the monitor daemon
npm run monitor:start

# Check status of all orders
npm run status

# Check status of monitor daemon
npm run monitor:status

# Stop the monitor daemon
npm run monitor:stop

工人系统如何运作

1. 当发起掉期交易时，订单信息保存到order-status.json

2. 监控守护进程不断检查需要监控的新订单

3. 对于每个新订单，都会生成一个专用的工作进程

4. 工作人员监控订单状态并在需要时提交机密以完成交换

5. 一旦订单被执行，工人就会被解雇，状态也会更新

技术说明

• 采用 1inch Cross-Chain SDK 构建，实现安全的跨链交换

• 使用模型上下文协议进行人工智能助手集成

• Fusion SDK 中的PrivateKeyProviderConnector支持 BlockchainProviderConnector

• 该工具负责跨链交换验证的秘密管理