> For the complete documentation index, see [llms.txt](https://doc.lockerprotocol.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.lockerprotocol.com/browser-extension/swap.md).

# Swap

Exchange one token for another on the same network.

A swap trades one token for another on the same network, through an aggregator that finds the best route (LI.FI on EVM, Jupiter on Solana, SunSwap on Tron, path payments on Stellar).

## What you need

* A balance of the token you sell, plus a little of the network's coin for fees.
* Your Vault for one or two signatures.

{% stepper %}
{% step %}

### Fill in "You pay" and "You receive"

Home → **Swap**. Pick the token you sell and the amount (**Max** available), then **Select a token** to receive. Search by name or paste an address. *route not guaranteed* next to a token means the aggregator may not find a path.

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-ad68327358fb2d2ad47cee7947d4fc74535e3f8e%2F01-swap-form.png?alt=media" alt="swap form"><figcaption><p>The swap form.</p></figcaption></figure>
{% endstep %}

{% step %}

### Choose the network and token

**Select a network** narrows the token list; the badge on each logo shows its network. *No swap route on this network* means pick a mainnet token.

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-f14189e95a31c173a659f94f23cc76f999da4887%2F02-select-token.png?alt=media" alt="select token"><figcaption><p>The token picker with network badges.</p></figcaption></figure>
{% endstep %}

{% step %}

### Slippage

**Transaction settings → Slippage tolerance**: how much worse than the quote you accept. The default is fine; a **Custom (%)** value is for illiquid tokens.

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-fe23365e18afd9e7253c1d1409d8ff1cad974b35%2F03-slippage.png?alt=media" alt="slippage"><figcaption><p>Slippage settings.</p></figcaption></figure>
{% endstep %}

{% step %}

### Approval (tokens only)

Selling a token (not the network's coin) needs an *allowance* first. Either it is bundled (*Includes the token approval - one signature covers both*), or it is a separate step: **Step 1 of 2 · Allowance** then **Step 2 of 2 · Swap**. *Approved. Now sign the swap itself - this is the second of two signatures.*
{% endstep %}

{% step %}

### The quote, then sign

The summary shows **Rate**, **Minimum received**, **Price impact**, **Network fee**, and *Includes a X% fee*. **Quote valid for** counts down; an expired quote is refreshed and you are asked to check it again. **Submit**, then the QR loop with the Vault.

When no quote can be built, the wallet names the reason rather than staying silent: no route on this network, an amount below the routes' minimum (with the figure in dollars), or a route that could not be built right now.

It also refuses quotes that do not add up, and says which: a route service that describes the token you are buying with **a different number of decimals** than the network does, or one that guarantees **far less than the slippage you set** allows. In both cases nothing is staged, and the message tells you what to change.

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-12b29414211af3cab0e5e6909730c5d994e9be5f%2F05-quote.png?alt=media" alt="quote"><figcaption><p>The quote summary.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
*The approval itself was broadcast and stands on-chain. Only the trade could not be staged - your funds did not move.* If you see this, retry the swap; the allowance is already in place. You can also [revoke it](https://doc.lockerprotocol.com/browser-extension/revoke-an-approval.md).
{% endhint %}

{% hint style="info" %}
**What the wallet checks before it stages a route.** The route it hands the Vault is held against the quote you accepted: the same token in, the same token out, the same account, the same chain, and a minimum received that respects the slippage you chose. A route that does not match the quote is refused rather than signed.
{% endhint %}
