Swaps

The Swap with Crypto flow lets you exchange one token for another, on the same chain or across chains, using your connected wallet or embedded smart wallet.

Qwerti works as an aggregator: it finds a route through trusted providers (like Jupiter, Relay, 1inch, OKX and others), builds the transaction, and lets you confirm it in a few clicks.


1. What You Can Do with Swaps

With the swap flow in Qwerti, you can:

  • Swap tokens on the same chain (e.g. SOL → BONK token on Solana)

  • Perform cross-chain swaps (e.g. PEPE on Ethereum → BONK on Solana)

  • Use either:

    • your own self-custody wallet

    • or an embedded smart wallet created via socials / email

Depending on the route, a swap can be:

  • a simple mono-chain swap, or

  • direct cross-chain swap, or

  • a bridge + swap sequence under the hood.

Qwerti hides this complexity and shows you a single, clean flow.


2. Starting a Swap

Step 1 — Select source chain & token

In the “Swap” section:

  1. Select the network (chain) where your funds are located (for example: Solana, Base, BNB, etc.)

  2. Choose the token you want to spend

  3. Enter the amount you want to swap

Qwerti will check your balance on that chain and validate that:

  • you have enough token to swap

  • and you have some native token for gas on that chain (to pay network fees)


Step 2 — Route & Quote

After you completed step 1:

  • Qwerti queries its routing providers (for example, DEXs and/or Bridges)

  • It finds the cheapest available route, considering:

    • expected output amount

    • liquidity

    • slippage

    • fees and reliability

You’ll see a quote with:

  • the estimated amount of the target token you will receive

  • any relevant fees included in the route

  • (optionally) a route breakdown (e.g. which aggregator / bridge is used)

For a detailed breakdown of fees, see the Fees page.

If the route doesn’t meet minimum conditions (for example, amount too small, or no liquid path), you’ll see an error or a suggestion to adjust the amount.


Step 3 — Confirm the swap

Once you’re happy with the quote:

  1. Click “Swap Tokens” in the Qwerti UI

  2. Your wallet (self-custody or embedded) will open a confirmation window

  3. Review:

    • the transaction details

    • the network / gas cost

  4. Approve the transaction in your wallet

If you reject the transaction in your wallet, nothing is executed.


Step 4 — Processing & Completion

After you sign:

  • The transaction will show as Processing in Qwerti

  • For mono-chain and cross-chain swaps, this usually completes quickly once the on-chain tx is confirmed.

  • For bridge + swap flow, you may see two steps:

    1. Bridging funds to the target chain

    2. Swapping into the target token on the target chain

Once everything is done, the status will change to Completed, and the target token will appear in your wallet.


3. Mono-Chain vs Cross-Chain Swaps

3.1 Same-chain swaps

These are swaps where:

  • source chain = target chain

Example:

  • SOL → BONK (both on Solana)

  • USDC → ETH (both on an Base chain)

Characteristics:

  • Usually faster and cheaper

  • Typically a single transaction on one network

  • Uses a DEX / aggregator route on that chain


3.2 Cross-chain swaps

These are swaps where:

  • source chaintarget chain

Example:

  • PEPE on Ethereum → BONK on Solana

Under the hood:

  1. Your assets are bridged from the source chain to the target chain

  2. Once funds arrive on the target chain, they are swapped into the final token

Characteristics:

  • May involve multiple providers (Bridge + DEX, or jest DEX, depends of cheapest route)

  • Sometimes takes longer than single-chain swaps

  • Final completion time depends on:

    • bridge confirmation

    • target chain congestion

Qwerti keeps you on a single screen with step-by-step status instead of forcing you to manually hop across different apps.


4. Fees for Swaps (Short Version)

When you use swaps in Qwerti, you typically pay:

  1. Routing / liquidity provider fee

    • e.g. an aggregator like Jupiter charging around 0.10%

  2. Qwerti fee: 0.10% per swap transaction

  3. Network gas fees

    • paid to the blockchain where the transaction is executed

    • not controlled by Qwerti

For the full explanation and examples, see the Fees page.


5. Slippage, Quotes & Expiry

5.1 Slippage

Token prices move constantly. To protect you, swaps usually have a slippage tolerance:

  • If the price moves more than this tolerance against you before execution, the transaction can revert.

  • This prevents you from receiving significantly less than expected.

Depending on the UI, slippage may be:

  • automatically set to a default value (we automatically find you a route with lowest slippage requirements)

  • configurable by advanced users


5.2 Quote expiry

Quotes are time-sensitive.

  • If you wait too long before confirming, the quote may expire

  • In that case, we automatically refresh quotes every 5-10 seconds

This is normal behavior in DeFi aggregators and helps reflect up-to-date market conditions.


6. Common Errors & How to Handle Them

Here are some common issues you might encounter:

“Insufficient funds / Not enough balance”

  • Your source token balance is lower than the amount you’re trying to swap → Reduce the amount or add more funds to your wallet.

“Insufficient gas”

  • You don’t have enough native token (e.g. SOL, ETH) to pay for network fees → Top up a small amount of native token on that chain.

“Route not found” or “No liquidity”

  • There is no reliable route for this pair / amount right now → Try:

    • lowering the amount

    • choosing another source token

    • or picking a different source chain.


7. Best Practices for Swaps

  • Always double-check:

    • the source chain & token

    • the target chain & token

    • the amount you’re swapping

  • Keep a small buffer of native token on each active chain for gas.

  • For volatile or low-liquidity tokens:

    • be careful with high slippage settings

    • consider swapping smaller amounts first

  • If something looks off (unexpected output, weird token, very high slippage):

    • stop and re-check before confirming.


In short:

The Swaps flow in Qwerti gives you a simple, aggregated interface to swap tokens within and across chains, while you stay in full control of your wallet, approvals, and risk.

Last updated