Swapping tokens

Swapping is the simplest thing you can do on Kumbaya. Pick the token you have, pick the token you want, click swap. The whole flow is designed to feel instant - most swaps confirm in well under a second.

The Swap page on kumbaya.xyz

Make your first swap

1. Go to kumbaya.xyz/#/swap (or click Swap in the top nav).

2. In the top field, pick the token you're paying with and enter an amount.

3. In the bottom field, pick the token you want to receive. The amount fills in automatically based on the current best route.

4. Review the rate, price impact, and minimum received lines.

5. If this is your first time swapping with that token, you'll see an Approve button - click it and confirm the approval in your wallet. (You only do this once per token.)

6. Click Swap and confirm in your wallet.

That's the whole flow.

Reading the swap details

Before you confirm, expand the swap card to see:

• Rate - how much of the destination token you get per unit of source token.

• Price impact - how much your trade is moving the market price. Under 1% is normal; over 5% means the pool is thin and you might want a smaller trade.

• Minimum received - the absolute least you'll get back, accounting for slippage.

• Network fee (gas) - what you'll pay in ETH to MegaETH for processing the transaction.

• Route - which pools the trade is going through. Sometimes the best price comes from hopping through an intermediate token like ETH or USDC.

Slippage

Slippage is the difference between the price you saw and the price you actually got. It exists because the pool moves with every trade, including yours.

• The default tolerance is 0.5% for most tokens - fine for blue chips.

• For new or low-liquidity tokens, you may need to bump it to 1–3%.

• Click the gear icon ⚙️ in the swap card to change it.

If your swap fails with a "Slippage exceeded" error, it usually means the price moved more than your tolerance allowed between clicking and confirming. Try again with a slightly higher tolerance or a smaller size.

For more, see Slippage and gas explained.

Finding the right token

Most tokens you'd want to trade show up in the picker without any setup:

• Verified tokens (curated by Kumbaya) appear by default and carry a Verified badge.

• Launchpad tokens show up automatically as soon as they're launched - you don't need to import them. You can also go to the launch page (kumbaya.xyz/#/launch/<address>) and use the swap panel right there.

The only time you'd manually import is for an arbitrary on-chain token that isn't on Kumbaya's lists and didn't launch through the launchpad. To do that:

1. Click the token picker.

2. Paste the token's contract address into the search box.

3. Kumbaya looks it up on-chain and lets you select it. Once imported it carries an Imported badge.

⚠️ Unknown tokens carry real risk

Tokens that aren't on Kumbaya's verified list show up with an Unknown badge (golden, tooltip: "This token is not on our token list or launchpad"). Treat these with caution. Anyone can deploy an ERC-20 with any name and symbol, and an Unknown token can:

• Be a scam impersonator - same name/symbol as a popular token but a different address that nobody has audited.

• Be a honeypot - designed to let you buy but not sell, trapping your funds.

• Have admin transfer/freeze powers - the contract owner may be able to move tokens out of your wallet, blacklist your address, or pause transfers entirely.

• Have hidden taxes - fees on every transfer that drain value out of holders.

Before swapping into an Unknown token:

• Verify the contract address is the one you expect - check the block explorer (mega.etherscan.io) and the project's official channels.

• Start with a tiny amount and try selling it back before scaling in.

• Read the contract source on the explorer if you can - look for onlyOwner modifiers on transfer functions, blocklists, or taxable transfers.

• When in doubt, skip it. Kumbaya can't recover funds lost to a malicious token contract.

Wrap and unwrap ETH

ETH and WETH are interchangeable on Kumbaya. The app wraps and unwraps automatically when needed for a swap, so you don't have to think about it. If you ever want to manually wrap/unwrap, do an ETH ↔ WETH swap - the rate is always 1:1 with no fees.

Common swap errors

Error	What it means	Fix
Slippage exceeded	Price moved more than your tolerance	Increase slippage or reduce size
Insufficient gas	Not enough ETH to pay the network fee	Top up your ETH balance
Insufficient allowance	Token approval was too small	Approve again with a higher amount
Pool not found	No pool exists for that pair	Try routing through ETH or USDC

"Transaction failed on chain"

If your swap submitted, then the UI showed "Transaction failed on chain. Please try again.", the transaction reached MegaETH but reverted. The Kumbaya UI doesn't always surface the underlying revert reason - to see it, open the transaction on the block explorer (mega.etherscan.io) by clicking the tx hash in the failed-swap notification (or by pasting the hash into the explorer's search). The explorer shows the contract-level error message, which usually points straight at the cause:

• Too little received → slippage exceeded; bump tolerance or reduce size.

• STF → token allowance too low; re-approve.

• A revert from the token contract itself (e.g. transfer paused, blocklisted) → the token has admin restrictions; see the Unknown tokens warning above.

• No reason given → usually a bad path or a token with non-standard transfer behaviour.

If something else goes wrong, check Troubleshooting.

Where to next?

• Adding liquidity → to earn fees on your tokens

• Discovering tokens → on the launchpad