49 using namespace std::chrono_literals;
54 testcase <<
"LoanPay xrpl::detail::computePeriodicPayment : "
57 Env env(*
this, features);
61 Account const borrower{
"borrower"};
72 auto const loanSetFee =
Fee(env.
current()->fees().base * 2);
73 Number const principalRequest{640562, -5};
75 Number const serviceFee{2462611968};
78 auto createJson = env.
json(
81 kLoanServiceFee(serviceFee),
82 kPaymentTotal(numPayments),
85 createJson[
"CloseInterestRate"] = 55374;
86 createJson[
"ClosePaymentFee"] =
"3825205248";
87 createJson[
"LatePaymentFee"] =
"237";
88 createJson[
"LoanOriginationFee"] =
"0";
89 createJson[
"OverpaymentFee"] = 35167;
90 createJson[
"OverpaymentInterestRate"] = 1360;
91 createJson[
"PaymentInterval"] = 727;
95 createJson = env.
json(createJson,
Sig(sfCounterpartySignature, lender));
103 Number const actualPrincipal{6};
105 createJson[sfPrincipalRequested] = actualPrincipal;
106 createJson.removeMember(sfSequence.jsonName);
107 createJson = env.
json(createJson,
Sig(sfCounterpartySignature, lender));
116 testcase <<
"xrpl::loanComputePaymentParts : valid total interest";
118 Env env(*
this, features);
120 Account const issuer{
"issuer"};
121 Account const lender{
"lender"};
122 Account const borrower{
"borrower"};
128 using namespace loan;
130 auto const loanSetFee =
Fee(env.
current()->fees().base * 2);
131 Number const principalRequest{1, 3};
133 auto createJson = env.
json(
138 createJson[
"CloseInterestRate"] = 47299;
139 createJson[
"ClosePaymentFee"] =
"3985819770";
140 createJson[
"InterestRate"] = 92;
141 createJson[
"LatePaymentFee"] =
"3866894865";
142 createJson[
"LoanOriginationFee"] =
"0";
143 createJson[
"LoanServiceFee"] =
"2348810240";
144 createJson[
"OverpaymentFee"] = 58545;
145 createJson[
"PaymentInterval"] = 60;
146 createJson[
"PaymentTotal"] = 1;
147 createJson[
"PrincipalRequested"] =
"0.000763058";
151 createJson = env.
json(createJson,
Sig(sfCounterpartySignature, lender));
156 loanPayTx[
"Amount"][
"value"] =
"0.000281284125490196";
163 testcase <<
"xrpl::loanComputePaymentParts : totalPrincipalPaid "
166 Env env(*
this, features);
168 Account const issuer{
"issuer"};
169 Account const lender{
"lender"};
170 Account const borrower{
"borrower"};
176 using namespace loan;
178 auto const loanSetFee = Fee(env.current()->fees().base * 2);
179 Number
const principalRequest{1, 3};
181 auto createJson = env.json(
182 set(borrower, broker.brokerID, principalRequest),
186 createJson[
"ClosePaymentFee"] =
"0";
187 createJson[
"InterestRate"] = 24346;
188 createJson[
"LateInterestRate"] = 65535;
189 createJson[
"LatePaymentFee"] =
"0";
190 createJson[
"LoanOriginationFee"] =
"218";
191 createJson[
"LoanServiceFee"] =
"0";
192 createJson[
"PaymentInterval"] = 60;
193 createJson[
"PaymentTotal"] = 5678;
194 createJson[
"PrincipalRequested"] =
"9924.81";
198 createJson = env.json(createJson, Sig(sfCounterpartySignature, lender));
202 auto const baseFee = env.current()->fees().base;
208 env.json(
pay(borrower,
keylet.
key, STAmount{broker.asset, Number{}}));
209 Number
const amount{3074'745'058'823'529, -12};
210 BEAST_EXPECT(
to_string(amount) ==
"3074.745058823529");
213 (amount / stateBefore.periodicPayment / kLoanPaymentsPerFeeIncrement + 1)};
214 loanPayTx[
"Amount"][
"value"] =
to_string(amount);
221 env.json(
pay(borrower,
keylet.
key, STAmount{broker.asset, Number{}}));
222 Number
const amount{6732'118'170'944'051, -12};
223 BEAST_EXPECT(
to_string(amount) ==
"6732.118170944051");
226 (amount / stateBefore.periodicPayment / kLoanPaymentsPerFeeIncrement + 1)};
227 loanPayTx[
"Amount"][
"value"] =
to_string(amount);
232 auto const stateAfter = getCurrentState(env, broker, keylet);
234 BEAST_EXPECT(stateAfter.totalValue >= stateAfter.principalOutstanding);
236 BEAST_EXPECT(stateBefore.principalOutstanding >= stateAfter.principalOutstanding);
238 BEAST_EXPECT(stateBefore.totalValue >= stateAfter.totalValue);
242 (stateBefore.totalValue - stateAfter.totalValue) >=
243 (stateBefore.principalOutstanding - stateAfter.principalOutstanding));
248 testcase <<
"xrpl::loanComputePaymentParts : loanValueChange rounded";
250 Env env(*
this, features);
252 Account const issuer{
"issuer"};
253 Account const lender{
"lender"};
254 Account const borrower{
"borrower"};
256 PrettyAsset
const iouAsset =
257 createFundedIouAsset(env, issuer, lender, borrower, 100'000'000, 10'000'000);
259 BrokerInfo
const broker{createVaultAndBroker(env, iouAsset, lender)};
261 auto const coverDepositValue =
262 broker.asset(broker.params.coverDeposit * 10).value();
263 env(loan_broker::coverDeposit(lender, broker.brokerID, coverDepositValue));
267 using namespace loan;
269 auto const loanSetFee = Fee(env.current()->fees().base * 2);
270 Number
const principalRequest{1, 3};
272 auto createJson = env.json(
273 set(borrower, broker.brokerID, principalRequest),
277 createJson[
"ClosePaymentFee"] =
"0";
278 createJson[
"InterestRate"] = 12833;
279 createJson[
"LateInterestRate"] = 77048;
280 createJson[
"LatePaymentFee"] =
"0";
281 createJson[
"LoanOriginationFee"] =
"218";
282 createJson[
"LoanServiceFee"] =
"0";
283 createJson[
"PaymentInterval"] = 752;
284 createJson[
"PaymentTotal"] = 5678;
285 createJson[
"PrincipalRequested"] =
"9924.81";
287 auto const keylet = nextLoanKeylet(env, broker);
289 createJson = env.json(createJson, Sig(sfCounterpartySignature, lender));
290 env(createJson, Ter(tesSUCCESS));
293 auto const baseFee = env.current()->fees().base;
295 auto const stateBefore = getCurrentState(env, broker, keylet);
296 BEAST_EXPECT(stateBefore.paymentRemaining == 5678);
297 BEAST_EXPECT(stateBefore.paymentRemaining > kLoanMaximumPaymentsPerTransaction);
299 auto loanPayTx = env.json(
pay(borrower,
keylet.
key, STAmount{broker.asset, Number{}}));
300 Number
const amount{9924'81, -2};
301 BEAST_EXPECT(
to_string(amount) ==
"9924.81");
304 (amount / stateBefore.periodicPayment / kLoanPaymentsPerFeeIncrement + 1)};
305 loanPayTx[
"Amount"][
"value"] =
to_string(amount);
306 env(loanPayTx, Fee(payFee), Ter(tesSUCCESS));
309 auto const stateAfter = getCurrentState(env, broker, keylet);
311 stateAfter.paymentRemaining ==
312 stateBefore.paymentRemaining - kLoanMaximumPaymentsPerTransaction);
320 testcase <<
"LoanPay xrpl::LoanPay::doApply : debtDecrease "
324 using namespace std::chrono_literals;
326 Env env(*
this, features);
328 Account const issuer{
"issuer"};
329 Account const lender{
"lender"};
330 Account const borrower{
"borrower"};
336 using namespace loan;
338 auto const baseFee = env.
current()->fees().base;
339 auto const loanSetFee =
Fee(baseFee * 2);
340 Number const principalRequest{1, 3};
342 auto createJson = env.
json(
347 createJson[
"ClosePaymentFee"] =
"0";
348 createJson[
"GracePeriod"] = 60;
349 createJson[
"InterestRate"] = 24346;
350 createJson[
"LateInterestRate"] = 65535;
351 createJson[
"LatePaymentFee"] =
"0";
352 createJson[
"LoanOriginationFee"] =
"218";
353 createJson[
"LoanServiceFee"] =
"0";
354 createJson[
"PaymentInterval"] = 60;
355 createJson[
"PaymentTotal"] = 5678;
356 createJson[
"PrincipalRequested"] =
"9924.81";
360 createJson = env.
json(createJson,
Sig(sfCounterpartySignature, lender));
368 verifyLoanStatus(originalState);
370 Number const payment{3'269'349'176'470'588, -12};
373 ((payment / originalState.periodicPayment) / kLoanPaymentsPerFeeIncrement + 1)};
374 auto const loanPayTx =
376 BEAST_EXPECT(
to_string(payment) ==
"3269.349176470588");
382 isRounded(broker.
asset, newState.managementFeeOutstanding, originalState.loanScale));
383 BEAST_EXPECT(newState.managementFeeOutstanding < originalState.managementFeeOutstanding);
384 BEAST_EXPECT(
isRounded(broker.
asset, newState.totalValue, originalState.loanScale));
386 isRounded(broker.
asset, newState.principalOutstanding, originalState.loanScale));
396 testcase(
"LoanPay overpayment schedule advancement");
399 using namespace loan;
401 Env env{*
this, features | featureLendingProtocolV1_1};
403 Account const lender{
"lender"};
404 Account const borrower{
"borrower"};
406 env.
fund(
XRP(10'000'000), lender, borrower);
416 .vaultDeposit = asset(100'000).value(),
420 auto const loanSetFee =
Fee(env.
current()->fees().base * 2);
425 env(
loan::set(borrower, broker.
brokerID, asset(10'000).value(), tfLoanOverpayment),
426 Sig(sfCounterpartySignature, lender),
434 BEAST_EXPECT(before.paymentRemaining == 3);
436 STAmount const belowOnePayment = asset(1'000).value();
437 BEAST_EXPECT((belowOnePayment <
STAmount{asset, before.periodicPayment}));
439 auto const payFee =
Fee(env.
current()->fees().base * 2);
445 env(
pay(borrower, loanKeylet.key, belowOnePayment, tfLoanOverpayment),
451 BEAST_EXPECT(afterReject.paymentRemaining == before.paymentRemaining);
452 BEAST_EXPECT(afterReject.principalOutstanding == before.principalOutstanding);
453 BEAST_EXPECT(afterReject.nextPaymentDate == before.nextPaymentDate);
458 STAmount const onePaymentPlusExtra = asset(5'000).value();
459 env(
pay(borrower, loanKeylet.key, onePaymentPlusExtra, tfLoanOverpayment), payFee);
463 BEAST_EXPECT(afterPay.paymentRemaining == before.paymentRemaining - 1);
464 BEAST_EXPECT(afterPay.principalOutstanding < before.principalOutstanding);
465 BEAST_EXPECT(afterPay.nextPaymentDate == before.nextPaymentDate + before.paymentInterval);
537 using namespace loan;
540 bool const withAmendment = features[fixCleanup3_2_0];
557 auto const runTest = [&](
Number vaultDeposit,
auto&& body) {
558 Env env(*
this, features);
560 Account const issuer{
"issuer"};
561 Account const lender{
"lender"};
562 Account const borrower{
"borrower"};
564 env.
fund(
XRP(1'000'000'000), issuer, lender, borrower);
569 env(
fset(issuer, asfAllowTrustLineClawback));
573 env(
trust(lender, iou(1'000'000'000)));
574 env(
trust(borrower, iou(1'000'000'000)));
576 env(
pay(issuer, lender, iou(100'000'000)));
577 env(
pay(issuer, borrower, iou(100'000'000)));
582 .vaultDeposit = vaultDeposit,
585 .coverDeposit = 5'000,
596 .borrower = borrower,
599 .brokerParams = brokerParams,
609 testcase(
"LoanPay minimum cover scale consistency");
622 Asset const asset{c.iou};
628 if (!BEAST_EXPECT(brokerSle1))
630 auto const tinyLoanSeq = brokerSle1->at(sfLoanSequence);
631 auto const tinyLoanKeylet =
634 env(
set(c.borrower, c.broker.brokerID,
Number{1, -2}),
635 Sig(sfCounterpartySignature, c.lender),
638 kPaymentInterval(86400 * 365),
646 if (!BEAST_EXPECT(brokerSle2))
648 auto const bigLoanSeq = brokerSle2->at(sfLoanSequence);
649 auto const bigLoanKeylet =
652 env(
set(c.borrower, c.broker.brokerID,
Number{500}),
653 Sig(sfCounterpartySignature, c.lender),
656 kPaymentInterval(86400 * 365),
664 auto const tinyLoanSle = env.
le(tinyLoanKeylet);
665 auto const bigLoanSle = env.
le(bigLoanKeylet);
667 if (!BEAST_EXPECT(tinyLoanSle) || !BEAST_EXPECT(bigLoanSle) ||
668 !BEAST_EXPECT(vaultSle))
670 if (!BEAST_EXPECT(tinyLoanSle->at(sfLoanScale) == -12) ||
671 !BEAST_EXPECT(bigLoanSle->at(sfLoanScale) == -11) ||
687 Number const expectedCoverAfter = withAmendment ?
Number{1330651855688460000, -15}
688 :
Number{1330651855688458000, -15};
690 Number{c.brokerParams.coverDeposit} - expectedCoverAfter;
692 env(coverClawback(c.issuer),
693 kLoanBrokerId(c.broker.brokerID),
698 if (!BEAST_EXPECT(brokerSle) ||
699 !BEAST_EXPECT(brokerSle->at(sfCoverAvailable) == expectedCoverAfter))
702 return LoanKeylets{.tiny = tinyLoanKeylet, .big = bigLoanKeylet};
708 auto feeGoesToPseudo = [&](
Env& env, Ctx
const& c,
Keylet const& loanKeylet) ->
bool {
709 Asset const asset{c.iou};
711 if (!BEAST_EXPECT(brokerSle))
713 auto const pseudoAcct =
Account(
"pseudo", brokerSle->at(sfAccount));
714 auto const pseudoBefore = env.
balance(pseudoAcct, c.iou);
716 auto const payLoan = env.
le(loanKeylet);
717 if (!BEAST_EXPECT(payLoan))
719 auto const periodicPayment = payLoan->at(sfPeriodicPayment);
720 auto const serviceFee = payLoan->at(sfLoanServiceFee);
721 std::int32_t const loanScale = payLoan->at(sfLoanScale);
724 auto const payAmt =
STAmount{asset, payment + serviceFee};
729 auto const pseudoAfter = env.
balance(pseudoAcct, c.iou);
730 return pseudoAfter.
number() > pseudoBefore.number();
739 runTest(1'000, [&](
Env& env, Ctx
const& c) {
740 auto const loans = setupLoansAndClawback(env, c);
743 BEAST_EXPECT(feeGoesToPseudo(env, c, loans->big) == !withAmendment);
752 runTest(1'000, [&](
Env& env, Ctx
const& c) {
753 auto const loans = setupLoansAndClawback(env, c);
756 BEAST_EXPECT(!feeGoesToPseudo(env, c, loans->tiny));
775 testcase(
"CoverWithdraw minimum cover scale consistency");
777 100'000, [&](
Env& env, Ctx
const& c) {
778 Asset const asset{c.iou};
783 env(
set(c.borrower, c.broker.brokerID,
Number{500}),
784 Sig(sfCounterpartySignature, c.lender),
787 kPaymentInterval(86400 * 365),
794 if (!BEAST_EXPECT(brokerSle) || !BEAST_EXPECT(vaultSle))
797 auto const coverAvail = brokerSle->at(sfCoverAvailable);
798 auto const debtTotal = brokerSle->at(sfDebtTotal);
800 auto const debtScale =
scale(debtTotal, asset);
803 BEAST_EXPECT(debtScale < vaultScale);
805 auto const oldMin = [&] {
813 debtTotal,
TenthBips32{c.brokerParams.coverRateMin}, vaultSle);
818 Number const expectedNewMin{1330650518688500000, -15};
819 Number const expectedOldMin{1330650518688472000, -15};
820 BEAST_EXPECT(newMin == expectedNewMin);
821 BEAST_EXPECT(oldMin == expectedOldMin);
825 auto const target = oldMin + (newMin - oldMin) / 2;
826 auto const withdrawAmount =
STAmount{asset, coverAvail - target};
832 env(coverWithdraw(c.lender, c.broker.brokerID, withdrawAmount),
839 env(coverWithdraw(c.lender, c.broker.brokerID, withdrawAmount));
853 testcase(
"LoanSet minimum cover scale consistency");
855 1'000, [&](
Env& env, Ctx
const& c) {
864 env(
set(c.borrower, c.broker.brokerID,
Number{1, -2}),
865 Sig(sfCounterpartySignature, c.lender),
868 kPaymentInterval(86400 * 365),
872 env(
set(c.borrower, c.broker.brokerID,
Number{500}),
873 Sig(sfCounterpartySignature, c.lender),
876 kPaymentInterval(86400 * 365),
884 Number const expectedCoverAfter = withAmendment ?
Number{1330651855688460000, -15}
885 :
Number{1330651855688458000, -15};
887 Number{c.brokerParams.coverDeposit} - expectedCoverAfter;
888 env(coverClawback(c.issuer),
889 kLoanBrokerId(c.broker.brokerID),
895 if (!BEAST_EXPECT(vaultSle))
898 BEAST_EXPECT(vaultScale == -11);
914 auto const tinyPrincipal =
Number{1, -11};
918 env(
set(c.borrower, c.broker.brokerID, tinyPrincipal),
919 Sig(sfCounterpartySignature, c.lender),
922 kPaymentInterval(86400 * 365),
927 env(
set(c.borrower, c.broker.brokerID, tinyPrincipal),
928 Sig(sfCounterpartySignature, c.lender),
931 kPaymentInterval(86400 * 365),
943 using namespace loan;
945 auto const runCase = [&](
bool coarseBorrower) {
947 coarseBorrower ?
"LoanSet borrower balance uses coarsest scale"
948 :
"LoanSet broker owner balance uses coarsest scale");
950 Env env(*
this,
all_ | featureLendingProtocolV1_1);
951 Account const issuer{
"issuer"};
952 Account const lender{
"lender"};
953 Account const borrower{
"borrower"};
955 Number const coarseBalance{100'000'000'000LL};
956 Number const regularBalance{100'000'000};
962 coarseBorrower ? regularBalance : coarseBalance,
963 coarseBorrower ? coarseBalance : regularBalance);
966 .vaultDeposit = 1'000'000,
975 Number const principal{1'012'345, -5};
976 Number const originationFee{123'456, -6};
977 Account const& recipient = coarseBorrower ? borrower : lender;
978 Number const expected = coarseBorrower ? principal : originationFee;
979 auto const before = env.
balance(recipient, asset);
984 kCounterparty(lender),
985 Sig(sfCounterpartySignature, lender),
994 kCounterparty(lender),
995 Sig(sfCounterpartySignature, lender),
996 kLoanOriginationFee(originationFee),
1005 Number const received =
after.number() - before.number();
1006 auto const recipientScale =
1007 std::max(before.value().exponent(),
after.value().exponent());
1008 auto const vaultScale = broker.
vaultScale(env);
1009 Number const tolerance{1, recipientScale};
1011 BEAST_EXPECT(recipientScale > vaultScale);
1012 BEAST_EXPECT(received != expected);
1015 roundToAsset(asset, expected, recipientScale)) <= tolerance);
1033 testcase(
"LoanPay interest-due non-negative invariant");
1035 using namespace jtx;
1036 using namespace loan;
1038 Env env(*
this,
all_ | featureLendingProtocolV1_1);
1040 Account const issuer{
"issuer"};
1041 Account const lender{
"lender"};
1042 Account const borrower{
"borrower"};
1051 auto const loanSetFee =
Fee(env.
current()->fees().base * 2);
1058 Sig(sfCounterpartySignature, lender),
1061 kPaymentInterval(86400 * 30),
1065 auto const payFee =
Fee(env.
current()->fees().base * 2);
1070 initial.totalValue >=
1071 initial.principalOutstanding + initial.managementFeeOutstanding);
1078 for (
int i = 0; i < 6; ++i)
1080 auto const loanSle = env.
le(loanKeylet);
1081 if (!BEAST_EXPECT(loanSle))
1089 iouAsset, loanSle->at(sfPeriodicPayment), loanSle->at(sfLoanScale)) +
1090 loanSle->at(sfLoanServiceFee)};
1096 state.totalValue >= state.principalOutstanding + state.managementFeeOutstanding);
1097 BEAST_EXPECT(state.paymentRemaining == prevPaymentRemaining - 1);
1098 prevPaymentRemaining = state.paymentRemaining;