1inch Cross Chain Swap

🚀 1inch Cross-Chain Exchange Tool

A tool for cross-chain token exchange using 1inch Fusion+ and Model Context Protocol (MCP).

🎥 Preview Video

📋 Overview

This tool helps users exchange tokens between different blockchains (such as Arbitrum, Base, Polygon, etc.). It uses the 1inch Fusion+ API to manage the exchange process on a large scale, from order initialization to background tracking of the execution status.

📦 Installation

You need to use pnpm or yarn to install dependencies instead of npm:

pnpm install
# or
yarn install

⚙️ Configuration

The project needs to be configured in CommonJS format. The current library design does not work properly in ESM format.

1. Create a .env file in the root directory and fill in the following variables:

DEV_PORTAL_KEY=Replace with the developer portal API key
WALLET_ADDRESS=Replace with the wallet address
WALLET_KEY=Replace with the wallet private key
RPC_URL_ETHEREUM=Replace with the Ethereum RPC URL
RPC_URL_BASE=Replace with the Base RPC URL
INCH_API_KEY=Replace with the 1inch API key

💻 Usage Examples

🚀 Start the MCP Server

npm start

This command starts the Model Context Protocol server, which exposes tools for cross-chain exchange and portfolio management.

🛠️ Available MCP Tools

This tool provides the following MCP functions, which can be used in Claude or other MCP-compatible assistants:

🔄 Cross-Chain Exchange

• swap: Initialize cross-chain token exchange

  Parameters:
  - srcChainId: Source chain ID (Default: 8453/Base)
  - dstChainId: Destination chain ID (Default: 42161/Arbitrum)
  - srcTokenAddress: Source token address
  - dstTokenAddress: Destination token address
  - amount: Exchange amount (base unit or human-readable format)
  - invert: Switch the exchange direction (Default: false)
  

📊 Order Management

• swap-status: Check the status of an exchange order

  Parameters:
  - txHash: Transaction hash
  

📈 Portfolio Management

• portfolio: Manage multi-entry investment portfolios

  Parameters:
  - operation: Operation type (create, read, update, delete)
  - portfolioId: Portfolio ID
  - data: Related data
  

🔧 Technical Details

🔒 Environment Variable Security

All sensitive information is stored in the .env file. Avoid exposing it. It is recommended to add this file to .gitignore to prevent accidental public exposure in the version control system.

🐞 Error Handling

The .worker.js file that tracks orders in the background should regularly check its health status and restart or alarm when errors are found. This can be achieved by adding log recording and error catching.

🔐 Security Measures

Implement authentication and authorization mechanisms to ensure that only authorized users can access the MCP server and related services. In addition, encrypt sensitive data such as private keys to prevent unauthorized access.

⚙️ Performance Optimization

If the transaction volume is large, consider using load balancing and a fractionalized architecture to distribute request traffic and improve the overall system stability and processing capacity.

📚 Documentation

❓ Frequently Asked Questions

Q: How to start using this tool? A: Follow the installation and configuration steps. After starting the MCP server, you can operate through the provided APIs.

Q: Which blockchains are supported? A: Currently, it mainly supports Arbitrum, Base, and Polygon. Support for more chains will be expanded in the future.

Q: How to handle errors or failures? A: You can detect problems by tracking logs and implementing error catching, and design appropriate error recovery mechanisms.

📚 Additional Resources

• 1inch Fusion+ Documentation
• Model Context Protocol Video Tutorial

This tool provides a secure and efficient solution for cross-chain financial transactions. It combines advanced APIs and a background tracking system to help users easily manage complex token exchange processes.