HandsOnChain

返済の期限と不履行の担保を扱う

作るもの

このレッスンを終えると、返済の期限を過ぎても返していない借り手の担保を、担保維持率に関わらず処分できます。
追加担保の請求も、3日の猶予も待ちません。
担保の社債が不履行になり、評価会社が価格を0円にした借り手も、猶予を待たずに処分できることをテストで確かめます。

背景

ローンには返済の期限があり、借り手は期限までに元本と利息を返します。
期限を過ぎても返さない借り手から回収するために、貸し手は担保を売ります。
担保の価値が十分に残っていても、期限を過ぎた借金を待ち続ける理由はありません。
そのため、期限を過ぎた後は担保維持率を見ずに処分できるようにします。

このコースでは、返済の期限を担保の社債の満期より前に置きます。
満期に社債は償還され、社債トークンはburnされて額面の円に変わります。
ローンのコントラクトは償還を受け取る関数を持たないので、満期を過ぎて預かったままの社債は担保として売れなくなります。
pledge-borrowのレッスンで作ったコンストラクタは、期限が満期より前でないローンをDueDateAfterMaturityで拒みます。

日付 ローカルノードの値 何が起こるか
払込日 2026-01-15 社債が発行され、借り手が預けて借りられるようになる
返済の期限 2026-12-15 この時刻からは借りられない。
この時刻ちょうどまでは返せる
期限の1秒後 2026-12-15 0時0分1秒 返していない借り手の担保を、誰でも処分できる
満期 2027-01-15 社債が償還される

社債の発行体が利金や元本を払えなくなると、その社債の価値はほとんどなくなります。
評価会社はその時に社債1口の価格を0円にします。
価格が0円になると担保の評価額も0円になり、担保維持率は0%になります。
liquidateのレッスンで作った決まりでは、100%を下回った借り手は猶予を待たずに処分できます。
買い手は0円で担保を引き取り、元本と利息は全て借り手の借金として残ります。

liquidatableは、次の順に確かめて処分できるかを決めます。

処分できるかを決める順
ないまだ下回った下回らないはいいいえ始まり終わり終わりliquidatableを読む担保と借金がある?返済の期限を過ぎた?処分できる処分できない100%を下回った?猶予を過ぎて110%未満?11223344あるあるある過ぎた

期限を過ぎた借り手を処分する時も、担保を売る額は最新の価格から決めます。
価格が3日より古いと、liquidationPriceの中のcurrentPriceがStalePriceで拒みます。
期限の後に処分する前には、評価会社が価格を入れ直します。

実装

starter/contracts/contracts/SecuritiesLoan.solのliquidatableで、担保と借金があるかを確かめた行の次に、期限の確かめを足します。
関数の説明の@noticeにも、返済の期限を足します。

    /// @notice 処分できるか。返済の期限を過ぎたか、100%を下回ったか、請求から猶予を過ぎても110%に戻らない時に処分できる
    function liquidatable(address borrower) public view returns (bool) {
        Position storage p = _positions[borrower];
        if (p.units == 0 || debtOf(borrower) == 0) return false;
        // 返済の期限を過ぎても返していない借り手は、担保維持率に関わらず処分できる
        if (block.timestamp > dueDate) return true;
        uint256 ratio = ratioBps(borrower);
        if (ratio < LIQUIDATE_BPS) return true;
        return p.calledAt != 0 && block.timestamp > p.calledAt + GRACE && ratio < CALL_BPS;
    }
行 意味
p.units == 0 || debtOf(borrower) == 0 担保のない借り手と、借金のない借り手は処分しない。
返し終えた借り手は期限を過ぎても処分されない
block.timestamp > dueDate 期限の時刻ちょうどはまだ処分しない。
borrowはblock.timestamp >= dueDateで拒むので、期限の時刻からは借りられず、期限の時刻ちょうどまでは返せる
return true 期限を過ぎていれば、担保維持率と請求を読まずに処分できると返す

価格が0円になった借り手の処分には、コードを足しません。
ratioBpsが0を返し、ratio < LIQUIDATE_BPSで処分できると決まります。
liquidateは0円を買い手から受け取り、利息と元本に1円も充てずに、担保の社債を買い手へ渡します。

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

    function test_LiquidateAfterDueDate() public {
        _pledgeAndBorrow(alice, 10, 100_000);
        // 返済の期限ちょうどは、担保維持率が高いので処分できない
        vm.warp(DUE_DATE);
        _setPrice(PRICE);
        vm.expectRevert(abi.encodeWithSelector(SecuritiesLoan.NotLiquidatable.selector, alice));
        vm.prank(bob);
        loan.liquidate(alice);
        // 期限を過ぎると、担保維持率に関わらず処分できる
        vm.warp(DUE_DATE + 1);
        vm.prank(bob);
        loan.liquidate(alice);
        assertEq(bond.balanceOf(bob), 20);
        assertEq(loan.debtOf(alice), 0);
    }

    function test_DefaultedCollateralCanBeLiquidated() public {
        _pledgeAndBorrow(alice, 10, 700_000);
        // 社債が不履行になったと評価会社が見て、価格を0にする
        vm.prank(address(settlement));
        bond.markDefaulted();
        _setPrice(0);
        assertEq(loan.ratioBps(alice), 0);
        vm.prank(bob);
        loan.liquidate(alice);
        // 買い手は0円で担保を引き取り、元本は全て借金として残る
        assertEq(bond.balanceOf(bob), 20);
        assertEq(loan.debtOf(alice), 700_000);
    }
テスト 確かめること
test_LiquidateAfterDueDate 2026-12-15の期限ちょうどはNotLiquidatableで拒まれ、1秒後には処分できる。
bobは10口を950,000円で買い、334日分の利息1,830円と元本100,000円に充てた残りの848,170円がaliceへ返る
test_DefaultedCollateralCanBeLiquidated 不履行の印が付いて価格が0円になると、担保維持率が0%になり、猶予を待たずに処分できる。
bobは0円で10口を引き取り、700,000円がaliceの借金として残る

bond.markDefaulted()は、社債トークンのSETTLEMENT_ROLEを持つ決済のコントラクトだけが呼べます。
テストではvm.prankで決済のコントラクトの名義にして、不履行の印を付けます。
不履行の印は売買の注文を止めますが、社債トークンの移転は止めません。
そのため、処分で担保の社債を買い手へ渡せます。

確かめる

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

forge test --match-contract SecuritiesLoanTest

次の行が出れば、期限と不履行の担保のテストは通っています。

[PASS] test_DefaultedCollateralCanBeLiquidated()
[PASS] test_LiquidateAfterDueDate()
Suite result: ok. 27 passed; 0 failed; 0 skipped

liquidatableのif (block.timestamp > dueDate) return true;の行を消して実行すると、test_LiquidateAfterDueDateが失敗します。

[FAIL: NotLiquidatable(0x328809Bc894f92807417D2dAD6b7C998c1aFdac6)] test_LiquidateAfterDueDate()

期限を確かめないと、aliceの担保維持率は900%を超えたままなので、期限を過ぎても処分できません。
返さない借り手の担保を、貸し手は売れなくなります。
確かめたら、消した行を戻しておきます。

次のレッスンで、担保の利金を受け取る欄と、返済の期限の後へ時刻を進めるボタンを画面に足します。