CollateralFactor

The LetterOfCredit contract’s per-pair risk configuration for one (collateral token, credited token) pair. All values are basis points (10_000 = 100%). A collateral factor is credited value divided by collateral value, so lower means more collateral per unit credited.

Remarks

This is V3’s live risk configuration. Health and liquidation fee math read the current values for the pair, so a configuration change applies to open dynamic LOCs immediately. The V3 contract’s per-LOC storage fields are legacy. Read this configuration separately with getCollateralFactor; neither canonical nor outstanding LOC models embed mutable current terms.

Properties

collateralFactorBasisPoints

collateralFactorBasisPoints: bigint;

Liquidation threshold. Once a LOC’s current collateral factor reaches this value it is unhealthy and anyone may convert its collateral; compare with calculateRiskFactorBasisPoints.

---

creationCollateralFactorBasisPoints

creationCollateralFactorBasisPoints: bigint;

Highest collateral factor a dynamic LOC may have when it is created or when collateral is removed. 8_000 means the credited value may be at most 80% of the collateral’s value; 0 means the pair is disabled for new LOCs.

---

liquidatorIncentiveBasisPoints

liquidatorIncentiveBasisPoints: bigint;

Extra collateral, as a share of the collateral converted, paid to whoever liquidates an unhealthy LOC.

---

redeemBufferBasisPoints?

optional redeemBufferBasisPoints?: bigint;

Fee charged when a healthy LOC is redeemed, as a share of the collateral converted. It is undefined only when a profile is still bound to a pre-V3 ABI during an environment’s upgrade window — the field is absent from that ABI’s getCollateralFactor return tuple, not zero.