Qlyphs Docs

When things fail

Your QTC and your tokens live in two ledgers with two rulebooks. Here is what each one does when something goes wrong.

The question

When something goes wrong, what happens to your QTC, and what happens to your tokens?

Quantus executes QTC transfers. QLYP interprets token operations. When something goes wrong, those two ledgers can give two different answers, and knowing which is which is what keeps you from paying twice or waiting for a refund that will never come.

Pick a case

Your QTC · Unchanged

The whole batch reverts: approval and both transfers are undone. Only the network fee is spent.

Your tokens · Unchanged

No delivery. The reservation stays live, ready for a valid purchase.

Atomicity protects the approval and the two payments together.

Three words, three meanings

Your wallet never folds these into a single "failed":

  • Transaction failed. Quantus rejected or reverted it. In an atomic purchase, the approval and both payments were undone together; only the network fee is spent.
  • Operation rejected. The transaction went through, but QLYP did not accept the message. No token moved. A fee paid in that same transaction stays paid.
  • Outcome unknown. The network did not answer. The transaction may already be in a block. Your wallet keeps its hash; look it up instead of signing again.

Expiry and cleanup

An offer's expiry height is inclusive. Its reservation is released at the first block strictly after that height, the same point at which the native approval stops accepting it. A lot that was already sold or released cannot be released a second time.

On this page