HandsOnChain

110%を下回ったら請求を記録する

作るもの

このレッスンを終えると、担保維持率が110%を下回った借り手に、誰でも追加担保の請求を記録できます。
請求を記録した時刻から3日が猶予になり、graceEndで猶予の終わりを読めます。
担保維持率が110%以上の借り手への請求は拒みます。
最後の価格から3日を過ぎた古い価格での請求も拒みます。
記録した請求は、後のレッスンで猶予を過ぎた担保を処分する時の起点になります。

背景

銀行や証券会社が有価証券を担保に貸す時は、担保の値下がりに備えて、担保維持率の下限を約束に入れておきます。
担保の価格が下がって下限を割ると、貸し手は借り手へ追加担保を求めます。
この請求をマージンコールとも呼びます。
借り手は決めた期限までに担保を足すか一部を返して、担保維持率を下限より上へ戻します。
期限までに戻らない時は、貸し手の側が担保を売って貸したお金に充てます。

このコースでは、借りる時の掛け目を80%にし、請求の線を110%に置きます。
掛け目いっぱいに借りた直後の担保維持率は、80%の逆数の125%です。
そこから担保の価格が12%下がると、担保維持率は110%に届きます。

担保維持率 起きること
125% 掛け目いっぱいに借りた直後の値
110%以上 そのまま借りていられる
110%未満 誰でも追加担保の請求を記録できる。
記録した時刻から3日が猶予になる
100%未満 後のレッスンで、猶予を待たずに担保を処分できるようにする

今の担保ローンでは、担保維持率を数えて請求を出すのは貸し手だけです。
借り手は貸し手から知らせを受けるまで、いつから猶予が始まったかを自分では確かめられません。
チェーンの上では、預けた口数と元本と利息と評価会社の価格が全て読めます。
そのため、担保維持率は誰が数えても同じ値になります。
請求を記録するmarkCallは誰でも呼べるようにし、記録してよいかはコントラクトが確かめます。
記録した時刻はチェーンに残るので、猶予の終わりも借り手と貸し手で食い違いません。

価格が下がって請求を記録し、3日の猶予が始まる
借り手Aの状態担保維持率142%108%請求なし3月2日1〜2日1〜2日担保維持率140%台で借りている2〜5日2〜5日3日の猶予1日2日4日6日7日請求の記録請求の記録calledAt猶予の終わり猶予の終わりgraceEnd11223344

実装

starter/contracts/contracts/SecuritiesLoan.solのLTV_BPSの下に、請求の線と猶予の長さを足します。

    /// @notice 担保維持率がこれを下回ると、誰でも追加担保の請求を記録できる (110%)
    uint256 public constant CALL_BPS = 11_000;
    /// @notice 請求から処分できるまでの猶予
    uint256 public constant GRACE = 3 days;
行 意味
CALL_BPS = 11_000 請求の線の110%を、1万分率で持つ。
ratioBpsが返す担保維持率と同じ単位
GRACE = 3 days 請求の記録から処分できるまでの長さ。
Solidityの3 daysは259,200秒になる

借り手ごとの担保と借入のPositionの末尾に、請求を記録した時刻を足します。

        // 次に利息を数え始める時刻
        uint64 interestFrom;
        // 追加担保の請求を記録した時刻。請求のない時は0
        uint64 calledAt;
    }

calledAtが0の時は、請求がない状態です。
positionOfはPositionをそのまま返すので、画面はcalledAtを読めば請求の有りなしが分かります。

イベントの末尾に請求のイベントを、エラーの末尾に請求を拒む2つのエラーを足します。

    event Called(address indexed borrower, uint256 graceEnd);
    error AlreadyCalled(address borrower);
    error NotBelowCallLevel(address borrower, uint256 ratioBps);
行 意味
Called 請求を記録した借り手と猶予の終わりを残す。
貸し手の銀行はこのイベントを見て借り手へ連絡できる
AlreadyCalled もう請求を記録した借り手に、もう一度記録しようとした
NotBelowCallLevel 担保維持率が110%以上の借り手に記録しようとした。
エラーにはその時の担保維持率が入る

