Borrow assets

Borrow from a hub-asset market against collateral on the same account’s spoke. Borrowing lets you:

Open scaled debt that accrues borrow interest
Receive tokens to to or the caller
Stay solvent under LTV and health-factor gates

Post-borrow health factor must stay at or above 1 WAD. Every priced asset on the account must resolve a valid price, or the call reverts.

Borrowing

Open or select an account with eligible collateral
Choose borrowable HubAssetKey listings on that spoke
Size the borrow under caps, liquidity, and HF
Call borrow

Call shape

borrow(
  caller: Address,
  account_id: u64,
  borrows: Vec<(HubAssetKey, i128)>,
  to: Option<Address>,
)

stellar contract invoke \
  --id <CONTROLLER> \
  --source-account <CALLER> \
  --network testnet \
  -- borrow \
  --caller <CALLER> \
  --account_id 42 \
  --borrows '[[{"hub_id":1,"asset":"<USDC>"}, "1000000000"]]' \
  --to null

to only changes where the tokens land. The debt is always booked to account_id, whoever receives the funds.

Preconditions

caller holds the account’s position NFT, or is an active delegate on it. (A delegate must be an address governance already approved as a position manager — it is not a separate authority level.)
The spoke lists the asset and marks it borrowable, and the listing is not blocking entry.
The spoke’s borrow cap, the market’s cash, and its max-utilization ceiling all leave headroom.
After the borrow: the LTV gate holds, health factor stays at or above 1e18, and LTV-weighted collateral stays above the minimum-borrow floor.
Every priced asset on the account resolves a valid price. A stale or disagreeing feed reverts the whole call.

Common errors

Error	Cause	Fix
`#107 AssetNotBorrowable`	The spoke listing does not allow borrowing this asset.	Borrow an allowed asset.
`#100 InsufficientCollateral`	The LTV gate or health factor fails after the borrow.	Borrow less, or add collateral.
`#126 MinBorrowCollateralNotMet`	LTV-weighted collateral is below the floor (about `$5`) while debt remains.	Add collateral, or repay in full.
`#312 SpokeBorrowCapReached`	The spoke’s borrow cap is full.	Borrow less, or wait for headroom.
`#112 InsufficientLiquidity`	The market’s cash is below what you asked for.	Borrow less, or wait for repayments.
`#127 UtilizationAboveMax`	The borrow would push utilization past the market’s ceiling.	Borrow less, or wait for more supply.
`#47 BorrowRoundsToZeroShares`	The amount is too small to mint one scaled debt share.	Borrow more.
`#44 NotAuthorized`	Caller is neither the NFT holder nor an active delegate.	Call as the owner, or get a delegate grant.
`#310 SpokeMismatch`	The asset is not on the account’s spoke.	Borrow from the account’s own spoke.
`#205` / `#206`	An asset’s price is unusable — stale, or two sources disagree.	Retry once the feed recovers.

Caps are set per spoke, not per market. The same market can have different borrow headroom depending on which spoke your account sits on.

Overview

Liquidity model

User positions

More

Borrowing

Call shape

Preconditions

Common errors

​Borrowing

​Call shape

​Preconditions

​Common errors

Borrowing

Call shape

Preconditions

Common errors