Order types: refund and cancel
An order’s funds come back to you in one of two ways: a cancel with your own key, or a refund after it expires. Neither reads the market, so no pause, upgrade announcement or wind-down can block them. Every order can be refunded; for routes, see the note under Cancel.
Cancel: any time, with your key
Section titled “Cancel: any time, with your key”- Who: only you, with the key that created the order.
- When: any time before it’s fully filled.
- Routes: in the app, Cancel appears for a route only once the DEX service supports cancelling routes; until then, My orders says so, and the refund after expiry is the way back.
- What comes back: everything in the order box, including any proceeds a DCA or grid has kept.
- What it costs: the miner fee only.
- After a partial fill, cancel the new box that holds the rest (see partial fills).
Refund: after expiry, by anyone
Section titled “Refund: after expiry, by anyone”- Who: anyone may build the refund. Kadia’s keeper does it in practice, so you don’t have to sign anything.
- When: once the order has expired unfilled.
- What comes back: your tokens exactly as they were, and your ERG less at most your execution-fee cap. Kadia’s keeper charges only what the refund costs and gives the rest back.
- Another refunder may keep up to your cap. That’s why the cap is there: it pays for refunds even if Kadia’s keeper stops.
Vaults are different
Section titled “Vaults are different”- Maker vault: withdraw with your withdraw key at any time. Every vault also shows “Withdraw without the service” (it needs a browser wallet; with ErgoPay, use Withdraw).
- Firm offer: no cancel before the lock ends; withdraw from the block after it.
After an upgrade
Section titled “After an upgrade”If the market’s contracts are upgraded, orders made for the old ones can’t be filled any more. Cancel them, or wait for the refund, and place them again. See if something goes wrong.
Technical details
Sources: kadia-dex docs/guide/how-it-works.md, docs/guide/fees.md, docs/guide/maker-vault-bots.md and the order-type decisions in docs/decisions/ at commit 7ce1595 (7ce159587dc8c0bd78d6a5fbe0f7f8e7dde3920e).