Order types: maker vault
What it does
Section titled “What it does”A maker vault holds your inventory of both of a market’s assets. Settlers fill other people’s orders from it, in the same transaction as the pool, at prices your bot signs. What the vault receives on one side funds the other side, and everything stays in the vault until you withdraw.
It uses two keys:
| Key | Where it lives | What it can do |
|---|---|---|
| Withdraw key | Your wallet | Create, top up and withdraw the vault. Never give it to a bot. |
| Quote key | Your bot’s server | Sign prices. It can’t move funds. |
The app only ever takes the quote key’s public half. Any fill, top-up or withdrawal makes a new vault box, and that cancels every price your bot had signed for the old one.
The full guide for makers is kadia-dex’s “Running a maker vault and its quote bot”.
When to use it
Section titled “When to use it”- You make markets, and you want to quote your own prices next to the pool without leaving your liquidity in it.
- You run a bot that can re-sign prices as the market moves.
What you pay
Section titled “What you pay”- The execution fee each price names, paid to the settler out of the vault’s ERG. Your vault sets the most any one price may pay.
- The miner fee for creating, topping up and withdrawing.
What can go wrong
Section titled “What can go wrong”- A leaked quote key can only sell within your vault’s own price guard: no further than
maxDevBpsfrom the block’s opening price (1% by default, 3% at most). It can’t withdraw. - A stale price can still be hit if the market moves before your bot re-signs. Keep your prices’ expiries short (the service takes at most about a day ahead).
- Settlers use your vault only when it helps the batch, so a signed price isn’t a promise of fills.
- Storage rent: an idle vault left for about 4 years can be charged rent. Any fill or top-up resets that clock, and the app warns from about 3 years.
Getting your funds back
Section titled “Getting your funds back”Withdraw with your withdraw key at any time. Every vault also shows “Withdraw without the service”, built from the chain alone, so you never need Kadia’s service to get your funds back. It needs a browser wallet. With ErgoPay, use Withdraw.
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).