swap-planner

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Swap Planning

交换规划

Plan and generate deep links for token swaps on Uniswap across all supported chains.

Runtime Compatibility: This skill uses
AskUserQuestion
for interactive prompts. If
AskUserQuestion
is not available in your runtime, collect the same parameters through natural language conversation instead.

规划并生成跨所有支持链的Uniswap代币交换深度链接。

运行时兼容性： 本Skill使用
AskUserQuestion
实现交互式提示。如果你的运行环境不支持
AskUserQuestion
，请通过自然语言对话收集相同参数。

Overview

概述

Plan token swaps by:

Gathering swap intent (tokens, amounts, chain)
Verifying token contracts on-chain
Researching tokens via web search when needed
Generating a deep link that opens in the Uniswap interface with parameters pre-filled

The generated link opens Uniswap with all parameters ready for execution.

Note: Browser opening (
xdg-open
/
open
) may fail in SSH, containerized, or headless environments. Always display the URL prominently so users can copy and access it manually if needed.

通过以下步骤规划代币交换：

收集交换意向（代币、金额、链）
链上验证代币合约
必要时通过网页搜索研究代币
生成可在Uniswap界面打开的深度链接，参数已预填充

生成的链接会打开Uniswap，所有参数已准备就绪，可直接执行交换。

注意： 在SSH、容器化或无界面环境中，浏览器打开操作（
xdg-open
/
open
）可能失败。请始终显眼地显示URL，以便用户在需要时手动复制访问。

Workflow

工作流

Step 0: Token Discovery (When Needed)

步骤0：代币发现（必要时）

If the user wants to discover tokens rather than swap a known token (e.g., "find me a memecoin", "what's trending on Base"), help them explore before proceeding to the swap.

如果用户想要发现代币而非交换已知代币（例如「给我找一个迷因币」「Base链上有什么热门代币」），请先帮他们探索，再进入交换流程。

Option A: Search by Keyword

选项A：关键词搜索

DexScreener search works best with specific terms:

bash

undefined

DexScreener搜索在使用特定术语时效果最佳：

bash

undefined

Search for tokens by name/category (e.g., "degen", "pepe", "ai agent")

curl -s "https://api.dexscreener.com/latest/dex/search?q=degen" |
jq '[.pairs[] | select(.chainId == "base" and .dexId == "uniswap")] | sort_by(-.volume.h24) | .[0:5] | map({ token: .baseToken.symbol, address: .baseToken.address, price: .priceUsd, volume24h: .volume.h24, liquidity: .liquidity.usd })'


**Good search terms:** `degen`, `pepe`, `ai`, `agent`, `meme`, `dog`, `cat`, or specific token names


**推荐搜索词：** `degen`, `pepe`, `ai`, `agent`, `meme`, `dog`, `cat`，或具体代币名称

Option B: Check Promoted Tokens

选项B：查看推荐代币

Get tokens with active promotions (limited selection):

bash

undefined

获取带有活跃推广的代币（选择有限）：

bash

undefined

Get boosted/promoted tokens on a chain

curl -s "https://api.dexscreener.com/token-boosts/top/v1" |
jq '[.[] | select(.chainId == "base")] | .[0:5] | map({ tokenAddress, url })'

undefined

curl -s "https://api.dexscreener.com/token-boosts/top/v1" |
jq '[.[] | select(.chainId == "base")] | .[0:5] | map({ tokenAddress, url })'

undefined

Option C: Web Search + Verify

选项C：网页搜索+验证

For broad discovery ("what's trending"), use web search to find tokens, then verify with DexScreener:

bash

undefined

对于广泛的代币发现（「什么代币热门」），先通过网页搜索找到代币，再用DexScreener验证：

bash

undefined

After finding a token address from web search, verify it exists

curl -s "https://api.dexscreener.com/token-pairs/v1/{network}/{address}" |
jq '[.[] | select(.dexId == "uniswap")][0] | { name: .baseToken.name, symbol: .baseToken.symbol, price: .priceUsd, liquidity: .liquidity.usd, volume24h: .volume.h24 }'


