mirror of
https://github.com/XRPLF/rippled.git
synced 2025-12-06 17:27:55 +00:00
Compare commits
36 Commits
ximinez/le
...
ximinez/le
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
3783861578 | ||
|
|
5224636794 | ||
|
|
8eabad42dd | ||
|
|
5ceb915be4 | ||
|
|
354531f946 | ||
|
|
0650e6e89d | ||
|
|
89de2b55f6 | ||
|
|
43a6f10050 | ||
|
|
e2e9582ff1 | ||
|
|
803380c53c | ||
|
|
06689d9cb5 | ||
|
|
8e4be94f4a | ||
|
|
1f3ded7116 | ||
|
|
aa1234199a | ||
|
|
3eaddcc2bc | ||
|
|
da9a483b79 | ||
|
|
f447827474 | ||
|
|
d9a44dbbbc | ||
|
|
19c72b30e4 | ||
|
|
07497322de | ||
|
|
d5d6b0c7cb | ||
|
|
f665463050 | ||
|
|
c7d73fb938 | ||
|
|
c6ff9882f8 | ||
|
|
f9027bb88f | ||
|
|
992a62a95a | ||
|
|
1484ec6640 | ||
|
|
0d119161cf | ||
|
|
a224e089e6 | ||
|
|
295c8bddae | ||
|
|
c2b3cd4069 | ||
|
|
ef3fa22144 | ||
|
|
e961d85819 | ||
|
|
12ceb8bc86 | ||
|
|
078afb51d9 | ||
|
|
bfac68e308 |
@@ -3176,6 +3176,24 @@ requireAuth(
|
|||||||
!isTesSuccess(err))
|
!isTesSuccess(err))
|
||||||
return err;
|
return err;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// requireAuth is also recursive if the _account_ is a vault
|
||||||
|
auto const sleAccount = view.read(keylet::account(account));
|
||||||
|
if (!sleAccount)
|
||||||
|
return tefINTERNAL; // LCOV_EXCL_LINE
|
||||||
|
|
||||||
|
if (sleAccount->isFieldPresent(sfVaultID))
|
||||||
|
{
|
||||||
|
auto const sleVault =
|
||||||
|
view.read(keylet::vault(sleAccount->getFieldH256(sfVaultID)));
|
||||||
|
if (!sleVault)
|
||||||
|
return tefINTERNAL; // LCOV_EXCL_LINE
|
||||||
|
auto const ownerAcct = sleVault->getAccountID(sfOwner);
|
||||||
|
if (auto const err =
|
||||||
|
requireAuth(view, mptIssue, ownerAcct, authType, depth + 1);
|
||||||
|
!isTesSuccess(err))
|
||||||
|
return err;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
auto const mptokenID = keylet::mptoken(mptID.key, account);
|
auto const mptokenID = keylet::mptoken(mptID.key, account);
|
||||||
|
|||||||
642
src/test/app/LendingHelpers_test.cpp
Normal file
642
src/test/app/LendingHelpers_test.cpp
Normal file
@@ -0,0 +1,642 @@
|
|||||||
|
#include <xrpl/beast/unit_test/suite.h>
|
||||||
|
// DO NOT REMOVE
|
||||||
|
#include <test/jtx.h>
|
||||||
|
#include <test/jtx/Account.h>
|
||||||
|
#include <test/jtx/amount.h>
|
||||||
|
#include <test/jtx/mpt.h>
|
||||||
|
|
||||||
|
#include <xrpld/app/misc/LendingHelpers.h>
|
||||||
|
#include <xrpld/app/misc/LoadFeeTrack.h>
|
||||||
|
#include <xrpld/app/tx/detail/Batch.h>
|
||||||
|
#include <xrpld/app/tx/detail/LoanSet.h>
|
||||||
|
|
||||||
|
#include <xrpl/beast/xor_shift_engine.h>
|
||||||
|
#include <xrpl/protocol/SField.h>
|
||||||
|
|
||||||
|
#include <string>
|
||||||
|
#include <vector>
|
||||||
|
|
||||||
|
namespace ripple {
|
||||||
|
namespace test {
|
||||||
|
|
||||||
|
class LendingHelpers_test : public beast::unit_test::suite
|
||||||
|
{
|
||||||
|
void
|
||||||
|
testComputeRaisedRate()
|
||||||
|
{
|
||||||
|
using namespace jtx;
|
||||||
|
using namespace ripple::detail;
|
||||||
|
struct TestCase
|
||||||
|
{
|
||||||
|
std::string name;
|
||||||
|
Number periodicRate;
|
||||||
|
std::uint32_t paymentsRemaining;
|
||||||
|
Number expectedRaisedRate;
|
||||||
|
};
|
||||||
|
|
||||||
|
auto const testCases = std::vector<TestCase>{
|
||||||
|
{
|
||||||
|
.name = "Zero payments remaining",
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.paymentsRemaining = 0,
|
||||||
|
.expectedRaisedRate = Number{1}, // (1 + r)^0 = 1
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "One payment remaining",
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.paymentsRemaining = 1,
|
||||||
|
.expectedRaisedRate = Number{105, -2},
|
||||||
|
}, // 1.05^1
|
||||||
|
{
|
||||||
|
.name = "Multiple payments remaining",
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.paymentsRemaining = 3,
|
||||||
|
.expectedRaisedRate = Number{1157625, -6},
|
||||||
|
}, // 1.05^3
|
||||||
|
{
|
||||||
|
.name = "Zero periodic rate",
|
||||||
|
.periodicRate = Number{0},
|
||||||
|
.paymentsRemaining = 5,
|
||||||
|
.expectedRaisedRate = Number{1}, // (1 + 0)^5 = 1
|
||||||
|
}};
|
||||||
|
|
||||||
|
for (auto const& tc : testCases)
|
||||||
|
{
|
||||||
|
testcase("computeRaisedRate: " + tc.name);
|
||||||
|
|
||||||
|
auto const computedRaisedRate =
|
||||||
|
computeRaisedRate(tc.periodicRate, tc.paymentsRemaining);
|
||||||
|
BEAST_EXPECTS(
|
||||||
|
computedRaisedRate == tc.expectedRaisedRate,
|
||||||
|
"Raised rate mismatch: expected " +
|
||||||
|
to_string(tc.expectedRaisedRate) + ", got " +
|
||||||
|
to_string(computedRaisedRate));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void
|
||||||
|
testComputePaymentFactor()
|
||||||
|
{
|
||||||
|
using namespace jtx;
|
||||||
|
using namespace ripple::detail;
|
||||||
|
struct TestCase
|
||||||
|
{
|
||||||
|
std::string name;
|
||||||
|
Number periodicRate;
|
||||||
|
std::uint32_t paymentsRemaining;
|
||||||
|
Number expectedPaymentFactor;
|
||||||
|
};
|
||||||
|
|
||||||
|
auto const testCases = std::vector<TestCase>{
|
||||||
|
{
|
||||||
|
.name = "Zero periodic rate",
|
||||||
|
.periodicRate = Number{0},
|
||||||
|
.paymentsRemaining = 4,
|
||||||
|
.expectedPaymentFactor = Number{25, -2},
|
||||||
|
}, // 1/4 = 0.25
|
||||||
|
{
|
||||||
|
.name = "One payment remaining",
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.paymentsRemaining = 1,
|
||||||
|
.expectedPaymentFactor = Number{105, -2},
|
||||||
|
}, // 0.05/1 = 1.05
|
||||||
|
{
|
||||||
|
.name = "Multiple payments remaining",
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.paymentsRemaining = 3,
|
||||||
|
.expectedPaymentFactor = Number{367208564631245, -15},
|
||||||
|
}, // from calc
|
||||||
|
{
|
||||||
|
.name = "Zero payments remaining",
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.paymentsRemaining = 0,
|
||||||
|
.expectedPaymentFactor = Number{0},
|
||||||
|
} // edge case
|
||||||
|
};
|
||||||
|
|
||||||
|
for (auto const& tc : testCases)
|
||||||
|
{
|
||||||
|
testcase("computePaymentFactor: " + tc.name);
|
||||||
|
|
||||||
|
auto const computedPaymentFactor =
|
||||||
|
computePaymentFactor(tc.periodicRate, tc.paymentsRemaining);
|
||||||
|
BEAST_EXPECTS(
|
||||||
|
computedPaymentFactor == tc.expectedPaymentFactor,
|
||||||
|
"Payment factor mismatch: expected " +
|
||||||
|
to_string(tc.expectedPaymentFactor) + ", got " +
|
||||||
|
to_string(computedPaymentFactor));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void
|
||||||
|
testLoanPeriodicPayment()
|
||||||
|
{
|
||||||
|
using namespace jtx;
|
||||||
|
using namespace ripple::detail;
|
||||||
|
|
||||||
|
struct TestCase
|
||||||
|
{
|
||||||
|
std::string name;
|
||||||
|
Number principalOutstanding;
|
||||||
|
Number periodicRate;
|
||||||
|
std::uint32_t paymentsRemaining;
|
||||||
|
Number expectedPeriodicPayment;
|
||||||
|
};
|
||||||
|
|
||||||
|
auto const testCases = std::vector<TestCase>{
|
||||||
|
{
|
||||||
|
.name = "Zero principal outstanding",
|
||||||
|
.principalOutstanding = Number{0},
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.paymentsRemaining = 5,
|
||||||
|
.expectedPeriodicPayment = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Zero payments remaining",
|
||||||
|
.principalOutstanding = Number{1'000},
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.paymentsRemaining = 0,
|
||||||
|
.expectedPeriodicPayment = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Zero periodic rate",
|
||||||
|
.principalOutstanding = Number{1'000},
|
||||||
|
.periodicRate = Number{0},
|
||||||
|
.paymentsRemaining = 4,
|
||||||
|
.expectedPeriodicPayment = Number{250},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Standard case",
|
||||||
|
.principalOutstanding = Number{1'000},
|
||||||
|
.periodicRate =
|
||||||
|
loanPeriodicRate(TenthBips32(100'000), 30 * 24 * 60 * 60),
|
||||||
|
.paymentsRemaining = 3,
|
||||||
|
.expectedPeriodicPayment =
|
||||||
|
Number{3895690663961231, -13}, // from calc
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
for (auto const& tc : testCases)
|
||||||
|
{
|
||||||
|
testcase("loanPeriodicPayment: " + tc.name);
|
||||||
|
|
||||||
|
auto const computedPeriodicPayment = loanPeriodicPayment(
|
||||||
|
tc.principalOutstanding, tc.periodicRate, tc.paymentsRemaining);
|
||||||
|
BEAST_EXPECTS(
|
||||||
|
computedPeriodicPayment == tc.expectedPeriodicPayment,
|
||||||
|
"Periodic payment mismatch: expected " +
|
||||||
|
to_string(tc.expectedPeriodicPayment) + ", got " +
|
||||||
|
to_string(computedPeriodicPayment));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void
|
||||||
|
testLoanPrincipalFromPeriodicPayment()
|
||||||
|
{
|
||||||
|
using namespace jtx;
|
||||||
|
using namespace ripple::detail;
|
||||||
|
|
||||||
|
struct TestCase
|
||||||
|
{
|
||||||
|
std::string name;
|
||||||
|
Number periodicPayment;
|
||||||
|
Number periodicRate;
|
||||||
|
std::uint32_t paymentsRemaining;
|
||||||
|
Number expectedPrincipalOutstanding;
|
||||||
|
};
|
||||||
|
|
||||||
|
auto const testCases = std::vector<TestCase>{
|
||||||
|
{
|
||||||
|
.name = "Zero periodic payment",
|
||||||
|
.periodicPayment = Number{0},
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.paymentsRemaining = 5,
|
||||||
|
.expectedPrincipalOutstanding = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Zero payments remaining",
|
||||||
|
.periodicPayment = Number{1'000},
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.paymentsRemaining = 0,
|
||||||
|
.expectedPrincipalOutstanding = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Zero periodic rate",
|
||||||
|
.periodicPayment = Number{250},
|
||||||
|
.periodicRate = Number{0},
|
||||||
|
.paymentsRemaining = 4,
|
||||||
|
.expectedPrincipalOutstanding = Number{1'000},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Standard case",
|
||||||
|
.periodicPayment = Number{3895690663961231, -13}, // from calc
|
||||||
|
.periodicRate =
|
||||||
|
loanPeriodicRate(TenthBips32(100'000), 30 * 24 * 60 * 60),
|
||||||
|
.paymentsRemaining = 3,
|
||||||
|
.expectedPrincipalOutstanding = Number{1'000},
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
for (auto const& tc : testCases)
|
||||||
|
{
|
||||||
|
testcase("loanPrincipalFromPeriodicPayment: " + tc.name);
|
||||||
|
|
||||||
|
auto const computedPrincipalOutstanding =
|
||||||
|
loanPrincipalFromPeriodicPayment(
|
||||||
|
tc.periodicPayment, tc.periodicRate, tc.paymentsRemaining);
|
||||||
|
BEAST_EXPECTS(
|
||||||
|
computedPrincipalOutstanding == tc.expectedPrincipalOutstanding,
|
||||||
|
"Principal outstanding mismatch: expected " +
|
||||||
|
to_string(tc.expectedPrincipalOutstanding) + ", got " +
|
||||||
|
to_string(computedPrincipalOutstanding));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void
|
||||||
|
testComputeOverpaymentComponents()
|
||||||
|
{
|
||||||
|
testcase("computeOverpaymentComponents");
|
||||||
|
using namespace jtx;
|
||||||
|
using namespace ripple::detail;
|
||||||
|
|
||||||
|
Account const issuer{"issuer"};
|
||||||
|
PrettyAsset const IOU = issuer["IOU"];
|
||||||
|
int32_t const loanScale = 1;
|
||||||
|
auto const overpayment = Number{1'000};
|
||||||
|
auto const overpaymentInterestRate = TenthBips32{10'000}; // 10%
|
||||||
|
auto const overpaymentFeeRate = TenthBips32{50'000}; // 50%
|
||||||
|
auto const managementFeeRate = TenthBips16{10'000}; // 10%
|
||||||
|
|
||||||
|
auto const expectedOverpaymentFee = Number{500}; // 50% of 1,000
|
||||||
|
auto const expectedOverpaymentInterestGross =
|
||||||
|
Number{100}; // 10% of 1,000
|
||||||
|
auto const expectedOverpaymentInterestNet =
|
||||||
|
Number{90}; // 100 - 10% of 100
|
||||||
|
auto const expectedOverpaymentManagementFee = Number{10}; // 10% of 100
|
||||||
|
auto const expectedPrincipalPortion = Number{400}; // 1,000 - 100 - 500
|
||||||
|
|
||||||
|
auto const components = detail::computeOverpaymentComponents(
|
||||||
|
IOU,
|
||||||
|
loanScale,
|
||||||
|
overpayment,
|
||||||
|
overpaymentInterestRate,
|
||||||
|
overpaymentFeeRate,
|
||||||
|
managementFeeRate);
|
||||||
|
|
||||||
|
BEAST_EXPECT(
|
||||||
|
components.untrackedManagementFee == expectedOverpaymentFee);
|
||||||
|
|
||||||
|
BEAST_EXPECT(
|
||||||
|
components.untrackedInterest == expectedOverpaymentInterestNet);
|
||||||
|
BEAST_EXPECT(
|
||||||
|
components.trackedManagementFeeDelta ==
|
||||||
|
expectedOverpaymentManagementFee);
|
||||||
|
BEAST_EXPECT(
|
||||||
|
components.trackedPrincipalDelta == expectedPrincipalPortion);
|
||||||
|
BEAST_EXPECT(
|
||||||
|
components.trackedManagementFeeDelta +
|
||||||
|
components.untrackedInterest ==
|
||||||
|
expectedOverpaymentInterestGross);
|
||||||
|
|
||||||
|
BEAST_EXPECT(
|
||||||
|
components.trackedManagementFeeDelta +
|
||||||
|
components.untrackedInterest +
|
||||||
|
components.trackedPrincipalDelta +
|
||||||
|
components.untrackedManagementFee ==
|
||||||
|
overpayment);
|
||||||
|
}
|
||||||
|
|
||||||
|
void
|
||||||
|
testComputeInterestAndFeeParts()
|
||||||
|
{
|
||||||
|
using namespace jtx;
|
||||||
|
using namespace ripple::detail;
|
||||||
|
|
||||||
|
struct TestCase
|
||||||
|
{
|
||||||
|
std::string name;
|
||||||
|
Number interest;
|
||||||
|
TenthBips16 managementFeeRate;
|
||||||
|
Number expectedInterestPart;
|
||||||
|
Number expectedFeePart;
|
||||||
|
};
|
||||||
|
|
||||||
|
Account const issuer{"issuer"};
|
||||||
|
PrettyAsset const IOU = issuer["IOU"];
|
||||||
|
std::int32_t const loanScale = 1;
|
||||||
|
|
||||||
|
auto const testCases = std::vector<TestCase>{
|
||||||
|
{.name = "Zero interest",
|
||||||
|
.interest = Number{0},
|
||||||
|
.managementFeeRate = TenthBips16{10'000},
|
||||||
|
.expectedInterestPart = Number{0},
|
||||||
|
.expectedFeePart = Number{0}},
|
||||||
|
{.name = "Zero fee rate",
|
||||||
|
.interest = Number{1'000},
|
||||||
|
.managementFeeRate = TenthBips16{0},
|
||||||
|
.expectedInterestPart = Number{1'000},
|
||||||
|
.expectedFeePart = Number{0}},
|
||||||
|
{.name = "10% fee rate",
|
||||||
|
.interest = Number{1'000},
|
||||||
|
.managementFeeRate = TenthBips16{10'000},
|
||||||
|
.expectedInterestPart = Number{900},
|
||||||
|
.expectedFeePart = Number{100}},
|
||||||
|
};
|
||||||
|
|
||||||
|
for (auto const& tc : testCases)
|
||||||
|
{
|
||||||
|
testcase("computeInterestAndFeeParts: " + tc.name);
|
||||||
|
|
||||||
|
auto const [computedInterestPart, computedFeePart] =
|
||||||
|
computeInterestAndFeeParts(
|
||||||
|
IOU, tc.interest, tc.managementFeeRate, loanScale);
|
||||||
|
BEAST_EXPECTS(
|
||||||
|
computedInterestPart == tc.expectedInterestPart,
|
||||||
|
"Interest part mismatch: expected " +
|
||||||
|
to_string(tc.expectedInterestPart) + ", got " +
|
||||||
|
to_string(computedInterestPart));
|
||||||
|
BEAST_EXPECTS(
|
||||||
|
computedFeePart == tc.expectedFeePart,
|
||||||
|
"Fee part mismatch: expected " + to_string(tc.expectedFeePart) +
|
||||||
|
", got " + to_string(computedFeePart));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void
|
||||||
|
testLoanLatePaymentInterest()
|
||||||
|
{
|
||||||
|
using namespace jtx;
|
||||||
|
using namespace ripple::detail;
|
||||||
|
struct TestCase
|
||||||
|
{
|
||||||
|
std::string name;
|
||||||
|
Number principalOutstanding;
|
||||||
|
TenthBips32 lateInterestRate;
|
||||||
|
NetClock::time_point parentCloseTime;
|
||||||
|
std::uint32_t nextPaymentDueDate;
|
||||||
|
Number expectedLateInterest;
|
||||||
|
};
|
||||||
|
|
||||||
|
auto const testCases = std::vector<TestCase>{
|
||||||
|
{
|
||||||
|
.name = "On-time payment",
|
||||||
|
.principalOutstanding = Number{1'000},
|
||||||
|
.lateInterestRate = TenthBips32{10'000}, // 10%
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.nextPaymentDueDate = 3'000,
|
||||||
|
.expectedLateInterest = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Early payment",
|
||||||
|
.principalOutstanding = Number{1'000},
|
||||||
|
.lateInterestRate = TenthBips32{10'000}, // 10%
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.nextPaymentDueDate = 4'000,
|
||||||
|
.expectedLateInterest = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "No principal outstanding",
|
||||||
|
.principalOutstanding = Number{0},
|
||||||
|
.lateInterestRate = TenthBips32{10'000}, // 10%
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.nextPaymentDueDate = 2'000,
|
||||||
|
.expectedLateInterest = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "No late interest rate",
|
||||||
|
.principalOutstanding = Number{1'000},
|
||||||
|
.lateInterestRate = TenthBips32{0}, // 0%
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.nextPaymentDueDate = 2'000,
|
||||||
|
.expectedLateInterest = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Late payment",
|
||||||
|
.principalOutstanding = Number{1'000},
|
||||||
|
.lateInterestRate = TenthBips32{100'000}, // 100%
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.nextPaymentDueDate = 2'000,
|
||||||
|
.expectedLateInterest =
|
||||||
|
Number{3170979198376459, -17}, // from calc
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
for (auto const& tc : testCases)
|
||||||
|
{
|
||||||
|
testcase("loanLatePaymentInterest: " + tc.name);
|
||||||
|
|
||||||
|
auto const computedLateInterest = loanLatePaymentInterest(
|
||||||
|
tc.principalOutstanding,
|
||||||
|
tc.lateInterestRate,
|
||||||
|
tc.parentCloseTime,
|
||||||
|
tc.nextPaymentDueDate);
|
||||||
|
BEAST_EXPECTS(
|
||||||
|
computedLateInterest == tc.expectedLateInterest,
|
||||||
|
"Late interest mismatch: expected " +
|
||||||
|
to_string(tc.expectedLateInterest) + ", got " +
|
||||||
|
to_string(computedLateInterest));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
void
|
||||||
|
testLoanAccruedInterest()
|
||||||
|
{
|
||||||
|
using namespace jtx;
|
||||||
|
using namespace ripple::detail;
|
||||||
|
struct TestCase
|
||||||
|
{
|
||||||
|
std::string name;
|
||||||
|
Number principalOutstanding;
|
||||||
|
Number periodicRate;
|
||||||
|
NetClock::time_point parentCloseTime;
|
||||||
|
std::uint32_t startDate;
|
||||||
|
std::uint32_t prevPaymentDate;
|
||||||
|
std::uint32_t paymentInterval;
|
||||||
|
Number expectedAccruedInterest;
|
||||||
|
};
|
||||||
|
|
||||||
|
auto const testCases = std::vector<TestCase>{
|
||||||
|
{
|
||||||
|
.name = "Zero principal outstanding",
|
||||||
|
.principalOutstanding = Number{0},
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.startDate = 2'000,
|
||||||
|
.prevPaymentDate = 2'500,
|
||||||
|
.paymentInterval = 30 * 24 * 60 * 60,
|
||||||
|
.expectedAccruedInterest = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Before start date",
|
||||||
|
.principalOutstanding = Number{1'000},
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{1'000}},
|
||||||
|
.startDate = 2'000,
|
||||||
|
.prevPaymentDate = 1'500,
|
||||||
|
.paymentInterval = 30 * 24 * 60 * 60,
|
||||||
|
.expectedAccruedInterest = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Zero periodic rate",
|
||||||
|
.principalOutstanding = Number{1'000},
|
||||||
|
.periodicRate = Number{0},
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.startDate = 2'000,
|
||||||
|
.prevPaymentDate = 2'500,
|
||||||
|
.paymentInterval = 30 * 24 * 60 * 60,
|
||||||
|
.expectedAccruedInterest = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Zero payment interval",
|
||||||
|
.principalOutstanding = Number{1'000},
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.startDate = 2'000,
|
||||||
|
.prevPaymentDate = 2'500,
|
||||||
|
.paymentInterval = 0,
|
||||||
|
.expectedAccruedInterest = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Standard case",
|
||||||
|
.principalOutstanding = Number{1'000},
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.startDate = 1'000,
|
||||||
|
.prevPaymentDate = 2'000,
|
||||||
|
.paymentInterval = 30 * 24 * 60 * 60,
|
||||||
|
.expectedAccruedInterest =
|
||||||
|
Number{1929012345679012, -17}, // from calc
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
for (auto const& tc : testCases)
|
||||||
|
{
|
||||||
|
testcase("loanAccruedInterest: " + tc.name);
|
||||||
|
|
||||||
|
auto const computedAccruedInterest = loanAccruedInterest(
|
||||||
|
tc.principalOutstanding,
|
||||||
|
tc.periodicRate,
|
||||||
|
tc.parentCloseTime,
|
||||||
|
tc.startDate,
|
||||||
|
tc.prevPaymentDate,
|
||||||
|
tc.paymentInterval);
|
||||||
|
BEAST_EXPECTS(
|
||||||
|
computedAccruedInterest == tc.expectedAccruedInterest,
|
||||||
|
"Accrued interest mismatch: expected " +
|
||||||
|
to_string(tc.expectedAccruedInterest) + ", got " +
|
||||||
|
to_string(computedAccruedInterest));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// This test overlaps with testLoanAccruedInterest, the test cases only
|
||||||
|
// exercise the computeFullPaymentInterest parts unique to it.
|
||||||
|
void
|
||||||
|
testComputeFullPaymentInterest()
|
||||||
|
{
|
||||||
|
using namespace jtx;
|
||||||
|
using namespace ripple::detail;
|
||||||
|
|
||||||
|
struct TestCase
|
||||||
|
{
|
||||||
|
std::string name;
|
||||||
|
Number rawPrincipalOutstanding;
|
||||||
|
Number periodicRate;
|
||||||
|
NetClock::time_point parentCloseTime;
|
||||||
|
std::uint32_t paymentInterval;
|
||||||
|
std::uint32_t prevPaymentDate;
|
||||||
|
std::uint32_t startDate;
|
||||||
|
TenthBips32 closeInterestRate;
|
||||||
|
Number expectedFullPaymentInterest;
|
||||||
|
};
|
||||||
|
|
||||||
|
auto const testCases = std::vector<TestCase>{
|
||||||
|
{
|
||||||
|
.name = "Zero principal outstanding",
|
||||||
|
.rawPrincipalOutstanding = Number{0},
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.paymentInterval = 30 * 24 * 60 * 60,
|
||||||
|
.prevPaymentDate = 2'000,
|
||||||
|
.startDate = 1'000,
|
||||||
|
.closeInterestRate = TenthBips32{10'000},
|
||||||
|
.expectedFullPaymentInterest = Number{0},
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Zero close interest rate",
|
||||||
|
.rawPrincipalOutstanding = Number{1'000},
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.paymentInterval = 30 * 24 * 60 * 60,
|
||||||
|
.prevPaymentDate = 2'000,
|
||||||
|
.startDate = 1'000,
|
||||||
|
.closeInterestRate = TenthBips32{0},
|
||||||
|
.expectedFullPaymentInterest =
|
||||||
|
Number{1929012345679012, -17}, // from calc
|
||||||
|
},
|
||||||
|
{
|
||||||
|
.name = "Standard case",
|
||||||
|
.rawPrincipalOutstanding = Number{1'000},
|
||||||
|
.periodicRate = Number{5, -2},
|
||||||
|
.parentCloseTime =
|
||||||
|
NetClock::time_point{NetClock::duration{3'000}},
|
||||||
|
.paymentInterval = 30 * 24 * 60 * 60,
|
||||||
|
.prevPaymentDate = 2'000,
|
||||||
|
.startDate = 1'000,
|
||||||
|
.closeInterestRate = TenthBips32{10'000},
|
||||||
|
.expectedFullPaymentInterest =
|
||||||
|
Number{1000192901234568, -13}, // from calc
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
for (auto const& tc : testCases)
|
||||||
|
{
|
||||||
|
testcase("computeFullPaymentInterest: " + tc.name);
|
||||||
|
|
||||||
|
auto const computedFullPaymentInterest = computeFullPaymentInterest(
|
||||||
|
tc.rawPrincipalOutstanding,
|
||||||
|
tc.periodicRate,
|
||||||
|
tc.parentCloseTime,
|
||||||
|
tc.paymentInterval,
|
||||||
|
tc.prevPaymentDate,
|
||||||
|
tc.startDate,
|
||||||
|
tc.closeInterestRate);
|
||||||
|
BEAST_EXPECTS(
|
||||||
|
computedFullPaymentInterest == tc.expectedFullPaymentInterest,
|
||||||
|
"Full payment interest mismatch: expected " +
|
||||||
|
to_string(tc.expectedFullPaymentInterest) + ", got " +
|
||||||
|
to_string(computedFullPaymentInterest));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public:
|
||||||
|
void
|
||||||
|
run() override
|
||||||
|
{
|
||||||
|
testComputeFullPaymentInterest();
|
||||||
|
testLoanAccruedInterest();
|
||||||
|
testLoanLatePaymentInterest();
|
||||||
|
testLoanPeriodicPayment();
|
||||||
|
testLoanPrincipalFromPeriodicPayment();
|
||||||
|
testComputeRaisedRate();
|
||||||
|
testComputePaymentFactor();
|
||||||
|
testComputeOverpaymentComponents();
|
||||||
|
testComputeInterestAndFeeParts();
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
BEAST_DEFINE_TESTSUITE(LendingHelpers, app, ripple);
|
||||||
|
|
||||||
|
} // namespace test
|
||||||
|
} // namespace ripple
|
||||||
@@ -1275,7 +1275,8 @@ protected:
|
|||||||
verifyLoanStatus,
|
verifyLoanStatus,
|
||||||
issuer,
|
issuer,
|
||||||
lender,
|
lender,
|
||||||
borrower);
|
borrower,
|
||||||
|
PaymentParameters{.showStepBalances = true});
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Runs through the complete lifecycle of a loan
|
/** Runs through the complete lifecycle of a loan
|
||||||
@@ -6154,15 +6155,16 @@ protected:
|
|||||||
// Accrued + prepayment-penalty interest based on current periodic
|
// Accrued + prepayment-penalty interest based on current periodic
|
||||||
// schedule
|
// schedule
|
||||||
auto const fullPaymentInterest = computeFullPaymentInterest(
|
auto const fullPaymentInterest = computeFullPaymentInterest(
|
||||||
after.periodicPayment,
|
detail::loanPrincipalFromPeriodicPayment(
|
||||||
|
after.periodicPayment, periodicRate2, after.paymentRemaining),
|
||||||
periodicRate2,
|
periodicRate2,
|
||||||
after.paymentRemaining,
|
|
||||||
env.current()->parentCloseTime(),
|
env.current()->parentCloseTime(),
|
||||||
after.paymentInterval,
|
after.paymentInterval,
|
||||||
after.previousPaymentDate,
|
after.previousPaymentDate,
|
||||||
static_cast<std::uint32_t>(
|
static_cast<std::uint32_t>(
|
||||||
after.startDate.time_since_epoch().count()),
|
after.startDate.time_since_epoch().count()),
|
||||||
closeInterestRate);
|
closeInterestRate);
|
||||||
|
|
||||||
// Round to asset scale and split interest/fee parts
|
// Round to asset scale and split interest/fee parts
|
||||||
auto const roundedInterest =
|
auto const roundedInterest =
|
||||||
roundToAsset(asset.raw(), fullPaymentInterest, after.loanScale);
|
roundToAsset(asset.raw(), fullPaymentInterest, after.loanScale);
|
||||||
@@ -6190,9 +6192,9 @@ protected:
|
|||||||
// window by clamping prevPaymentDate to 'now' for the full-pay path.
|
// window by clamping prevPaymentDate to 'now' for the full-pay path.
|
||||||
auto const prevClamped = std::min(after.previousPaymentDate, nowSecs);
|
auto const prevClamped = std::min(after.previousPaymentDate, nowSecs);
|
||||||
auto const fullPaymentInterestClamped = computeFullPaymentInterest(
|
auto const fullPaymentInterestClamped = computeFullPaymentInterest(
|
||||||
after.periodicPayment,
|
detail::loanPrincipalFromPeriodicPayment(
|
||||||
|
after.periodicPayment, periodicRate2, after.paymentRemaining),
|
||||||
periodicRate2,
|
periodicRate2,
|
||||||
after.paymentRemaining,
|
|
||||||
env.current()->parentCloseTime(),
|
env.current()->parentCloseTime(),
|
||||||
after.paymentInterval,
|
after.paymentInterval,
|
||||||
prevClamped,
|
prevClamped,
|
||||||
@@ -7203,15 +7205,15 @@ class LoanArbitrary_test : public LoanBatch_test
|
|||||||
.vaultDeposit = 10000,
|
.vaultDeposit = 10000,
|
||||||
.debtMax = 0,
|
.debtMax = 0,
|
||||||
.coverRateMin = TenthBips32{0},
|
.coverRateMin = TenthBips32{0},
|
||||||
// .managementFeeRate = TenthBips16{5919},
|
.managementFeeRate = TenthBips16{0},
|
||||||
.coverRateLiquidation = TenthBips32{0}};
|
.coverRateLiquidation = TenthBips32{0}};
|
||||||
LoanParameters const loanParams{
|
LoanParameters const loanParams{
|
||||||
.account = Account("lender"),
|
.account = Account("lender"),
|
||||||
.counter = Account("borrower"),
|
.counter = Account("borrower"),
|
||||||
.principalRequest = Number{10000, 0},
|
.principalRequest = Number{200000, -6},
|
||||||
// .interest = TenthBips32{0},
|
.interest = TenthBips32{50000},
|
||||||
// .payTotal = 5816,
|
.payTotal = 2,
|
||||||
.payInterval = 150};
|
.payInterval = 200};
|
||||||
|
|
||||||
runLoan(AssetType::XRP, brokerParams, loanParams);
|
runLoan(AssetType::XRP, brokerParams, loanParams);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -2358,6 +2358,18 @@ class Vault_test : public beast::unit_test::suite
|
|||||||
.amount = asset(100)});
|
.amount = asset(100)});
|
||||||
env(tx, ter(tecNO_AUTH));
|
env(tx, ter(tecNO_AUTH));
|
||||||
|
|
||||||
|
// Withdrawal to other (authorized) accounts doesn't work.
|
||||||
|
// Issuer would have to VaultClawback
|
||||||
|
tx[sfDestination] = issuer.human();
|
||||||
|
env(tx, ter(tecNO_AUTH));
|
||||||
|
tx[sfDestination] = owner.human();
|
||||||
|
env(tx, ter(tecNO_AUTH));
|
||||||
|
env.close();
|
||||||
|
|
||||||
|
// Issuer reauthorizes
|
||||||
|
mptt.authorize({.account = issuer, .holder = depositor});
|
||||||
|
env.close();
|
||||||
|
|
||||||
// Withdrawal to other (authorized) accounts works
|
// Withdrawal to other (authorized) accounts works
|
||||||
tx[sfDestination] = issuer.human();
|
tx[sfDestination] = issuer.human();
|
||||||
env(tx);
|
env(tx);
|
||||||
@@ -2368,6 +2380,13 @@ class Vault_test : public beast::unit_test::suite
|
|||||||
env.close();
|
env.close();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Re-unauthorize
|
||||||
|
mptt.authorize(
|
||||||
|
{.account = issuer,
|
||||||
|
.holder = depositor,
|
||||||
|
.flags = tfMPTUnauthorize});
|
||||||
|
env.close();
|
||||||
|
|
||||||
{
|
{
|
||||||
// Cannot deposit some more
|
// Cannot deposit some more
|
||||||
auto tx = vault.deposit(
|
auto tx = vault.deposit(
|
||||||
|
|||||||
@@ -644,7 +644,7 @@ MPTTester::operator[](std::string const& name) const
|
|||||||
}
|
}
|
||||||
|
|
||||||
PrettyAmount
|
PrettyAmount
|
||||||
MPTTester::operator()(std::uint64_t amount) const
|
MPTTester::operator()(std::int64_t amount) const
|
||||||
{
|
{
|
||||||
return MPT("", issuanceID())(amount);
|
return MPT("", issuanceID())(amount);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -272,7 +272,7 @@ public:
|
|||||||
operator[](std::string const& name) const;
|
operator[](std::string const& name) const;
|
||||||
|
|
||||||
PrettyAmount
|
PrettyAmount
|
||||||
operator()(std::uint64_t amount) const;
|
operator()(std::int64_t amount) const;
|
||||||
|
|
||||||
operator Asset() const;
|
operator Asset() const;
|
||||||
|
|
||||||
|
|||||||
@@ -187,9 +187,9 @@ class Feature_test : public beast::unit_test::suite
|
|||||||
BEAST_EXPECTS(jrr[jss::status] == jss::success, "status");
|
BEAST_EXPECTS(jrr[jss::status] == jss::success, "status");
|
||||||
jrr.removeMember(jss::status);
|
jrr.removeMember(jss::status);
|
||||||
BEAST_EXPECT(jrr.size() == 1);
|
BEAST_EXPECT(jrr.size() == 1);
|
||||||
BEAST_EXPECT(
|
BEAST_EXPECT(jrr.isMember(
|
||||||
jrr.isMember("12523DF04B553A0B1AD74F42DDB741DE8DC06A03FC089A0EF197E"
|
"740352F2412A9909880C23A559FCECEDA3BE2126FED62FC7660D6"
|
||||||
"2A87F1D8107"));
|
"28A06927F11"));
|
||||||
auto feature = *(jrr.begin());
|
auto feature = *(jrr.begin());
|
||||||
|
|
||||||
BEAST_EXPECTS(feature[jss::name] == "fixAMMOverflowOffer", "name");
|
BEAST_EXPECTS(feature[jss::name] == "fixAMMOverflowOffer", "name");
|
||||||
|
|||||||
@@ -203,14 +203,6 @@ computeRawLoanState(
|
|||||||
std::uint32_t const paymentRemaining,
|
std::uint32_t const paymentRemaining,
|
||||||
TenthBips32 const managementFeeRate);
|
TenthBips32 const managementFeeRate);
|
||||||
|
|
||||||
LoanState
|
|
||||||
computeRawLoanState(
|
|
||||||
Number const& periodicPayment,
|
|
||||||
TenthBips32 interestRate,
|
|
||||||
std::uint32_t paymentInterval,
|
|
||||||
std::uint32_t const paymentRemaining,
|
|
||||||
TenthBips32 const managementFeeRate);
|
|
||||||
|
|
||||||
// Constructs a valid LoanState object from arbitrary inputs
|
// Constructs a valid LoanState object from arbitrary inputs
|
||||||
LoanState
|
LoanState
|
||||||
constructLoanState(
|
constructLoanState(
|
||||||
@@ -240,17 +232,6 @@ computeFullPaymentInterest(
|
|||||||
std::uint32_t startDate,
|
std::uint32_t startDate,
|
||||||
TenthBips32 closeInterestRate);
|
TenthBips32 closeInterestRate);
|
||||||
|
|
||||||
Number
|
|
||||||
computeFullPaymentInterest(
|
|
||||||
Number const& periodicPayment,
|
|
||||||
Number const& periodicRate,
|
|
||||||
std::uint32_t paymentRemaining,
|
|
||||||
NetClock::time_point parentCloseTime,
|
|
||||||
std::uint32_t paymentInterval,
|
|
||||||
std::uint32_t prevPaymentDate,
|
|
||||||
std::uint32_t startDate,
|
|
||||||
TenthBips32 closeInterestRate);
|
|
||||||
|
|
||||||
namespace detail {
|
namespace detail {
|
||||||
// These classes and functions should only be accessed by LendingHelper
|
// These classes and functions should only be accessed by LendingHelper
|
||||||
// functions and unit tests
|
// functions and unit tests
|
||||||
@@ -388,6 +369,58 @@ struct LoanStateDeltas
|
|||||||
nonNegative();
|
nonNegative();
|
||||||
};
|
};
|
||||||
|
|
||||||
|
Number
|
||||||
|
computeRaisedRate(Number const& periodicRate, std::uint32_t paymentsRemaining);
|
||||||
|
|
||||||
|
Number
|
||||||
|
computePaymentFactor(
|
||||||
|
Number const& periodicRate,
|
||||||
|
std::uint32_t paymentsRemaining);
|
||||||
|
|
||||||
|
std::pair<Number, Number>
|
||||||
|
computeInterestAndFeeParts(
|
||||||
|
Asset const& asset,
|
||||||
|
Number const& interest,
|
||||||
|
TenthBips16 managementFeeRate,
|
||||||
|
std::int32_t loanScale);
|
||||||
|
|
||||||
|
Number
|
||||||
|
loanPeriodicPayment(
|
||||||
|
Number const& principalOutstanding,
|
||||||
|
Number const& periodicRate,
|
||||||
|
std::uint32_t paymentsRemaining);
|
||||||
|
|
||||||
|
Number
|
||||||
|
loanPrincipalFromPeriodicPayment(
|
||||||
|
Number const& periodicPayment,
|
||||||
|
Number const& periodicRate,
|
||||||
|
std::uint32_t paymentsRemaining);
|
||||||
|
|
||||||
|
Number
|
||||||
|
loanLatePaymentInterest(
|
||||||
|
Number const& principalOutstanding,
|
||||||
|
TenthBips32 lateInterestRate,
|
||||||
|
NetClock::time_point parentCloseTime,
|
||||||
|
std::uint32_t nextPaymentDueDate);
|
||||||
|
|
||||||
|
Number
|
||||||
|
loanAccruedInterest(
|
||||||
|
Number const& principalOutstanding,
|
||||||
|
Number const& periodicRate,
|
||||||
|
NetClock::time_point parentCloseTime,
|
||||||
|
std::uint32_t startDate,
|
||||||
|
std::uint32_t prevPaymentDate,
|
||||||
|
std::uint32_t paymentInterval);
|
||||||
|
|
||||||
|
ExtendedPaymentComponents
|
||||||
|
computeOverpaymentComponents(
|
||||||
|
Asset const& asset,
|
||||||
|
int32_t const loanScale,
|
||||||
|
Number const& overpayment,
|
||||||
|
TenthBips32 const overpaymentInterestRate,
|
||||||
|
TenthBips32 const overpaymentFeeRate,
|
||||||
|
TenthBips16 const managementFeeRate);
|
||||||
|
|
||||||
PaymentComponents
|
PaymentComponents
|
||||||
computePaymentComponents(
|
computePaymentComponents(
|
||||||
Asset const& asset,
|
Asset const& asset,
|
||||||
|
|||||||
@@ -100,6 +100,9 @@ computePaymentFactor(
|
|||||||
Number const& periodicRate,
|
Number const& periodicRate,
|
||||||
std::uint32_t paymentsRemaining)
|
std::uint32_t paymentsRemaining)
|
||||||
{
|
{
|
||||||
|
if (paymentsRemaining == 0)
|
||||||
|
return numZero;
|
||||||
|
|
||||||
// For zero interest, payment factor is simply 1/paymentsRemaining
|
// For zero interest, payment factor is simply 1/paymentsRemaining
|
||||||
if (periodicRate == beast::zero)
|
if (periodicRate == beast::zero)
|
||||||
return Number{1} / paymentsRemaining;
|
return Number{1} / paymentsRemaining;
|
||||||
@@ -132,27 +135,6 @@ loanPeriodicPayment(
|
|||||||
computePaymentFactor(periodicRate, paymentsRemaining);
|
computePaymentFactor(periodicRate, paymentsRemaining);
|
||||||
}
|
}
|
||||||
|
|
||||||
/* Calculates the periodic payment amount from annualized interest rate.
|
|
||||||
* Converts the annual rate to periodic rate before computing payment.
|
|
||||||
*
|
|
||||||
* Equation (7) from XLS-66 spec, Section A-2 Equation Glossary
|
|
||||||
*/
|
|
||||||
Number
|
|
||||||
loanPeriodicPayment(
|
|
||||||
Number const& principalOutstanding,
|
|
||||||
TenthBips32 interestRate,
|
|
||||||
std::uint32_t paymentInterval,
|
|
||||||
std::uint32_t paymentsRemaining)
|
|
||||||
{
|
|
||||||
if (principalOutstanding == 0 || paymentsRemaining == 0)
|
|
||||||
return 0;
|
|
||||||
|
|
||||||
Number const periodicRate = loanPeriodicRate(interestRate, paymentInterval);
|
|
||||||
|
|
||||||
return loanPeriodicPayment(
|
|
||||||
principalOutstanding, periodicRate, paymentsRemaining);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Reverse-calculates principal from periodic payment amount.
|
/* Reverse-calculates principal from periodic payment amount.
|
||||||
* Used to determine theoretical principal at any point in the schedule.
|
* Used to determine theoretical principal at any point in the schedule.
|
||||||
*
|
*
|
||||||
@@ -164,6 +146,9 @@ loanPrincipalFromPeriodicPayment(
|
|||||||
Number const& periodicRate,
|
Number const& periodicRate,
|
||||||
std::uint32_t paymentsRemaining)
|
std::uint32_t paymentsRemaining)
|
||||||
{
|
{
|
||||||
|
if (paymentsRemaining == 0)
|
||||||
|
return numZero;
|
||||||
|
|
||||||
if (periodicRate == 0)
|
if (periodicRate == 0)
|
||||||
return periodicPayment * paymentsRemaining;
|
return periodicPayment * paymentsRemaining;
|
||||||
|
|
||||||
@@ -171,21 +156,6 @@ loanPrincipalFromPeriodicPayment(
|
|||||||
computePaymentFactor(periodicRate, paymentsRemaining);
|
computePaymentFactor(periodicRate, paymentsRemaining);
|
||||||
}
|
}
|
||||||
|
|
||||||
/* Splits gross interest into net interest (to vault) and management fee (to
|
|
||||||
* broker). Returns pair of (net interest, management fee).
|
|
||||||
*
|
|
||||||
* Equation (33) from XLS-66 spec, Section A-2 Equation Glossary
|
|
||||||
*/
|
|
||||||
std::pair<Number, Number>
|
|
||||||
computeInterestAndFeeParts(
|
|
||||||
Number const& interest,
|
|
||||||
TenthBips16 managementFeeRate)
|
|
||||||
{
|
|
||||||
auto const fee = tenthBipsOfValue(interest, managementFeeRate);
|
|
||||||
|
|
||||||
return std::make_pair(interest - fee, fee);
|
|
||||||
}
|
|
||||||
|
|
||||||
/*
|
/*
|
||||||
* Computes the interest and management fee parts from interest amount.
|
* Computes the interest and management fee parts from interest amount.
|
||||||
*
|
*
|
||||||
@@ -216,6 +186,12 @@ loanLatePaymentInterest(
|
|||||||
NetClock::time_point parentCloseTime,
|
NetClock::time_point parentCloseTime,
|
||||||
std::uint32_t nextPaymentDueDate)
|
std::uint32_t nextPaymentDueDate)
|
||||||
{
|
{
|
||||||
|
if (principalOutstanding == beast::zero)
|
||||||
|
return numZero;
|
||||||
|
|
||||||
|
if (lateInterestRate == TenthBips32{0})
|
||||||
|
return numZero;
|
||||||
|
|
||||||
auto const now = parentCloseTime.time_since_epoch().count();
|
auto const now = parentCloseTime.time_since_epoch().count();
|
||||||
|
|
||||||
// If the payment is not late by any amount of time, then there's no late
|
// If the payment is not late by any amount of time, then there's no late
|
||||||
@@ -248,6 +224,9 @@ loanAccruedInterest(
|
|||||||
if (periodicRate == beast::zero)
|
if (periodicRate == beast::zero)
|
||||||
return numZero;
|
return numZero;
|
||||||
|
|
||||||
|
if (paymentInterval == 0)
|
||||||
|
return numZero;
|
||||||
|
|
||||||
auto const lastPaymentDate = std::max(prevPaymentDate, startDate);
|
auto const lastPaymentDate = std::max(prevPaymentDate, startDate);
|
||||||
auto const now = parentCloseTime.time_since_epoch().count();
|
auto const now = parentCloseTime.time_since_epoch().count();
|
||||||
|
|
||||||
@@ -548,6 +527,14 @@ tryOverpayment(
|
|||||||
|
|
||||||
auto const deltas = rounded - newRounded;
|
auto const deltas = rounded - newRounded;
|
||||||
|
|
||||||
|
// The change in loan management fee is equal to the change between the old
|
||||||
|
// and the new outstanding management fees
|
||||||
|
XRPL_ASSERT_PARTS(
|
||||||
|
deltas.managementFee ==
|
||||||
|
rounded.managementFeeDue - managementFeeOutstanding,
|
||||||
|
"ripple::detail::tryOverpayment",
|
||||||
|
"no fee change");
|
||||||
|
|
||||||
auto const hypotheticalValueOutstanding =
|
auto const hypotheticalValueOutstanding =
|
||||||
rounded.valueOutstanding - deltas.principal;
|
rounded.valueOutstanding - deltas.principal;
|
||||||
|
|
||||||
@@ -562,7 +549,6 @@ tryOverpayment(
|
|||||||
"the loan. Ignore the overpayment";
|
"the loan. Ignore the overpayment";
|
||||||
return Unexpected(tesSUCCESS);
|
return Unexpected(tesSUCCESS);
|
||||||
}
|
}
|
||||||
|
|
||||||
return LoanPaymentParts{
|
return LoanPaymentParts{
|
||||||
// Principal paid is the reduction in principal outstanding
|
// Principal paid is the reduction in principal outstanding
|
||||||
.principalPaid = deltas.principal,
|
.principalPaid = deltas.principal,
|
||||||
@@ -677,12 +663,6 @@ doOverpayment(
|
|||||||
"ripple::detail::doOverpayment",
|
"ripple::detail::doOverpayment",
|
||||||
"principal change agrees");
|
"principal change agrees");
|
||||||
|
|
||||||
XRPL_ASSERT_PARTS(
|
|
||||||
overpaymentComponents.trackedManagementFeeDelta ==
|
|
||||||
managementFeeOutstandingProxy - managementFeeOutstanding,
|
|
||||||
"ripple::detail::doOverpayment",
|
|
||||||
"no fee change");
|
|
||||||
|
|
||||||
// I'm not 100% sure the following asserts are correct. If in doubt, and
|
// I'm not 100% sure the following asserts are correct. If in doubt, and
|
||||||
// everything else works, remove any that cause trouble.
|
// everything else works, remove any that cause trouble.
|
||||||
|
|
||||||
@@ -713,13 +693,6 @@ doOverpayment(
|
|||||||
"ripple::detail::doOverpayment",
|
"ripple::detail::doOverpayment",
|
||||||
"principal payment matches");
|
"principal payment matches");
|
||||||
|
|
||||||
XRPL_ASSERT_PARTS(
|
|
||||||
loanPaymentParts.feePaid ==
|
|
||||||
overpaymentComponents.untrackedManagementFee +
|
|
||||||
overpaymentComponents.trackedManagementFeeDelta,
|
|
||||||
"ripple::detail::doOverpayment",
|
|
||||||
"fee payment matches");
|
|
||||||
|
|
||||||
// All validations passed, so update the proxy objects (which will
|
// All validations passed, so update the proxy objects (which will
|
||||||
// modify the actual Loan ledger object)
|
// modify the actual Loan ledger object)
|
||||||
totalValueOutstandingProxy = totalValueOutstanding;
|
totalValueOutstandingProxy = totalValueOutstanding;
|
||||||
@@ -1232,17 +1205,12 @@ computeOverpaymentComponents(
|
|||||||
// This interest doesn't follow the normal amortization schedule - it's
|
// This interest doesn't follow the normal amortization schedule - it's
|
||||||
// a one-time charge for paying early.
|
// a one-time charge for paying early.
|
||||||
// Equation (20) and (21) from XLS-66 spec, Section A-2 Equation Glossary
|
// Equation (20) and (21) from XLS-66 spec, Section A-2 Equation Glossary
|
||||||
auto const [rawOverpaymentInterest, _] = [&]() {
|
|
||||||
Number const interest =
|
|
||||||
tenthBipsOfValue(overpayment, overpaymentInterestRate);
|
|
||||||
return detail::computeInterestAndFeeParts(interest, managementFeeRate);
|
|
||||||
}();
|
|
||||||
|
|
||||||
// Round the penalty interest components to the loan scale
|
|
||||||
auto const [roundedOverpaymentInterest, roundedOverpaymentManagementFee] =
|
auto const [roundedOverpaymentInterest, roundedOverpaymentManagementFee] =
|
||||||
[&]() {
|
[&]() {
|
||||||
Number const interest =
|
auto const interest = roundToAsset(
|
||||||
roundToAsset(asset, rawOverpaymentInterest, loanScale);
|
asset,
|
||||||
|
tenthBipsOfValue(overpayment, overpaymentInterestRate),
|
||||||
|
loanScale);
|
||||||
return detail::computeInterestAndFeeParts(
|
return detail::computeInterestAndFeeParts(
|
||||||
asset, interest, managementFeeRate, loanScale);
|
asset, interest, managementFeeRate, loanScale);
|
||||||
}();
|
}();
|
||||||
@@ -1436,31 +1404,6 @@ computeFullPaymentInterest(
|
|||||||
return accruedInterest + prepaymentPenalty;
|
return accruedInterest + prepaymentPenalty;
|
||||||
}
|
}
|
||||||
|
|
||||||
Number
|
|
||||||
computeFullPaymentInterest(
|
|
||||||
Number const& periodicPayment,
|
|
||||||
Number const& periodicRate,
|
|
||||||
std::uint32_t paymentRemaining,
|
|
||||||
NetClock::time_point parentCloseTime,
|
|
||||||
std::uint32_t paymentInterval,
|
|
||||||
std::uint32_t prevPaymentDate,
|
|
||||||
std::uint32_t startDate,
|
|
||||||
TenthBips32 closeInterestRate)
|
|
||||||
{
|
|
||||||
Number const rawPrincipalOutstanding =
|
|
||||||
detail::loanPrincipalFromPeriodicPayment(
|
|
||||||
periodicPayment, periodicRate, paymentRemaining);
|
|
||||||
|
|
||||||
return computeFullPaymentInterest(
|
|
||||||
rawPrincipalOutstanding,
|
|
||||||
periodicRate,
|
|
||||||
parentCloseTime,
|
|
||||||
paymentInterval,
|
|
||||||
prevPaymentDate,
|
|
||||||
startDate,
|
|
||||||
closeInterestRate);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Calculates the theoretical loan state at maximum precision for a given point
|
/* Calculates the theoretical loan state at maximum precision for a given point
|
||||||
* in the amortization schedule.
|
* in the amortization schedule.
|
||||||
*
|
*
|
||||||
@@ -1522,21 +1465,6 @@ computeRawLoanState(
|
|||||||
.managementFeeDue = rawManagementFeeOutstanding};
|
.managementFeeDue = rawManagementFeeOutstanding};
|
||||||
};
|
};
|
||||||
|
|
||||||
LoanState
|
|
||||||
computeRawLoanState(
|
|
||||||
Number const& periodicPayment,
|
|
||||||
TenthBips32 interestRate,
|
|
||||||
std::uint32_t paymentInterval,
|
|
||||||
std::uint32_t const paymentRemaining,
|
|
||||||
TenthBips32 const managementFeeRate)
|
|
||||||
{
|
|
||||||
return computeRawLoanState(
|
|
||||||
periodicPayment,
|
|
||||||
loanPeriodicRate(interestRate, paymentInterval),
|
|
||||||
paymentRemaining,
|
|
||||||
managementFeeRate);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Constructs a LoanState from rounded Loan ledger object values.
|
/* Constructs a LoanState from rounded Loan ledger object values.
|
||||||
*
|
*
|
||||||
* This function creates a LoanState structure from the three tracked values
|
* This function creates a LoanState structure from the three tracked values
|
||||||
|
|||||||
@@ -67,7 +67,7 @@ LoanBrokerDelete::preclaim(PreclaimContext const& ctx)
|
|||||||
JLOG(ctx.j.warn()) << "LoanBrokerDelete: Debt total is "
|
JLOG(ctx.j.warn()) << "LoanBrokerDelete: Debt total is "
|
||||||
<< debtTotal << ", which rounds to " << rounded;
|
<< debtTotal << ", which rounds to " << rounded;
|
||||||
return tecHAS_OBLIGATIONS;
|
return tecHAS_OBLIGATIONS;
|
||||||
// LCOV_EXCL_START
|
// LCOV_EXCL_STOP
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -1,4 +1,6 @@
|
|||||||
#include <xrpld/app/tx/detail/VaultWithdraw.h>
|
#include <xrpld/app/tx/detail/VaultWithdraw.h>
|
||||||
|
//
|
||||||
|
#include <xrpld/app/tx/detail/Payment.h>
|
||||||
|
|
||||||
#include <xrpl/ledger/CredentialHelpers.h>
|
#include <xrpl/ledger/CredentialHelpers.h>
|
||||||
#include <xrpl/ledger/View.h>
|
#include <xrpl/ledger/View.h>
|
||||||
@@ -197,7 +199,7 @@ VaultWithdraw::doApply()
|
|||||||
assetsAvailable -= assetsWithdrawn;
|
assetsAvailable -= assetsWithdrawn;
|
||||||
view().update(vault);
|
view().update(vault);
|
||||||
|
|
||||||
auto const& vaultAccount = vault->at(sfAccount);
|
AccountID const& vaultAccount = vault->at(sfAccount);
|
||||||
// Transfer shares from depositor to vault.
|
// Transfer shares from depositor to vault.
|
||||||
if (auto const ter = accountSend(
|
if (auto const ter = accountSend(
|
||||||
view(),
|
view(),
|
||||||
|
|||||||
Reference in New Issue
Block a user