⚡

EVMDEX交易Skill trading-evm

此技能提供了在以太坊虚拟机（EVM）链上进行代币交易的完整工具集，支持Uniswap V3和1inch聚合器，覆盖以太坊、Arbitrum、Optimism、Base和Polygon等多个网络。用户可以通过聊天命令或TypeScript API执行交换、获取报价、比较路由和检查余额，适用于去中心化金融（DeFi）应用。关键词包括：EVM，DEX，Uniswap，1inch，代币交易，区块链，DeFi，API接口，量化交易。

DeFi 0 次安装 0 次浏览 更新于 3/9/2026

name: trading-evm description: “在EVM链上交易代币 - 以太坊、Arbitrum、Optimism、Base、Polygon上的Uniswap V3、1inch” emoji: “⟠” gates: envs: - EVM_PRIVATE_KEY

EVM DEX交易 - 完整API参考

使用Uniswap V3和1inch聚合器在以太坊、Arbitrum、Optimism、Base和Polygon上交易任何代币。

所需环境变量

EVM_PRIVATE_KEY=0x...                      # 您的EVM钱包私钥
ALCHEMY_API_KEY=...                        # 可选：用于更好的RPC
ONEINCH_API_KEY=...                        # 可选：用于1inch API

支持的链

链 链ID DEXes MEV保护
以太坊 1 Uniswap V3, 1inch Flashbots保护
Arbitrum 42161 Uniswap V3, 1inch 序列器
Optimism 10 Uniswap V3, 1inch 序列器
Base 8453 Uniswap V3, 1inch 序列器
Polygon 137 Uniswap V3, 1inch 标准

聊天命令

交换

/swap eth <数量> <从> to <到>           # 在以太坊上交换
/swap arb <数量> <从> to <到>           # 在Arbitrum上交换
/swap op <数量> <从> to <到>            # 在Optimism上交换
/swap base <数量> <从> to <到>          # 在Base上交换
/swap matic <数量> <从> to <到>         # 在Polygon上交换

# 示例：
/swap eth 1 ETH to USDC                     # 在以太坊上将1 ETH交换为USDC
/swap arb 100 USDC to ARB                   # 在Arbitrum上将100 USDC交换为ARB
/swap base 0.5 ETH to DEGEN                 # 在Base上将0.5 ETH交换为DEGEN

报价

/quote eth <数量> <从> to <到>          # 获取报价而不执行
/quote arb 1 ETH to USDC                    # 在Arbitrum上报价

比较路由

/compare <链> <数量> <从> to <到>    # 比较Uniswap与1inch
/compare eth 1 ETH to USDC                  # 在以太坊上比较路由

余额

/balance eth                                # 检查ETH和代币余额
/balance arb                                # 检查Arbitrum余额
/balance base <代币>                       # 检查Base上的特定代币

TypeScript API参考

Uniswap V3

import {
  executeUniswapSwap,
  getUniswapQuote,
  resolveToken,
  getTokenInfo,
  getEvmBalance
} from 'clodds/evm/uniswap';

// 获取报价
const quote = await getUniswapQuote({
  chain: 'ethereum',
  tokenIn: 'ETH',
  tokenOut: 'USDC',
  amountIn: '1000000000000000000',  // 1 ETH，单位为wei
  slippageTolerance: 0.5,
});

console.log(`预期输出：${quote.amountOut}`);
console.log(`价格影响：${quote.priceImpact}%`);
console.log(`路由：${quote.route.join(' → ')}`);

// 执行交换
const result = await executeUniswapSwap({
  chain: 'ethereum',
  tokenIn: 'ETH',
  tokenOut: 'USDC',
  amountIn: '1000000000000000000',
  slippageTolerance: 0.5,
  deadline: 300,  // 5分钟
});

console.log(`交易哈希：${result.transactionHash}`);
console.log(`输出金额：${result.amountOut}`);

// 将代币符号解析为地址
const usdcAddress = resolveToken('USDC', 'ethereum');

// 获取代币信息
const tokenInfo = await getTokenInfo('ethereum', usdcAddress);
console.log(`${tokenInfo.symbol}: ${tokenInfo.decimals} 小数位数`);

// 检查余额
const balance = await getEvmBalance('ethereum', walletAddress, 'USDC');

1inch聚合器

import {
  executeOneInchSwap,
  getOneInchQuote,
  getOneInchProtocols,
  compareDexRoutes
} from 'clodds/evm/oneinch';