**Network IDs:** See `references/chains.md` for the full list with DexScreener and DefiLlama provider IDs. Common IDs: `ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `bsc`, `avalanche`, `unichain`.

**DexScreener coverage varies by chain.** Ethereum, Base, and Arbitrum have deep Uniswap data. Celo, Blast, Zora, and World Chain have limited Uniswap pool coverage — fewer results and potentially missing pairs. Fall back to DefiLlama for price data when DexScreener returns empty results (see `references/data-providers.md`).

**Note:** DexScreener's public API doesn't have a "trending" or "top gainers" endpoint. Token discovery uses keyword search (`/latest/dex/search`) and web search as a fallback. For general discovery, ask the user what type of token they're looking for and search by keyword.


**网络ID：** 完整列表请查看`references/chains.md`，包含DexScreener和DefiLlama的服务商ID。常见ID：`ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `bsc`, `avalanche`, `unichain`。

**DexScreener的链覆盖范围不同：** Ethereum、Base和Arbitrum的Uniswap数据全面。Celo、Blast、Zora和World Chain的Uniswap池覆盖有限——结果更少，可能缺少交易对。当DexScreener返回空结果时，可使用DefiLlama获取价格数据（详见`references/data-providers.md`）。

**注意：** DexScreener的公开API没有「热门」或「涨幅榜」端点。代币发现使用关键词搜索（`/latest/dex/search`），网页搜索作为备选。对于通用发现需求，请询问用户想要找什么类型的代币，再按关键词搜索。

Category-Based Discovery

基于分类的发现

For specific categories (memecoins, DeFi, gaming tokens), use web search:

text

"trending {category} {chain} {current_year}"

Example:

"trending memecoins Base 2026"

对于特定分类（迷因币、DeFi、游戏代币），使用网页搜索：

text

"trending {category} {chain} {current_year}"

示例：

"trending memecoins Base 2026"

Present Options to User

向用户展示选项

After gathering token data, present options using AskUserQuestion:

json

{
  "questions": [
    {
      "question": "Which token would you like to swap to?",
      "header": "Token",
      "options": [
        { "label": "MOLT ($23M mcap)", "description": "$5.9M liquidity, $7.8M 24h volume" },
        { "label": "CLANKER ($31M mcap)", "description": "$3.1M liquidity, established token" },
        { "label": "CLAWSTR ($13M mcap)", "description": "$2.1M liquidity, high volume spike" }
      ],
      "multiSelect": false
    }
  ]
}

收集代币数据后，使用AskUserQuestion展示选项：

json

{
  "questions": [
    {
      "question": "Which token would you like to swap to?",
      "header": "Token",
      "options": [
        { "label": "MOLT ($23M mcap)", "description": "$5.9M liquidity, $7.8M 24h volume" },
        { "label": "CLANKER ($31M mcap)", "description": "$3.1M liquidity, established token" },
        { "label": "CLAWSTR ($13M mcap)", "description": "$2.1M liquidity, high volume spike" }
      ],
      "multiSelect": false
    }
  ]
}

Risk Assessment for Trending Tokens

Metric	Low Risk	Medium Risk	High Risk
Market Cap	>$50M	$5M-$50M	<$5M
Pool TVL	>$1M	$100k-$1M	<$100k
24h Volume	Consistent	Spiking unusually	Very low
Contract Age	>30 days	7-30 days	<7 days

指标	低风险	中风险	高风险
市值	>$50M	$5M-$50M	<$5M
池TVL	>$1M	$100k-$1M	<$100k
24小时交易量	稳定	异常飙升	极低
合约时长	>30天	7-30天	<7天

Step 1: Gather Swap Intent

步骤1：收集交换意向

Extract from the user's request:

Parameter	Required	Example
Input token	Yes	ETH, USDC, token address
Output token	Yes	USDC, WBTC, token address
Amount	Yes	1.5 ETH, $500 worth
Chain	Yes (default: Ethereum)	Base, Arbitrum, etc.

