# User Guide

### Connect your wallet <a href="#connect-your-wallet" id="connect-your-wallet"></a>

Before starting your cross-chain transfer, we need to connect the wallet

Click "Connect Wallet", and you will be prompted to select a wallet. (This tutorial will take MetaMask as an example).

![](https://docs.butternetwork.io/~gitbook/image?url=https%3A%2F%2F753337664-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FeZxUsQ7XiGCAg2Xch4Yp%252Fuploads%252FMfYNk4HugmWUXETbtrvw%252Fimage.png%3Falt%3Dmedia%26token%3Deccfb67e-3066-43cd-99ba-db4440c0124e\&width=768\&dpr=4\&quality=100\&sign=ab2aff0365cffe4791ab62eb9cdc70df318d3cce13f8c7c1e6de5cebf6be475c)

Select MetaMask, and you should now see your wallet address in the top right corner of the page.

![](https://docs.butternetwork.io/~gitbook/image?url=https%3A%2F%2F753337664-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FeZxUsQ7XiGCAg2Xch4Yp%252Fuploads%252FR2njmUvemIKFXV3PXS53%252Fimage.png%3Falt%3Dmedia%26token%3Dcc9f5b61-5d95-40ca-8cfe-75a7bcc380c1\&width=768\&dpr=4\&quality=100\&sign=e63bb8d1b70eb2e52ab4ecaf19ebc2ea3608db36e2c81ed20942f2d189d1925c)

### Select Chain and Assets <a href="#select-chain-and-assets" id="select-chain-and-assets"></a>

In the **'From'** section, we need to select the source chain and token that we want to transfer.

In the **'To'** section, we need to select the destination chain and token that we want to be swapped.

In the **'Received Address'** section, we can input an address we want to receive the cross-chain token. The default is the same address as the sending one.

In the **'You pay'** section, we can input the amount of token we want to send.

![](https://docs.butternetwork.io/~gitbook/image?url=https%3A%2F%2F753337664-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FeZxUsQ7XiGCAg2Xch4Yp%252Fuploads%252Fnevqt7GF4ARO76hsrpnQ%252Fimage.png%3Falt%3Dmedia%26token%3Dbe64444e-4c28-4b81-b107-15cec4425d49\&width=768\&dpr=4\&quality=100\&sign=b74746dc7ae637c65e56d14c83ec3c1474fd9a76263ac6bc84166ebd2e6da292)

The selection panel can be poped up by clicking at **'Choose'** in both **'From'** and **'To'** section, we can select the chains and tokens in the panel.

![](https://docs.butternetwork.io/~gitbook/image?url=https%3A%2F%2F753337664-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FeZxUsQ7XiGCAg2Xch4Yp%252Fuploads%252F27Wglc6xswMA2EpmNjPH%252Fimage.png%3Falt%3Dmedia%26token%3D145a0e05-0f00-49f3-8faa-734ef15a99f7\&width=768\&dpr=4\&quality=100\&sign=ea8de3352d70316fab4130e4a0f0b294cf849198db5647d37aff447f569b529f)

### Confirm the Cross-chain Swap <a href="#confirm-the-cross-chain-swap" id="confirm-the-cross-chain-swap"></a>

After selecting both chains/tokens and entering the amount, the best route will be retrieved by Butter Routing Service.

The route gives a detailed trace of the token swapping process and the expected receiving amount on the destination chain.

The fee section below **'Confirm'** button is the cost of the cross-chain transaction.

![](https://docs.butternetwork.io/~gitbook/image?url=https%3A%2F%2F753337664-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FeZxUsQ7XiGCAg2Xch4Yp%252Fuploads%252FwRowFxyz1fl9Kksq5hZI%252Fimage.png%3Falt%3Dmedia%26token%3D6a320780-aa01-4a63-99ac-c6394e86604e\&width=768\&dpr=4\&quality=100\&sign=a79d2f272151d99523a4322003108712650b90c4e98c06a3c585565847b5a416)

A confirmation window will pop up after clicking on the **'Confirm'** button, the detail of the cross-chain transaction will be listed in the pop-up.

After reviewing the detail, we need to confirm again to proceed the transfer

![](https://docs.butternetwork.io/~gitbook/image?url=https%3A%2F%2F753337664-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FeZxUsQ7XiGCAg2Xch4Yp%252Fuploads%252F6fEklOsAf2FXbvqdbyo5%252Fimage.png%3Falt%3Dmedia%26token%3D85571bed-2988-48eb-9eca-d716fdbd779d\&width=768\&dpr=4\&quality=100\&sign=d4a2fdf0831c8d6132cf977d8483c2cd816685fe7b566c4f6f4b79e5bf2af1aa)

***

## Learn first

* [🧈 What is a cross-chain swap?](/butter-swap-user-guide/what-is-a-cross-chain-swap.md)

***

## Swap tutorials

These are pair-specific step by step tutorials. Use them if you want exact address format warnings, gas tips, fees and timing notes, and UI aligned steps for a specific route.

* [USDT (TRC20) to BTC (Native Bitcoin) Step by Step](/butter-swap-user-guide/swap-tutorials/swap-usdt-trc20-to-btc.md)
* [BTC (Native Bitcoin) to USDT on BNB Chain Step by Step](/butter-swap-user-guide/swap-tutorials/swap-btc-to-usdt-bnb-chain.md)
* [BTC (Native Bitcoin) to USDT (TRC20) on TRON Step by Step](/butter-swap-user-guide/swap-tutorials/swap-btc-to-usdt-trc20-tron.md)
* [ETH (Ethereum) to USDT (TRC20) on TRON Step by Step](/butter-swap-user-guide/swap-tutorials/swap-eth-to-usdt-trc20-tron.md)
* [BTC (Native Bitcoin) to USDC on Solana Step by Step](/butter-swap-user-guide/swap-tutorials/swap-btc-to-usdc-solana.md)
* [Swap into memecoins safely (Solana, BNB Chain, TRON)](/butter-swap-user-guide/swap-tutorials/swap-into-memecoins-safely.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.butternetwork.io/butter-swap-user-guide/user-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.