← 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