If any required parameter is missing, use AskUserQuestion with structured options:

For missing chain:

json

{
  "questions": [
    {
      "question": "Which chain do you want to swap on?",
      "header": "Chain",
      "options": [
        { "label": "Base (Recommended)", "description": "Low gas fees, fast transactions" },
        { "label": "Ethereum", "description": "Main network, higher gas" },
        { "label": "Arbitrum", "description": "Low fees, Ethereum L2" },
        { "label": "Optimism", "description": "Low fees, Ethereum L2" }
      ],
      "multiSelect": false
    }
  ]
}

For missing output token (when input is ETH):

json

{
  "questions": [
    {
      "question": "What token do you want to receive?",
      "header": "Output",
      "options": [
        { "label": "USDC", "description": "USD stablecoin" },
        { "label": "USDT", "description": "Tether stablecoin" },
        { "label": "DAI", "description": "Decentralized stablecoin" },
        { "label": "WBTC", "description": "Wrapped Bitcoin" }
      ],
      "multiSelect": false
    }
  ]
}

For missing amount:

json

{
  "questions": [
    {
      "question": "How much do you want to swap?",
      "header": "Amount",
      "options": [
        { "label": "0.1 ETH", "description": "~$320" },
        { "label": "0.5 ETH", "description": "~$1,600" },
        { "label": "1 ETH", "description": "~$3,200" },
        { "label": "Custom amount", "description": "Enter specific amount" }
      ],
      "multiSelect": false
    }
  ]
}

Always use forms instead of plain text questions for better UX.

从用户请求中提取以下信息：

参数	是否必填	示例
输入代币	是	ETH, USDC, 代币地址
输出代币	是	USDC, WBTC, 代币地址
金额	是	1.5 ETH, 价值$500
链	是（默认：Ethereum）	Base, Arbitrum等

如果缺少任何必填参数，使用AskUserQuestion提供结构化选项：

缺少链时：

json

{
  "questions": [
    {
      "question": "Which chain do you want to swap on?",
      "header": "Chain",
      "options": [
        { "label": "Base (Recommended)", "description": "Low gas fees, fast transactions" },
        { "label": "Ethereum", "description": "Main network, higher gas" },
        { "label": "Arbitrum", "description": "Low fees, Ethereum L2" },
        { "label": "Optimism", "description": "Low fees, Ethereum L2" }
      ],
      "multiSelect": false
    }
  ]
}

输入为ETH时缺少输出代币：

json

{
  "questions": [
    {
      "question": "What token do you want to receive?",
      "header": "Output",
      "options": [
        { "label": "USDC", "description": "USD stablecoin" },
        { "label": "USDT", "description": "Tether stablecoin" },
        { "label": "DAI", "description": "Decentralized stablecoin" },
        { "label": "WBTC", "description": "Wrapped Bitcoin" }
      ],
      "multiSelect": false
    }
  ]
}

缺少金额时：

json

{
  "questions": [
    {
      "question": "How much do you want to swap?",
      "header": "Amount",
      "options": [
        { "label": "0.1 ETH", "description": "~$320" },
        { "label": "0.5 ETH", "description": "~$1,600" },
        { "label": "1 ETH", "description": "~$3,200" },
        { "label": "Custom amount", "description": "Enter specific amount" }
      ],
      "multiSelect": false
    }
  ]
}

为获得更好的用户体验，请始终使用表单而非纯文本问题。

Step 2: Resolve Token Addresses

步骤2：解析代币地址

For token symbols, resolve to addresses using known tokens or web search:

Native tokens: Use

NATIVE

as the address parameter.

Common tokens by chain - see

../../references/chains.md

for full list:

Token Ethereum Base Arbitrum

USDC

