> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cow.bleu.builders/llms.txt
> Use this file to discover all available pages before exploring further.

# Cross-chain swaps

> The  feature on  lets you swap a token on one network and receive a different token on another network — all in one seamless transaction.

This guide will walk you through the process step-by-step, from setting up your trade to tracking it in the explorer.

<img src="https://mintcdn.com/cowswap/r2wvR6M9DaXUdOhD/images/cowswap/bridging/swap-form.png?fit=max&auto=format&n=r2wvR6M9DaXUdOhD&q=85&s=92137c8be6a2b954ec7b430766f8786e" alt="Cross-chain swaps" width="1026" height="972" data-path="images/cowswap/bridging/swap-form.png" />

<Note>
  Currently, the Cross-chain swaps functionality is limited to swap orders and is not available for smart contract wallets. These features will be available in the future.
</Note>

***

## 1. Setting up a Swap with Different Network Assets

When using **Cross-chain swaps**, you’ll start by selecting the tokens you want to trade — just like a regular swap — but with the option to choose a different destination chain.

### Source Token Selector

Open a source token selector:

<img src="https://mintcdn.com/cowswap/r2wvR6M9DaXUdOhD/images/cowswap/bridging/source-token-selector-place.png?fit=max&auto=format&n=r2wvR6M9DaXUdOhD&q=85&s=80dbba0696b020e94c19ac86c44fab0a" alt="Open source token selector" width="978" height="610" data-path="images/cowswap/bridging/source-token-selector-place.png" />

Select the network and token you want to sell:

<img src="https://mintcdn.com/cowswap/r2wvR6M9DaXUdOhD/images/cowswap/bridging/source-token-selector.png?fit=max&auto=format&n=r2wvR6M9DaXUdOhD&q=85&s=cb324d0c95c6f3dddf663230b4ccf7ff" alt="Source token selector" width="1238" height="986" data-path="images/cowswap/bridging/source-token-selector.png" />

### Destination Token Selector

Similarly to Source Token Selector, open the selector, choose a network and token you would like to buy

<img src="https://mintcdn.com/cowswap/BmBLPrBvQ401BeyM/images/cowswap/bridging/destination-token-selector.png?fit=max&auto=format&n=BmBLPrBvQ401BeyM&q=85&s=0cb0e1dbfe3d98b4a3ed22b5a4d91728" alt="Destination token selector" width="994" height="624" data-path="images/cowswap/bridging/destination-token-selector.png" />

<Check>
  The list of available destination networks depends on the source token you’ve selected.

  If you choose a destination network different from the source token’s network:

  * You will only see tokens supported by the bridge provider for that chain.

  If the destination network is the same as the source network:

  * You’ll see the regular list of tokens from the token lists.
</Check>

<Note>
  **Tokens must be different.** Bridging the same token between two networks is not yet supported. This feature will be available in the future.
</Note>

***

## 2. Creating a Cross-chain swap

Once your tokens and networks are set, you can proceed to create the order.

### Token Approval

If it’s your first time selling this token through CoW Swap, you’ll need to approve it. This is the standard ERC-20 approval process that allows CoW Protocol to use your tokens for the trade.

Approvals can happen through:

