Skip to content

swap-and-bridge.md

Latest commit

 

History

History
93 lines (62 loc) · 2.46 KB

swap-and-bridge.md

File metadata and controls

93 lines (62 loc) · 2.46 KB
Raw
description Swap or bridge tokens with mm swap quote and mm swap execute.
keywords
MetaMask
Agent Wallet
swap
bridge
mm

Swap and bridge tokens

Get a quote, review the route, and execute a same-chain swap or cross-chain bridge.

Ask your agent

You (to your agent): "Swap 0.1 ETH to USDC"

For a cross-chain bridge:

You (to your agent): "Bridge 10 USDC from Base to Arbitrum"

Your agent fetches a quote, shows you the route and output, then executes after you confirm.

Prerequisites

  • Quickstart completed
  • Sufficient balance of the source token on the source chain

Same-chain swap

  1. Request a quote:

    mm swap quote --from <TOKEN> --to <TOKEN> --amount <AMOUNT> --from-chain <CHAIN_ID> [--slippage <PERCENT>]

  2. Review the quoted output, fees, and route in the command output. Note the quoteId.

  3. Execute the swap:

    mm swap execute --quote-id <QUOTE_ID>

  4. Optionally check status:

    mm swap status --quote-id <QUOTE_ID>

Cross-chain bridge

Include --to-chain when requesting a quote:

mm swap quote --from USDC --to USDC --amount 10 --from-chain 8453 --to-chain 42161
mm swap execute --quote-id <QUOTE_ID>

Send bridged tokens to another address

Add --to-address to send output tokens to a recipient other than your wallet. Only valid for cross-chain bridges (--to-chain differs from --from-chain):

mm swap quote --from USDC --to USDC --amount 10 --from-chain 8453 --to-chain 42161 --to-address 0x742d35Cc6634C0532925a3b844Bc454e4438f08e

Top up destination gas (refuel)

When bridging to a chain where you hold no native gas token, add --refuel to bundle a small destination native-gas top-up into the quote:

mm swap quote --from USDC --to USDC --amount 50 --from-chain 1 --to-chain 42161 --refuel

Refuel is opt-in and cross-chain only. Do not use --refuel when the destination token is the destination chain's native gas asset (for example, bridging ETH to Arbitrum ETH). The backend returns NO_QUOTES in that case.

Common pitfalls

:::caution Verify the quote step succeeded If mm swap quote returns an error or no quote ID, do not call mm swap execute with a fabricated or expired quote ID. The execute step fails and no transaction is submitted, even when partial output is printed. :::

Related commands

See mm swap in the commands reference.