110%を下回ったら請求を記録する
作るもの
このレッスンを終えると、担保維持率が110%を下回った借り手に、誰でも追加担保の請求を記録できます。
請求を記録した時刻から3日が猶予になり、graceEndで猶予の終わりを読めます。
担保維持率が110%以上の借り手への請求は拒みます。
最後の価格から3日を過ぎた古い価格での請求も拒みます。
記録した請求は、後のレッスンで猶予を過ぎた担保を処分する時の起点になります。
背景
銀行や証券会社が有価証券を担保に貸す時は、担保の値下がりに備えて、担保維持率の下限を約束に入れておきます。
担保の価格が下がって下限を割ると、貸し手は借り手へ追加担保を求めます。
この請求をマージンコールとも呼びます。
借り手は決めた期限までに担保を足すか一部を返して、担保維持率を下限より上へ戻します。
期限までに戻らない時は、貸し手の側が担保を売って貸したお金に充てます。
このコースでは、借りる時の掛け目を80%にし、請求の線を110%に置きます。
掛け目いっぱいに借りた直後の担保維持率は、80%の逆数の125%です。
そこから担保の価格が12%下がると、担保維持率は110%に届きます。
| 担保維持率 | 起きること |
|---|---|
| 125% | 掛け目いっぱいに借りた直後の値 |
| 110%以上 | そのまま借りていられる |
| 110%未満 | 誰でも追加担保の請求を記録できる。 記録した時刻から3日が猶予になる |
| 100%未満 | 後のレッスンで、猶予を待たずに担保を処分できるようにする |
今の担保ローンでは、担保維持率を数えて請求を出すのは貸し手だけです。
借り手は貸し手から知らせを受けるまで、いつから猶予が始まったかを自分では確かめられません。
チェーンの上では、預けた口数と元本と利息と評価会社の価格が全て読めます。
そのため、担保維持率は誰が数えても同じ値になります。
請求を記録するmarkCallは誰でも呼べるようにし、記録してよいかはコントラクトが確かめます。
記録した時刻はチェーンに残るので、猶予の終わりも借り手と貸し手で食い違いません。
実装
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も同じ取引の中で拒まれます。
古い価格では、実際には戻っている借り手にまで請求を記録してしまうためです。
次に、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%以上に戻った借り手の請求を解消する関数を足します。