Struct MarginTierConfig 

pub struct MarginTierConfig {

    pub tier_id: u64,
    pub line: u64,
    pub leverage: u64,
    pub duration: u64,
    pub maintenance_bps: u64,
    pub open_buffer_bps: u64,
    pub liq_price_factor: u64,
    pub prolong_fee: [String; 4],
    pub max_credit_line_bps: u64,
    pub max_price_age: u64,
    pub open_fee: String,
    pub profit_share_bps: u64,
    pub price_band_bps: u64,
    pub daily_loss_limit_bps: Option<u64>,
    pub markets: Vec<String>,
    pub sidecar: bool,
    pub turbo: Option<MarginTurboConfig>,
    pub enabled: bool,
}

One tier of the margin catalogue. Mirrors the on-chain TierParams plus the tier id and the markets (order books) it covers. line follows the config convention of u64 amounts as strings.

Fields

tier_id: u64

line: u64

Credit line in collateral-asset base units, as a decimal string.

leverage: u64

duration: u64

Initial session term in seconds. Prepaid tiers require a positive value; u64::MAX means no expiration.

maintenance_bps: u64

open_buffer_bps: u64

liq_price_factor: u64

prolong_fee: [String; 4]

Historical paid-prolongation fees, in WHOLE collateral units as a decimal string - "13.5" at 9 decimals means 13_500_000_000 base units. Indexed six hours, day, week, month; a zero means the period is not offered. All four must be zero for an enabled prepaid tier; disabled catalogue entries may retain old fees.

max_credit_line_bps: u64

max_price_age: u64

open_fee: String

Flat fee charged once at open, in WHOLE collateral units as a decimal string. Same form as prolong_fee.

profit_share_bps: u64

Historical profit share; must be zero for an enabled prepaid tier.

price_band_bps: u64

daily_loss_limit_bps: Option<u64>

Backend daily loss limit in basis points of line (0..=10_000). Omitted or null disables the policy; zero is a real zero-loss limit. Reconciliation treats changes like immutable tier economics and publishes a new version, preserving policies on historical versions.

markets: Vec<String>

Markets in this tier, referencing already-configured pairs by “BASE/QUOTE” symbol or by hex market id.

sidecar: bool

Select each market’s deployed sidecar instead of its canonical book. Defaults to canonical; independent of the prepaid account terms.

turbo: Option<MarginTurboConfig>

The prepaid (“Turbo”) sidecar. Its PRESENCE is what makes the tier prepaid: the version is published with publish_tier_v3 and carries terms, and every reader keys the cohort off exactly that. Required for enabled tiers: entries without terms are rejected before any transactions, because the legacy publisher is disabled. Disabled entries only reconcile the sales gate and may retain legacy terms.

Immutable once published - no setter exists on chain - so a change here is a NEW VERSION, exactly like a change to the economics.

enabled: bool

Whether the tier SELLS. Gates open_session only: a live session keeps every lifecycle call it was sold with, which is what lets an old catalogue be retired without stranding anybody on it. Disabled entries never publish versions or update books; unpublished disabled tiers are skipped. Their historical economics are not validated.

Defaults to true, so an existing config keeps selling exactly what it sold before this field existed.

Trait Implementations

impl Clone for MarginTierConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MarginTierConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for MarginTierConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MarginTierConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.