How it works
You hold ETH or USDC. A maker holds XMR. The swap contract and a shared Monero key make sure that either both of you are paid or both of you get your coins back.
A swap, step by step
- Quotes. The wallet asks every active maker in the on-chain registry for a quote over
.sesh, skips makers whose cap is below your amount, and picks the one that gives the most XMR. The quote screen lists every maker asked and why each was or wasn't used. - Fair-price check. The wallet compares each quote with an XMR/USD price feed. It skips registry quotes more than 5% worse than the feed and warns you if the quote you're looking at is that far off. On Arbitrum Sepolia there is no official XMR/USD feed, so a test feed is used and the quote screen says so.
- You lock. You lock your ETH or USDC in the swap contract. The lock records every term of the trade, including both halves of the Monero key that will hold the XMR.
- The maker locks XMR to an address that needs both key halves to spend, and posts a signed note saying it did.
- Confirmations. Your wallet waits until the XMR has at least 10 confirmations (more for larger swaps), then marks the swap ready.
- The maker claims. It first posts a notice that it intends to claim, then claims your coins. Claiming publishes its key half, so your wallet now holds the whole Monero key and sweeps the XMR to itself.
A small swap is done in about 25 minutes, and the XMR is spendable in your wallet about 20 minutes later. Monero block times vary, so it can take longer.
Refunds and timing
Every move that reveals a key half happens in two steps: a notice first, then the reveal. While one side's notice is open, the other side can't act, so at any moment only one person can move. That way a late reveal doesn't cost anyone their coins.
- If the maker never locks XMR, your wallet refunds you, at the latest about 2 hours 45 minutes after your lock.
- A claim notice stays open for 6 hours, or until the maker's claim deadline if that is later. If the maker hasn't claimed when it closes, you can refund right away.
- Until your wallet marks the swap ready, you can cancel and take your coins back. If the swap included a small premium and you cancel after the maker has said its XMR is locked, the premium goes to the maker. Otherwise it comes back to you.
The maker doesn't need ETH to claim. It signs the claim and a relayer sends it for a fee taken from the swap. The signature fixes where the money goes.
The contracts
All on Arbitrum Sepolia. The four SeshSwap contracts have no owner, admin key, upgrade path or fee. The mock USDC and the test price feed are test tools: their deployer can mint tokens and set the price.
| Contract | What it does | Address |
|---|---|---|
| XmrSwapV3 | Holds your ETH or USDC during a swap and pays it out to the maker or back to you. It checks the Monero key halves directly on-chain. | 0x1F3e5b5d9C7bE3a95535Bac1e68864B1d10A46F4 |
| SeshRegistry | The public list of makers and other .sesh services. Every listing posts an ETH bond. A maker can quote up to 5 times its bond and loses part of its bond to you if it doesn't confirm its XMR lock in time. | 0xc3576aefa11cef4e7758dacfa9e58560eca148d8 |
| ExitLease | Sells hours on an exit listed in the registry. The payment goes straight to the seller in the same transaction. | 0x145049b20f382Ca9D0B281a986dc02DEb653e65c |
| ExitPay | Lets an XMR seller have a swap's proceeds buy exit hours in one step. Each payment goes to its own address, which can only buy that one lease or send everything back. | 0xE622AF84dcC1f976f14E143287e68587CC8F24A6 |
| Mock USDC | The test token used for USDC swaps. Not real USDC. | 0x91280FA5450d481569C5fEBFdeF4E794C00cBCfa |
| XMR/USD test feed | The price feed for the fair-price check on this testnet. | 0xaeF4c8ae583e245323e3C72dea975B0d81FEBc8b |
What you do and don't trust
You don't have to trust
- The maker with your coins. The contract only pays it once it publishes the key half that gives you the XMR.
- Relayers. They can't change where a claim pays out or take more than the agreed fee.
- The connection. Only the setup messages travel over
.sesh. After you lock, everything is read from the two chains, so a dropped connection can't lose funds.
Limits to know about
- Nothing here is audited. Use test coins only.
- Ethereum can't see Monero. A maker's note that it locked XMR is its own word. If it lies, you lose time, not funds: the swap still refunds you.
- The Ethereum side is public: your address, amount and timing are visible on-chain.
- A Monero reorg deeper than the confirmations the wallet waits for, or a reorg by the Arbitrum sequencer, could still break a swap.
- On this testnet the XMR/USD price feed is a test feed, not an independent one.
Exit Markets
Session Router can also work as an onion-routed exit. With Exit Markets, the wallet can buy exit time by the hour from sellers listed on-chain and send your web traffic out through them.
- Buy hours. Pick an exit and the hours, and pay in testnet USDC or ETH through ExitLease. Paid hours are final and are not refunded if the exit goes down. Five minutes before your time ends, the wallet offers to add an hour.
- Connect. The wallet moves this computer's default route into the tunnel. The exit carries web traffic (ports 80 and 443) and its own DNS; anything else is dropped until you disconnect. Connecting works on Linux for now.
- Disconnect when you're done, or when your time runs out. The wallet also disconnects when you lock or close it.
Three connection states
- Waiting for this computer's routes. The exit is set up; the wallet is waiting for the routes to be installed.
- Connected. The routes are up. Only now does the wallet point your DNS at the exit's resolver, and it puts your DNS back when you disconnect, even after a crash.
- Not connected: routes aren't up. The exit is set up but your routes didn't come up or went down. DNS stays unchanged and you can retry.
An exit is not a privacy VPN: it sees which sites you connect to. Ethereum can't see whether an exit lets you in after you pay, so for that you rely on the seller's registry listing and reputation.
In a later release the exit and the wallet will be split into two programs, so the part that handles routes and DNS won't have access to the wallet's keys.