// 从1inch获取报价
const quote = await getOneInchQuote({
  chain: 'ethereum',
  fromToken: 'ETH',
  toToken: 'USDC',
  amount: '1000000000000000000',
});

console.log(`预期输出：${quote.toAmount}`);
console.log(`预估气体：${quote.estimatedGas}`);
console.log(`使用的协议：${quote.protocols.join(', ')}`);

// 通过1inch执行交换
const result = await executeOneInchSwap({
  chain: 'ethereum',
  fromToken: 'ETH',
  toToken: 'USDC',
  amount: '1000000000000000000',
  slippage: 0.5,
});

// 获取可用协议
const protocols = await getOneInchProtocols('ethereum');
// ['UNISWAP_V3', 'SUSHISWAP', 'CURVE', ...]

// 比较Uniswap和1inch之间的路由
const comparison = await compareDexRoutes({
  chain: 'ethereum',
  tokenIn: 'ETH',
  tokenOut: 'USDC',
  amountIn: '1000000000000000000',
});

console.log(`Uniswap：${comparison.uniswap.amountOut}`);
console.log(`1inch：${comparison.oneinch.amountOut}`);
console.log(`最佳：${comparison.best}`);

链特定示例

以太坊

// 在以太坊上交换ETH → USDC，使用MEV保护
const result = await executeUniswapSwap({
  chain: 'ethereum',
  tokenIn: 'ETH',
  tokenOut: 'USDC',
  amountIn: '1000000000000000000',
  useMevProtection: true,  // 使用Flashbots
});

Arbitrum

// 在Arbitrum上交换（气体费用较低）
const result = await executeOneInchSwap({
  chain: 'arbitrum',
  fromToken: 'ETH',
  toToken: 'ARB',
  amount: '500000000000000000',  // 0.5 ETH
  slippage: 1,
});

Base

// 在Base上交换
const result = await executeUniswapSwap({
  chain: 'base',
  tokenIn: 'ETH',
  tokenOut: 'DEGEN',
  amountIn: '100000000000000000',  // 0.1 ETH
  slippageTolerance: 2,  // 对于模因代币使用较高的滑点容忍度
});

Optimism

// 在Optimism上交换
const result = await executeOneInchSwap({
  chain: 'optimism',
  fromToken: 'USDC',
  toToken: 'OP',
  amount: '100000000',  // 100 USDC（6位小数）
  slippage: 0.5,
});

Polygon

// 在Polygon上交换
const result = await executeUniswapSwap({
  chain: 'polygon',
  tokenIn: 'MATIC',
  tokenOut: 'USDC',
  amountIn: '10000000000000000000',  // 10 MATIC
  slippageTolerance: 0.5,
});

常见代币

以太坊

符号 地址
ETH 原生
USDC 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
USDT 0xdAC17F958D2ee523a2206206994597C13D831ec7
WETH 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
DAI 0x6B175474E89094C44Da98b954EescdeCB5BE3830

Arbitrum

符号 地址
ETH 原生
ARB 0x912CE59144191C1204E64559FE8253a0e49E6548
USDC 0xaf88d065e77c8cC2239327C5EDb3A432268e5831

Base

符号 地址
ETH 原生
USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
DEGEN 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed

Optimism

符号 地址
ETH 原生
OP 0x4200000000000000000000000000000000000042
USDC 0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85

MEV保护

以太坊（Flashbots）

// 自动使用Flashbots保护RPC
const result = await executeUniswapSwap({
  chain: 'ethereum',
  useMevProtection: true,  // 通过Flashbots发送
  ...
});

L2链

L2（Arbitrum、Optimism、Base）默认具有序列器级别的MEV保护。

气体估计

// 在交换前获取气体估计
const quote = await getUniswapQuote({ ... });
console.log(`预估气体：${quote.gasEstimate}`);
console.log(`气体价格：${quote.gasPrice} gwei`);
console.log(`总气体成本：${quote.gasCostUsd} USD`);

错误处理

import { EvmSwapError, InsufficientBalanceError, SlippageExceededError } from 'clodds/evm';

try {
  await executeUniswapSwap({ ... });
} catch (error) {
  if (error instanceof InsufficientBalanceError) {
    console.log('余额不足');
  } else if (error instanceof SlippageExceededError) {
    console.log('价格变动，增加滑点容忍度');
  }
}