Stellar lending data types

This page summarizes the main on-chain types. Source definitions live in common/src/types.

HubAssetKey

HubAssetKey {
  hub_id: u32,
  asset: Address,
}

HubAssetKey is the market coordinate used by controller flows, pool storage, keeper config, views, events, and strategy inputs.

Account

Account {
  owner: Address,
  spoke_id: u32,
  mode: PositionMode,
  supply_positions: Map<HubAssetKey, AccountPositionRaw>,
  borrow_positions: Map<HubAssetKey, DebtPositionRaw>,
}

Accounts bind to a spoke id >= 1.

PositionMode

Variant	Meaning
`Normal`	Standard supply and borrow.
`Multiply`	Leveraged collateral/debt loop.
`Long`	Directional long strategy.
`Short`	Directional short strategy.

AccountPositionRaw

Field	Meaning
`scaled_amount_ray`	RAY-scaled supply shares.
`liquidation_threshold_bps`	Snapshot threshold used by health factor.
`liquidation_bonus_bps`	Snapshot liquidation bonus.
`loan_to_value_bps`	Snapshot LTV.

DebtPositionRaw

Field	Meaning
`scaled_amount_ray`	RAY-scaled debt shares.

SpokeAssetConfig

Field	Meaning
`is_collateralizable`	Whether supply counts as collateral.
`is_borrowable`	Whether accounts can borrow it.
`paused`	Blocks risk-increasing use.
`frozen`	Blocks new supply/borrow while allowing exits.
`loan_to_value`	LTV in BPS.
`liquidation_threshold`	Health-factor collateral weight in BPS.
`liquidation_bonus`	Liquidator bonus in BPS.
`liquidation_fees`	Protocol fee in BPS.
`supply_cap`	Spoke supply cap in token units.
`borrow_cap`	Spoke borrow cap in token units.
`oracle_override`	Optional per-spoke oracle config.

MarketParamsRaw

Field	Meaning
`base_borrow_rate_ray`	Borrow rate at zero utilization.
`slope1_ray`	Slope below first kink.
`slope2_ray`	Slope between first and optimal utilization.
`slope3_ray`	Slope above optimal utilization.
`max_borrow_rate_ray`	Borrow-rate cap.
`mid_utilization_ray`	First utilization kink.
`optimal_utilization_ray`	Target utilization.
`max_utilization_ray`	Hard utilization cap.
`reserve_factor_bps`	Protocol share of borrower interest.
`supply_cap`	Hub supply cap.
`borrow_cap`	Hub borrow cap.
`is_flashloanable`	Flash-loan eligibility.
`flashloan_fee`	Flash-loan fee in BPS.
`asset_id`	Token address.
`asset_decimals`	Token decimals.

Oracle Types

Oracle config is token-rooted under AssetOracle(asset) and can be overridden per spoke asset. It supports Reflector and RedStone sources, primary/anchor composition, tolerance bands, staleness bounds, resolution, decimals, and sanity bounds.

​HubAssetKey

​Account

​PositionMode

​AccountPositionRaw

​DebtPositionRaw

​SpokeAssetConfig

​MarketParamsRaw

​Oracle Types