ErgoDEXBetaFAQ

Frequently asked questions

Updated

Short answers to what people ask before their first swap and after it. Each one links to the page with the details.

Who holds my funds?

You do. ErgoDEX never holds your funds and never sees your seed phrase or keys. It reads the chain, prepares a transaction and hands it to your wallet; nothing happens until you sign it there.

Pools and orders are contracts on the Ergo blockchain. Funds in an order stay in its box on the chain, under the order’s contract: our executor can only fill it at your price or better, and only you can cancel it. See Your wallet and your keys.

Which wallets can I use?

  • Nautilus, the browser extension, on a computer. It signs right on the page.
  • ErgoPay on a phone: scan the QR code with an Ergo wallet app that supports ErgoPay, or tap “Open in Ergo wallet” on the phone itself, and sign in the app.
  • Watch an address to see its balances, orders and history without a wallet. Nothing can be signed that way.

Before the first connection ErgoDEX asks you to accept the Terms of Use and the Risk Notice.

What can’t ErgoPay sign?

ErgoPay signs what Nautilus signs: a swap through any route, a split route included, limit, stop and DCA orders, smart orders, liquidity, range positions and every cancel. Each is one QR code for the mobile wallet. What differs:

  • ErgoPay works with the one address your mobile wallet shares. Nautilus brings every address of the wallet, so orders and positions on its other addresses show only there.
  • Creating a pool takes three QR codes, one per transaction: the pool NFT, the LP token, then the pool box. Each comes once the one before reaches the network.

For Lithos it is the other way round. Nautilus cannot sign a swap that spends a Lithos pool, so ErgoDEX places a Lithos order instead, which an executor fills against the pool (its fee is on Fees). Cancelling such an order needs ErgoPay.

Market, Limit, DCA or a smart order?

  • Market swaps now, through the best route ErgoDEX finds, in one transaction. You get at least the minimum shown, or the swap fails and nothing leaves your wallet.
  • Limit places an order at your price. It waits on the chain until it can be filled at that price or better, until it expires or until you cancel it.
  • DCA buys or sells over time. One order holds the budget, and our executor fills it in parts, at most one part per interval, each through Smart Route and never past the price limit you set.
  • A smart order shows up beside a large ERG swap when splitting it across sources that cannot share a transaction pays more, after its fee. You sign once; our executor fills it, usually within a block or two, and pays you once.

How each of them is filled: How orders are routed and filled.

Why does a swap say “No route”?

Every swap on ErgoDEX is one transaction: through one source, or split across several so that it completes as a whole or not at all. When no single transaction can fill your swap, ErgoDEX says “No route” rather than build something that could leave you halfway.

  • The pair may have no pool or open order, or none that can take this amount.
  • Settings → Route may be set to One pool while no single pool can take the whole amount. The route card says so; Best may find a route.
  • Some tokens trade only through a third one. ErgoDEX does not chain two transactions for you: swap to the middle token first, then on.

What one transaction may combine: How a route is built.

What is the price-impact guard?

A large swap moves a pool’s price. On a market swap the Swap button reacts to the price impact the card shows:

  • below 10%, it signs as usual;
  • from 10% to 30%, it reads “Swap anyway”: the first press arms it, and a second press within 5 seconds signs;
  • above 30%, the swap is blocked until you turn on Settings → Allow high price impact, and then it takes two presses as well.

Limit orders and DCA plans have no such guard: you set their price yourself.

What does “Same ticker as …” mean?

Anyone can create a token with any ticker, and fake tokens copy the tickers of real ones. When several tokens share a ticker, ErgoDEX takes the one with the most ERG in its pools as the original and marks every other one with an amber sign; in the token pickers a line under its name reads “Same ticker as …” and names the original. When none leads, each of them is marked. ERG always leads its ticker. Tickers are compared the way people read them: upper or lower case, look-alike letters from other alphabets and invisible characters make no difference.

The mark is a warning, not a block. Check the token ID before you trade; on a computer the sign’s hint shows the first and last characters of the original’s ID.

What are V3 pools?

V3 pools are concentrated liquidity on Crux’s contracts. Each liquidity provider places liquidity in a price range of their choice and earns that range’s fee only while the price is inside it; outside it, the range holds just one of the two tokens. ErgoDEX shows all the ranges of a pair as one V3 pool, and Smart Route can fill a swap from several ranges in one transaction.

V3 runs on the Ergo mainnet with a pre-launch configuration of Crux: it holds real funds, and Crux can replace the configuration. The Risk Notice says what that means; the contract and the configuration’s NFT are on Contracts.

My order has not filled. What can I do?

  • An order fills only when the pools give at least your price, and our executor fills a part only when its fee covers the cost of the transaction. A limit far from the market, or a very small order or remainder, can wait a long time.
  • Cancel it whenever you like from Swap or Portfolio and sign the cancel in your wallet. The unsold part, everything bought so far and the unused executor fee come back.
  • An order with an expiry comes back to your address after it expires. What is left of a smart order comes back after 30 blocks.

Partial fills, cancelling and what happens when the site is down: How orders are routed and filled.

What is the network fee?

Every transaction pays a fee to Ergo miners: 0.002 ERG by default. You can change it in Settings → Miner fee, from 0.001 to 1 ERG. It goes to the miners, not to ErgoDEX.

ErgoDEX adds no fee of its own. Pool fees, the executor fee of orders and the rest are on Fees.

Where can I ask a question?

In the ErgoDEX Telegram group, t.me/ErgoDexio: questions, problems and ideas. The group is public, so never post your seed phrase or keys there or anywhere else. Nobody from ErgoDEX will ever ask for them. For anything private, write to hello@ergodex.io.

—Alerts