HandsOnChain

請求を解消する

作るもの

このレッスンを終えると、追加担保の請求を受けた借り手の担保維持率が110%以上に戻った時に、誰でも請求の解消を記録できます。
110%以上に戻る道は3つあります。
借り手が担保の社債を足すか、借りた円の一部を返すか、評価会社の入れる価格が戻るかです。
どの道で戻っても、同じcureで解消を記録します。
まだ110%を下回っている借り手と、請求のない借り手の解消は拒みます。

背景

追加担保を求められた借り手は、猶予の間に担保を差し入れるか、借りたお金の一部を返します。
貸し手は担保維持率が戻ったことを確かめて、請求を締めます。
期限の前に担保の価格が戻り、何もしなくても担保維持率が下限を上回ることもあります。
その時も、貸し手は担保維持率を数え直して請求を締めます。

戻る道 借り手がすること 担保維持率の式で変わる所
担保を足す 持っている社債を担保に足して預ける 分子の担保の評価額が増える
一部を返す 借りた円の一部を返す 分母の元本と利息の合計が減る
価格が戻る 何もしない 評価会社の入れる価格が上がり、分子が増える

前のレッスンの請求の時刻は、全て返した時を除いて、担保を足しても一部を返しても消えません。
価格が戻る道では、価格のコントラクトがローンのコントラクトを呼ぶこともありません。
そこで3つの道のどれで戻った時も、担保維持率を数え直して請求を消すcureを1つ置きます。
請求の記録と同じく、cureも誰でも呼べるようにします。
請求を消したいのは借り手で、戻ったかどうかはチェーンの上の値だけで決まるためです。

後のレッスンの担保の処分は、請求が残ったまま猶予を過ぎた借り手を対象にします。
戻った後に解消を記録しないでいると、猶予の終わりの後にまた110%を下回った時、新しい猶予を待たずに処分される状態になります。
そのため、戻ったら早めに解消を記録しておきます。

3つの道で110%以上に戻って請求を解消する
110%未満始まり終わり請求を受けた借り手 (108%)借りた円の一部を返す110%以上に戻った?請求を消す社債を足して預ける評価会社の価格が戻る拒む11223344110%以上

実装

starter/contracts/contracts/SecuritiesLoan.solのCalledの下に、解消のイベントを足します。

    event Called(address indexed borrower, uint256 graceEnd);
    event Cured(address indexed borrower);

エラーの末尾のNotBelowCallLevelの下に、解消を拒む2つのエラーを足します。

    error NotBelowCallLevel(address borrower, uint256 ratioBps);
    error NotCalled(address borrower);
    error StillBelowCallLevel(address borrower, uint256 ratioBps);
行 意味
Cured 請求を解消した借り手を残す。
貸し手の銀行は、CalledとCuredの組で請求の始まりと終わりを追える
NotCalled 請求のない借り手の解消を記録しようとした
StillBelowCallLevel 担保維持率がまだ110%を下回っている。
エラーにはその時の担保維持率が入る

ファイルの末尾のgraceEndの下に、解消を記録する関数を足します。

    /// @notice 担保を足すか一部を返すか価格が戻って担保維持率が110%以上になった借り手の請求を、誰でも解消できる
    function cure(address borrower) external {
        Position storage p = _positions[borrower];
        if (p.calledAt == 0) revert NotCalled(borrower);
        uint256 ratio = ratioBps(borrower);
        if (ratio < CALL_BPS) revert StillBelowCallLevel(borrower, ratio);
        p.calledAt = 0;
        emit Cured(borrower);
    }
行 意味
p.calledAt == 0 請求のない借り手は拒む。
拒まないと、何も起きていない時にもCuredのイベントが残る
ratioBps(borrower) 今の担保の口数と元本と利息と、最新の価格で担保維持率を数え直す。
最後の価格から3日を過ぎていればStalePriceで拒む
ratio < CALL_BPS 110%ちょうどは戻ったとみなす。
請求のratio >= CALL_BPSで拒む線と同じ所で分ける
p.calledAt = 0 請求の時刻を消す。
この後にまた110%を下回れば、新しい請求と新しい3日の猶予になる

