Monzero DEX · self-custody

Recover your swap from zero.

A Monzero atomic swap is non-custodial: no one — not Monzero, not the trader on the other side — can move your coins. That also means recovery is in your hands. This guide covers every market on the DEX today — XMZ against ETH, BNB, SOL and USDT (on Solana and on BNB Chain) — from the everyday fixes to the rare worst case.

Read first

A swap is short-lived: once coins are locked it completes or refunds within about four hours (section 6). The wallet does every protective step by itself — claims, refunds and sweeps never wait for a click. Your only job is to keep the wallet able to come back: back up its trading data and password (section 1), and reopen it if it closes mid-trade.

1Back up your trading data

Trading uses a separate set of trading keys, made when you first chose a trading password. They control your trade account (where ETH, BNB, SOL or USDT is paid in and paid out) and the small in-app XMZ trading wallet. Each trade's own keys are derived from them, and each trade keeps a journal of where it is.

WalletWhat to keep safe
Linux desktopThe folder ~/.local/share/monzero-project/monzero-core/dex/ and your trading password
Windows desktop (beta)The folder %APPDATA%\monzero-project\monzero-core\dex\ and your trading password
AndroidThe twelve trading recovery words the app showed when it made your trading keys, and your trading password. Keep the phone's wallet app installed while a trade runs: its trade journals live inside the app.

On the desktop the trading keys are stored encrypted inside that folder — nobody can restore the password, and there is no separate word list, so the folder plus the password is the backup. Inside it, trading-keys/ holds the keys, evm-trades/ one folder per offer or trade (each running trade has a journal.json), and xmz-wallet/ the trading XMZ wallet. Copy the whole dex folder (with the wallet closed) to somewhere private (an encrypted USB stick, for example), and do it again while a trade is running. Treat it like a seed backup.

2The quick fix: reopen the wallet

If the wallet closed, crashed, or lost power mid-swap, just open it again and unlock trading with your password. It resumes every unfinished trade from its journal, reads both chains, and takes the right path by itself: claim, refund, or sweep the XMZ.

Leave the wallet running until the trade says swapped or refunded. If you are the XMZ seller, it must be online at some point before the claim deadline (section 6) to collect your coin — and even if it misses that, your XMZ comes back (section 8).

3Coin left in your trade account

ETH, BNB, SOL and USDT go through your wallet's own trade account — paid in before a trade, paid out after it. When a trade started from the web page finishes, the wallet sends the account's coin back to the MetaMask or Phantom account you connected, by itself. Coin can still be left there — an offer you cancelled, one nobody took, a take the maker refused, or proceeds from a trade made in the desktop Exchange. To move it:

If Withdraw refuses

The wallet will not empty a trade account that something still needs. It says why: "an offer of yours is still open: cancel it first" or "a trade is still running". Cancel your open offers on that coin (section 4), or let the running trade finish or refund, then withdraw again. SOL and USDT on Solana share one trade account, so an open offer on either market holds both.

4An order or take that won't go away

Nothing is locked on any chain until you approve a trade in the wallet. Before that, an offer or a take is only a message, and can always be dropped:

5Lost the device, kept the data

  1. Desktop: install the Monzero wallet on any computer, put your backed-up dex folder back in the location from section 1 (with the wallet closed), open the wallet and unlock trading with the same password. If it says your trading keys were set up by another copy of the wallet, accept the switch. Unfinished trades resume from their journals.
  2. Android: your twelve trading recovery words open the trade account in MetaMask or any Ethereum wallet: it is the standard account m/44'/60'/0'/0/0 of those words, so ETH, BNB and USDT on BNB Chain left in it are yours to move. Restoring the words into a new phone's wallet app is not available yet; if the lost phone had a trade running, or SOL or USDT on Solana in its trade account, email us (section 7).

Nothing secret ever left your device, so a fresh install plus your backup is a complete recovery. A trade can only be rebuilt with the same keys it started with; a different backup is refused rather than producing a different trade.

6Timeout reference

Every trade has two deadlines, set on chain when the buyer of XMZ locks their coin in the swap contract (the Solana program on Solana) — timeout 1 two hours after the lock, timeout 2 two hours after that. The same rules apply on Ethereum, BNB Chain and Solana, for the native coin and for USDT:

WhenWhoWhat happens
Right after agreeingbuyer of XMZlocks ETH/BNB/SOL/USDT in the contract (the seller waits about 30 min, 1 h on Ethereum, then gives up — nothing lost)
Before timeout 1seller of XMZlocks the XMZ in a key shared by both sides
Before timeout 1buyerconfirms the XMZ lock (ready) — or, if no correct XMZ arrived, takes the coin straight back (early refund)
From ready (or timeout 1) until timeout 2sellerclaims the coin; the claim reveals what the buyer needs, and the buyer's wallet sweeps the XMZ
From timeout 2buyerif the seller never claimed: refunds the coin; the refund reveals what the seller needs, and the seller's wallet sweeps the XMZ back

So a trade is settled within about four hours of the lock, either way. The wallet keeps safety margins: it never claims in the last 30 minutes before timeout 2, and never confirms ready late.

7No Monzero app at all (advanced)

Even without Monzero software, the outcome is recoverable, because the contracts and the trade format are open source (Monzero-source, under gui/dex-contracts):

Honest limitation

This last-resort path is real but not a one-click, non-technical procedure. If you are ever in this situation, email security@monzero.org and we will walk you through it. We can help you recover your funds; we cannot take them — there is no key on our side that can.

8What can and can't happen to your funds

Questions, or stuck mid-swap? security@monzero.org, or the Monzero Telegram. The source for everything above is open: Monzero-source.