* Regular ERC-20 allowance transactions
* [EIP-2612](https://eips.ethereum.org/EIPS/eip-2612) signature (when supported by the token)

<img src="https://mintcdn.com/cowswap/BmBLPrBvQ401BeyM/images/cowswap/bridging/sign-approval.png?fit=max&auto=format&n=BmBLPrBvQ401BeyM&q=85&s=7ced2f803a7749b835ba23b2c38d9e44" alt="Sign an approval" width="1150" height="805" data-path="images/cowswap/bridging/sign-approval.png" />

### Signing Steps

1. **Sign the post-hook call** for the bridge provider.

* The post-hook might include a call to approve an `intermediate token` in the Account Proxy, allowing it to be transferred to the deposit smart contract.
* The post-hook always includes a call to the bridge provider’s smart contract, which transfers the swapped amount to the deposit smart contract.

2. **Sign the order**:

* Sign an off-chain order (ERC-20 token selling).
* Sign a transaction (Native tokens (e.g., ETH) selling).

<img src="https://mintcdn.com/cowswap/r2wvR6M9DaXUdOhD/images/cowswap/bridging/sign-post-hook.png?fit=max&auto=format&n=r2wvR6M9DaXUdOhD&q=85&s=70fef616389838eb6f3ee965c0b5b58a" alt="Sign a post-hook" width="1192" height="854" data-path="images/cowswap/bridging/sign-post-hook.png" />

<img src="https://mintcdn.com/cowswap/r2wvR6M9DaXUdOhD/images/cowswap/bridging/sign-order.png?fit=max&auto=format&n=r2wvR6M9DaXUdOhD&q=85&s=d4ac012b463950216ec98e911e9d3b8c" alt="Sign an order" width="1172" height="858" data-path="images/cowswap/bridging/sign-order.png" />

<Note>
  **Intermediate token** — the currency received on the source chain as the result of a swap, which is then deposited to the bridge provider. It is usually the same currency as on the destination chain, but issued on the source blockchain.
</Note>

<Note>
  If a token to sell does not have an approved permit, the process will involve three signing steps, beginning with the permit signature.
</Note>

***

## 3. Using a Custom Recipient

By default, your connected wallet address will be set as the recipient on the destination chain. If you want to send funds to another address:

* Enable **Custom recipient** in the settings (same place as in the regular Swap).
* Enter a recipient address.
* **Note:** ENS names are **not** supported here — you must use a full wallet address.

<img src="https://mintcdn.com/cowswap/BmBLPrBvQ401BeyM/images/cowswap/bridging/custom-recipient.png?fit=max&auto=format&n=BmBLPrBvQ401BeyM&q=85&s=e7ef2eed6a36bbd8eeb11a8d1d4619b4" alt="Custom recipient" width="1116" height="1238" data-path="images/cowswap/bridging/custom-recipient.png" />

***

## 4. Previewing Your Quote

In the Swap form you can see a detailed breakdown of the expected swap and bridge:

* Swap **Min. to receive** → Final amount after all swap costs and a slippage tolerance.
* **Expected deposit amount** → This is equal to the “Expected to receive” amount from the swap step.
* **Bridge cost** → A fee charged by a bridge provider for processing your transfer.
* **Estimated bridging time** → Pulled directly from a bridge provider (varies by a network and a provider).
* Bridge **Min. to receive** → Calculated as: `(Swap min. to receive)` - `(Bridge provider cost)`

<img src="https://mintcdn.com/cowswap/BmBLPrBvQ401BeyM/images/cowswap/bridging/quote-preview.png?fit=max&auto=format&n=BmBLPrBvQ401BeyM&q=85&s=46cb11811d50acab9d29b81578bef508" alt="Quote preview" width="1008" height="1078" data-path="images/cowswap/bridging/quote-preview.png" />

***

## 5. Understanding the Account Proxy

The [**Account Proxy**](https://swap.cow.fi/#/1/account-proxy) (also known as **CoW Shed**) is a helper contract that powers advanced features like [**CoW Hooks**](/cow-protocol/reference/core/intents/hooks).

* **CoW Hooks** allow solvers to execute additional Ethereum calls before or after your order is settled.
* Your funds are safe: If anything goes wrong during execution, your assets will be sent to your personal proxy account. You can withdraw them to your wallet at any time.

> More detailed information can be found in [Account Proxy page](https://swap.cow.fi/#/1/account-proxy/help).

***

## 6. How Bridging Execution Works

1. The bridge step will only start **after** a successful swap.

<img src="https://mintcdn.com/cowswap/r2wvR6M9DaXUdOhD/images/cowswap/bridging/swap-success.png?fit=max&auto=format&n=r2wvR6M9DaXUdOhD&q=85&s=8da10dcc130da0bb676031b6ace5f489" alt="Swap is finished" width="530" height="610" data-path="images/cowswap/bridging/swap-success.png" />

<Note>
  If your order expires, is canceled, or fails, bridging will not start — your funds will remain in your wallet.
</Note>

<Note>
  You can only soft‑cancel your order during the swap phase. Once the swap has executed and the bridge deposit has been submitted by your Account Proxy, the bridge transfer cannot be canceled. It will complete on the destination chain or be refunded per the provider’s policy.
</Note>

2. Once the swap completes:

* The order goes into 'Bridging in progress' status.
* The received amount is sent to your [**Account Proxy**](https://swap.cow.fi/#/1/account-proxy).
* From there, it’s deposited into the bridge provider’s smart contract.
* These steps happen within **one transaction**.

3. When the bridging completes, you’ll see a **“Bridging completed!”** status along with the final amount received on the destination chain.
4. You’ll always get a link to the bridge provider’s explorer to track your order progress.

<img src="https://mintcdn.com/cowswap/BmBLPrBvQ401BeyM/images/cowswap/bridging/bridging-in-progress.png?fit=max&auto=format&n=BmBLPrBvQ401BeyM&q=85&s=71771e8781ac740ad98609e323cc23c6" alt="Bridging in progress" width="512" height="721" data-path="images/cowswap/bridging/bridging-in-progress.png" />

<img src="https://mintcdn.com/cowswap/BmBLPrBvQ401BeyM/images/cowswap/bridging/bridging-success.png?fit=max&auto=format&n=BmBLPrBvQ401BeyM&q=85&s=5475ccc12737451dedb0ec753c629130" alt="Bridging success" width="498" height="695" data-path="images/cowswap/bridging/bridging-success.png" />

5. Your Cross-chain swaps history is available in the **Account modal** on CoW Swap. .

<img src="https://mintcdn.com/cowswap/BmBLPrBvQ401BeyM/images/cowswap/bridging/activities-button.png?fit=max&auto=format&n=BmBLPrBvQ401BeyM&q=85&s=9f7988e269e03ab0c11b372b603f49ab" alt="Activities button" width="1188" height="242" data-path="images/cowswap/bridging/activities-button.png" />

<img src="https://mintcdn.com/cowswap/BmBLPrBvQ401BeyM/images/cowswap/bridging/activities-list.png?fit=max&auto=format&n=BmBLPrBvQ401BeyM&q=85&s=fc2113ee214dbd213005db8b22e02196" alt="Activities list" width="811" height="477" data-path="images/cowswap/bridging/activities-list.png" />

<Note>
  **Account modal** displays only last 10 orders. For your full order history, visit [CoW Explorer](https://explorer.cow.fi)
</Note>

***

## 7. If Bridging Fails — Getting a Refund

In rare cases, the bridging step may fail. Don’t worry — your funds are safe.

Most bridge providers will automatically send your funds back to your [**Account Proxy**](https://swap.cow.fi/#/1/account-proxy) once the deposit expires.

Expiration time varies by provider. For example, **Across** provider usually refunds after \~3 hours if the deposit hasn’t been completed.

Once the refund arrives in your Account Proxy:

* Open the CoW Swap [**Account Proxy**](https://swap.cow.fi/#/1/account-proxy/help) page.
* In the list of Account Proxy versions, select the latest Account Proxy version (unless you’ve been told to use a different one).
* Open details of the required Account Proxy version.
* Choose a token and recover the funds to your wallet.

<img src="https://mintcdn.com/cowswap/BmBLPrBvQ401BeyM/images/cowswap/bridging/account-proxy-list.png?fit=max&auto=format&n=BmBLPrBvQ401BeyM&q=85&s=0d2959d8a165e1afb52e9bdfbef05695" alt="Account proxies" width="1038" height="654" data-path="images/cowswap/bridging/account-proxy-list.png" />

<img src="https://mintcdn.com/cowswap/BmBLPrBvQ401BeyM/images/cowswap/bridging/account-proxy-card.png?fit=max&auto=format&n=BmBLPrBvQ401BeyM&q=85&s=080369aef546c731e848a6c8eee65148" alt="Account proxy" width="1030" height="870" data-path="images/cowswap/bridging/account-proxy-card.png" />

***

## 8. Tracking Your Orders in the Explorer

You can view all your Cross-chain swaps on [explorer.cow.fi](https://explorer.cow.fi).

* See orders in any state — **In Progress**, **Completed**, **Cancelled**, and more.
* Filter results and view full details for each trade.
* Each Cross-chain swap has two tabs — Swap and Bridge — so you can easily explore both parts of the transaction.

<img src="https://mintcdn.com/cowswap/BmBLPrBvQ401BeyM/images/cowswap/bridging/cow-explorer.png?fit=max&auto=format&n=BmBLPrBvQ401BeyM&q=85&s=9a9892c16ab32b50f9d3b9f11871cce7" alt="CoW Explorer" width="2202" height="1270" data-path="images/cowswap/bridging/cow-explorer.png" />
