Skip to content

Order types: maker vault

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”.

  • 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.
  • 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.
  • A leaked quote key can only sell within your vault’s own price guard: no further than maxDevBps from 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.

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).