Cancel Order
Order cancellation
In Carina, order cancellation allows users to invalidate an existing order before it is executed. Once cancelled, the order is no longer eligible for matching or execution by solvers. This mechanism gives users control to withdraw unexecuted orders in response to changing market conditions or updated preferences.
Types of Cancel
In Carina, there are two types of order cancellation: on-chain and off-chain. The following sections explain how each works.
What's on-chain cancellation?
On-chain cancellation is performed by submitting a transaction that marks an order as cancelled in the protocol’s smart contracts. Once confirmed on-chain, the order is no longer executable by any solver, even if it was previously broadcast or included in a batch.
How It Works:
The user submits an on-chain transaction to cancel the intent.
This transaction marks the order as cancelled and invalidates its signature.
Any subsequent attempt to execute the intent will be rejected when checked by solvers or smart contracts.
Characteristics:
Requires an on-chain transaction and gas fees
Guarantees that the intent can no longer be executed
Necessary when an intent has already been signed and broadcast
What's off-chain cancellation?
Off-chain cancellation allows a user to invalidate an order without submitting an on-chain transaction. By updating the order status off-chain, the intent is removed from active consideration by Carina’s systems and solvers. Off-chain cancellation is effective as long as the order has not yet been executed on-chain.
How It Works:
The user requests cancellation off-chain without submitting a transaction.
The intent is marked as cancelled in Carina’s off-chain systems and removed from active batches.
Solvers will no longer consider the intent for execution unless it has already been submitted on-chain.
Characteristics:
Does not require an on-chain transaction or gas fees
Prevents execution as long as the intent has not yet been submitted on-chain
Suitable for quickly withdrawing intents that are still pending or unexecuted
Too late to cancel
In some cases, your intent may already be in the process of being executed. When this happens, off-chain cancellation is no longer possible.
Last updated