moonpay-swap-tokens

兑换或跨链桥接代币

目标

在同一条链上兑换代币，或跨链桥接代币。有两个命令：

• mp token swap — 同一条链，不同代币
• mp token bridge — 跨链

这两个命令都会通过 swaps.xyz 构建交易，在本地签名，广播交易，并注册以便跟踪。

命令

兑换（同一条链）

mp token swap \
  --wallet <wallet-name> \
  --chain <chain> \
  --from-token <token-address> \
  --from-amount <amount> \
  --to-token <token-address>

支持精确输出：使用 --to-amount 替代 --from-amount。

跨链桥接（跨链）

mp token bridge \
  --from-wallet <wallet-name> \
  --from-chain <chain> \
  --from-token <token-address> \
  --from-amount <amount> \
  --to-chain <chain> \
  --to-token <token-address> \
  --to-wallet <wallet-name>  # optional, defaults to from-wallet

支持精确输出：使用 --to-amount 替代 --from-amount。

示例

同链兑换（在 Solana 上将 SOL 兑换为 USDC）

mp token swap \
  --wallet main --chain solana \
  --from-token So11111111111111111111111111111111111111111 \
  --from-amount 0.1 \
  --to-token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

跨链桥接（将 ETH 桥接为 Polygon 上的 USDC.e）

mp token bridge \
  --from-wallet funded --from-chain ethereum \
  --from-token 0x0000000000000000000000000000000000000000 \
  --from-amount 0.003 \
  --to-chain polygon \
  --to-token 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174

ERC20 兑换（需要时自动授权）

mp token swap \
  --wallet funded --chain polygon \
  --from-token 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 \
  --from-amount 5 \
  --to-token 0x0000000000000000000000000000000000000000

支持的链

solana、ethereum、base、polygon、arbitrum、optimism、bnb、avalanche、bitcoin（仅支持跨链桥接）

工作原理

1. 将钱包名称解析为地址
2. 通过 swaps.xyz 构建未签名交易（处理小数位转换）
3. 如果 ERC20 代币需要授权，会先发送授权交易，然后重新构建交易
4. 在本地签名 — 私钥不会离开本机
5. 将交易广播到网络
6. 注册以便跟踪

token swap 在底层通过设置 from-chain = to-chain 调用 token bridge。

提示

• 如果用户提供了代币名称或符号，请使用 mp token search --query "USDC" --chain solana 解析为地址
• 先使用 mp token balance list --wallet <address> --chain <chain> 检查余额
• 原生代币使用 0x0000000000000000000000000000000000000000（EVM）或 So11111111111111111111111111111111111111111（Solana）

相关技能

• moonpay-discover-tokens — 搜索代币地址
• moonpay-check-wallet — 兑换前检查余额
• moonpay-auth — 设置用于签名的钱包