全て返した借り手へ担保を戻す_releaseでは、請求の記録も消します。

    function _release(address borrower, Position storage p) private {
        uint256 units = p.units;
        p.units = 0;
        p.calledAt = 0;

請求を受けた借り手が元本と利息を全て返すと、もう処分する担保も借金もありません。
全て返したことで請求に応じたことになるので、請求の時刻もここで0に戻します。

最後に、ファイルの末尾に請求を記録する関数と、猶予の終わりを読む関数を足します。

    // 追加担保の請求

    /// @notice 担保維持率が110%を下回った借り手に、誰でも追加担保の請求を記録できる
    function markCall(address borrower) external {
        Position storage p = _positions[borrower];
        if (p.calledAt != 0) revert AlreadyCalled(borrower);
        uint256 ratio = ratioBps(borrower);
        if (ratio >= CALL_BPS) revert NotBelowCallLevel(borrower, ratio);
        p.calledAt = SafeCast.toUint64(block.timestamp);
        emit Called(borrower, graceEnd(borrower));
    }

    /// @notice 猶予の終わり。この時刻を過ぎると処分できる。請求のない時は0
    function graceEnd(address borrower) public view returns (uint256) {
        uint64 calledAt = _positions[borrower].calledAt;
        return calledAt == 0 ? 0 : calledAt + GRACE;
    }
行 意味
p.calledAt != 0 もう請求した借り手は拒む。
記録し直せると、誰かが猶予の終わりを後ろへずらして処分を遅らせられる
ratioBps(borrower) 前のレッスンの担保維持率をそのまま使う。
最新の価格で担保の評価額を出し、元本と利息の合計で割る
ratio >= CALL_BPS 110%ちょうどは下回っていないので拒む。
借りていない借り手はratioBpsが最大の値を返すので、ここで拒まれる
SafeCast.toUint64(block.timestamp) 今のブロックの時刻を請求の時刻に残す。
uint64に収まらない時刻は拒む
graceEnd 請求の時刻に3日を足す。
請求のない時は0を返す

markCallの中に、価格の新しさを確かめる行はありません。
ratioBpsが呼ぶcollateralValueは、価格のコントラクトのcurrentPriceで価格を読みます。
最後の価格から3日を過ぎていればcurrentPriceがStalePriceで拒むので、markCallも同じ取引の中で拒まれます。
古い価格では、実際には戻っている借り手にまで請求を記録してしまうためです。

請求を記録してよいかを確かめる
請求した3日を過ぎた110%以上始まり終わりmarkCallを呼ぶもう請求した?価格は3日以内?110%を下回る?請求の時刻を残す拒む1122334455まだまだまだ3日以内3日以内3日以内下回る

次に、starter/contracts/test/SecuritiesLoan.t.solのSecuritiesLoanBaseで、_pledgeAndBorrowの下に請求まで進める関数を足します。
次のレッスンの解消のテストもこの関数を使います。

    // 10口を預けて700,000円を借り、46日後 (2026-03-02) に価格が76,000円へ下がって担保維持率が108%になる
    function _fallBelowCallLevel() internal returns (uint256 calledAt) {
        _pledgeAndBorrow(alice, 10, 700_000);
        vm.warp(ISSUE_DATE + 46 days);
        _setPrice(76_000);
        loan.markCall(alice);
        return block.timestamp;
    }

SecuritiesLoanTestの末尾に、請求のテストを3つ足します。

    function test_CallBelowHundredTenPercent() public {
        _pledgeAndBorrow(alice, 10, 700_000);
        vm.warp(ISSUE_DATE + 46 days);
        _setPrice(76_000);
        // 760,000 ÷ (700,000 + 利息1,764) = 108.29%
        assertEq(loan.ratioBps(alice), 10_829);
        vm.expectEmit(address(loan));
        emit SecuritiesLoan.Called(alice, block.timestamp + 3 days);
        // 借り手でも貸し手でもない人が記録できる
        vm.prank(stranger);
        loan.markCall(alice);
        assertEq(loan.positionOf(alice).calledAt, block.timestamp);
        assertEq(loan.graceEnd(alice), block.timestamp + 3 days);
    }

    function test_RevertWhen_CallAtHundredTenPercent() public {
        _pledgeAndBorrow(alice, 10, 700_000);
        // 770,000 ÷ 700,000 = ちょうど110%
        _setPrice(77_000);
        vm.expectRevert(abi.encodeWithSelector(SecuritiesLoan.NotBelowCallLevel.selector, alice, 11_000));
        loan.markCall(alice);
        assertEq(loan.positionOf(alice).calledAt, 0);
    }

    function test_RevertWhen_CallWithStalePrice() public {
        _pledgeAndBorrow(alice, 10, 700_000);
        _setPrice(76_000);
        vm.warp(ISSUE_DATE + 3 days + 1);
        vm.expectRevert(abi.encodeWithSelector(CollateralPrice.StalePrice.selector, ISSUE_DATE, ISSUE_DATE + 3 days + 1));
        loan.markCall(alice);
        assertEq(loan.positionOf(alice).calledAt, 0);
    }
テスト 確かめること
test_CallBelowHundredTenPercent 46日分の利息1,764円を足した借金に対して、担保維持率が108.29%になる。
strangerが記録でき、猶予の終わりが3日後になる
test_RevertWhen_CallAtHundredTenPercent 借りた日に価格が77,000円になると、担保維持率はちょうど110%で請求を拒む
test_RevertWhen_CallWithStalePrice 担保維持率が108%台でも、最後の価格から3日と1秒を過ぎていればStalePriceで拒む

46日分の利息は、700,000円 × 年2% × 46日 ÷ 365日 = 1,764.38円の1円未満を切り捨てた1,764円です。
test_RevertWhen_CallWithStalePriceは価格を入れた日に借りるので、担保維持率は760,000 ÷ 700,000 = 108.57%です。
請求の線を下回っていても、古い価格では記録できないことを確かめています。

確かめる

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

forge test --match-contract SecuritiesLoanTest

次の行が出れば、請求の記録は正しく動いています。

[PASS] test_CallBelowHundredTenPercent()
[PASS] test_RevertWhen_CallAtHundredTenPercent()
[PASS] test_RevertWhen_CallWithStalePrice()
Suite result: ok. 13 passed; 0 failed; 0 skipped

110%ちょうどを拒む行が効いていることも確かめます。
markCallのif (ratio >= CALL_BPS)をif (ratio > CALL_BPS)に書き換えて実行すると、test_RevertWhen_CallAtHundredTenPercentが失敗します。

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

110%ちょうどの借り手にも請求を記録できてしまうと分かります。
確かめたら>=に戻しておきます。

次のレッスンで、110%以上に戻った借り手の請求を解消する関数を足します。