Token	Ethereum	Base	Arbitrum
USDC	`0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48`	`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`	`0xaf88d065e77c8cC2239327C5EDb3A432268e5831`
WETH	`0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`	`0x4200000000000000000000000000000000000006`	`0x82aF49447D8a07e3bd95BD0d56f35241523fBab1`
WBTC	`0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599`	N/A	`0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f`

0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

0xaf88d065e77c8cC2239327C5EDb3A432268e5831

WETH

0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

0x4200000000000000000000000000000000000006

0x82aF49447D8a07e3bd95BD0d56f35241523fBab1

WBTC

0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599

N/A

0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f

For unknown tokens, use web search to find the contract address, then verify on-chain.

对于代币符号，通过已知代币或网页搜索解析为地址：

原生代币： 使用

NATIVE

作为地址参数。

各链常见代币 - 完整列表请查看

../../references/chains.md

：

代币 Ethereum Base Arbitrum

USDC

代币	Ethereum	Base	Arbitrum
USDC	`0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48`	`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`	`0xaf88d065e77c8cC2239327C5EDb3A432268e5831`
WETH	`0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`	`0x4200000000000000000000000000000000000006`	`0x82aF49447D8a07e3bd95BD0d56f35241523fBab1`
WBTC	`0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599`	N/A	`0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f`

0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

0xaf88d065e77c8cC2239327C5EDb3A432268e5831

WETH

0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

0x4200000000000000000000000000000000000006

0x82aF49447D8a07e3bd95BD0d56f35241523fBab1

WBTC

0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599

N/A

0x2f2a2543B76A4166549F7aaB2e75Bef0aefC5B0f

对于未知代币，使用网页搜索找到合约地址，再进行链上验证。

Step 3: Verify Token Contracts (Basic)

步骤3：验证代币合约（基础）

Input Validation (Required Before Any Shell Command):

Before interpolating user-provided values into any shell command, validate all inputs:

