Function: cancel(byte[32] asset, address account, CancelArgs args)

The cancel function allows an account or approved operator of an account to manually cancel previously submitted limit orders that are still active (not yet filled or expired).

Inputs

• asset

  • Control: Full control.

  • Constraints: Market should exist.

  • Impact: Determines from which asset market the orders are canceled.

• account

  • Control: Full control.

  • Constraints: Only the order owner (or authorized operator) can cancel the order.

  • Impact: Owner of the orders.

• args.orderIds

  • Control: Full control.

  • Constraints: Active orders.

  • Impact: Orders to be canceled.

• args.settlement

  • Control: Full control.

  • Constraints: ACCOUNT and INSTANT.

  • Impact: Settlement mode for the collateral refund.

Branches and code coverage

Intended branches

• reduceOnly order — no refund.

  Test coverage

• Successfully cancels all active limit orders.

  Test coverage

• INSTANT settlement.

  Test coverage

• ACCOUNT settlement.

  Test coverage

• Refunds correct margin.

  Test coverage

• No orders exist. No margin is refunded.

  Test coverage

• orderIds contains multiple valid orders and one invalid, and it is skipped.

  Test coverage

• orderIds contains duplicated orders, and they are all skipped, except the first one.

  Test coverage

• Cancels the last order in the book.

  Test coverage

Negative behavior

• The caller is not an owner or approved operator.

  Negative test