Enum OrderLifetime 

pub enum OrderLifetime {
    ShortTerm,
    LongTerm,
    Conditional,
}

Order lifetime type determined by time_in_force and expire_time.

dYdX v4 has different execution paths for orders based on their expected lifetime:

• ShortTerm: Lower latency/fees, expire by block height (max 20 blocks ~30s)
• LongTerm: Stored on-chain, expire by timestamp, explicit cancel events
• Conditional: Triggered by price conditions, always stored on-chain

Variants

ShortTerm

Short-term orders expire by block height (max 20 blocks). Lower latency and fees, but expire silently without cancel events. Used for IOC, FOK, or orders expiring within 60 seconds.

LongTerm

Long-term orders expire by timestamp. Stored on-chain with explicit cancel events when they expire or are cancelled. Used for GTC, GTD orders with expiry > 60 seconds.

Conditional

Conditional orders triggered by price conditions. Always stored on-chain (stateful), used for stop-loss and take-profit orders.

Implementations

impl OrderLifetime

pub fn from_time_in_force( time_in_force: TimeInForce, expire_time: Option<i64>, is_conditional: bool, max_short_term_secs: f64, ) -> Self

Determines order lifetime based on time_in_force, expire_time, and max short-term duration.

The max_short_term_secs is computed dynamically from BlockTimeMonitor: max_short_term_secs = SHORT_TERM_ORDER_MAXIMUM_LIFETIME (20 blocks) × seconds_per_block

Returns ShortTerm when:

• TimeInForce is IOC or FOK (immediate execution orders)
• expire_time is set and within max_short_term_secs from now

Returns LongTerm for GTC/GTD orders with expiry beyond short-term window. Returns Conditional for stop/take-profit orders (when is_conditional is true).

pub const fn order_flags(&self) -> u32

Returns the dYdX order_flags value for this lifetime.

These flags are used in both MsgPlaceOrder and MsgCancelOrder to identify the order type on-chain.

pub const fn is_short_term(&self) -> bool

Returns true if this is a short-term order.

pub const fn is_conditional(&self) -> bool

Returns true if this is a conditional order (stop/take-profit).

Trait Implementations

impl Clone for OrderLifetime

fn clone(&self) -> OrderLifetime

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OrderLifetime

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for OrderLifetime

fn eq(&self, other: &OrderLifetime) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for OrderLifetime

impl Eq for OrderLifetime

impl StructuralPartialEq for OrderLifetime