← All guides Intermediate • 10 min

Your First Cross-Chain Swap

A cross-chain swap moves your tokens from one blockchain to another — for example, USDC on Ethereum becoming USDC on Polygon. Here's how to do it safely.

1

What is a cross-chain swap, really?

Each blockchain (Ethereum, Polygon, Arbitrum, etc.) is its own separate network. They don't talk to each other directly. To move value between them you need a bridge — a smart contract on chain A that locks your tokens, then releases equivalent tokens on chain B.

Bridges are the most exploited part of crypto. Over $2.5 billion has been stolen from bridge hacks (Ronin, Wormhole v1, Nomad, Multichain, Harmony Horizon). That's why Riverforge only uses bridges that score 90/100 or higher on safety.

2

What Riverforge will use

Our AI router picks from a small whitelist of safe bridges:

For pure swaps within one chain, we use Uniswap v3 on EVM chains and Raydium on Solana.

3

Pick your tokens

On the dashboard's swap card:

From: Click the token selector. You'll only see tokens you actually own — the dropdown reads your connected wallet's balances live. Pick what you want to spend.

To: Pick the destination token. This can be:

4

Enter amount

Type how much you want to swap. The dashboard shows your wallet balance for that token, so you know the maximum.

Tip: Leave a little native token (ETH, MATIC, etc.) in your wallet for gas. If you swap 100% of your ETH out, you won't have any left to pay for the next transaction.
5

Find routes

Click Find Routes. The AI takes a few seconds to analyze options and returns the safest path. You'll see:

Tip: If no route is found, the AI couldn't find a path that meets the safety threshold. Try a different chain or token combination.
6

Execute the swap

Click Execute Swap. Your wallet pops up with a transaction to sign. Always read what you're signing — the wallet shows the contract you're interacting with and the amount being moved.

For some swaps you may need to sign multiple transactions:

  1. Approve — gives the bridge permission to move your tokens (one-time per token per chain)
  2. Bridge/Swap — the actual transaction

After you approve, the transaction goes on-chain. Riverforge tracks the status in real time.

7

Wait for arrival

Cross-chain swaps take longer than same-chain swaps because the destination chain has to wait for the source chain transaction to be confirmed and the bridge message to be relayed. Typical times:

The dashboard updates automatically when your destination tokens arrive.

✓

Done

Your tokens are now on the destination chain. You can swap them, hold them, or use them in any DeFi app on that chain.

Next up

→ Troubleshooting common issues