返済の期限と不履行の担保を扱う
作るもの
このレッスンを終えると、返済の期限を過ぎても返していない借り手の担保を、担保維持率に関わらず処分できます。
追加担保の請求も、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は、次の順に確かめて処分できるかを決めます。
期限を過ぎた借り手を処分する時も、担保を売る額は最新の価格から決めます。
価格が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%を超えたままなので、期限を過ぎても処分できません。
返さない借り手の担保を、貸し手は売れなくなります。
確かめたら、消した行を戻しておきます。
次のレッスンで、担保の利金を受け取る欄と、返済の期限の後へ時刻を進めるボタンを画面に足します。