cureは担保維持率がどの道で戻ったかを見ません。
担保を足すpledgeも、一部を返すrepayも、前のレッスンまでのまま書き換えずに済みます。

1口を足して請求を解消する
チェーンに残る値担保の口数9口10口担保維持率108%120%請求ありなし借り手A9口で700,000円を借りたローンのコントラクトSecuritiesLoan価格のコントラクト1口84,000円誰か借り手でも貸し手でもない11223344pledge(1)pledge(1)cure(借り手A)cure(借り手A)currentPrice()currentPrice()84,000円84,000円請求を消す

starter/contracts/test/SecuritiesLoan.t.solのSecuritiesLoanTestの末尾に、3つの道ごとのテストを足します。

    function test_CureByAddingCollateral() public {
        // 9口を預けて700,000円を借り、価格が84,000円へ下がると 756,000 ÷ 700,000 = 108%
        _pledgeAndBorrow(alice, 9, 700_000);
        _setPrice(84_000);
        loan.markCall(alice);
        // 1口を足すと 840,000 ÷ 700,000 = 120% に戻る
        vm.prank(alice);
        loan.pledge(1);
        vm.prank(stranger);
        loan.cure(alice);
        assertEq(loan.positionOf(alice).calledAt, 0);
    }

    function test_CureByPartialRepay() public {
        _fallBelowCallLevel();
        // 100,000円を返すと 760,000 ÷ 601,764 = 126% に戻る
        vm.prank(alice);
        loan.repay(100_000);
        loan.cure(alice);
        assertEq(loan.positionOf(alice).calledAt, 0);
    }

    function test_CureByPriceRecovery() public {
        _fallBelowCallLevel();
        // 下回ったままでは解消できない
        vm.expectRevert(abi.encodeWithSelector(SecuritiesLoan.StillBelowCallLevel.selector, alice, 10_829));
        loan.cure(alice);
        // 価格が80,000円に戻ると 800,000 ÷ 701,764 = 114% になる
        _setPrice(80_000);
        loan.cure(alice);
        assertEq(loan.positionOf(alice).calledAt, 0);
    }
テスト 確かめること
test_CureByAddingCollateral 借りた日に価格が下がって請求を受け、1口を足すと120%に戻る。
strangerが解消を記録できる
test_CureByPartialRepay 前のレッスンの_fallBelowCallLevelで請求を受け、100,000円を返すと126%に戻る
test_CureByPriceRecovery 108.29%のままではStillBelowCallLevelで拒む。
価格が80,000円に戻ると114%になり、解消できる

test_CureByPartialRepayの100,000円は、先に46日分の利息1,764円に充て、残りの98,236円を元本に充てます。
元本は601,764円になり、利息は全て払ったので、元本と利息の合計も601,764円です。
test_CureByPriceRecoveryでは借り手は何もせず、評価会社が価格を入れ直しただけで戻ります。

確かめる

starter/contractsのディレクトリで、ローンのテストを実行します。

forge test --match-contract SecuritiesLoanTest

次の行が出れば、3つの道のどれでも請求を解消できています。

[PASS] test_CureByAddingCollateral()
[PASS] test_CureByPartialRepay()
[PASS] test_CureByPriceRecovery()
Suite result: ok. 16 passed; 0 failed; 0 skipped

数え直す行が効いていることも確かめます。
cureのif (ratio < CALL_BPS) revert StillBelowCallLevel(borrower, ratio);の行を消して実行すると、test_CureByPriceRecoveryが失敗します。

[FAIL: next call did not revert as expected] test_CureByPriceRecovery()

数え直さないと、108%のままの借り手でも請求を消せてしまうと分かります。
確かめたら行を戻しておきます。

次のレッスンで、借り手のページに請求の知らせを出し、貸し手のページから請求と解消を記録できるようにします。