Skip to content

Order types: firm offer (firm vault)

A firm offer (a firm vault) is the no-bot version of a maker vault. You fix one set of terms when you create it: the price, the most per fill, and an expiry. Any settler can fill from it using the chain alone, as often as it likes, until the offered inventory runs out or the terms expire.

  • The terms are public and can’t change.
  • There’s no price guard: a firm price stays firm even if the market moves.
  • The funds are locked until a height you choose (lockUntil), which must come after the terms expire. The lock is at most 10,080 blocks (about 14 days), the length of an upgrade notice.
  • To offer a fixed price for a short time without running a bot.
  • For a one-off trade at terms you set.
  • The execution fee named in your terms, paid to the settler out of the vault’s ERG.
  • The miner fee for creating and withdrawing.
  • The market can move against your price. That’s what “firm” means: keep the expiry short.
  • You can’t cancel or top it up early. Your withdraw key works only from the block after the lock ends.
  • A pause or an upgrade can stop fills, but no lock outlasts an upgrade notice, so your funds are back in reach by then.
  • Storage rent: a firm vault left unwithdrawn for about 4 years can be charged rent (about 2.1 ERG).

Withdraw with your withdraw key once the lock has ended. The app says when Withdraw opens.

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