Token addresses MUST match:
```
^0x[a-fA-F0-9]{40}$
```
Chain/network names MUST be from the allowed list in
```
../../references/chains.md
```
Amounts MUST be valid decimal numbers (match:
```
^[0-9]+\.?[0-9]*$
```
)
Reject any input containing shell metacharacters (
```
;
```
,
```
|
```
,
```
$
```
,
```
`
```
,
```
&
```
,
```
(
```
,
```
)
```
,
```
>
```
,
```
<
```
,
```
\
```
)

Verify token contracts exist on-chain using curl (RPC call):

bash

undefined

输入验证（执行任何Shell命令前必须完成）：

在将用户提供的值插入任何Shell命令前，验证所有输入：

代币地址必须匹配：
```
^0x[a-fA-F0-9]{40}$
```
链/网络名称必须来自
```
../../references/chains.md
```
中的允许列表
金额必须是有效的十进制数（匹配：
```
^[0-9]+\.?[0-9]*$
```
）
拒绝任何包含Shell元字符的输入（
```
;
```
,
```
|
```
,
```
$
```
,
```
`
```
,
```
&
```
,
```
(
```
,
```
)
```
,
```
>
```
,
```
<
```
,
```
\
```
）

使用curl（RPC调用）验证代币合约是否在链上存在：

bash

undefined

Check if address is a contract using eth_getCode

IMPORTANT: Validate token_address matches ^0x[a-fA-F0-9]{40}$ before use

curl -s -X POST "$rpc_url"
-H "Content-Type: application/json"
-d "$(jq -n --arg addr "$token_address" '{"jsonrpc":"2.0","method":"eth_getCode","params":[$addr,"latest"],"id":1}')"
| jq -r '.result'


If the result is `0x` or empty, the address is not a valid contract.

**Alternative with cast** (optional, requires [Foundry](https://book.getfoundry.sh/)):

```bash

curl -s -X POST "$rpc_url"
-H "Content-Type: application/json"
-d "$(jq -n --arg addr "$token_address" '{"jsonrpc":"2.0","method":"eth_getCode","params":[$addr,"latest"],"id":1}')"
| jq -r '.result'


如果结果为`0x`或空，则该地址不是有效的合约。

**使用cast的替代方法**（可选，需要[Foundry](https://book.getfoundry.sh/)）：

```bash

Validate token_address matches ^0x[a-fA-F0-9]{40}$ before use

cast code "$token_address" --rpc-url "$rpc_url"


**Note:** The curl/RPC method above is preferred for broader compatibility. Only use `cast` if already available in the environment.

**RPC URLs by chain** - see `../../references/chains.md` for full list.

cast code "$token_address" --rpc-url "$rpc_url"


**注意：** 上述curl/RPC方法兼容性更广。仅在环境中已安装`cast`时使用。

**各链RPC URL** - 完整列表请查看`../../references/chains.md`。

Step 4: Research (If Needed)

步骤4：研究（必要时）

For unfamiliar tokens, use web search to research:

Token legitimacy and project info
Recent news or security concerns
Liquidity availability on Uniswap

Include relevant findings in the summary.

对于不熟悉的代币，使用网页搜索研究：

代币合法性和项目信息
近期新闻或安全问题
Uniswap上的流动性情况

在总结中包含相关发现。

Step 5: Fetch Price Data

步骤5：获取价格数据

Before generating the deep link, fetch current prices to estimate swap output. See

references/data-providers.md

for full API details.

Quick price lookup with DexScreener:

bash

undefined

生成深度链接前，获取当前价格以估算交换输出。完整API详情请查看

references/data-providers.md

。

使用DexScreener快速查询价格：

bash

undefined

Get token price and pool liquidity

curl -s "https://api.dexscreener.com/token-pairs/v1/{network}/{address}" |
jq '[.[] | select(.dexId == "uniswap")][0] | { price: .priceUsd, liquidity: .liquidity.usd, volume24h: .volume.h24 }'


**Network IDs:** `ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `bsc`, `avalanche`, `unichain`

**Liquidity warnings:**

| Pool TVL    | Risk Level | Action                        |
| ----------- | ---------- | ----------------------------- |
| > $1M       | Low        | Proceed normally              |
| $100k - $1M | Medium     | Note potential slippage       |
| < $100k     | High       | Warn user about slippage risk |

If API is unavailable, fall back to DefiLlama or web search for price estimates.

curl -s "https://api.dexscreener.com/token-pairs/v1/{network}/{address}" |
jq '[.[] | select(.dexId == "uniswap")][0] | { price: .priceUsd, liquidity: .liquidity.usd, volume24h: .volume.h24 }'


**网络ID：** `ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `bsc`, `avalanche`, `unichain`

**流动性警告：**

| 池TVL       | 风险等级 | 操作建议                  |
| ----------- | -------- | ------------------------- |
| > $1M       | 低       | 正常进行                  |
| $100k - $1M | 中       | 注意潜在滑点              |
| < $100k     | 高       | 警告用户滑点风险          |

如果API不可用，可使用DefiLlama或网页搜索估算价格。

Step 6: Generate Deep Link

步骤6：生成深度链接

Construct the Uniswap swap URL:

text

https://app.uniswap.org/swap?chain={chain}&inputCurrency={input}&outputCurrency={output}&value={amount}&field=INPUT

URL Parameters:

Parameter	Description	Values
`chain`	Network name	`ethereum` , `base` , `arbitrum` , `optimism` , `polygon` , `bnb` , `avalanche` , `celo` , `blast` , `zora` , `unichain` , `worldchain`
`inputCurrency`	Input token	Address or `NATIVE`
`outputCurrency`	Output token	Address or `NATIVE`
`value`	Amount	Decimal number (e.g., `1.5` )
`field`	Which field value applies to	`INPUT` or `OUTPUT`

构建Uniswap交换URL：

text

https://app.uniswap.org/swap?chain={chain}&inputCurrency={input}&outputCurrency={output}&value={amount}&field=INPUT

URL参数：

参数	描述	值
`chain`	网络名称	`ethereum` , `base` , `arbitrum` , `optimism` , `polygon` , `bnb` , `avalanche` , `celo` , `blast` , `zora` , `unichain` , `worldchain`
`inputCurrency`	输入代币	地址或 `NATIVE`
`outputCurrency`	输出代币	地址或 `NATIVE`
`value`	金额	十进制数（例如 `1.5` ）
`field`	金额对应的字段	`INPUT` 或 `OUTPUT`

Step 7: Present Output and Open Browser

步骤7：展示输出并打开浏览器

Format the response with:

Summary of the swap parameters
Deep link URL (displayed for reference)
Notes about risks or considerations
Open the browser automatically using system command

Example output format:

markdown

undefined

按以下格式整理响应：

交换参数摘要
深度链接URL（供参考展示）
风险或注意事项说明
自动打开浏览器（使用系统命令）

示例输出格式：

markdown

undefined

Swap Summary

交换摘要

Parameter	Value
From	1 ETH
To	USDC
Chain	Base
Current Rate	~3,200 USDC per ETH
Estimated Output	~3,200 USDC
Pool Liquidity	$15.2M (Low slippage risk)

参数	值
转出	1 ETH
转入	USDC
链	Base
当前汇率	~3,200 USDC per ETH
预估输出	~3,200 USDC
池流动性	$15.2M (Low slippage risk)

Notes

注意事项

Final amount depends on current market price
Default slippage is 0.5% - adjust in Uniswap if needed
Review all details in Uniswap before confirming

Opening Uniswap in your browser...


**After displaying the summary, open the URL in the browser:**

```bash

最终金额取决于当前市场价格
默认滑点为0.5% - 可在Uniswap中调整
确认前请在Uniswap中查看所有细节

正在浏览器中打开Uniswap...


**展示摘要后，在浏览器中打开URL：**

```bash

Linux

xdg-open "https://app.uniswap.org/swap?chain=base&inputCurrency=NATIVE&outputCurrency=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&value=1&field=INPUT"

macOS

open "https://app.uniswap.org/swap?..."


**Environment limitations:** Browser opening may fail in remote SSH, containerized, or headless environments. If `xdg-open`/`open` fails, display the full URL prominently so users can copy and paste it manually:

```markdown
**[Click here to open in Uniswap](https://app.uniswap.org/swap?...)**

Or copy this URL: `https://app.uniswap.org/swap?...`

Always present the summary and URL so users can review and execute.

open "https://app.uniswap.org/swap?..."


**环境限制：** 在远程SSH、容器化或无界面环境中，浏览器打开操作可能失败。如果`xdg-open`/`open`失败，请显眼地显示完整URL，以便用户手动复制粘贴：

```markdown
**[点击此处在Uniswap中打开](https://app.uniswap.org/swap?...)**

或复制此URL：`https://app.uniswap.org/swap?...`

请始终展示摘要和URL，以便用户查看并执行。

Important Considerations

重要注意事项

Slippage

滑点

The deep link uses Uniswap's default slippage (0.5%). For volatile tokens or large trades, advise users to adjust slippage in the interface.

深度链接使用Uniswap的默认滑点（0.5%）。对于波动大的代币或大额交易，建议用户在界面中调整滑点。

Gas Estimation

手续费估算

Gas costs vary by chain and network congestion. Base and Arbitrum typically have lower gas than Ethereum mainnet.

Gas费用因链和网络拥堵情况而异。Base和Arbitrum的Gas费用通常低于Ethereum主网。

Token Verification

代币验证

Always verify token contracts before generating links. Scam tokens often use similar names to legitimate tokens.

生成链接前务必验证代币合约。诈骗代币常使用与合法代币相似的名称。

Price Impact

价格影响

For large trades, warn users about potential price impact. Suggest splitting into smaller trades if impact would be significant.

对于大额交易，警告用户潜在的价格影响。建议拆分交易以降低影响。

Supported Chains

支持的链

All chains supported by the Uniswap interface:

Ethereum Mainnet (
```
ethereum
```
)
Base (
```
base
```
)
Arbitrum One (
```
arbitrum
```
)
Optimism (
```
optimism
```
)
Polygon (
```
polygon
```
)
BNB Chain (
```
bnb
```
)
Avalanche (
```
avalanche
```
)
Celo (
```
celo
```
)
Blast (
```
blast
```
)
Zora (
```
zora
```
)
World Chain (
```
worldchain
```
)
Unichain (
```
unichain
```
)

Uniswap界面支持的所有链：

Ethereum主网 (
```
ethereum
```
)
Base (
```
base
```
)
Arbitrum One (
```
arbitrum
```
)
Optimism (
```
optimism
```
)
Polygon (
```
polygon
```
)
BNB Chain (
```
bnb
```
)
Avalanche (
```
avalanche
```
)
Celo (
```
celo
```
)
Blast (
```
blast
```
)
Zora (
```
zora
```
)
World Chain (
```
worldchain
```
)
Unichain (
```
unichain
```
)

Additional Resources

附加资源

Reference Files

参考文件

../../references/chains.md
- Chain IDs, RPC URLs, native tokens, common token addresses
references/data-providers.md
- DexScreener and DefiLlama APIs for prices and liquidity

../../references/chains.md
- 链ID、RPC URL、原生代币、常见代币地址
references/data-providers.md
- DexScreener和DefiLlama的API，用于获取价格和流动性数据

Examples

示例

Common swap scenarios:

ETH → USDC on Ethereum
ETH → USDC on Base (lower gas)
USDC → WBTC on Arbitrum

常见交换场景：

ETH → USDC（Ethereum链）
ETH → USDC（Base链，更低Gas费用）
USDC → WBTC（Arbitrum链）

swap-planner

Original

Translation

Swap Planning

交换规划

Overview

概述

Workflow

工作流

Step 0: Token Discovery (When Needed)

步骤0：代币发现（必要时）

Option A: Search by Keyword

选项A：关键词搜索

Search for tokens by name/category (e.g., "degen", "pepe", "ai agent")

Search for tokens by name/category (e.g., "degen", "pepe", "ai agent")

Option B: Check Promoted Tokens

选项B：查看推荐代币

Get boosted/promoted tokens on a chain

Get boosted/promoted tokens on a chain

Option C: Web Search + Verify

选项C：网页搜索+验证

After finding a token address from web search, verify it exists

After finding a token address from web search, verify it exists

Category-Based Discovery

基于分类的发现

Present Options to User

向用户展示选项

Risk Assessment for Trending Tokens

热门代币的风险评估

Step 1: Gather Swap Intent

步骤1：收集交换意向

Step 2: Resolve Token Addresses

步骤2：解析代币地址

Step 3: Verify Token Contracts (Basic)

步骤3：验证代币合约（基础）

Check if address is a contract using eth_getCode

Check if address is a contract using eth_getCode

IMPORTANT: Validate token_address matches ^0x[a-fA-F0-9]{40}$ before use

IMPORTANT: Validate token_address matches ^0x[a-fA-F0-9]{40}$ before use

Validate token_address matches ^0x[a-fA-F0-9]{40}$ before use

Validate token_address matches ^0x[a-fA-F0-9]{40}$ before use

Step 4: Research (If Needed)

步骤4：研究（必要时）

Step 5: Fetch Price Data

步骤5：获取价格数据

Get token price and pool liquidity

Get token price and pool liquidity

Step 6: Generate Deep Link

步骤6：生成深度链接

Step 7: Present Output and Open Browser

步骤7：展示输出并打开浏览器

Swap Summary

交换摘要

Notes

注意事项

Linux

Linux

macOS

macOS

Important Considerations

重要注意事项

Slippage

滑点

Gas Estimation

手续费估算

Token Verification

代币验证

Price Impact

价格影响

Supported Chains

支持的链

Additional Resources

附加资源

Reference Files

参考文件

Examples

示例