Struct DebtInstrument 

pub struct DebtInstrument {

    pub id: String,
    pub entity_id: String,
    pub instrument_type: DebtType,
    pub lender: String,
    pub principal: Decimal,
    pub currency: String,
    pub interest_rate: Decimal,
    pub rate_type: InterestRateType,
    pub origination_date: NaiveDate,
    pub maturity_date: NaiveDate,
    pub amortization_schedule: Vec<AmortizationPayment>,
    pub covenants: Vec<DebtCovenant>,
    pub drawn_amount: Decimal,
    pub facility_limit: Decimal,
}

A debt instrument (loan, bond, credit facility).

Fields

id: String

Unique instrument identifier

entity_id: String

Legal entity borrower

instrument_type: DebtType

Type of debt instrument

lender: String

Lender / creditor name

principal: Decimal

Original principal amount

currency: String

Denomination currency

interest_rate: Decimal

Interest rate (annual, as decimal fraction)

rate_type: InterestRateType

Fixed or variable rate

origination_date: NaiveDate

Date the instrument was originated

maturity_date: NaiveDate

Contractual maturity date

amortization_schedule: Vec<AmortizationPayment>

Amortization schedule (empty for bullet / revolving)

covenants: Vec<DebtCovenant>

Associated financial covenants

drawn_amount: Decimal

Current drawn amount (for revolving facilities)

facility_limit: Decimal

Committed facility limit (for revolving facilities)

Implementations

impl DebtInstrument

pub fn new( id: impl Into<String>, entity_id: impl Into<String>, instrument_type: DebtType, lender: impl Into<String>, principal: Decimal, currency: impl Into<String>, interest_rate: Decimal, rate_type: InterestRateType, origination_date: NaiveDate, maturity_date: NaiveDate, ) -> Self

Creates a new debt instrument.

pub fn with_amortization_schedule( self, schedule: Vec<AmortizationPayment>, ) -> Self

Sets the amortization schedule.

pub fn with_covenant(self, covenant: DebtCovenant) -> Self

Adds a covenant.

pub fn with_drawn_amount(self, amount: Decimal) -> Self

Sets the drawn amount (for revolving facilities).

pub fn with_facility_limit(self, limit: Decimal) -> Self

Sets the facility limit (for revolving facilities).

pub fn total_principal_payments(&self) -> Decimal

Returns the total principal payments across the amortization schedule.

pub fn total_interest_payments(&self) -> Decimal

Returns the total interest payments across the amortization schedule.

pub fn available_capacity(&self) -> Decimal

Returns available capacity on a revolving credit facility.

pub fn all_covenants_compliant(&self) -> bool

Returns true if all covenants are compliant.

Trait Implementations

impl Clone for DebtInstrument

fn clone(&self) -> DebtInstrument

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DebtInstrument

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DebtInstrument

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DebtInstrument

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

where __S: Serializer,

Serialize this value into the given Serde serializer.