1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
// Copyright 2023 Centrifuge Foundation (centrifuge.io).
// This file is part of Centrifuge chain project.

// Centrifuge is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version (see http://www.gnu.org/licenses).

// Centrifuge is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.

use cfg_primitives::SECONDS_PER_YEAR;
use cfg_traits::{interest::InterestRate, Seconds};
use frame_support::{
	pallet_prelude::RuntimeDebug,
	traits::tokens::{self},
};
use parity_scale_codec::{Decode, Encode, MaxEncodedLen};
use scale_info::TypeInfo;
use sp_arithmetic::traits::checked_pow;
use sp_runtime::{
	traits::{EnsureDiv, EnsureFixedPointNumber, EnsureInto, EnsureMul, EnsureSub, One},
	ArithmeticError, FixedPointNumber, FixedPointOperand,
};

/// Discounted cash flow values
#[derive(Encode, Decode, Clone, PartialEq, Eq, TypeInfo, RuntimeDebug, MaxEncodedLen)]
pub struct DiscountedCashFlow<Rate> {
	/// The probability of a borrower defaulting a loan repayments.
	pub probability_of_default: Rate,

	/// The share of an asset that is lost if a borrower defaults.
	pub loss_given_default: Rate,

	/// Rate of return used to discount future cash flows back to their
	/// present value.
	pub discount_rate: InterestRate<Rate>,
}

impl<Rate: FixedPointNumber> DiscountedCashFlow<Rate> {
	pub fn new(
		probability_of_default: Rate,
		loss_given_default: Rate,
		discount_rate: InterestRate<Rate>,
	) -> Result<Self, ArithmeticError> {
		Ok(Self {
			probability_of_default,
			loss_given_default,
			discount_rate,
		})
	}

	pub fn compute_present_value<Balance: tokens::Balance + FixedPointOperand>(
		&self,
		debt: Balance,
		when: Seconds,
		interest_rate: &InterestRate<Rate>,
		maturity_date: Seconds,
		origination_date: Seconds,
	) -> Result<Balance, ArithmeticError> {
		// If the loan is overdue, there are no future cash flows to discount,
		// hence we use the outstanding debt as the value.
		if when > maturity_date {
			return Ok(debt);
		}

		// Calculate the expected loss over the term of the loan
		let tel = Rate::saturating_from_rational(
			maturity_date.ensure_sub(origination_date)?,
			SECONDS_PER_YEAR,
		)
		.ensure_mul(self.probability_of_default)?
		.ensure_mul(self.loss_given_default)?
		.min(One::one());

		let tel_inv = Rate::one().ensure_sub(tel)?;

		// Calculate the risk-adjusted expected cash flows
		let exp = maturity_date.ensure_sub(when)?.ensure_into()?;

		// TODO: Simplify this once #1231 is merged allowing to extract only the
		// acc_rate from InterestAccrual
		let interest_rate_per_sec = interest_rate.per_sec()?;
		let acc_rate = checked_pow(interest_rate_per_sec, exp).ok_or(ArithmeticError::Overflow)?;
		let ecf = acc_rate.ensure_mul_int(debt)?;
		let ra_ecf = tel_inv.ensure_mul_int(ecf)?;

		// Discount the risk-adjusted expected cash flows

		// TODO: use InterestAccrual for this once #1231 is merged
		// This would immply that discount_rate should be register/unregister.
		let discount_rate_per_sec = self.discount_rate.per_sec()?;
		let rate = checked_pow(discount_rate_per_sec, exp).ok_or(ArithmeticError::Overflow)?;
		let d = Rate::one().ensure_div(rate)?;

		d.ensure_mul_int(ra_ecf)
	}
}

/// Defines the valuation method of a loan
#[derive(Encode, Decode, Clone, PartialEq, Eq, TypeInfo, RuntimeDebug, MaxEncodedLen)]
pub enum ValuationMethod<Rate> {
	/// Dicounted cash flow valuation
	DiscountedCashFlow(DiscountedCashFlow<Rate>),
	/// Outstanding debt valuation
	OutstandingDebt,
	/// Equal to OutstandingDebt but signals
	/// that the given loan is i.e. an account
	/// holding cash
	Cash,
}

impl<Rate> ValuationMethod<Rate>
where
	Rate: FixedPointNumber,
{
	pub fn is_valid(&self) -> bool {
		match self {
			ValuationMethod::DiscountedCashFlow(dcf) => dcf.discount_rate.per_year() <= One::one(),
			ValuationMethod::OutstandingDebt | ValuationMethod::Cash => true,
		}
	}
}