Message: CreateDecreasePerpOrder

This operation allows to add a market order to decrease a perpetual position. The message is rejected if the pool is in the stopped state.

The message must carry sufficient TON to cover for the minimum perpMinExecutionFee plus the createPerpOrderGas gas-cost parameters configured in the contract.

The order is assigned a unique incremental ID and inserted into the perpOrders map, ready to be executed.

Finally, an event signalling the order to off-chain observers is emitted, the totalExecutionFee amount of total fees collected to be paid to executors is increased, and any excess TON is returned to the message sender.

Inputs

The incoming message has the following structure:

• executionFee

  • Validation: Must be sufficiently large to cover the minimum execution fee.

  • Impact: The fee to be paid to the executor for executing the order.

• tokenId

  • Validation: None.

  • Impact: Specifies the token for which the order is being created.

• isLong

  • Validation: None.

  • Impact: Indicates whether the order is for a long or short position.

• marginDelta

  • Validation: None (validation performed when the order is executed).

  • Impact: Specifies the amount the position margin is to be decreased by.

• sizeDelta

  • Validation: None (validation performed when the order is executed).

  • Impact: Specifies the amount the position size is to be decreased by.

• triggerPrice

  • Validation: None.

  • Impact: Allows to specify a trigger condition for the order, which becomes executable only if the price crosses this threshold (above for long positions, below for short).

• trxId

  • Validation: None.

  • Impact: Not used by the on-chain contract.

• requestTime

  • Validation: None.

  • Impact: Not used by the on-chain contract.

Test coverage

Intended branches

Negative behavior